Установка Plane на свой сервер в Казахстане: Docker-гид для продакшена

Plane ставится на собственный сервер через Docker за один вечер: скрипт setup.sh для Community Edition или установщик prime-cli для Commercial. Продакшен-установка требует ещё нескольких шагов, без которых система не доживёт до первой аварии: заменить пароли по умолчанию в plane.env, настроить домен и SMTP, автоматизировать бэкапы базы и файлов и отработать обновление.

Гид для DevOps-инженеров, системных администраторов и тимлидов в Казахстане, которые разворачивают Plane на виртуальной машине у местного хостера или в своём контуре. Все команды взяты из официальной документации Plane на октябрь 2026 года. Перед установкой сверьтесь с актуальной версией документации: скрипты и пункты меню меняются от релиза к релизу.

Community или Commercial: что ставить

У Plane три self-hosted редакции. Community Edition открыта под AGPL-3.0, бесплатна и по функциям соответствует облачному тарифу Free. Commercial — закрытая редакция с полным функциональным паритетом с облаком: она стартует на бесплатном плане с 12 местами на рабочее пространство, а платные функции включаются лицензионным ключом. Airgapped — вариант Commercial для сетей без доступа в интернет.

Важная деталь: чтобы перейти на платный план, сначала нужно переключиться на Commercial Edition. Если вы почти уверены, что через полгода понадобится SSO или расширенные права, разумно сразу ставить Commercial. Подробное сравнение редакций и расчёт стоимости — в статье о том, какую версию Plane выбрать.

Plane также ставится в Kubernetes. Это оправдано, если в компании уже есть кластер и команда, которая его сопровождает. В этом гиде разбираем Docker Compose на одной виртуальной машине: такой установки хватает большинству небольших и средних команд, а сопровождать её может один инженер.

Требования к серверу и подготовка

Параметр	Минимум по документации	Что мы рекомендуем для продакшена
Процессор	2 ядра, x64 или ARM64	4 ядра для команды от 25 человек
Память	4 ГБ	8 ГБ, как рекомендует Plane
ОС	Ubuntu, Debian, CentOS, Amazon Linux, macOS, Windows с WSL2	LTS-версия Ubuntu или Debian
Docker	Свежая версия Docker Compose	Docker Engine из официального скрипта
Сеть	Порты 80 и 443	Домен, TLS, закрытые лишние порты
Диск	—	Запас под вложения и локальные бэкапы, отдельный том под данные

До установки подготовьте:

1. Виртуальную машину у хостера в Казахстане или в своём дата-центре.
2. Домен или поддомен, например tasks.company.kz, с A-записью на сервер.
3. Доступ по SSH под root или пользователем с sudo.
4. SMTP для уведомлений: корпоративная почта или почтовый сервис.
5. Место для копий бэкапов вне этого сервера.

Контекст Казахстана. На сервере у казахстанского хостера данные хранятся в стране, а оплата идёт в тенге по договору. Учтите, что установка и обновление скачивают скрипты с GitHub и образы из Docker-реестров. Если ИБ закрывает серверу выход в интернет, обычная установка не подойдёт: нужна редакция Airgapped с обновлениями из собственного реестра.

Установка

Community Edition через setup.sh

Установите Docker, если его ещё нет:

curl -fsSL https://get.docker.com | sh -

Создайте папку для установки и скачайте скрипт:

mkdir plane-selfhost
cd plane-selfhost
curl -fsSL -o setup.sh https://github.com/makeplane/plane/releases/latest/download/setup.sh
chmod +x setup.sh
./setup.sh

Скрипт показывает меню: Install, Start, Stop, Restart, Upgrade, View Logs, Backup Data, Exit. Выберите 1 (Install). Скрипт создаст папку plane-app и скачает в неё docker-compose.yaml и plane.env. Затем выйдите из меню, отредактируйте plane.env (следующий раздел), снова запустите ./setup.sh и выберите 2 (Start).

Commercial Edition через prime-cli

Подключитесь к серверу под root или sudo-пользователем и запустите установщик:

curl -fsSL https://prime.plane.so/install/ | sh -

Установщик спросит домен в формате domain.tld или subdomain.domain.tld и предложит режим. Express ставит конфигурацию по умолчанию. Advanced позволяет указать внешнюю базу, Redis и хранилище файлов, и для продакшена документация настойчиво рекомендует именно его. После сообщения об успешной установке активируйте лицензионный ключ, если купили платный план.

