Як встановити n8n на Ubuntu 26.04
Якщо ви давно хотіли делегувати свої рутинні завдання автоматизації — тоді n8n може стати одним із найзручніших рішень для цього. Платформа дозволяє об’єднувати різні інструменти в єдині процеси без необхідності вручну підтримувати десятки однотипних дій.
N8n часто використовують для workflow-процесів, роботи з API, синхронізації даних між сервісами, AI-функцій та внутрішніх інтеграцій.
Далі розповідаємо детальніше про n8n та показуємо вам як за 10 хв. встановити його на Ubuntu 26.04.
Що таке n8n
N8n — це open-source платформа для workflow-автоматизації, яка дозволяє об’єднувати сервіси, бази даних та різні системи в єдині процеси.
Особливо корисною вона може бути для DevOps-інженерів та технічних команд, які регулярно оптимізують повторювані процеси.
Переваги
- open-source платформа з можливістю безплатнорозгорнути self-hosted версію;
- підтримка понад 500 інтеграцій із сервісами, API та AI-інструментами;
- гнучке налаштування workflow-процесів під власні завдання;
- можливість повністю контролювати дані та automation-процеси на власному сервері;
- відсутність обмежень на кількість завдань у self-hosted версії;
- підтримка складних automation-сценаріїв для внутрішніх систем.
Втім, як і будь-яке технічне рішення, n8n має кілька особливостей, які варто врахувати перед установлення:
Недоліки
- для self-hosted розгортання потрібні базові знання Linux та роботи із сервером;
- складні workflow можуть вимагати додаткового налаштування та підтримки;
- частина enterprise-функцій доступна лише у платних версіях;
- велика кількість automation-процесів може вимагати більше серверних ресурсів;
- деякі інтеграції потребують роботи з API-ключами та технічною документацією.
Інструкція з налаштування n8n
Тепер крок за кроком розберемо, як розгорнути платформу і підготувати все необхідне для її стабільного запуску.
Що потрібно для встановлення n8n
- Сервер з встановленою Ubuntu 26.04;
- root-доступ або звичайний користувач з правами sudo;
- доменне ім’я, прив’язане до вашого сервера.
Крок 1. Оновлення системи
Перш ніж переходити до встановлення n8n та необхідних компонентів, варто оновити системні пакети до актуальних версій. Для цього виконайте наступну команду:
apt update -y && apt upgrade -y
Крок 2. Встановлення NodeJS
Для роботи n8n спочатку потрібно встановити Node.js — саме на ньому працює платформа. Для цього виконайте наступні команди:
curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
apt update
apt install nodejs
Після встановлення варто переконатись, що Node.js працює коректно. Для цього перевіримо його поточну версію за допомогою команди нижче:
node -v
Система повинна відобразити встановлену версію Node.js, наприклад:
root@host:~# node -v
v24.14.0
Крок 3. Встановлення бази даних PostgreSQL
Далі встановимо PostgreSQL. Цю систему керування базами даних n8n часто використовує для збереження workflow, налаштувань та історії виконання процесів. Для встановлення PostgreSQL виконайте команду нижче:
apt install postgresql postgresql-contrib
Після встановлення запустимо службу бази даних та додамо її в автозапуск системи:
systemctl start postgresql && systemctl enable postgresql
Щоб переконатись, що база даних працює коректно, перевіримо статус служби за допомогою наступної команди:
systemctl status postgresql
Якщо все ок, система повинна відобразити такий результат:
root@host:~# systemctl status postgresql
● postgresql.service - PostgreSQL RDBMS
Loaded: loaded (/usr/lib/systemd/system/postgresql.service; enabled; preset: enabled)
Active: active (exited) since Thu 2026-03-05 19:16:38 CST; 2min 58s ago
Invocation: 37862c786fb14711b2ad5c63215631c9
Main PID: 39039 (code=exited, status=0/SUCCESS)
Mem peak: 2M
CPU: 17ms
На цьому етапі можемо створимо окремого користувача бази даних для n8n. Спочатку перейдіть до оболонки PostgreSQL, послідовно виконавши команди:
su postgres
psql
Тепер оболонка має виглядати так:
postgres@host:/root$ psql
psql (18.3 (Ubuntu 18.3-1))
Type "help" for help.
postgres=#
Підготуємо PostgreSQL для роботи з n8n: створимо окрему базу даних, користувача та одразу надамо йому необхідні права доступу. Для цього по черзі виконайте команди нижче:
CREATE DATABASE n8ndb;
CREATE USER n8nuser WITH SUPERUSER PASSWORD 'StrongDBPasswordHere';
GRANT ALL PRIVILEGES ON DATABASE n8ndb TO n8nuser;
\q
Щоб вийти з облікового запису postgres та повернутись до звичайного користувача системи, просто введіть команду exit.
postgres@host:/root$ exit
exit
root@host:~#
Крок 4. Додавання системного користувача n8n
Майже все готово для встановлення n8n. Залишилось лише створити окремого системного користувача, від імені якого працюватиме платформа. Для цього виконайте команду:
adduser n8n
Далі система запропонує створити пароль для нового юзера. Надамо йому n8n права sudo, щоб він міг виконувати адміністративні дії в системі:
usermod -aG sudo n8n
Крок 5. Встановлення n8n
Усе готово — тепер можемо переходити безпосередньо до встановлення n8n. Для початку увійдіть у систему від імені користувача n8n:
su - n8n
Щоб встановити n8n, виконайте команду нижче — вона автоматично встановить сервіс у домашній каталог:
sudo npm install -g n8n
Для виконання наступної команди вам знадобиться пароль користувача n8n:
n8n@host:~$ sudo npm install -g n8n
[sudo: authenticate] Password:
Встановлення розпочнеться автоматично. Зазвичай процес займає кілька хвилин — дочекайтесь його завершення, а потім виконайте команду для створення каталогу n8n, який потрібен для конфігурації сервісу:
n8n
У консолі має з’явитися це:
Finished building workflow dependency index. Processed 0 draft workflows, 0 published workflows.
Editor is now accessible via:
http://localhost:5678
Press "o" to open in Browser.
Зупиніть процес за допомогою комбінації CTRL+D, оскільки далі ми запускатимемо n8n уже як окремий сервіс.
Після цього потрібно створити файл середовища з даними для підключення до бази даних, яку ми налаштували раніше:
/home/n8n/.n8n/.env
Далі додайте у файл ці рядки коду:
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=localhost
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8ndb
DB_POSTGRESDB_USER=n8nuser
DB_POSTGRESDB_PASSWORD=StrongDBPasswordHere
DB_POSTGRESDB_SCHEMA=n8ndb
Збережіть файл і вийдіть із редактора. Після цього завершіть сеанс користувача n8n:
n8n@host:~/.n8n$ exit
logout
root@host:~#
Крок 6. Створення файлу systemd
Щоб керувати n8n як окремим сервісом, потрібно створити для нього systemd-файл:
nano /etc/systemd/system/n8n.service
Після цього вставте у файл наступні рядки коду:
[Unit]
Description=n8n
After=network.target
[Service]
User=n8n
WorkingDirectory=/home/n8n/.n8n
EnvironmentFile=/home/n8n/.n8n/.env
ExecStart=/usr/bin/n8n
Restart=on-failure
RestartSec=5s
[Install]
WantedBy=multi-user.target
Збережіть файл, закрийте редактор і перезавантажте systemd daemon:
systemctl daemon-reload
Щоб запустити службу n8n і додати її до автоматичного запуску системи, виконайте команду:
systemctl start n8n && systemctl enable n8n
Щоб перевірити статус служби, введіть наступне:
systemctl status n8n
Після виконання попередньої команди ви маєте побачити приблизно такий результат:
root@host:~# systemctl status n8n
● n8n.service - n8n
Loaded: loaded (/etc/systemd/system/n8n.service; enabled; preset: enabled)
Active: active (running) since Thu 2026-03-05 20:00:46 CST; 1min 7s ago
Invocation: 892510db0e954fa391a0aad28244dfd6
Main PID: 41577 (MainThread)
Tasks: 19 (limit: 4027)
Memory: 387.4M (peak: 704M)
CPU: 27.872s
CGroup: /system.slice/n8n.service
├─41577 node /usr/bin/n8n
└─41595 node --disallow-code-generation-from-strings --disable-proto=delete /usr/lib/node_modules/n8n/node_modules/@n8n/task-runner/dist/start.js
Mar 05 20:00:59 host.test.vps n8n[41577]: Finished migration MigrateExternalSecretsToEntityStorage1771500000000
Mar 05 20:00:59 host.test.vps n8n[41577]: n8n Task Broker ready on 127.0.0.1, port 5679
Як бачите, служба n8n працює на порту 5679. У подальшому ми налаштуємо зворотнІй проксі-сервер, щоб отримати доступ до n8n через доменне ім’я.
Крок 7. Встановіть Nginx та створіть зворотний проксі-сервер
Щоб встановити Nginx, виконайте таку команду:
apt install nginx -y
Після встановлення запустіть службу Nginx і додайте її до автоматичного запуску системи:
systemctl start nginx && systemctl enable nginx
Не забудьте перевірити стан послуги:
systemctl status nginx
Після цього ви маєте побачити такий результат:
root@host:~# systemctl status nginx
● nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; preset: enabled)
Active: active (running) since Thu 2026-03-05 20:06:07 CST; 1min 5s ago
Invocation: ae8be846641342a5b6f7e0f314291d71
Docs: man:nginx(8)
Main PID: 41933 (nginx)
Tasks: 4 (limit: 4027)
Memory: 3.8M (peak: 9.1M)
CPU: 117ms
CGroup: /system.slice/nginx.service
Тепер перейдімо до створення конфігураційного файлу для Nginx:
nano /etc/nginx/conf.d/n8n.conf
Додайте у файл наступні рядки коду:
upstream n8n {
server 127.0.0.1:5678;
}
server {
listen 80;
server_name yourdomain.com;
access_log /var/log/nginx/n8n.access.log;
error_log /var/log/nginx/n8n.error.log;
location / {
proxy_pass http://n8n;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Збережіть файл, закрийте редактор і перевірте конфігурацію Nginx на наявність помилок:
nginx -t
Якщо все налаштовано правильно, ви маєте побачити це:
root@host:~# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Перезапустіть службу Nginx:
systemctl restart nginx
Далі налаштуємо SSL-сертифікат для домену. Для початку встановіть Certbot для Nginx:
apt install python3-certbot-nginx -y
Після цього можна отримати SSL-сертифікат для домену:
certbot --nginx -d yourdomain.com
Після завершення налаштування сайт буде доступний через HTTPS.
Далі можна перейти за адресою https://yourdomain.com і завершити встановлення n8n. Достатньо просто створити обліковий запис власника та виконати базове налаштування сервісу.
N8n готовий до роботи
Тепер вся магія автоматизації до ваших послуг.
Маємо надію, що цей гайд був корисним для вас. А якщо хочеться налаштовувати сервіси не лише за інструкціями, а по-справжньому розуміти логіку роботи self-hosted рішень — у каталозі курсів ITEDU можна знайти навчальні програми для прокачки практичних скілів.