Skip to content

mjwhitta/nap

Repository files navigation

Nginx App Proxy (NAP)

Yum

GitHub Workflow Status License

Tired of dealing with bloated and/or complicated reverse proxy solutions? Sounds like you could use a NAP!

Why?

I loved SWAG but eventually decided I didn't need Let's Encrypt for my home lab, so I switched to NPM. For a while things were fine. Unfortunately I looked at the size of those containers and realized that I didn't need ~500MB or ~950MB to simply redirect to my other self-hosted services.

Thus, Nginx App Proxy (NAP) was born! This container is ~20MB and has support for you bringing your own certs (BYOC), whether that be self-signed, Let's Encrypt, or even Let's Encrypt wildcard certs. How you refresh your certs is up to you. This container just provides Nginx reverse proxy capabilities. Nothing fancy, unless you count the navigation dashboard (navdash).

Usage

The default config is fairly well documented. You should also look at compose.yaml for an example Docker compose file. Finally, examples has some config examples for specific use cases.

You can pull the container with docker pull ghcr.io/mjwhitta/nap:latest or build it locally with ./build.