Перенести docker-контейнер Bookstack из одного сервера на другой

Перенос Bookstack, развернутый в docker, из одного сервера на другой при миграции.

Когда происходит замена сервера, нужен рабочий бэкап сервисов на другом сервере, миграция из одного на другой. При этом нужно сохранить все настройки, как есть, а не разворачивать с нуля.

• Права админа на Linux-серверах;
• Права на docker;
• Наличие стабильной сети;
• Нахождение серверов в локальной сети (или в общей VPN-сети).

На сервере-отправителе:

1. Перейти в каталог, где находится файл docker-compose.yml конкретно Bookstack, а затем остановить работу docker:

cd ~/bookstack
docker stop bookstack bookstack_db

2. Создать бэкапы самого bookstack и его базы данных:

sudo tar -czf bookstack-backup.tar.gz -C /var/lib/docker/volumes/bookstack_bookstack_data/_data .
sudo tar -czf bookstack-db-backup.tar.gz -C /var/lib/docker/volumes/bookstack_bookstack_db_data/_data .

при необходимости можно заново запустить bookstack:

docker start bookstack bookstack_db

3. Скопировать на целевой сервер четыре файла (два бэкапа, docker-compose.yml и Dockerfile):

scp bookstack-backup.tar.gz bookstack-db-backup.tar.gz docker-compose.yml Dockerfile ваш_логин@IP_сервера:/home/ваш_логин/bookstack/

перед этим рекомендуется на целевом сервере создать папку bookstack графически или же командой:

mkdir -p ~/bookstack

На сервере-получателе:

4. Перейти на созданную папку в терминале и создать docker-контейнеры, а после создания сразу остановить:

cd ~/bookstack
docker compose up -d bookstack_db
docker compose up -d bookstack
docker compose stop bookstack_db
docker compose stop bookstack

5. Распаковать бэкапы в нужные каталоги:

sudo tar -xzf bookstack-db-backup.tar.gz -C /var/lib/docker/volumes/bookstack_bookstack_db_data/_data
sudo tar -xzf bookstack-backup.tar.gz -C /var/lib/docker/volumes/bookstack_bookstack_data/_data

6. Перестроить docker-контейнер после распаковки:

docker compose up -d --build

7. Отредактировать файл docker-compose.yml с помощью редактора nano, поменяв ip-адрес (если там стоит localhost, то пропускаем).

8. Поднять docker-контейнер:

docker compose up -d

Сервис Bookstack перенесен со всеми настройками, статьями, инструкциями и информацией без изменений на другой сервер. Если больше нет необходимости, на старом сервере можно остановить работу docker.

❌ Проблема: происходят сбои при поднятии docker на новом сервере.

✅ Решение: надо установить docker. По нему будет отдельная инструкция, зависит от дистрибутива.

❌ Проблема: не получается войти в Bookstack.

✅ Решение: проверить наличие сети; проверить ip-адрес в docker-compose.yml; проверить доступность порта (иначе открыть либо фаерволом, либо на уровне роутера).