Copy the example file and set the required variables:
cp .env.example .env
Generate a secure 32+ character secret for BETTER_AUTH_SECRET:
openssl rand -base64 32
Edit the .env file and paste the generated value:
BETTER_AUTH_SECRET=<your_generated_secret>
docker compose up -d
By default, the application will be available at: http://localhost:8000
By default, the application does not require authentication. Anyone with access to the URL can use it.
If you want to add authentication, you can configure an OpenID Connect provider (such as Keycloak, Authentik, Pocket ID, etc.) by adding the following variables to your .env:
OIDC_PROVIDER_NAME=My Provider
OIDC_PROVIDER_ID=my-provider
OIDC_CLIENT_ID=your_client_id
OIDC_CLIENT_SECRET=your_client_secret
OIDC_DISCOVERY_URL=https://your-provider/.well-known/openid-configuration
[!NOTE] If you don't configure an OIDC provider, the application will work without authentication.