Docker Compose クイックスタート
Docker Compose クイックスタート
セルフホスト版 Docmost を 最小構成 で起動する手順です。本リポジトリ同梱の docker-compose.yml を使います。
構成
| サービス | イメージ | 役割 |
|---|---|---|
| docmost | docmost/docmost:latest |
アプリケーション本体 |
| db | postgres:18 |
メインデータベース |
| redis | redis:8 |
セッション・キャッシュ・共同編集 |
前提条件
- Docker と Docker Compose がインストール済み
- ポート
3000が利用可能
手順
1. リポジトリを取得(または compose ファイルをコピー)
git clone https://github.com/docmost/docmost.git
cd docmost
2. 環境変数を設定
docker-compose.yml の以下を 必ず変更 してください。
| 変数 | 説明 |
|---|---|
APP_URL |
ブラウザからアクセスする URL(例: https://docs.example.com) |
APP_SECRET |
ランダムな長い文字列(セッション暗号化用) |
DATABASE_URL |
PostgreSQL 接続文字列 |
REDIS_URL |
Redis 接続文字列(既定: redis://redis:6379) |
APP_SECRET は次のように生成できます。
openssl rand -hex 32
3. 起動
docker compose up -d
4. 初回セットアップ
- ブラウザで
APP_URLを開く /setup/registerで管理者アカウントとワークスペースを作成/homeに入れば完了
→ 詳細: 「はじめかた — ログイン・招待・初回セットアップ」(No.2.3)
データの永続化
Compose ファイルでは以下のボリュームを使用します。
| ボリューム | 内容 |
|---|---|
docmost |
添付ファイル(local ストレージ時) |
db_data |
PostgreSQL データ |
redis_data |
Redis 永続化(AOF) |
よくある次のステップ
| やること | ナレッジ |
|---|---|
| HTTPS / リバースプロキシ | No.10.6 |
| 環境変数の詳細 | No.10.2 |
| 推奨スペック | No.10.7 |
| SMTP(招待メール)設定 | No.10.4 |
| S3 ストレージ | No.10.3 |
| Enterprise ライセンス | No.10.5 |
| バックアップ | No.10.4 |
関連ナレッジ
- リバースプロキシ: 「リバースプロキシ設定」(No.10.6)
- 環境変数: 「必要インフラと環境変数リファレンス」(No.10.2)
- はじめかた: 「ログイン・招待・初回セットアップ」(No.2.3)
- クラウド vs セルフホスト: 「クラウド版とセルフホスト版の違い」(No.2.4)
- 公式ドキュメント: https://docmost.com/docs