Tutorial Otomatisasi N8N untuk Ubuntu – Dari Nol ke Aliran

Kata Kunci

Mengapa otomatisasi itu penting

Tim modern tidak “menjalankan satu aplikasi” — mereka mengoperasikan rangkaian alat SaaS, layanan internal, penyimpanan data, dan sistem chat/pemberitahuan. Biaya dari kompleksitas itu muncul dengan cara yang dapat diprediksi:

• Serah terima manual dan pekerjaan berulang yang membosankan (salin/tempel antara sistem)
• Loop respons yang lambat (persetujuan, pengalihan tiket, pemberitahuan insiden)
• Hasil yang tidak konsisten (kesalahan manusia, langkah yang terlewat, pembaruan parsial)
• Integrasi yang rapuh (skrip satu kali tanpa visibilitas atau kepemilikan)

Otomatisasi adalah salah satu cara dengan leverage tertinggi untuk mengurangi gesekan tersebut. Bahkan alur kerja kecil — menyinkronkan data, memvalidasi payload, memposting pemberitahuan, memperbarui catatan — dapat terakumulasi menjadi kemenangan yang berarti: waktu siklus yang lebih cepat, lebih sedikit kesalahan, dan operasi yang lebih konsisten. Penting untuk dicatat, “otomatisasi” tidak hanya tentang mengurangi usaha; ini juga tentang membuat proses dapat diamati dan dapat diulang.

Laporan ini mendekati otomatisasi seperti infrastruktur produksi: menyebarkannya dengan bersih, mengontrol konfigurasi, menjaga data tetap persisten, dan memverifikasi perilaku dengan alur kerja pengujian yang deterministik.

Apa itu N8N (dan mengapa itu bisa menjadi teman terbaik Anda)

N8N adalah platform otomatisasi alur kerja yang memungkinkan Anda menghubungkan layanan menggunakan editor berbasis node. Anda membangun alur kerja dari “node” (pemicu, transformasi data, panggilan API, operasi basis data, pemberitahuan), kemudian menjalankannya secara manual, sesuai jadwal, atau melalui webhook.

Apa yang membuat n8n sangat berguna dalam konteks penyebaran Linux:

• Self-hostable: Anda dapat menjalankannya di infrastruktur Anda sendiri untuk kontrol atas data dan jaringan.
• Integrasi yang dapat diperluas: banyak node bawaan, ditambah node HTTP generik untuk apa pun yang memiliki API.
• Ramah operasional: berjalan dengan baik dalam kontainer, dapat menggunakan Postgres untuk persistensi, dan mendukung konfigurasi yang didorong oleh lingkungan.
• Baik untuk adopsi bertahap: mulai dengan alur kerja sederhana, kemudian memperkuat akses (reverse proxy + HTTPS) dan praktik operasional seiring pertumbuhan penggunaan.

Dalam penilaian ini, n8n diperlakukan seperti layanan yang mungkin benar-benar Anda jalankan: pilihan penyebaran dan konfigurasi didokumentasikan dengan bias menuju kejelasan, reproduksibilitas, dan “penguatan masa depan” (tanpa merancang ulang pengaturan awal).

Self-host instance N8N Anda sendiri

Siap untuk mencoba? Pengaturannya memerlukan beberapa langkah teknis, tetapi jangan khawatir — ikuti panduan ini dan Anda akan memiliki instance N8N pertama Anda berjalan dalam waktu singkat.

Tutorial ini menggunakan Ubuntu 22.04, berjalan di VPS yang disediakan oleh AlexHost.

Pengaturan Docker

Ada beberapa cara untuk mengatur n8n. Untuk tutorial ini, kami menggunakan Docker karena memberikan pendekatan yang jelas dan dapat diandalkan untuk mengelola dan mengonfigurasi n8n.

Pertama, pastikan bahwa docker dan docker compose terinstal di sistem Anda.

# Check for docker
docker -v

# Check for docker compose
docker compose

Jika itu mengembalikan versi, Anda sudah siap.

Jika Anda tidak menginstalnya, cukup ikuti halaman ini untuk instruksi: panduan instalasi. Pastikan untuk memilih OS yang tepat yang Anda gunakan.

Struktur Proyek

Mengorganisir file dengan benar sangat penting untuk kejelasan dan pemeliharaan jangka panjang. Secara konvensional, layanan Docker biasanya ditempatkan di bawah direktori /opt. Di dalamnya, folder docker_services dibuat untuk menyimpan semua layanan, termasuk N8N.

# Create all the needed folders
sudo mkdir -p /opt/docker_services/n8n

# Navigate to n8n folder
cd /opt/docker_services/n8n

Menambahkan file docker compose

Untuk memutar instance n8n kami dan basis data backend-nya, kami akan menggunakan file compose.yaml. Kami memilih PostgreSQL daripada SQLite default karena menyediakan penyimpanan data yang jauh lebih kuat dan siap produksi untuk konfigurasi dan log eksekusi.

Buat file menggunakan editor teks seperti nano:

nano compose.yaml

Tempel konfigurasi berikut ke dalam file:

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    env_file:
      - .env
    volumes:
      - ./data:/home/node/.n8n
      - ./files:/files
    depends_on:
      - postgres

  postgres:
    image: postgres:15
    restart: always
    env_file:
      - .env
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

Memahami konfigurasi:

Sebelum memulai kontainer, Anda perlu secara eksplisit membuat direktori yang diperlukan agar siap dipetakan:

# Use your own path if different
cd /opt/docker_services/n8n

