Qui
Sign in to the qui web interface with Pocket ID.
Create the client in Pocket ID
Section titled “Create the client in Pocket ID”- In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
- Enter a name such as
Quiand add the callback URLhttps://qui.example.com/api/auth/oidc/callback. - Click Create and copy the Client ID and the Client secret. The client secret is only shown once.
- On the client’s General tab, turn on PKCE, then click Save.
- On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.
Configure Qui
Section titled “Configure Qui”Via the config file
Section titled “Via the config file”- Fill in the required fields in the
config.tomlfile:
oidcEnabled = trueoidcIssuer = "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- Restart qui.
- Click on OpenID Connect and you will be redirected to Pocket ID for authentication.
Via environment variables
Section titled “Via environment variables”Environment variables can be used to override the values in the config.toml file.
- 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 |
- Restart qui.
- Click on OpenID Connect and you will be redirected to Pocket ID for authentication.
For more information, check the qui OIDC Reference
Troubleshooting
Section titled “Troubleshooting”- Check that Allowed Hosts is set correctly