Actions15
Overview
This node allows interaction with Docker through three main operations: Get, List, and Run, applied to Docker resources such as Containers, Images, Volumes, and Networks. Specifically, the List operation retrieves a list of Docker resources based on provided options.
A common use case for the Container - List operation is to fetch all running or existing containers with optional filters or parameters, enabling automation workflows that monitor container states, inventory Docker environments, or trigger actions based on container presence.
For example, you might use this node to:
- Retrieve all containers currently running on a Docker host.
- List containers filtered by specific labels or status.
- Integrate container data into monitoring dashboards or alerting systems.
Properties
| Name | Meaning |
|---|---|
| Options | JSON object specifying parameters for listing containers. This can include filters or other Docker API list options. |
Output
The output is an array of JSON objects representing Docker containers matching the list criteria. Each object corresponds to a container's metadata as returned by the Docker API's container listing method.
The json output field contains detailed information about each container, such as container ID, image, state, status, names, and other Docker container attributes.
No binary data output is produced by this operation.
Dependencies
- Requires a valid Docker API authentication credential to connect to the Docker daemon.
- Depends on the Dockerode library for interacting with the Docker API.
- The node expects the Docker environment to be accessible from where n8n runs (e.g., local Docker socket or remote Docker API endpoint).
Troubleshooting
No credentials got returned!
This error indicates missing or misconfigured Docker API credentials. Ensure that the node has access to a valid Docker API authentication token or configuration.Invalid JSON in Options property
Since the Options property expects a JSON object, malformed JSON will cause errors. Validate the JSON syntax before execution.Docker connection issues
If the node cannot connect to the Docker daemon, verify network connectivity, Docker daemon status, and that the credentials provide sufficient permissions.