diff --git a/website/integrations/services/outline/index.md b/website/integrations/services/outline/index.md new file mode 100644 index 000000000000..1092f75b5e3b --- /dev/null +++ b/website/integrations/services/outline/index.md @@ -0,0 +1,49 @@ +--- +title: Outline +--- + +Support level: Community + +## What is Outline + +> Your team's knowledge base. +> Lost in a mess of Docs? Never quite sure who has access? Colleagues requesting the same information repeatedly in chat? It’s time to get your team’s knowledge organized. +> +> -- https://www.getoutline.com + +## Preparation + +The following placeholders will be used: + +- `outline.company` is the FQDN of the Outline install. +- `authentik.company` is the FQDN of the authentik install. + + +## authentik configuration + +1. Create an OAuth2/OpenID provider with the following parameters: + +- Client Type: `Confidential` +- Scopes: OpenID, Email and Profile +- Signing Key: Select any available key +- Redirect URIs: `https://outline.company/auth/oidc.callback` + +2. Note the Client ID and Client Secret values. + +## Outline configuration + +You need to set the following `env` variables for Docker-based installations. + +1. Set the following values: + +```yaml +OIDC_CLIENT_ID= +OIDC_CLIENT_SECRET= +OIDC_AUTH_URI=https://authentik.company/application/o/authorize/ +OIDC_TOKEN_URI=https://authentik.company/application/o/token/ +OIDC_USERINFO_URI=https://authentik.company/application/o/userinfo/ +OIDC_LOGOUT_URI=https://authentik.company/application/o/wiki/end-session/ +OIDC_USERNAME_CLAIM=preferred_username +OIDC_DISPLAY_NAME=authentik +OIDC_SCOPES=openid profile email +``` diff --git a/website/sidebarsIntegrations.js b/website/sidebarsIntegrations.js index 8f836d31952f..03c54db40251 100644 --- a/website/sidebarsIntegrations.js +++ b/website/sidebarsIntegrations.js @@ -29,6 +29,7 @@ module.exports = { "services/mobilizon/index", "services/nextcloud/index", "services/onlyoffice/index", + "services/outline/index", "services/paperless-ng/index", "services/paperless-ngx/index", "services/rocketchat/index",