Public | Automated Build

Last pushed: a year ago
Short Description
Short description is empty for this repo.
Full Description

Nginx SSL Terminator

Simple container for terminating SSL infront of an application.

Getting Started

I'll leave production deployment up to you, but this is how to get this running locally.

Prerequisities

You'll need to install boot2docker if you're using OS X or Windows, or
docker if you're using Linux.

Running it

This container has 3 environment variables

  • SSL_KEY_PATH - A path to an SSL key
  • SSL_CRT_PATH - A path to an SSL Certificate (can be a pem of your certificate and intermediaries).
  • UPSTREAM - A host and port without protocol (for example 192.0.2.64:3000)

If SSL_KEY_PATH or SSL_CRT_PATH are missing it will generate a self signed SSL certificate.

You might run it something like this

docker run \
      --name ssl-term \
      -v /my/secrets:/certs \
      -e  SSL_KEY_PATH=/certs/example.key \
      -e  SSL_CRT_PATH=/certs/example.crt \
      -e  UPSTREAM=www.google.com \
      purplebooth/nginx-ssl-terminator

Or like this to generate a self signed certificate

docker run \
      --name ssl-term \
      -e  UPSTREAM=www.google.com \
      purplebooth/nginx-ssl-terminator

Built With

Contributing

Feel free to submit pull requests and issues. If it's a particualy large PR, you may wish to discuss
it in an issue first.

Please note that this project is released with a Contributor Code of Conduct. By participating in
this project you agree to abide by its terms.

Versioning

We use SemVer for the version tags available See the tags on this repository.

Authors

Billie Thompson - Developer - PurpleBooth

See also the list of
contributors who participated in
this project.

License

This project is licensed under the MIT License - see the
LICENSE file for
details.

Docker Pull Command
Owner
purplebooth

Comments (0)