Tinyauth and Pocket ID
Tinyauth is a lightweight sign-in page for Traefik and Caddy: a service behind it can only be opened after signing in. Pocket ID is an OIDC provider that signs users in with passkeys. Together they are a lighter alternative to Authentik.
Both are optional and can be used on their own. The settings below are in inventory/group_vars/all/sso.yml, next to the Authentik settings.
Requirements
Section titled “Requirements”tinyauth(andpocketid, to sign in with this project’s Pocket ID) enabled in the Container Map withproxy: true. To use a Pocket ID you already run, see below- Traefik or Caddy with SSL (
hmsdocker_ssl_enabled) to sign in with Pocket ID, since passkeys only work over HTTPS (the playbook checks this). Tinyauth with only local users also runs without SSL, but its session cookie is then sent unencrypted, so use SSL whenever you can
Signing in with Pocket ID
Section titled “Signing in with Pocket ID”hmsdocker_tinyauth_pocketid_enabled: trueThe playbook then:
- Generates a static API key for Pocket ID and a client secret for Tinyauth (stored in their config folders)
- Creates a
tinyauthOIDC client in Pocket ID with Tinyauth’s callback URL and that secret - Configures Tinyauth to use it, with a Pocket ID button on its login page
After the run, open https://pocketid.<your domain>/setup to create the first Pocket ID admin and their passkey (Pocket ID’s own one-time setup). Then add the users who should be able to sign in.
Optional settings:
# Skip the Tinyauth login page and go straight to Pocket IDhmsdocker_tinyauth_pocketid_auto_redirect: true
# Only these Pocket ID users may sign in (empty allows all of them). A value wrapped in slashes is a regexhmsdocker_tinyauth_oauth_whitelist: - you@example.com - '/@example\.com$/'
# Use your own client ID or secret (the secret must be at least 16 characters)hmsdocker_tinyauth_pocketid_client_id: tinyauthhmsdocker_tinyauth_pocketid_client_secret: ""If the OIDC client already exists in Pocket ID (for example, you created it by hand), the playbook keeps it, adds Tinyauth’s callback URL if it is missing, and adds the playbook’s client secret alongside any existing ones.
Using a Pocket ID you already run
Section titled “Using a Pocket ID you already run”To use a Pocket ID that runs somewhere else instead of the pocketid container, set its URL. The pocketid container does not need to be enabled.
hmsdocker_tinyauth_pocketid_enabled: truehmsdocker_tinyauth_pocketid_url: https://id.example.comTinyauth must be able to reach that URL, and your browser must too.
The OIDC client can then be set up in one of two ways:
-
Let the playbook create it: in Pocket ID, go to Settings > Admin > API Keys and create a key with the
oidc-clients:readandoidc-clients:writepermissions, then set it here. The playbook creates or updates the client like it does for thepocketidcontainer. Renew the key in Pocket ID before it expires.hmsdocker_tinyauth_pocketid_api_key: <API key> -
Create it yourself: in Pocket ID, add an OIDC client with the callback URL
https://tinyauth.<your domain>/api/oauth/callback/pocketid(use your Tinyauthproxy_host_ruleif you changed it), then set its ID and secret here. The playbook only configures Tinyauth.hmsdocker_tinyauth_pocketid_client_id: <client ID>hmsdocker_tinyauth_pocketid_client_secret: <client secret>
Local users
Section titled “Local users”Tinyauth can also have its own username/password users, with or without Pocket ID:
hmsdocker_tinyauth_users: - 'user:$2a$10$UdLYoJ5lgPsC0RKqYH/jMua7zIn0g9kPqWmhYayJYLaZQ/FTmH2/u'Generate an entry with:
docker run -i -t --rm ghcr.io/tinyauthapp/tinyauth:v5 user create --interactiveProtecting services
Section titled “Protecting services”List the container map keys of the services that require a sign-in:
hmsdocker_tinyauth_protected_containers: - sonarr - radarr - prowlarrEach listed service must be enabled with proxy: true. Its Traefik router (or Caddy route) gets the Tinyauth middleware after the usual IP allowlist, so opening it redirects to Tinyauth until you sign in. Protecting sonarr or radarr also protects their 4K instances.
tinyauth and pocketid (which serve the sign-in), and authentik and n8n (which set their own Traefik middlewares) cannot be protected. A service that also has authentik: true would ask for both sign-ins, and the playbook warns about it.
Anything that reaches a protected service through its Traefik URL without a browser sign-in is blocked too, for example mobile apps or scripts that call the *Arr APIs. Homepage widgets and the apps in this stack talk to each other over the Docker network, not through Traefik, so they are not affected. Protect only the services you open in a browser, or use Tinyauth’s access controls (Tinyauth docs) to let specific paths through.
Services outside this project
Section titled “Services outside this project”Routes to external services in hmsdocker_proxy_ext_hosts_list (in inventory/group_vars/all/reverse_proxy.yml, or traefik.yml until you run make update) can require a Tinyauth sign-in too:
hmsdocker_proxy_ext_hosts_list: [ { friendly_name: grafana, subdomain_name: grafana, backend_url: "http://192.168.1.50:3000", enabled: yes, expose_publicly: no, authentik: no, authentik_provider_type: proxy, tinyauth: yes },]For a container in another Compose project on the same host, add the Tinyauth middleware to its router yourself, after the IP allowlist. Replace hms-docker with your hmsdocker_project_name if you changed it:
- traefik.http.routers.<container name>.middlewares=internal-ipallowlist@file,tinyauth-hms-docker@dockerSocket proxy
Section titled “Socket proxy”Tinyauth reads access-control labels from other containers through the Docker socket. With the Docker Socket Proxy enabled, it only gets read access to container details and events.