Guide: n8n how to install community nodes?

This guide explains n8n how to install community nodes for beginners. You can install community nodes in n8n by adding the n8n-nodes-community package to a custom Docker image or by installing the package in your Node.js environment. The example commands below work on common Linux, macOS, and Windows WSL setups.

What You Need

• Docker and Docker Compose installed locally.
• Node.js (v16 or newer) and npm for local installs.
• Basic terminal knowledge and a code editor.

How to install n8n how to install community nodes with Docker

This section shows a simple Docker approach. You will build a custom image that includes the community nodes package. The direct method installs the npm package into the image so n8n loads the extra nodes on start.

Step 1: Create a folder and Dockerfile

Create a new folder and add a Dockerfile that installs the community package.

mkdir n8n-community && cd n8n-community
cat > Dockerfile <<'DOCKER'
FROM n8nio/n8n:latest
USER root
# Install community nodes into the image
RUN npm install --production n8n-nodes-community
USER node
DOCKER

Step 2: Build the image

Build the Docker image locally. This puts the community nodes into the runtime image.

docker build -t n8n-custom:latest .

Step 3: Run the custom image

Run n8n using the new image. Map port 5678 and mount a volume for persistence if needed.

docker run -it --rm \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8n-custom:latest

How to install n8n how to install community nodes with Node.js

For local development or single-user setups, install n8n and community nodes with npm. This is quick for testing and debugging custom nodes.

Step 1: Install n8n and the community package

npm install -g n8n
mkdir n8n-local && cd n8n-local
npm init -y
npm install --save n8n-nodes-community
# Or install globally for quick tests
# npm install -g n8n-nodes-community

Step 2: Start n8n

Run n8n from the same environment. It will load the installed community nodes.

n8n

Step-by-step logic

• 1. Decide where n8n will run: Docker for servers, Node.js for local testing.
• 2. Add the n8n-nodes-community package to the runtime (image or project).
• 3. Build or restart n8n so it loads the new node modules.
• 4. Verify new nodes appear in the node panel inside the editor.

Update

To update community nodes, rebuild your Docker image or run npm update locally. Rebuild ensures all containers use the new code.

# Docker rebuild
docker build -t n8n-custom:latest .
# Local update inside project
npm update n8n-nodes-community

Security

Only install community nodes from trusted sources. Review the package repository and recent commits. Run containers with least privilege. Keep n8n and dependencies updated.

Scan node_modules for known vulnerabilities. Limit network access for automation servers and use secrets management for credentials.

Done

You now have clear Docker and Node.js methods to install community nodes in n8n. Test the nodes in the editor and rebuild when you update packages. Keep security steps in place for production use.