Deploy a Next.js App

Varity Team Core Contributors Updated May 2026

Deploy a production Next.js app with a database and a live URL with one command. No server configuration, no environment variable setup, no infrastructure decisions.

Zero configuration

Varity detects your framework, wires your database, and deploys. You run one command.

Predictable pricing instead of usage-metered cloud bills

One flat monthly cost per app. Your bill on day 1 equals your bill on day 1000. No DevOps overhead.

Two ways to deploy

You can deploy from your AI editor using the Varity MCP server (the fastest path), or from the terminal using the CLI.

From Claude Code or Cursor (MCP)
From the terminal (CLI)

Step 1. Add the Varity MCP server

claude mcp add varity -- npx -y @varity-labs/mcp@beta

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "varity": {
      "command": "npx",
      "args": ["-y", "@varity-labs/mcp@beta"]
    }
  }
}

Restart Cursor.

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "varity": {
      "command": "npx",
      "args": ["-y", "@varity-labs/mcp@beta"]
    }
  }
}

Step 2. Ask your AI to deploy

Type this prompt in your AI editor:

Build and deploy my current Next.js project to Varity.

The AI will call varity_install_deps, varity_build, and varity_deploy in sequence. Your live URL appears when it is done.

Step 3. Check the result

Show me the status of my Varity deployment

You will get the live URL, framework detected, build time, and status.

Step 1. Install the CLI

pipx install varitykit

Python 3.8 or later is required.

Step 2. Open your app directory

cd my-app

Step 3. Install dependencies

npm install

Step 4. Deploy

varitykit app deploy

Your app is live. The terminal prints your URL.

What gets auto-configured

When you deploy a Next.js app with Varity, these services are wired automatically:

Service	What Varity does
Database (Postgres)	Provisions a dedicated schema, injects connection credentials at deploy time
Hosting	Detects SSR vs. static and picks the right compute type
SSL	HTTPS is on by default. No certificate setup needed
Custom URL	Your app gets a live public URL at `varity.app/your-app`

No environment variables to copy, no credential files to manage. The auto-wired services are documented in Auto-wired Services.

Full walkthrough: scaffold to live

Verify your environment
Terminal window
```
varitykit doctor
```
This checks Node.js, Python, CLI, and authentication status. Fix anything it flags before proceeding.
Open your app and install dependencies
Terminal window
```
cd my-nextjs-app
npm install
```
Run locally
Terminal window
```
npm run dev
```
Open http://localhost:3000. Sign in, create a record, verify the UI works.
Build for production
Terminal window
```
npm run build
```
Fix any TypeScript or lint errors before deploying.

Deploy

varitykit app deploy

Output when done:

Detecting framework...   Next.js (App Router)
Building app...          Done in 42s
Deploying...             Done in 18s

Live at: https://varity.app/my-nextjs-app/

Verify

Open the URL. Sign in. Create a record. Confirm the app works exactly as it did locally.

Deploy with a dynamic backend

By default Varity detects whether your app is static or needs a live server. A Next.js app with API routes, server actions, or getServerSideProps is automatically deployed with container-based compute.

If you want to force the hosting type:

varitykit app deploy --hosting dynamic

See Auto-wired Services for a full explanation of how Varity picks the hosting type.

Using the MCP tools in your AI editor

These are the relevant MCP tools for a Next.js deploy workflow:

Tool	What it does
`varity_doctor`	Checks environment setup
`varity_install_deps`	Runs npm install
`varity_build`	Builds for production
`varity_deploy`	Deploys and returns the live URL
`varity_deploy_status`	Lists deployments with status and URL
`varity_deploy_logs`	Gets build logs for debugging

Copy-paste prompts for each step:

Check if my environment is ready for Varity

Create a new Varity app called invoice-tracker, install dependencies

Build my project and deploy it to Varity

Show me the deployment status and live URL

Updating your app

After making changes, redeploy with the same command:

varitykit app deploy

Or from your AI editor:

Build and redeploy my Varity app

Varity keeps the previous deployment available for instant rollback. See Rollback a Deployment.

Cost

Varity uses fixed hardware profile pricing, while Vercel, Render, and Railway are usage-based. Use the cost calculator to get a precise estimate:

How much would it cost to host a Next.js app with 500 users on Varity?

Or use the CLI:

varitykit cost-calculator --users 500 --has-database

See How pricing works for details.

Troubleshooting

Build fails with “Module not found”

Run npm install first, then rebuild.

“varitykit not found” in terminal

pipx install varitykit
varitykit doctor

Deploy times out

varitykit doctor
varitykit app deploy --verbose

App loads but database is empty

Your app scaffold includes sample data creation in the dashboard. Navigate to a list view and create a record to confirm the database is wired correctly.

See Troubleshooting Deploys for the full list.

Next steps

Auto-wired Services: What gets provisioned and how
Environment Variables: What you can override
Custom Domains: Point your own domain at the deployment
MCP Server Reference: Full MCP tool reference
Rollback a Deployment: Revert to a previous version