Outline

В Outline страница принадлежит коллекции: например, «Регламенты команды» объединяет онбординг и порядок дежурства. Внутри документа есть заголовки, списки и вложения. Ссылку на инструкцию можно оставить прямо в рабочем обсуждении.

Редактор сохраняет изменения без отдельной кнопки. На стенде текст пережил перезагрузку страницы, а вложение после остановки и запуска стека скачалось с исходным содержимым.

Для двух связанных инструкций откройте контекстное меню документа в боковой панели и выберите Open in split view. Онбординг останется слева, регламент откроется справа.

Это удобная замена разделу документации в Notion или Confluence: сотрудник читает порядок работы и тут же уточняет соседний документ. Коллекцию можно закрыть от остальных участников.

Прежняя статья описывала 1.9.1. В 1.10.0 появились два документа рядом, комментарии для пользователей с правом чтения и перестановка элементов боковой панели.

В 1.11.0 добавлены ручки переноса блоков и импорт Open Knowledge Format, который появился как формат экспорта в 1.10.1. В настройках импорта теперь есть отдельная строка OKF.

В новых релизах исправлялись проверки доступа к импорту, скачиванию и API. Эти записи release notes не имеют присвоенной серьезности. Они не равны опубликованным GHSA: ни один из 26 бюллетеней по указанным диапазонам не затрагивает прежнюю 1.9.1.

Установка по-прежнему требует PostgreSQL и Redis. На свежей 1.11.0 миграции выполнились при старте автоматически: прежнюю отдельную команду миграции из инструкции убрали.

Сравнивайте стоимость своего сервера для Community с облачными тарифами, которые включают обслуживание у вендора.

Цены показаны на прайсе Outline, Notion и Confluence 16 октября 2026 года. Период оплаты и состав команды меняют счет; у Notion получена EUR-версия страницы.

В своей Community платите за сервер, резервные копии и обслуживание. Считать ее равной платному облаку только по числу мест нельзя: корпоративные возможности продаются отдельно.

Outline на Node.js и TypeScript хранит документы, пользователей и права в PostgreSQL. Redis обслуживает очередь фоновых задач и взаимодействие процессов. Редактор использует ProseMirror и Y.js.

В инструкции пять контейнеров: приложение, база, Redis, Caddy и MailHog. Caddy принимает HTTPS; порт приложения доступен только на localhost. MailHog принимает тестовые письма локально, его интерфейс открывается через SSH-туннель.

Документы и вложения лежат в разных постоянных томах. Пересоздание контейнера приложения их не удаляет. Для восстановления нужны база, файлы и прежние секреты из /opt/outline/.env.

Наш стенд - CPU2-RAM4-DISK50: 2 vCPU, 4 ГБ RAM, 50 ГБ диска, Ubuntu 24.04.4, Docker 29.9.1. Этот тариф за 500 руб./мес вместил приложение, зависимости и проверку импорта.

Загрузили 100 регламентов общим размером 1,6 МиБ и CSV на 4,14 МиБ. База выросла с 11 до 13 МиБ; после работы стек занимал 384 МиБ.

Для такого набора CPU2-RAM4-DISK50 дает запас под ОС, кеш и обновление. Импорт завершился примерно за семь секунд. После повторного запуска документ открылся, а скачанный CSV совпал с исходным.

Проверено на версии v1.11.0, 16 октября 2026. На новых версиях результаты могут отличаться.

Нужны чистая Ubuntu, доступ SSH с sudo и доменное имя. Сначала запустим локальный приемник почты; затем подключим рабочий SMTP.

1. Установите Docker

   На чистой Ubuntu 24.04 войдите по SSH и выполните sudo -i. Дальше команды идут от root в одной сессии. Подключите официальный репозиторий Docker:

   apt-get update
   apt-get install -y ca-certificates curl
   install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable' > /etc/apt/sources.list.d/docker.list
   apt-get update
   apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

2. Задайте адрес и секреты

   Замените ваш-домен на имя, которое указывает на сервер. На Fatmetal подойдет его IP с дефисами вместо точек и окончанием .fatmetal.net. Откройте входящие 80/443; создайте конфигурацию:

   install -d -m 0755 /opt/outline
   cd /opt/outline
   umask 077
   DOMAIN=ваш-домен
   PG_PASSWORD=$(openssl rand -hex 16)
   cat > .env <<EOF
   NODE_ENV=production
   URL=https://$DOMAIN
   PORT=3000
   FORCE_HTTPS=false
   SECRET_KEY=$(openssl rand -hex 32)
   UTILS_SECRET=$(openssl rand -hex 32)
   PG_PASSWORD=$PG_PASSWORD
   DATABASE_URL=postgres://outline:$PG_PASSWORD@postgres:5432/outline
   PGSSLMODE=disable
   REDIS_URL=redis://redis:6379
   FILE_STORAGE=local
   FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data
   DEFAULT_LANGUAGE=en_US
   SMTP_HOST=mailhog
   SMTP_PORT=1025
   SMTP_FROM_EMAIL=outline@$DOMAIN
   SMTP_SECURE=false
   EOF
   chmod 600 .env

3. Опишите пять сервисов

   Версия приложения закреплена тегом 1.11.0. Проверки готовности не дают запустить его раньше базы и Redis. Только Caddy получает публичные порты:

   cat > compose.yaml <<'YAML'
   name: outline
   services:
     postgres:
       image: postgres:16-alpine
       environment: {POSTGRES_USER: outline, POSTGRES_DB: outline, POSTGRES_PASSWORD: "${PG_PASSWORD}"}
       volumes: ["pgdata:/var/lib/postgresql/data"]
       restart: unless-stopped
       healthcheck: {test: ["CMD-SHELL", "pg_isready -U outline -d outline"], interval: 5s, timeout: 3s, retries: 20}
     redis:
       image: redis:7-alpine
       volumes: ["redisdata:/data"]
       restart: unless-stopped
       healthcheck: {test: ["CMD", "redis-cli", "ping"], interval: 5s, timeout: 3s, retries: 20}
     mailhog:
       image: mailhog/mailhog:v1.0.1
       ports: ["127.0.0.1:8025:8025"]
       restart: unless-stopped
   YAML

