How to deploy an Astro app · Ample Computer
How to deploy an Astro app
Deploy an Astro app to Ample with your coding agent, the CLI or MCP, using build and start commands verified on November 6, 2026.
the short version
To deploy an Astro app on Ample, run ample deploy . --name <app-name> --public in the project directory, or ask your coding agent to deploy it to Ample. Ample builds it on the node-22 template, starts it with npm run start and returns a public HTTPS URL.
Deploy Astro
- Ask your coding agent. Install the Ample CLI and create an account, then ask your agent: "Deploy this Astro app to Ample".
$ curl -fsSL https://get.ample.computer/install.sh | sh
$ ample auth signup
- Or deploy from the CLI. It waits until the app is live or failed and prints the URL.
$ ample deploy . --name <app-name> --public
Or use MCP. Call
ample_deployonhttps://api.ample.computer/mcp(orample mcpover stdio).Verify. On failure read
ample logs <deployment_id> --kind build, fix the cause and deploy again.
Tested configuration
| Template | node-22 |
| Install | npm install |
| Build | npm run build --if-present |
| Start | npm run start |
| Tested size | s-1vcpu-1gb |
A server-output Astro app runs its start script; a static build is published as a static site. Ample detects the runtime, installs dependencies, runs the build when present and starts the app on the node-22 template behind a public HTTPS URL.
Last verification (2026-11-06): Astro app built and started on node-22 and rendered the expected page.
You need
- A package.json with build and start scripts
- A server that listens on process.env.PORT and 0.0.0.0
- An Ample account token with servers:write
Know the limits
- Verified on the node-22 template at s-1vcpu-1gb.
- Tested with the Astro node adapter (standalone).
Frequently asked questions
Do I need a Dockerfile to deploy Astro?
No Dockerfile needed: Ample Computer detects Astro from the repository and builds it from source on the node-22 template.
How do I add a database to a Astro app?
Leave DATABASE_URL unset and deploy: when the code needs Postgres, MySQL, Redis or MongoDB, Ample creates a managed database and passes its connection string to the app. See Connect Postgres for Astro.
What if the deploy fails?
ample deploy waits until the app is live or failed. A failure returns who must act, a diagnosis and a suggested fix; read the logs with ample logs <deployment_id> --kind build.