Skip to content

Updating Hashtopolis

Upgrading to 0.14.0 (from non-Docker to Docker)

There are multiple ways to migrate data from a non-Docker setup to Docker. You can start fresh, but if you want to keep your data, several migration options are available.

Importing the existing database in docker

You can reuse your old database server or also migrate the database within a docker container.

  1. Install docker to your system
  2. Create a database backup using
mysqldump <database-name> > hashtopolis-backup.sql
  1. Make copies of the following folders, located in the Hashtopolis directory next to index.php:
  • files
  • import
  • log
  1. Download the docker compose file: 
wget https://raw.githubusercontent.com/hashtopolis/server/master/docker-compose.yml
  1. Edit the docker compose file
[...]
  hashtopolis-server:
[...]
    volumes:
      - <path to where you want to store your hashtopolis files>:/usr/local/share/hashtopolis:Z
[...]
  1. Download the env file 
wget https://raw.githubusercontent.com/hashtopolis/server/master/env.example -O .env
  1. Edit the .env file and adjust the settings according to your desired configuration:
  • HASHTOPOLIS_ADMIN_USER is only used during initial setup. Once the database is imported, it will be overwritten with your previous data. 8. Create the folder which to referred to in the docker-compose, in our example we will use /usr/local/share/hashtopolis
sudo mkdir -p /usr/local/share/hashtopolis
  1. Copy the files, import, and log folders to the location referenced in the docker-compose file.
sudo cp -r files/ import/ log/ /usr/local/share/hashtopolis
  1. In the same folder create a config folder: 
mkdir /usr/local/share/hashtopolis/config
  1. Start the docker container docker compose up
  2. Stop the backend container to avoid agents interfering with the migration:
docker compose stop hashtopolis-backend
  1. To migrate the data, first copy the database backup towards the db container: 
docker cp hashtopolis-backup.sql db:.
  1. Login on the container: 
docker exec -it db /bin/bash
  1. Import the data: 
mysql -D hashtopolis -p < hashtopolis-backup.sql
  1. Exit the container
  2. Copy the PEPPER value from inc/conf.php and paste it into config/config.json. For example, from /var/www/hashtopolis/inc/conf.php:
[...]
$PEPPER = [..., ..., ..., ...];
[...]

Becomes /usr/local/share/hashtopolis/config/config.json:

{
  "PEPPER": [..., ..., ..., ...],
}
  1. Restart the containers 
docker compose down && docker compose up

Preserving the existing database

Repeat the above steps, but you do not need to export or import the database. Just ensure the .env file points to your database server and that it is reachable from the container.

Upgrading from docker to docker (version 0.14.0 and up)

For this process, you need to stop your containers, pull the new ones and then restart the containers.

docker compose down
docker compose pull
docker compose up

Upgrading from docker to docker (version 0.14.0 and up) - Offline System(s)

  1. On a system with internet access execute the following commands:
docker pull hashtopolis/backend:latest
docker pull hashtopolis/frontend:latest
docker save hashtopolis/backend:latest --output hashtopolis-backend.tar
docker save hashtopolis/frontend:latest --output hashtopolis-frontend.tar
  1. Next, transfer both tar-files to your Hashtopolis server and import them using the following commands:
docker compose down
docker load --input hashtopolis-backend.tar
docker load --input hashtopolis-frontend.tar
docker compose up
GitHub Docker Discord