Quick Start
Deploy your first site with just 2 commands.
curl -X POST api.zerodeploy.dev/drop -H "Content-Type: text/html" --data-binary @index.htmlSites expire in 72 hours unless claimed. For ongoing projects, continue below.
Prerequisites
- A GitHub account
- Node.js 18+ or Bun installed
- A frontend project with a static build output (e.g.,
dist/orout/folder)
Step 1: Install the CLI
Install the ZeroDeploy CLI globally:
npm install -g @zerodeploy/cli
Step 2: Login
Run the login command. This opens your browser to authenticate with GitHub:
zerodeploy login
After authenticating, you’ll see:
Opening browser for GitHub authentication...
Logged in successfully!
Your personal workspace is automatically created using your GitHub username.
Step 3: Deploy
Navigate to your project folder and run deploy:
cd my-project
zerodeploy deploy
On your first deploy, you’ll be prompted to create a site:
No site configured. Create site "my-project"? [Y/n]
Creating site "my-project"...
Created site: my-project.zerodeploy.app
Saved config to zerodeploy.json
Detected: Vite
Deploying: ./dist
Found 42 files (1.2 MB)
Uploading...
Deployment successful!
URL: https://my-project.zerodeploy.app
Preview: https://abc123-my-project.zerodeploy.app
Just press Enter to accept the suggested site slug, and you’re done!
That’s it!
Your site is now live. Every deployment also gets a unique preview URL that you can share.
For subsequent deploys, just run:
zerodeploy deploy
The config is saved in zerodeploy.json, so you never need to specify options again.
Starter Plan Limits
The Starter plan ($9/mo) includes a 14-day free trial. Here’s what’s included:
- 1 site, 1 GB storage, 10 deploys per day
- 1 custom domain, deploy tokens, preview deployments, password protection
- 30-day analytics (same as Pro)
Trial Period
You get a 14-day free trial when you sign up — no credit card required. After the trial, subscribe to the Starter plan to keep your site live.
Next Steps
- Build and deploy — Use
--buildto run your build command first - Set up GitHub Actions — Automated deployments on every push
- Learn about rollbacks — Roll back to any previous deployment
- Create team organizations — Collaborate with your team