Skip to content

Conversation

@s3inlc
Copy link
Member

@s3inlc s3inlc commented Mar 15, 2023

The purpose of these changes is to facilitate the setup of Hashtopolis with Docker and allow more flexibility in configuration.
So far when installing Hashtopolis, even with Docker, the Installation steps needed to be completed to let it set up the database and create an initial user. With the upcoming changes to the backend the manual setup of a server gets more and more complicated why using Docker gets recommended.
Typically, when Hashtopolis should be set up, all the required information should already be present, so there is not really a need to have some click-through installation, but instead it can just be completely automatically. This is the purpose of this pull request. Either the database connection details can be set in the old conf.php file format or it can be passed in a docker compose via environment variables.

While we strongly recommend to switch to a docker setup in the future, we understand that there still may be users which prefer to run Hashtopolis directly on a server. The same for setups which are already existing which should not be affected by the changes, they should be updated just as usual without having to manually interact with it.

A side effect of this installation procedure changes is the restructuring of the data directories. In order to better separate them from the source code, the path for these can now be configured and can be mounted inside docker without having to create three mount binds.

As this is a fairly complex change, we need to make sure that all use-cases can still run properly and will not break existing installations. Further some documentation updates will also be required so people understand what the new possibilities for installation are.

closes #723

@zyronix zyronix changed the title [Feature] Docker Installation Docker Installation May 11, 2023
@zyronix zyronix linked an issue May 11, 2023 that may be closed by this pull request
12 tasks
@s3inlc s3inlc merged commit f38be29 into feature/apiv2 Jun 9, 2023
@zyronix zyronix deleted the feature/docker-install branch June 22, 2023 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[EPIC] Docker installation

3 participants