Choose Your Guide

1. Install Docker and Run n8n

Install Docker on your system and run the official n8n image.

version: '3.7'

services:
  n8n:
    image: n8nio/n8n:latest # Or your custom image
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      # Variables
      # ... add more env
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

2. Access the Container

To modify the license certificate, you need root access inside the container:

3. Download the Patcher Script

Download patcher.sh inside the container.

Download command:

Make executable:

4. Using the Patcher

The patcher.sh script has two commands:

• Patch – creates a backup of the original license certificate and replaces it with a custom one.
• Restore – restores the original certificate from the backup.

Patch command:

Expected output for patch command:

/home/node # sh ./patcher.sh patch
✅ Detected: Running main logic INSIDE the container.
...
✅ Patch applied! Restart n8n for the changes to take effect.
✅ Patch License URL applied! https://patcher.n8selfhosted.com
/home/node #

Restore command:

Expected output for restore command:

/home/node # sh ./patcher.sh restore
✅ Detected: Running main logic INSIDE the container.
...
Starting operation: RESTORE
Restoring the original file from backup...
✅ Original file restored! Restart n8n for the changes to take effect.
/home/node #

Use "exit" to exit the container shell.

5. Restart the Container

After applying the patch, restart your container to apply the changes:

6. Activate the License

Access your application's web interface.

Go to Settings.

Enter your N8SH-Entomai license. (If you don't have one, check the "Get Free License" tab).

1. Install Docker

Install Docker on your system following the official instructions.

2. Run the Pre-patched Container

Use the pre-patched Docker image that comes with the license already configured. No additional patching required.

version: '3.7'

services:
  n8n:
    image: ghcr.io/n8nsh/n8n:latest # Pre-patched image
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      # Variables
      # ... add more env
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

3. Activate the License

No restart needed! The container is already patched. Simply access the web interface.

Go to Settings.

Enter your N8SH-Entomai license. (If you don't have one, check the "Get Free License" tab).

Video Tutorial (Both Methods)

1. Go to the Order Portal

Open your browser and go to control.entomai.com/Order.

You'll see a list of products. Locate and select the "Starter - Free" option. You can also select Pro, Business, or Enterprise if you prefer.

2. Register and Complete the Order

You'll be prompted to log in or register for a new account. Complete the registration process.

Follow the steps to complete the order. Since the Starter plan is free, you won't need to enter any payment method.

3. Get the License

Upon completing the order, you'll see an order summary and your license key. This is the "N8easy" license you'll use in your n8n.

Copy this license key.

4. Activate in n8n

Open the web interface of your n8n instance (which should already be running with the n8nsh/n8n image or manually patched).

Go to Settings > License.

Paste the license key you copied in the previous step and click "Activate".

All done! Your n8n instance is now activated.

1. Log In and Go to Orders

Go to control.entomai.com and log in.

Navigate to the "Orders" or "My Services" section.

2. Find and Reset the License

Find the license you want to reset and click on it to see the details.

You'll see a button that says "Reset". Click on it.

This generates a new license sequence and the previous license becomes invalid.

You can now use this same license key in your new n8n instance (repeating step 4 for activation).