#環境変数

#環境変数の設定方法

#Gitソースコードまたはcreate-nocobase-appでのインストール方法

プロジェクトのルートディレクトリにある .env ファイルで環境変数を設定します。環境変数を変更した後は、アプリケーションのプロセスを終了させてから再起動する必要があります。

#Dockerでのインストール方法

docker-compose.yml の設定を変更し、environment パラメータで環境変数を設定します。例：

services:
  app:
    image: nocobase/nocobase:latest
    environment:
      - APP_ENV=production

env_file を使用して、.env ファイルで環境変数を設定することもできます。例：

services:
  app:
    image: nocobase/nocobase:latest
    env_file: .env

環境変数を変更した後は、appコンテナを再構築する必要があります。

docker compose up -d app

#グローバル環境変数

#TZ

アプリケーションのタイムゾーンを設定するために使用します。デフォルトはオペレーティングシステムのタイムゾーンです。

https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

#APP_ENV

アプリケーションの環境です。デフォルト値は development で、選択可能なオプションは以下の通りです：

• production 本番環境
• development 開発環境

APP_ENV=production

#APP_KEY

アプリケーションの秘密鍵で、ユーザートークンの生成などに使用されます。独自のアプリケーションキーに変更し、外部に漏洩しないようにしてください。

APP_KEY=app-key-test

#APP_PORT

アプリケーションのポート番号です。デフォルト値は 13000 です。

APP_PORT=13000

#API_BASE_PATH

NocoBase APIアドレスのプレフィックスです。デフォルト値は /api/ です。

API_BASE_PATH=/api/

#API_BASE_URL

#CLUSTER_MODE

v1.6.0+

マルチコア（クラスター）起動モードです。この変数を設定すると、pm2 start コマンドに -i <instances> パラメータとして渡されます。オプションはpm2の -i パラメータと一致します（PM2: Cluster Mode を参照）。オプションは以下の通りです：

• max：CPUの最大コア数を使用
• -1：CPUの最大コア数 - 1を使用
• <number>：指定したコア数を使用

デフォルト値は空で、無効を意味します。

詳細はクラスターモードを参照してください。

#PLUGIN_PACKAGE_PREFIX

プラグインパッケージのプレフィックスです。デフォルトは @nocobase/plugin-,@nocobase/preset- です。

例えば、hello プラグインを my-nocobase-app プロジェクトに追加する場合、プラグインの完全なパッケージ名は @my-nocobase-app/plugin-hello となります。

PLUGIN_PACKAGE_PREFIXは以下のように設定できます：

PLUGIN_PACKAGE_PREFIX=@nocobase/plugin-,@nocobase-preset-,@my-nocobase-app/plugin-

この場合、プラグイン名とパッケージ名の対応関係は以下のようになります：

• users プラグインのパッケージ名は @nocobase/plugin-users
• nocobase プラグインのパッケージ名は @nocobase/preset-nocobase
• hello プラグインのパッケージ名は @my-nocobase-app/plugin-hello

#DB_DIALECT

データベースの種類です。選択可能なオプションは以下の通りです：

• mariadb
• mysql
• postgres

DB_DIALECT=mysql

#DB_HOST

データベースのホストです（MySQLまたはPostgreSQLデータベースを使用する場合に設定が必要です）。

デフォルト値は localhost です。

DB_HOST=localhost

#DB_PORT

データベースのポート番号です（MySQLまたはPostgreSQLデータベースを使用する場合に設定が必要です）。

• MySQL、MariaDBのデフォルトポートは3306
• PostgreSQLのデフォルトポートは5432

DB_PORT=3306

#DB_DATABASE

データベース名です（MySQLまたはPostgreSQLデータベースを使用する場合に設定が必要です）。

DB_DATABASE=nocobase

#DB_USER

データベースのユーザー名です（MySQLまたはPostgreSQLデータベースを使用する場合に設定が必要です）。

DB_USER=nocobase

#DB_PASSWORD

データベースのパスワードです（MySQLまたはPostgreSQLデータベースを使用する場合に設定が必要です）。

