Self-host n8n di VPS.
Mesin otomasi Anda, kredensial Anda, metal Anda.

n8n adalah mesin otomasi workflow: sebuah canvas visual tempat Anda merangkai trigger — webhook, jadwal, baris baru dalam basis data, pesan dalam antrean — menjadi rangkaian node yang memanggil API, mentransformasi data, bercabang berdasarkan kondisi, menjalankan JavaScript atau Python apa pun, dan menyerahkan hasilnya ke apa pun yang berikutnya. Beberapa ratus node integrasi sudah tersedia langsung, ditambah node HTTP Request generik yang mencakup semua sisanya. Sejak lini 1.x, ia juga membawa node AI Agent dan LLM, itulah sebabnya sebagian besar orang yang menginstalnya pada 2026 sedang membangun agent, bukan pipa ETL klasik.

Bagian yang penting sebelum Anda mengetik satu perintah pun adalah lisensinya, karena n8n bukan open source dalam pengertian OSI dan perbedaannya bukan sekadar akademis. Inti n8n dirilis di bawah Sustainable Use License: hibah non-eksklusif, bebas royalti, berlaku di seluruh dunia untuk menggunakan, menyalin, memodifikasi, dan mendistribusikan perangkat lunak untuk keperluan bisnis internal serta penggunaan pribadi atau non-komersial. Yang ditahannya adalah hak untuk membebankan biaya kepada orang lain untuk n8n atau turunannya — klausul yang menyingkirkan kemungkinan membangun produk "managed n8n" berbayar di atasnya. Secara terpisah, file apa pun yang membawa .ee. dalam namanya atau .ee dalam path-nya dikecualikan sepenuhnya dari lisensi itu dan memerlukan n8n Enterprise License berbayar.

Dibaca secara terus terang: menjalankan n8n di VPS untuk mengotomasi perusahaan Anda sendiri, pekerjaan klien Anda sendiri yang diberikan sebagai layanan yang Anda kerjakan, atau kehidupan pribadi Anda sendiri, masuk dalam hibah gratis dan selalu begitu. Menjual n8n-sebagai-produk-hosting tidak. Hampir setiap perdebatan "apakah n8n benar-benar gratis?" di internet adalah dua orang yang bicara melewati satu sama lain melintasi garis itu.

Sisi biaya. n8n Cloud diberi harga per eksekusi: paket Starter seharga €20 sebulan ditagih tahunan untuk 2,500 eksekusi, Pro €50 sebulan untuk 10,000, Business €667 sebulan untuk 40,000. Pada self-hosted, jumlah eksekusi sama sekali bukan item tagihan — ia dibatasi oleh seberapa besar CPU dan memori yang dimiliki kotak itu. Sebuah workflow yang melakukan polling API setiap lima menit menghabiskan 8,640 eksekusi sebulan dengan sendirinya; di Cloud, satu workflow itu saja sudah memaksa ke tingkatan Pro, dan pada VPS $3.90 itu hanyalah kesalahan pembulatan dibanding CPU idle.

Harga Cloud sebagaimana dipublikasikan di n8n.io pada Agustus 2026, ditagih tahunan; penagihan bulanan lebih mahal. Pertukarannya bukan hanya soal uang — self-hosting memindahkan pembaruan, cadangan, perpanjangan TLS, dan uptime ke sisi Anda.

Di panel: Order → VPS → Sentinel, image Debian 12. Tidak ada alamat surel yang diperlukan untuk membuka akun, tidak ada dokumen identitas yang diminta kapan pun, dan tagihan diselesaikan dalam Monero, Bitcoin, Lightning, atau aset lain yang didukung. Pilih bastion berdasarkan latensi ke layanan yang Anda otomasi, bukan ke diri Anda sendiri — server otomasi jauh lebih sering bicara dengan API daripada dengan Anda.

Kemudian buat rekaman DNS sebelum Anda menyentuh server: satu A record untuk n8n.example.com yang mengarah ke IPv4 VPS, dan satu AAAA record jika Anda menggunakan IPv6. Ini harus dilakukan lebih dulu, karena Caddy meminta sertifikat ke Let's Encrypt saat stack mulai berjalan, dan permintaan sertifikat untuk nama yang tidak resolve akan gagal — lalu mundur, dan Anda menghabiskan dua puluh menit bertanya-tanya mengapa situsnya tidak bisa dijangkau.

