Introduction
A fast, scriptable command-line interface for Nginx Proxy Manager.
nginxpm CLI is a command-line interface for Nginx Proxy Manager. Manage proxy hosts, redirections, TCP/UDP streams, 404 dead hosts, SSL certificates, access lists, users, audit logs, and settings from your terminal.
It is designed for both human operators and coding agents. List and get commands
support -o json and -o yaml for machine-readable output.
The binary is nginxpm. It connects to an existing Nginx Proxy Manager
instance over its API; the CLI does not install or run the server itself.
Features
- Host management: list, get, create, update, delete, enable, and disable proxy, redirection, and 404 dead hosts.
- Network forwarding: manage TCP/UDP streams and their enabled state.
- Certificates and access: issue and renew certificates, discover DNS providers, test HTTP reachability, and manage access lists.
- Administration: users, permissions, passwords, audit logs, and server settings.
- Multiple instances: save named connection profiles and select one with
--profile. - Agent-friendly:
-o json|yaml,--read-only,--no-input, and environment-variable configuration. - Cross-platform: macOS, Linux, and Windows on amd64 and arm64.
Next steps
Installation
Install a prebuilt binary or build from source.
Authentication
Connect with a login profile, environment variables, or one-off flags.
Quick start
Connect to NPM and run your first commands.
Agents
Machine-readable output and automation safety flags.
Independent project. Not affiliated with, endorsed by, or sponsored by Nginx Proxy Manager or NGINX. All product names, logos, and trademarks are the property of their respective owners and are used for identification purposes only.