Deploy an Astro App

Last updated October 19, 2026

You can deploy Astro as a frontend app or enable server-side rendering (SSR). With SSR enabled, the app is deployed as a backend app.

Build Process
Copy link

By default, App Platform prepares the build environment by running this command:

DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y --no-install-recommends \
 curl \
 {% if system_dependencies %}{{ system_dependencies | join(' ') }}{% endif %} \
 && rm -rf /var/lib/apt/lists/*

system_dependencies is the list of system dependencies you specify in the dashboard. App Platform inserts them into the command during the build.

Next, App Platform installs the project dependencies. It picks the package manager (yarn, pnpm, or npm) based on your project files and runs the matching command:

yarn install
pnpm install
npm install

To build the app, App Platform runs the following command by default:

npm run build

Make sure your package.json file contains a build script.

The default build directory is /dist. After the build, App Platform publishes the files from this directory.

Deploy as a Frontend App
Copy link

Configure your Astro project to build a static site.

Deploy with SSR
Copy link

  1. When creating the app, enable SSR support. The app switches to backend app mode, which means:
    • You select a server configuration.
    • After deployment, the dashboard interface is identical to a backend app.
    • You can set a start command.
  2. Configure the @astrojs/node adapter in standalone mode.
  3. In the astro.config.mjs file, set output: 'server'.
  4. Make sure the server listens on 0.0.0.0, not 127.0.0.1. Otherwise, external connections won't work.

The default start command is:

node ./dist/server/entry.mjs