Настройка plane.env

В Community Edition до первого запуска нужно пройтись по plane.env. Останавливайте сервисы перед каждым изменением файла.

Переменная	По умолчанию	Что поставить
WEB_URL	http://localhost	Полный адрес, например https://tasks.company.kz
CORS_ALLOWED_ORIGINS	http://localhost	Тот же адрес, что в WEB_URL
APP_DOMAIN	localhost	Ваш домен без протокола
LISTEN_HTTP_PORT, LISTEN_HTTPS_PORT	80, 443	Оставить или сменить, если порты заняты
POSTGRES_PASSWORD	plane	Длинный случайный пароль
Пароль RabbitMQ (RABBITMQ_*)	plane	Длинный случайный пароль; имя переменной сверьте со своим plane.env
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY	access-key, secret-key	Свои ключи для MinIO
SECRET_KEY	не задан	Случайная строка, хранить вместе с бэкапами
FILE_SIZE_LIMIT	5242880 (5 МБ)	Увеличить, если в задачи прикладывают большие файлы
DATABASE_URL, REDIS_URL	пусто	Заполнить, если база и Redis внешние

Два правила. Не оставляйте пароли по умолчанию: они опубликованы в документации. И сохраните plane.env в менеджере секретов: без него бэкап базы восстанавливать сложнее.

Первый вход и настройка инстанса

Откройте адрес из WEB_URL. На экране «Let’s secure your instance» введите почту и пароль: по документации Plane тот, кто первым поднимает инстанс, становится его администратором. После этого откроется панель /god-mode.

В панели администратора сделайте по порядку:

• Задайте имя инстанса и решите, оставлять ли телеметрию.
• Настройте SMTP. Документация советует делать это в интерфейсе, а не через файл окружения.
• В разделе аутентификации выключите регистрацию без приглашения и включите нужные способы входа, включая SSO, если он доступен в вашей редакции.
• Запретите создавать рабочие пространства всем, кроме администратора.

Затем создайте рабочее пространство, первый проект и пригласите пилотную команду. Если переезжаете с Jira, импортер Plane перенесёт задачи, комментарии, вложения, спринты и пользователей. План переезда разобран в статье о миграции с Jira на Plane.

Бэкапы PostgreSQL и файлов

Plane состоит из нескольких контейнеров. Не все из них нужно бэкапить, но потеря любого из трёх хранилищ данных болезненна.

Компонент	За что отвечает	Что бэкапить
plane-db (PostgreSQL)	Задачи, проекты, пользователи, комментарии, страницы	Обязательно, ежедневно
plane-minio (хранилище файлов)	Вложения, изображения, файлы в описаниях	Обязательно, вместе с базой
plane-redis	Кэш и служебные данные	Включено в штатный бэкап, критичность ниже
plane-mq (RabbitMQ)	Очередь фоновых задач	Не требуется
api, worker, beat-worker	Бэкенд и фоновые задачи по расписанию	Не требуется, восстанавливаются из образов
web, space, admin, live	Интерфейс, публичные страницы, админка, работа в реальном времени	Не требуется
proxy	Входящие запросы и TLS	Не требуется, но сертификаты при своей схеме TLS храните отдельно
plane.env	Конфигурация и секреты	Обязательно, вручную

В Community Edition запустите ./setup.sh и выберите 7 (Backup Data). Скрипт сохранит pgdata.tar.gz, redisdata.tar.gz и uploads.tar.gz в папку plane-app/backup/<отметка времени>. Для восстановления документация предлагает отдельный скрипт:

curl -fsSL -o restore.sh https://raw.githubusercontent.com/makeplane/plane/refs/heads/preview/deployments/cli/community/restore.sh
chmod +x restore.sh
./restore.sh <папка с архивами *.tar.gz>
./setup.sh start

Перед восстановлением Plane должен быть установлен, запущен и затем остановлен.

В Commercial бэкап делает sudo prime-cli backup, архивы по умолчанию лежат в /opt/plane/backups. Восстановление: sudo prime-cli restore, оно перезаписывает текущие данные, поэтому сначала убедитесь, что выбран нужный архив. Файл plane.env (в Commercial он в /opt/plane) в обеих редакциях копируйте вручную.

