nginx-proxy/README.md

nginx-proxy sets up a container running nginx and [docker-gen][1].  docker-gen generate reverse proxy configs for nginx and reloads nginx when containers they are started and stopped.

See [Automated Nginx Reverse Proxy for Docker][2] for why you might want to use this.

### Usage

To run it:

    $ docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock -t jwilder/nginx-proxy

Then start any containers you want proxied with an env var VIRTUAL_HOST=subdomain.youdomain.com

    $ docker run -e VIRTUAL_HOST=foo.bar.com -t ...

Provided your DNS is setup to forward foo.bar.com to the a host running nginx-proxy, the request will be routed to a container with the VIRTUAL_HOST env var set.

### Multiple Ports

If your container exposes multiple ports, nginx-proxy will default to the service running on port 80.  If you need to specify a different port, you can set a VIRTUAL_PORT env var to select a different one.  If your container only exposes one port and it has a VIRTUAL_HOST env var set, that port will be selected.

  [1]: https://github.com/jwilder/docker-gen
  [2]: http://jasonwilder.com/blog/2014/03/25/automated-nginx-reverse-proxy-for-docker/

### Multiple Hosts

If you need to support multipe virtual hosts for a container, you can separate each enty with commas.  For example, `foo.bar.com,baz.bar.com,bar.com` and each host will be setup the same.
Fix typo 2014-05-05 22:15:18 +02:00			`nginx-proxy sets up a container running nginx and [docker-gen][1]. docker-gen generate reverse proxy configs for nginx and reloads nginx when containers they are started and stopped.`
Initial commit 2014-05-05 19:01:40 +02:00
Updated instructions 2014-05-05 22:13:51 +02:00			`See [Automated Nginx Reverse Proxy for Docker][2] for why you might want to use this.`

Update docs for VIRTUAL_PORT 2014-05-20 17:39:08 +02:00			`### Usage`

Updated instructions 2014-05-05 22:13:51 +02:00			`To run it:`

			`$ docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock -t jwilder/nginx-proxy`

			`Then start any containers you want proxied with an env var VIRTUAL_HOST=subdomain.youdomain.com`

			`$ docker run -e VIRTUAL_HOST=foo.bar.com -t ...`

			`Provided your DNS is setup to forward foo.bar.com to the a host running nginx-proxy, the request will be routed to a container with the VIRTUAL_HOST env var set.`

Update docs for VIRTUAL_PORT 2014-05-20 17:39:08 +02:00			`### Multiple Ports`

			`If your container exposes multiple ports, nginx-proxy will default to the service running on port 80. If you need to specify a different port, you can set a VIRTUAL_PORT env var to select a different one. If your container only exposes one port and it has a VIRTUAL_HOST env var set, that port will be selected.`
Updated instructions 2014-05-05 22:13:51 +02:00
			`[1]: https://github.com/jwilder/docker-gen`
			`[2]: http://jasonwilder.com/blog/2014/03/25/automated-nginx-reverse-proxy-for-docker/`
Document multiple host support 2014-08-19 17:42:43 +02:00
			`### Multiple Hosts`

			If you need to support multipe virtual hosts for a container, you can separate each enty with commas. For example, `foo.bar.com,baz.bar.com,bar.com` and each host will be setup the same.