Как развернуть ERPNext на VPS через Docker
Пошаговое руководство по установке ERPNext на собственном сервере. Разбираем настройку стека из 11 контейнеров, конфигурацию TLS, отправку почты и правила миграции базы данных.
Что вы берете на себя при запуске
Self-hosting ERPNext на VPS — это задача по администрированию, а не установка одной командой. Официальный стек Docker Compose состоит из одиннадцати контейнеров, в которых хранятся ваша главная бухгалтерская книга и записи о клиентах. Это повышает требования ко всему, что описано ниже: резервная копия не считается таковой, пока вы её не восстановили, а не зафиксированный тег образа — это потенциальная проблема при миграции схемы базы данных.
В тексте часто встречаются несколько названий. ERPNext — это бизнес-приложение. Frappe — это Python-фреймворк, на котором оно работает. Bench — это инструмент командной строки для управления сайтами, который уже установлен внутри контейнеров. Сайт — это один арендатор: одна база данных MariaDB плюс один каталог с загруженными файлами. Почти каждая команда здесь выполняется bench внутри контейнера backend для конкретного сайта.
В этом руководстве используется репозиторий frappe_docker — это вариант развертывания, поддерживаемый проектом. Все приведенные ниже команды были проверены на соответствие этому репозиторию в августе 2026 года. Если Docker Compose для вас в новинку, в статье запуск Docker Compose на VPS описаны основы, которые подразумеваются в данном руководстве.
Сколько ресурсов VPS требуется для ERPNext?
Данные, на которых построен график
[
{
"label": "Evaluation",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 40
},
{
"label": "Small production",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 100
},
{
"label": "Room to grow",
"vcpu": 4,
"ram_gb": 16,
"disk_gb": 160
}
]Для ознакомления начните с 2 vCPU и 4 ГБ оперативной памяти. Это уровень для оценки возможностей системы. Данные значения являются отправной точкой, а не результатами измерений из этого руководства; реальные требования зависят от объема ваших документов. Последняя строка не является официально опубликованным минимумом. Она лишь предоставляет больше свободного места в памяти, но не гарантирует, что она никогда не закончится.
Будьте реалистичны в отношении младших тарифных планов. VPS с 1 ГБ или 2 ГБ оперативной памяти оставляет мало свободного пространства для десяти постоянно работающих контейнеров, буферного пула MariaDB и Python-воркера, формирующего отчет. При нехватке памяти механизм kernel out of memory killer может остановить контейнер, и команда docker inspect покажет для него "OOMKilled": true с кодом завершения 137. Воркер, остановленный в процессе выполнения задачи, оставляет отправленный документ с незавершенной фоновой обработкой.
Для компании, использующей ERPNext ежедневно, планируйте конфигурацию от 8 ГБ оперативной памяти и 4 vCPU с 100 ГБ SSD, а затем протестируйте свою рабочую нагрузку. Оперативная память заканчивается в первую очередь. Дисковое пространство расходуется быстрее, чем ожидается, так как все вложения и локальные резервные копии сохраняются на том же томе, что и база данных.
Одиннадцать контейнеров и назначение каждого из них
Запустите docker compose ps после того, как стек поднят и работают десять контейнеров. Еще один, configurator, выполняет свою задачу один раз и завершается, поэтому в сумме их одиннадцать.
backendзапускает приложение Frappe под управлением gunicorn. Здесь находитсяbench.frontend— это nginx. Он отдает статические файлы и передает все остальные запросы на backend.queue-shortиqueue-long— это воркеры RQ (Redis Queue). Они выполняют фоновые задачи, такие как отправка электронной почты, импорт данных и формирование отчетов.schedulerзапускает задачи по расписанию, включая автоматическую генерацию отчетов и повторяющиеся документы.websocket— это процесс socket.io, отвечающий за обновления в реальном времени в браузере.db— это MariaDB.redis-cacheиredis-queue— два отдельных экземпляра Redis: один для кэша, другой для очереди задач.proxy— это Traefik, добавленный через HTTPS override. Он занимает порты 80 и 443 и получает сертификаты.
Это разделение важно изучить, так как оно указывает, какой лог нужно читать. Если зависла отправка почты — это проблема воркера очереди, поэтому правильной командой будет docker compose logs -f queue-short. Если страница загружается, но уведомления на ней не обновляются — это проблема веб-сокетов. Чтение логов backend в обоих случаях — пустая трата времени.
Установка с использованием production-файлов compose, а не демонстрационных
Репозиторий поставляет pwd.yml, и в README прямо сказано: «Эта конфигурация предназначена только для краткосрочного ознакомления. Вы не сможете устанавливать пользовательские приложения в эту среду». Используйте её, чтобы ознакомиться с ERPNext в течение пары часов. Не запускайте на ней рабочие процессы компании.
sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.envОткройте ~/gitops/erpnext.env и измените четыре значения. ERPNEXT_VERSION фиксирует тег образа. DB_PASSWORD поставляется как 123 в примере файла. SITES_RULE — это правило маршрутизации Traefik, а LETSENCRYPT_EMAIL задает email для учетной записи ACME. Let's Encrypt прекратил рассылку уведомлений об истечении срока действия сертификатов 4 июня 2025 года, поэтому отслеживайте срок действия сертификатов отдельно.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comТеперь сгенерируйте один файл compose, а затем запустите его.
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
export COMPOSE_FILE="$HOME/gitops/erpnext.yaml"config ничего не запускает. Он объединяет базовый файл с переопределениями и выводит результат с уже подставленными переменными. Затем вы запускаете этот сгенерированный файл. Этот дополнительный шаг оправдан: работающий стек представляет собой один файл, который можно прочитать, поэтому он не изменится неожиданно, если кто-то отредактирует файл env или если вы обновите репозиторий. как объединяются несколько файлов Docker Compose подробно объясняет правила переопределения.
Экспорт COMPOSE_FILE заставляет команды ниже использовать сгенерированный файл. Повторяйте его в каждой новой оболочке; в cron передавайте -f ~/gitops/erpnext.yaml явно.
Дождитесь запуска db и завершения configurator, что занимает несколько секунд, затем создайте сайт.
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--install-app erpnext \
--admin-password '<a strong admin password>' \
erp.example.comПроверьте его:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps должен вывести frappe и erpnext с их версиями. Исправный ps показывает десять сервисов в состоянии running и ни одного в restarting.
Здесь часто возникают две проблемы. --mariadb-user-host-login-scope=% задает пользователю базы данных нового сайта область действия хоста с подстановочным знаком, чтобы он мог войти в систему, даже если Docker назначит контейнеру приложения другой адрес. Без этого Frappe ограничивает пользователя текущим подключающимся хостом. Контейнер приложения обращается к MariaDB через сеть Docker, поэтому он определяется как удаленный хост, и пользователь базы данных, ограниченный localhost, не сможет оттуда подключиться. Эта опция меняет пользователя базы данных сайта, а не учетную запись root. Область действия % разрешает подключения с любого хоста, который имеет доступ к MariaDB, поэтому держите базу данных во внутренней сети Docker.
Вторая проблема — имя сайта. По умолчанию фронтенд выбирает, какой сайт обслуживать, на основе HTTP-заголовка Host, поэтому сайт, созданный как erpnext, будет недоступен по адресу erp.example.com, даже если оба существуют. Называйте сайт в соответствии с доменом, как показано выше, или установите FRAPPE_SITE_NAME_HEADER в файле env на имя сайта и снова сгенерируйте файл compose.
HTTPS и условия, необходимые для его работы
Переопределение compose.https.yaml запускает Traefik на порту 443, перенаправляет на него запросы с порта 80 и запрашивает сертификаты у Let's Encrypt. TLS (transport layer security) предотвращает передачу счетов и сессионных cookie в открытом виде.
Для выпуска сертификата должны быть соблюдены два условия. DNS A-запись для erp.example.com уже должна указывать на VPS. Порты 80 и 443 должны быть доступны из Интернета, так как Let's Encrypt проверяет владение доменом с помощью HTTP-01 challenge на порту 80. Проверьте сетевой брандмауэр провайдера и брандмауэр на самом сервере. Это независимые уровни контроля, и про брандмауэр в панели управления часто забывают.
Сертификаты сохраняются в томе cert-data по пути /letsencrypt/acme.json. Если браузер показывает сертификат по умолчанию вместо вашего, найдите имя прокси-сервиса в docker compose --project-name erpnext ps и изучите его логи на предмет ошибок ACME (automatic certificate management environment). Запускаете другие веб-приложения на этом же сервере? В одном экземпляре Traefik перед несколькими приложениями Docker Compose показано, как использовать общий прокси, чтобы избежать конфликтов за порт 443. Второе приложение на таком сервере часто предназначено для клиентов, а self-hosted служба поддержки Chatwoot работает за тем же прокси, поэтому сотрудники, работающие со счетами, могут отвечать на письма и сообщения клиентов в одном месте.
Исходящая почта: почему счета не покидают сервер
Этот этап пропускают большинство руководств по ERPNext, хотя именно от него зависит полезность всей системы. Без настроенной исходящей почты клиенты не получают счета, пользователи не могут сбросить пароль, а запланированные отчеты не доставляются. В составе стека нет собственного почтового сервера.
Не пытайтесь отправлять почту напрямую с VPS через 25 порт. Провайдеры, такие как AWS, блокируют исходящий 25 порт по умолчанию, а новый IP-адрес без истории отправлений повышает риск отклонения писем или попадания в спам. Используйте аутентифицируемый релей на 587 порту и предварительно изучите правила вашего провайдера: например, DigitalOcean по умолчанию блокирует порты 25, 465 и 587 на Droplets.
Поддерживаемый способ настройки — экран Email Account в интерфейсе ERPNext, который сохраняет пароль в зашифрованном виде. Вы также можете прописать ключи непосредственно в конфигурацию сайта:
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_server smtp.example.com
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_port 587 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config use_tls 1 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_login 'erp@example.com'
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config auto_email_id 'erp@example.com'--parse сохраняет 587 как число, а не как строку "587". Прочитайте файл и убедитесь, что эти два значения не заключены в кавычки:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonДля хранения пароля в зашифрованном виде настройте исходящий сервер, логин и пароль в интерфейсе Email Account. Поле пароля в этом меню не устанавливает отдельный ключ mail_password в конфигурации сайта.
Затем отправьте реальное сообщение. Создайте Sales Invoice, отправьте его на адрес, который вы контролируете, и наблюдайте за очередью в процессе:
docker compose --project-name erpnext logs -f queue-shortИсходящая почта обрабатывается фоновым заданием, поэтому письмо, которое не дошло, обычно отображается как неудачное задание в этом логе, а не как ошибка в браузере. Опубликуйте записи SPF (sender policy framework) и DKIM (domainkeys identified mail) для домена отправителя, а затем добавьте политику DMARC. Без аутентификации технически корректный счет рискует быть отклоненным или попасть в спам. Если вы предпочитаете контролировать весь путь доставки, собственный почтовый сервер Mailcow предоставит вам релей под вашим управлением на отдельном от ERP сервере.
Резервные копии, которые действительно восстанавливаются
Дамп базы данных сам по себе не является резервной копией ERPNext. Вложения и приватные файлы хранятся в каталоге sites, а не в MariaDB. Если восстановить только базу данных, каждый загруженный заказ на закупку превратится в неработающую ссылку.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesЭта команда записывает четыре файла в sites/erp.example.com/private/backups внутри тома sites:
- дамп
-database.sql.gz - архив
-files.tarпубличных файлов - архив
-private-files.tarприватных файлов - копию
-site_config_backup.jsonконфигурации сайта
Четвертый файл — это то, что люди часто удаляют, и именно его потеря приводит к проблемам. Он содержит encryption_key — ключ, который Frappe использует для шифрования сохраненных паролей: учетных данных почтовых аккаунтов, ключей платежных шлюзов и всех секретов интеграций. Если восстановить базу данных без соответствующего ключа, сайт загрузится нормально, но отправка почты завершится ошибкой:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonВсегда храните все четыре файла вместе.
Затем переместите их с сервера. Резервная копия внутри тома не переживет выход сервера из строя, к тому же bench удаляет её: по умолчанию он стирает резервные копии старше 23 часов из этого каталога. До версий Frappe 16.20.0 и 15.114.0 это значение по умолчанию составляло 24 часа, а ключ keep_backups_for_hours в конфигурации сайта позволяет переопределить этот параметр.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsЗапускайте эту команду через cron, а затем отправляйте каталог туда, где вы не являетесь администратором. зашифрованные резервные копии restic во внешнее хранилище — подходящий инструмент, так как он выполняет шифрование перед загрузкой, а restic check подтверждает, что репозиторий по-прежнему доступен для чтения. Резервная копия ERP — это копия всей вашей бухгалтерской книги, поэтому она должна храниться в зашифрованном виде на другом оборудовании.
Проверяйте восстановление до того, как оно понадобится
Непроверенная резервная копия — это лишь предположение. Тестируйте восстановление на отдельном сайте на том же сервере, никогда не делайте этого на рабочей среде.
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--admin-password '<a strong admin password>' \
restore-test.example.com
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com --force restore \
sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
--with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
--with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
--db-root-password '<your DB_PASSWORD>'Скопируйте ключ шифрования из конфигурации резервной копии в восстановленный сайт, иначе интеграции останутся нерабочими:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Теперь проверьте восстановление так, как это сделал бы бухгалтер. Откройте отчет о дебиторской задолженности и сравните итоговый баланс с данными на рабочем сайте. Откройте недавний счет на оплату и скачайте вложение. Сайт, который просто отображает страницу входа, не является доказательством успешного восстановления.
Удалите тестовый сайт после завершения проверки:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comПочему фиксация версии критически важна для ERPNext
Для статического сайта нефиксированный тег образа означает лишь неожиданный перезапуск. Для ERPNext это означает миграцию схемы базы данных. bench migrate переписывает таблицы базы данных и может изменять данные документов, при этом функция отмены отсутствует. Откат возможен только через восстановление из резервной копии, а не через docker compose down.
Поэтому фиксируйте тег. ERPNEXT_VERSION=v16.32.1 был релизом, зафиксированным в собственном pwd.yml репозитория в августе 2026 года. На 2026-11-16 и pwd.yml, и example.env использовали v16.55.0. Не переносите ни один из этих номеров без предварительной проверки. Текущие релизы перечислены на странице релизов frappe/erpnext, а существующие теги образов доступны на Docker Hub. Перед переходом на новую версию обязательно ознакомьтесь с примечаниями к ней.
Само обновление начинается с создания резервной копии и перевода системы в режим обслуживания.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-files
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode onОтредактируйте ERPNEXT_VERSION в ~/gitops/erpnext.env, затем выполните рендеринг, загрузку образа и миграцию.
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
docker compose --project-name erpnext exec backend \
bench --site erp.example.com migrate
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode offРежим обслуживания важен, так как migrate изменяет схему во время выполнения. Если пользователь отправит документ в момент, когда таблица мигрирована лишь частично, вам придется исправлять записи вручную.
Выполняйте переход по одной мажорной версии за раз, создавая резервную копию между каждым шагом. Перед продолжением проверяйте руководство по миграции для каждой мажорной версии.
Репозиторий также поставляет overrides/compose.migrator.yaml, который добавляет контейнер, запускающий bench --site all migrate при старте, если сайты существуют и включен MIGRATE_SITES (что является настройкой по умолчанию). Это удобно. Однако это также означает, что docker compose up с измененным тегом выполнит миграцию вашей рабочей базы данных без вашего контроля. В бизнес-системах запускайте миграцию как осознанное решение, принятое в начале рабочего дня.
Защита сервера с данными клиентов
Смените пароль администратора при первом входе в систему. В демонстрационном файле compose в качестве пароля по умолчанию используется admin, и эта привычка часто переносится в рабочие окружения.
Измените DB_PASSWORD, удалив значение 123 из файла example.env. Это значение попадает в сгенерированный файл ~/gitops/erpnext.yaml в открытом виде, поэтому используйте chmod 600 для этого файла и не добавляйте его в репозитории git. Для более надежной защиты используйте overrides/compose.mariadb-secrets.yaml, чтобы считывать пароль из файла Docker secret вместо переменной окружения. В разделе работа с файлами окружения и секретами в Docker Compose описаны все нюансы этого подхода.
Открывайте только необходимые порты. При использовании HTTPS-прокси должны быть открыты только порты 80 и 443. Не добавляйте маппинг ports для сервиса db, чтобы упростить подключение клиента базы данных: это сделает MariaDB доступной из публичного интернета. Вместо этого используйте docker compose --project-name erpnext exec backend bench mariadb. На хосте разрешите порты 22, 80 и 443, запретите все остальные и дополнительно проверьте настройки сетевого межсетевого экрана вашего провайдера.
Включите двухфакторную аутентификацию в настройках системы (System Settings) для каждой учетной записи с ролью System Manager. Эта роль позволяет изменять системные настройки, поэтому относитесь к ней как к учетной записи администратора, а не как к средству для удобства. Если вы используете несколько self-hosted приложений, лучше настроить Authentik как провайдер единого входа (SSO), чем создавать отдельный пароль для каждого приложения.
Устанавливайте обновления безопасности на хост и перезагружайте его для применения обновлений ядра. Прежде чем полагаться на автоматический запуск стека после перезагрузки, проверьте наличие политики restart для каждого сервиса в сгенерированном файле, так как стек без этой политики не запустится автоматически. В разделе настройка автоматического запуска стека Docker Compose после перезагрузки описана работа с systemd.
Когда ERPNext перестает комфортно работать на одном VPS
Один VPS может долгое время обслуживать небольшую компанию. Признаки того, что ресурсов больше не хватает:
- Фоновые задачи накапливаются, из-за чего электронные письма и импорт данных приходят с задержкой в минуты или часы.
docker inspectсообщает о контейнерах с"OOMKilled": trueили кодом завершения 137.- Отчеты, которые раньше формировались за две секунды, теперь требуют тридцать, а процесс MariaDB потребляет все ресурсы CPU.
- Резервное копирование длится так долго, что накладывается на следующий запланированный запуск.
Начните с выделения MariaDB ресурсов, которые она не будет ни с кем делить, так как база данных и Python-воркеры конкурируют за одну и ту же память, а буферному пулу требуется её всё больше. Увеличение мощности сервера приложений помогает меньше, чем ожидается. запуск базы данных в Docker или на хосте поможет принять это решение, а настройка лимитов памяти в Docker Compose не даст одному контейнеру исчерпать ресурсы остальных, пока вы занимаетесь оптимизацией.
После этого добавьте воркеры очередей, а не веб-мощности. Медленная работа ERPNext — это фоновая работа: генерация отчетов и массовый импорт данных. Для дополнительных воркеров нужен запас по CPU и памяти; добавление контейнеров на уже перегруженный VPS не увеличит производительность.
FAQ
Сколько оперативной памяти требуется ERPNext на VPS?
Для ознакомления начните с 4 ГБ ОЗУ и 2 vCPU. Для ежедневной работы в компании планируйте 8 ГБ ОЗУ и 4 vCPU при 100 ГБ SSD. При нехватке памяти механизм out of memory killer ядра может остановить контейнеры, что docker inspect отображает как "OOMKilled": true с кодом завершения 137. Это лишь начальные значения, а не точные замеры, поэтому следите за потреблением памяти в течение первого месяца.
Можно ли использовать pwd.yml в production?
Нет. В README проекта указано, что этот файл предназначен только для краткосрочного ознакомления, и в нём нельзя устанавливать сторонние приложения. Используйте compose.yaml с переопределениями для MariaDB, Redis и HTTPS, объедините их в один файл с помощью docker compose config и запускайте этот файл.
Почему сайт ERPNext недоступен сразу после создания?
Frontend по умолчанию выбирает сайт для отображения на основе HTTP-заголовка Host, поэтому имя сайта должно совпадать с доменом в браузере. Сайт, созданный как erpnext, не будет доступен по адресу erp.example.com. Либо создайте сайт, используя домен в качестве имени, либо укажите FRAPPE_SITE_NAME_HEADER в файле env, соответствующий имени сайта, пересоберите compose-файл и перезапустите стек.
Что должно входить в резервную копию ERPNext?
Четыре файла, которые должны храниться вместе: дамп -database.sql.gz, архивы -files.tar и -private-files.tar, а также копия конфигурации -site_config_backup.json. Команда bench --site erp.example.com backup --with-files создает все четыре файла. Копия конфигурации содержит encryption_key, поэтому восстановление без неё сделает сохраненные пароли интеграций нечитаемыми, что проявится как Encryption key is invalid! Please check site_config.json.
Как обновить ERPNext без потери данных?
Создайте резервную копию с помощью --with-files, включите режим обслуживания, измените ERPNEXT_VERSION в файле env, пересоберите compose-файл, выполните pull, запустите стек, затем выполните bench --site erp.example.com migrate и отключите режим обслуживания. Переходите между мажорными версиями по одной и сначала читайте примечания к выпуску, так как migrate перезаписывает схему и данные документов без возможности отмены. Откат возможен только через восстановление резервной копии, сделанной перед началом процесса.