# How to deploy an ASP.NET Core app

Deploy an ASP.NET Core 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 ASP.NET Core 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 dotnet-10 template, runs the tested start command below and returns a public HTTPS URL.

## Deploy ASP.NET Core

1. **Ask your coding agent.** Install the Ample CLI and create an account, then ask your agent: "Deploy this ASP.NET Core 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 | `dotnet-10` |
| Build | `dotnet publish -c Release -o out` |
| Start | `ASPNETCORE_URLS=http://0.0.0.0:$PORT dotnet out/$(basename $(ls out/*.runtimeconfig.json | head -n 1) .runtimeconfig.json).dll` |
| Tested size | `s-1vcpu-1gb` |

NET Core app on Ample. Verified on ASP.NET Core: the app built and started with the documented commands and answered on its public HTTPS URL. Build and start: `dotnet publish -c Release -o out` in the builder, then `dotnet <entry>.dll` on the dotnet-10 template with `ASPNETCORE_URLS` bound to `PORT`.

Last verification (2026-11-06): ASP.NET Core pattern fixture deployed on Ample (dotnet publish -c Release -o out in the builder, then dotnet <entry>.dll on the dotnet-10 template with ASPNETCORE_URLS bound to PORT); for this guide: the app built and started with the documented commands and answered on its public HTTPS URL.

## You need

- An ASP.NET Core project (dotnet publish -c Release -o out in the builder, then dotnet <entry>.dll on the dotnet-10 template with ASPNETCORE_URLS bound to PORT)
- An Ample account token with servers:write

## Know the limits

- Verified on the dotnet-10 template at s-1vcpu-1gb.

## Frequently asked questions

### Do I need a Dockerfile to deploy ASP.NET Core?

No Dockerfile needed: Ample Computer detects ASP.NET Core from the repository and builds it from source on the `dotnet-10` template.

### How do I add a database to a ASP.NET Core 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 ASP.NET Core](/content/guides/asp-net-core/database-connection/index.html).

### 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 ASP.NET Core](/content/guides/asp-net-core/deployment-diagnostics/index.html).
