Налаштування

Налаштування pnpm поділяються на дві категорії:

  • Налаштування автентифікації та сертифіката зберігаються у файлах INI. Вони містять конфіденційні облікові дані та не повинні зберігатися у вашому репозиторії. Див. Налаштування автентифікації для отримання детальної інформації.
  • Усі інші налаштування зберігаються у файлах YAML: проєкт — pnpm-workspace.yaml та глобальний —<1>config.yaml</1>.

pnpm також більше не зчитує налаштування з поля pnpm файлу package.json. Налаштування повинні бути визначені в pnpm-workspace.yaml.

Конфігурація локального проєкту#

Налаштування рівня проєкту знаходяться у pnpm-workspace.yaml:

pnpm-workspace.yaml
nodeVersion: "22"
saveExact: true

Глобальні налаштування#

Глобальний файл конфігурації YAML (config.yaml) розташований в одному з наступних шляхів:

  • Якщо встановлено змінну $XDG_CONFIG_HOME env, то $XDG_CONFIG_HOME/pnpm/config.yaml
  • У Windows: ~/AppData/Local/pnpm/config/config.yaml
  • У macOS: ~/Library/Preferences/pnpm/config.yaml
  • У Linux: ~/.config/pnpm/config.yaml

Глобальний файл rc (лише для налаштувань реєстру та автентифікації) знаходиться за адресою:

  • Якщо встановлено змінну середовища $XDG_CONFIG_HOME, тоді $XDG_CONFIG_HOME/pnpm/rc
  • У Windows: ~/AppData/Local/pnpm/config/rc
  • У macOS: ~/Library/Preferences/pnpm/rc
  • У Linux: ~/.config/pnpm/rc

Змінні середовища#

Змінні середовища, чиї імена починаються з pnpm_config_ (або PNPM_CONFIG_), завантажуються в конфігурацію. Ці налаштування замінюють налаштування з pnpm-workspace.yaml, але не аргументи CLI.

попередження

pnpm більше не читає змінні середовища npm_config_*. Використовуйте замість цього змінні середовища pnpm_config_* (наприклад, pnpm_config_registry замість npm_config_registry).

Наприклад:

pnpm_config_save_exact=true pnpm add foo

Якщо вам потрібно, щоб pnpm працював на декількох жорстких дисках або файлових системах, прочитайте ЧаПи.

Див. команду config для отримання додаткової інформації про керування конфігурацією.