How to deploy a Next.js app | Ample

The short version

To deploy a Next.js app on Ample, run ample deploy . --name <app-name> --public in the project directory, or ask your coding agent to deploy it to Ample. Ample builds it on the node-22 template, starts it with npm run start and returns a public HTTPS URL.

Deploy Next.js

Ask your coding agent

Install the Ample CLI and create an account (no browser or card needed), then ask Claude Code, Codex, Cursor or any agent with a shell to deploy the project. See Ample for coding agents.

curl -fsSL https://get.ample.computer/install.sh | sh
ample auth signup
# then, in your agent:
# "Deploy this Next.js app to Ample"

Or deploy from the CLI

Run the deploy once from the project directory. It waits until the app is live or failed and prints the URL; exit 0 is live, 1 failed, 2 needs input.

ample deploy . --name <app-name> --public

Or use MCP

Agents connected to the Ample MCP server (https://api.ample.computer/mcp, or ample mcp over stdio) call ample_deploy with the same arguments.

Verify

Open the URL. If the deploy failed, read the build log, then the runtime log, fix the cause and deploy again.

ample logs <deployment_id> --kind build

What Ample runs

js app on Ample. A server-rendered app runs next build then next start on the node-22 template with the detected package manager; a static export is published as a static site. The app must bind 0.0.0.0 on PORT.

Last verification (September 19, 2026): Next.js 15 SSR app (next build, next start) deployed on node-22; the page and an API route served correctly.

Before you deploy

You need

A package.json with build and start scripts (next build, next start -H 0.0.0.0 -p ${PORT:-3000})
Node 22 compatible dependencies
An Ample account token with servers:write

Know the limits

Verified on the node-22 template at s-1vcpu-1gb; other templates and sizes are not verified by this recipe.
Next.js 15 was tested; other majors are not verified.
Image optimization, ISR and middleware behavior are not verified.

Move a Next.js app to Ample

Frequently asked questions

Do I need a Dockerfile to deploy Next.js?

No. Ample detects Next.js from the repository and builds it from source on the node-22 template. Dockerfile build steps are not run.

How do I add a database to a Next.js app?

Leave DATABASE_URL unset and deploy: when the code needs Postgres, MySQL, Redis or MongoDB, Ample creates a managed database and passes its connection string to the app. See Connect Postgres for Next.js.

What does it cost to host a Next.js app on Ample?

The Free plan runs 2 apps at once with no card and a hard monthly budget, so it never bills you. Larger needs are priced on volume; see pricing.

What if the deploy fails?

ample deploy waits until the app is live or failed. A failure returns who must act, a diagnosis and a suggested fix; read the logs with ample logs <deployment_id> --kind build. See Diagnose deployment failures for Next.js.

More for Next.js

Next.js How to serve Next.js public assets through a CDN on Ample Next.js How to set environment variables and secrets for a Next.js app on Ample Next.js How to connect a Next.js app to Postgres on Ample Next.js How to fix a failed Next.js deploy on Ample Next.js How to use S3-compatible storage from a Next.js app on Ample Next.js How to serve private files from a Next.js app on Ample Next.js How to run database migrations for a Next.js app on Ample