Beri waktu semenit agar DNS-nya merambat (propagate), lalu konfirmasi dari mesin Anda sendiri sebelum melanjutkan:

dig +short n8n.example.com
# → the IPv4 of your VPS, and nothing else

Sebelum apa pun mendengarkan di port publik, jalankan checklist pengerasan jam pertama — SSH khusus kunci, firewall yang hanya mengizinkan 22, 80, dan 443, dan pembaruan keamanan tanpa pengawasan. Server otomasi adalah brankas kredensial; ia layak mendapat satu jam penuh.

Buat direktorinya dan hasilkan dua secret terlebih dahulu. Hasilkan sekarang, dengan urutan ini, dan tempelkan ke dalam .env begitu setiap kunci dihasilkan — kunci enkripsi khususnya harus sudah ada sebelum boot pertama n8n, bukan sesudahnya.

mkdir -p /opt/n8n && cd /opt/n8n
openssl rand -hex 32   # → N8N_ENCRYPTION_KEY
openssl rand -hex 24   # → POSTGRES_PASSWORD

/opt/n8n/.env

DOMAIN=n8n.example.com
LETSENCRYPT_EMAIL=you@example.com
GENERIC_TIMEZONE=Europe/Stockholm

N8N_ENCRYPTION_KEY=paste_the_32_byte_hex_here
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=paste_the_24_byte_hex_here

Kunci file ini segera — ia menyimpan kunci untuk setiap kredensial yang akan pernah disimpan instance ini:

chmod 600 /opt/n8n/.env

/opt/n8n/docker-compose.yml

services:
  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    environment:
      - DOMAIN=${DOMAIN}
      - LETSENCRYPT_EMAIL=${LETSENCRYPT_EMAIL}
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_DB=${POSTGRES_DB}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      - N8N_HOST=${DOMAIN}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_EDITOR_BASE_URL=https://${DOMAIN}
      - WEBHOOK_URL=https://${DOMAIN}/
      - N8N_PROXY_HOPS=1
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_BLOCK_ENV_ACCESS_IN_NODE=true
      - N8N_DIAGNOSTICS_ENABLED=false
      - N8N_VERSION_NOTIFICATIONS_ENABLED=false
      - N8N_PERSONALIZATION_ENABLED=false
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  caddy_data:
  caddy_config:
  pg_data:
  n8n_data:

/opt/n8n/Caddyfile

{$DOMAIN} {
    encode zstd gzip
    tls {$LETSENCRYPT_EMAIL}
    reverse_proxy n8n:5678
}

Dua keputusan desain yang layak disebutkan. Pertama, n8n tidak mempublikasikan port. Hanya Caddy yang bind ke 80 dan 443; n8n mendengarkan di 5678 di dalam jaringan Compose tempat tidak ada apa pun di luar host yang bisa menjangkaunya. Cukup banyak instance n8n self-hosted yang berada di internet publik pada port 5678 tanpa TLS di depannya, dan mesin pencari untuk layanan yang terekspos mengindeksnya. Kedua, volume data n8n tetap ter-mount meskipun PostgreSQL kini menyimpan workflow-nya — direktori itu masih membawa pengaturan instance, file log, dan aset source-control.

Nyalakan:

cd /opt/n8n
docker compose up -d
docker compose logs -f caddy   # watch the certificate being issued

n8n yang boot, menampilkan editor, dan menjalankan tes manual belum tentu n8n yang benar-benar berfungsi. Bagian yang diam-diam rusak adalah webhook masuk, dan kerusakannya tampak seolah-olah layanan pihak ketigalah yang bersalah.

WEBHOOK_URL. Tanpanya, n8n membangun URL webhook dari N8N_HOST dan N8N_PORT dan memberi Anda sesuatu seperti http://localhost:5678/webhook/abc — yang kemudian Anda tempel ke Stripe atau GitHub, di mana itu tidak akan pernah bisa dijangkau. File Compose di atas menyetel WEBHOOK_URL ke root HTTPS publik, yang merupakan apa yang akan ditampilkan editor dan apa yang benar-benar bisa dipanggil dunia luar.

N8N_EDITOR_BASE_URL. URL publik yang digunakan n8n untuk tautan dalam surel yang dikirimnya — reset kata sandi, undangan pengguna. Salah di sini berarti tautan undangan yang mengarah ke localhost, yang menghasilkan tiket dukungan dari rekan kerja alih-alih integrasi yang rusak.

