Deploy Astro from a monorepo

Run the deploy from your repository root and tell EasyHost which folder holds your Astro app. It installs where the lockfile is and builds in your app folder.

Last updated November 9, 2026

Set the root directory

npx ezhst link --project <project-slug> --app <app-slug>
npx ezhst build set --root-dir apps/web
npx ezhst deploy

How it resolves

Step	Where it runs
Upload	The folder where you ran `deploy`, so use the repository root
Install	Your app folder if it has a lockfile, otherwise the repository root
Build	`apps/web`, using `astro build`, through your package build script
Start	`apps/web`, using `node ./dist/server/entry.mjs`, set as the start command

Build shared packages first

If Astro imports workspace packages that need compiling, build them first with a custom command.

npx ezhst build set --build "npx turbo run build --filter=./apps/web"

Nx works the same way with npx nx build <project>.

Several apps, one project

A project holds up to 3 apps. Create one EasyHost app per deployable folder and set each root directory. They share the project's database and bucket.

See the Astro hub for every Astro guide, or free Astro hosting for what is included.

Frequently asked questions

Where should I run ezhst deploy?

From the repository root, so shared packages and the lockfile are included in the upload.

Start for free

Install the skill, choose Global or Local, then tell your agent to deploy. No credit card, no config files.

npx ezhst skill install