Nginx UI

v1.0.0Cloud Servicesstable

Yet another WebUI for Nginx

chatgpt-appcode-completioncopilotcrondeepseek-r1
Share:
11,165
Stars
0
Downloads
0
Weekly
0/5

What is Nginx UI?

Nginx UI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to yet another webui for nginx

Yet another WebUI for Nginx

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Yet another WebUI for Nginx

Use Cases

Web server management
SSL certificate handling
Configuration interface
0xJacky

Maintainer

LicenseAGPL-3.0
Languagego
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx nginx-ui

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Nginx UI

Nginx UI is a feature-rich web management interface for the Nginx web server that lets you edit configurations, manage SSL certificates via Let's Encrypt, monitor server performance, and access a web terminal — all from a browser. Written in Go with a Vue frontend, it ships as a single binary and also supports Docker deployment. It integrates an AI assistant (ChatGPT/Claude) for configuration help and includes a built-in MCP server so AI coding agents can manage Nginx directly through natural-language instructions.

Prerequisites

  • Nginx installed and running on the target server
  • Go 1.19+ (only for building from source)
  • Node.js 18+ and Yarn (only for building the frontend from source)
  • Docker (for the containerized deployment path)
  • An MCP-compatible AI client (Claude Desktop, Cursor, etc.)
1

Install Nginx UI via the official script

Run the one-line installation script on your Linux server. It downloads the correct binary for your architecture and sets up a systemd service automatically.

bash <(curl -L -s https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh) install
2

Deploy with Docker (alternative)

Use Docker to run Nginx UI in a container, mapping your host Nginx config directories into the container so changes persist.

docker run -dit --name=nginx-ui --restart=always \
  -e TZ=Asia/Shanghai \
  -v /etc/nginx:/etc/nginx \
  -v /etc/nginx-ui:/etc/nginx-ui \
  -p 8080:80 -p 8443:443 uozi/nginx-ui:latest
3

Complete the initial setup wizard

Open your browser and navigate to the install URL. The setup wizard guides you through creating the admin account and configuring the Nginx path.

http://<your-server-ip>:9000/install
4

Configure the app.ini settings

The main configuration file is at /usr/local/etc/nginx-ui/app.ini. The defaults work for most setups — the server listens on port 9000 and the HTTP challenge port for Let's Encrypt is 9180.

5

Manage the service with systemd

After script installation, Nginx UI is registered as a systemd service. Use standard systemctl commands to start, stop, or restart it.

systemctl start nginx-ui
systemctl enable nginx-ui
systemctl status nginx-ui
6

Connect your MCP client

Nginx UI exposes an MCP endpoint. Add the server block to your AI client's config to enable AI-assisted Nginx management. Replace the URL with your server's address.

{
  "mcpServers": {
    "nginx-ui": {
      "url": "http://your-server-ip:9000/mcp"
    }
  }
}

Nginx UI Examples

Client configuration

MCP client config for connecting to a locally running Nginx UI instance.

{
  "mcpServers": {
    "nginx-ui": {
      "url": "http://localhost:9000/mcp"
    }
  }
}

Prompts to try

Use these prompts in your AI assistant after connecting to the Nginx UI MCP server.

- "Show the current Nginx configuration for the default site"
- "Create a new server block for api.example.com that proxies to localhost:3000"
- "Enable HTTPS for example.com using Let's Encrypt"
- "Show current CPU and memory usage on the server"
- "Reload Nginx after applying the configuration changes"

Troubleshooting Nginx UI

Cannot access the web interface after installation

Check that port 9000 is open in your firewall (ufw allow 9000 or equivalent). Verify the service is running with 'systemctl status nginx-ui' and check logs with 'journalctl -u nginx-ui'.

Let's Encrypt certificate issuance fails

Ensure port 9180 is open for the HTTP-01 challenge and that the domain's DNS A record points to the server's public IP. Also confirm Nginx is not already using port 80 for another service.

Configuration changes don't take effect

Nginx UI automatically tests and reloads Nginx after saving. If reload fails, check the Nginx error log at /var/log/nginx/error.log for syntax errors in the configuration.

Frequently Asked Questions about Nginx UI

What is Nginx UI?

Nginx UI is a Model Context Protocol (MCP) server that yet another webui for nginx It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Nginx UI?

Follow the installation instructions on the Nginx UI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Nginx UI?

Nginx UI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Nginx UI free to use?

Yes, Nginx UI is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "nginx-ui": { "command": "npx", "args": ["-y", "nginx-ui"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Nginx UI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides