Description
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:
Built with ❤️ by Ramon Matias
