README.md

---
title: N8n
emoji: 😻
colorFrom: indigo
colorTo: yellow
sdk: docker
pinned: false
license: ecl-2.0
short_description: n8n
---

## Deploy n8n Gratis di Hugging Face Spaces

Belum punya cloud atau domain sendiri? Gak masalah!
Template ini bantu kamu hosting n8n langsung di Hugging Face Spaces, gratis dan tanpa ribet.

> 📌 Tutorial ini diadaptasi dari:  
> [Reddit - Deploy n8n for free with Hugging Face Spaces](https://www.reddit.com/r/n8n/comments/1lxp0jx/deploy_n8n_for_free_with_hugging_face_spaces/)

---

Video Tutorial: 

> [Type Click Done - Host n8n Gratis](https://www.tiktok.com/@typeclickdone)

![tutorial](images/tutorial.png)

--- 

Hugging Face Spaces menyediakan layanan gratis dengan spesifikasi berikut:

| **Perangkat Keras** | **CPU**  | **RAM**  | **Harga per Jam** |
| ------------------- | -------- | -------- | ----------------- |
| CPU Basic           | 2 vCPU   | 16 GB    | Gratis!           |

Spesifikasi ini sudah cukup untuk menjalankan n8n tanpa perlu server sendiri. Yuk kita deploy n8n dengan cara mudah!

---

## Menggunakan Supabase sebagai Database

Masalah utama dari **setup yang gratisan** adalah database bawaan n8n (SQLite) menyimpan data di dalam **filesystem container**, bukan di volume yang bersifat *persistent*, kecuali kamu secara eksplisit melakukan mounting volume tersebut.

Di Hugging Face Spaces versi gratis, kita **tidak bisa membuat volume persistent**, sehingga setiap kali container di-restart (misalnya karena redeploy), seluruh data akan hilang.

Solusinya: gunakan **Supabase** sebagai database eksternal yang *persisten dan stabil*.

---

### Langkah-langkah Menghubungkan Supabase:

1. **Daftar akun gratis di:**  
   [https://supabase.com/dashboard/sign-up](https://supabase.com/dashboard/sign-up)

   ![supabase_signup](images/supabase_signup.png)

   ![supabase_organization](images/supabase_organization.png)

2. **Buat project baru**, isi form yang diminta, dan **catat password database** yang ditampilkan.  
   Password ini akan digunakan nanti saat konfigurasi koneksi database di Dockerfile atau `.env`.

   ![supabase_database](images/supabase_database.png)

3. Setelah project dibuat, klik tombol **Connect** di menu kiri atas untuk melihat detail koneksi database.

   ![supabase_connect](images/supabase_connect.png)

4. Pilih opsi **SQLAlchemy** sebagai format *Connection String*, lalu cari bagian **Transaction Pooler**.

   ![supabase_sqlalchemy](images/supabase_sqlalchemy.png)

   ![supabase_transaction_pooler](images/supabase_transaction_pooler.png)

5. **Simpan informasi koneksi berikut untuk digunakan nanti:**
   - **Host**
   - **Port**
   - **User**
   - **DB Name**

---

Dengan Supabase, data workflow n8n kamu akan tetap aman dan tersimpan meskipun Space di-redeploy ulang.


---

### Langkah-langkah Deploy n8n di Hugging Face:

1. **Daftar akun gratis di**  
   [https://huggingface.co/join](https://huggingface.co/join) dan buat nama profil (misalnya: `typeclickdone`).  
   Ingat nama profil ini karena akan digunakan nanti.

2. **Akses halaman ini:**  
   [https://huggingface.co/spaces/typeclickdone/n8n](https://huggingface.co/spaces/typeclickdone/n8n)  
   Klik tombol menu di pojok kanan atas lalu pilih **Duplicate this space**.

   ![duplicate space](images/duplicate_space.png)

3. **Isi atau ubah secret dan variabel di form pop-up. Untuk *N8N_ENCRYPTION_KEY*, bisa digenerate dari situs UUID v4.**  
   [https://www.uuidgenerator.net/version4](https://www.uuidgenerator.net/version4)

   ![uuidv4](images/uuidv4.png)

   ![variabel](images/variabel.png)

4. **Ubah visibility menjadi *public*:**  

   ![public](images/public.png)

5. Klik tombol **Duplicate Space**, lalu tunggu proses deploy selesai. Kamu bisa melihat log-nya seperti ini:

   ![deploy log](images/deploy_log.png)

6. Setelah selesai deploy, kamu akan mendapatkan URL space milikmu sendiri seperti ini:

   **https://username_hugging_face_kamu-n8n.hf.space/**

   ![link_space](images/link_space.png)

---

Sekarang kamu bisa akses n8n-mu di URL:  
**https://username_hugging_face_kamu-n8n.hf.space/**

---