logo
icon

Outline

The fastest knowledge base for growing teams. A self-hosted, open-source wiki and documentation tool with real-time collaboration and Markdown support.

template cover
Deployed0 times
PublisherzeaburZeabur
Created2026-07-21
Tags
WikiKnowledge BaseDocumentationOpen Source

Outline

Outline is a fast, collaborative, open-source knowledge base and wiki for growing teams. This template deploys Outline together with PostgreSQL and Redis, using local file storage (no S3/MinIO required).

⚠️ You must configure an authentication provider

Outline has no username/password login. Sign-in only works through an SSO provider (OIDC, Google, Slack, GitHub, etc.). The email magic-link only works for users who already exist, so the very first admin account must be created via SSO. After deploying, set one of the following on the outline service and restart it:

💡 The first person to sign in automatically becomes the administrator — there is no separate admin setup. Just make sure you are the first to log in.

Option A — Generic OIDC (Authentik / Logto / Keycloak / Zitadel …)

Set these env vars on the outline service:

  • OIDC_CLIENT_ID
  • OIDC_CLIENT_SECRET
  • OIDC_AUTH_URI
  • OIDC_TOKEN_URI
  • OIDC_USERINFO_URI

Redirect / callback URL to register with your provider: https://YOUR_DOMAIN/auth/oidc.callback

Option B — Google

Create an OAuth client in Google Cloud Console and set:

  • GOOGLE_CLIENT_ID
  • GOOGLE_CLIENT_SECRET

Redirect URL: https://YOUR_DOMAIN/auth/google.callback

Notes

  • SECRET_KEY and UTILS_SECRET are auto-generated on first boot and persisted to the data volume — don't change them or existing encrypted data becomes unreadable.
  • To enable email invites, configure the SMTP_* variables.
  • Uploads are stored on the persistent volume at /var/lib/outline/data.