---
title: "Configuration"
description: "Where each setting lives: the module options in nuxt.config.ts, the environment variables, and the app config content layer."
canonical_url: "https://nuxt-backend.dev/docs/reference/configuration"
---
# Configuration

> Where each setting lives: the module options in nuxt.config.ts, the environment variables, and the app config content layer.

All options have sensible defaults, and environment variables are picked up automatically. The minimal config is just the module:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  modules: ['nuxt-backend'],
})
```

Three places configure an app, each with one page:

<card-group>
<card icon="i-lucide-settings" title="Module options" to="https://nuxt-backend.dev/docs/reference/configuration/module-options">

The `backend` key in `nuxt.config.ts`: every option, its default, and the runtime config the module publishes.

</card>

<card icon="i-lucide-key-round" title="Environment variables" to="https://nuxt-backend.dev/docs/reference/configuration/environment-variables">

What `.env.local` holds, the variables the deployment declares, and how `env push` sets them.

</card>

<card icon="i-lucide-palette" title="App config" to="https://nuxt-backend.dev/docs/ui/customize">

`appConfig.backend`: the plan catalog, labels and brand the packaged pages read.

</card>
</card-group>

The auth route is configured in [Auth setup](https://nuxt-backend.dev/docs/auth/setup#auth-route-and-options), where the
three places it has to match are listed together.


## Sitemap

See the full [sitemap](https://nuxt-backend.dev/sitemap.md) for all pages.