| --- |
| title: Hugging8n |
| emoji: ♾️ |
| colorFrom: blue |
| colorTo: indigo |
| sdk: docker |
| app_port: 7861 |
| pinned: true |
| license: mit |
| secrets: |
| - name: HF_TOKEN |
| description: HuggingFace token with write access. Used for automatic backup. |
| --- |
| |
| # ♾️ Hugging8n |
|
|
| **Self-hosted n8n workflow automation — free, no server needed.** Hugging8n runs [n8n](https://n8n.io) on HuggingFace Spaces Docker, serving a premium dashboard at `/` and the n8n editor at `/app/`. |
|
|
| ## ✨ Features |
|
|
| - ⚡ **Zero Config:** Duplicate this Space, set `HF_TOKEN`, and you're ready. |
| - 💾 **Persistent Backup:** Workflows and credentials back up automatically to a private HF Dataset. |
| - 🔐 **Secure by Default:** Uses n8n v2's built-in user management. No more insecure environment variables. |
| - 🐳 **Docker Native:** Optimized for the free HF Spaces tier. |
| - 🌐 **Dashboard UI:** Beautiful management interface at the root URL. |
| - ⏰ **Built-in Keep-Alive:** Easily setup UptimeRobot from the dashboard. |
|
|
| ## 🚀 Quick Start |
|
|
| ### Step 1: Duplicate this Space |
|
|
| [](https://huggingface.co/spaces/somratpro/Hugging8n?duplicate=true) |
|
|
| ### Step 2: Add Your HF_TOKEN |
| |
| Add your HuggingFace token with **write** access to the Space Secrets. This enables automatic backup so your workflows aren't lost on restart. |
| |
| ### Step 3: Set Up Auth |
| |
| When the Space starts, visit the URL and click **Open n8n Editor**. On the first run, n8n will ask you to create an owner account. **This is your primary login.** |
| |
| ## 🔐 Authentication |
| |
| Hugging8n uses n8n's native user management. |
| 1. The first person to visit `/app/` on a fresh install becomes the owner. |
| 2. If you are restoring from a backup, your existing user accounts will be active. |
| |
| ## 💾 Persistent Backup |
| |
| Your data is synced to a private dataset named `hugging8n-backup` in your HF account. |
| |
| ## 🏗️ Architecture |
| |
| - `/` : Premium Dashboard (Status, Uptime, Keep-Alive setup) |
| - `/app/` : n8n Workflow Editor |
| - `/health` : Health check endpoint |
| |
| *Made with ❤️ by [@somratpro](https://github.com/somratpro)* |
| |
