環境変数の設定と反映

API キーやデータベース接続情報などは、コードに書かず環境変数としてプロジェクトに設定します。環境変数は、プロジェクト詳細ページを下にスクロールしたところにある 環境変数 で管理します。

環境変数を追加する

1. プロジェクト詳細を開き、下にスクロールして 環境変数 を表示する
2. 新しい変数を追加 を押し、キーと値を入力する
3. 必要に応じて シークレット にチェックを入れて 追加 する

• 1 プロジェクトに登録できるのは 最大 45 個 です
• 1 つの値の上限は 64KB です
• 環境変数を編集できるのは、ワークスペースのオーナー・管理者・開発者です（閲覧者には環境変数の欄が表示されません）

シークレットについて

シークレット にチェックを入れた変数は、追加後に値を表示できなくなります（画面上は •••••••• 表示）。API キーやパスワードなど、他のメンバーに見せる必要のない値はシークレットにしてください。

.env ファイルからまとめて取り込む

.env取込 ボタンで、手元の .env / .env.local / .env.production などのファイルを読み込み、未登録のキーだけを一括追加できます。取り込み後に必要な変数をシークレットへ変更することもできます。

重要: 「保存」と「反映」は別の操作です

環境変数を追加・編集した時点では、稼働中のアプリにはまだ反映されていません。保存後に表示されるバナーの案内に従って、次のどちらかを実行してください。

ビルド時変数は再デプロイ（再ビルド）が必要

NEXT_PUBLIC_ / VITE_ / REACT_APP_ / NUXT_PUBLIC_ / PUBLIC_ で始まる変数は、ビルド時にアプリへ埋め込まれます。これらを変更した場合、「AppRunに設定を反映」では反映されず、再ビルドが必要です。GitHub 連携のプロジェクトでデプロイ権限がある場合は、画面のバナーに 再ビルドする ボタンが出るので、そこから実行できます。ZIP アップロードのプロジェクトではボタンが出ないので、プロジェクト詳細の 再デプロイ から ZIP を上げ直してください。

まだ一度もデプロイしていない場合

デプロイ履歴がないプロジェクトでは反映先がないため、環境変数はデプロイの実行時に反映されます。

バージョン切り替え（ロールバック）との関係

プロジェクトを過去のバージョンに切り替えると、動いているアプリが読み込む環境変数も、そのバージョンを作ったときの値に戻ります。画面に並んでいる環境変数は保存された最新の内容のままなので、切り替えたあとは両者がずれていないか確認してください。

よくある質問

Q. 反映されたか確認したい

反映が完了すると「AppRunへの設定反映が完了しました」と通知されます。変更がない状態で実行した場合は「反映する変更はありません」と表示されます。

Q. 上限の 45 個を超えたい

現在の上限は 45 個です。整理してもなお不足する場合はお問い合わせください。