How to Self-Host BookStack Wiki

What Is BookStack?

BookStack is an open-source wiki platform designed for organizing and storing information. It uses a book/chapter/page hierarchy that makes documentation easy to structure and navigate.

Requirements

• A Breeze with at least 1 GB RAM
• Docker and Docker Compose

Docker Compose Setup

mkdir -p /opt/bookstack && cd /opt/bookstack
cat > docker-compose.yml <<'EOF'
services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=https://wiki.yourdomain.com
      - DB_HOST=db
      - DB_PORT=3306
      - DB_USER=bookstack
      - DB_PASS=bookstack_password
      - DB_DATABASE=bookstack
    volumes:
      - bookstack-data:/config
    ports:
      - "6875:80"
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mariadb:11
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=bookstack_password
    volumes:
      - bookstack-db:/var/lib/mysql
    restart: unless-stopped

volumes:
  bookstack-data:
  bookstack-db:
EOF

docker compose up -d

Default Login

Email: admin@admin.com / Password: password. Change these immediately after first login.

Features

• Book → Chapter → Page hierarchy
• WYSIWYG and Markdown editors
• Full-text search
• Role-based permissions
• Image management
• PDF and HTML export
• LDAP and SAML authentication
• API for programmatic access