> 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

Reference for every Node.js build configuration option on Hostinger, covering Node version, framework, build script, output directory, entry file, and limits.

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 (always server mode)            |
| `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`                                           |
| 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](/api-reference/endpoints/hosting/nodejs.md)) — 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](/api-reference/endpoints/hosting/nodejs.md).

***

*Last updated: August 17, 2026*