Presentiaのインストール

Presentiaは、アプリ全体 — バックエンド、フロントエンド、アセット — をパッケージする単一の マルチステージ Dockerfile（EXPOSE 80）からビルドされるため、Dockerfileからビルドできる プラットフォームならどれでも動きます。

最も重要な1つのルール

永続的なものすべて — プレゼンテーション、ログイン、設定、コスト履歴、生成された画像、 エクスポート、アップロード — は /app_data の下にあります。必ずそこに永続ボリュームを マウントしてください。 これは外部のPostgresを使う場合でも変わりません。画像とエクスポートは 依然として /app_data に書き込まれるからです。

クイックスタート（Docker Compose）

git clone https://github.com/diegoparras/presentia.git
cd presentia
docker compose up -d --build production

http://localhost:5001 を開き、ログインを作成し、オンボーディングでテキストプロバイダーを 選びます — OpenRouterのAPIキーが、カタログのすべてのモデルを一度に解放する最速の方法です。

composeファイルはすでに ./app_data をマウントし、Escriba、Anonimal、GPUバリアント用の コメントアウトされたサービスブロックを同梱しています。GPUホストでは、 docker compose up -d --build production-gpu がローカルモデル向けのNVIDIAアクセラレーションを 有効にします。ポートは PRESENTON_HTTP_HOST_PORT で変更できます。

ビルドに関する注記

このイメージはPython + Next.jsをコンパイルし、エクスポートランタイムをダウンロードし、Chromiumを 同梱します — 重いビルドで、数GBのイメージになります。ビルダーにはRAMとディスクに余裕のあるホストを 与えてください。

EasyPanelにデプロイ

1. + Service → App、Source → GitHub → diegoparras/presentia（ブランチ main）、 Build → Dockerfile。
2. （推奨）+ Service → Postgres を同じプロジェクト内に（例：presentia-db）。 サービス同士は名前で会話します — <project>_presentia-db:5432 であって、 host.docker.internal ではありません。
3. アプリの Environment で：

   DATABASE_URL=postgresql://user:password@<project>_presentia-db:5432/presentia
   MIGRATE_DATABASE_ON_STARTUP=true

   素の postgresql:// スキームを使います — 非同期ドライバーはアプリ自身が追加します。 組み込みのSQLiteを使う場合は DATABASE_URL を空のままにします。
4. Mounts → Volume → 永続ボリュームを /app_data にマウントします。
5. Domains → Container Port 80、ドメインを追加し、HTTPSを有効にします。
6. Deploy。 初回起動時にマイグレーションが完全なスキーマを自動的に作成します。

素のDocker / リバースプロキシ

docker build -t presentia .
docker run -d --name presentia --restart unless-stopped \
  -p 5001:80 -v presentia_data:/app_data \
  -e MIGRATE_DATABASE_ON_STARTUP=true \
  presentia

TLSのためにリバースプロキシを前に置きます。Caddyfile の例：

presentia.example.com {
    reverse_proxy localhost:5001
}

主な環境変数

すべては Settings UIから設定できます — 環境変数はヘッドレスまたはロックダウンされた デプロイのためのものです。特に有用なもの：

変数	既定値	説明
LLM	—	テキストプロバイダー：openai、anthropic、google、deepseek、openrouter、ollama、lmstudio、litellm、azure_openai、bedrock、vertex、custom。
<PROVIDER>_API_KEY / <PROVIDER>_MODEL	—	プロバイダーごとの認証情報とモデル（例：OPENROUTER_API_KEY + OPENROUTER_MODEL）。
IMAGE_PROVIDER	—	gpt-image-1.5、dall-e-3、gemini_flash、pexels、pixabay、comfyui。
WEB_GROUNDING / WEB_SEARCH_PROVIDER	オフ	Web検索：searchgirl、searxng、tavily、exa、brave、または auto（モデルネイティブ）。
AUTH_USERNAME / AUTH_PASSWORD	—	初回起動フォームの代わりにログインをシードします。
CAN_CHANGE_KEYS	true	false はAPIキーをロックし、UIから編集できなくします。
DATABASE_URL	SQLite	マルチユーザーのデプロイではPostgreSQLを指定します。
DATASET_MAX_ROWS	200	データからグラフを作るエンドポイントの行数上限。
DISABLE_ANONYMOUS_TRACKING	—	true でアップストリームの匿名テレメトリーを無効化します。

完全なプロバイダーマトリクス（Azure、Bedrock、Vertex、ComfyUIほか）はリポジトリの docker-compose.yml と .env.example に文書化されています。

ドキュメントを読む