<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Outline – Serverküche</title><link>https://serverkueche.de/en/tags/outline/</link><description>Outline – Neueste Beiträge von Serverküche</description><generator>Hugo</generator><language>en-US</language><managingEditor>feedback@serverkueche.de (Serverküche)</managingEditor><webMaster>feedback@serverkueche.de (Serverküche)</webMaster><copyright>2026 Serverküche</copyright><lastBuildDate>Tue, 17 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://serverkueche.de/en/tags/outline/index.xml" rel="self" type="application/rss+xml"/><item><title>Outline: The Modern Team Wiki with an Authentik Login</title><link>https://serverkueche.de/en/tutorials/outline-wiki/</link><pubDate>Tue, 17 Nov 2026 00:00:00 +0000</pubDate><author>feedback@serverkueche.de (Serverküche)</author><guid>https://serverkueche.de/en/tutorials/outline-wiki/</guid><description>Outline 1.12 with Postgres 18 behind Traefik – sign-in exclusively through Authentik, local file storage instead of S3, and the OIDC trap that kills the login.</description><content:encoded><![CDATA[<p>Outline is the rare wiki that feels like Notion and still runs entirely on your own server. The
price for that shows up at the very first start: there is no sign-in with a username and password.
Without an identity provider you cannot get in, not even as the administrator.</p>
<h2 id="what-are-we-building">What are we building?</h2>
<p>We run Outline 1.12.0 with PostgreSQL 18.6 and Redis 8.10.3 behind Traefik. Sign-in goes
through Authentik 2026.8.5 over OpenID Connect, and uploaded files live in a Docker volume
instead of an S3 bucket.</p>
<p>At the end you have a wiki that only lets in people who have an account in Authentik. It
needs no cloud service at all.</p>
<div class="not-prose my-6 rounded-lg border-l-4 p-4 border-amber-400 bg-amber-50 dark:border-amber-700 dark:bg-amber-900/20">
  <p class="mb-1 flex items-center gap-2 font-semibold text-slate-900 dark:text-white">
    <span aria-hidden="true">⚠️</span>Outline has no passwords
  </p>
  <div class="prose-kitchen text-sm">Outline has no user management of its own with passwords. It can only authenticate against an
external identity provider (OIDC, Google, Slack, Azure, Discord). Set the wiki up without having one
of those first and you end up facing an application nobody can enter. That is why Authentik is a
requirement here, not an accessory.</div>
</div>
<h2 id="requirements">Requirements</h2>
<ul>
<li>A running <a href="/en/tutorials/authentik-single-sign-on/">Authentik as single sign-on</a>, where you
already have an administrator and access to the admin interface</li>
<li>A <a href="/en/tutorials/traefik-reverse-proxy/">reverse proxy with Traefik</a></li>
<li>Two names that both point at the server: <code>wiki.YOUR_DOMAIN</code> for Outline and
<code>auth.YOUR_DOMAIN</code> for Authentik</li>
<li>About 60 minutes, half of it inside the Authentik interface</li>
</ul>
<div class="not-prose my-6 overflow-hidden rounded-xl border border-paprika-200 bg-paprika-50 dark:border-paprika-800 dark:bg-paprika-900/20"
     data-track-content data-content-name="Affiliate-Box · /en/tutorials/outline-wiki/" data-content-piece="VPS 2000 G12.5">
  <div class="flex items-center justify-between border-b border-paprika-200 bg-paprika-100 px-4 py-1.5 text-xs font-semibold uppercase tracking-wide text-paprika-700 dark:border-paprika-800 dark:bg-paprika-900/40 dark:text-paprika-300">
    <span>🍳 Recommendation</span>
    <span title="Links marked with * are affiliate links.">Ad</span>
  </div>
  <div class="flex flex-col gap-4 p-4 sm:flex-row sm:items-center sm:justify-between">
    <div>
      <p class="text-lg font-bold text-slate-900 dark:text-white">VPS 2000 G12.5</p>
      <p class="mt-1 text-sm text-slate-600 dark:text-slate-300">8 vCores · 16 GB RAM · 256 GB SSD</p>
      <p class="mt-1 text-sm font-semibold text-paprika-700 dark:text-paprika-400">from €26.92/month</p>
      <p class="mt-2 text-sm text-slate-600 dark:text-slate-400">Outline uses around 340 MB, database and Redis together a good 100 MB – plus the Authentik next to it at a good gigabyte.</p>
    </div>
    <a href="https://www.netcup.com/en/server/vps/vps-2000-g12.5-iv-24m-eu?ref=44083#vps-2000-g12.5-iv-12m-eu" rel="sponsored noopener" target="_blank"
   data-track-event="Affiliate|netcup: Affiliate-Box|VPS 2000 G12.5 · {page}"
   class="inline-flex shrink-0 items-center justify-center rounded-lg bg-paprika-600 px-5 py-2.5 font-semibold text-white transition-colors hover:bg-paprika-700">
  Go to netcup →
