Actions72
- Image Actions
- Config Actions
- Container Actions
- Edge Group Actions
- Edge Stack Actions
- Network Actions
- Node Actions
- Registry Actions
- Secret Actions
- Service Actions
- Stack Actions
- Team Actions
- Template Actions
- User Actions
- Volume Actions
- Webhook Actions
Overview
This node integrates with the Portainer API to manage Docker registries among other Docker-related resources. Specifically, for the Registry - Delete operation, it allows users to delete a Docker image registry from Portainer by specifying its unique Registry ID. This is useful for cleaning up unused or obsolete registries in your Docker environment managed via Portainer.
Practical scenarios include:
- Removing a registry that is no longer used or has been deprecated.
- Automating cleanup of registries as part of CI/CD pipelines.
- Managing multiple Docker registries centrally through Portainer and n8n workflows.
Properties
| Name | Meaning |
|---|---|
| Registry ID | The unique identifier of the registry to be deleted. Required to specify which registry. |
| Force Delete | Boolean flag indicating whether to force deletion even if the registry is currently in use. |
Output
The node outputs the JSON response returned by the Portainer API after attempting to delete the specified registry. Typically, this will be an empty object or confirmation message indicating successful deletion. If the deletion fails, the output will contain error details from the API.
No binary data is involved in this operation.
Dependencies
- Requires a valid connection to a Portainer instance with API access.
- An API key credential for authenticating requests to the Portainer API must be configured in n8n.
- The base URL of the Portainer API must be set in the credentials.
Troubleshooting
Common issues:
- Invalid or missing Registry ID: Ensure the Registry ID provided exists and is correct.
- Insufficient permissions: The API key used must have rights to delete registries.
- Registry in use: If the registry is actively used by containers or services, deletion may fail unless "Force Delete" is enabled.
- Network connectivity issues to the Portainer API endpoint.
Error messages:
- 404 Not Found: The specified Registry ID does not exist.
- 403 Forbidden: The API key lacks permission to delete registries.
- 409 Conflict: Registry is in use; try enabling "Force Delete".
- 401 Unauthorized: Authentication failed; verify API key and credentials.
Resolving these typically involves verifying input parameters, checking API credentials, and ensuring the registry is not locked by active usage unless forced deletion is intended.