🐳 Day 1 — Self-Hosting n8n dengan Docker & Ollama Lokal

Week 3 · Day 1 · 6 Video Topik: Cloud vs Self-Hosted, Instalasi Docker Desktop, Menjalankan n8n di Container, AI Agent Pertama di Self-Hosted, Integrasi Ollama untuk Model AI Lokal

📋 Daftar Isi

Cloud vs Self-Hosted: Perbandingan
Instalasi Docker Desktop
Menjalankan n8n di Docker Container
AI Agent Pertama di Self-Hosted
Integrasi Ollama: AI Sepenuhnya Lokal
Catatan OAuth untuk Self-Hosted

🔀 Cloud vs Self-Hosted: Perbandingan

Week 3 dimulai dengan keputusan penting bagi setiap pengguna n8n: tetap di cloud atau pindah ke self-hosted? Ini adalah "fork in the road" — sebuah persimpangan yang menentukan arah perjalanan Anda selanjutnya.

Tabel Perbandingan

Aspek	☁️ n8n Cloud	🏠 Self-Hosted
Setup	Sangat mudah, langsung pakai	Memerlukan instalasi Docker
Biaya	Langganan ~$20/bulan	Gratis (fair code license)
Webhook	Otomatis tersedia	Perlu konfigurasi tambahan (ngrok, dll.)
OAuth	One-click simplified	Full OAuth2 setup (manual GCP, dll.)
Kontrol	Terbatas pada fitur cloud	Kontrol penuh atas environment
Privasi	Data di server n8n	Data 100% di mesin Anda
Maintenance	Ditangani n8n	Tanggung jawab Anda sendiri

Opsi Self-Hosted

Self-hosted tidak berarti harus di komputer lokal saja. Ada dua jalur:

Self-Hosted
├── 💻 Lokal (komputer Anda sendiri)
│   └── Ideal untuk: belajar, eksperimen, privasi
└── ☁️ Deploy ke Cloud Server
    ├── AWS
    ├── Google Cloud Platform
    └── Microsoft Azure
    └── Ideal untuk: production, skalabilitas

💡 Rekomendasi Instruktur: Orang teknis sebaiknya mencoba instalasi lokal. Yang fokus pada penggunaan komersial bisa tetap di cloud.

🖥️ Instalasi Docker Desktop

Docker diibaratkan sebagai "komputer di dalam kotak" — sebuah cara untuk menjalankan aplikasi dalam lingkungan terisolasi yang disebut container.

Konsep Dasar Docker

Istilah	Penjelasan
Container	Instance berjalan dari sebuah image — seperti VM ringan
Image	Template/blueprint untuk membuat container
Volume	Penyimpanan persisten yang tetap ada meski container dihapus
Port Mapping	Menghubungkan port di host ke port di container

Langkah Instalasi

Download Docker Desktop dari docker.com
PC/Windows: Pastikan WSL2 (Windows Subsystem for Linux 2) sudah terinstal
Mac: Download versi sesuai chip (Intel atau Apple Silicon)
Install & restart komputer jika diminta
Buka Docker Desktop — pastikan muncul UI dengan tab: Containers, Images, Volumes

⚠️ Catatan Windows: WSL2 sangat direkomendasikan untuk performa optimal. Docker Desktop akan memandu instalasinya jika belum ada.

🚀 Menjalankan n8n di Docker Container

Step 1: Buat Docker Volume

bash

docker volume create n8n_data

Volume ini menyimpan data n8n secara persisten — workflow, credentials, dan settings Anda tidak hilang meski container di-restart.

Step 2: Jalankan Container n8n

bash

docker run \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE=Asia/Jakarta \
  -e TZ=Asia/Jakarta \
  -v n8n_data:/home/node \
  docker.n8n.io/n8nio/n8n

Penjelasan Setiap Flag

Flag	Fungsi
`--name n8n`	Memberi nama container "n8n"
`-p 5678:5678`	Map port 5678 host → port 5678 container
`-e GENERIC_TIMEZONE`	Set timezone untuk scheduling workflow
`-e TZ`	Set timezone sistem container
`-v n8n_data:/home/node`	Mount volume untuk data persisten
`docker.n8n.io/n8nio/n8n`	Image resmi n8n dari registry Docker

Diagram Arsitektur

