0xJacky/nginx-ui — an automation project — sits at 11.8k GitHub stars in the Automation space. Yet another WebUI for Nginx
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Yet another Nginx Web UI, developed by 0xJacky, Hintay and Akino.
Proudly hosted on AtomGit — a part of the G-Star program.
Documentation
To check out docs, visit nginxui.com.
Sponsor
If you find this project helpful, please consider sponsoring us to support ongoing development and maintenance.
Sponsors
Protect and accelerate websites and APIs with consistent access performance across mainland China and worldwide, and extend acceleration and security to native and mobile apps through client SDKs — Self-hosted private CDN|Subscription-based anti-DDoS CDN|A self-controlled, flexibly composable CDN network.
Official Community Group
Join the official Nginx UI WeChat community group to discuss usage, deployment ideas, and troubleshooting with other community members.
Scan the QR code below to add us on WeChat, and include Nginx UI Community Group in your request. The administrator will invite you to the official community group.
Your support helps us:
🚀 Accelerate the development of new features
🐛 Fix bugs and improve stability
📚 Enhance documentation and tutorials
🌐 Provide better community support
💻 Maintain infrastructure and demo servers
Tooling Support
Thanks to JetBrains for supporting us with free open source licenses.
Stargazers over time
English | Español | 简体中文 | 繁體中文 | Tiếng Việt | 日本語
Table of Contents
About The Project
Demo
Features
Internationalization
Getting Started
Before Use
Installation
Usage
From Executable
With Systemd
With Docker
Manual Build
Prerequisites
Build Frontend
Build Backend
Script for Linux
Basic Usage
More Usage
Example of Nginx Reverse Proxy Configuration
Contributing
License
About The Project
Demo
URL:https://demo.nginxui.com
Username:admin
Password:admin
Features
Online statistics for server indicators such as CPU usage, memory usage, load average, and disk usage.
Automatic configuration backup after changes, with version comparison and restore capabilities
Cluster management supporting mirroring operations to multiple nodes, making multi-server environments easy to manage
Export encrypted Nginx / Nginx UI configurations for quick deployment and recovery to new environments
Enhanced online ChatGPT assistant supporting multiple models, including Deepseek-R1's chain-of-thought display to help you better understand and optimize configurations
MCP (Model Context Protocol) provides special interfaces for AI agents to interact with Nginx UI, enabling automated configuration management and service control.
One-click deployment and automatic renewal Let's Encrypt certificates.
Online editing websites configurations with our self-designed NgxConfigEditor which is a user-friendly block editor for nginx configurations or Ace Code Editor which supports LLM Code Completion and highlighting nginx configuration syntax.
View Nginx logs online, with indexed search, a traffic dashboard and visitor maps
Plugin system: install signed plugins from the marketplace, an uploaded file or an offline directory, for example the official DNS-01 plugin with the DNS providers for certificates
Written in Go and Vue, distribution is a single executable binary.
Automatically test configuration file and reload nginx after saving configuration.
Web Terminal
Dark Mode
Responsive Web Design
Internationalization
We proudly offer official support for:
English
Simplified Chinese
Traditional Chinese
As non-native English speakers, we strive for accuracy, but we know there's always room for improvement. If you spot any issues, we'd love your feedback!
Thanks to our amazing community, additional languages are also available! Explore and contribute to translations on Weblate.
Getting Started
Before Use
The Nginx UI follows the Debian web server configuration file standard. Created site configuration files will be placed in the sites-available folder that under the Nginx configuration folder (auto-detected). The configuration files for an enabled site will create a soft link to the sites-enabled folder. You may need to adjust the way the configuration files are organised.
For non-Debian (and Ubuntu) systems, you may need to change the contents of the nginx.conf configuration file to the Debian style as shown below.
http {
# ...
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;
}
For more information: debian/conf/nginx.conf
Installation
Nginx UI is available on the following platforms:
macOS 11 Big Sur and later (amd64 / arm64)
Windows 10 and later (amd64 / arm64)
Linux 2.6.23 and later (x86 / amd64 / arm64 / armv5 / armv6 / armv7 / mips32 / mips64 / riscv64 / loongarch64)
Including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7, Arch Linux
FreeBSD
OpenBSD
Dragonfly BSD
Openwrt
You can visit latest release to download the latest distribution, or just use installation scripts for Linux.
Usage
In the first runtime of Nginx UI, please visit http://<your_server_ip>:<listen_port>
in your browser to complete the follow-up configurations.
Stop Nginx UI gracefully with the following command.
kill -TERM "$(cat nginx-ui.pid)"
With Systemd
If you are using the installation script for Linux, the Nginx UI will be installed as nginx-ui service in systemd. Please use the systemctl command to control it.
Start Nginx UI
systemctl start nginx-ui
Stop Nginx UI
systemctl stop nginx-ui
Restart Nginx UI
systemctl restart nginx-ui
With Docker
Our docker image uozi/nginx-ui:latest is based on the latest nginx image and
can be used to replace the Nginx on the host. By publishing the container's port 80 and 443 to the host,
you can easily make the switch.
Note
When using this container for the first time, ensure that the volume mapped to /etc/nginx is empty.
If you want to host static files, you can map directories to container.
If you are upgrading from an older image, see the Docker WebSocket fix guide for required conf.d/nginx-ui.conf updates.
The image bundles the official DNS-01 plugin and installs it on the first start. Installed plugins are kept in /etc/nginx-ui/plugins, so keep /etc/nginx-ui on a volume. When upgrading from v2, see Upgrading to v3.
When your docker container is running, Log in to nginx-ui panel with http://<your_server_ip>:8080/install.
If you change the port mapping, access Nginx UI through the host port mapped to container port 80 instead.
When your docker container is running, Log in to nginx-ui panel with http://<your_server_ip>:8080/install.
If you change the port mapping, access Nginx UI through the host port mapped to container port 80 instead.
Manual Build
On platforms that do not have an official build version, they can be built manually.
Prerequisites
Make
Golang 1.27.2+
Bun 1.4.3 (the version pinned by this repository's package manifest and CI)
node.js 21+
npx browserslist@latest --update-db
Build Frontend
Please execute the following command in app directory.
bun install
bun run build
Build Backend
Please build the app first, and then execute the following command in the project root directory.
go generate
go build -tags=jsoniter -ldflags "$LD_FLAGS -X 'github.com/0xJacky/Nginx-UI/settings.buildTime=$(date +%s)'" -o nginx-ui -v main.go
The default listening port is 9000, and the default HTTP Challenge port is 9180.
If there is a port conflict, please modify /usr/local/etc/nginx-ui/app.ini manually,
then use systemctl restart nginx-ui to reload the Nginx UI service.
Remove Nginx UI, except configuration and database files
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request
License
This project is provided under a GNU Affero General Public License v3.0 license that can be found in the LICENSE file. By using, distributing, or contributing to this project, you agree to the terms and conditions of this license.
The most recent commit recorded on 0xJacky/nginx-ui was 3 months ago, based on the GitHub push timestamp. The repository has 921 forks — one of the better signals of community interest.
How does 0xJacky/nginx-ui compare to other Automation projects?
0xJacky/nginx-ui is tracked by TopGit in the Automation category, with 11.8k GitHub stars and written in Go. Browse the Automation topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does 0xJacky/nginx-ui have?
0xJacky/nginx-ui has 11.8k GitHub stars — refresh the page for the live number, or check github.com/0xJacky/nginx-ui. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is 0xJacky/nginx-ui open source?
Yes — 0xJacky/nginx-ui ships under the AGPL-3.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/0xJacky/nginx-ui.
What is 0xJacky/nginx-ui?
0xJacky/nginx-ui (0xJacky/nginx-ui) is a Go project on GitHub. From the project's own README: Yet another WebUI for Nginx
Where do I read more about 0xJacky/nginx-ui?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/0xJacky/nginx-ui is the definitive source.
Read full README in the tab above.
Still deciding about nginx-ui?
One click hands the question to an AI along with this page — see what it says about nginx-ui.