☰
16.03.2026

Как запустить n8n с PostgreSQL (и безопасно перенести данные с SQLite)

По умолчанию n8n хранит данные в SQLite. Это файловая база, которая не требует настройки и подходит для локального тестирования. Но в продакшене она создаёт проблемы: блокирует весь файл при каждой записи, не поддерживает горячее резервное копирование и несовместима с режимом очередей (горизонтальное масштабирование с воркерами). PostgreSQL решает все три проблемы и является рекомендованной базой данных для любого рабочего развёртывания n8n.

В этом руководстве мы настроим n8n с PostgreSQL через Docker Compose, а затем разберём, как безопасно перенести существующий инстанс с SQLite. Весь процесс занимает около 15 минут и не требует опыта работы с базами данных.

Зачем переходить на PostgreSQL?

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

PostgreSQL использует блокировку на уровне строк, поэтому параллельные процессы не мешают друг другу. Поддерживает горячее резервное копирование через pg_dump без остановки n8n. Обязателен для режима очередей (масштабирование через Redis и несколько воркеров) и для отказоустойчивых конфигураций с несколькими основными инстансами. Если ваш n8n обслуживает команду или обрабатывает больше нескольких десятков рабочих процессов в день, PostgreSQL будет правильным выбором.

Требования

 

Арендовать VPS на Serverspace можно за пару минут. Если вы хотите пропустить ручную установку, у Serverspace также есть

VPS с предустановленным n8n в формате приложения в один клик.

Шаг 1. Сгенерируйте ключ шифрования

n8n шифрует все сохранённые учётные данные (API-токены, пароли, OAuth-секреты) с помощью этого ключа. Если ключ будет утерян, расшифровать данные станет невозможно. Сгенерируйте ключ и сохраните его в менеджере паролей:

openssl rand -hex 32

 

Шаг 2. Создайте файлы проекта

Создайте директорию и поместите в неё три файла:

mkdir ~/n8n-postgres && cd ~/n8n-postgres

 

.env

POSTGRES_USER=postgres

POSTGRES_PASSWORD=your_strong_postgres_password

POSTGRES_DB=n8n

 

POSTGRES_NON_ROOT_USER=n8n_user

POSTGRES_NON_ROOT_PASSWORD=your_strong_n8n_password

 

N8N_ENCRYPTION_KEY=paste_your_generated_key_here

N8N_HOST=0.0.0.0

N8N_PROTOCOL=http

N8N_PORT=5678

GENERIC_TIMEZONE=UTC

 

Частая ошибка: указать DB_TYPE как "postgres" вместо postgresdb. Правильное значение именно postgresdb. При неверном значении n8n молча откатится на SQLite.

docker-compose.yml

volumes:

db_storage:

n8n_storage:

 

services:

postgres:

image: postgres:16-alpine

restart: always

environment:

- POSTGRES_USER

- POSTGRES_PASSWORD

- POSTGRES_DB

- POSTGRES_NON_ROOT_USER

- POSTGRES_NON_ROOT_PASSWORD

volumes:

- db_storage:/var/lib/postgresql/data

- ./init-data.sh:/docker-entrypoint-initdb.d/init-data.sh

healthcheck:

test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}']

interval: 5s

timeout: 5s

retries: 10

 

n8n:

image: docker.n8n.io/n8nio/n8n

restart: always

environment:

- DB_TYPE=postgresdb

- DB_POSTGRESDB_HOST=postgres

- DB_POSTGRESDB_PORT=5432

- DB_POSTGRESDB_DATABASE=${POSTGRES_DB}

- DB_POSTGRESDB_USER=${POSTGRES_NON_ROOT_USER}

- DB_POSTGRESDB_PASSWORD=${POSTGRES_NON_ROOT_PASSWORD}

- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}

- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}

ports:

- 5678:5678

volumes:

- n8n_storage:/home/node/.n8n

depends_on:

postgres:

condition: service_healthy

 

Том n8n_storage, смонтированный в /home/node/.n8n, нужен даже при использовании PostgreSQL. Там n8n хранит метаданные ключа шифрования. DB_POSTGRESDB_HOST должен совпадать с именем сервиса в Compose-файле ("postgres"), а не быть "localhost", поскольку контейнеры общаются через Docker-сеть.

init-data.sh

Этот скрипт создаёт пользователя базы данных при первом запуске. Создайте файл и сделайте его исполняемым (chmod +x init-data.sh):

#!/bin/bash

set -e; psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL

CREATE USER "$POSTGRES_NON_ROOT_USER" WITH PASSWORD '$POSTGRES_NON_ROOT_PASSWORD';

GRANT ALL PRIVILEGES ON DATABASE "$POSTGRES_DB" TO "$POSTGRES_NON_ROOT_USER";

GRANT ALL ON SCHEMA public TO "$POSTGRES_NON_ROOT_USER";

EOSQL

Шаг 3. Запустите стек

