English
Get started
← All templates

Deploy Authorizer on Pethost in one click

Sign-in for your own apps, with OAuth 2 and OpenID Connect

What happens

  1. You sign in to Pethost or make an account, with a passkey, GitHub or Google.
  2. No machine yet? You pick a plan, and we prepare one for you. The link waits in your browser until it is ready.
  3. New project opens at the app. You fill in what it asks for and click Create project: Admin password.
  4. In a minute or two the app is live at its own address with HTTPS. Its secrets are made for it at random, and its data is in the nightly backup.
  5. It is a project like any other: its compose.yaml, its .env, its logs and a terminal are in the panel, and your agent can change it, roll it back or restore it.

First steps

Open https://authorizer.sam.pethost.app/dashboard and sign in with the password you gave. Your apps use https://authorizer.sam.pethost.app as the issuer, and CLIENT_ID from the project’s .env as their client ID.

What it runs

The template is this compose.yaml and the variables it writes into the project’s .env. Pethost runs the file as it is written.

services:
  authorizer:
    image: quay.io/authorizer/authorizer:2.4.2
    restart: unless-stopped
    # A volume comes up owned by root, and the image's own user could not write to it
    # (Authorizer's README, "Docker").
    user: root
    # Authorizer reads its settings from its arguments alone.
    command:
      - --database-type=sqlite
      - --database-url=/authorizer/data/data.db
      - --url=${URL}
      - --client-id=${CLIENT_ID}
      - --client-secret=${CLIENT_SECRET}
      - --admin-secret=${ADMIN_PASSWORD}
      - --jwt-type=HS256
      - --jwt-secret=${JWT_SECRET}
      - --encryption-key=${ENCRYPTION_KEY}
    volumes:
      - data:/authorizer/data

volumes:
  data: