How to Deploy n8n on Zenifra

First Step

After selecting Create Project, we'll start gathering the necessary information!

Second Step

Field Details

Project Name

The project name is important for organizing projects and for the domain!

Here, you can choose any name you want, but a tip: For projects on the "basic" plan, the domain name to be used will be the project name.

Image

The project image is an OCI-standard image!

For n8n, we'll use the 2.5.2 available image:

docker.io/n8nio/n8n:2.5.2

For more information about n8n and its different images, visit the external link: n8n

Registry

For n8n, we'll use the official public image, which doesn't require authentication to download!

Plan

To run n8n, the "Premium" plan is sufficient, with 1vCPU and 1GB of RAM, which handles most automation workflows.

For more complex workflows or high execution volumes, we recommend the "Premium Plus" plan.

For n8n, it is highly recommended to use persistent storage, as your workflows, credentials, and execution data will be saved. Without persistent storage, you will lose everything when restarting the instance.

Storage Size

For testing purposes, we'll proceed with a size of 5GB, which is suitable to start.

For production environments with many workflows, consider larger sizes.

Port Number

By default, n8n runs on port 5678!

Payment Plan Model

Here, since we'll be running this for testing purposes, we'll select the "hourly" model, which will charge a minimum of 1 hour of project usage.

For automations that need to run 24/7, the monthly model may be more advantageous.

Number of Instances

For n8n, we'll proceed with just 1 instance. n8n doesn't have native load balancing for the web interface.

Environment Variables

n8n needs some environment variables for basic configuration:

N8N_BASIC_AUTH_ACTIVE = true
N8N_BASIC_AUTH_USER = <username>
N8N_BASIC_AUTH_PASSWORD = <password>
N8N_HOST = 0.0.0.0
N8N_PORT = 5678
WEBHOOK_URL = https://<your-domain>/webhook/

For production, also consider:

N8N_ENCRYPTION_KEY = <random-encryption-key>
N8N_PROTOCOL = https
NODE_ENV = production

Total Cost

In this section, you can view the total cost of the project!

Remember that Zenifra offers discounts for properly enrolled students and free access for partnered schools and universities!

In addition, new users get R$30 monthly for 3 months to use as they like, on any plan!

Third Step

After filling in all the information above, click the "Create Project" button, which may take a few seconds to complete the project creation!

Once created, a new tab will automatically open showing the URL of the project to access.

Click on this link, which will open a new tab in your browser, redirecting you directly to the created n8n! Log in with the credentials defined in the environment variables.

Finalizing

If you want to stop/terminate the instance, go to the Projects tab, search for the created project, and click on the project name, which will open a new page containing the project's information.

When accessing the screen, click on "Settings" and "Delete," which will properly delete the project.

For more information on this screen and how to gain insights from your business, proceed to the next documentation!