Помните, что бэкап на том же сервере не защищает от потери самого сервера. Если у хостера откажет диск или виртуальную машину удалят по ошибке, локальная папка с архивами исчезнет вместе с данными.

Чего нет в штатных скриптах и что нужно добавить самим: запуск по расписанию через cron, копирование архивов на другую площадку и проверку восстановления на отдельной машине хотя бы раз в квартал.

Обновление и мониторинг

Порядок обновления Community Edition:

1. Сделайте бэкап.
2. Скачайте свежий setup.sh той же командой, что при установке.
3. Запустите ./setup.sh и выберите 5 (Upgrade).
4. Сравните variables-upgrade.env со своим plane.env и перенесите новые переменные. Сам plane.env скрипт не перезаписывает.
5. Запустите сервисы пунктом 2 (Start) и проверьте вход, создание задачи и загрузку файла.

Инструкция относится к версиям от 0.14.0. С более старых версий сначала нужен отдельный переход на 0.14.0. В Commercial обновление делается двумя командами: sudo prime-cli update-cli и sudo prime-cli upgrade.

Для мониторинга достаточно простого набора: внешняя проверка доступности адреса из WEB_URL, алерт на заполнение диска и памяти, ежедневная проверка, что свежий бэкап появился. Логи сервисов смотрите пунктом 6 (View Logs) в меню setup.sh.

Типичные проблемы

• Не работает вход или запросы падают с ошибками CORS. Проверьте, что WEB_URL, CORS_ALLOWED_ORIGINS и APP_DOMAIN указывают на один и тот же адрес с правильным протоколом.
• Сервисы не стартуют. Часто порты 80 или 443 уже заняты другим веб-сервером. Освободите их или смените LISTEN_HTTP_PORT и LISTEN_HTTPS_PORT.
• Не приходят письма. SMTP не настроен в /god-mode или хостер блокирует исходящие почтовые порты.
• Не загружаются вложения. Файл больше FILE_SIZE_LIMIT или неверно заданы ключи MinIO.
• После обновления что-то сломалось. Не перенесены новые переменные из variables-upgrade.env. Сверьте файлы и перезапустите.
• Система тормозит. Памяти меньше рекомендуемых 8 ГБ, а команда выросла. Добавьте ресурсов или вынесите базу на отдельный сервер.

Как мы это делаем

Мы не начинаем с установки. Сначала диагностика: сколько людей придёт в Plane, какая редакция нужна, где будет сервер и кто станет его владельцем. Затем ставим Plane на сервер в Казахстане, меняем секреты, настраиваем TLS, SMTP, SSO, бэкапы по расписанию с копией на другую площадку и мониторинг. Запускаем пилот с одной командой и только после него переносим остальных.

Подробности на странице внедрения таск-трекеров Jira и Plane. Там же можно заказать сопровождение сервера, если своего DevOps-инженера нет.

---

Источники. Официальная документация Plane (установка через Docker Compose, переменные окружения, бэкап и восстановление, обновление, панель администратора, редакции) и репозиторий проекта на GitHub. Данные на октябрь 2026 года.

Термины простыми словами

Docker и Docker Compose

Способ запускать программу в готовых изолированных «контейнерах». Compose поднимает все части Plane одной командой на одном сервере, поэтому установку может сопровождать один инженер.

Self-hosted

Программа, которую компания ставит на свой сервер, а не использует в облаке вендора. Данные остаются у вас, но установка, бэкапы и обновления тоже на вас.

AGPL-3.0

Открытая лицензия, под которой выпущена Community Edition. Разрешает бесплатно ставить и использовать Plane у себя; если вы меняете код и даёте доступ по сети, изменения нужно открыть.

Airgapped

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

SMTP

Протокол отправки электронной почты. Через него Plane рассылает уведомления и приглашения; без настроенного SMTP письма сотрудникам не приходят.

SSO (Single Sign-On)

Единый вход: сотрудник заходит в Plane под той же учётной записью, что и в другие корпоративные системы. В Plane эта функция есть в платных планах Commercial.

plane.env

Файл настроек Plane: адрес сайта, пароли к базе и хранилищу, секретный ключ. Его нужно заполнить до запуска и хранить отдельно, иначе бэкап восстановить сложнее.

Бэкап PostgreSQL

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