mkdir data files postgres-data

Kepemilikan dan izin direktori

Secara default, ketika Docker secara otomatis membuat direktori host untuk volume Anda (seperti folder data dan files kami), ia menetapkan kepemilikan kepada pengguna root. Namun, untuk alasan keamanan, kontainer n8n sengaja menurunkan hak istimewa dan berjalan sebagai pengguna non-root (khususnya, UID 1000).

Jika folder ini tetap dimiliki oleh root, n8n tidak akan dapat menyimpan konfigurasi atau file basis datanya, menyebabkan kontainer crash saat startup dengan kesalahan ‘izin ditolak’. Untuk mencegah gesekan ini, kami secara eksplisit memberikan kepemilikan direktori ini kepada pengguna yang benar sebelum memulai layanan.

# Set ownership of the volume directories to UID/GID 1000
sudo chown -R 1000:1000 data files

Menambahkan file .env

Docker menggunakan file .env untuk mengirimkan konfigurasi sistem dan rahasia ke dalam kontainer kami tanpa mengkodekan keras ke dalam compose.yaml kami.

Buat file di direktori yang sama:

nano .env

Tempel konfigurasi berikut (pastikan untuk mengganti example.com dan kata sandi basis data dengan nilai aman Anda sendiri):

# n8n Settings
DOMAIN_NAME=example.com
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Europe/Chisinau
N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.example.com/
N8N_SECURE_COOKIE=false
NODE_ENV=production


# PostgreSQL
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=changeme123

Memahami variabel lingkungan:

Simpan dan tutup file. Anda sekarang memiliki semua konfigurasi yang diperlukan untuk menjalankan tumpukan Docker Compose Anda.

Memulai layanan docker

Jelajahi direktori proyek Anda dan bawa semua layanan ke latar belakang.

# Use your own path if different
cd /opt/docker_services/n8n

docker compose up -d

Docker menarik gambar yang diperlukan dan memulai kontainer Anda. Setelah berjalan, n8n akan tersedia di port 5678 (default), atau di domain yang Anda konfigurasikan jika menggunakan reverse proxy.

Untuk memastikan bahwa semuanya berfungsi dengan baik, periksa apakah kontainer n8n dan postgres terdaftar dan berjalan.

docker ps

Bekerja dengan N8N

Setelah layanan berjalan dengan sukses, saatnya yang menarik untuk mulai menjelajahi N8N!

Akses N8N

N8N dapat diakses melalui browser web. Dalam pengaturan lokal ini, tersedia di URL berikut: http://localhost:5678.

Pada akses pertama, halaman login muncul dengan kolom umum untuk diisi.

Atur kunci lisensi

Awalnya, N8N menampilkan jendela yang menawarkan kunci lisensi gratis yang membuka fitur berbayar. Ya, Anda tidak salah dengar: fitur berbayar secara gratis! Ini adalah salah satu keuntungan menjalankan instance N8N yang dihosting sendiri.

Setelah Anda menerima kunci lisensi di email Anda, Anda dapat menavigasi ke Pengaturan->Penggunaan dan Rencana untuk mengaktifkannya.

Membuat alur kerja pertama

Alur kerja baru dapat dibuat langsung dari halaman utama. Lihat gambar di bawah ini.

Untuk kasus eksekusi pertama, dua node akan digunakan:

• Pemicu Manual: memulai alur kerja secara manual.
• Set Node: mendefinisikan dan bekerja dengan bidang dan nilai mereka.

Node Pemicu Manual tidak memerlukan konfigurasi, sementara node Set memerlukan. Dalam kasus kami, tujuannya adalah untuk mengeluarkan pesan yang menyatakan ‘n8n berfungsi’ bersama dengan cap waktu dari peristiwa tersebut. Node Set dikonfigurasi seperti yang ditunjukkan dalam gambar di bawah ini.

Setelah kedua node terhubung dan dikonfigurasi, kami memulai alur kerja dengan menekan tombol Eksekusi alur kerja.

Selamat 👏, alur kerja N8N pertama Anda telah berhasil dieksekusi!

Apa selanjutnya?

Pengaturan awal ini hanyalah permulaan. Kekuatan nyata N8N terbuka ketika Anda mulai menghubungkan alat harian Anda untuk mengotomatiskan tugas berulang dan mengurangi gesekan. Misalnya, Anda dapat membuat alur kerja untuk secara otomatis menyinkronkan prospek baru dari situs web Anda ke dalam CRM, mengalihkan pemberitahuan mendesak dan kesalahan layanan kritis ke obrolan tim, atau secara berkala mencadangkan data dari berbagai platform SaaS ke basis data Anda. Kemungkinan untuk mengotomatiskan operasi Anda dan menyederhanakan beban kerja harian Anda hampir tidak terbatas.

Kesimpulan

Dengan menyelesaikan panduan ini, Anda telah berhasil menyebarkan platform kuat yang dihosting sendiri yang mampu mengubah cara Anda mengelola operasi harian. Terima kasih telah mengikuti pengaturan ini! Saat Anda terus menjelajahi apa yang dapat dilakukan N8N, pastikan untuk memeriksa tutorial kami yang lain untuk menemukan lebih banyak alat yang luar biasa dan berguna. Ketika Anda siap untuk meningkatkan atau terjun ke proyek baru yang menarik, ingatlah bahwa AlexHost menyediakan semua infrastruktur yang kuat yang Anda butuhkan untuk menghosting layanan Anda dengan andal.