Free Full Guide to Deploy n8n on HuggingFace

1. Create an online PostgreSQL database

Use Supabase (https://supabase.com/) to obtain a persistent PostgreSQL instance. Log in, create an organization, start a new project, and copy the connection details—host, port, database, user, pool_mode, and password. Keep these credentials for later configuration.

host : aws-1-us-east-1.pooler.supabase.com

port : 6543

database : postgres

user : postgres.mfoqhqwbmwkqumelngbj

pool_mode : transaction

password : the password you set when creating the Supabase project

2. Deploy n8n on HuggingFace

Navigate to https://huggingface.co/spaces and search for “n8n”. Click the “Copy Space” button on a suitable n8n template.

During the copy process, several fields are pre‑filled with the original author’s information. Replace them with your own details, especially the Supabase connection information gathered in step 1.

Determine the correct N8N_HOST value. The full access URL is built from your HuggingFace nickname, a hyphen, the space name you chose, and the top‑level domain hf.space. For example: https://workman2588-n8n-free.hf.space After copying, HuggingFace automatically builds the environment. When the logs display the n8n version and the status running, the deployment is successful.

Open the URL in a browser, register with a username and password, and you now have an online n8n service ready to use webhooks and other integrations.

3. Verify database connectivity

Create a new workflow in the n8n UI, give it a name, and save it. Then return to the Supabase dashboard, open the “Table Editor”. If you see tables automatically created by n8n, the connection to Supabase is working.

4. Test the webhook feature

Add a Webhook node to your workflow canvas.

Copy the generated webhook URL from the node and ensure the node is listening.

In a new browser tab, paste the URL and append a test query string, e.g. ?name=tutu, then press Enter.

Return to the n8n workflow view; the Webhook node should show that it received the request, confirming that the webhook endpoint is functional.

5. Manage the HuggingFace space

To delete the space, go to your HuggingFace personal homepage → Settings → Delete project.

To modify build‑time variables, open Settings → Variables and secrets, edit the required values, and restart the space for the changes to take effect.