NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較

設定

セルフホスティングの 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 -d

Nodaro は、起動時に環境変数を読み込みます。唯一の例外は /setup で貼り付けたプロバイダーキーで、これはすぐに適用されます。Compose スタックを使わない場合は、利用しているプラットフォームの環境変数の設定で変数を設定します。

Compose スタックを使わない場合に必須の変数:SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY、INTERNAL_ORCHESTRATOR_SECRET です。これらがないと、API は起動せず、不足している変数や無効な変数を一覧表示します。

インスタンス

変数デフォルト.env内容
EDITIONcommunityいいえcommunity、business、cloud のいずれかです。Compose ファイルでは community に固定されています。エディションとサーフェスプロファイルを参照してください。
PUBLIC_URLhttp://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_STATUS302いいえ移したページへのリダイレクトのステータスです。302 はキャッシュされず、301 はブラウザーに 1 時間キャッシュされます。ほかの値は 302 として扱われます。
CORS_ORIGIN空はい追加で許可するブラウザーのオリジンを、カンマ区切りで指定します。PUBLIC_URL は常に許可されます。これらのホストでは、SSO のランディングのリダイレクトが相対パスになります。パスで提供する MCP がオンの場合、PUBLIC_URL とこれらのホストが、MCP が応答するホストになります。
DEFAULT_LOCALE空(ブラウザーの言語)はい新しい訪問者が最初に使う言語です。デフォルトの言語を参照してください。
NODARO_SURFACE_PROFILE空(すべてのインターフェース)はいBusiness エディションの環境で、インターフェースを絞り込みます。サーフェスプロファイルを参照してください。
NODARO_TUTORIAL_PACKS空(組み込みのチュートリアルのみ)はい追加のチュートリアルパックのディレクトリを、カンマ区切りで指定します。チュートリアルパックを参照してください。
RUNTIME_ENVlocalいいえ2 つの環境が 1 つのデータベースを共有し、Redis は共有しない場合に、環境を区別する名前です。スケーリングを参照してください。Railway では、RAILWAY_ENVIRONMENT_NAME がこの値を設定します。Webhook エンドポイントは、それを作成した環境に属します。そのため、RUNTIME_ENV の名前を変えると、古い名前で作成したエンドポイントは見えなくなります。
PORT, HOST8000、0.0.0.0いいえAPI が待ち受ける場所です。イメージの中では、API は 9000 で待ち受け、その前段で Web サーバーが 3000 で待ち受けます。
NODE_ENVdevelopmentいいえどのイメージでも production です。

シークレット

変数デフォルト.env内容
INTERNAL_ORCHESTRATOR_SECRETCompose スタックでは起動時に生成はいオーケストレーターを API に対して認証します。32 文字以上が必要です。Compose スタックを使わない場合は必須です。1 回限りのボイスクローンの同意記録にも署名します。値を変えると、それ以前に発行されたすべての記録が無効になります。コンテナを置き換えてもクローンしたボイスが動き続けるように、明示的に設定してください。
NODARO_ENCRYPTION_KEYCompose スタックでは初回起動時に生成し、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_URLCompose スタックでは http://localhost:3000/supabaseはいAPI が使う Supabase の URL です。Compose スタックを使わない場合は必須です。
SUPABASE_SERVICE_ROLE_KEYCompose スタックでは公開済みのデフォルトキーはいAPI が使う service-role キーです。Compose スタックを使わない場合は必須です。
SUPABASE_ANON_KEYCompose スタックでは公開済みのデフォルトキーはいブラウザーとログインサービスに渡す 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_PASSWORDnodaro-postgres-pwはい同梱のデータベースのパスワードです。内部ロールのパスワードがこの値に合わせられるのは、データベースの初回起動時だけです。
DATABASE_URLpostgres://postgres:nodaro-postgres-pw@db:5432/postgresはいPostgres に直接接続する URL で、起動時にマイグレーションを適用するためだけに使います。パスワードは POSTGRES_PASSWORD と一致させてください。
RUN_MIGRATIONS_ON_BOOTfalse(Compose スタックでは true)はいAPI の起動前に supabase/migrations/ を適用します。マネージドの Supabase プロジェクトを使う場合は false にします。
SUPABASE_MANAGED_PROXY未設定いいえtrue にすると、マネージドの Supabase プロジェクトを、アプリ自身のオリジン経由で提供します。データベースを参照してください。
SUPABASE_PROXY_UPSTREAM未設定いいえ上記のプロキシで使う、マネージドプロジェクトのオリジンです。パスは含めません。

