デプロイ

すべては ひとつのビルド済みイメージ から動作します：ghcr.io/diegoparras/escriba:latest。ffmpeg、Tesseract OCR、Whisper、組み込み Redis を同梱しており、追加のサービスは不要です。

ヒント

始める前に、.env.example を .env にコピーし、シークレット（SECRET_KEY、GOD_PASSWORD、…）を設定してください。キーは openssl rand -hex 32 で生成できます。

EasyPanel

1. Project → + Service → App を開き、Source → Docker Image を ghcr.io/diegoparras/escriba:latest に設定します。
2. 環境変数 を追加します（設定 を参照）。
3. Domains で Container Port 8000 を設定し、ドメインを追加して HTTPS を有効にします。
4. デプロイします。

Docker Compose

git clone https://github.com/diegoparras/escriba.git
cd escriba
cp .env.example .env          # set your secrets
docker compose up -d --build

Portainer

Stacks → Add stack → Repository で https://github.com/diegoparras/escriba を指定し、compose パスを docker-compose.yml にします（または Web エディタに compose ファイルを貼り付けます）。環境変数を設定して デプロイします。アプリはポート 8000 で待ち受けます。

Dokploy

Create Application → GitHub（リポジトリ diegoparras/escriba）を Build Type: Dockerfile で作成し、環境変数を追加し、ドメインを Container Port 8000 に HTTPS つきで設定して、デプロイします。

素の Docker

docker build -t escriba .
docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" -e GOD_PASSWORD="change-me" escriba

TLS には、前段にリバースプロキシを置きます。Caddyfile の例（自動 HTTPS）：

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

Nginx を使う場合は、localhost:8000 へプロキシし、大きなアップロードに備えて client_max_body_size を引き上げてください。

匿名化サービス

PII 匿名化 を有効にするには、内部の Anonimal サービスを Escriba と並べて実行し、ANONIMAL_URL をそこに向けます（例：http://anonimal:8000）。ANONIMAL_URL を空のままにすると、この機能は完全に非表示になります。

パフォーマンス

デフォルトでは、アプリは CPU コアごとに 1 つのワーカー を起動するため、どんなホストにも適応します（1 コアの VPS → 1 ワーカー、24 スレッドのサーバー → 24）。各ワーカーは約 250 MB の RAM を使います。上限を設けるには WEB_CONCURRENCY を固定値に設定してください。