# 環境変数を読み込んでコマンド実行
dotenvx run -- node index.js

# 特定の .env ファイルを指定
dotenvx run -f .env.production -- npm start

# 複数ファイル読み込み（後が優先）
dotenvx run -f .env -f .env.local -- npm start

# 環境変数を取得
dotenvx get DATABASE_URL

# 全環境変数を表示
dotenvx get

暗号化

# .env を暗号化（DOTENV_PUBLIC_KEY, DOTENV_PRIVATE_KEY 生成）
dotenvx encrypt

# 特定ファイルを暗号化
dotenvx encrypt -f .env.production

# 復号化
dotenvx decrypt

# 暗号化されたファイルを実行（DOTENV_PRIVATE_KEY が必要）
dotenvx run -- node index.js

暗号化の仕組み

dotenvx encrypt 実行で公開鍵/秘密鍵ペアを生成
DOTENV_PUBLIC_KEY: .env ファイル内に保存（暗号化用）
DOTENV_PRIVATE_KEY: ローカル環境または CI に設定（復号化用）
環境別: DOTENV_PRIVATE_KEY_PRODUCTION で自動判定

オプション

オプション	説明
`-f, --env-file`	.env ファイル指定
`--overload`	後続ファイルで上書き
`--quiet`	出力抑制
`--verbose`	詳細表示
`--debug`	デバッグ情報表示

複数環境の管理

.env                 # 共通設定
.env.local           # ローカル上書き（gitignore）
.env.production      # 本番環境
.env.development     # 開発環境

# 本番環境で実行
dotenvx run -f .env.production -- npm start

# 開発 + ローカル上書き
dotenvx run -f .env.development -f .env.local -- npm run dev

GitHub Actions

curl でインストール。完全な例は assets/gh_action_example.yaml を参照。

steps:
  - uses: actions/checkout@v4

  - name: Install dotenvx
    run: curl -sfS https://dotenvx.sh | sh

  - name: Run tests
    env:
      DOTENV_PRIVATE_KEY: ${{ secrets.DOTENV_PRIVATE_KEY }}
    run: dotenvx run -- npm test

暗号化

暗号化の仕組み

オプション

複数環境の管理

GitHub Actions

参考

dotenvx

dotenvx Skill

インストール

基本コマンド