Excaliself
Sign in to the Excaliself whiteboard with Pocket ID.
Requirements
Section titled “Requirements”- Self-hosted Excaliself with
BASE_URLset to the address you open it at, such ashttps://excaliself.example.com. The callback URL is<BASE_URL>/api/auth/callback/oidc.
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
Excaliselfand add the callback URLhttps://excaliself.example.com/api/auth/callback/oidc. - Click Create and copy the Client ID and the Client secret. Under Show more details, also copy the Issuer URL. 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.
Verify emails in Pocket ID
Section titled “Verify emails in Pocket ID”Open Administration → Users and select each user that should have access. If the icon next to the email isn’t green, click it to mark the email as verified, then save.
Configure Excaliself
Section titled “Configure Excaliself”- Add the OIDC variables to the
.envfile next to Excaliself’sdocker-compose.yaml, with the values from Pocket ID:OIDC_ISSUER=https://id.example.comOIDC_CLIENT_ID=<client-id>OIDC_CLIENT_SECRET=<client-secret>OIDC_NAME=Pocket IDOIDC_ISSUERis the Issuer URL, the address of Pocket ID. - Optional: To let new users get an account on their first sign-in, add their email domains, separated by commas:
Without it, new users need an invite link from an Excaliself admin.SSO_ALLOWED_DOMAINS=example.com
- Restart Excaliself with
docker compose up -d.
The sign-in page now shows a Continue with Pocket ID button.