Установка Docmost на свой сервер: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка Docmost на свой сервер». Страница справочника целиком: Установка Docmost.

Коротко о теме

Установка Docmost на VPS через Docker Compose: приложение, PostgreSQL и Redis, ключ APP_SECRET, домен с HTTPS, пространства, копии базы и обновление.

Подробности по разделам

Что такое Docmost и чем он отличается от Notion и BookStack

От BookStack это движок, где важнее живая работа над страницей, чем жёсткая структура полок и книг. Остальные варианты сведены на странице self hosted wiki.

Что нужно Docmost: PostgreSQL, Redis и сколько памяти

Три ответа, и калькулятор подберёт готовую конфигурацию

Домен, APP_URL и HTTPS для Docmost

Совместная правка идёт по WebSocket, поэтому в Nginx добавьте заголовки Upgrade и Connection, иначе страницы будут открываться, но правки коллег не появятся. Порт 3000 в compose привяжите к 127.0.0.1.

Пространства, группы и права в Docmost

Часть функций доступна только с платной лицензией: по странице установки, это Bases, единый вход SSO, ИИ-функции, журнал аудита и подключение каталога пользователей SCIM. Если сотрудникам нужен вход через Keycloak или другой SSO, сверьтесь с условиями редакции заранее. Рассылка приглашений требует SMTP, переменные для него перечислены в документации Docmost.

Копии и обновление Docmost без потери страниц

Расписание копий и вынос с сервера: сервер для бэкапов. Обновление делается командами docker compose pull и docker compose up -d. Перед этим сделайте дамп: обновление может изменить схему базы, а вернуть её назад можно только из копии.

Ключевые цифры

Термины на странице

Redis
Redis это хранилище данных в памяти. Его используют как кеш и очередь задач.
PostgreSQL
PostgreSQL это база данных для приложений с большими объёмами и сложными запросами.
Nginx
Nginx это веб-сервер и обратный прокси. Его часто ставят перед приложением, чтобы раздавать статику и держать HTTPS.
A-запись
A-запись связывает домен с IPv4-адресом сервера.
Certbot
Certbot это программа, которая получает и продлевает сертификаты Let's Encrypt на сервере.
SMTP
SMTP это протокол отправки писем.
Облачный сервер
Облачный сервер это VPS, ресурсы которого можно менять на ходу, а оплата часто почасовая.
Поддомен
Поддомен это адрес внутри домена, например shop.example.ru.

Что проверить

  1. Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
  2. Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
  3. Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.
  4. Храните данные контейнеров в томах.
  5. Закрепляйте версии образов, а не latest.
  6. Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.

Связанные страницы