varitykit app deploy command

Varity Team Core Contributors Updated June 2026

Deploy your application to Varity’s secure infrastructure.

Usage

varitykit app deploy [OPTIONS]

Hosting Options

Static Sites

Deploy static websites and single-page applications:

varitykit app deploy

Best for:

Marketing websites
Documentation sites
Single-page applications
Landing pages

Features:

Global CDN distribution
Permanent deployment URLs
Automatic SSL
One flat monthly cost per app, your bill does not change with traffic

Dynamic Apps

Deploy full-stack applications with compute resources:

varitykit app deploy --hosting dynamic

Best for:

APIs and backends
Server-side rendering
Database applications
Full-stack apps

Features:

Container hosting
Persistent storage
One flat monthly cost per app. Your bill does not change with traffic

Options

Option	Default	Description
`--hosting`	`auto`	Hosting type: `auto`, `static`, or `dynamic`
`--path`	`.`	Project directory
`--name`	None	Custom app name. Static apps live at `https://varity.app/<name>/`; dynamic apps live at `https://<name>.varity.app/`
`--mode`	`auto`	Deployment mode (advanced)
`--target`	None	Deployment target
`--tier`	None	Hardware tier to reserve
`--repo-url`	None	Deploy directly from a GitHub repo URL
`--skip-build`	`false`	Skip the build step (deploy prebuilt output)
`--image`	None	Deploy a prebuilt OCI image instead of building from source
`--image-registry`	None	Registry host for a private `--image`
`--image-username`	None	Username for a private `--image`
`--image-password`	None	Password or secret value for a private `--image`
`--port`	`80`	Port your dynamic app listens on
`--dry-run`	`false`	Preview the deployment without shipping (not compatible with `--image`)

Basic Deployment

Build your project
Terminal window
```
npm run build
```
Deploy
Terminal window
```
varitykit app deploy
```

View your live app

✓ Build complete
✓ Deployed successfully
✓ Registered on Varity

Your app is live at:
https://varity.app/your-app/

Deployment ID: deploy-1737492000

Supported Frameworks

The CLI automatically detects your framework:

Framework	Detection	Build Command
Next.js	`next.config.*`	`npm run build`
React (Vite)	`vite.config.*`	`npm run build`
React (CRA)	`react-scripts`	`npm run build`
Vue	`vue.config.*`	`npm run build`
Custom	`package.json`	`npm run build`

Environment Variables

Storage and service credentials are auto-provided by Varity. No manual credential setup is required. See Managed Credentials.

List Deployments

View all deployments:

varitykit app list

Output:

ID                  | Status  | URL
--------------------|---------|---------------------------
deploy-1737492000   | live    | https://varity.app/your-app/
deploy-1737491000   | archived| https://varity.app/your-app/ (archived)

View Deployment Details

Get detailed information about a specific deployment:

varitykit app info deploy-1737492000

Delete a Deployment

Remove a deployment:

varitykit app delete deploy-1737492000 --yes

Troubleshooting

”Build failed”

Verify your build works locally:
Terminal window
```
npm run build
```
Check for missing dependencies:
Terminal window
```
npm install
```

“Upload failed”

Verify network connectivity:
Terminal window
```
varitykit doctor
```
Check your internet connection and try again

Advanced: Deployment Manifest

After deployment, a manifest file is created:

{
  "deployment_id": "deploy-1737492000",
  "timestamp": "2026-01-28T12:00:00Z",
  "hosting": "static",
  "url": "https://varity.app/your-app/"
}

Next Steps

Deploy Your App: Deployment details
Configure environment variables: Required setup
CLI Overview: All CLI commands

Quick Start: Complete tutorial
Troubleshooting: Fix common issues
Auto-wired Services: Databases and caches configured automatically