BookStack на VPS: wiki и база знаний команды

Краткий ответ: BookStack — wiki с WYSIWYG-редактором: полки → книги → главы. На VPS 1–2 GB: Docker + MariaDB, SSL, бэкапы.

Runbook’и, onboarding, API-доки — лучше в своей wiki, чем в Notion/Google Docs с vendor lock-in.

---

BookStack vs Outline vs Confluence

	BookStack	Outline	Confluence
Self-hosted	Да	Да	Cloud/SERVER
WYSIWYG	Да	Markdown	Да
RAM	1 GB+	2 GB+	SaaS
LDAP/OAuth	Да	Да	Да

SSO — Authentik или OAuth provider.

---

Docker Compose

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=https://wiki.example.com
      - DB_HOST=bookstack_db
      - DB_DATABASE=bookstack
      - DB_USERNAME=bookstack
      - DB_PASSWORD=secret
    volumes:
      - ./bookstack:/config
    ports:
      - "127.0.0.1:6875:80"
    depends_on:
      - bookstack_db

  bookstack_db:
    image: mariadb:11
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: bookstack
      MYSQL_USER: bookstack
      MYSQL_PASSWORD: secret
    volumes:
      - ./db:/var/lib/mysql

Nginx reverse proxy + Let’s Encrypt.

---

Структура документации

• Полка: DevOps, Backend, Onboarding
• Книга: «VPS runbooks», «Deploy Laravel»
• Глава: «SSL renew fails», «Restore from Restic»

Ссылка на внешние гайды — ваш блог или internal mirror.

---

Права и роли

• Admin — настройки
• Editor — создание/редактирование
• Viewer — только чтение

Для команды 3–10 человек — достаточно ролей BookStack.

---

Бэкапы

# MariaDB dump + /config volume
mysqldump -u bookstack -p bookstack > wiki-backup.sql
tar czf bookstack-config.tar.gz ./bookstack

Restic на MinIO.

---

Поиск

Встроенный поиск по заголовкам и тексту. Для большого объёма — Meilisearch как external index (опционально).

---

Итог

BookStack на VPS — wiki за вечер. Docker, MariaDB, SSL — и команда пишет runbook’и в одном месте.

VPS 1–2 GB — StormNet Cloud. Секреты — Vault. Git-доки — Gitea.