2021-06-14 12:31:30 +00:00
# Custom build preset (advanced)
2021-10-11 17:18:38 +00:00
Get full control of Nuxt Nitro output to deploy on any kind of hosting platform.
2021-06-14 12:31:30 +00:00
2021-10-11 17:18:38 +00:00
::list{type=info}
2021-10-29 11:26:01 +00:00
2021-10-11 17:18:38 +00:00
- Allows full customization
- This is an advanced usage pattern
::
::alert{icon=IconPresets}
Back to [presets list ](/docs/deployment/presets ).
::
## Setup
2021-06-14 12:31:30 +00:00
2021-11-21 12:31:44 +00:00
You can create your own custom-built preset. See [the provided presets ](https://github.com/nuxt/framework/blob/main/packages/nitro/src/presets ) for examples.
2021-06-14 12:31:30 +00:00
2021-10-11 17:18:38 +00:00
### Inline preset definition
2021-06-14 12:31:30 +00:00
You can define everything that a custom preset would configure directly in the Nitro options:
2021-10-13 08:58:28 +00:00
```ts [nuxt.config.js|ts]
2021-06-14 12:31:30 +00:00
export default {
nitro: {
2021-10-11 17:18:38 +00:00
// preset options
2021-06-14 12:31:30 +00:00
}
}
```
2021-10-11 17:18:38 +00:00
### Reusable preset
2021-06-14 12:31:30 +00:00
You can also define a preset in a separate file (or publish as a separate npm package).
```ts [my-preset/index.ts]
import type { NitroPreset } from '@nuxt/nitro'
const myPreset: NitroPreset = {
// Your custom configuration
}
export default myPreset
```
Then in your `nuxt.config` you can specify that Nitro should use your custom preset:
2021-10-13 08:58:28 +00:00
```ts [nuxt.config.js|ts]
2021-06-14 12:31:30 +00:00
import { resolve } from 'path'
export default {
nitro: {
preset: resolve(__dirname, 'my-preset')
}
}
```