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
First 3 static sites free, then $1/month per site, for verified accounts; 1 GB of pinned assets

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
Up to a fixed monthly maximum per app, prorated by running time. An unchanged profile does not cost more as traffic grows

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: `free`, `starter`, `growth`, `enterprise`, or `scale`
`--repo-url`	None	GitHub repo URL to build from. Auto-detected from `.git/config`; required for source deploys, since nothing is uploaded from your machine
`--template`	None	Deploy a certified template by id (`varitykit app templates`). Mutually exclusive with `--repo-url` and `--image`
`--env KEY=VALUE`	None	Set an environment variable on the deployment (repeatable)
`--service`	None	Attach an auto-wired service: `postgres`, `redis`, `ollama`, `mongodb`, `mysql`, or `minio` (repeatable)
`--volume-size` / `--volume-path`	None	Persistent volume in GB and its absolute mount path (both required together)
`--command` / `--arg` / `--health-path`	None	Advanced runtime overrides for image and Dockerfile deploys
`--dockerfile-path` / `--docker-context-path`	None	Advanced build overrides for repo deploys
`--memory-mb` / `--cpu-units` / `--storage-mb`	None	Advanced reserved-resource overrides for image and prebuilt deploys
`--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

Push your project to GitHub

Varity builds from the repository in the cloud, so the code you want live must be pushed.
Deploy from the checkout
Terminal window
```
varitykit app deploy
```
Outside a Git checkout, pass --repo-url https://github.com/you/my-app, --image <ref>, or --template <id>.

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:

Name       | Type    | URL                          | Deployed
-----------|---------|------------------------------|-----------------
your-app   | static  | https://varity.app/your-app/ | 2026-09-06 12:00
my-api     | dynamic | https://my-api.varity.app/   | 2026-09-05 18:30

Pass the global --json flag (varitykit --json app list) for machine-readable output.

View Deployment Details

Get detailed information about a specific deployment:

varitykit app info your-app

Delete a Deployment

Remove a deployment:

varitykit app delete my-app --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