設定
セルフホスティングの Nodaro のすべての環境変数を、目的別に説明します。デフォルト値、Compose スタックで .env から設定できるかどうか、変数で変わる内容をまとめています。
このページは、セルフホスティングの Nodaro の設定リファレンスです。運用者が設定するすべての環境変数を、目的別に、デフォルト値とあわせて説明します。同梱の Compose スタックでは、どの変数にもそのまま動くデフォルト値があるので、変えたいものだけを設定します。Nodaro Cloud にだけ関係する変数は載せていません。
変数の設定方法
Compose スタックでは、変数を次の 2 か所のどちらかで設定します。
.envで設定する:docker-compose.community.ymlと同じ場所にある.envです。Compose ファイルがアプリに渡す変数には、この方法が使えます。以下の表では、そうした変数の .env 列がはいになっています。- Compose ファイルで設定する:それ以外のすべての変数に使います。
nodaroサービスのenvironment:に追加します。
nodaro:
environment:
# ...the variables already listed...
MCP_ENABLED: "true"
MCP_PUBLIC_URL: https://mcp.nodaro.example.comそのあと、変更を適用します。
docker compose -f docker-compose.community.yml up -dNodaro は、起動時に環境変数を読み込みます。唯一の例外は /setup で貼り付けたプロバイダーキーで、これはすぐに適用されます。Compose スタックを使わない場合は、利用しているプラットフォームの環境変数の設定で変数を設定します。
Compose スタックを使わない場合に必須の変数:SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY、INTERNAL_ORCHESTRATOR_SECRET です。これらがないと、API は起動せず、不足している変数や無効な変数を一覧表示します。
インスタンス
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
EDITION | community | いいえ | community、business、cloud のいずれかです。Compose ファイルでは community に固定されています。エディションとサーフェスプロファイルを参照してください。 |
PUBLIC_URL | http://localhost:3000 | はい | 環境の公開オリジンです。ログインと OAuth のコールバック、メディアの URL、CORS のチェックに使われます。 |
PUBLIC_URL_SAME_ORIGIN | 未設定 | いいえ | true にすると、ブラウザーに渡す API のアドレスが PUBLIC_URL ではなく / になり、ストリームが、訪問者が開いたホスト名のまま維持されます。複数のホスト名で応答する環境向けです。有効になるのは、厳密に true という値だけです。 |
ROBOTS_NOINDEX | 未設定 | いいえ | true にすると、環境全体が検索エンジンにインデックスされなくなります。どこから配信されても、すべての応答に X-Robots-Tag: noindex が付きます。ステージング用のコピーなど、検索結果に決して表示されてはいけない環境で使います。有効になるのは、厳密に true という値だけです。反映するには再起動します。 |
LEGACY_UI_HOSTS, FLOW_UI_ORIGIN | 未設定 | いいえ | API を PUBLIC_URL に残したまま、アプリのページに専用のホスト名を与えます。FLOW_UI_ORIGIN だけの場合は、専用のホスト名ができますが、リダイレクトはされません。LEGACY_UI_HOSTS も設定すると、ページがそこへ移ります。LEGACY_UI_HOSTS には FLOW_UI_ORIGIN が必要です。アプリのページを専用のホスト名に移すを参照してください。 |
FLOW_PUBLIC_URL | 未設定 | いいえ | FLOW_UI_ORIGIN の別名です。どちらか一方を設定します。両方を設定する場合は、同じオリジンを指定する必要があります。 |
LEGACY_UI_REDIRECT_STATUS | 302 | いいえ | 移したページへのリダイレクトのステータスです。302 はキャッシュされず、301 はブラウザーに 1 時間キャッシュされます。ほかの値は 302 として扱われます。 |
CORS_ORIGIN | 空 | はい | 追加で許可するブラウザーのオリジンを、カンマ区切りで指定します。PUBLIC_URL は常に許可されます。これらのホストでは、SSO のランディングのリダイレクトが相対パスになります。パスで提供する MCP がオンの場合、PUBLIC_URL とこれらのホストが、MCP が応答するホストになります。 |
DEFAULT_LOCALE | 空(ブラウザーの言語) | はい | 新しい訪問者が最初に使う言語です。デフォルトの言語を参照してください。 |
NODARO_SURFACE_PROFILE | 空(すべてのインターフェース) | はい | Business エディションの環境で、インターフェースを絞り込みます。サーフェスプロファイルを参照してください。 |
NODARO_TUTORIAL_PACKS | 空(組み込みのチュートリアルのみ) | はい | 追加のチュートリアルパックのディレクトリを、カンマ区切りで指定します。チュートリアルパックを参照してください。 |
RUNTIME_ENV | local | いいえ | 2 つの環境が 1 つのデータベースを共有し、Redis は共有しない場合に、環境を区別する名前です。スケーリングを参照してください。Railway では、RAILWAY_ENVIRONMENT_NAME がこの値を設定します。Webhook エンドポイントは、それを作成した環境に属します。そのため、RUNTIME_ENV の名前を変えると、古い名前で作成したエンドポイントは見えなくなります。 |
PORT, HOST | 8000、0.0.0.0 | いいえ | API が待ち受ける場所です。イメージの中では、API は 9000 で待ち受け、その前段で Web サーバーが 3000 で待ち受けます。 |
NODE_ENV | development | いいえ | どのイメージでも production です。 |
シークレット
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
INTERNAL_ORCHESTRATOR_SECRET | Compose スタックでは起動時に生成 | はい | オーケストレーターを API に対して認証します。32 文字以上が必要です。Compose スタックを使わない場合は必須です。1 回限りのボイスクローンの同意記録にも署名します。値を変えると、それ以前に発行されたすべての記録が無効になります。コンテナを置き換えてもクローンしたボイスが動き続けるように、明示的に設定してください。 |
NODARO_ENCRYPTION_KEY | Compose スタックでは初回起動時に生成し、app-data ボリュームに保持 | はい | 保存する認証情報を暗号化する、64 文字の 16 進数のキーです。対象は、貼り付けたプロバイダーキー、SNS のログイントークン、Webhook 出力用に保存した HTTP の認証情報、Webhook エンドポイントの署名シークレットです。このキーがないと、Webhook エンドポイントの登録は 503 encryption_key_missing を返します。 |
SOCIAL_ENCRYPTION_KEY | 空 | はい | NODARO_ENCRYPTION_KEY の以前の名前です。どちらでも動作します。 |
シークレットは openssl rand -hex 32 で生成します。暗号化キーは、データベースと一緒にバックアップしてください。バックアップとリストアを参照してください。
データベースとログイン
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
SUPABASE_URL | Compose スタックでは http://localhost:3000/supabase | はい | API が使う Supabase の URL です。Compose スタックを使わない場合は必須です。 |
SUPABASE_SERVICE_ROLE_KEY | Compose スタックでは公開済みのデフォルトキー | はい | API が使う service-role キーです。Compose スタックを使わない場合は必須です。 |
SUPABASE_ANON_KEY | Compose スタックでは公開済みのデフォルトキー | はい | ブラウザーとログインサービスに渡す anon キーです。 |
FRONTEND_SUPABASE_URL | 同梱のスタックでは PUBLIC_URL/supabase | はい | ブラウザーが使う Supabase の URL で、起動時に /config.js に書き込まれます。マネージドの Supabase プロジェクトを使う場合に設定します。 |
SUPABASE_JWT_SECRET | 公開済みのデフォルトのシークレット | はい | 同梱のスタックで、anon キーと service-role キーに署名するシークレットです。3 つとも node tools/generate-selfhost-keys.mjs で生成します。 |
POSTGRES_PASSWORD | nodaro-postgres-pw | はい | 同梱のデータベースのパスワードです。内部ロールのパスワードがこの値に合わせられるのは、データベースの初回起動時だけです。 |
DATABASE_URL | postgres://postgres:nodaro-postgres-pw@db:5432/postgres | はい | Postgres に直接接続する URL で、起動時にマイグレーションを適用するためだけに使います。パスワードは POSTGRES_PASSWORD と一致させてください。 |
RUN_MIGRATIONS_ON_BOOT | false(Compose スタックでは true) | はい | API の起動前に supabase/migrations/ を適用します。マネージドの Supabase プロジェクトを使う場合は false にします。 |
SUPABASE_MANAGED_PROXY | 未設定 | いいえ | true にすると、マネージドの Supabase プロジェクトを、アプリ自身のオリジン経由で提供します。データベースを参照してください。 |
SUPABASE_PROXY_UPSTREAM | 未設定 | いいえ | 上記のプロキシで使う、マネージドプロジェクトのオリジンです。パスは含めません。 |
キュー
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
REDIS_URL | redis://localhost:6379(Compose スタックでは redis://redis:6379) | いいえ | キューと共有キャッシュに使う Redis です。クラスターや Sentinel の URL も使えます。 |
ストレージ
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
R2_ENDPOINT | Compose スタックでは http://minio:9000 | はい | ストレージの S3 API の URL です。Compose スタックでは、空の値は MinIO にフォールバックします。 |
R2_FORCE_PATH_STYLE | Compose スタックでは true | はい | パス形式のアドレス指定です。セルフホスティングのストレージの多くで必要です。 |
R2_ACCOUNT_ID | 空 | はい | Cloudflare のアカウント ID です。Compose スタックを使わない場合、R2_ENDPOINT が未設定なら、R2 のエンドポイントはこの値から決まります。 |
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY | 同梱の MinIO の認証情報 | はい | ストレージの認証情報です。Compose スタックでは、MinIO のルートユーザーの認証情報も兼ねます。 |
R2_BUCKET_NAME | Compose スタックでは nodaro-assets | はい | バケットです。Compose スタックを使わない場合のデフォルトは scenenode-assets なので、必ず設定してください。 |
R2_PUBLIC_URL | Compose スタックでは http://localhost:3000/storage/nodaro-assets | はい | バケットの公開 URL です。 |
R2_REGION | auto | はい | S3 のリージョンです。AWS、DigitalOcean Spaces(nyc3 など)、ローカルの Supabase(local)では、実際のリージョンを設定します。 |
STORAGE_OBJECT_ACL | 空(ACL ヘッダーなし) | はい | アップロードするすべてのオブジェクトに付ける既定 ACL です。バケットポリシーを受け付けないストレージ向けです。インストールを参照してください。 |
R2_PUBLIC_FALLBACK_DOMAIN | 空 | いいえ | メディア用の 2 つ目の公開ホストです。たとえば、CDN のドメインと並べて使う、r2.dev の生のアドレスです。 |
R2_SHARED_WITH_RELAY_TARGET | false | いいえ | R2_PUBLIC_URL が、Nodaro Cloud のホストが書き込むのと同じバケットを指している場合にだけ true にします。Nodaro Cloud に接続するを参照してください。 |
STORAGE_DELETES | on | はい | skip にすると、このインストールはストレージから何も削除しません。すべての削除はスキップされ、ログに警告 storage deletes are off on this deployment が出て、ファイルは残ります。行は削除され、リンクとストレージのクォータはこれまでどおり更新されます。メディアのストレージを別のインストールと共有し、データベースは独自のコピーを使うインストールで使います。たとえば、本番環境から復元したステージング環境です。on、未設定、または空の場合は、これまでどおり削除します。それ以外の値では、API が起動しません。反映するには再起動してください。 |
いくつかのノードは、実行が請求される前に入力を計測します。たとえば、動画のトリミング、動画をループ、動画を結合、動画の効果音、吹き替え、リップシンクです。サーバーがメディアのリンクを読み込むのは、公開アドレスからだけです。ループバックアドレスやプライベートアドレスへのリンク、またはそうしたアドレスにリダイレクトするリンクは拒否されます。例外は自分のストレージです。同梱の MinIO のように R2_PUBLIC_URL がプライベートアドレスにある場合、サーバーは保存されたファイルを最大 2 GiB までダウンロードし、ディスク上で計測します。
ストレージへ直接送る大きなアップロード
500 MB を超えるファイルは、POST /v1/uploads/large/*(SDK の uploads.uploadLarge)で、ブラウザーからバケットへ直接、分割してアップロードできます。ブラウザーは各パートを、ストアの S3 エンドポイント(R2_ENDPOINT、または R2_ACCOUNT_ID の R2 エンドポイント)にある署名付き URL へ PUT で送ります。パートがアプリを通ることはありません。それより小さいファイルは、これまでどおり POST /v1/upload を通るので、以下の設定は不要です。アプリの外で、バケットに次の 2 つを設定してください。
PUTの CORS。 この方法でアップロードするすべての Web オリジン(PUBLIC_URL、CORS_ORIGINの各エントリー、ブラウザーで SDK を使う自分のほかのサイト)から、メソッドPUTを許可します。リクエストヘッダーcontent-typeを許可します。公開する必要があるレスポンスヘッダーはありません。このルールがないと、ブラウザーのパートはプリフライトで失敗します。サーバーや、ブラウザー外の SDK には何も必要ありません。- 未完了のマルチパートアップロードを 1 日後に中止するライフサイクルルール。 このルールは必須です。アップロードの途中でブラウザーが離れると、パートがバケットに残り、アプリはそれを削除しません。パートが誰かのストレージ容量に数えられることはありませんが、領域は使います。アカウントごとに、同時に開いているアップロードは最大 3 件、1 件あたり最大 10 GiB です。Cloudflare R2 では、バケットの Settings › Object lifecycle rules › Abort incomplete multipart uploads にあります。MinIO は、古い未完了のアップロードを自動で削除します。デフォルトでは 24 時間後です(
stale_uploads_expiry設定)。1 日以内になっていることを確認してください。ほかのストアでは、同等のルールを設定します。
Cloudflare R2 では、CORS ルールはバケットの Settings › CORS policy にあります。たとえば次のとおりです。
[{ "AllowedOrigins": ["https://app.example.com"], "AllowedMethods": ["PUT"],
"AllowedHeaders": ["content-type"], "MaxAgeSeconds": 3600 }]MinIO では、バケットの CORS か、サーバーの MINIO_API_CORS_ALLOW_ORIGIN を設定します。ブラウザー自身が S3 エンドポイントに届く必要もあります。Compose スタックに同梱の MinIO では、このエンドポイントは内部向け(http://minio:9000)なので、公開しない限り、ブラウザーはこの方法でアップロードできません。そのような環境では、500 MB を超えるファイルはブラウザー外のクライアントに任せてください。アップロードポリシーを登録した環境では、この経路は閉じられ、開始は 409 large_upload_unavailable を返します。アプリを通らないバイトを、ポリシーが読めないためです。
モデルプロバイダー
これらのキーは、どれも /setup で貼り付けることもできます。環境変数で設定したキーが優先されます。プロバイダーキーを参照してください。
| 変数 | デフォルト | .env | 用途 |
|---|---|---|---|
NODARO_API_KEY | 空 | はい | 個人用 API トークンを使った、プロバイダーとしての Nodaro Cloud です。 |
KIE_API_KEY | 空 | はい | メディアとテキストのモデルを、最も幅広くカバーします。 |
KIE_API_BASE_URL | プロバイダー自身の API ホスト | はい | そのプロバイダーへの通信を、自分のプロキシ経由にします。KIE_API_KEY で動く Claude と Gemini のテキストの通信も、プロキシ経由になります。 |
REPLICATE_API_TOKEN | 空 | はい | 別のカタログです。Flux 2 のモデルも含まれます。 |
ANTHROPIC_API_KEY | 空 | はい | テキストノード用に、Claude を直接使います。 |
GEMINI_API_KEY | 空 | はい | Gemini を直接使います。Gemini のモデルを参照してください。 |
ELEVENLABS_API_KEY | 空 | はい | 音声、ボイス、吹き替えです。 |
ELEVENLABS_BASE_URL | https://api.elevenlabs.io | はい | ElevenLabs への通信を、自分のプロキシ経由にします。 |
FAL_KEY | 空 | はい | Sync Lipsync v3 などのモデルと、動画を延長の Gemini Omni Flash 1.2 エンジンです。 |
HEYGEN_API_KEY | 空 | はい | AI アバターとシネマティックアバターです。 |
BEEBLE_API_KEY | 空 | はい | リライティングと差し替えです。 |
APIFY_API_TOKEN | 空 | はい | Web スクレイピングとサイトキャプチャです。 |
SITE_CAPTURE_ENABLED | オン | いいえ | false にすると、このインストールでサイトキャプチャノード、POST /v1/site-capture、MCP ツール capture_site がオフになります。 |
HEYGEN_CATALOG_REFRESH_HOURS | 24 | いいえ | HeyGen のアバターとボイスの共有リストを更新する間隔です。 |
VOICE_LIBRARY_REFRESH_HOURS | 6 | いいえ | ライブラリの絞り込みの件数のために、ElevenLabs の共有ボイスライブラリを読み直す間隔です。ELEVENLABS_API_KEY が必要です。 |
VOICE_PREVIEW_PROXY | 未設定 | いいえ | true にすると、ボイスのプレビューを自分のホストから配信します。自分のホストからのボイスのプレビューを参照してください。 |
Nodaro Cloud への接続
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
NODARO_CLOUD_URL | https://app.nodaro.ai | はい | nodaro.ai を接続で登録する先の Nodaro Cloud のホストで、NODARO_API_KEY を使った呼び出しの送信先でもあります。変更するのは、環境が Nodaro の専用デプロイメントに属している場合だけです。起動時に読み込まれます。 |
NODARO_API_KEY と R2_SHARED_WITH_RELAY_TARGET も、接続に関わる変数です。Nodaro Cloud に接続するを参照してください。
ワーカーとパフォーマンス
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
MAX_CONCURRENT_NODES_PER_EXECUTION | 6(最大 20) | いいえ | 1 回のワークフローの実行で、同時に実行できるノードの数です。 |
VIDEO_WORKER_CONCURRENCY | 50 | いいえ | メディアワーカーの並列ジョブ数です。メディアワーカーは、主にプロバイダーの応答を待っています。 |
ORCHESTRATOR_CONCURRENCY | 20 | いいえ | オーケストレーターの並列ジョブ数です。 |
RENDER_WORKER_CONCURRENCY | 2(最大 10) | いいえ | 並列のレンダリング数です。各レンダリングは、ヘッドレス Chrome を 1 つ動かします。 |
REMOTION_CONCURRENCY | 3D シーンでは 2、それ以外のレンダリングでは CPU コア数の半分 | いいえ | 1 回のレンダリングで使うブラウザーのタブ数です。値を設定すると、両方に適用されます。複数の 3D ジョブを実行するときは、低い値にしてください。WebGL のタブはそれぞれスレッドを増やし、コンテナのプロセス数の上限に数えられます。 |
FFMPEG_CONCURRENCY | 4(最大 32) | いいえ | すべての動画とオーディオの編集ノードを通じて、同時に動かす ffmpeg のプロセス数です。 |
UV_THREADPOOL_SIZE | すべてのイメージで 16 | いいえ | Node のワーカースレッドプールのサイズです。このプールは、すべての DNS ルックアップも実行します。Node 自体のデフォルトは 4 なので、イメージの外でバックエンドを動かすときは設定してください。プロセスの起動時に読み込まれます。 |
RAILWAY_DEPLOYMENT_DRAINING_SECONDS | 未設定 | いいえ | Railway でのみ使います。置き換えるコンテナに停止シグナルを送ってから、強制停止するまでの時間です。メディアワーカーは、この時間から 5 秒を引いた時間だけドレインします。未設定の場合は、25 秒ドレインします。 |
これらの値を上げる前に、スケーリングを読んでください。
エディター
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
FREECUT_URL | 空(ホスティング版のエディター) | はい | キャンバスの NodarCut で編集と、アプリの動画の結果の編集で開く動画エディターです。off、none、false、disabled のいずれかにすると、この操作がすべての場所から取り除かれます。キャンバス、プレゼンテーション、公開したアプリのどの動画の結果にも表示されません。 |
AUDIOMASS_URL | 空(オーディオエディターなし) | はい | オーディオの結果の編集で開くオーディオエディターです。空のままだと操作は残り、設定内容を説明するパネルが開きます。off にすると、その操作がどこからも削除されます。 |
動画とオーディオのエディターを参照してください。
アップデート
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
NODARO_IMAGE | ghcr.io/nodaroai/nodaro-community:latest | はい | Compose ファイルが実行するアプリのイメージです。リリースのタグは、ここで固定します。 |
NODARO_UPDATE_CHECK | オン | いいえ | off にすると、毎日のアップデートの確認が止まり、環境から外部へのリクエストがなくなります。エアギャップ環境向けです。 |
NODARO_UPDATE_CHECK_TOKEN | 空(匿名) | いいえ | アップデートの確認に使う GitHub トークンです。スコープは不要です。 |
アップデートを参照してください。
MCP
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
MCP_ENABLED | オフ | いいえ | true または 1 にすると、MCP エンドポイントを提供します。 |
MCP_PUBLIC_URL | 空(Nodaro Cloud の MCP ホスト) | いいえ | 自分の MCP ホストの公開アドレスです。パスで提供する MCP では必要ありません。 |
MCP_DYNAMIC_REGISTRATION | allowlist | いいえ | MCP クライアントの動的クライアント登録です。allowlist、open、off のいずれかです。 |
MCP_DCR_ALLOWLIST | 既知のクライアント 14 個 | いいえ | allowlist モードで登録を許可するクライアント名です。 |
MCP_ALLOWED_CLIENT_IDS | 空(リストなし) | いいえ | MCP エンドポイントを使える開発者アプリの client_id を、カンマ区切りで指定します。設定すると、ほかのクライアントは MCP を使えず、動的登録はオフになります。不正なエントリがあると、起動が止まります。自分のクライアントだけで使う MCP を参照してください。 |
MCP_ASSERTION_EXCHANGE_CLIENT_IDS | 空(オフ) | いいえ | ID プロバイダーの署名付きアサーションを、同意画面なしで MCP トークンに交換できる、リストにあるクライアントです。アサーションの交換を参照してください。 |
MCP_ASSERTION_EXCHANGE_TOKEN_TTL_SECONDS | 3600 | いいえ | アサーションの交換で得たトークンの有効期間で、300〜86400 秒です。それ以外の値では、起動が止まります。 |
MCP_TOOLS_BUILT_ONCE | オフ | いいえ | 試験的な機能です。true にすると、MCP エンドポイントのツールを、リクエストごとに作るのではなく、リクエストの種類ごとに 1 回だけ作って保持します。応答は同じで、1 回のリクエストにかかるメモリと時間が減ります。起動時に読み取られるので、変更後は再起動してください。 |
MCP を参照してください。
ログインとロール
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
EXTERNAL_SSO_PROVIDERS | 空(SSO はオフ) | いいえ | 信頼する ID プロバイダーです。インラインの JSON か、@/path/to/file.json で指定します。形式が正しくない値の場合、起動が止まります。 |
EXTERNAL_SSO_LINK_EXISTING | false | いいえ | シングルサインオンを、既存のローカルアカウントにリンクできるかどうかです。 |
PLATFORM_OWNER_EMAIL | 空 | いいえ | Business エディション:オーナーのアカウントです。このアカウントのロールは、ほかの管理者には変更できません。 |
シングルサインオンと最初のユーザーと管理者を参照してください。
連携
| 変数 | デフォルト | .env | 内容 |
|---|---|---|---|
FIGMA_PLUGIN_OAUTH_CLIENT_ID | 空(プラグインの接続はオフ) | いいえ | Figma プラグインが接続に使う開発者アプリのクライアント ID です。 |
| SNS の変数 | 空 | いいえ | SNS のアプリを参照してください。 |
Figma プラグインを使うには、環境に開発者アプリを登録します。リダイレクト URI には <PUBLIC_URL>/v1/oauth/plugin/callback を、スコープには jobs:read、assets:read、assets:write、credits:read を指定します。そのあと、アプリのクライアント ID をこの変数に設定します。この変数が空の場合、プラグインの接続用ルートは 503 を返し、それ以外に変わることはありません。OAuth アプリを参照してください。
ビルド時の設定
これらの設定は、イメージのビルド時に決まります。Compose ファイルの build: args: で変更し、ビルドし直してください。
| ビルド引数 | デフォルト | 内容 |
|---|---|---|
VITE_EDITION | Compose ファイルでは community | エディターが表示するエディションです。空の値や不明な値では、ビルドが失敗します。 |
VITE_STUDIO_URL | https://studio.nodaro.ai | Studio で開くリンクのアドレスです。 |
VITE_PERSON_URL | https://person.nodaro.ai | ホーム画面の Person を開くカードのアドレスです。 |
動画とオーディオのエディター
キャンバスの動画の結果で NodarCut で編集を使うか、アプリの動画の結果で編集を使うと、NodarCut 動画エディターが開きます。アプリのオーディオの結果で編集を使うと、AudioMass エディターが開きます。メディアがエディターのサーバーに送られることはありません。アプリが自分のストレージからファイルを読み込み、ブラウザーの中でエディターに渡します。編集と書き出しも、ブラウザーの中で行われます。
- 動画:
FREECUT_URLが空の場合、エディターはfreecut.nodaro.aiから読み込まれます。freecut.nodaro.aiは、http://localhost:3000からの埋め込みしか許可していません。LAN のアドレスやドメインなど、ほかのオリジンではブラウザーが埋め込みを拒否し、パネルにその理由が表示されます。許可してもらうには、配信している URL を添えて GitHub でイシューを作成してください。または、自分で FreeCut を運用します。FreeCut は MIT ライセンスで公開されており、Dockerfile も含まれています。そのあと、FREECUT_URL=https://freecut.example.internalを設定します。動画エディターの操作をすべての場所から取り除くには、FREECUT_URL=offを設定します。 - オーディオ:公開されているホスティング版の AudioMass はないため、設定するまで、オーディオの結果の編集ではエディターが開きません。エディターの「プレゼン」タブ、共有したプレゼンテーション、公開アプリのどれでも、設定内容を説明するパネルが開きます。オーディオエディターの操作をどこからも削除するには、
AUDIOMASS_URL=offを設定します(none、false、disabledも使えます)。Nodaro のフォーク版 AudioMass を運用してください。フォーク版は、オリジナルの AudioMass にはない、ブラウザー内での受け渡しに対応しています。そのあと、AUDIOMASS_URL=https://audiomass.example.internalを設定します。
変更したら、スタックを再起動します。ビルドし直す必要はありません。
自分のホストからのボイスのプレビュー
ボイスの一覧である GET /v1/voices と GET /v1/voices/library は、各ボイスの preview_url を、音声プロバイダー自身のストレージのアドレスとして返します。ブラウザーのリクエストをすべてホスト名で絞り込むネットワークでは、ブラウザーがそのアドレスにアクセスできないため、どのボイスの選択画面でもプレビューを再生できません。VOICE_PREVIEW_PROXY=true を設定すると、一覧は各プレビューを自分のホスト上のアドレス /v1/voices/<voiceId>/preview?src=…&sig=… として返します。API がプロバイダーのファイルを取得して、ブラウザーにストリーミングします。
- アドレスには署名が付きます:署名の鍵は
INTERNAL_ORCHESTRATOR_SECRETから作られます。このルートが取得するのは、一覧が渡したファイルを、一覧が渡したボイスに対してだけです。それ以外には、取得する前に404を返します。 - ボイスの制限が適用されます:サーフェスプロファイルでボイスの性別を制限している場合、このルートは、ほかの性別のボイスを取得する前に
400 voice_not_availableで拒否します。ボイスの性別を参照してください。 - サイズとキャッシュ:このルートが配信するのは、4 MB 以下の
audio/*ファイルだけです。各ファイルはメモリーに 1 日、合計で 32 MB まで保持されるので、プロバイダーへの問い合わせはファイルごとに 1 回です。バイト範囲のリクエストには206で応答します。ブラウザーは、プレビューを 1 日保持します。 - MCP は変わりません:ボイスの一覧を読む MCP のツールは、引き続きプロバイダーのアドレスを受け取ります。
- 同じオリジンのみ:プレビューのアドレスはパスなので、既定のコンテナーのように、API がページと同じオリジンで応答する場合にだけ再生できます。API が別のホストで動いている場合は、この変数を設定しないでください。
- 保存済みのボイス:これらの一覧のボイスを付けて保存したキャラクターやクリーチャーは、自分のホスト上のアドレスを
voice.previewUrlとして保持します。この変数がtrueのままで、INTERNAL_ORCHESTRATOR_SECRETが変わらないあいだは、プレビューを再生できます。
有効にするのは、値がちょうど true の場合だけです。未設定の場合、一覧はこれまでどおりに応答し、/v1/voices/<voiceId>/preview は 404 を返します。この変数は nodaro サービスの environment: に追加し、再起動してください。
モデルメーカーのロゴ
GET /v1/models は各モデルのメーカーを示し、モデルピッカーを描画するアプリ向けに、メーカーのロゴを logoUrl として含めることができます。企業のロゴはその企業の商標なので、Nodaro にロゴは同梱されていません。各環境は、表示する権利を持つロゴだけを公開します。それ以外のメーカーの logoUrl は null で、アプリはメーカーの名前を表示します。ロゴを公開しない環境では、設定は不要です。
メーカーのロゴを公開するには、次のようにします。
- ファイルをアップロードします。
R2_PUBLIC_URLの背後にあるバケットのbrand/makers/<maker id>.svgに、コンテンツタイプimage/svg+xmlでアップロードします。企業の公式ロゴを、スクリプトを含まない SVG で使ってください。メーカー ID は、GET /v1/modelsが返すmaker.idの値です。 - メーカー ID を宣言します。インスタンス設定
model_maker_logosに、["google", "openai"]のようなリストで指定します。Business エディションでは、プラットフォームの運用者がPUT /v1/admin/settings/model_maker_logosに本文{"value": ["google", "openai"]}を送って設定します。管理パネルのない Community エディションでは、同じインスタンス設定をデータベースに直接書き込みます。
- サーバーが先にファイルを確認します。宣言したメーカーに
logoUrlが付くのは、そのファイルが SVG としてバケットにある場合だけです。そのため、2 つのステップはどちらの順でもかまいません。ファイルがない場合やコンテンツタイプが違う場合は、壊れたアドレスではなくnullになります。 - アップロードの確認に、アドレスをブラウザーで開かないでください。CDN と、同梱スタックの Caddy は、「見つかりません」の応答を 1 年間保持します。ファイルは、ストレージのコンソールか、
curl -IのようなHEADリクエストで確認してください。 - 反映までの時間:新しいロゴは約 10 分以内に表示されます。ロゴを差し替えるには、新しいファイルを古いファイルの上にアップロードします。アドレスはファイルに合わせて変わります。ロゴを取り下げるには、設定から ID を削除するか、ファイルを削除します。
- Nodaro がこれらのファイルを削除することはありません。ロゴを削除したいときは、ストレージのコンソールから削除してください。
デフォルトの言語
DEFAULT_LOCALE は、新しい訪問者が最初に使う言語を設定します。値は he、ar、de、fr、es、hi、ja、ko、pt-BR、ru、zh-CN、en のいずれかです。ユーザー自身が保存した選択が、常に優先されます。値が空、空白のみ、または不明な場合は、訪問者のブラウザーの言語にフォールバックします。適用するには再起動します。言語を参照してください。
チュートリアルパック
セルフホスティング環境では、ビルドし直さずに、組み込みのチュートリアルに独自のチュートリアルを追加できます。各パックは 1 つのディレクトリで、次のものを含みます。
manifest.json:パックのnameと、そのチュートリアルが使うcategoriesです。各カテゴリーにはslugとnameがあり、任意でsortOrderとdescriptionも指定できます。任意のキーはlocale、version、forbiddenPromptTerms、creatorDisplayNameです。creatorDisplayNameは、パックのすべてのカードに表示される作成者名です。- チュートリアルごとに 1 つの
*.jsonファイル:ノード、接続、作成済みの結果を含むワークフローのスナップショットです。そのため、複製すると、実行が完了した状態で開きます。カードの任意のデータとして、1 回の実行にかかるクレジットのestimatedCreditsを指定できます。料金が渡された録音の長さで決まるチュートリアルでは、estimatedPerMinuteCreditsも指定できます。その場合、estimatedCreditsは固定部分、estimatedPerMinuteCreditsは録音 1 分あたりのクレジットです。ほかに、カードのチップに表示するnodeTypesUsed、providersUsed、チュートリアルごとのcreatorDisplayName、listedInも指定できます。listedInは、チュートリアルタブ用の["tutorial"](デフォルト)か、テンプレートのマーケットプレイス用の["marketplace"]です。この値が反映されるのは、最初のシード時だけです。
チュートリアルで使うメディアファイルは、すべて公開された https:// の URL にする必要があります。各チュートリアルのカテゴリーはマニフェストで宣言する必要があり、カテゴリーは初回起動時に作成されます。
パックのディレクトリを読み取り専用でコンテナにマウントし、コンテナ内でのパスを列挙します。
nodaro:
volumes:
- ./tutorials/acme:/data/tutorials/acme:roNODARO_TUTORIAL_PACKS=/data/tutorials/acmeパックはチュートリアルを追加するだけで、組み込みのチュートリアルを変更することはありません。検証に失敗したパックは丸ごとスキップされ、ログに記録されます。検証が失敗するのは、JSON が無効な場合、宣言されていないカテゴリーがある場合、メディアの URL が公開されていない場合、スラッグが既存のチュートリアルと重複する場合です。変更したパックを読み込むには、コンテナを再起動します。
SNS のアプリ
SNS への公開は、ネットワークごとに動作します。各ネットワークは、その OAuth アプリの認証情報を設定すると使えるようになります。認証情報がない場合も、ネットワークは設定 › 連携に利用不可として表示され、不足している変数の名前も表示されます。
| ネットワーク | 変数 |
|---|---|
META_APP_ID、META_APP_SECRET。任意:ビジネス向け Facebook ログイン用の META_INSTAGRAM_CONFIG_ID。 | |
| Instagram(Facebook ページなし) | INSTAGRAM_APP_ID、INSTAGRAM_APP_SECRET。Meta は、これらを Facebook アプリとは別に発行します。トークンは約 60 日ごとに自動で更新されます。 |
META_APP_ID、META_APP_SECRET。任意:META_FACEBOOK_CONFIG_ID。 | |
| TikTok | TIKTOK_CLIENT_KEY、TIKTOK_CLIENT_SECRET |
| YouTube | GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET |
LINKEDIN_CLIENT_ID、LINKEDIN_CLIENT_SECRET | |
| X | X_CLIENT_ID、X_CLIENT_SECRET |
REDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET | |
PINTEREST_CLIENT_ID、PINTEREST_CLIENT_SECRET | |
| Discord | DISCORD_CLIENT_ID、DISCORD_CLIENT_SECRET、DISCORD_BOT_TOKEN |
| Twitch | TWITCH_CLIENT_ID、TWITCH_CLIENT_SECRET |
| Threads | THREADS_APP_ID、THREADS_APP_SECRET |
| Mastodon | MASTODON_CLIENT_ID、MASTODON_CLIENT_SECRET。任意:MASTODON_URL(デフォルトは mastodon.social)。 |
| Telegram | 不要です。ユーザーが自分のボットトークンを貼り付けます。 |
| Bluesky | 不要です。ユーザーがハンドルとアプリパスワードで接続します。 |
| Dev.to、Hashnode、Medium | 不要です。ユーザーが自分の API キーまたはトークンで接続します。 |
| WordPress | 不要です。ユーザーがサイトの URL とアプリケーションパスワードで接続します。 |
| Lemmy | 不要です。ユーザーがインスタンス、ログイン情報、コミュニティを指定して接続します。 |
どの OAuth アプリでも、リダイレクト URI https://<your-domain>/v1/social/callback/<network> を許可する必要があります。Facebook や Instagram のログインで複数のページやアカウントを管理している場合は、接続ウィンドウで、どれを接続するかをユーザーに確認します。SNS への公開を参照してください。
よくある質問
.env ファイルに書いた変数が反映されないのはなぜですか?
Compose ファイルは、nodaro サービスの environment ブロックに列挙された変数だけをアプリに渡します。それ以外の変数は、docker-compose.community.yml のそのブロックに追加してから、docker compose up -d を実行してください。
必須の環境変数はどれですか?
同梱の Compose スタックでは、必須の変数はありません。スタックが設定または生成するためです。それ以外の構成では、SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY、32 文字以上の INTERNAL_ORCHESTRATOR_SECRET がないと、API は起動しません。
変数を変更したら、再起動が必要ですか?
はい。Nodaro は起動時に環境変数を読み込むので、docker compose up -d を実行して、新しい値でコンテナを作り直してください。例外は /setup で貼り付けたプロバイダーキーで、再起動しなくても適用されます。
環境のデフォルトの言語を変えるには、どうすればよいですか?
DEFAULT_LOCALE を設定して(たとえば DEFAULT_LOCALE=de)、再起動します。新しい訪問者は、その言語で使い始めます。ユーザー自身が保存した選択が常に優先され、不明な値の場合はブラウザーの言語にフォールバックします。
セルフホスティング環境に独自のチュートリアルを追加するには、どうすればよいですか?
チュートリアルパックごとに、manifest.json と、チュートリアルごとに 1 つの JSON ファイルを入れたディレクトリを用意します。そのディレクトリをコンテナにマウントし、NODARO_TUTORIAL_PACKS に列挙します。読み込むには再起動します。
関連ページ
インストール
プロバイダーキー
エディションとサーフェスプロファイル
データベース
トラブルシューティング
最終更新