## Configure build and start for Gin

### Summary
Build and start for a Gin app on Ample. Verified on Gin: the app built and started with the documented commands and answered on its public HTTPS URL. Build and start:

```sh
CGO_ENABLED=0 go build -o app ./...
./app
```
on the ubuntu-24.04 template (go.sum committed for a reproducible build).

### Prerequisites
- A Gin project (CGO_ENABLED=0 go build -o app ./... then ./app on the ubuntu-24.04 template (go.sum committed for a reproducible build))
- An Ample account token with servers:write

### Workflow Steps
1. **Build and start**  
   `CGO_ENABLED=0 go build -o app ./... then ./app on the ubuntu-24.04 template (go.sum committed for a reproducible build); the server must bind 0.0.0.0 on PORT.`
2. **Deploy**  
   `Run the synchronous deploy once and read the result.`  
   `ample deploy . --name --public`
3. **Verify**  
   `Fetch the live URL on the example; on failure read the build and runtime logs.`  
   `ample logs --kind build`

### Tested Configuration
- **Template**: ubuntu-24.04
- **Runtime**: go
- **Size**: s-1vcpu-1gb
- **Build Command**: CGO_ENABLED=0 go build -o app ./...
- **Start Command**: ./app

### Success Checks
- app responds on its public URL

### Limitations
- Verified on the ubuntu-24.04 template at s-1vcpu-1gb; other sizes and Gin major versions are not verified.
- Region, compliance attestations and request-duration limits are unknown and not claimed.

### Cost Estimate
- **Currency**: USD
- **Monthly Amount**: 5.0
- **Components**:  
  - app server (size: s-1vcpu-1gb, quantity: 1.0, monthly amount: 5.0)
  - **Note**: Always-on monthly price of the tested sizes; apps auto-pause when idle.

### Evidence Summary
- **Kind**: canary_run  
  **Summary**: Gin pattern fixture deployed on Ample (CGO_ENABLED=0 go build -o app ./... then ./app on the ubuntu-24.04 template (go.sum committed for a reproducible build)); for this guide: the app built and started with the documented commands and answered on its public HTTPS URL.  
  **Observed At**: 2026-09-21T01:15:54Z

### Formats
- **HTML**: [View Document](/content/guides/gin/build-and-start/index.html)
- **Markdown**: [View Document](/content/guides/gin/build-and-start.md)  
- **JSON**: [View Document](https://api.ample.computer/v1/catalog/recipes/page%3Aguides%3Agin%3Abuild-and-start)

### Next Actions
- **Browse the catalog index**  
  `GET /v1/catalog`  
- **Search published recipes by intent, stack and constraints**  
  `POST /v1/catalog/search`  
- **Prepare a side-effect-free deployment plan for an authorized project**  
  `POST /v1/catalog/plan`  
- **Read the existing agent authentication setup**  
  `GET /mcp/setup`  
- **Browse Gin**  
  `GET /v1/catalog/nodes/stack%3Aframework-gin`  
- **Browse Configure deployment**  
  `GET /v1/catalog/nodes/intent%3Aconfigure-deployment`  
- **Browse Public web service**  
  `GET /v1/catalog/nodes/pattern%3Apublic-web-service`