pomerium/docs/guide

title	lang	meta
Docker	en-US	name content keywords pomerium identity-access-proxy oidc docker reverse-proxy containers

Pomerium using Docker

Docker is a straightforward way to start using Pomerium. In the following quick-start, we'll create a minimal but complete environment for running Pomerium with containers.

Prerequisites

• A configured identity provider
• Docker and docker-compose
• A wild-card TLS certificate

Configure

Docker-compose

Download the following docker-compose.yml file and modify it to:

• generate new secrets
• mount your wild-card TLS certificate
• mount your config.yaml configuration file

<<< @/docs/docs/examples/docker/basic.docker-compose.yml

Configuration file

Create a configuration file (config.yaml) for defining Pomerium's configuration settings, routes, and access-policies. Consider the following example:

<<< @/docs/docs/examples/config/config.minimal.yaml

Ensure the docker-compose.yml contains the correct path to your config.yaml.

Run

Finally, simply run docker compose.

docker-compose up

Docker will automatically download the required container images for Pomerium and httpbin. Then, Pomerium will run with the configuration details set in the previous steps.

You should now be able access to the routes (e.g. https://httpbin.corp.yourdomain.example) as specified in your policy file.