DB_PASSWORD=nocobase

#DB_TABLE_PREFIX

データテーブルのプレフィックスです。

DB_TABLE_PREFIX=nocobase_

#DB_UNDERSCORED

データベースのテーブル名、フィールド名をスネークケース（snake case）形式に変換するかどうかを指定します。デフォルトは false です。MySQL（MariaDB）データベースを使用し、lower_case_table_names=1 の場合、DB_UNDERSCOREDは true に設定する必要があります。

#DB_LOGGING

データベースログのスイッチです。デフォルト値は off で、選択可能なオプションは以下の通りです：

• on オン
• off オフ

DB_LOGGING=on

#DB_POOL_MAX

データベース接続プールの最大接続数です。デフォルト値は 5 です。

#DB_POOL_MIN

データベース接続プールの最小接続数です。デフォルト値は 0 です。

#DB_POOL_IDLE

データベース接続プールがアイドル状態を維持できる最大時間です。デフォルト値は 10000（10秒）です。

#DB_POOL_ACQUIRE

データベース接続プールが接続を取得しようとする最大待機時間です。デフォルト値は 60000（60秒）です。

#DB_POOL_EVICT

データベース接続プールがアイドル接続を削除するまでの時間間隔です。デフォルト値は 1000（1秒）です。

#DB_POOL_MAX_USES

接続が破棄され、置き換えられるまでに使用できる回数です。デフォルト値は 0（無制限）です。

#LOGGER_TRANSPORT

ログの出力方法です。複数指定する場合は , で区切ります。開発環境のデフォルト値は console、本番環境のデフォルト値は console,dailyRotateFile です。 選択可能なオプション：

• console - console.log
• file - ファイル
• dailyRotateFile - 日次ローテーションファイル

LOGGER_TRANSPORT=console,dailyRotateFile

#LOGGER_BASE_PATH

ファイルベースのログの保存パスです。デフォルトは storage/logs です。

LOGGER_BASE_PATH=storage/logs

#LOGGER_LEVEL

出力するログのレベルです。開発環境のデフォルト値は debug、本番環境のデフォルト値は info です。選択可能なオプション：

• error
• warn
• info
• debug
• trace

LOGGER_LEVEL=info

データベースログの出力レベルは debug で、DB_LOGGING によって出力が制御され、LOGGER_LEVEL の影響は受けません。

#LOGGER_MAX_FILES

保持するログファイルの最大数です。

• LOGGER_TRANSPORT が file の場合、デフォルト値は 10 です。
• LOGGER_TRANSPORT が dailyRotateFile の場合、[n]d で日数を表します。デフォルト値は 14d です。

LOGGER_MAX_FILES=14d

#LOGGER_MAX_SIZE

サイズによるログのローテーションです。

• LOGGER_TRANSPORT が file の場合、単位は byte で、デフォルト値は 20971520 (20 * 1024 * 1024) です。
• LOGGER_TRANSPORT が dailyRotateFile の場合、[n]k, [n]m, [n]g を使用できます。デフォルトでは設定されていません。

LOGGER_MAX_SIZE=20971520

#LOGGER_FORMAT

ログの出力形式です。開発環境のデフォルトは console、本番環境のデフォルトは json です。選択可能なオプション：

• console
• json
• logfmt
• delimiter

LOGGER_FORMAT=json

参考：ログフォーマット

#CACHE_DEFAULT_STORE

使用するキャッシュ方法の一意の識別子で、サーバーサイドのデフォルトのキャッシュ方法を指定します。デフォルト値は memory で、組み込みの選択肢は以下の通りです：

• memory
• redis

CACHE_DEFAULT_STORE=memory

#CACHE_MEMORY_MAX

メモリキャッシュの最大アイテム数です。デフォルト値は 2000 です。

CACHE_MEMORY_MAX=2000

#CACHE_REDIS_URL

Redisの接続URLです。オプションです。例：redis://localhost:6379

CACHE_REDIS_URL=redis://localhost:6379

#TELEMETRY_ENABLED

