Skip to content
v2.18.0GitHub

RomM

Sign in to the RomM game library with Pocket ID.

  1. In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
  2. Enter a name such as RomM and add the callback URL https://romm.example.com/api/oauth/openid.
  3. Click Create and copy the Client ID and the Client secret. The client secret is only shown once.
  4. On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.
  1. Set the following RomM environment variables:
    • OIDC_ENABLED: Set to true to enable OIDC authentication.
    • OIDC_PROVIDER: The lowercase name of the provider (pocketid).
    • OIDC_CLIENT_ID: The Client ID from Pocket ID.
    • OIDC_CLIENT_SECRET: The Client secret from Pocket ID.
    • OIDC_REDIRECT_URI: The callback URL configured in Pocket ID, in the format https://romm.example.com/api/oauth/openid.
    • OIDC_SERVER_APPLICATION_URL: The authorization URL for your Pocket ID instance, for example https://id.example.com.
  2. Set up your email address in RomM. This email has to match your user email in Pocket ID.