Actions107
- Node Actions
- Network Actions
- Container Actions
- Container List
- Container Create
- Container Inspect
- Container Top
- Container Logs
- Container Changes
- Container Export
- Container Stats
- Container Resize
- Container Start
- Container Stop
- Container Restart
- Container Kill
- Container Update
- Container Rename
- Container Pause
- Container Unpause
- Container Attach
- Container Attach Websocket
- Container Wait
- Container Delete
- Container Archive Info
- Container Archive
- Put Container Archive
- Container Prune
- Image Actions
- Volume Actions
- Swarm Actions
- Secret Actions
- System Actions
- Exec Actions
- Service Actions
- Task Actions
- Config Actions
- Plugin Actions
- Distribution Actions
- Session Actions
Overview
This node enables interaction with Docker through the Portainer API. It is designed to facilitate management and automation of Docker environments by connecting to a specified Portainer endpoint. Common use cases include retrieving Docker system information, managing containers, images, networks, and volumes via Portainer's REST API.
Specifically, the "System Version" operation under the "System" resource fetches version details about the Docker engine running on the selected endpoint. This can be useful for monitoring Docker versions across multiple environments or validating compatibility before deploying containers.
Example scenarios:
- Automatically checking Docker version before running deployment workflows.
- Auditing Docker environments in an organization.
- Integrating Docker version info into dashboards or reports.
Properties
| Name | Meaning |
|---|---|
| EndpointID Name or ID | The identifier of the Portainer endpoint to connect to. Choose from a list of available endpoints or specify an ID using an expression. This determines which Docker environment the node will interact with. |
Output
The node outputs JSON data containing the Docker system version information retrieved from the Portainer API. This typically includes fields such as the Docker version number, API version, Go runtime version, Git commit hash, build time, and other relevant metadata describing the Docker engine.
No binary data output is involved in this operation.
Dependencies
- Requires access to a Portainer instance with its API enabled.
- Needs an API authentication token or key configured in n8n credentials to authenticate requests to the Portainer API.
- The node uses the Portainer API endpoint
/api/endpoints/{endpointId}/dockeras the base URL for Docker-related operations.
Troubleshooting
Common issues:
- Invalid or missing endpoint ID: Ensure the selected endpoint exists and is accessible.
- Authentication failures: Verify that the API key or token credential is correctly set up and has sufficient permissions.
- Network connectivity problems: Confirm that n8n can reach the Portainer server URL.
- API version mismatches: If the Portainer API changes, some operations might fail; check compatibility.
Error messages:
- Unauthorized or 401 errors indicate invalid credentials.
- 404 errors may mean the endpoint ID does not exist.
- Timeout or network errors suggest connectivity issues.
Resolving these usually involves verifying credentials, endpoint IDs, and network access.