How to deploy an Axum app · Ample Computer

How to deploy an Axum app

Deploy an Axum app to Ample with your coding agent, the CLI or MCP, using build and start commands verified on November 5, 2026.

the short version

To deploy an Axum 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, runs the tested start command below and returns a public HTTPS URL.

Deploy Axum

  1. Ask your coding agent. Install the Ample CLI and create an account, then ask your agent: "Deploy this Axum app to Ample".

    $ curl -fsSL https://get.ample.computer/install.sh | sh
    $ ample auth signup
    
  2. Or deploy from the CLI. It waits until the app is live or failed and prints the URL.

    $ ample deploy . --name <app-name> --public
    
  3. Or use MCP. Call ample_deploy on https://api.ample.computer/mcp (or ample mcp over stdio).

  4. Verify. On failure read ample logs <deployment_id> --kind build, fix the cause and deploy again.

Tested configuration

Template Build Start Tested size
ubuntu-24.04 cargo build --release `./$(ls target/release/*.d grep -v '/lib'

Verified on Axum: the app built and started with the documented commands and answered on its public HTTPS URL. Build and start: cargo build --release in the rust builder image (stable toolchain, Cargo.lock committed, pure-Rust dependencies), then the release binary on the ubuntu-24.04 template reading PORT and DATABASE_URL.

Last verification (2026-11-05): Axum pattern fixture deployed on Ample (cargo build --release in the rust builder image (stable toolchain, Cargo.lock committed, pure-Rust dependencies), then the release binary on the ubuntu-24.04 template reading PORT and DATABASE_URL); for this guide: the app built and started with the documented commands and answered on its public HTTPS URL.

You need

Know the limits

Frequently asked questions

Do I need a Dockerfile to deploy Axum?

No Dockerfile needed: Ample Computer detects Axum from the repository and builds it from source on the ubuntu-24.04 template.

How do I add a database to a Axum 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 Axum.

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