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

  1. 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
  1. Or deploy from the CLI. It waits until the app is live or failed and prints the URL.
   $ ample deploy . --name <app-name> --public
  1. Or use MCP. Call ample_deploy on https://api.ample.computer/mcp (or ample mcp over stdio).

  2. 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

Know the limits

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.