Deploy an App Without DevOps on Varity

Varity Team Core Contributors Updated June 2026

Deploy your application to Varity from the Dashboard, CLI, or MCP server.

From the Dashboard, choose a GitHub repository, add environment variables, review the fixed monthly price for the reserved hardware, and deploy.

Three Ways In

Varity accepts three kinds of input, from the CLI, the Developer Portal, or the MCP server in your AI coding tool:

Input	How	Best for
Your project / GitHub repo	`varitykit app deploy` (this page)	Apps in a supported framework with automatic detection and builds
A Docker image	`varitykit app deploy --image <ref>`. See Deploy a Docker Image	Anything already containerized, any language
A template	The portal gallery. See agent templates	One-click AI agent and tool deployments

The rest of this page covers the first path: deploying your own project.

Quick Deploy

Install the CLI
Terminal window
```
pipx install varitykit
```
Build your project
Terminal window
```
npm run build
```
Deploy
Terminal window
```
varitykit app deploy
```

Your app is live!

Varity will output your live URL:

✓ Deployed successfully!
✓ URL: https://your-app.varity.app
✓ Build time: 1m 23s
✓ Status: Live

What Happens During Deployment

When you run varitykit app deploy:

Detects your framework: automatically identifies Next.js, React, Vue, etc.
Builds your app: runs your build command (npm run build)
Uploads your files: stores them securely
Makes your app live: generates a public URL
Returns a live URL: static apps use https://varity.app/<name>/; dynamic apps use https://<name>.varity.app/

All of this happens automatically.

Hosting Options

Choose the right hosting for your application type:

Static Sites

Best for: React, Vue, Next.js static exports, documentation, landing pages

Features:

Global CDN distribution
Instant cache invalidation
Automatic SSL certificates
Fixed profile pricing

varitykit app deploy

Dynamic Apps

Best for: Full-stack apps, APIs, real-time applications, databases

Features:

Container-based compute
Managed container hosting
Auto-wired database support
Flat monthly pricing

varitykit app deploy --hosting dynamic

Before You Deploy

Environment Variables

Credentials are managed automatically by Varity. Optionally set your app ID:

# Optional: Your Varity App ID
NEXT_PUBLIC_VARITY_APP_ID=<your-app-id>

See Environment Variables for the complete list and Managed Credentials for how credential auto-provision works.

Test Locally First

Always test your build works locally:

npm run build
npm run start

Visit http://localhost:3000 and verify everything works.

Manage Your Deployments

List All Deployments

View your deployment history:

varitykit app list

Output:

ID                  Status    URL                                Deployed
deploy-1737491000   live      https://your-app.varity.app       2 hours ago
deploy-1737484800   archived  https://your-app-v2.varity.app    1 day ago
deploy-1737398400   archived  https://your-app-v1.varity.app    2 days ago

Recover a Known-Good Version

To recover after a bad deploy, redeploy a known-good version of your app. Check out the working commit and run varitykit app deploy again under the same --name. The deployment at that URL is replaced with the version you just built.

View Deployment Details

Check the details of a specific deployment:

varitykit app info deploy-1737491000

Check Deployment Status

View overall deployment status:

varitykit app status

Deployment URL

Every deployment gets a public URL. URL format depends on hosting type:

varitykit app deploy --name my-app
# Static hosting → https://varity.app/my-app/
# Dynamic hosting → https://my-app.varity.app/

See App URLs & Subdomains for naming rules and the current status of bring-your-own domains.

Troubleshooting

”Deployment failed: Build error”

Verify your build works locally:
Terminal window
```
npm run build
```
Check the build output directory exists:
- Next.js: .next/ or out/
- React: dist/ or build/
- Vue: dist/

”Environment variables not found”

Credentials are auto-provided. If you see this error, run varitykit doctor to check your setup.

”Deployment timed out”

Check your internet connection:

varitykit doctor

If issues persist, you can preview what would deploy without deploying:

varitykit app deploy --dry-run

Advanced Configuration

Deploy Options

Option	Default	Description
`--hosting`	`auto`	Hosting type: `auto`, `static`, or `dynamic` (auto picks based on your project)
`--name`	from `package.json`	App name (and URL) for this deployment
`--path`	`.`	Project directory
`--mode`	auto	Override the detected build/run mode
`--skip-build`	off	Skip the build step (deploy a pre-built output)
`--repo-url`	None	Deploy directly from a GitHub repo URL instead of a local path
`--dry-run`	off	Simulate the deploy: show what would deploy without deploying (not supported with `--image`)

Deploy a prebuilt Docker image

Instead of a project directory, you can deploy an existing image. See Deploy a Docker Image for the full flow.

Option	Default	Description
`--image`	None	Image reference to deploy as-is (e.g. `ghcr.io/acme/api:1.4.2`)
`--port`	`80`	Container port your app listens on
`--image-registry` / `--image-username` / `--image-password`	None	Credentials for a private registry