# Nginx UI — Self-Hosted Nginx Management Dashboard

> A web-based interface for managing Nginx servers with real-time config editing, SSL certificate handling, and performance monitoring.

## Install

Save as a script file and run:

# Nginx UI — Self-Hosted Nginx Management Dashboard

## Quick Use
```bash
docker run -d --name nginx-ui 
  -p 8080:80 -p 8443:443 
  -v /etc/nginx:/etc/nginx 
  -v /etc/nginx-ui:/etc/nginx-ui 
  uozi/nginx-ui
```

## Introduction
Nginx UI provides a graphical web interface for managing Nginx server configurations without manually editing config files. It simplifies tasks like virtual host creation, SSL certificate management via Let's Encrypt, and real-time log monitoring for teams that run Nginx in production or homelab environments.

## What Nginx UI Does
- Provides a visual editor for Nginx configuration files with syntax highlighting
- Manages SSL certificates automatically through ACME / Let's Encrypt integration
- Monitors Nginx performance with CPU, memory, and traffic dashboards
- Supports dark mode and multi-language localization
- Offers a built-in terminal for direct server access from the browser

## Architecture Overview
Nginx UI is a single Go binary that serves a Vue.js frontend. It reads and writes Nginx configuration files on disk, validates them with `nginx -t`, and reloads Nginx via systemd or direct signals. An embedded SQLite database stores user accounts and certificate metadata. The application runs alongside your existing Nginx installation rather than replacing it.

## Self-Hosting & Configuration
- Deploy via Docker or install the Go binary on any Linux server
- Mount your existing `/etc/nginx` directory into the container
- Set the admin username and password on first launch via the web UI
- Configure ACME email for automatic SSL certificate provisioning
- Reverse-proxy Nginx UI itself behind Nginx for HTTPS access on a subdomain

## Key Features
- Real-time Nginx configuration editing with validation before reload
- Automatic Let's Encrypt certificate issuance and renewal
- Built-in system resource monitoring (CPU, memory, disk, network)
- Multi-user support with role-based access control
- One-click Nginx reload and service management from the dashboard

## Comparison with Similar Tools
- **Nginx Proxy Manager** — focused on reverse proxy and SSL; Nginx UI offers full config editing and server monitoring
- **Webmin** — general-purpose server admin panel; Nginx UI is purpose-built for Nginx
- **Portainer** — container management; Nginx UI manages Nginx directly on the host
- **Caddy** — has built-in HTTPS but uses its own config format; Nginx UI wraps standard Nginx

## FAQ
**Q: Does Nginx UI replace Nginx?**
A: No. Nginx UI runs alongside your existing Nginx installation and provides a web interface to manage its configuration files.

**Q: Can I manage multiple Nginx servers?**
A: The current architecture manages the Nginx instance on the same host. For multi-server setups, deploy one Nginx UI per server.

**Q: Is Nginx UI production-safe?**
A: It validates configurations before reloading. However, always test changes in staging first for critical infrastructure.

**Q: What databases does it support?**
A: Nginx UI uses an embedded SQLite database by default. No external database setup is required.

## Sources
- https://github.com/0xJacky/nginx-ui
- https://nginxui.com

---
Source: https://tokrepo.com/en/workflows/asset-16c2b3be
Author: Script Depot