How to Host a Next.js Application on Vertra Cloud

Requirements

Node.js 18+ installed locally
Account on Vertra Cloud

Project Structure

my-app-next/
├── src/
│   ├── app/
│   │   ├── layout.tsx
│   │   └── page.tsx
│   └── components/
├── public/
├── next.config.js
├── package.json
└── vertracloud.config

Configuration

next.config.js

For deployment on Vertra Cloud, configure standalone mode to optimize build size:

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone',
};

module.exports = nextConfig;

package.json

{
  "name": "my-app-next",
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start -p 80"
  },
  "dependencies": {
    "next": "^14.0.0",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

vertracloud.config

MAIN=package.json
BUILD=npm run build
START=npx next start -p 80
VERSION=recommended

Next.js needs to be compiled before starting. Set build_command to npm run build (or the BUILD key above) instead of chaining it into the start command — it runs in its own isolated build environment (2× the application’s RAM and vCPU, 10-minute timeout) on every deploy, and a plain restart skips it when the last build already succeeded.

Available Versions

Version	Status	Description
24.22.1	Latest	Node.js 24.22.1 (latest version)
22.23.4	Recommended	Node.js 22.23.4 LTS (recommended for production)

Deploy

Dashboard
CLI
VS Code

Compress the project into a .zip (folders like node_modules, venv and target are removed automatically) or push it to GitHub.
In the dashboard, click New Project and upload the .zip or paste the repository URL.
In Build, check the runtime (JavaScript or TypeScript), and the memory. Under Advanced settings, confirm the build command npm run build and the start command npx next start -p 80; both are pre-filled for Next.js projects.
Add your environment variables in Environment.
In Network, turn on web publishing so the app gets a *.vertraweb.app address (512 MB of memory or more). The app must listen on port 80.
Review and deploy. Follow the output in the Logs tab.

vertra upload
vertra logs -f

See CLI for installation and login.

The full walkthrough is in First deploy.

Notes

Recommended memory: 512MB or more (build process is intensive)
Environment variables: Configure via dashboard before first build
Use output: 'standalone' to reduce build size
API Routes from Next.js work normally on the platform
The application must listen on port 80

Common Issues

Build fails due to lack of memory

The build environment already gets 2× the application’s RAM automatically. If it still fails, raise the application’s own memory to at least 512MB — the build environment scales with it.

Build exceeds the time limit

build_command has a 10-minute ceiling (BUILD_TIMEOUT). Trim dependencies or split a very large build.

Page returns 404

Check if output: 'standalone' is configured and if the build completed successfully in logs.

Overview

Bots

Node.js

Python

Other Languages

Guides

How to Host a Next.js Application on Vertra Cloud

Requirements

Project Structure

Configuration

next.config.js

package.json

vertracloud.config

Available Versions

Deploy

Notes

Common Issues

​Requirements

​Project Structure

​Configuration

​next.config.js

​package.json

​vertracloud.config

​Available Versions

​Deploy

​Notes

​Common Issues

Requirements

Project Structure

Configuration

next.config.js

package.json

vertracloud.config

Available Versions

Deploy

Notes

Common Issues