# Nginx Auto SSL

Nginx Auto SSL is a Docker-based Nginx/OpenResty reverse proxy that automatically obtains and renews Let's Encrypt TLS certificates for self-hosted sites. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6638/nginx-auto-ssl

## Description

Nginx Auto SSL is a Docker-based Nginx/OpenResty reverse proxy that automatically obtains and renews Let's Encrypt TLS certificates for self-hosted sites. It provides reasonable TLS settings, HTTP/2, and WebSocket support, and lets you configure allowed domains and upstream applications through environment variables.

## Platform availability

Available on 0 of 10 platforms.

## Health score

32/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1115 days ago)
- Popular: 53 (430 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- GitHub: https://github.com/Valian/docker-nginx-auto-ssl
- Docker Hub: https://hub.docker.com/r/elestio/nginx-auto-ssl

## Common questions

### How do I map a domain to an upstream application in Nginx Auto SSL?

Set the SITES environment variable as domain=endpoint, for example yourdomain.com=myapp:80 or yourdomain.com=localhost:8080. You can define multiple mappings separated by semicolons, and use _ for the default server.

### Can I restrict certificate issuance to specific domains?

Yes, set ALLOWED_DOMAINS to a regex pattern of the domains you want to allow. If it is not set, all domains are accepted.

### Where are the Let's Encrypt certificates stored?

Mount a persistent volume to /etc/resty-auto-ssl, such as a Docker named volume called ssl-data. The README examples use this path to keep the auto-SSL data.

### What ports and DNS conditions are required for the proxy?

Expose ports 80 and 443, or run the container with host networking. The domain must have a correct DNS entry pointing to the server so requests reach the proxy.

## Alternatives

- Apache HTTP Server: Open-source HTTP server offering cross-platform support, modular architecture, secure configuration, robust content delivery, and extensive…
- BunkerWeb: BunkerWeb is a self-hosted, open-source web application firewall and NGINX-based web server that protects services with secure-by-default s…
- Caddy: Caddy is an extensible web server and reverse proxy that serves Transport Layer Security (TLS) by default, making it simple to secure and r…
- Corvus: Self-hosted reverse proxy and web application firewall with a web console; it provides domain forwarding, free SSL, live traffic monitoring…
- Haproxy: HAProxy is a TCP proxy and a HTTP reverse proxy.
- Microsoft IIS: Internet Information Services (IIS) for Windows® Server is a flexible, secure and easy-to-manage Web server for hosting anything on the Web.
- Træfik Proxy: The Cloud Native Application Proxy Simplify networking complexity while designing, deploying, and operating applications.
- Varnish: Varnish is an open-source HyperText Transfer Protocol (HTTP) accelerator for website operators that serves cached pages from memory in fron…
- lighttpd: Lighttpd is a secure, lightweight web server that uses memory and CPU more efficiently than comparable servers, with FastCGI, CGI, authenti…
- nginx: Nginx is an HTTP web server, reverse proxy, content cache, load balancer, TCP/UDP proxy, and mail proxy server.
- nginx-ui

---
Source: Our Local Host (https://ourlocalhost.com/app/6638/nginx-auto-ssl), the self-hosted and open-source app directory.
