Welcome to our QuickStart template – your portal to swift application development and seamless local testing. Whether you're automating your first workflow or moving an existing instance onto managed infrastructure, our template, based on n8n's self-hosting guide, has got you covered.
Create a Divio Account and choose n8n from the template selection when creating a new application. Alternatively, click the Deploy to Divio button above and follow the app creation wizard. Finally, deploy your app to the test or live environment.
n8n needs three things that the wizard does not set for you:
- A Business subscription with at least 1024 MB of memory. n8n will not start on Lite, nor on the 512 MB Business configuration — see Resource Requirements.
- A PostgreSQL addon. n8n defaults to SQLite, which cannot survive a redeploy on Divio. Add object storage too if you want S3 for binary data.
- An
N8N_ENCRYPTION_KEYenvironment variable. Generate one withopenssl rand -hex 32, add it per environment, and keep a copy somewhere safe — see Set the encryption key.
After deploying, open the app URL and create the owner account. Until you do, anyone who reaches the URL can claim it, so do this immediately.
For in-depth details about Divio Cloud, refer to the Divio documentation.
Install the Divio CLI to set up your app locally.
Alternatively, build this app locally using Docker:
- Ensure Docker is installed and running.
- Clone this repository locally.
- Build the app with
docker compose build. - Run the app using
docker compose up. - Open http://localhost:8000 to view your app.
.env-local supplies the same variable names Divio injects in the cloud, so the
container boots through an identical code path in both places. The encryption
key in it is a throwaway — never reuse it in a Divio environment.
If your Divio PostgreSQL is not version 16, change the database_default image
in docker-compose.yml to match DEFAULT_DATABASE_VERSION.