Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host Nginx UI
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A web interface for managing Nginx: edit site configurations in a block editor or a code editor, test and reload after saving, view logs with indexed search, issue and renew Let's Encrypt certificates, and mirror changes to other nodes in a cluster. It also lists automatic configuration backups with version comparison, a web terminal, an optional ChatGPT assistant and, since v3, a plugin system. The Docker image bundles Nginx and is meant to replace the Nginx on the host. A single Go binary with a Vue frontend.
Pick Nginx UI when you want to manage Nginx configuration from a browser instead of editing files over SSH, and you are happy to run Nginx inside its container. It edits site configurations in a block editor or a code editor, tests and reloads Nginx after saving, keeps automatic configuration backups with version comparison, shows logs with indexed search, deploys and renews Let's Encrypt certificates, and can mirror changes to other nodes in a cluster. The README also lists a web terminal, an optional ChatGPT assistant and MCP interfaces. It is AGPL-3.0 Go with a Vue frontend. The Docker image is based on the Nginx image and is meant to replace the Nginx on the host. Our snippet follows the README's Compose example with the image pinned to uozi/nginx-ui:v3.0.1 (released 2026-11-07), the same host ports 8080 and 8443 as that example, an empty bind mount for `/etc/nginx`, as the README requires, and another for `/etc/nginx-ui`, and the Docker socket and `/var/www` mounts left out. We did not find an upstream RAM minimum, so our 256 MB floor is an estimate. In the catalog, Nginx Proxy Manager is a point-and-click proxy with Let's Encrypt, Caddy is configured from a short Caddyfile, and Zoraxy is a Go reverse proxy managed from a web UI; Nginx UI is the one that edits Nginx's own configuration files and runs Nginx itself inside the container.
What you need
Any VPS with at least 256 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# Nginx UI: web UI that manages the Nginx inside its own image. Adapted from the README Docker Compose example, image pinned to v3.0.1, Docker socket and /var/www mounts left out, config bind mounts created empty (the README requires this for /etc/nginx)mkdir nginxui && cd nginxuimkdir etc-nginx etc-nginx-uicat > docker-compose.yml <<'EOF'services: nginx-ui: image: uozi/nginx-ui:v3.0.1 stdin_open: true tty: true restart: always environment: - TZ=UTC volumes: - ./etc-nginx:/etc/nginx - ./etc-nginx-ui:/etc/nginx-ui ports: - 8080:80 - 8443:443EOFdocker compose up -dtimeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:8080/; do sleep 3; done'# → http://SERVER_IP:8080/#/install (within 10 minutes of first start; paste the one-time secret from: sudo cat etc-nginx-ui/.install_secret, then create the admin account)
Nginx UI's README, docs, release notes and security advisories flag these before you rely on it:
non-negotiableFirst-run setup is guarded by a one-time secret: the docs say Nginx UI requires an install secret before the web setup can continue, and with Docker it is the .install_secret file in the directory mounted to /etc/nginx-ui, here etc-nginx-ui/.install_secret inside the nginxui folder (root-owned, so use sudo cat). The setup window lasts 10 minutes from startup; restart the container if it expires. The panel can edit Nginx configuration and the README lists a web terminal, so treat the admin credentials as highly privileged.
non-negotiablev3.0.1 is very new: the release notes call it a fix for two problems found right after v3.0.0, which was released only a day earlier, and v3 introduces a plugin system. The notes say to read the v3.0.0 notes if you are upgrading from v2.
non-negotiableThe /etc/nginx bind mount must be empty the first time, per the README, because the image fills it with a default configuration. Keep /etc/nginx-ui on a volume too: the README says installed plugins live in /etc/nginx-ui/plugins.
non-negotiableUpstream's example also mounts /var/run/docker.sock. Our snippet omits it because the install does not need it; mounting it gives the container control over the host's Docker, so add it only if you use a feature that needs it.
non-negotiableOur snippet serves plain http on port 8080 and ships no TLS for the panel itself. The image replaces the host Nginx, so if you map the default ports 80 and 443 it will conflict with any Nginx already on the host.
non-negotiableNginx UI has a long published security record: the project's GitHub advisories list 69 issues, 61 of them published in 2026 and 7 rated critical, including an unauthenticated MCP endpoint that allowed control of Nginx (CVE-2026-33032), unauthenticated backup download with key disclosure (CVE-2026-27944), unauthenticated code execution through backup restore (CVE-2026-42238) and remote claim of the first-run admin account (CVE-2026-42221). Further MCP, service-token and backup-restore issues were fixed as late as v2.9.0. Keep the panel off the public internet, behind a VPN or its IP allowlist, and upgrade promptly.
Nginx UI used 57 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 256 MB.
Is the Nginx UI install snippet verified?
The Nginx UI install snippet is marked verified on Ubuntu 26.04 (Nov 2026).