</a>

  </div><div class="px-4 pb-4"><div class="not-prose my-3 rounded-lg border border-herb-500/40 bg-herb-50 px-3 py-2 text-sm text-slate-700 dark:bg-herb-900/20 dark:text-slate-200"
     data-voucher-api="vps-2000" data-voucher-msg-empty="No code is available for this plan right now – use the €5.95 code." data-voucher-msg-limit="No more codes today – use the €5.95 code or try again tomorrow." data-voucher-msg-error="The code couldn&#39;t be fetched right now – use the €5.95 code."
     data-voucher-hint="Empty the cart first – the code adds the server itself.">
  <p class="flex flex-wrap items-center gap-x-2 gap-y-1"><span>💶 <span class="font-semibold">1 month free</span>:</span>
    <button type="button" data-voucher-reveal data-copy-title="Click to copy"
            class="cursor-pointer rounded bg-white px-2 py-0.5 font-mono text-sm font-semibold text-herb-800 hover:ring-2 hover:ring-herb-500/40 dark:bg-slate-800 dark:text-herb-400">Show code</button>
    <button type="button" data-voucher-next hidden
            class="rounded border border-herb-500/40 px-2 py-0.5 text-xs text-herb-800 hover:bg-white dark:text-herb-400 dark:hover:bg-slate-800">another code</button>
  </p><p class="mt-1 text-xs text-slate-500 dark:text-slate-400" data-voucher-hint-target>
    Single use, valid for VPS 2000 G12.5.
    <a href="https://www.netcup.com/en/checkout/cart?ref=44083" rel="sponsored noopener" target="_blank"
       data-track-event="Affiliate|netcup: Gutschein einlösen|VPS 2000 G12.5 · {page}"
       class="font-medium text-herb-800 underline underline-offset-2 hover:text-herb-900 dark:text-herb-400">Redeem in the cart →</a>
  </p><p class="mt-2 flex flex-wrap items-center gap-x-2 gap-y-1 border-t border-herb-500/30 pt-2">
    <span>💶 <span class="font-semibold">€5.95 voucher</span> for new netcup customers:</span>
    <button type="button" data-voucher-code data-track-voucher="36nc17844976032"
            title="Click to copy" class="cursor-pointer rounded bg-white px-2 py-0.5 font-mono text-sm font-semibold text-herb-800 hover:ring-2 hover:ring-herb-500/40 dark:bg-slate-800 dark:text-herb-400">36nc17844976032</button>
    <span class="text-xs text-slate-500 dark:text-slate-400">always valid · not for domains or VPS Lite</span>
  </p><p class="mt-1 text-xs"><a href="/en/netcup-voucher/" class="font-medium text-herb-800 underline underline-offset-2 hover:text-herb-900 dark:text-herb-400">All netcup vouchers →</a></p>
</div></div>
</div>

