n8n-nodes-portainer

This Community Node is a 100% free solution, created to simplify and help the community integrate and fully leverage the main features offered by Portainer in n8n workflows.

Notice: This node was developed independently to make it easier to integrate with Portainer's public API in n8n.
It is not affiliated with, endorsed by, or maintained by Portainer.
All referenced trademarks belong to their respective owners.

⚙️ Requirements

To use this Community Node, you need:

• n8n version 1.54.4 or newer
• Node.js version 16.0.0 or newer
• An active Portainer account with an API token

📌 Available Resources

🐳 Containers

📝 Full Docker container management with advanced operations for creation, execution, monitoring, and lifecycle control.

Operations

✅ Create - Create new containers

✅ Delete - Delete containers

✅ Exec - Execute commands in containers

✅ Get - Get specific container information

✅ Get Logs - Get container logs

✅ Get Many - List all containers

✅ Get Stats - Get usage statistics

✅ Inspect - Inspect container details

✅ Pause - Pause running containers

✅ Restart - Restart containers

✅ Start - Start stopped containers

✅ Stop - Stop running containers

✅ Unpause - Unpause paused containers

🖼️ Images

📝 Full Docker image management including build, pull, push, tagging, and history inspection for lifecycle control.

Operations

✅ Build - Build images from a Dockerfile

✅ Delete - Delete images

✅ Get - Get specific image information

✅ Get History - Get image history

✅ Get Many - List all images

✅ Inspect - Inspect image details

✅ Pull - Pull images from a registry

✅ Push - Push images to a registry

✅ Tag - Create tags for images

⚙️ Services (Docker Swarm)

📝 Full Docker Swarm service management with creation, scaling, updates, and monitoring for distributed container orchestration.

Operations

✅ Create - Create new services

✅ Delete - Delete services

✅ Get - Get specific service information

✅ Get Logs - Get service logs

✅ Get Many - List all services

✅ Scale - Scale number of replicas

✅ Update - Update service configuration

🔐 Secrets (Docker Swarm)

📝 Secure Docker Swarm secret management for storing and safely distributing sensitive information to services.

Operations

✅ Create - Create new secrets

✅ Delete - Delete secrets

✅ Get - Get specific secret information

✅ Get Many - List all secrets

✅ Inspect - Inspect secret details

📋 Configs (Docker Swarm)

📝 Docker Swarm config management for distributing configuration files and non-sensitive data to cluster services.

Operations

✅ Create - Create new configs

✅ Delete - Delete configs

✅ Get - Get specific config information

✅ Get Many - List all configs

✅ Inspect - Inspect config details

🌐 Edge Groups

📝 Edge computing group management for organizing and centrally controlling geographically distributed endpoints.

Operations

✅ Create - Create new edge groups

✅ Delete - Delete edge groups

✅ Get - Get specific group information

✅ Get Many - List all edge groups

✅ Update - Update group settings

📦 Edge Stacks

📝 Edge stack management for distributed deployment of applications across multiple edge locations.

Operations

✅ Create - Create new edge stacks

✅ Delete - Delete edge stacks

✅ Get - Get specific stack information

✅ Get Many - List all edge stacks

✅ Get Status - Get deployment status

✅ Update - Update stack settings

🖥️ Nodes (Docker Swarm)

📝 Docker Swarm node management for monitoring and controlling cluster nodes, including status and settings.

Operations

✅ Get - Get specific node information

✅ Get Many - List all nodes

✅ Inspect - Inspect node details

✅ Update - Update node settings

📚 Stacks (Docker Compose)

📝 Docker Compose stack management for deploying and updating multi-container applications defined in YAML files.

Operations

✅ Delete - Delete stacks

✅ Get - Get specific stack information

✅ Get Many - List all stacks

✅ Update - Update stack settings

📋 Registries

📝 Docker image registry management with support for multiple types including DockerHub, ECR, Azure, GitLab, and custom registries.

Operations

✅ Create - Create new registries

✅ Delete - Delete registries

✅ Get - Get specific registry information

✅ Get Many - List all registries

✅ Update - Update registry settings

👥 Teams

📝 Portainer team management for group-based access control and collaborative permissions.

Operations

✅ Create - Create new teams

✅ Delete - Delete teams

✅ Get - Get specific team information

✅ Get Many - List all teams

✅ Update - Update team settings

📄 Templates

📝 Portainer application template management for fast deployment of pre-configured applications.

Operations

✅ Get - Get specific template information

✅ Get Many - List all templates

⚙️ Settings

📝 Portainer settings management including authentication, security policies, and global platform settings.

Operations

✅ Get - Get current settings

✅ Update - Update settings

🔗 Webhooks

📝 Webhook management for automation and integration with external systems via HTTP notifications.

Operations

✅ Create - Create new webhooks

✅ Delete - Delete webhooks

✅ Get Many - List all webhooks

💻 System

📝 Portainer system information including status, version, and node information for platform monitoring.

Operations

✅ Get Status - Get system status

✅ Get Version - Get Portainer version

✅ Get Nodes - Get node information

👤 Users

📝 Portainer user management for access control and account administration.

Operations

✅ Get - Get specific user information

✅ Get Many - List all users

💾 Volumes

📝 Docker volume management for data persistence and sharing between containers.

Operations

✅ Delete - Delete volumes

✅ Get Many - List all volumes

🌐 Networks

📝 Docker network management for connectivity and isolation between containers.

Operations

✅ Delete - Delete networks

✅ Get Many - List all networks

🏢 Environments

📝 Portainer environment/endpoint management for connecting to different Docker instances.

Operations

✅ Get - Get specific environment information

✅ Get Many - List all environments

🚀 Installation

Via n8n Community Nodes:

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Install the package: n8n-nodes-portainer
4. Restart n8n

Via NPM:

npm install n8n-nodes-portainer

🤝 Contributing

Help this project grow! You can contribute in several ways:

• Pull Requests: Send improvements, fixes, or new features.
• Issues: Report bugs or suggest ideas.
• Feedback: Share your thoughts and suggestions.
• Documentation: Help improve or expand the existing docs.

Built with ❤️ by Ramon Matias