docker compose up -d

 

Docker скачает образы, запустит PostgreSQL и дождётся прохождения проверки доступности (healthcheck). После этого запустится n8n, подключится к PostgreSQL и автоматически создаст все необходимые таблицы. Откройте в браузере http://IP-адрес-сервера:5678 и создайте учётную запись администратора. Первый зарегистрированный пользователь автоматически получает права администратора.

Шаг 4. Проверьте работу

Убедитесь, что n8n использует PostgreSQL. Выведите список таблиц:

docker compose exec postgres psql -U n8n_user -d n8n -c "\dt"

 

В списке должны быть таблицы workflow_entity, credentials_entity, execution_entity и другие. Создайте тестовый рабочий процесс с узлами Manual Trigger и Set, запустите его и проверьте, что запуск отображается в истории. Затем добавьте тестовые учётные данные, перезапустите n8n командой docker compose restart n8n и убедитесь, что данные доступны после перезапуска.

Миграция с SQLite на PostgreSQL

Если у вас уже есть рабочий инстанс n8n на SQLite, воспользуйтесь CLI-командой export:entities (доступна с версии n8n 1.67, ноябрь 2025). Она экспортирует все типы сущностей и поддерживает импорт между разными типами баз данных.

  1. Остановите n8n: docker compose stop n8n
  2. Экспортируйте данные:
docker exec -u node -it <имя-контейнера-n8n> \

n8n export:entities --outputDir=/home/node/.n8n/backup

 

Если нужна история выполнений (может занимать много места), добавьте флаг --includeExecutionHistoryDataTables=true.

  1. Настройте PostgreSQL по шагам 1-3 из этого руководства. Используйте **тот же самый N8N_ENCRYPTION_KEY**, что и на старом инстансе. Это критически важно: при другом ключе все учётные данные станут нечитаемыми.
  2. Импортируйте данные:
docker exec -u node -it <имя-контейнера-n8n> \
n8n import:entities --inputDir=/home/node/.n8n/backup

 

  1. Запустите n8n и убедитесь, что все рабочие процессы, учётные данные и пользователи на месте.

Для версий n8n старше 1.67, где команда export:entities недоступна, используйте n8n export:workflow --all и n8n export:credentials --all --decrypted. Эти команды переносят только рабочие процессы и учётные данные, без пользователей, проектов и папок.

Рекомендации после настройки

Резервное копирование. Выполняйте pg_dump регулярно. В отличие от SQLite, это работает при запущенном n8n:

docker compose exec postgres pg_dump -U n8n_user -d n8n > backup_$(date +%F).sql

 

Настройте выполнение этой команды через cron (например, ежедневно в 3 часа ночи). Храните несколько свежих копий и периодически проверяйте восстановление из них.

HTTPS. Разместите перед n8n обратный прокси (Nginx или Caddy) и настройте TLS-сертификат через Let's Encrypt. Не открывайте порт 5678 напрямую в интернет. Без HTTPS логины и данные рабочих процессов передаются открытым текстом.

Очистка данных о выполнениях. n8n сохраняет результат каждого запуска. С 2025 года автоматическая очистка включена по умолчанию: хранение 14 дней, до 10 000 записей. Скорректировать можно переменными EXECUTIONS_DATA_MAX_AGE (в часах) и EXECUTIONS_DATA_PRUNE_MAX_COUNT.

Частые проблемы

n8n запускается, но использует SQLite вместо PostgreSQL. Проверьте, что DB_TYPE имеет значение "postgresdb" (не "postgres"). Убедитесь, что все переменные DB_POSTGRESDB_* присутствуют в окружении. Если хотя бы одна отсутствует, n8n молча переключается на SQLite.

Ошибка подключения при запуске. Убедитесь, что DB_POSTGRESDB_HOST совпадает с именем сервиса в Compose-файле ("postgres"), а не "localhost". Контейнеры общаются через Docker-сеть, а не через loopback-интерфейс. Также проверьте, что healthcheck PostgreSQL проходит успешно до того, как n8n пытается подключиться.

Учётные данные пусты после миграции. N8N_ENCRYPTION_KEY на новом инстансе не совпадает со старым. n8n не может расшифровать данные, зашифрованные другим ключом. Проверьте значение ключа и выполните импорт заново.

Ошибка "Column already exists" при миграции. Возникает, когда данные таблиц импортируются в базу, где n8n уже выполнил миграции схемы. Целевая база должна быть пустой перед импортом. Если нужно начать заново, удалите и пересоздайте базу, затем повторите импорт.

Заключение

Три файла конфигурации и одна команда docker compose up дают готовый к работе инстанс n8n на PostgreSQL. Такая конфигурация обеспечивает безопасное параллельное выполнение рабочих процессов, надёжное резервное копирование и возможность масштабирования через режим очередей.

Для быстрого старта можно развернуть n8n на Serverspace с готовым окружением и добавить PostgreSQL по шагам из этого руководства.