Hướng dẫn cài đặt Docmost – Opensource wiki tuyệt vời thay thế cho Notion

Dưới đây là hướng dẫn cài đặt Docmost bằng Docker (cách đơn giản và được khuyến nghị chính thức nhất năm 2026). Docmost là open-source, tự host, rất phù hợp làm Notion/Confluence thay thế cho note + tài liệu nội bộ với phân quyền tốt.

Yêu cầu trước khi bắt đầu

• Máy chủ (VPS/Ubuntu/Debian/CentOS…) hoặc máy local có Docker + Docker Compose đã cài.

• Cổng 3000 mở (hoặc bạn sẽ map sang cổng khác).

• Dung lượng ổ cứng: ít nhất 5-10GB trống (dữ liệu sẽ tăng dần).

Nếu chưa có Docker, cài nhanh trên Ubuntu (phổ biến ở VN):

Bash

# Cài Docker + Compose (phiên bản mới nhất)
sudo apt update && sudo apt upgrade -y
sudo apt install ca-certificates curl gnupg lsb-release -y

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

# Kiểm tra
docker --version
docker compose version

Bước 1: Tạo thư mục và tải file docker-compose

Bash

mkdir -p ~/docmost && cd ~/docmost

# Tải file mẫu chính thức từ repo
curl -o docker-compose.yml https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml

(Nếu link trên không còn, bạn có thể copy thủ công từ: https://github.com/docmost/docmost/blob/main/docker-compose.yml)

Bước 2: Chỉnh sửa file docker-compose.yml

Mở file bằng nano/vim:

Bash

nano docker-compose.yml

Bạn cần thay/chỉnh những phần quan trọng nhất (đừng để mặc định!):

YAML

services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: http://your-domain.com     # hoặc http://IP-cua-may:3000 (bắt buộc)
      APP_SECRET: your_very_long_random_secret   # Tạo bằng: openssl rand -hex 32
      DATABASE_URL: postgresql://docmost:matkhau-manh@db:5432/docmost?schema=public
      REDIS_URL: redis://redis:6379
    ports:
      - "3000:3000"   # Có thể đổi thành 8080:3000 nếu muốn
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: matkhau-manh   # Phải khớp với DATABASE_URL ở trên
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql/data

  redis:
    image: redis:7.2-alpine
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  docmost:
  db_data:
  redis_data:

Lưu ý quan trọng:

• APP_URL: phải là địa chỉ truy cập thực tế (ví dụ: http://192.168.1.100:3000 hoặc https://wiki.tencongty.vn sau khi có domain + SSL).

• APP_SECRET: tạo chuỗi ngẫu nhiên dài, ví dụ:

  Bash

  openssl rand -hex 32

• POSTGRES_PASSWORD: dùng mật khẩu mạnh, ghi nhớ lại.

Lưu file (Ctrl+O → Enter → Ctrl+X nếu dùng nano).

Bước 3: Khởi động

Bash

# Pull image và chạy (lần đầu sẽ tải khá lâu)
docker compose up -d

# Kiểm tra container đang chạy
docker compose ps
docker logs -f docmost-docmost-1   # Xem log nếu có lỗi

Bước 4: Truy cập và hoàn tất cài đặt

Mở trình duyệt:

• http://IP-cua-may:3000 (hoặc domain bạn đã set trong APP_URL)

Bạn sẽ thấy trang setup đầu tiên:

1. Tạo tài khoản admin (email + password).

2. Đăng nhập → bắt đầu tạo workspace, space (phòng ban), page, upload file, set permission…

Bảo mật & Nâng cao (khuyến nghị)

• Dùng reverse proxy + SSL (rất quan trọng nếu expose ra ngoài):

  • Nginx / Caddy / Traefik + Let’s Encrypt.

  • Ví dụ đơn giản với Nginx Proxy Manager (cũng chạy bằng Docker).

• Backup: Sao lưu 3 volume: docmost, db_data, redis_data.

• Update Docmost:

  Bash

  docker compose pull
  docker compose up -d --force-recreate

Nếu gặp lỗi phổ biến:

• “Connection refused db” → kiểm tra password khớp giữa DATABASE_URL và POSTGRES_PASSWORD.

• Port 3000 bị chiếm → đổi port trong docker-compose.yml.