varitykit app deploy command

Varity TeamCore Contributors

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
• The CLI does not show a price or ask for confirmation before it deploys. Check the current price first in Pricing and Costs

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

Tip

Dynamic hosting is powered by cloud compute. --hosting defaults to auto, which detects the framework and picks static or dynamic for you. Pass --hosting dynamic to force it for server-side frameworks (Next.js API routes, Express, and similar).

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/
--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
--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	Container listen port for an --image deploy only
--dry-run	false	Preview the deployment without shipping (not compatible with --image or --template)

Basic Deployment

1. Push your project to GitHub

   Varity builds from the repository in the cloud, so the code you want live must be pushed.

2. Deploy from the checkout

   varitykit app deploy

   Outside a Git checkout, pass --repo-url https://github.com/you/my-app, --image <ref>, or --template <id>.

3. View your live app

   Deploying via Varity…
     Run: 3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b0c
   
   ✓ Live: https://varity.app/your-app/
   Run: 3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b0c
   Final status: live
   Continue: varitykit app status 3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b0c

   The command waits until the app is live. A dynamic app can take a few minutes, and the CLI prints no progress while it waits.

Note

Static apps live at a path: https://varity.app/<name>/. Dynamic apps get their own subdomain: https://<name>.varity.app/ (the apex path redirects to the subdomain).

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:

The table has the columns ID, Name, Status, Runtime, URL, Outcome, and Updated. In a narrow terminal (80 columns) only ID and Name fit, so widen the terminal or use JSON output.

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”

1. Verify your build works locally:

   npm run build

2. Check for missing dependencies:

   npm install

“Upload failed”

1. Verify network connectivity:

   varitykit doctor

2. Check your internet connection and try again

Next Steps

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

Related Resources

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