Manual installation

You can manually install community nodes from the npm registry on self-hosted n8n.

You need to manually install community nodes in the following circumstances:

• Your n8n instance runs in queue mode.

• You want to install private packages.

Install a community node

Access your Docker shell:

docker exec -it n8n sh

Create ~/.n8n/nodes if it doesn't already exist, and navigate into it:

mkdir ~/.n8n/nodes
cd ~/.n8n/nodes

Install the node:

npm i n8n-nodes-nodeName

Then restart n8n.

Uninstall a community node

Access your Docker shell:

docker exec -it n8n sh

Run npm uninstall:

npm uninstall n8n-nodes-nodeName

Upgrade a community node

Breaking changes in versions

Node developers may introduce breaking changes in new versions of their nodes. A breaking change is an update that breaks previous functionality. Depending on the node versioning approach that a node developer chooses, upgrading to a version with a breaking change could cause all workflows using the node to break. Be careful when upgrading your nodes. If you find that an upgrade causes issues, you can downgrade.

Upgrade to the latest version

Access your Docker shell:

docker exec -it n8n sh

Run npm update:

npm update n8n-nodes-nodeName

Upgrade or downgrade to a specific version

Access your Docker shell:

docker exec -it n8n sh

Run npm uninstall to remove the current version:

npm uninstall n8n-nodes-nodeName

Run npm install with the version specified:

# Replace 2.1.0 with your version number <a href="#replace-210-with-your-version-number" id="replace-210-with-your-version-number"></a>
npm install n8n-nodes-nodeName@2.1.0