К содержимому

Запуск n8n через docker compose на Ubuntu 24.04

n8n запускается одним сервисом в compose-файле: образ docker.n8n.io/n8nio/n8n, порт 5678 и том для данных.

Руководство Docker 3 мин чтения

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».

bash
docker compose version

02Создайте каталог проекта и файл compose.yaml

Создайте отдельный каталог, чтобы файлы n8n не смешивались с другими проектами. Внутри создайте compose.yaml с сервисом n8n, публикацией порта и именованным томом. Ключ version: не нужен: в Compose v2 он устарел и даёт предупреждение.

bash
mkdir -p /opt/n8n && cd /opt/n8n
nano compose.yaml

03Опишите сервис n8n в compose-файле

Сервис слушает порт 5678 внутри контейнера. Порт 5678:5678 публикует его на всех интерфейсах сервера, а 127.0.0.1:5678:5678 оставляет доступ только с самого сервера. Том n8n_data хранит базу и настройки между перезапусками.

yaml
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 с номером проблемной строки. Исправьте файл до запуска.

bash
docker compose config

05Запустите n8n

Команда docker compose up -d скачает образ и поднимет контейнер в фоне. Первый запуск занимает время: образ n8n весит около гигабайта. Если порт 5678 уже занят, Docker вернёт Bind for 0.0.0.0:5678 failed: port is already allocated.

bash
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.

bash
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 печатает версию внутри контейнера. Оба ответа вместе подтверждают, что контейнер запущен и приложение отвечает.

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.