n8n

n8n

Docker app from medzin's Repository

Overview

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, and hundreds of integrations.

n8n Docker Image for Unraid

This repository provides a custom Docker image for n8n, specifically designed for better compatibility with Unraid and other systems where file permissions on mounted volumes can be problematic.

Key Features

  • User/Group ID Mapping: Supports PUID and PGID environment variables to run the n8n process with specific user and group IDs. This ensures that files created in your appdata share (e.g., /data/.n8n) are owned by your Unraid user, preventing permission issues.
  • Root Entrypoint: The container starts as root to allow necessary initializations (like user modifications) and then steps down to the specified user using su-exec. This structure is also compatible with Tailscale integrations that require root access for setup.
  • Automated Updates: A daily workflow checks for new stable n8n releases and automatically builds and publishes updated images to Docker Hub.

Usage

Docker CLI

docker run -d \
  --name n8n \
  -e PUID=99 \
  -e PGID=100 \
  -e UMASK=022 \
  -p 5678:5678 \
  -v /mnt/user/appdata/n8n:/data \
  medzin/n8n:latest

Environment Variables

Variable Description Default
PUID User ID to run the n8n process as. 1000
PGID Group ID to run the n8n process as. 1000
UMASK Umask for file creation. 022

License

This project is licensed under the MIT License - see the LICENSE file for details.

Install N8n on Unraid in a few clicks.

Find N8n in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for N8n Review the template variables and paths Click Install

Download Statistics

25,019
Total Downloads
2,941
This Month
3,934
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
medzin/n8n
Last Updated2026-06-29
First Seen2026-02-12

Runtime arguments

Web UI
http://[IP]:[PORT:5678]
Network
bridge
Shell
sh
Privileged
false

Template configuration

AppdataPathrw

Container path: /data

Target
/data
Default
/mnt/cache/appdata/n8n
Value
/mnt/cache/appdata/n8n
GENERIC_TIMEZONEVariable

The n8n instance timezone. Important for schedule nodes (such as Cron).

Default
Etc/UTC
Value
Etc/UTC
N8N_DEFAULT_LOCALEVariable

A locale identifier, compatible with the Accept-Language header. n8n doesn't support regional identifiers, such as de-AT. When running in a locale other than the default, n8n displays UI strings in the selected locale, and falls back to en for any untranslated strings.

Default
en
N8N_PORTVariable

The HTTP port n8n runs on.

Default
5678
Value
5678
WebUIPorttcp

The port for n8n web interface.

Target
5678
Default
5678
Value
5678
EXECUTIONS_DATA_MAX_AGEVariable

The execution age (in hours) before it's deleted.

Default
168
N8N_EDITOR_BASE_URLVariable

Public URL where users can access the editor. Also used for emails sent from n8n and the redirect URL for SAML based authentication.

N8N_HIRING_BANNER_ENABLEDVariable

Whether to show the n8n hiring banner in the console (true) or not (false).

Default
false
Value
false
N8N_HOSTVariable

Host name n8n runs on.

N8N_LOG_FORMATVariable

The log format to use. text prints human readable messages. json prints one JSON object per line containing the message, level, timestamp, and all metadata. This is useful for production monitoring as well as debugging.

Default
text
N8N_LOG_LEVELVariable

Log output level.

Default
info
N8N_PROXY_HOPSVariable

Number of reverse-proxies n8n is running behind.

Default
0
Value
0
N8N_SECURE_COOKIEVariable

Ensures that cookies are only sent over HTTPS, enhancing security.

Default
true
PGIDVariable

Group ID for the process and file permissions.

Default
100
Value
100
PUIDVariable

User ID for the process and file permissions.

Default
99
Value
99