Portainer

Overview

This node integrates with the Portainer API to manage Docker registries. Specifically, the Delete operation for the Registry resource allows users to delete a Docker image registry from Portainer by specifying its ID. This is useful for cleaning up unused or obsolete registries in your Docker environment managed via Portainer.

Typical use cases include:

• Removing registries that are no longer needed.
• Automating cleanup of registries as part of CI/CD pipelines.
• Managing Docker registries programmatically within workflow automation.

Example: You have a registry with ID "1" that you want to remove from Portainer. Using this node's Delete Registry operation, you provide the registry ID and optionally force deletion if the registry is currently in use.

Properties

Output

The node outputs JSON data representing the response from the Portainer API after attempting to delete the specified registry. Typically, this will be an empty object or confirmation message indicating successful deletion.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to a Portainer instance with API access.
• Requires an API key credential configured in n8n to authenticate requests to the Portainer API.
• The base URL of the Portainer API must be set in the credentials.

Troubleshooting

• Error: Unauthorized or 401 — Check that the API key credential is valid and has sufficient permissions.
• Error: Registry not found or 404 — Verify the Registry ID is correct and exists in Portainer.
• Error: Conflict or 409 when not forcing deletion — If the registry is in use, enable the "Force Delete" option to override.
• Network errors — Ensure the Portainer API endpoint is reachable from the n8n instance.

Links and References

• Portainer API Documentation - Registries
• Docker Registry Concepts
• Portainer Official Website