4. Добавьте приложение и TLS

   Допишите тот же compose-файл. Постоянный том сохраняет вложения, Caddy отвечает за сертификат:

   cat >> compose.yaml <<'YAML'
     outline:
       image: outlinewiki/outline:1.11.0
       env_file: .env
       ports: ["127.0.0.1:3000:3000"]
       volumes: ["storage:/var/lib/outline/data"]
       restart: unless-stopped
       depends_on:
         postgres: {condition: service_healthy}
         redis: {condition: service_healthy}
       healthcheck: {test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/_health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"], interval: 10s, timeout: 5s, retries: 20}
     caddy:
       image: caddy:2.11.7
       ports: ["80:80", "443:443"]
       volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "caddy_data:/data", "caddy_config:/config"]
       restart: unless-stopped
       depends_on: {outline: {condition: service_healthy}}
   volumes: {pgdata: {}, redisdata: {}, storage: {}, caddy_data: {}, caddy_config: {}}
   YAML
   printf '%s {\n reverse_proxy outline:3000\n}\n' "$DOMAIN" > Caddyfile

5. Поднимите стек

   Скачайте образы и дождитесь готовности. Миграции пустой базы выполняются автоматически. Первый pull на стенде занял около 44 секунд; после готовности дайте Caddy 15 секунд на выдачу сертификата:

   docker compose config --quiet
   docker compose pull
   docker compose up -d --wait --wait-timeout 240
   sleep 15
   curl -I https://ваш-домен

Откройте HTTPS-адрес сразу после запуска. В Create workspace укажите название пространства, имя и email администратора, нажмите Continue. Первый вход проходит без письма. Создайте коллекцию через New collection и страницу через New doc.

Для повторного входа нажмите Continue with Email, введите тот же email и выберите Sign In. На своем компьютере откройте туннель:

ssh -L 8025:127.0.0.1:8025 пользователь@ваш-домен

В браузере откройте http://localhost:8025, найдите письмо и перейдите по ссылке в том же браузере, где запросили вход. Это локальная проверка: MailHog не доставляет письма сотрудникам.

В /opt/outline/.env замените настройки локального приемника параметрами своего SMTP. Сервер, отправителя и учетку выдаст ваш почтовый сервис; для порта 587 используйте STARTTLS:

SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=ваш-логин
SMTP_PASSWORD=ваш-пароль
SMTP_FROM_EMAIL=wiki@example.com
SMTP_SECURE=false
SMTP_TLS_REJECT_UNAUTHORIZED=true

Примените изменения и запросите новое письмо входа:

cd /opt/outline
docker compose up -d --force-recreate outline

На стенде Outline отправил письмо через SMTP с проверкой сертификата, оно дошло в настоящий ящик и открыло рабочее пространство. Старую ссылку повторно не используйте: запросите новую в форме входа.

cd /opt/outline
docker compose logs --tail=30 caddy
curl -I https://ваш-домен

Базовая диагностика приложения: docker compose ps и docker compose logs --tail=50 outline. В готовом стеке PostgreSQL, Redis и Outline отмечены healthy.

В одной root-сессии остановите запись приложения. Сохраните дамп, файловый том и конфигурацию; затем верните приложение в работу. Каталог копии содержит секреты, доступ к нему должен оставаться закрытым.

cd /opt/outline
umask 077
mkdir -p backup
docker compose stop outline
docker compose exec -T postgres pg_dump -U outline -Fc outline > backup/db.dump </dev/null
docker compose cp -a outline:/var/lib/outline/data/. backup/files
cp .env compose.yaml Caddyfile backup/
docker compose start outline

Сохраните копию за пределами сервера. На своем компьютере подставьте выданное имя SSH-пользователя и выполните:

ssh пользователь@ваш-домен 'sudo tar -C /opt/outline -czf - backup' > outline-backup.tgz

Восстановление на этом же стеке заменяет текущую базу копией. Остановите приложение, восстановите файлы и дамп, затем проверьте документ и скачайте вложение:

cd /opt/outline
docker compose stop outline
cp backup/.env .env
docker compose cp -a backup/files/. outline:/var/lib/outline/data/
docker compose exec -T postgres pg_restore -U outline -d outline --clean --if-exists < backup/db.dump
docker compose start outline

Для обновления сначала сделайте такую копию. Укажите выбранный тег Outline в compose.yaml, затем выполните:

cd /opt/outline
docker compose pull outline
docker compose up -d --wait --wait-timeout 240
docker compose logs --tail=30 outline

Секреты .env при обновлении сохраняйте. После запуска откройте прежний документ и вложение. Дамп без файлового тома не восстанавливает вложения.

Версия 1.11.0 из инструкции содержит исправления перечисленных бюллетеней. Если установлена затронутая версия, сохраните копию и обновите тег по командам выше. Прежняя проверенная 1.9.1 уже новее всех указанных исправлений.

• SMTP доставляет ссылки входа и уведомления в рабочие ящики.
• Keycloak или Authentik служат провайдерами OIDC, если в компании уже есть единая учетная запись.
• Система резервного копирования забирает каталог backup за пределы сервера: база и файлы нужны вместе.

Для переноса Markdown используйте Settings → Import. На стенде ZIP со ста регламентами превратился в документы отдельной коллекции. По завершении появилось состояние Completed.