<h2 id="step-by-step">Step by step</h2>
<h3 id="step-1-create-the-access-in-authentik">Step 1: Create the access in Authentik</h3>
<p>Sign in to Authentik and go to <em>Applications → Providers → Create</em> in the admin area. Pick
<em>OAuth2/OpenID Provider</em> and enter:</p>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">Name                  Outline
</span></span><span class="line"><span class="cl">Authorization flow    default-provider-authorization-implicit-consent
</span></span><span class="line"><span class="cl">Client type           Confidential
</span></span><span class="line"><span class="cl">Redirect URI          https://wiki.YOUR_DOMAIN/auth/oidc.callback   (Strict)
</span></span><span class="line"><span class="cl">Signing Key           authentik Self-signed Certificate
</span></span><span class="line"><span class="cl">Subject mode          Based on the User&#39;s Email
</span></span><span class="line"><span class="cl">Grant types           Authorization Code, Refresh Token</span></span></code></pre></div>
</div>
<p>Two fields decide whether the login will work later. The redirect URI has to match character for
character: Outline always calls <code>https://wiki.YOUR_DOMAIN/auth/oidc.callback</code>, with no trailing
slash and no other path. Anything else and Authentik aborts the sign-in with <code>invalid_request</code>.</p>
<p><em>Grant types</em> must also contain <strong>Authorization Code</strong>. In Authentik 2026.x that is a field of its
own; leave it empty and the configuration looks complete while the sign-in still fails
immediately. The log then says <code>Invalid grant_type for provider</code>.</p>
<p><em>Subject mode &ldquo;Based on the User&rsquo;s Email&rdquo;</em> makes Outline tie accounts to the mail address. That
matters if you ever switch identity providers: the address survives, an internal user ID does not.</p>
<p>Then create the application under <em>Applications → Applications → Create</em>: name <code>Outline</code>, slug
<code>outline</code>, and the provider you just made. The provider page now shows the <em>Client ID</em> and
<em>Client Secret</em>, which you need in a moment.</p>
<p>You can have Authentik confirm the finished configuration itself:</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">curl -s https://auth.YOUR_DOMAIN/application/o/outline/.well-known/openid-configuration <span class="se">\
</span></span></span><span class="line"><span class="cl">  <span class="p">|</span> python3 -m json.tool <span class="p">|</span> head -6</span></span></code></pre></div>
</div>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">{
</span></span><span class="line"><span class="cl">    &#34;issuer&#34;: &#34;https://auth.YOUR_DOMAIN/application/o/outline/&#34;,
</span></span><span class="line"><span class="cl">    &#34;authorization_endpoint&#34;: &#34;https://auth.YOUR_DOMAIN/application/o/authorize/&#34;,
</span></span><span class="line"><span class="cl">    &#34;token_endpoint&#34;: &#34;https://auth.YOUR_DOMAIN/application/o/token/&#34;,
</span></span><span class="line"><span class="cl">    &#34;userinfo_endpoint&#34;: &#34;https://auth.YOUR_DOMAIN/application/o/userinfo/&#34;,
</span></span><span class="line"><span class="cl">    &#34;end_session_endpoint&#34;: &#34;https://auth.YOUR_DOMAIN/application/o/outline/end-session/&#34;,</span></span></code></pre></div>
</div>
<p>Those four addresses go into Outline unchanged.</p>
<h3 id="step-2-outlines-configuration">Step 2: Outline&rsquo;s configuration</h3>
<p>Outline is configured through an <code>.env</code>. Generate the two keys first:</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mkdir -p /opt/outline <span class="o">&amp;&amp;</span> <span class="nb">cd</span> /opt/outline
</span></span><span class="line"><span class="cl">openssl rand -hex <span class="m">32</span>   <span class="c1"># twice: for SECRET_KEY and UTILS_SECRET</span></span></span></code></pre></div>
</div>
<div class="sk-code">
  <span class="sk-code-head">INI</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="c1"># /opt/outline/.env</span>
