Как установить n8n локально и на свой сервер

Какой способ установки выбрать

• npx: быстрая проба на компьютере, где уже есть Node.js.
• Docker: локальная работа с данными в отдельном томе. Подходит и для Windows, и для macOS.
• Docker Compose на сервере: постоянная работа с HTTPS и доступом из интернета.
• n8n Cloud: вариант без установки, с пробным периодом.

Как установить n8n через Docker

Установите Docker Desktop, а на Linux без графической среды поставьте Docker Engine и Docker Compose. Затем выполните команды, заменив часовой пояс на свой:

1. Создайте том для данных: docker volume create n8n_data
2. Запустите контейнер: docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE=Europe/Moscow -e TZ=Europe/Moscow -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n
3. Откройте в браузере http://localhost:5678 и следуйте подсказкам первого запуска.

Как установить n8n на Windows через npm

Нужен Node.js версии от 20.19 до 24.x. Попробовать n8n без установки можно командой npx n8n. Для постоянной установки выполните npm install n8n -g, а затем запустите программу командой n8n. Интерфейс откроется по тому же адресу http://localhost:5678.

При ошибках на Windows сначала проверьте настройку Node.js по руководству Microsoft. Учтите, что в документации установка через npm помечена как устаревшая начиная с n8n 3.0, поэтому для постоянной работы лучше выбрать Docker.

Где хранятся данные

По умолчанию n8n использует базу SQLite: там лежат workflow, учётные данные и история запусков. В Docker они попадают в том n8n_data, поэтому не удаляйте его вместе с контейнером. Даже если вы подключите PostgreSQL, том всё равно нужен: в нём хранится ключ шифрования учётных данных.

Как установить n8n на свой сервер

В документации этот сценарий описан для Linux. Там же приведён полный файл compose.yaml, который стоит взять оттуда, а не собирать по памяти.

1. Установите Docker Engine и Docker Compose и проверьте их командами docker --version и docker compose version.
2. Создайте для поддомена A-запись на IP сервера.
3. В каталоге проекта создайте файл .env с параметрами DOMAIN_NAME, SUBDOMAIN, GENERIC_TIMEZONE и SSL_EMAIL.
4. Создайте папку local-files: она будет доступна контейнеру как /files.
5. Добавьте compose.yaml с двумя службами: Traefik получает сертификаты Let's Encrypt, а n8n работает за ним.
6. Запустите sudo docker compose up -d и откройте адрес вроде https://n8n.example.com.

Что учесть перед постоянной работой

Разработчики предупреждают, что собственный сервер требует опыта с контейнерами и безопасностью: ошибки могут привести к потере данных и простоям. Для рабочих сценариев используйте версию stable, а не beta. Туннель для вебхуков подходит только для разработки и тестов. Настройте резервные копии тома заранее, ещё до первого важного сценария.

Вопросы и ответы