File size: 2,147 Bytes
e110d9d
 
1c85513
e110d9d
 
 
 
42a7d7b
e110d9d
3505a64
 
320e776
e110d9d
 
320e776
e110d9d
320e776
e110d9d
42a7d7b
e110d9d
320e776
 
 
 
 
 
e110d9d
42a7d7b
e110d9d
42a7d7b
e110d9d
42a7d7b
e110d9d
320e776
42a7d7b
320e776
42a7d7b
320e776
42a7d7b
320e776
42a7d7b
 
 
320e776
 
 
42a7d7b
 
 
320e776
42a7d7b
 
 
320e776
 
 
42a7d7b
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
---
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

[![Duplicate this Space](https://huggingface.co/datasets/huggingface/badges/resolve/main/duplicate-this-space-xl.svg)](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)*