> For the complete documentation index, see [llms.txt](https://docs.hostinger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostinger.com/node.js/build-settings.md).

# Build Settings

Every Node.js build configuration option, available in hPanel and the API.

## Node.js version

| Value | Description                |
| ----- | -------------------------- |
| `18`  | Node.js 18                 |
| `20`  | Node.js 20 (LTS)           |
| `22`  | Node.js 22 (LTS) — default |
| `24`  | Node.js 24                 |

Pick the version in your project's `engines` field in `package.json`, or the one you develop with. LTS recommended for production. Projects declaring a version older than 18 build on Node 18 instead.

## Application type

The framework. Helps Hostinger pick sensible defaults. Full list with per-framework setup: [Supported Frameworks](/node.js/overview-1.md).

| Value              | Use for                                 |
| ------------------ | --------------------------------------- |
| `next`             | Next.js (static or SSR)                 |
| `nuxt`             | Nuxt.js (static or SSR)                 |
| `nitro`            | Nitro                                   |
| `astro`            | Astro (static or SSR)                   |
| `svelte-kit`       | SvelteKit (static or SSR)               |
| `svelte`           | Svelte                                  |
| `react`            | React + Vite                            |
| `create-react-app` | Create React App                        |
| `react-router`     | React Router (framework mode)           |
| `gatsby`           | Gatsby                                  |
| `vue`              | Vue + Vite                              |
| `angular`          | Angular                                 |
| `vite`             | Vite (framework-agnostic, incl. Preact) |
| `parcel`           | Parcel                                  |
| `express`          | Express.js                              |
| `nest`             | NestJS                                  |
| `fastify`          | Fastify                                 |
| `hono`             | Hono                                    |
| `other`            | Any other Node.js project               |
| (auto-detect)      | Detect from `package.json`              |

## Root directory

Directory containing `package.json`, relative to the source root.

* Use `/` or leave empty if it's at the root.
* Use a subdirectory (`apps/web`) for monorepos — auto-detected on import; only that subdirectory is built.

## Build script

The npm script to run during the build phase (e.g., `build`). Matches a script in `package.json`:

```json
{
  "scripts": {
    "build": "next build"
  }
}
```

Leave empty for apps without a build step.

## Output directory

Where built files land, relative to the app root.

| Framework                         | Typical output                                    |
| --------------------------------- | ------------------------------------------------- |
| Next.js                           | `.next` (SSR) or `out` (`output: 'export'`)       |
| Nuxt.js / Nitro                   | `.output` (SSR) or `dist` (generate)              |
| Astro                             | `dist`                                            |
| SvelteKit                         | `build` (adapter-node) or `dist` (adapter-static) |
| Svelte                            | `dist`                                            |
| React / Vue / Preact (Vite)       | `dist`                                            |
| Create React App / React Router   | `build`                                           |
| Gatsby                            | `public`                                          |
| Angular                           | `dist/<project-name>`                             |
| Parcel                            | `dist`                                            |
| Express / NestJS / Fastify / Hono | `dist` (or none)                                  |

For server apps, this is the compiled server code. For static sites, the HTML/CSS/JS to serve.

## Entry file

For server apps, the file Node runs to start your server — relative to the app root. Must end in `.js`, `.mjs`, or `.cjs`.

Examples: `server.js`, `index.js`, `dist/main.js`, `server/index.mjs`.

Leave empty for static sites.

## Package manager

| Value  | Description |
| ------ | ----------- |
| `npm`  | Default     |
| `yarn` | Yarn        |
| `pnpm` | pnpm        |

Auto-detected from lockfiles (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`). Override if needed.

## Source type

| Value     | Description               |
| --------- | ------------------------- |
| `archive` | From an uploaded archive  |
| `git`     | From a connected Git repo |

## Archive path

When `source_type` is `archive`, path to the archive relative to `public_html`.

Supported: `.zip`, `.tar`, `.tar.gz`, `.tgz`, `.gz`, `.7z`. (The hPanel uploader accepts `.zip`, `.tar`, `.tar.gz`, `.tgz`.)

Example: `myapp.zip` or `uploads/myproject.tar.gz`.

## Auto-detecting settings

Not sure what to fill in? Let Hostinger detect from your `package.json`.

* **hPanel:** settings are detected automatically when you import a repository or upload an archive; review them on the deploy settings screen.
* **API:** use the Get Build Settings from Archive / from Repository endpoints (see the [API reference](https://developers.hostinger.com/)) — they return framework, Node version, output directory, and available scripts.

## Build limits

* One deployment runs at a time per site; additional builds queue (up to 20 pending).
* Dependency installation and the build script each have a **15-minute** time limit.
* Logs from the **last 10 builds** are kept.

## Build logs

Every build produces a log:

* Dependency installation
* Build script output
* Errors and warnings
* Success/failure status

View them under **Deployments** in hPanel (see [Deployments](/node.js/deployments.md)), or fetch them via the [API](https://developers.hostinger.com/).

***

*Last updated: July 22, 2026*