A modern, intuitive user interface for the nginx web server.
Designed for developers and enthusiasts who want powerful control without the manual config headache.
- 🌐 Virtual hosts: Easily manage multiple hosts with custom domains, routes, and port bindings.
- 🔄 Streams: Proxy TCP, UDP, and Unix sockets with SNI-based routing, circuit breakers, and load balancing.
- ⚡ Versatile routing: Configure proxies, redirections, custom JS/Lua code, static responses, or file serving.
- ⚙️ Server configuration: Easy configuration of the nginx server (maximum body/upload size, server tokens, timeouts, log level, etc).
- 🔐 SSL certificates: Automated Let's Encrypt (ACME), self-signed, or bring your own certificates.
- 🐳 Native integrations: First-class support for Docker, Docker Swarm, Tailscale VPNs, and TrueNAS.
- 🛡️ Security: Secure access with attribute-based access control (ABAC) and per-host access lists using basic authentication and source IP checks.
- 📋 Logging: Detailed access and error logs for the server and each virtual host, with built-in automatic log rotation.
- 🚀 Performance: Built-in nginx caching configuration to speed up your content delivery.
- 🏗️ Flexible execution: nginx ignition can run nginx for you, or just generate the configuration files for you.
nginx ignition is built for developers and enthusiasts who want a balance between ease of use and the power of nginx. This project is not aimed at being enterprise-ready or feature-complete for highly complex environments. If your use-case is extremely advanced, you'll likely prefer managing configuration files manually.
Our goal is to provide a powerful, yet intuitive way to run nginx for the most common use-cases with some optional, nice-to-have features that can help you get your homelab up and running quickly.
Getting up and running to check out if nginx ignition is for you can be done using a single Docker command.
docker run -p 8090:8090 -p 80:80 dillmann/nginx-ignition- Wait a few seconds for the app to initialize.
- Open http://localhost:8090 in your browser.
- The setup wizard will guide you through creating your first user.
By default, an embedded SQLite database is used. For production environments we recommend using PostgreSQL. Check the database configuration documentation for more details on how to do it.
Choose the method that best fits your environment, be it Docker, Docker Compose, native packages for Linux, Windows, or macOS.
Use our docker-compose.yml for a production-ready setup with PostgreSQL and health checks.
Download the latest version for your architecture from the releases page:
| Platform | Package type | Arch |
|---|---|---|
| Debian, Ubuntu | .deb |
amd64, arm64 |
| RedHat, Fedora | .rpm |
amd64, arm64 |
| Alpine Linux | .apk |
amd64, arm64 |
| Arch Linux | .pkg.tar.zst |
amd64, arm64 |
| OpenWrt | .ipk |
amd64, arm64 |
| Windows | ZIP archive | amd64, arm64 |
| macOS | ZIP archive | arm64 |
Need to tune your setup? Explore our detailed guides:
- 📜 Configuration properties: Full list of available environment variables and configuration properties.
- 🏥 Health checks: Monitor your instance's status.
- 🔍 Troubleshooting: Common issues and recovery steps (like password resets).
- 🔁 Migrating from v1 to v2: Steps to upgrade from nginx ignition v1 to v2.
We love to hear and receive feedback from you. Whether it's a bug report, a feature request, or a pull request:
- 🛠️ Open an issue if you have a problem or bug to report
- 💬 Start a discussion if you have a question or feature request
- 👋 Say hello on LinkedIn if you want to share some feedback
Made with ❤️ from Brazil. We hope nginx ignition can solve some problems for you and make your homelab a bit simpler.