# .nuxtrc

> Файл .nuxtrc задаёт настройки Nuxt плоским синтаксисом.

Файл `.nuxtrc` задаёт настройки Nuxt в плоском виде (ключ=значение). Формат совместим с [`unjs/rc9`](https://github.com/unjs/rc9).

<tip>

Для более сложной конфигурации используйте [`nuxt.config`](/docs/3.x/directory-structure/nuxt-config).

</tip>

## Использование

```bash [.nuxtrc]
# отключить SSR
ssr=false

# настройки для `@nuxt/devtools`
devtools.enabled=true

# подключить модули Nuxt
modules[]=@nuxt/image
modules[]=nuxt-security

# настройки модулей (Nuxt добавляет автоматически)
setups.@nuxt/test-utils="3.23.0"
```

Если есть `nuxt.config`, его поля переопределяют значения из `.nuxtrc`.

<note>

Nuxt автоматически добавляет секцию `setups`, чтобы отслеживать установку и обновление модулей. Она используется внутренне для [хуков жизненного цикла модулей](/docs/3.x/api/kit/modules#using-lifecycle-hooks-for-module-installation-and-upgrade) и не должна изменяться вручную.

</note>

<read-more to="/docs/3.x/api/configuration/nuxt-config">

Все доступные опции описаны в документации **конфигурации Nuxt**.

</read-more>

## Глобальный файл `.nuxtrc`

Можно создать глобальный `.nuxtrc` в домашнем каталоге, чтобы применять настройки ко всем проектам.

- На macOS/Linux файл лежит по пути:```md
~/.nuxtrc
```
- В Windows:```md
C:\Users\{username}\.nuxtrc
```

Глобальный `.nuxtrc` задаёт значения по умолчанию для всех проектов Nuxt на этой машине. Его переопределяет `.nuxtrc` в каталоге проекта, а высший приоритет у `nuxt.config`.