キュー

変数デフォルト.env内容
REDIS_URLredis://localhost:6379(Compose スタックでは redis://redis:6379)いいえキューと共有キャッシュに使う Redis です。クラスターや Sentinel の URL も使えます。

ストレージ

変数デフォルト.env内容
R2_ENDPOINTCompose スタックでは http://minio:9000はいストレージの S3 API の URL です。Compose スタックでは、空の値は MinIO にフォールバックします。
R2_FORCE_PATH_STYLECompose スタックでは trueはいパス形式のアドレス指定です。セルフホスティングのストレージの多くで必要です。
R2_ACCOUNT_ID空はいCloudflare のアカウント ID です。Compose スタックを使わない場合、R2_ENDPOINT が未設定なら、R2 のエンドポイントはこの値から決まります。
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY同梱の MinIO の認証情報はいストレージの認証情報です。Compose スタックでは、MinIO のルートユーザーの認証情報も兼ねます。
R2_BUCKET_NAMECompose スタックでは nodaro-assetsはいバケットです。Compose スタックを使わない場合のデフォルトは scenenode-assets なので、必ず設定してください。
R2_PUBLIC_URLCompose スタックでは http://localhost:3000/storage/nodaro-assetsはいバケットの公開 URL です。
R2_REGIONautoはいS3 のリージョンです。AWS、DigitalOcean Spaces(nyc3 など)、ローカルの Supabase(local)では、実際のリージョンを設定します。
STORAGE_OBJECT_ACL空(ACL ヘッダーなし)はいアップロードするすべてのオブジェクトに付ける既定 ACL です。バケットポリシーを受け付けないストレージ向けです。インストールを参照してください。
R2_PUBLIC_FALLBACK_DOMAIN空いいえメディア用の 2 つ目の公開ホストです。たとえば、CDN のドメインと並べて使う、r2.dev の生のアドレスです。
R2_SHARED_WITH_RELAY_TARGETfalseいいえR2_PUBLIC_URL が、Nodaro Cloud のホストが書き込むのと同じバケットを指している場合にだけ true にします。Nodaro Cloud に接続するを参照してください。
STORAGE_DELETESonはい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 つを設定してください。

  1. PUT の CORS。 この方法でアップロードするすべての Web オリジン(PUBLIC_URL、CORS_ORIGIN の各エントリー、ブラウザーで SDK を使う自分のほかのサイト)から、メソッド PUT を許可します。リクエストヘッダー content-type を許可します。公開する必要があるレスポンスヘッダーはありません。このルールがないと、ブラウザーのパートはプリフライトで失敗します。サーバーや、ブラウザー外の SDK には何も必要ありません。
  2. 未完了のマルチパートアップロードを 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_URLhttps://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_HOURS24いいえHeyGen のアバターとボイスの共有リストを更新する間隔です。
VOICE_LIBRARY_REFRESH_HOURS6いいえライブラリの絞り込みの件数のために、ElevenLabs の共有ボイスライブラリを読み直す間隔です。ELEVENLABS_API_KEY が必要です。
VOICE_PREVIEW_PROXY未設定いいえtrue にすると、ボイスのプレビューを自分のホストから配信します。自分のホストからのボイスのプレビューを参照してください。

Nodaro Cloud への接続

