DEV Community

Mahinsha Nazeer
Mahinsha Nazeer

Posted on • Originally published at Medium on

Installing and Configuring n8n on a Raspberry Pi (Private Home Server)

#raspberrypi #n8n #ai #agents

GitHub - mahinshanazeer/n8n-home-server: Installing and Configuring n8n on a Raspberry Pi (Private Home Server)

Introduction

Automation is becoming a core part of modern workflows, whether for DevOps, personal productivity, or integrations. n8n is a powerful, open-source workflow automation platform that allows you to create custom integrations with full control over your data.

In this guide, we will set up n8n on a Raspberry Pi using Docker, configured for private network access (no domain, no SSL) — ideal for home labs.

Why Self-Host n8n on Raspberry Pi?

  • Low-cost, always-on device
  • Full data privacy (no third-party cloud dependency)
  • Perfect for home lab and DevOps experimentation
  • Lightweight yet powerful automation engine

Prerequisites

Ensure the following are ready:

  • Raspberry Pi (Pi 4/5 recommended, 4GB+ RAM)
  • Linux OS (Ubuntu Server / Raspberry Pi OS Lite)
  • Docker & Docker Compose installed
  • Static private IP (recommended)

Project Structure

We will keep everything inside a single directory:

~/n8n/
├── .env
├── docker-compose.yml
├── n8n-data/
└── local-files/
Enter fullscreen mode Exit fullscreen mode


directory structure

This approach ensures:

  • Easy backup
  • Clean portability between systems
  • Full control over persistent data

Step 1: Create Project Directory 

mkdir -p ~/n8n && cd ~/n8n
mkdir n8n-data local-files
Enter fullscreen mode Exit fullscreen mode

Step 2: Create Environment Configuration

Create a .env file:

nano .env
Enter fullscreen mode Exit fullscreen mode

Add the following:

N8N_HOST=192.168.1.200
N8N_PORT=5678
N8N_PROTOCOL=http

WEBHOOK_URL=http://192.168.1.200:5678/

GENERIC_TIMEZONE=Asia/Kolkata

N8N_SECURE_COOKIE=false
Enter fullscreen mode Exit fullscreen mode

Key Notes:

  • N8N_HOST → Your Raspberry Pi private IP
  • WEBHOOK_URL → Required for workflows
  • N8N_SECURE_COOKIE=false → Mandatory for HTTP access

Step 3: Create Docker Compose File

Create docker-compose.yml:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=${N8N_HOST}
      - N8N_PORT=${N8N_PORT}
      - N8N_PROTOCOL=${N8N_PROTOCOL}
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=${N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS}
      - N8N_SECURE_COOKIE=${N8N_SECURE_COOKIE}
      - NODE_ENV=${NODE_ENV}
      - WEBHOOK_URL=${WEBHOOK_URL}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
    volumes:
      # n8n data: SQLite database and encryption key
      - ./n8n-data:/home/node/.n8n
      # Shared files between n8n and host (use /files path inside n8n)
      - ./local-files:/files
Enter fullscreen mode Exit fullscreen mode

Step 4: Start n8n 

docker compose up -d
Enter fullscreen mode Exit fullscreen mode

Verify:

docker compose ps
Enter fullscreen mode Exit fullscreen mode

Step 5: Access n8n

Open in browser:

http://192.168.1.200:5678
Enter fullscreen mode Exit fullscreen mode


home page

  • Create your admin account
  • Start building workflows (will create another blog on building workflows)

Common Issue (Important)

Secure Cookie Error

You may see:

“Your n8n server is configured to use a secure cookie…”

Fix:

Set in .env:

N8N_SECURE_COOKIE=false
Enter fullscreen mode Exit fullscreen mode

Restart:

docker compose down
docker compose up -d
Enter fullscreen mode Exit fullscreen mode

Data Persistence

All important data is stored in:

~/n8n/n8n-data
Enter fullscreen mode Exit fullscreen mode

This includes:

  • Workflows
  • Credentials
  • SQLite database

Github: https://github.com/mahinshanazeer/n8n-home-server

Top comments (0)