N8N_PROXY_HOPS. n8n membaca IP klien dari X-Forwarded-For, dan hanya mempercayai sebanyak hop yang dikatakan angka ini. Dengan satu reverse proxy di depan — Caddy dalam stack ini — nilainya adalah 1. Taruh Cloudflare di depan Caddy dan nilainya menjadi 2. Biarkan pada bawaan 0 dan setiap request tampak berasal dari proxy itu sendiri, yang diam-diam merusak rate limit dan logika berbasis IP apa pun dalam workflow Anda.

N8N_SECURE_COOKIE. Bawaannya true, artinya cookie sesi hanya dikirim lewat HTTPS. Itu pengaturan yang benar dan stack ini memenuhinya. Ini penting diketahui karena menjelaskan gejala klasik dari percobaan pertama lewat http biasa: formulir login menerima kata sandinya lalu mengembalikan Anda ke formulir login, selamanya. Solusinya adalah TLS, bukan mematikan flag ini.

Uji dengan benar. Buat workflow dengan node Webhook, aktifkan workflow-nya, salin Production URL, lalu panggil dari mesin yang bukan server:

curl -i https://n8n.example.com/webhook/<path>
# → HTTP/2 200, and a new execution visible in the editor

Perbedaan yang membuat semua orang tersandung setidaknya sekali: Test URL hanya mendengarkan selama Anda membuka editor dengan "Listen for test event" diaktifkan. Production URL hanya ada saat workflow di-toggle menjadi Active. Webhook yang berfungsi di editor tapi 404 di produksi hampir selalu berarti workflow yang tidak aktif.

Secara bawaan n8n berjalan dalam regular mode: proses yang sama yang melayani editor dan menerima webhook juga mengeksekusi workflow. Ini sederhana dan benar sampai satu workflow yang panjang mulai membuat yang lain menunggu. Gejalanya jelas — eksekusi tertahan pada status "running" selama beberapa menit, editor menjadi lamban, dan webhook yang seharusnya merespons dalam 200 ms malah merespons dalam delapan detik.

Queue mode membagi pekerjaan. Instance utama menyimpan editor, trigger, dan endpoint webhook; ia mendorong execution ID ke dalam Redis; proses worker terpisah menariknya, memuat workflow dari PostgreSQL, menjalankannya, dan melaporkan kembali lewat Redis. Ada tiga aturan yang mengikuti arsitektur itu dan ketiganya menggigit orang yang mengabaikannya: setiap instance harus berbagi basis data PostgreSQL yang sama, setiap instance harus membawa N8N_ENCRYPTION_KEY yang sama, dan SQLite sama sekali tidak didukung.

Tambahan pada file Compose adalah satu layanan Redis dan satu layanan worker, yang merupakan image n8n yang sama dijalankan dengan perintah worker:

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: ["redis-server", "--save", "60", "1", "--appendonly", "no"]
    volumes:
      - redis_data:/data

  n8n-worker:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    command: worker --concurrency=5
    depends_on:
      - redis
      - postgres
    environment:
      # the SAME encryption key and the SAME database as the main instance
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}

Tambahkan juga EXECUTIONS_MODE=queue dan QUEUE_BULL_REDIS_HOST=redis ke layanan n8n utama — kedua sisi perlu sepakat soal mode ini. Ada dua opsi yang layak diatur sejak hari pertama: OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true, agar menekan "Test workflow" di editor tidak membebani proses utama, dan N8N_GRACEFUL_SHUTDOWN_TIMEOUT, yang bawaannya 30 detik dan menentukan berapa lama worker diizinkan menyelesaikan pekerjaannya saat ini selama redeploy. Jika workflow Anda biasanya berjalan lebih dari setengah menit, naikkan nilainya, atau setiap deployment akan menghentikan pekerjaan yang sedang berjalan.

Jangan mulai di sini. Queue mode menambahkan dua bagian yang bergerak dan satu kelas kegagalan yang sama sekali tidak dimiliki regular mode. Tetaplah di regular mode sampai Anda melihat antrean bertambah atau satu workflow memblokir yang lain, lalu tambahkan satu worker di kotak yang sama sebelum menambahkan kotak kedua. Progresi itu — Sentinel di regular mode, Garrison dengan satu worker, Ravelin dengan tiga — mencakup semuanya kecuali deployment yang benar-benar besar.