Skip to main content

Run Pomerium Enterprise With Docker

Run Pomerium Enterprise with Docker containers and connect to the Console.

This guide uses our Hosted Authenticate Service. If you use our hosted service and have a license key, you can complete this guide in under 5 minutes.

See the Self-Hosted Authenticate Service page if you want to self-host Pomerium.

Prerequisites​

To complete this guide, you need:

Configure Pomerium Core​

If you haven't, create a file called config.yaml and add the following code:

config.yaml
routes:
  - from: https://verify.localhost.pomerium.io
    to: http://verify:8000
    policy:
      - allow:
          or:
            - email:
                is: user@example.com

Replace user@example.com with your email address.

Configure Pomerium Enterprise Console​

Add to your config.yaml:

config.yaml
enterprise:
  administrators:
    - user@example.com
  url: 'https://console.localhost.pomerium.io'

You must configure at least one administrator for console access. This user (or users) can then configure additional administrators in the console UI.

Configure Docker Compose services​

Create a file called docker-compose.yaml in your project's root folder and add the configuration below:

docker-compose.yaml
services:
  pomerium:
    image: pomerium/pomerium:latest
    volumes:
      - ./config.yaml:/pomerium/config.yaml:ro
    ports:
      - 443:443
  verify:
    image: pomerium/verify:latest
    expose:
      - 8000

Connect to Pomerium Enterprise Console​

Run docker compose up.

Go to https://console.localhost.pomerium.io to access your Console.

Next Steps​

If you want to try connecting Pomerium with other services, see some of our Guides.

Did you finish this quickstart guide? We'd love to hear what you think. Get in touch with us on our Discuss forum, message us on Twitter, LinkedIn, or check out our Community page.