設定

このページは、セルフホスティングの 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 は起動せず、不足している変数や無効な変数を一覧表示します。

インスタンス

シークレット

シークレットは openssl rand -hex 32 で生成します。暗号化キーは、データベースと一緒にバックアップしてください。バックアップとリストアを参照してください。

データベースとログイン

キュー

ストレージ

モデルプロバイダー

これらのキーは、どれも /setup で貼り付けることもできます。環境変数で設定したキーが優先されます。プロバイダーキーを参照してください。

Nodaro Cloud への接続

NODARO_API_KEY と R2_SHARED_WITH_RELAY_TARGET も、接続に関わる変数です。Nodaro Cloud に接続するを参照してください。

ワーカーとパフォーマンス

これらの値を上げる前に、スケーリングを読んでください。

エディター

動画とオーディオのエディターを参照してください。

アップデート

アップデートを参照してください。

MCP

MCP を参照してください。

ログインとロール

シングルサインオンと最初のユーザーと管理者を参照してください。

連携

Figma プラグインを使うには、環境に開発者アプリを登録します。リダイレクト URI には <PUBLIC_URL>/v1/oauth/plugin/callback を、スコープには jobs:read、assets:read、assets:write、credits:read を指定します。そのあと、アプリのクライアント ID をこの変数に設定します。この変数が空の場合、プラグインの接続用ルートは 503 を返し、それ以外に変わることはありません。OAuth アプリを参照してください。

ビルド時の設定

これらの設定は、イメージのビルド時に決まります。Compose ファイルの build: args: で変更し、ビルドし直してください。

動画とオーディオのエディター

動画の結果で Edit video を使うと NodarCut 動画エディターが、オーディオの結果で Edit audio を使うと AudioMass エディターが開きます。メディアがエディターのサーバーに送られることはありません。アプリが自分のストレージからファイルを読み込み、ブラウザーの中でエディターに渡します。編集と書き出しも、ブラウザーの中で行われます。

• 動画：FREECUT_URL が空の場合、エディターは freecut.nodaro.ai から読み込まれます。freecut.nodaro.ai は、http://localhost:3000 からの埋め込みしか許可していません。LAN のアドレスやドメインなど、ほかのオリジンではブラウザーが埋め込みを拒否し、パネルにその理由が表示されます。許可してもらうには、配信している URL を添えて GitHub で issue を作成してください。または、自分で FreeCut を運用します。FreeCut は MIT ライセンスで公開されており、Dockerfile も含まれています。そのあと、FREECUT_URL=https://freecut.example.internal を設定します。
• オーディオ：公開されているホスティング版の AudioMass はないため、設定するまで、Edit audio には設定内容を説明するパネルだけが表示されます。Nodaro のフォーク版 AudioMass を運用してください。フォーク版は、オリジナルの AudioMass にはない、ブラウザー内での受け渡しに対応しています。そのあと、AUDIOMASS_URL=https://audiomass.example.internal を設定します。

変更したら、スタックを再起動します。ビルドし直す必要はありません。

デフォルトの言語

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 ファイル：ノード、接続、作成済みの結果を含むワークフローのスナップショットです。そのため、複製すると、実行が完了した状態で開きます。カードの任意のデータとして、カードのチップに表示する estimatedCredits、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 アプリの認証情報を設定すると使えるようになります。認証情報がない場合も、ネットワークは設定 › 連携に利用不可として表示され、不足している変数の名前も表示されます。

どの OAuth アプリでも、リダイレクト URI https://<your-domain>/v1/social/callback/<network> を許可する必要があります。Facebook や Instagram のログインで複数のページやアカウントを管理している場合は、接続ウィンドウで、どれを接続するかをユーザーに確認します。SNS への公開を参照してください。