Запуск n8n через docker compose на Ubuntu 24.04
n8n запускается одним сервисом в compose-файле: образ docker.n8n.io/n8nio/n8n, порт 5678 и том для данных.
01Проверьте, что Docker Compose установлен
На сервере нужен Docker с плагином Compose v2. Команда docker compose version должна вывести версию плагина, например v2.29.7. Если вывод содержит ошибку docker: 'compose' is not a docker command, установите Docker по инструкции «Установка Docker и Docker Compose на Ubuntu 24.04».
docker compose version
02Создайте каталог проекта и файл compose.yaml
Создайте отдельный каталог, чтобы файлы n8n не смешивались с другими проектами. Внутри создайте compose.yaml с сервисом n8n, публикацией порта и именованным томом. Ключ version: не нужен: в Compose v2 он устарел и даёт предупреждение.
mkdir -p /opt/n8n && cd /opt/n8n
nano compose.yaml
03Опишите сервис n8n в compose-файле
Сервис слушает порт 5678 внутри контейнера. Порт 5678:5678 публикует его на всех интерфейсах сервера, а 127.0.0.1:5678:5678 оставляет доступ только с самого сервера. Том n8n_data хранит базу и настройки между перезапусками.
services:
n8n:
image: docker.n8n.io/n8nio/n8n
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_HOST=example.com
- N8N_PORT=5678
- N8N_PROTOCOL=http
- GENERIC_TIMEZONE=Europe/Moscow
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
04Проверьте compose-файл
Команда docker compose config разбирает YAML и печатает итоговый конфиг. Если отступы или кавычки нарушены, вы увидите ошибку вида yaml: line 12: did not find expected key с номером проблемной строки. Исправьте файл до запуска.
docker compose config
05Запустите n8n
Команда docker compose up -d скачает образ и поднимет контейнер в фоне. Первый запуск занимает время: образ n8n весит около гигабайта. Если порт 5678 уже занят, Docker вернёт Bind for 0.0.0.0:5678 failed: port is already allocated.
docker compose up -d
06Посмотрите статус и логи
docker compose ps показывает, что контейнер в состоянии running. Логи через docker compose logs -f n8n выводят строку Editor is now accessible via: http://example.com:5678/, когда n8n готов принимать запросы. Флаг -f держит вывод открытым, выйдите из него по Ctrl+C.
docker compose ps
docker compose logs -f n8n
07Откройте веб-интерфейс и создайте владельца
Откройте http://203.0.113.10:5678 в браузере. При первом входе n8n попросит email, имя и пароль владельца аккаунта. Эти данные хранятся в томе n8n_data, поэтому переживают перезапуск контейнера.
08Проверьте, что n8n работает
Запрос к /healthz возвращает {"status":"ok"}, если сервис жив. Команда docker compose exec n8n n8n --version печатает версию внутри контейнера. Оба ответа вместе подтверждают, что контейнер запущен и приложение отвечает.
curl -s http://127.0.0.1:5678/healthz
docker compose exec n8n n8n --version
Частые ошибки
-
В
compose.yamlостался ключversion: "3", и при каждом запуске выводится предупреждениеthe attribute version is obsolete.Удалите строку
version:целиком: Compose v2 определяет формат файла сам. -
Порт 5678 занят другим процессом, и
docker compose up -dпадает сBind for 0.0.0.0:5678 failed: port is already allocated.Найдите держателя порта командой
sudo ss -ltnpи остановите его либо смените внешний порт в строкеports, например на5679:5678. -
После
docker compose downвсе workflows и учётные записи n8n пропали.Команда
docker compose down -vудаляет именованные тома. Запускайтеdocker compose downбез-v, чтобы сохранить томn8n_data. -
Контейнер n8n перезапускается с кодом 137, и в логах нет явной ошибки.
Код 137 значит, что процесс убит SIGKILL, чаще всего из-за нехватки памяти. Добавьте серверу RAM или ограничьте нагрузку на n8n.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Как обновить n8n в docker compose?
Выполните docker compose pull, затем docker compose up -d. Compose пересоздаст контейнер на новом образе, том n8n_data с данными останется на месте.
Где n8n хранит workflows и учётные данные?
В каталоге /home/node/.n8n внутри контейнера. В примере он подключён как именованный том n8n_data, поэтому данные переживают docker compose down и пересоздание контейнера.
Почему n8n не открывается по адресу сервера?
Проверьте, что контейнер в состоянии running по docker compose ps, и что порт 5678 не закрыт firewall. Если в ports указано 127.0.0.1:5678:5678, сервис доступен только с самого сервера.
Можно ли использовать PostgreSQL вместо встроенной базы n8n?
Да, n8n поддерживает PostgreSQL. Добавьте сервис базы в тот же compose.yaml и передайте n8n параметры подключения через переменные окружения. Пошаговая настройка есть в инструкции «PostgreSQL в Docker Compose».
Ещё по теме
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы