How to Self-Host Outline Wiki

What Is Outline?

Outline is a modern, fast wiki and knowledge base for teams. It features a beautiful editor, real-time collaboration, and integrations with Slack, Figma, and other tools.

Requirements

• A Breeze with at least 2 GB RAM
• Docker and Docker Compose
• An OAuth provider (Google, GitHub, or OIDC)

Docker Compose Setup

mkdir -p /opt/outline && cd /opt/outline
cat > docker-compose.yml <<'EOF'
services:
  outline:
    image: outlinewiki/outline:latest
    env_file: .env
    ports:
      - "3000:3000"
    depends_on:
      - postgres
      - redis
    restart: unless-stopped

  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: outline
      POSTGRES_PASSWORD: outline_password
      POSTGRES_DB: outline
    volumes:
      - outline-db:/var/lib/postgresql/data
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    restart: unless-stopped

volumes:
  outline-db:
EOF

Environment Configuration

Create a .env file with:

SECRET_KEY=$(openssl rand -hex 32)
UTILS_SECRET=$(openssl rand -hex 32)
DATABASE_URL=postgres://outline:outline_password@postgres:5432/outline
REDIS_URL=redis://redis:6379
URL=https://wiki.yourdomain.com
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data

You also need OAuth credentials from your provider (Google, GitHub, etc.).

Features

• Clean, fast block-style editor
• Real-time collaboration
• Nested document collections
• Full-text search
• Markdown shortcuts
• API for automation
• Slack and other integrations