How to deploy an Echo app · Ample Computer
How to deploy an Echo app
Deploy an Echo app to Ample with your coding agent, the CLI or MCP, using build and start commands.
the short version
To deploy an Echo 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 ubuntu-24.04 template, starts it with ./app and returns a public HTTPS URL.
Deploy Echo
- Ask your coding agent. Install the Ample CLI and create an account, then ask your agent: "Deploy this Echo 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 | ubuntu-24.04 |
| Build | CGO_ENABLED=0 go build -o app ./... |
| Start | ./app |
| Tested size | s-1vcpu-1gb |
Verified on Echo: the app built and started with the documented commands and answered on its public HTTPS URL. Build and start: CGO_ENABLED=0 go build -o app ./... then ./app on the ubuntu-24.04 template.
You need
- An Echo project (
CGO_ENABLED=0 go build -o app ./...then./appon theubuntu-24.04template) - An Ample account token with
servers:write
Know the limits
- Verified on the
ubuntu-24.04template ats-1vcpu-1gb.
Frequently asked questions
Do I need a Dockerfile to deploy Echo?
No Dockerfile needed: Ample Computer detects Echo from the repository and builds it from source on the ubuntu-24.04 template.
How do I add a database to an Echo 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 Echo.
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. See Diagnose deployment failures for Echo.