Nginx Proxy Manager (NPM) icon

Nginx Proxy Manager (NPM)

Interact with your NPM instance

Overview

This node integrates with an Nginx Proxy Manager (NPM) instance, allowing users to manage various resources such as access lists, proxy hosts, certificates, and more. Specifically, for the Certificate - Delete operation, it enables users to delete a certificate from their NPM setup by specifying its unique ID. This is useful for cleaning up unused or expired SSL/TLS certificates to maintain security and organization.

Practical examples include:

  • Removing outdated SSL certificates after renewal.
  • Deleting certificates that are no longer associated with any proxy host.
  • Automating certificate lifecycle management in CI/CD pipelines.

Properties

Name Meaning
ID The unique numeric identifier of the certificate to be deleted. This is required to specify which certificate should be removed.

Output

The node outputs a JSON array containing the result of the delete operation. Typically, this will include a success indicator and possibly a message confirming the deletion. The exact structure depends on the response from the NPM API but generally confirms whether the certificate was successfully deleted.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to an Nginx Proxy Manager instance.
  • Needs credentials including the URL, email, and password for authentication.
  • The node authenticates by requesting a token from the NPM API before performing operations.
  • Proper API permissions are necessary to delete certificates.

Troubleshooting

  • Login failed: No token received: This error indicates authentication failure. Verify that the provided credentials (email, password, and URL) are correct and that the NPM instance is reachable.
  • Invalid or missing certificate ID: Ensure the ID property is set and corresponds to an existing certificate in NPM.
  • API connectivity issues: Network problems or incorrect base URL can prevent communication with the NPM API.
  • Permission denied errors: The authenticated user must have sufficient rights to delete certificates.

To resolve these issues:

  • Double-check credentials and network connectivity.
  • Confirm the certificate ID exists via the NPM UI or API.
  • Ensure the user account has appropriate permissions.

Links and References

Discussion