Deploy Astro on Render – Render Docs

You can deploy your Astro site on Render for free.

How you deploy depends on whether your site includes server-side logic (SSR, API routes, etc.):

Nope, it's

fully static.

Yep!

Does your site have a server-side component?

Create a

Static site
Create a

Web service

See instructions for each service type below.

Not sure if you have a server-side component?

Check your project's astro.config.mjs file. If it sets output: 'server' or output: 'hybrid' (removed in Astro v5), deploy as a web service.

Static site (no server-side logic)

Sites without a server-side component use Render's static site service type.

Static sites are served over a global CDN. They include fully managed TLS certificates and support custom domains out of the box.

  1. In the Render Dashboard, click New > Static Site:

  2. In the creation form, connect your Astro project's GitHub repository.

    • (GitLab and Bitbucket work too.)

  3. For your site's Build Command and Publish Directory, set the following:

Setting Value
Build Command npm install && npm run build
If you use a different package manager (such as bun, pnpm, or yarn), use its equivalent command instead.
Publish Directory dist
  1. Click Deploy Static Site. Render kicks off your site's first build and deploy.

That's it! Your site will be live at its onrender.com URL as soon as the deploy finishes:

As next steps, you can add a custom domain to your site and set up pull request previews.

Web service

If your Astro site includes a server-side component, you deploy it as a web service.

Web services support both horizontal and vertical scaling. They include fully managed TLS certificates and support custom domains out of the box.

  1. If necessary, update your Astro project to use the @astrojs/node adapter if you currently use a different adapter:
$ npx astro add node

After making this change, push it to your repository.

  1. In the Render Dashboard, click New > Web Service:

  2. In the creation form, connect your Astro project's GitHub repository.

    • (GitLab and Bitbucket work too.)

  3. For your web service's Build Command and Start Command, set the following:

Setting Value
Build Command npm install && npm run build
If you use a different package manager (such as bun, pnpm, or yarn), use its equivalent command instead.
Start Command node dist/server/entry.mjs
If you've customized your site's builds, confirm this path by building your site locally and checking the output of the build command.
  1. Set your service's Compute Plan to Free.
    • You can upgrade to a paid compute plan at any time.
    • Learn more about free compute plans.
  2. Under Environment Variables, add the following variables:
Name Value
HOST 0.0.0.0
(By default, dynamic Astro sites bind to 127.0.0.1 (i.e., localhost). Render web services must bind to 0.0.0.0 instead.)
NODE_VERSION (optional) Optionally set this to the version of Node.js you want to use for your site.
Newly created services use Node.js 24.21.0 by default.
  1. Click Deploy Web Service. Render kicks off your service's first build and deploy.

That's it! Your site will be live at its onrender.com URL as soon as the deploy finishes: