### Docker Compose setup for Zettelrobbe Source: https://github.com/admonstrator/zettelrobbe/blob/main/README.md Recommended way to run Zettelrobbe with Docker Compose. Maps port 3000 and persists data in a named volume. For plain HTTP, set COOKIE_SECURE_MODE=never to avoid login issues. ```yaml services: zettelrobbe: image: admonstrator/zettelrobbe:latest container_name: zettelrobbe restart: unless-stopped ports: - '3000:3000' volumes: - data:/app/data volumes: data: ``` -------------------------------- ### Development, Test, Lint, and Production Commands Source: https://github.com/admonstrator/zettelrobbe/blob/main/CLAUDE.md Commands for running the dev server, tests, linting, formatting, production, and maintenance. Note that `npm test` starts the dev server via nodemon, not tests. Tests use a custom runner and some self-skip unless a server is reachable at BASE_URL. ```bash # Run the dev server (auto-reload) npm run test # = nodemon server.js node server.js # plain run # Tests (custom runner — plain node scripts, no jest/mocha) npm run test:all # all tests (node scripts/run-tests.js --all) npm run test:list # list areas + tests npm run test:area:security # an area (auth|ocr|observability|processing|prompts|quickstart|security) node scripts/run-tests.js --test ssrf-url-validation # single test by name # Lint / format npx eslint . # flat config: eslint.config.mjs npx prettier --check . # .prettierrc.json + .prettierignore npm run lint:css # stylelint over public/css/**/*.css # Production (what Docker runs) pm2-runtime ecosystem.config.js # via start-services.sh # Maintenance npm run mfa:reset # reset MFA for a user node scripts/regen-openapi.js # regenerate OPENAPI/openapi.json from @swagger JSDoc ``` -------------------------------- ### OIDC button customization variables Source: https://github.com/admonstrator/zettelrobbe/blob/main/docs/sso-oidc.md Configure the SSO login button text, icon, and colors via environment variables. Icon accepts an http(s) URL or server path; 'none' removes it. Colors accept various formats; quote hex values in YAML because '#' starts a comment. ```yaml OIDC_BUTTON_TEXT: Sign in with Authentik OIDC_BUTTON_ICON: https://auth.example.com/media/zettelrobbe-icon.svg OIDC_BUTTON_COLOR: '#fd4b2d' OIDC_BUTTON_TEXT_COLOR: white ``` -------------------------------- ### OIDC environment configuration for Zettelrobbe Source: https://github.com/admonstrator/zettelrobbe/blob/main/README.md Enables Single Sign-On with any OpenID Connect provider. Requires OIDC_ADMIN_EMAIL to map an identity to the admin account. Password login remains available. ```yaml environment: OIDC_ENABLED: 'yes' OIDC_ISSUER_URL: https://auth.example.com/application/o/zettelrobbe/ OIDC_CLIENT_ID: zettelrobbe OIDC_CLIENT_SECRET: ${ZETTELROBBE_OIDC_CLIENT_SECRET} OIDC_REDIRECT_URI: https://zettelrobbe.example.com/auth/oidc/callback OIDC_ADMIN_EMAIL: you@example.com # required OIDC_BUTTON_TEXT: Sign in with Authentik # optional, also OIDC_BUTTON_ICON / _COLOR / _TEXT_COLOR ``` -------------------------------- ### Authelia OIDC client configuration (YAML) Source: https://github.com/admonstrator/zettelrobbe/blob/main/docs/sso-oidc.md Add this client block to the Authelia configuration (Authelia 4.38 or later syntax). The client secret is hashed; set require_pkce to true and use S256 challenge method. The issuer URL is https://. ```yaml identity_providers: oidc: clients: - client_id: 'zettelrobbe' client_name: 'Zettelrobbe' client_secret: '$pbkdf2-sha512$310000$...' # hashed secret public: false authorization_policy: 'two_factor' redirect_uris: - 'https://zettelrobbe.example.com/auth/oidc/callback' scopes: ['openid', 'profile', 'email'] require_pkce: true pkce_challenge_method: 'S256' token_endpoint_auth_method: 'client_secret_basic' ``` -------------------------------- ### OIDC environment variables in compose file Source: https://github.com/admonstrator/zettelrobbe/blob/main/docs/sso-oidc.md Add these environment variables to your docker-compose service to enable OIDC SSO. Keep the client secret in a .env file using ${ZETTELROBBE_OIDC_CLIENT_SECRET}. Optional button styling and TRUST_PROXY for reverse proxy are included. ```yaml services: zettelrobbe: environment: OIDC_ENABLED: 'yes' OIDC_ISSUER_URL: https://auth.example.com/application/o/zettelrobbe/ OIDC_CLIENT_ID: zettelrobbe OIDC_CLIENT_SECRET: ${ZETTELROBBE_OIDC_CLIENT_SECRET} OIDC_REDIRECT_URI: https://zettelrobbe.example.com/auth/oidc/callback OIDC_ADMIN_EMAIL: you@example.com # Optional: make the button look like your provider OIDC_BUTTON_TEXT: Sign in with Authentik OIDC_BUTTON_COLOR: '#fd4b2d' OIDC_BUTTON_TEXT_COLOR: white # Behind a reverse proxy TRUST_PROXY: '1' ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.