Hosting n8n on Raspberry Pi

Hosting n8n on Raspberry Pi

n8n is an open-source workflow automation tool that enables users to connect various applications and services, facilitating the automation of tasks without the need for extensive coding. It offers a user-friendly interface with a visual workflow editor, allowing users to design complex automation processes through a simple drag-and-drop mechanism. This tutorial will teach you the steps to run n8n on Raspberry Pi. 

n8n on Raspberry Pi

1. Update Your Raspberry Pi System

To install n8n on Raspberry Pi, we will begin by ensuring your Raspberry Pi is running the latest system updates. Open the terminal and execute:

sudo apt update && sudo apt upgrade -y

2. Install Node.js and npm

n8n is built on Node.js, so you'll need to install Node.js and npm. Run the following commands:

curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

After installation, verify the versions:

node -v
npm -v

3. Install n8n

Use npm to install n8n on Raspberry Pi globally:

sudo npm install -g n8n

4. Set Up n8n as a System Service

To have n8n start automatically with your Raspberry Pi, set it up as a system service:

  1. Create the n8n service file: 
    sudo nano /etc/systemd/system/n8n.service

  2. Add the following content to the file:

    [Unit]
Description=n8n Automation Tool
After=network.target

[Service]
ExecStart=/usr/bin/n8n
Restart=always
User=pi
Environment=PATH=/usr/bin:/usr/local/bin
Environment=NODE_ENV=production
WorkingDirectory=/home/pi/

[Install]
WantedBy=multi-user.target
  3. Enable and start the service: 
    sudo systemctl enable n8n
sudo systemctl start n8n
  4. Check the service status: 
    sudo systemctl status n8n

5. Access the n8n Web Interface

By default, n8n runs on port 5678. Access it via your browser:

http://<Raspberry_Pi_IP_Address>:5678

Replace <Raspberry_Pi_IP_Address> with your Raspberry Pi's actual IP address.

6. Configure the AI Agent Functionality

n8n's AI Agent feature enables the creation of intelligent workflows. Here's how to set it up:

  1. Create a New Workflow:

    In the n8n web interface, click on "New Workflow" to start a new project.

  2. Add a Trigger Node:

    Click on the canvas and select "Chat Trigger" to start the workflow upon receiving a chat message.

  3. Add an AI Agent Node:

    Click on the "+" icon, search for "AI Agent," and add it to your workflow.

  4. Configure the AI Agent Node:
    • In the AI Agent node settings, set the "Source" to "Chat Trigger."
    • Choose "Tools Agent" for the "Agent" setting.
  5. Integrate a Chat Model:
    • Click on the "+" icon under the "Chat Model" connection in the AI Agent node.
    • Select "OpenAI Chat Model" from the list.
    • Enter your OpenAI API key in the credentials section.
  6. Add Memory for Context:
    • To maintain conversation context, add a "Window Buffer Memory" node.
    • Connect it to the AI Agent node and configure the memory size (e.g., 5 interactions).
  7. Save and Activate the Workflow:

    After configuring, save the workflow and activate it to start processing chat inputs.

By following these steps, you can set up n8n on your Raspberry Pi and utilize its AI Agent functionality to create intelligent automation workflows.

For a detailed walkthrough, refer to n8n's official tutorial: (AI Agent node)

Back to blog