Перейти к основному контенту

Установка и настройка

Сгенерировать секреты

В примере 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();"