はじめに
必要要件
- Docker EngineまたはDocker Desktop
- Docker Compose v2（
docker compose） - clone・開発用のGit
- ForgejoデータとSpaceイメージを保存できるディスク容量
通常のCompose起動では、ホスト側にNode.jsやPythonは不要です。
新しい環境で起動する
bash
git clone https://github.com/Sunwood-ai-labs/OpenFace.git
cd OpenFace
cp .env.example .env
docker compose up -d --buildWindows PowerShellではコピー行を次に置き換えます。
powershell
Copy-Item .env.example .env共有する前に .env の OPENFACE_ADMIN_PASSWORD を変更してください。https://localhost:8443 を開きます。初回は自己署名の開発用証明書が生成されるため、ブラウザに警告が表示されます。
起動確認
bash
docker compose ps
docker compose logs seedseed は正常終了し、常駐サービスはhealthyまたはrunningになります。
停止と再ビルド
bash
docker compose down
docker compose up -d --build通常の down はnamed volumeを保持します。--volumes はForgejoのリポジトリ・ユーザー・token・agent metricsを意図的に削除するときだけ追加してください。