Installation

Install the Mailpulse community node in your n8n instance.

Community Node (Recommended)

The easiest way to install is through n8n’s Community Nodes feature:

Go to Settings in your n8n instance
Click on Community Nodes
Click Install
Enter n8n-nodes-mailpulse
Click Install

The node will be available immediately after installation.

Manual Installation

For self-hosted n8n instances, you can install manually:


cd ~/.n8n/nodes
npm install n8n-nodes-mailpulse

Then restart your n8n instance:


# If using Docker
docker restart n8n
 
# If using PM2
pm2 restart n8n
 
# If running directly
# Stop and start n8n again

Docker Installation

If you’re running n8n in Docker, add the package to your Docker setup:

Using Docker Compose


version: '3'
services:
  n8n:
    image: n8nio/n8n
    environment:
      - N8N_COMMUNITY_PACKAGES=n8n-nodes-mailpulse
    volumes:
      - ~/.n8n:/home/node/.n8n
    ports:
      - "5678:5678"

Using Dockerfile


FROM n8nio/n8n
 
USER root
RUN cd /usr/local/lib/node_modules/n8n && \
    npm install n8n-nodes-mailpulse
USER node

Verifying Installation

After installation, you should see the Mailpulse Email Tracker node when searching in the n8n editor:

Open any workflow
Click the + button to add a node
Search for “Mailpulse” or “Email Tracker”
The node should appear in the search results

Troubleshooting

Node Not Appearing

If the node doesn’t appear after installation:

Restart n8n - Make sure to fully restart your n8n instance
Check installation - Verify the package is installed:
```
npm list -g | grep mailpulse
```
Check logs - Look for any errors in n8n startup logs

Community Nodes Disabled

If you don’t see the Community Nodes option:

Make sure you’re using n8n v0.170.0 or later
Check if N8N_COMMUNITY_PACKAGES_ENABLED is set to true in your environment

Permission Errors

If you get permission errors during installation:


# Fix npm permissions
sudo chown -R $(whoami) ~/.n8n
 
# Then reinstall
npm install n8n-nodes-mailpulse

Next Steps

After installation, set up your credentials to connect to your Mailpulse account.