Deploy guide
How to deploy Astro to Cloudflare Pages
The settings to enter and where to find them: Astro on Cloudflare Pages, built on every push.
Checked 16 October 2026
In short
The settings
- Framework preset
Usually picked for you on import.
- Build command
- Build output directory
Step by step
Set it up
- 1
Put the project in a Git repository
Push it to GitHub, GitLab or Bitbucket. Cloudflare Pages builds from the repository, so the build folder (dist) doesn't need to be committed.
- 2
Import it in Cloudflare Pages
Start a new project from the repository and give Cloudflare Pages access to it when it asks.
Workers & Pages→Create application→Pages→Connect to Git
- 3
Check the build settings
Cloudflare Pages usually recognises Astro and fills these in. Make sure they read:
- Framework preset
Usually picked for you on import.
- Build command
- Build output directory
- 4
Deploy
Start the deploy. When the build finishes, the site is at https://YOUR-PROJECT.pages.dev. Each push to the main branch deploys again, and other branches and pull requests get preview links.
To change the settings later: Workers & Pages → Your project → Settings.
Good to know
Common snags
- This is for Astro's default static output. With an adapter for server rendering, the host needs to run it, and the settings differ.
- Node.js version: Set a NODE_VERSION environment variable, or add an .nvmrc or .node-version file. The current build image starts on Node 22.
Stuck? The usual problems, solved
Questions
Before you start
Is Cloudflare Pages free for this?
A generous free plan. Workers paid plans for more builds and functions.
How do I use my own domain?
Add it in Cloudflare Pages's domain settings, then add the DNS records at your registrar. Our custom domain guides have the exact records for Cloudflare Pages at each registrar.
The build works on my computer but fails here. Why?
Most often a different Node.js version, or a package that's installed on your computer but missing from package.json. Set a NODE_VERSION environment variable, or add an .nvmrc or .node-version file. The current build image starts on Node 22.
Next step: connect your own domain to Cloudflare Pages.
Rather skip git and build settings?
Build on your computer with npm run build, then drop the dist folder (or a zip of it) on 99helpers. It's online at its own address in seconds, with no repository, workflow or base path to set up. Passwords, analytics, your own domain and AI editing are built in.
Or skip the setup
Drop it in. It's online in seconds.
A file, a folder or a whole site: 99helpers puts it online at its own address, with no git, no build settings and no DNS to start with. Add your own domain whenever you're ready.