Deploy a Astro app that uses npm

Q: How do I change the npm install command?

Run ezhst build set --install " ", then ezhst redeploy. Pass an empty string to return to auto-detection.

EasyHost picks npm when it finds package-lock.json. There is nothing to configure, and these are the exact commands it runs for Astro.

Last updated November 9, 2026

What EasyHost runs

Step	Command
Lockfile	`package-lock.json`
Install	`npm ci`
Build	`astro build`, through your package build script
Start	`node ./dist/server/entry.mjs`, set as the start command

Scripts run with npm run <script>. Dev dependencies are available during the build, and the app runs with NODE_ENV=production.

Deploy

Install @astrojs/node in standalone mode and use on-demand rendering where you need a server.

npx ezhst projects create my-project --link
npx ezhst apps create my-app
npx ezhst link --project <project-slug> --app <app-slug>
npx astro add node
npx ezhst build set --start "node ./dist/server/entry.mjs"
npx ezhst env import .env
npx ezhst deploy

Things to watch with npm

npm ci fails if the lockfile and package.json disagree. Run npm install locally and deploy again. npm 11 lockfiles need Node 24.

Commit package-lock.json. Without any lockfile, EasyHost falls back to npm install. To replace the install step, run ezhst build set --install "<command>".

Next steps

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

Frequently asked questions

How do I change the npm install command?

Run ezhst build set --install "<command>", then ezhst redeploy. Pass an empty string to return to auto-detection.

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