</span></span><span class="line"><span class="cl"><span class="na">NODE_ENV</span><span class="o">=</span><span class="s">production</span>
</span></span><span class="line"><span class="cl"><span class="na">URL</span><span class="o">=</span><span class="s">https://wiki.YOUR_DOMAIN</span>
</span></span><span class="line"><span class="cl"><span class="na">PORT</span><span class="o">=</span><span class="s">3000</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="na">SECRET_KEY</span><span class="o">=</span><span class="s">YOUR_FIRST_KEY</span>
</span></span><span class="line"><span class="cl"><span class="na">UTILS_SECRET</span><span class="o">=</span><span class="s">YOUR_SECOND_KEY</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="na">POSTGRES_PASSWORD</span><span class="o">=</span><span class="s">YOUR_DB_PASSWORD</span>
</span></span><span class="line"><span class="cl"><span class="na">DATABASE_URL</span><span class="o">=</span><span class="s">postgres://outline:YOUR_DB_PASSWORD@db:5432/outline</span>
</span></span><span class="line"><span class="cl"><span class="na">PGSSLMODE</span><span class="o">=</span><span class="s">disable</span>
</span></span><span class="line"><span class="cl"><span class="na">REDIS_URL</span><span class="o">=</span><span class="s">redis://redis:6379</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="na">FILE_STORAGE</span><span class="o">=</span><span class="s">local</span>
</span></span><span class="line"><span class="cl"><span class="na">FILE_STORAGE_LOCAL_ROOT_DIR</span><span class="o">=</span><span class="s">/var/lib/outline/data</span>
</span></span><span class="line"><span class="cl"><span class="na">FILE_STORAGE_UPLOAD_MAX_SIZE</span><span class="o">=</span><span class="s">26214400</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="na">OIDC_CLIENT_ID</span><span class="o">=</span><span class="s">FROM_AUTHENTIK</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_CLIENT_SECRET</span><span class="o">=</span><span class="s">FROM_AUTHENTIK</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_AUTH_URI</span><span class="o">=</span><span class="s">https://auth.YOUR_DOMAIN/application/o/authorize/</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_TOKEN_URI</span><span class="o">=</span><span class="s">https://auth.YOUR_DOMAIN/application/o/token/</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_USERINFO_URI</span><span class="o">=</span><span class="s">https://auth.YOUR_DOMAIN/application/o/userinfo/</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_LOGOUT_URI</span><span class="o">=</span><span class="s">https://auth.YOUR_DOMAIN/application/o/outline/end-session/</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_USERNAME_CLAIM</span><span class="o">=</span><span class="s">preferred_username</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_DISPLAY_NAME</span><span class="o">=</span><span class="s">Authentik</span>
</span></span><span class="line"><span class="cl"><span class="na">OIDC_SCOPES</span><span class="o">=</span><span class="s">openid profile email</span></span></span></code></pre></div>
</div>
<ul>
<li><code>SECRET_KEY</code> encrypts field contents in the database and signs sessions. Change it later and
every sign-in is invalid and encrypted fields are unreadable. <strong>It belongs in the backup and is
never touched again.</strong></li>
<li><code>FILE_STORAGE=local</code> saves you an S3-compatible store. For a team wiki that is perfectly
enough; the files end up in a Docker volume.</li>
<li><code>PGSSLMODE=disable</code> is needed because the database runs without TLS on the internal network.
Without the line Outline tries an encrypted connection, gets
<code>The server does not support SSL connections</code> and restarts in a loop.</li>
<li><code>OIDC_DISPLAY_NAME</code> is only the label on the sign-in page.</li>
</ul>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">chmod <span class="m">600</span> /opt/outline/.env</span></span></code></pre></div>
</div>
<h3 id="step-3-the-stack">Step 3: The stack</h3>
<div class="sk-code">
  <span class="sk-code-head">YAML</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># /opt/outline/compose.yaml</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">services</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">db</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">postgres:18.6-alpine</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="l">outline-db</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">unless-stopped</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">environment</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">POSTGRES_USER</span><span class="p">:</span><span class="w"> </span><span class="l">outline</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">POSTGRES_PASSWORD</span><span class="p">:</span><span class="w"> </span><span class="l">${POSTGRES_PASSWORD}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">POSTGRES_DB</span><span class="p">:</span><span class="w"> </span><span class="l">outline</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">pgdata:/var/lib/postgresql</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">networks</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">outline-intern]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">healthcheck</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;CMD-SHELL&#34;</span><span class="p">,</span><span class="w"> </span><span class="s2">&#34;pg_isready -U outline&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l">10s</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">timeout</span><span class="p">:</span><span class="w"> </span><span class="l">5s</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">retries</span><span class="p">:</span><span class="w"> </span><span class="m">6</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">redis</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">redis:8.10.3-alpine</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="l">outline-redis</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">unless-stopped</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">networks</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">outline-intern]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">healthcheck</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">test</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;CMD&#34;</span><span class="p">,</span><span class="w"> </span><span class="s2">&#34;redis-cli&#34;</span><span class="p">,</span><span class="w"> </span><span class="s2">&#34;ping&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l">10s</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">timeout</span><span class="p">:</span><span class="w"> </span><span class="l">5s</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">retries</span><span class="p">:</span><span class="w"> </span><span class="m">6</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">outline</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">outlinewiki/outline:1.12.0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="l">outline</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">unless-stopped</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">depends_on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">db</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">condition</span><span class="p">:</span><span class="w"> </span><span class="l">service_healthy</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">redis</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">condition</span><span class="p">:</span><span class="w"> </span><span class="l">service_healthy</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">env_file</span><span class="p">:</span><span class="w"> </span><span class="l">.env</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">storage:/var/lib/outline/data</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">networks</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">outline-intern, proxy]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">labels</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.enable=true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.docker.network=proxy</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.http.routers.outline.rule=Host(`wiki.YOUR_DOMAIN`)</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.http.routers.outline.entrypoints=websecure</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.http.routers.outline.tls.certresolver=le</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">traefik.http.services.outline.loadbalancer.server.port=3000</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">pgdata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">storage</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">networks</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">outline-intern</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">internal</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">proxy</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">external</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span></span></span></code></pre></div>
