Run your own Docker image.
Bring a specialised agent runtime while preserving Hangar’s provisioning, billing, and EU operating environment.
Image requirements
| Requirement | Contract |
|---|---|
| Entrypoint | Start a long-lived HTTP service and handle SIGTERM for graceful shutdown. |
| Exposed port | Listen on the configured PORT environment variable; do not bind only to localhost. |
| Health endpoint | Serve a fast, unauthenticated GET /health returning 200 when the runtime is ready. |
Delivery checklist
Build for Linux, pin image tags or digests, avoid credentials inside layers, and make startup configuration environment-driven. Test your image locally with the same port and health endpoint before submitting it to Hangar.
A failing health check prevents traffic from reaching the image. Return a clear non-200 status whenever the agent cannot safely accept work.