変数デフォルト.env内容
NODARO_CLOUD_URLhttps://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_EXECUTION6(最大 20)いいえ1 回のワークフローの実行で、同時に実行できるノードの数です。
VIDEO_WORKER_CONCURRENCY50いいえメディアワーカーの並列ジョブ数です。メディアワーカーは、主にプロバイダーの応答を待っています。
ORCHESTRATOR_CONCURRENCY20いいえオーケストレーターの並列ジョブ数です。
RENDER_WORKER_CONCURRENCY2(最大 10)いいえ並列のレンダリング数です。各レンダリングは、ヘッドレス Chrome を 1 つ動かします。
REMOTION_CONCURRENCY3D シーンでは 2、それ以外のレンダリングでは CPU コア数の半分いいえ1 回のレンダリングで使うブラウザーのタブ数です。値を設定すると、両方に適用されます。複数の 3D ジョブを実行するときは、低い値にしてください。WebGL のタブはそれぞれスレッドを増やし、コンテナのプロセス数の上限に数えられます。
FFMPEG_CONCURRENCY4(最大 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_IMAGEghcr.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_REGISTRATIONallowlistいいえ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_SECONDS3600いいえアサーションの交換で得たトークンの有効期間で、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_EXISTINGfalseいいえシングルサインオンを、既存のローカルアカウントにリンクできるかどうかです。
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_EDITIONCompose ファイルでは communityエディターが表示するエディションです。空の値や不明な値では、ビルドが失敗します。
VITE_STUDIO_URLhttps://studio.nodaro.aiStudio で開くリンクのアドレスです。
VITE_PERSON_URLhttps://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 で、アプリはメーカーの名前を表示します。ロゴを公開しない環境では、設定は不要です。

メーカーのロゴを公開するには、次のようにします。

  1. ファイルをアップロードします。R2_PUBLIC_URL の背後にあるバケットの brand/makers/<maker id>.svg に、コンテンツタイプ image/svg+xml でアップロードします。企業の公式ロゴを、スクリプトを含まない SVG で使ってください。メーカー ID は、GET /v1/models が返す maker.id の値です。
  2. メーカー 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:ro
NODARO_TUTORIAL_PACKS=/data/tutorials/acme

パックはチュートリアルを追加するだけで、組み込みのチュートリアルを変更することはありません。検証に失敗したパックは丸ごとスキップされ、ログに記録されます。検証が失敗するのは、JSON が無効な場合、宣言されていないカテゴリーがある場合、メディアの URL が公開されていない場合、スラッグが既存のチュートリアルと重複する場合です。変更したパックを読み込むには、コンテナを再起動します。

SNS のアプリ

SNS への公開は、ネットワークごとに動作します。各ネットワークは、その OAuth アプリの認証情報を設定すると使えるようになります。認証情報がない場合も、ネットワークは設定 › 連携に利用不可として表示され、不足している変数の名前も表示されます。

ネットワーク変数
InstagramMETA_APP_ID、META_APP_SECRET。任意:ビジネス向け Facebook ログイン用の META_INSTAGRAM_CONFIG_ID。
Instagram(Facebook ページなし)INSTAGRAM_APP_ID、INSTAGRAM_APP_SECRET。Meta は、これらを Facebook アプリとは別に発行します。トークンは約 60 日ごとに自動で更新されます。
FacebookMETA_APP_ID、META_APP_SECRET。任意:META_FACEBOOK_CONFIG_ID。
TikTokTIKTOK_CLIENT_KEY、TIKTOK_CLIENT_SECRET
YouTubeGOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET
LinkedInLINKEDIN_CLIENT_ID、LINKEDIN_CLIENT_SECRET
XX_CLIENT_ID、X_CLIENT_SECRET
RedditREDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET
PinterestPINTEREST_CLIENT_ID、PINTEREST_CLIENT_SECRET
DiscordDISCORD_CLIENT_ID、DISCORD_CLIENT_SECRET、DISCORD_BOT_TOKEN
TwitchTWITCH_CLIENT_ID、TWITCH_CLIENT_SECRET
ThreadsTHREADS_APP_ID、THREADS_APP_SECRET
MastodonMASTODON_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 に列挙します。読み込むには再起動します。

インストール

Nodaro のセルフホスティング環境を順を追ってインストールします。リポジトリのクローン、.env、シークレット、マイグレーション、オブジェクトストレージの設定から、スタックの起動、ログイン、セキュリティの強化までを説明します。

プロバイダーキー

セルフホスティング環境の Nodaro に、モデルプロバイダーのキーを /setup か .env で設定します。どのキーでどのノードが動くかと、プロバイダーへの通信を自分のプロキシ経由にする方法も説明します。

エディションとサーフェスプロファイル

Community、Business、Cloud のエディションを比較し、セルフホスティングの Nodaro を Business に切り替えます。NODARO_SURFACE_PROFILE でインターフェイスを絞り込む方法も説明します。

データベース

セルフホスティング環境の Nodaro を、同梱の Supabase スタックかマネージドの Supabase プロジェクトで動かします。マイグレーションの適用方法と、データベースのキーとパスワードの保護も説明します。

トラブルシューティング

セルフホスティングの Nodaro でよくある問題を、/setup から順に解決します。起動エラー、ポート、CORS、マイグレーション、ストレージ、キュー、キーについて、症状と対処法をまとめています。

最終更新

目次