How techakash32/n8n-free-cloud-deployment works
N8n Free packages n8n as a Hugging Face Space deployment backed by Supabase Postgres, with GitHub Actions for publishing, version updates, health recovery, and keep-alive checks. The main operational path is a repository change or update trigger, followed by a Space push and n8n runtime; health checks can request a rebuild when readiness fails. Supabase and Hugging Face keep-alive checks are separate automation branches, and an optional imported n8n workflow can trigger keep-alive and update tasks. Relationships below are based on README documentation; source excerpts were not provided.
Main entry points: update-n8n.yml Version Update Workflow · healthcheck-rebuild.sh Readiness and Rebuild · Auto keep n8n alive and updates on n8n-free repo.json In-App Workflow · Dockerfile n8n Service
Components 13
Space Runtime
- n8n Service
Dockerfile
GitHub Automation
- Healthcheck Workflow
.github/workflows/healthcheck.yml - Readiness and Rebuild
healthcheck-rebuild.sh - Space Push Workflow
.github/workflows/push-to-huggingface.yml - Version Update Workflow
.github/workflows/update-n8n.yml - Version Blocklist
version-blocklist.txt - Space Keep-Alive
.github/workflows/huggingface-keep-alive.yml - Database Keep-Alive
.github/workflows/supabase-keep-alive.yml
Optional Workflow
- In-App Workflow
Auto keep n8n alive and updates on n8n-free repo.json
Other components
- Maintainer
- GitHub Actions
- Hugging Face Space
- Supabase Postgres
Connections 20
- Maintainer → GitHub Actions: triggers workflows
README.md - GitHub Actions → Healthcheck Workflow: runs
README.md - Healthcheck Workflow → Readiness and Rebuild: calls
README.md - Readiness and Rebuild → Hugging Face Space: checks readiness
README.md - Readiness and Rebuild → Hugging Face Space: forces rebuild
README.md - GitHub Actions → Space Push Workflow: runs on commits
README.md - Space Push Workflow → Hugging Face Space: pushes main
README.md - GitHub Actions → Version Update Workflow: runs manually
README.md - Version Update Workflow → Version Blocklist: checks versions
README.md - Version Update Workflow → n8n Service: updates image tag
README.md - Version Update Workflow → Hugging Face Space: pushes update
README.md - Hugging Face Space → n8n Service: runs container
README.md - n8n Service → Supabase Postgres: stores data
README.md - GitHub Actions → Space Keep-Alive: runs scheduled job
README.md - Space Keep-Alive → Hugging Face Space: pings Space
README.md - GitHub Actions → Database Keep-Alive: runs scheduled job
README.md - Database Keep-Alive → Supabase Postgres: pings table
README.md - Maintainer → In-App Workflow: imports optionally
README.md - In-App Workflow → Space Keep-Alive: triggers keep-alive
README.md - In-App Workflow → Version Update Workflow: triggers updates
README.md