selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

outline logo

Self-host outline

v1.12.0

Team wiki and knowledge base with realtime collaboration

ReleaseOpen CoreOther
docker compose up -d
Updated3 weeks ago
LanguageTypescript
Setup difficultyAdvanced
ThemeDark mode
Stars
41 272
RAM
512MB
Port
3000 (HTTP (and websocket) port the Outline server listens on)
Requires
PostgreSQL, Redis
Docker
outlinewiki/outline
Outline workspace showing a document being editedOutline document navigation sidebar and editorComment threads on a documentEditor block menu

What is outline?

Outline is a team knowledge base and wiki written in React and Node.js that keeps internal documentation, product specs, meeting notes and onboarding material in one searchable workspace. Documents are edited in a markdown-aware block editor with slash commands and live embeds, several people can work on the same page at once, and threaded comments plus @mentions keep discussion attached to the content. Access is managed with read and write permissions, user groups and shareable links, and the workspace can be served from your own custom domain and brand. Sign-in is delegated to an identity provider — Google, Microsoft, Slack, Discord, GitLab, generic OIDC, SAML, passkeys or email magic links — since the app has no native email-and-password login. An open API with webhooks supports automation, and existing content can be imported from Notion or a markdown export. Self-hosting means running the official Docker image next to PostgreSQL (v14 or newer) and Redis (v4 or newer), configured through environment variables; the vendor sells Business and Enterprise licenses that add SAML, an audit log, guest users and AI answers. Under the BSL-1.1 licence you may not offer Outline itself to third parties as a paid hosted service.

outline alternatives

All self-hosted alternatives to Confluence → All self-hosted alternatives to Google Docs →

Should you self-host outline?

outline scores 78/100 on selfhost.directory (how scoring works) and ranks #2 of 31 in Wikis. It has 41 272 GitHub stars, +404 in the last 30 days.

It shipped 14 stable releases in the past year. The latest, v1.12.0, came out on 23 October 2026. New versions land roughly every 2 weeks.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is AppFlowy (83/100, 78 922 stars). It scores higher overall, so compare the two before you pick. See outline vs AppFlowy side by side.

Features

  • AI question answeringNot included in the free community edition; requires a Business or Enterprise license.
  • Comments and mentions
  • Custom domain and brandingRemoving Outline branding is an Enterprise-only item on the on-premises pricing table.
  • Document templates
  • Full-Text Search
  • Groups and permissionsGuest users are listed as a paid Business/Enterprise feature.
  • Markdown editor with embeds
  • Multi-language and RTL support
  • Public Sharing
  • Real-time collaborative editing
  • REST API
  • Version History

outline README

Outline

A fast, collaborative, knowledge base for your team built using React and Node.js.
Try out Outline using our hosted version at www.getoutline.com.

screenshot

TypeScript Styled Components

This is the source code that runs Outline and all the associated services. If you want to use Outline then you don't need to run this code, A hosted version of the app is offered at getoutline.com. You can also find documentation on using Outline in our guide.

How to install outline

Install outline with Docker

Environment variables
URL, PORT, DATABASE_URL, REDIS_URL, SECRET_KEY, UTILS_SECRET, FILE_STORAGE

Using this sample file as a reference create a docker.env file to contain the environment variables for your installation.

Be sure to include all required environment variables for your chosen setup, a URL, DATABASE_URL, REDIS_URL , and SECRET_KEY are considered the minimum.

Install Docker Compose, create a docker-compose.yml file with the outline, postgres, redis and https-portal services, then:

docker compose up -d

Docs call Docker the recommended and supported way to self-host; images are Alpine-based and released monthly.

How to configure outline

  • URLThis URL should point to the fully qualified, publicly accessible, URL. If using a proxy this will be the proxy's URL.
  • PORT3000The port to expose the Outline server on, this should match what is configured in your docker-compose.yml
  • SECRET_KEY––––––––––––––––––––––––––––––––––––––––– ––––––––––– FILE-BASED SECRETS –––––––– ––––––––––––––––––––––––––––––––––––––––– Any environment variable read by Outline can be loaded from a file by appending _FILE to the variable name and setting the value to the path of the file. This is useful for Docker secrets and other file-based secret management systems. For example, instead of:
  • UTILS_SECRETGenerate a unique random key. The format is not important but you could still use `openssl rand -hex 32` in your terminal to generate a random value.
  • DEFAULT_LANGUAGEen_USThe default interface language. See translate.getoutline.com for a list of available language codes and their rough percentage translated.

outline releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I choose a specific plan?

Plans are based on the number of team members, and a workspace automatically moves up a tier when it outgrows its plan.

Do you have discounts for non-profits or educational institutions?

Yes, a 30% discount applies to non-profit and educational organisations.

What about teams larger than 200 users?

Larger teams are supported on the cloud-hosted service after contacting the vendor to discuss pricing.

How does the free trial work?

A new team gets 30 free days; after that the knowledge base becomes read-only until a payment method is added, and all documents can still be exported.

More in Wikis

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…