Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rockstorm101/nginx-autoreload-docker

Nginx image which autoreloads on configuration changes
https://github.com/rockstorm101/nginx-autoreload-docker

docker nginx

Last synced: about 1 month ago
JSON representation

Nginx image which autoreloads on configuration changes

Awesome Lists containing this project

README

        

# Nginx + autoreload
[![GitHub Workflow Status][1]][2]

Docker image of [Nginx][3] which automatically reloads on
configuration changes.

Image source at: https://github.com/rockstorm101/nginx-autoreload-docker.

[1]: https://img.shields.io/github/actions/workflow/status/rockstorm101/nginx-autoreload-docker/test-build.yml?branch=master
[2]: https://hub.docker.com/r/rockstorm/nginx-autoreload
[3]: https://en.wikipedia.org/wiki/Nginx

## Usage

Use as a normal Nginx image. Add environment variable
`AUTORELOAD_FILES` to track these files and auto-reload Nginx when any
of these files gets modified. Example docker-compose.yml:

```yaml
services:
nginx:
image: rockstorm/nginx-autoreload

environment:
AUTORELOAD_FILES: "/etc/nginx/nginx.conf /etc/nginx/conf.d"
```

Note that `AUTORELOAD_FILES` can contain multiple files and folders
separated by a space. However, no spaces are allowed on the
file/folder names.

## Build Arguments

By default, this image uses the stable and [Alpine-based][4] Nginx image as
a base. Use build argument `NGINX_VERSION` to change the base Nginx
Docker image being built upon.

[4]: https://hub.docker.com/_/nginx

## License

View [license information][5] for the software contained in this
image.

As with all Docker images, these likely also contain other software
which may be under other licenses (such as Nginx, etc from the base
image, along with any direct or indirect dependencies of the primary
software being contained).

As for any pre-built image usage, it is the image user's
responsibility to ensure that any use of this image complies with any
relevant licenses for all software contained within.

[5]: https://github.com/rockstorm101/nginx-autoreload-docker/blob/master/LICENSE