Deploy Your Application

Varity Team Core Contributors Updated May 2026

Deploy your application to Varity with one command.

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 with automatic backups
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
Database support
WebSocket support

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

Rollback to Previous Version

Revert to a previous deployment:

varitykit app rollback deploy-1737484800

Your app will instantly switch to the selected version. See Rollback a Deployment for a full walkthrough, including how to find deployment IDs and handle caveats around environment variables and database migrations.

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 Custom Domains for 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, try deploying with verbose output:

varitykit app deploy --verbose

Advanced Configuration

Deploy Options

Option	Default	Description
`--hosting`	`static`	Hosting type: `static` or `dynamic`
`--path`	`.`	Project directory