pomerium/docs/guide/docker.md
Bobby DeSimone bcecee5ee3
docs: add kubernetes (#33)
- Update PR template to use Go language conventions.
- Moved healthcheck middleware to hijack a request before logging.
- Rewrote the quickstart guides to follow a similar pattern.
- Added an overview blurb on pomerium and its goals.
- Add an "example config" section to docs.
2019-01-27 22:22:14 -08:00

1.7 KiB

Docker

Prerequisites

Install

Install docker and docker-compose. Docker-compose is a tool for defining and running multi-container Docker applications. We've created an example docker-compose file that creates a minimal, but complete test environnement for pomerium.

Download

Copy and paste the contents of the provided example basic.docker-compose.yml and save it locally as docker-compose.yml.

Configure

Edit the [docker-compose.yml] to match your identity provider settings.

Place your domain's wild-card TLS certificate next to the compose file. If you don't have one handy, the included script generates one from LetsEncrypt.

Run

You can then download the latest pomerium release of pomerium in docker form along some example containers and an nginx load balancer all in one step.

docker-compose up

Pomerium is configured to delegate access to two test apps helloworld and httpbin.

Navigate

Open a browser and navigate to hello.your.domain.com or httpbin.your.domain.com. You should see something like the following in your browser.

Getting started

And in your terminal.

asciicast