Backing Up and Migrating Chevereto Docker Service (4.0.6)

To back up and migrate a Chevereto Docker service, follow these steps:

1. Stop the running Chevereto container with:

1
docker stop chevereto

2. Back up the /var/www/html/images/ directory. Different VPS providers may offer different backup and migration methods. If you are using a Linux-based VPS, you can use the tar command to create a backup. For example, run the following command to back up the images directory to the current path:

1
tar -zcvf images_backup.tar.gz /var/www/html/images/

3. Export the database with:

1
docker exec CONTAINER /usr/bin/mysqldump -u root --password=root DATABASE > backup.sql

Here, CONTAINER is the name or ID of the Chevereto container, and DATABASE is the database name used by Chevereto.

4. Copy the backup archive and the exported database file to the new VPS.

5. Install Docker and Docker Compose on the new VPS. If they are not installed yet, follow the official installation guide for your operating system. For example, on Ubuntu 20.04 you can install them as follows:

1
sudo apt-get update
2
sudo apt-get install docker-compose docker.io

6. Create a new directory on the new VPS. For convenience, you can name it Chevereto, then switch into that directory with:

1
mkdir Chevereto
2
cd Chevereto

7. In the Chevereto directory, create a new docker-compose.yml file to start the Chevereto service. To ensure the service starts correctly, make sure to set the following environment variables to match your original Chevereto deployment:

• CHEVERETO_DB_HOST: Database host address.

• CHEVERETO_DB_USER: Username used to connect to the database.

• CHEVERETO_DB_PASS: Password used to connect to the database.

• CHEVERETO_DB_NAME: Database name used by Chevereto.

• CHEVERETO_ASSET_STORAGE_BUCKET: Path where image files are stored.

The docker-compose.yml file should look like this:

1
version: '3'
2
services:
3
  chevereto:
4
    image: ghcr.io/chevereto/chevereto:latest
5
    container_name: chevereto
6
    ports:
7
      - "80:80"
8
    environment:
9
      - CHEVERETO_DB_HOST=database
10
      - CHEVERETO_DB_USER=chevereto
11
      - CHEVERETO_DB_PASS=user_database_password
12
      - CHEVERETO_DB_NAME=chevereto
13
      - CHEVERETO_ASSET_STORAGE_TYPE=local
14
      - CHEVERETO_ASSET_STORAGE_URL=/images/_assets/
15
      - CHEVERETO_ASSET_STORAGE_BUCKET=/var/www/html/images/_assets/
16
    volumes:
17
      - /var/www/html/images:/var/www/html/images
18
    depends_on:
19
      - database
20
  database:
21
    image: ghcr.io/chevereto/chevereto-mariadb:latest
22
    container_name: chevereto_database
23
    environment:
24
      - MYSQL_ROOT_PASSWORD=root
25
      - MYSQL_DATABASE=chevereto

Make sure the docker-compose.yml file is located in the root of the Chevereto directory so that subsequent commands work properly.

8. Start the Chevereto service on the new VPS with:

1
docker-compose up -d

This will start the Chevereto service on the new VPS, connect to the restored database, and read from the backup directory according to the environment variable configuration. After that, you can access the new VPS IP address or domain name in your browser to verify that Chevereto is working correctly.