┌─────────────────────────────────────────────┐
│            Komputer Anda (Host)              │
│                                              │
│  Browser → http://localhost:5678             │
│       │                                      │
│       ▼                                      │
│  ┌─────────────────────────────────┐         │
│  │     Docker Container: n8n       │         │
│  │                                 │         │
│  │   n8n App (:5678)               │         │
│  │       │                         │         │
│  │       ▼                         │         │
│  │   /home/node ──── Volume ────── │── n8n_data
│  └─────────────────────────────────┘         │
└─────────────────────────────────────────────┘

Step 3: Setup Owner Account

Buka browser → http://localhost:5678
Abaikan peringatan "Python 3 missing" (ini normal dan disengaja)
Buat Owner Account (email + password)
Aktivasi free license key yang ditawarkan
n8n self-hosted Anda siap digunakan! 🎉

🤖 AI Agent Pertama di Self-Hosted

Langkah pertama membuktikan bahwa n8n self-hosted sama powerfull-nya dengan versi cloud: membangun AI Agent sederhana.

Konfigurasi

Komponen	Detail
LLM Provider	OpenRouter
Model Utama	DeepSeek v3.2
Model Cadangan	GPT-4o (via OpenRouter)
Memory	Simple Memory
Tool	MarketStack (data pasar saham)

Temuan Penting

DeepSeek melalui OpenRouter terkadang tidak reliabel untuk tool calling — model kadang gagal memanggil tool dengan benar. Solusinya: beralih ke GPT-4o (model open-source dari OpenAI via OpenRouter) yang lebih stabil untuk use case ini.

💡 Pelajaran: Selalu uji beberapa model untuk task spesifik. Model yang lebih murah belum tentu cocok untuk semua kebutuhan, terutama tool calling yang membutuhkan presisi tinggi.

🦙 Integrasi Ollama: AI Sepenuhnya Lokal

Ini adalah bagian yang paling menarik — menjalankan AI 100% lokal tanpa internet, tanpa API key, tanpa biaya per-token!

Apa itu Ollama?

Ollama adalah platform untuk menjalankan Large Language Model secara lokal di komputer Anda. Model diunduh sekali, lalu berjalan sepenuhnya offline.

Langkah Integrasi

1. Install Ollama

Download dari ollama.com dan install.

2. Restart Container n8n dengan Flag Tambahan

bash

docker run \
  --name n8n \
  -p 5678:5678 \
  --add-host=host.docker.internal:host-gateway \
  -e GENERIC_TIMEZONE=Asia/Jakarta \
  -v n8n_data:/home/node \
  docker.n8n.io/n8nio/n8n

⚠️ Flag krusial: --add-host=host.docker.internal:host-gateway — flag ini memungkinkan container Docker berkomunikasi dengan aplikasi yang berjalan di host (komputer Anda), termasuk Ollama.

3. Konfigurasi di n8n

Setting	Nilai
Credential Type	Ollama Chat Model
Base URL	`http://host.docker.internal:11434`
Model	Mistral 3 (atau model lain yang tersedia)

Diagram Koneksi Docker ↔ Ollama

┌──────────────────────────────┐
│     Komputer Anda (Host)     │
│                              │
│  ┌────────────────────┐      │
│  │  Ollama Server     │      │
│  │  :11434            │      │
│  │  [Mistral 3]       │      │
│  └────────┬───────────┘      │
│           │                  │
│    host.docker.internal      │
│           │                  │
│  ┌────────▼───────────┐      │
│  │  Docker: n8n       │      │
│  │  :5678             │      │
│  │  AI Agent ─── Ollama Chat │
│  └────────────────────┘      │
└──────────────────────────────┘

Hasil

AI Agent berjalan sepenuhnya lokal — Mistral 3 di Ollama memproses semua request tanpa koneksi internet. Ini ideal untuk:

🔒 Privasi maksimal — data tidak pernah meninggalkan komputer Anda
💰 Biaya nol — tidak ada biaya per-token
🌐 Offline capable — bekerja tanpa internet setelah model diunduh

Opsi Deployment Ollama

Ollama
├── 🖥️ Di Host Machine (seperti yang kita lakukan)
│   └── Akses via host.docker.internal
└── 🐳 Di Docker Compose (bersama n8n)
    └── Lebih portable, satu command untuk semuanya

🔐 Catatan OAuth untuk Self-Hosted

Video terakhir di hari ini memberikan preview penting: di self-hosted, OAuth tidak semudah di cloud.

