Deploy a Astro App

Astro builds static by default — deploying it should be just as easy

Last updated: February 20, 2026
Deploy Now Read the Docs

Astro outputs static HTML by default, which means zero configuration for deployment. No adapters to install, no settings to change. Build your Astro project and deploy the output — your content-first site is live on a global edge network in seconds.

Deploy in 3 steps

From zero to live in under a minute.

1

Create your Astro project

Scaffold a new project with the official Astro CLI CLI.

bash 
npm create astro@latest my-app
2

Build for production

Run the build command to generate static output in dist/.

bash 
cd my-app && npm run build
3

Deploy to ZeroDeploy

One command to push your site to the edge. It's live in seconds.

bash 
zerodeploy deploy --dir dist

Things to know

Astro-specific tips to avoid common pitfalls.

  • Astro is static by default — no extra configuration needed. Just build and deploy.
  • If you add an SSR adapter (Node, Cloudflare, etc.), remove it before deploying to ZeroDeploy. Use output: 'static' (the default).
  • Client-side JavaScript requires explicit client:* directives on interactive components (e.g., client:load, client:visible).

Everything you need

Deploy Astro apps with the features you'd expect from a modern hosting platform.

Instant Deploys

Push to deploy in under 5 seconds. No queues, no build minutes to worry about.

Preview URLs

Every deployment gets a unique URL. Share any version instantly with your team.

Custom Domains

Connect your own domain with automatic SSL. Just add a CNAME and you're live. Learn more →

GitHub Actions CI/CD

Deploy on every push with GitHub Actions. Get PR comments with preview URLs. Set up CI/CD →

Built-in Analytics

See traffic, top pages, referrers, and countries right in your dashboard. No third-party scripts. Learn more →

Forms That Just Work

Add action="/_forms/contact" to any form. Submissions appear in your dashboard. Learn more →

Deploy other frameworks

ZeroDeploy works with any static build output.

Deploy Next.js Deploy Svelte Deploy Vite

The simplest way to host Astro

Zero config needed. Build, deploy, live. Free hosting with custom domains, analytics, and preview URLs.

Get Started Free