Installation¶

This guide covers installing the DeepTagger node for both self-hosted n8n instances and n8n Cloud.

For Self-Hosted n8n¶

Method 1: npm Install (Recommended)¶

Install the package

npm install n8n-nodes-deeptagger

Restart n8n

# If running directly
n8n start

# If running with PM2
pm2 restart n8n

# If running with Docker
docker restart n8n-container

# If running with Docker Compose
docker-compose restart n8n

Verify installation
Open your n8n interface
Click the + button to add a node
Search for "DeepTagger"
The node should appear in the search results

Method 2: n8n UI Installation¶

Open your n8n instance
Go to Settings (gear icon in left sidebar)
Click Community Nodes
Click Install button
Enter package name: n8n-nodes-deeptagger
Click Install
Wait for installation to complete (n8n will restart automatically)

Installation Complete

The DeepTagger node should now be available in your node list!

Verification¶

To verify the node is installed correctly:

Create a new workflow
Click + to add a node
Search for "DeepTagger"
You should see the DeepTagger node with its icon

For n8n Cloud¶

Current Status¶

The DeepTagger node is pending verification by the n8n team.

n8n Cloud Availability

Once verified, the node will be available directly from the n8n Cloud interface. Check back soon or contact support@deeptagger.com for status updates.

When Verified (Coming Soon)¶

Once verification is complete:

Open your n8n Cloud workspace
Click + to add a node
Search for "DeepTagger"
Click to add the node to your workflow
No installation required!

Docker Installation¶

If you're running n8n in Docker, you have two options:

Option 1: Install at Runtime¶

Mount a volume and install the package:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -v $(pwd)/custom-nodes:/home/node/.n8n/custom \
  n8nio/n8n \
  /bin/bash -c "npm install -g n8n-nodes-deeptagger && n8n start"

Option 2: Custom Dockerfile¶

Create a custom Docker image with the node pre-installed:

FROM n8nio/n8n:latest

USER root

# Install DeepTagger node
RUN cd /usr/local/lib/node_modules/n8n && \
    npm install n8n-nodes-deeptagger

USER node

Build and run:

docker build -t n8n-with-deeptagger .
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8n-with-deeptagger

Docker Compose Installation¶

Add the package installation to your docker-compose.yml:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=password
    volumes:
      - ~/.n8n:/home/node/.n8n
    command: >
      /bin/bash -c "
        npm install -g n8n-nodes-deeptagger &&
        n8n start
      "

Persistent Installation

Once installed, the node persists in the /home/node/.n8n volume, so you won't need to reinstall after container restarts.

Kubernetes/Helm Installation¶

If deploying n8n with Kubernetes:

Option 1: Init Container¶

apiVersion: apps/v1
kind: Deployment
metadata:
  name: n8n
spec:
  template:
    spec:
      initContainers:
      - name: install-deeptagger
        image: n8nio/n8n:latest
        command:
        - /bin/sh
        - -c
        - npm install -g n8n-nodes-deeptagger
        volumeMounts:
        - name: n8n-data
          mountPath: /home/node/.n8n

      containers:
      - name: n8n
        image: n8nio/n8n:latest
        ports:
        - containerPort: 5678
        volumeMounts:
        - name: n8n-data
          mountPath: /home/node/.n8n

      volumes:
      - name: n8n-data
        persistentVolumeClaim:
          claimName: n8n-pvc

Option 2: Custom Image¶

Build a custom n8n image (see Docker section) and reference it in your deployment.

Troubleshooting Installation¶

Node not appearing after installation¶

Solution:

Restart n8n completely
Check that the package is installed:
```
npm list -g n8n-nodes-deeptagger
```

Check n8n logs for errors:

# Standard installation
~/.n8n/n8n.log

# Docker
docker logs n8n-container

Permission errors during npm install¶

Solution:

# Use sudo (not recommended)
sudo npm install n8n-nodes-deeptagger

# Or fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install n8n-nodes-deeptagger

Package installation fails¶

Solution:

Update npm:
```
npm install -g npm@latest
```
Clear npm cache:
```
npm cache clean --force
```
Try installing again:
```
npm install n8n-nodes-deeptagger
```

Docker: npm command not found¶

Solution:

The n8n Docker image has npm pre-installed. If you get this error, ensure you're running commands inside the container:

docker exec -it n8n-container /bin/bash
npm install n8n-nodes-deeptagger

Updating the Node¶

To update to the latest version:

# Self-hosted
npm update n8n-nodes-deeptagger

# Restart n8n
n8n start

# Docker
docker exec -it n8n-container npm update n8n-nodes-deeptagger
docker restart n8n-container

Uninstalling¶

To remove the DeepTagger node:

# Self-hosted
npm uninstall n8n-nodes-deeptagger

# Docker
docker exec -it n8n-container npm uninstall n8n-nodes-deeptagger

Restart n8n after uninstalling.

Next Steps¶

Authentication Setup - Configure DeepTagger API credentials
Operations Reference - Learn what the node can do
Example Workflows - See it in action

Get Help¶

If you encounter installation issues:

Check the Troubleshooting guide
Search existing GitHub Issues
Open a new issue with:
n8n version (n8n --version)
Node version (node --version)
Installation method (npm/Docker/Kubernetes)
Full error message