Установка и настройка
https://fatmetal.ru/knowledge-base/bookstack
Сгенерировать секреты
В примере compose апстрима захардкожены APP_KEY, пароль базы и root-пароль MariaDB - меняем все три. Ключ генерирует штатный хелпер образа appkey.
mkdir -p ~/bookstack/{bookstack_app_data,bookstack_db_data,caddy_data,caddy_config} && cd ~/bookstack
sudo docker run --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:version-v26.05.4 appkey
openssl rand -hex 16 # DB_PASSWORD
openssl rand -hex 16 # MYSQL_ROOT_PASSWORD
Написать docker-compose.yml
Теги закреплены на конкретные версии. APP_URL - сразу реальный адрес с https: ссылки хранятся абсолютными, с localhost за прокси ломаются редиректы. APP_LANG=ru включает русский перевод.
services:
bookstack:
image: lscr.io/linuxserver/bookstack:version-v26.05.4
container_name: bookstack
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Moscow
- APP_URL=https://wiki.example.com
- APP_KEY=base64:вывод_команды_appkey
- APP_LANG=ru
- DB_HOST=bookstack_mariadb
- DB_PORT=3306
- DB_USERNAME=bookstack
- DB_PASSWORD=первый_openssl_rand
- DB_DATABASE=bookstackapp
volumes:
- ./bookstack_app_data:/config
ports:
- 127.0.0.1:6875:80
depends_on:
- bookstack_mariadb
restart: unless-stopped
bookstack_mariadb:
image: lscr.io/linuxserver/mariadb:version-11.4.12-r0
container_name: bookstack_mariadb
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Moscow
- MYSQL_ROOT_PASSWORD=второй_openssl_rand
- MYSQL_DATABASE=bookstackapp
- MYSQL_USER=bookstack
- MYSQL_PASSWORD=первый_openssl_rand
volumes:
- ./bookstack_db_data:/config
restart: unless-stopped
caddy:
image: caddy:2
container_name: bookstack_caddy
ports:
- 80:80
- 443:443
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
- ./caddy_data:/data
- ./caddy_config:/config
depends_on:
- bookstack
restart: unless-stopped
Caddyfile - две строки; домен уже должен указывать на сервер, порт 80 открыт для HTTP-01.
wiki.example.com {
reverse_proxy bookstack:80
}
Поднять стек и подождать миграции
sudo docker compose pull && sudo docker compose up -d
Образы скачались за 89 секунд. Первые секунды Caddy отдает 502: MariaDB готовит базу, BookStack прогоняет около 140 миграций. До первого 302 на страницу входа прошло 70 секунд.
Сменить пароль администратора
Первая миграция создает учетку admin@admin.com с паролем password; Docker-путь, в отличие от скрипта апстрима, случайный пароль не генерирует. Меняем сразу - в профиле или из консоли.
sudo docker exec bookstack php /app/www/artisan tinker --execute="
\$u = \BookStack\Users\Models\User::where('email','admin@admin.com')->first();
\$u->forceFill(['password' => \Illuminate\Support\Facades\Hash::make('НОВЫЙ_ПАРОЛЬ')])->save();"