テレメトリデータ収集を有効にします。デフォルトは off です。

TELEMETRY_ENABLED=on

#TELEMETRY_METRIC_READER

有効にする監視メトリクスコレクターです。デフォルトは console です。その他の値は、対応するコレクタープラグインで登録された名前（例：prometheus）を参照してください。複数指定する場合は , で区切ります。

TELEMETRY_METRIC_READER=console,prometheus

#TELEMETRY_TRACE_PROCESSOR

有効にするトレースデータプロセッサーです。デフォルトは console です。その他の値は、対応するプロセッサープラグインで登録された名前を参照してください。複数指定する場合は , で区切ります。

TELEMETRY_TRACE_PROCESSOR=console

#SERVER_REQUEST_WHITELIST

SSRF（サーバーサイドリクエストフォージェリ）攻撃を防ぐための、サーバーから送信される HTTP リクエストの許可先ホワイトリスト。カンマ区切りで、正確な IP アドレス・CIDR 範囲・正確なホスト名・単一レベルのワイルドカードサブドメインを指定できます。

SERVER_REQUEST_WHITELIST=1.2.3.4,10.0.0.0/8,api.example.com,*.trusted.com

適用範囲：ワークフローの「HTTP リクエスト」ノードおよびカスタムリクエストアクションボタン。相対パスのリクエスト（NocoBase 自身の API 呼び出し）は対象外です。

未設定時：すべての http/https リクエストを許可（既存の動作）。設定時：ホワイトリストに一致するホストへのリクエストのみ許可し、一致しないリクエストはエラーになります。

サポートされる形式：

#実験的な環境変数

#APPEND_PRESET_LOCAL_PLUGINS

プリセットされた未アクティブなプラグインを追加するために使用します。値はプラグインのパッケージ名（package.jsonのnameパラメータ）で、複数のプラグインはカンマで区切ります。

:::info

1. プラグインがローカルにダウンロードされ、node_modules ディレクトリ内に存在することを確認してください。詳細はプラグインの構成を参照してください。
2. 環境変数を追加した後、初期インストール nocobase install またはアップグレード nocobase upgrade を実行すると、プラグイン管理ページに表示されるようになります。 :::

APPEND_PRESET_LOCAL_PLUGINS=@my-project/plugin-foo,@my-project/plugin-bar

#APPEND_PRESET_BUILT_IN_PLUGINS

組み込みでデフォルトでインストールされるプラグインを追加するために使用します。値はプラグインのパッケージ名（package.jsonのnameパラメータ）で、複数のプラグインはカンマで区切ります。

:::info

1. プラグインがローカルにダウンロードされ、node_modules ディレクトリ内に存在することを確認してください。詳細はプラグインの構成を参照してください。
2. 環境変数を追加した後、初期インストール nocobase install またはアップグレード nocobase upgrade 時にプラグインが自動的にインストールまたはアップグレードされます。 :::

APPEND_PRESET_BUILT_IN_PLUGINS=@my-project/plugin-foo,@my-project/plugin-bar

#一時的な環境変数

NocoBaseをインストールする際に、一時的な環境変数を設定してインストールを補助することができます。例：

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  INIT_ROOT_NICKNAME="Super Admin" \
  nocobase install

# 以下と同等
yarn nocobase install \
  --lang=zh-CN  \
  --root-email=demo@nocobase.com \
  --root-password=admin123 \
  --root-nickname="Super Admin"

# 以下と同等
yarn nocobase install -l zh-CN -e demo@nocobase.com -p admin123 -n "Super Admin"

#INIT_APP_LANG

インストール時の言語です。デフォルト値は en-US で、選択可能なオプションは以下の通りです：

• en-US
• zh-CN

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  nocobase install

#INIT_ROOT_EMAIL

Rootユーザーのメールアドレスです。

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  nocobase install

#INIT_ROOT_PASSWORD

Rootユーザーのパスワードです。

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  nocobase install

#INIT_ROOT_NICKNAME

Rootユーザーのニックネームです。

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  INIT_ROOT_NICKNAME="Super Admin" \
  nocobase install