</div>
<p>The database and Redis sit in a network with <code>internal: true</code> and are unreachable from outside and
from the <code>proxy</code> network. The database mount is on <code>/var/lib/postgresql</code>, not on
<code>/var/lib/postgresql/data</code>: from PostgreSQL 18 onwards the container refuses to start with the old
path.</p>
<p>For the file store we deliberately use a named volume and not a folder from the host. Outline
runs inside the container as the user <code>nodejs</code> with UID 1001; with a bind mount you would have to
set the permissions yourself, with a volume Docker handles it.</p>
<h3 id="step-4-start-and-check">Step 4: Start and check</h3>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> /opt/outline
</span></span><span class="line"><span class="cl">docker compose up -d
</span></span><span class="line"><span class="cl">docker compose logs -f outline</span></span></code></pre></div>
</div>
<p>On first start Outline creates the database and runs its migrations. It takes a good minute until
the container reports <code>(healthy)</code>:</p>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">{&#34;label&#34;:&#34;database&#34;,&#34;level&#34;:&#34;info&#34;,&#34;message&#34;:&#34;Migrated 20261012120000-add-owner-id-to-collections.js in 0.011s&#34;}
</span></span><span class="line"><span class="cl">{&#34;label&#34;:&#34;plugins&#34;,&#34;level&#34;:&#34;info&#34;,&#34;message&#34;:&#34;OIDC endpoints mounted with manual configuration&#34;}
</span></span><span class="line"><span class="cl">{&#34;label&#34;:&#34;plugins&#34;,&#34;level&#34;:&#34;info&#34;,&#34;message&#34;:&#34;OIDC plugin registered&#34;}
</span></span><span class="line"><span class="cl">{&#34;label&#34;:&#34;lifecycle&#34;,&#34;level&#34;:&#34;info&#34;,&#34;message&#34;:&#34;Listening on http://localhost:3000 / https://wiki.YOUR_DOMAIN&#34;}</span></span></code></pre></div>
</div>
<p>The two <code>plugins</code> lines are the acceptance test for sign-in: Outline only registers the module at
all if the OIDC variables are complete. If one is missing, Outline still starts, but then has no
way to sign in whatsoever.</p>
<p>Check from outside only once <code>docker compose ps</code> shows <code>(healthy)</code> for <code>outline</code>.
That takes a good minute after the start, and while the healthcheck is still running Traefik skips
the container: <code>curl</code> then fails on the certificate, because Traefik only serves its own
<code>TRAEFIK DEFAULT CERT</code>.</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">curl -s -o /dev/null -w <span class="s2">&#34;%{http_code}\n&#34;</span> https://wiki.YOUR_DOMAIN/
</span></span><span class="line"><span class="cl">curl -s -o /dev/null -w <span class="s2">&#34;%{http_code} -&gt; %{redirect_url}\n&#34;</span> https://wiki.YOUR_DOMAIN/auth/oidc</span></span></code></pre></div>
</div>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">200
</span></span><span class="line"><span class="cl">302 -&gt; https://auth.YOUR_DOMAIN/application/o/authorize/?response_type=code&amp;redirect_uri=…</span></span></code></pre></div>
</div>
<p>The second line is the important one: Outline assembles that redirect from your settings. A wrong
address there comes from the <code>.env</code>, not from Authentik.</p>
<h3 id="step-5-the-first-sign-in">Step 5: The first sign-in</h3>
<p>Open <code>https://wiki.YOUR_DOMAIN/</code>. Because Authentik is the only configured identity provider,
Outline no longer shows a sign-in page of its own and forwards you straight through:</p>
<p><figure class="my-6"><img src="/en/tutorials/outline-wiki/outline-sso_hu_263d6f117a105c66.webp" srcset="/en/tutorials/outline-wiki/outline-sso_hu_66f0636ba3f15c9b.webp 480w, /en/tutorials/outline-wiki/outline-sso_hu_263d6f117a105c66.webp 768w, /en/tutorials/outline-wiki/outline-sso_hu_695e2dedcfa9a7a3.webp 1200w, /en/tutorials/outline-wiki/outline-sso_hu_134af81d7209b827.webp 1920w" sizes="(min-width: 768px) 768px, 100vw"
    width="768" height="432"
    data-full="/en/tutorials/outline-wiki/outline-sso_hu_4f53210f2db87162.webp"
    alt="The Authentik sign-in mask with the notice Log in to continue to Outline" title="Authentik handles the sign-in – Outline itself asks for nothing"
    loading="lazy" decoding="async" class="rounded-lg"><figcaption class="mt-2 text-sm text-center text-slate-500 italic">Authentik handles the sign-in – Outline itself asks for nothing</figcaption></figure></p>
<p>After signing in you land in Outline. The first user automatically becomes the administrator, and
the workspace is created along with an example collection you can delete later:</p>
<p><figure class="my-6"><img src="/en/tutorials/outline-wiki/outline-home_hu_d9fe17f3e39dce1b.webp" srcset="/en/tutorials/outline-wiki/outline-home_hu_b55cbe9b9b483d60.webp 480w, /en/tutorials/outline-wiki/outline-home_hu_d9fe17f3e39dce1b.webp 768w, /en/tutorials/outline-wiki/outline-home_hu_307697927246ccf9.webp 1200w, /en/tutorials/outline-wiki/outline-home_hu_7541d78e4b99394.webp 1920w" sizes="(min-width: 768px) 768px, 100vw"
    width="768" height="432"
    data-full="/en/tutorials/outline-wiki/outline-home_hu_2e4fc29136cf7371.webp"
    alt="Outline after signing in: the navigation on the left with the &ldquo;Welcome&rdquo; collection and the &ldquo;Personal&rdquo; section, the four starter documents in the middle" title="After signing in: collections and the personal section on the left, the documents of the Welcome collection in the middle"
    loading="lazy" decoding="async" class="rounded-lg"><figcaption class="mt-2 text-sm text-center text-slate-500 italic">After signing in: collections and the personal section on the left, the documents of the Welcome collection in the middle</figcaption></figure></p>
<p>Below the collections sits the <em>Personal</em> section. Every account can create documents there that
only it can see and that it can share with others on purpose, a private notepad next to the shared
wiki.</p>
<div class="not-prose my-6 rounded-lg border-l-4 p-4 border-paprika-400 bg-paprika-50 dark:border-paprika-700 dark:bg-paprika-900/20">
  <p class="mb-1 flex items-center gap-2 font-semibold text-slate-900 dark:text-white">
    <span aria-hidden="true">🔥</span>Whoever signs in first owns the wiki
  </p>
  <div class="prose-kitchen text-sm">There is no invitation and no approval: whoever comes through Authentik first is the administrator.
So create the OIDC access in Authentik <strong>restricted from the start</strong> (through a group binding on
the application) and sign in yourself first, before you hand the name to anyone.</div>
</div>
<h3 id="step-6-documents-and-files">Step 6: Documents and files</h3>
<p>You create a document with <em>New doc</em>. Outline understands Markdown as you type: <code>##</code> becomes a
heading, <code>-</code> a list:</p>
<p><figure class="my-6"><img src="/en/tutorials/outline-wiki/outline-dokument_hu_fe90e1b506b9226e.webp" srcset="/en/tutorials/outline-wiki/outline-dokument_hu_433ce37edb87baaf.webp 480w, /en/tutorials/outline-wiki/outline-dokument_hu_fe90e1b506b9226e.webp 768w, /en/tutorials/outline-wiki/outline-dokument_hu_3512251ba5459e07.webp 1200w, /en/tutorials/outline-wiki/outline-dokument_hu_7985a3f836a90f7d.webp 1920w" sizes="(min-width: 768px) 768px, 100vw"
    width="768" height="432"
    data-full="/en/tutorials/outline-wiki/outline-dokument_hu_37e8a089122e2306.webp"
    alt="An Outline document with headings and bullet lists plus the document list in the sidebar" title="A finished document – headings appear on the left inside the collection as sub-items"
    loading="lazy" decoding="async" class="rounded-lg"><figcaption class="mt-2 text-sm text-center text-slate-500 italic">A finished document – headings appear on the left inside the collection as sub-items</figcaption></figure></p>
<p>With <code>FILE_STORAGE=local</code>, uploaded images and attachments end up in the volume. After an upload you
find them like this:</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker <span class="nb">exec</span> outline find /var/lib/outline/data -type f <span class="p">|</span> head -3</span></span></code></pre></div>
</div>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">/var/lib/outline/data/uploads/fbc65b45-…/f633c516-…/punkt.png</span></span></code></pre></div>
</div>
<p>The files live under random identifiers; anyone who does not know the URL will not find them. They
are only served through <code>/api/attachments.redirect</code>, and that checks permissions.</p>
<h3 id="step-7-security-settings-before-anyone-else-joins">Step 7: Security settings before anyone else joins</h3>
<p>Under <em>Settings → Security</em> there are four switches you should touch before the first invitation:</p>
<p><figure class="my-6"><img src="/en/tutorials/outline-wiki/outline-security_hu_eb2897cd41b86cbf.webp" srcset="/en/tutorials/outline-wiki/outline-security_hu_9f821f510489650f.webp 480w, /en/tutorials/outline-wiki/outline-security_hu_eb2897cd41b86cbf.webp 768w, /en/tutorials/outline-wiki/outline-security_hu_3c1907a541c66b3b.webp 1200w, /en/tutorials/outline-wiki/outline-security_hu_9653274c32734f8f.webp 1920w" sizes="(min-width: 768px) 768px, 100vw"
    width="768" height="432"
    data-full="/en/tutorials/outline-wiki/outline-security_hu_a9224ecafa6d9d73.webp"
    alt="Outline&rsquo;s security settings with invites, default role and public document sharing" title="The default role for new accounts and public sharing are the two switches that matter"
    loading="lazy" decoding="async" class="rounded-lg"><figcaption class="mt-2 text-sm text-center text-slate-500 italic">The default role for new accounts and public sharing are the two switches that matter</figcaption></figure></p>
<p><em>Default role</em> is set to <code>Editor</code>. Everyone who signs in through Authentik may write immediately.
For a mixed team <code>Viewer</code> is the better default; you then grant write access deliberately.</p>
<p><em>Public document sharing</em> lets every member put a document on the open internet behind a link.
That is convenient and a data leak in one switch; turn it off unless you explicitly need it.</p>
<p><em>Allow users to send invites</em> gives members the right to bring in more people. With SSO that
decision is better kept in Authentik than in the wiki.</p>
<p><em>Personal documents</em> sits further down and enables the private documents from step 5. For a team
wiki that is a trade-off, because private really means private here: even as the administrator you
cannot open someone else&rsquo;s personal document. You only get &ldquo;No access to this doc&rdquo; and the option
to request access. Search does not find it, and an export of the whole workspace leaves it out. In
plain text it exists only in the database and therefore in your backup. If knowledge should always
end up in the shared part, <strong>turn the switch off before the first invitation</strong>: it only prevents
new personal documents, existing ones stay with their authors.</p>
<p>The bottom left shows the running version (<code>v1.12.0</code>) along with whether it is current. There is
no quicker way to check your update status.</p>
<h2 id="when-it-doesnt-work">When it doesn&rsquo;t work</h2>
<div class="troubleshoot not-prose">
<p><strong>The sign-in bounces straight back and Outline shows &ldquo;Authentication failed&rdquo;.</strong> Look at Authentik&rsquo;s logs: <code>docker compose logs server | grep -i grant</code>. If it says <code>Invalid grant_type for provider</code>, the provider&rsquo;s <strong>Grant types</strong> field is empty. In Authentik 2026.x <strong>Authorization Code</strong> has to be listed there explicitly; otherwise the sign-in aborts with <code>invalid_request</code> before the login mask even appears. Outline only logs <code>OAuth error during authentication: The request is otherwise malformed</code> – the actual cause is always on the Authentik side.</p>
<p><strong>After signing in you get <code>redirect_uri</code> back as an error.</strong> The address stored in Authentik has to be exactly <code>https://wiki.YOUR_DOMAIN/auth/oidc.callback</code>, with the same name that <code>URL=</code> in Outline&rsquo;s <code>.env</code> names. A different hostname, an extra slash or <code>http</code> instead of <code>https</code> is enough for a rejection. With matching mode <code>Strict</code> there is no leeway – that is the point.</p>
<p><strong>Outline shows no sign-in page any more and jumps straight to Authentik.</strong> That is not a fault: with exactly one configured identity provider Outline skips its own selection page. As soon as you set up a second route it comes back. If you want to see the page, call it with a notice parameter, for example after a failed attempt.</p>
<p><strong>Uploads fail when you bind a host folder instead of using the volume.</strong> Outline runs inside the container as <code>nodejs</code> with UID 1001 and cannot write into a root-owned folder – on hardened servers with <code>umask 027</code> even less so. Either stay with the named volume, or run <code>chown -R 1001:1001</code> on the directory. You can check with <code>docker exec outline ls -la /var/lib/outline/data</code>.</p>
<p><strong>Outline starts, but nobody can sign in, and the log is missing the line <code>OIDC plugin registered</code>.</strong> Then at least one of the six <code>OIDC_</code> variables is empty. Outline does not report this as an error – it simply starts without a sign-in route. Check with <code>docker exec outline env | grep OIDC</code> whether all values arrive; a common cause is a <code>$</code> in the client secret, which Compose expands under <code>environment:</code>. With <code>env_file:</code> as used here that does not happen.</p>

</div>
<p class="mt-3 text-sm text-slate-500 dark:text-slate-400">
  Your problem is not listed?
  <a href="/en/errors/" class="font-medium text-paprika-700 hover:underline dark:text-paprika-400">Search all error messages →</a>
</p>

<h2 id="maintenance--backups">Maintenance &amp; backups</h2>
<p>Updates are unremarkable because the migrations run automatically at start:</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> /opt/outline
</span></span><span class="line"><span class="cl">docker compose <span class="nb">exec</span> -T db pg_dump -U outline outline &gt; before-update-<span class="k">$(</span>date +%F<span class="k">)</span>.sql
</span></span><span class="line"><span class="cl">sed -i <span class="s1">&#39;s/outline:1.12.0/outline:NEW_VERSION/&#39;</span> compose.yaml
</span></span><span class="line"><span class="cl">docker compose pull <span class="o">&amp;&amp;</span> docker compose up -d
</span></span><span class="line"><span class="cl">docker compose logs outline --tail <span class="m">20</span></span></span></code></pre></div>
</div>
<p>The <code>pg_dump</code> beforehand is not a ritual: migrations only run one way, and a step back to an older
version is not possible afterwards. Outline publishes a new minor version roughly monthly.</p>
<p>Three things have to go into the backup:</p>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">/opt/outline/.env                 # SECRET_KEY and UTILS_SECRET, without them the DB is useless
</span></span><span class="line"><span class="cl">pg_dump output                    # documents, collections, accounts
</span></span><span class="line"><span class="cl">volume outline_storage            # uploaded images and attachments</span></span></code></pre></div>
</div>
<p>The <code>SECRET_KEY</code> is the critical part: the database alone is worth nothing without it. You back up
the volume with</p>
<div class="sk-code">
  <span class="sk-code-head">Terminal</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run --rm -v outline_storage:/data -v /tmp:/backup alpine <span class="se">\
</span></span></span><span class="line"><span class="cl">  tar czf /backup/outline-files.tar.gz -C /data .</span></span></code></pre></div>
</div>
<p>All of it belongs encrypted in your <a href="/en/tutorials/restic-backups/">Restic backup</a>.</p>
<p>Resource use is modest and steady:</p>
<div class="sk-code">
  <span class="sk-code-head">Ausgabe</span>
  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">outline         341 MB
</span></span><span class="line"><span class="cl">outline-db       77 MB
</span></span><span class="line"><span class="cl">outline-redis    27 MB</span></span></code></pre></div>
</div>
<p>The database grew to 12 MB with a few documents. What really costs memory is the Authentik next to
it. Reckon with a good gigabyte for the identity provider alone and size the VPS accordingly.</p>
<p>The effort in operation: one update a month with a dump beforehand, about fifteen minutes. Nothing
happens in between. Outline has no background jobs that get out of hand, and the file store only
grows as fast as your team inserts images. The one thing to keep an eye on is the user list: someone
deleted in Authentik still exists as an account in Outline and has to be deactivated there
separately.</p>
]]></content:encoded></item></channel></rss>