По умолчанию n8n хранит данные в SQLite. Это файловая база, которая не требует настройки и подходит для локального тестирования. Но в продакшене она создаёт проблемы: блокирует весь файл при каждой записи, не поддерживает горячее резервное копирование и несовместима с режимом очередей (горизонтальное масштабирование с воркерами). PostgreSQL решает все три проблемы и является рекомендованной базой данных для любого рабочего развёртывания n8n.
В этом руководстве мы настроим n8n с PostgreSQL через Docker Compose, а затем разберём, как безопасно перенести существующий инстанс с SQLite. Весь процесс занимает около 15 минут и не требует опыта работы с базами данных.
Зачем переходить на PostgreSQL?
SQLite хранит всё в одном файле и полностью блокирует его при каждой записи. Когда несколько рабочих процессов выполняются одновременно, операции записи выстраиваются в очередь и могут завершаться по тайм-ауту. В крайних случаях файл базы данных повреждается. Создать корректную резервную копию при работающем n8n тоже невозможно: копирование файла в момент записи даёт неконсистентный снимок.
PostgreSQL использует блокировку на уровне строк, поэтому параллельные процессы не мешают друг другу. Поддерживает горячее резервное копирование через pg_dump без остановки n8n. Обязателен для режима очередей (масштабирование через Redis и несколько воркеров) и для отказоустойчивых конфигураций с несколькими основными инстансами. Если ваш n8n обслуживает команду или обрабатывает больше нескольких десятков рабочих процессов в день, PostgreSQL будет правильным выбором.
Требования
- Сервер с Linux (Ubuntu 22.04 или 24.04), минимум 2 ГБ RAM и 20 ГБ диска.
- Установленные Docker и Docker Compose.
- SSH-доступ к серверу.
- Для миграции: доступ к текущей директории данных n8n (/home/node/.n8n или Docker-том).
Арендовать 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). Она экспортирует все типы сущностей и поддерживает импорт между разными типами баз данных.
- Остановите n8n: docker compose stop n8n
- Экспортируйте данные:
docker exec -u node -it <имя-контейнера-n8n> \
n8n export:entities --outputDir=/home/node/.n8n/backup
Если нужна история выполнений (может занимать много места), добавьте флаг --includeExecutionHistoryDataTables=true.
- Настройте PostgreSQL по шагам 1-3 из этого руководства. Используйте **тот же самый N8N_ENCRYPTION_KEY**, что и на старом инстансе. Это критически важно: при другом ключе все учётные данные станут нечитаемыми.
- Импортируйте данные:
docker exec -u node -it <имя-контейнера-n8n> \
n8n import:entities --inputDir=/home/node/.n8n/backup
- Запустите 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 по шагам из этого руководства.