pomerium/docs/guide

Quick start

Using Docker

1. Install docker.
2. Install docker-compose.
3. Save Pomerium's example docker-compose.yml.
4. Inspect the docker-compose.yml file. In addition to specifying Pomerium's configuration settings, and services, you'll see that there are other included services to give you a feel for how pomerium works.
5. Update the compose file with your identity provider settings.
6. Copy your subdomain's wild-card TLS certificate next to the compose file. See included script to generate one from LetsEncrypt.
7. Run docker compose by runnig the command $ docker-compose up.
8. You should see something like the following in your terminal and in your browser when you navigate to https://hello.corp.beyondperimeter.com or https://httpbin.corp.beyondperimeter.com where "corp.beyondperimeter.com" is your subdomain.