Skip to content
v2.19.3GitHub

Qui

Sign in to the qui web interface with Pocket ID.

  1. In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
  2. Enter a name such as Qui and add the callback URL https://qui.example.com/api/auth/oidc/callback.
  3. Click Create and copy the Client ID and the Client secret. The client secret is only shown once.
  4. On the client’s General tab, turn on PKCE, then click Save.
  5. On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.
  1. Fill in the required fields in the config.toml file:
config.toml
oidcEnabled = true
oidcIssuer = "https://id.example.com"
oidcClientId = "client-id"
oidcClientSecret = "client-secret"
oidcRedirectUrl = "https://qui.example.com/api/auth/oidc/callback"
oidcDisableBuiltInLogin = true # Optional, hides the username/password form
  1. Restart qui.
  2. Click on OpenID Connect and you will be redirected to Pocket ID for authentication.

Environment variables can be used to override the values in the config.toml file.

  1. Set the following environment variables:
Variable Value
QUI__OIDC_ENABLED true
QUI__OIDC_ISSUER https://id.example.com
QUI__OIDC_CLIENT_ID The Client ID from Pocket ID
QUI__OIDC_CLIENT_SECRET The Client secret from Pocket ID
QUI__OIDC_REDIRECT_URL https://qui.example.com/api/auth/oidc/callback
QUI__OIDC_DISABLE_BUILT_IN_LOGIN true Optional, hides the local username/password form
  1. Restart qui.
  2. Click on OpenID Connect and you will be redirected to Pocket ID for authentication.

For more information, check the qui OIDC Reference

  • Check that Allowed Hosts is set correctly