Fitur	Cloud	Self-Hosted
Google Sheets OAuth	One-click ✅	Full OAuth2 setup ❌
Gmail OAuth	One-click ✅	Full OAuth2 setup ❌
Google Drive OAuth	One-click ✅	Full OAuth2 setup ❌

Di cloud, n8n sudah menyiapkan OAuth2 application sehingga pengguna tinggal klik "Connect with Google". Di self-hosted, Anda harus:

Buat project di Google Cloud Console
Enable API yang diperlukan
Konfigurasi OAuth consent screen
Buat OAuth2 credentials
Copy redirect URI dari n8n
Masukkan Client ID + Client Secret

Detail lengkap tentang proses ini akan dibahas di Day 2.

📊 Tabel Terminologi

Istilah	Definisi
Docker	Platform untuk menjalankan aplikasi dalam container terisolasi
Container	Instance berjalan dari image — lingkungan aplikasi terisolasi
Image	Blueprint/template untuk membuat container
Volume	Storage persisten yang hidup di luar siklus container
Port Mapping	Meneruskan traffic dari port host ke port container
WSL2	Windows Subsystem for Linux 2 — menjalankan Linux di Windows
Ollama	Platform untuk menjalankan LLM secara lokal
host.docker.internal	DNS khusus untuk mengakses host dari dalam container
OpenRouter	Gateway API yang menyediakan akses ke berbagai model LLM
Fair Code License	Lisensi n8n — gratis untuk self-hosted dengan batasan tertentu

🏆 Pencapaian Day 1

✅ Memahami trade-off Cloud vs Self-Hosted
✅ Menginstal Docker Desktop
✅ Menjalankan n8n di Docker container
✅ Membuat owner account di self-hosted n8n
✅ Membangun AI Agent dengan OpenRouter + DeepSeek
✅ Mengintegrasikan Ollama untuk AI sepenuhnya lokal
✅ Memahami flag --add-host untuk koneksi Docker ↔ Host

🎯 Progres Keseluruhan: Memasuki Week 3 — fase Amplify! Self-hosted n8n membuka kemungkinan baru: kontrol penuh, privasi data, dan AI lokal tanpa biaya API.

🐳 Day 1 — Self-Hosting n8n dengan Docker & Ollama Lokal ​

📋 Daftar Isi ​

🔀 Cloud vs Self-Hosted: Perbandingan ​

Tabel Perbandingan ​

Opsi Self-Hosted ​

🖥️ Instalasi Docker Desktop ​

Konsep Dasar Docker ​

Langkah Instalasi ​

🚀 Menjalankan n8n di Docker Container ​

Step 1: Buat Docker Volume ​

Step 2: Jalankan Container n8n ​

Penjelasan Setiap Flag ​

Diagram Arsitektur ​

Step 3: Setup Owner Account ​

🤖 AI Agent Pertama di Self-Hosted ​

Konfigurasi ​

Temuan Penting ​

🦙 Integrasi Ollama: AI Sepenuhnya Lokal ​

Apa itu Ollama? ​

Langkah Integrasi ​

1. Install Ollama ​

2. Restart Container n8n dengan Flag Tambahan ​

3. Konfigurasi di n8n ​

Diagram Koneksi Docker ↔ Ollama ​

Hasil ​

Opsi Deployment Ollama ​

🔐 Catatan OAuth untuk Self-Hosted ​

📊 Tabel Terminologi ​

🏆 Pencapaian Day 1 ​

🐳 Day 1 — Self-Hosting n8n dengan Docker & Ollama Lokal

📋 Daftar Isi

🔀 Cloud vs Self-Hosted: Perbandingan

Tabel Perbandingan

Opsi Self-Hosted

🖥️ Instalasi Docker Desktop

Konsep Dasar Docker

Langkah Instalasi

🚀 Menjalankan n8n di Docker Container

Step 1: Buat Docker Volume

Step 2: Jalankan Container n8n

Penjelasan Setiap Flag

Diagram Arsitektur

Step 3: Setup Owner Account

🤖 AI Agent Pertama di Self-Hosted

Konfigurasi

Temuan Penting

🦙 Integrasi Ollama: AI Sepenuhnya Lokal

Apa itu Ollama?

Langkah Integrasi

1. Install Ollama

2. Restart Container n8n dengan Flag Tambahan

3. Konfigurasi di n8n

Diagram Koneksi Docker ↔ Ollama

Hasil

Opsi Deployment Ollama

🔐 Catatan OAuth untuk Self-Hosted

📊 Tabel Terminologi

🏆 Pencapaian Day 1