Escriba を自分の手元に

Escriba は、必要なものをすべてすでに同梱した ひとつのビルド済み Docker イメージ として提供されます — ffmpeg、Tesseract OCR、Whisper、組み込み Redis。配線すべき追加サービスはありません。取得して、パスワードを設定すれば、自分のインフラ上で動く、プライベートなドキュメント→Markdown エンジンが手に入ります。

なぜセルフホストなのか？

あなたのドキュメントは あなたの マシンで変換され、直後に削除されます。何も保存されず、サードパーティのクラウドには何も送られません。制御は人間のレイヤーに留まります — LLM に何が届くかは、あなたが決めます。

クイックスタート

イメージを取得し、単一のコマンドで実行します。

Escriba を実行

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

その後、http://localhost:8000 を開き、設定した GOD_PASSWORD でサインインします。

ノート

このイメージは ffmpeg、Tesseract OCR、Whisper、組み込み Redis を同梱しています。追加のサービスは不要です。キーは 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 には、前段にリバースプロキシを置きます。Caddy なら、2 行の Caddyfile で 自動 HTTPS が手に入ります：

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

最小限の設定

すべての設定は環境変数です。推奨される最小構成は次のとおりです。

.env

SECRET_KEY=<openssl rand -hex 32>   # required in production
GOD_PASSWORD=<a strong password>
ANGEL_PASSWORD=<optional>
HUMAN_PASSWORD=<optional>

パスワードが設定されていない場合、ランダムな GOD_PASSWORD が生成され、起動時にコンテナの ログ に出力されます。すべての一覧は 設定 をご覧ください。

要件

ベースのアプリは 軽量 です。1 コア / 2 GB の VPS にディスク約 5 GB あれば、始めるには本当に十分で、Escriba はワーカーを CPU に合わせてスケールします。任意の エンタープライズ向け PII 匿名化 モジュール（Anonimal）はより重いので、必要なときだけマウントしてください。

デプロイ前に確かめておく

私たちは、すべての構成 — ベースのアプリ、エンタープライズ匿名化、重い文字起こし — について、正直な最小・推奨スペックを示しています。だから、あなたのマシンのせいで「動かない」と感じることは決してありません。システム要件の全文を見る →

デプロイガイド全文 すべての設定オプション