Установка BookStack на свой сервер

Установка BookStack в Docker на Ubuntu по шагам#

1. Установите движок Docker и Compose официальным скриптом curl -fsSL https://get.docker.com | sh.
2. Сгенерируйте ключ приложения командой из документации образа LinuxServer: он нужен для шифрования сессий и вписывается в APP_KEY.
3. Создайте файл docker-compose.yml ниже, поставив свой адрес в APP_URL и свои пароли.
4. Запустите docker compose up -d и откройте http://IP-сервера:6875.
5. Войдите под admin@admin.com с паролем password и сразу замените оба значения в профиле.

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    restart: unless-stopped
    depends_on:
      - bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Moscow
      - APP_URL=https://wiki.example.com
      - APP_KEY=вставьте-ключ
      - DB_HOST=bookstack_db
      - DB_PORT=3306
      - DB_USERNAME=bookstack
      - DB_PASSWORD=замените-пароль
      - DB_DATABASE=bookstackapp
    volumes:
      - ./bookstack_app_data:/config
    ports:
      - '6875:80'
  bookstack_db:
    image: lscr.io/linuxserver/mariadb:latest
    restart: unless-stopped
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Moscow
      - MYSQL_ROOT_PASSWORD=замените-пароль-root
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=замените-пароль
    volumes:
      - ./bookstack_db_data:/config

Без Docker документация предлагает скрипт установки для Ubuntu LTS: он ставит всё сам и в конце печатает случайный пароль администратора.

Роли, права и вход сотрудников в BookStack#

Из коробки есть роли Admin, Editor, Viewer и Public. Права назначаются двумя слоями: роль задаёт общие возможности, а на конкретную полку, книгу, главу или страницу можно выдать свои права. Так бухгалтерия видит свои регламенты, а остальные нет.

Ещё 1 абзац · 10 сек

Вопросы об установке BookStack#

Какие требования у BookStack к серверу?

PHP 8.2 и выше, MySQL 8.0 или MariaDB 10.6 и выше, Git и Composer для ручной установки. Объём памяти документация не называет, для малой вики хватает недорогого сервера.

Какой пароль у BookStack после установки?

Вход admin@admin.com с паролем password. Замените оба значения при первом входе. Скрипт установки для Ubuntu из документации вместо этого печатает случайный пароль.

Как установить BookStack в Docker?

Взять образ LinuxServer, добавить контейнер MariaDB, указать APP_URL, ключ APP_KEY и параметры базы, затем выполнить docker compose up -d. Приложение откроется на порту 6875.

Почему BookStack грузится без стилей и картинок?

Почти всегда в APP_URL указан не тот адрес, например http вместо https или IP вместо домена. Исправьте значение и перезапустите контейнер.