# techakash32/n8n-free-cloud-deployment architecture

> Architecture diagram of the GitHub repository techakash32/n8n-free-cloud-deployment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/techakash32/n8n-free-cloud-deployment
- Repository: https://github.com/techakash32/n8n-free-cloud-deployment

## Overview

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: [`.github/workflows/update-n8n.yml`](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/update-n8n.yml) (Version Update Workflow), [`healthcheck-rebuild.sh`](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/healthcheck-rebuild.sh) (Readiness and Rebuild), [`Auto keep n8n alive and updates on n8n-free repo.json`](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Auto%20keep%20n8n%20alive%20and%20updates%20on%20n8n-free%20repo.json) (In-App Workflow), [`Dockerfile`](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Dockerfile) (n8n Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Space Runtime"]
  node_n8n["n8n Service"]
end

subgraph group_automation["GitHub Automation"]
  node_healthcheck["Healthcheck Workflow<br/>[healthcheck.yml]"]
  node_healthscript["Readiness and Rebuild"]
  node_push["Space Push Workflow"]
  node_update["Version Update Workflow<br/>[update-n8n.yml]"]
  node_blocklist["Version Blocklist"]
  node_hfkeepalive["Space Keep-Alive"]
  node_dbkeepalive["Database Keep-Alive"]
end

subgraph group_optional["Optional Workflow"]
  node_n8nworkflow["In-App Workflow"]
end

node_maintainer(("Maintainer"))
node_github["GitHub Actions"]
node_hf["Hugging Face Space"]
node_supabase[("Supabase Postgres")]

node_maintainer -->|"triggers workflows"| node_github
node_github -->|"runs"| node_healthcheck
node_healthcheck -->|"calls"| node_healthscript
node_healthscript -->|"checks readiness"| node_hf
node_healthscript -->|"forces rebuild"| node_hf
node_github -->|"runs on commits"| node_push
node_push -->|"pushes main"| node_hf
node_github -->|"runs manually"| node_update
node_update -->|"checks versions"| node_blocklist
node_update -->|"updates image tag"| node_n8n
node_update -->|"pushes update"| node_hf
node_hf -->|"runs container"| node_n8n
node_n8n -->|"stores data"| node_supabase
node_github -->|"runs scheduled job"| node_hfkeepalive
node_hfkeepalive -->|"pings Space"| node_hf
node_github -->|"runs scheduled job"| node_dbkeepalive
node_dbkeepalive -->|"pings table"| node_supabase
node_maintainer -->|"imports optionally"| node_n8nworkflow
node_n8nworkflow -.->|"triggers keep-alive"| node_hfkeepalive
node_n8nworkflow -.->|"triggers updates"| node_update

click node_n8n "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Dockerfile"
click node_healthcheck "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/healthcheck.yml"
click node_healthscript "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/healthcheck-rebuild.sh"
click node_push "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/push-to-huggingface.yml"
click node_update "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/update-n8n.yml"
click node_blocklist "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/version-blocklist.txt"
click node_hfkeepalive "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/huggingface-keep-alive.yml"
click node_dbkeepalive "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/supabase-keep-alive.yml"
click node_n8nworkflow "https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Auto%20keep%20n8n%20alive%20and%20updates%20on%20n8n-free%20repo.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_n8n toneBlue
class node_healthcheck,node_healthscript,node_push,node_update,node_blocklist,node_hfkeepalive,node_dbkeepalive,node_supabase toneAmber
class node_n8nworkflow toneMint
class node_maintainer,node_github,node_hf toneIndigo
```

## Components

### Space Runtime

- [n8n Service](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Dockerfile): `Dockerfile`

### GitHub Automation

- [Healthcheck Workflow](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/healthcheck.yml): `.github/workflows/healthcheck.yml`
- [Readiness and Rebuild](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/healthcheck-rebuild.sh): `healthcheck-rebuild.sh`
- [Space Push Workflow](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/push-to-huggingface.yml): `.github/workflows/push-to-huggingface.yml`
- [Version Update Workflow](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/update-n8n.yml): `.github/workflows/update-n8n.yml`
- [Version Blocklist](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/version-blocklist.txt): `version-blocklist.txt`
- [Space Keep-Alive](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/huggingface-keep-alive.yml): `.github/workflows/huggingface-keep-alive.yml`
- [Database Keep-Alive](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/.github/workflows/supabase-keep-alive.yml): `.github/workflows/supabase-keep-alive.yml`

### Optional Workflow

- [In-App Workflow](https://github.com/techakash32/n8n-free-cloud-deployment/blob/main/Auto%20keep%20n8n%20alive%20and%20updates%20on%20n8n-free%20repo.json): `Auto keep n8n alive and updates on n8n-free repo.json`

### Other components

- **Maintainer**
- **GitHub Actions**
- **Hugging Face Space**
- **Supabase Postgres**

## Connections

- Maintainer → GitHub Actions: triggers workflows (evidence: `README.md`)
- GitHub Actions → Healthcheck Workflow: runs (evidence: `README.md`)
- Healthcheck Workflow → Readiness and Rebuild: calls (evidence: `README.md`)
- Readiness and Rebuild → Hugging Face Space: checks readiness (evidence: `README.md`)
- Readiness and Rebuild → Hugging Face Space: forces rebuild (evidence: `README.md`)
- GitHub Actions → Space Push Workflow: runs on commits (evidence: `README.md`)
- Space Push Workflow → Hugging Face Space: pushes main (evidence: `README.md`)
- GitHub Actions → Version Update Workflow: runs manually (evidence: `README.md`)
- Version Update Workflow → Version Blocklist: checks versions (evidence: `README.md`)
- Version Update Workflow → n8n Service: updates image tag (evidence: `README.md`)
- Version Update Workflow → Hugging Face Space: pushes update (evidence: `README.md`)
- Hugging Face Space → n8n Service: runs container (evidence: `README.md`)
- n8n Service → Supabase Postgres: stores data (evidence: `README.md`)
- GitHub Actions → Space Keep-Alive: runs scheduled job (evidence: `README.md`)
- Space Keep-Alive → Hugging Face Space: pings Space (evidence: `README.md`)
- GitHub Actions → Database Keep-Alive: runs scheduled job (evidence: `README.md`)
- Database Keep-Alive → Supabase Postgres: pings table (evidence: `README.md`)
- Maintainer → In-App Workflow: imports optionally (evidence: `README.md`)
- In-App Workflow → Space Keep-Alive: triggers keep-alive (evidence: `README.md`)
- In-App Workflow → Version Update Workflow: triggers updates (evidence: `README.md`)