Register, launch, publish: three separate things
Applies to Host on GMI only. Self-hosted agents are never launched on GMI: no + Sandbox button, only the Analytics tab.Who pays when a user shows up
The order that saves you trouble
- Register. Free, private, reversible.
- Launch a sandbox and use it. Confirm it starts, binds the right port, reaches the model, returns what you expect. Delete it when done.
- Publish once it works.
Choosing your path first
Path A: Host on GMI
Run your agent in a GMI-managed sandbox with built-in access to GMI Models.
Before you begin
What your image must do. GMI runs your sandbox as a long-lived network service. If your image doesn’t behave like one, the sandbox starts and is then marked errored.- Listen on the Internal Port. GMI forwards external traffic to your sandbox’s Internal Port (default
8080). Your process must bind that port. - Run as a persistent HTTP server that responds to health checks, not a one-shot CLI.
- Bake the right start command into the image. Whatever
CMD/ENTRYPOINTyour Dockerfile declares is what runs.
latest. If the registry or repository is private, turn on Requires sign-in during registration, or the pull fails at launch.
Basics & Template
The page reminds you: Image must read the env var
GMI_MAAS_API_KEY for the API key. We inject the value at runtime. Required for Models calls. See Environment Variables below.
View Setup Guide links to the registration guide on docs.gmicloud.ai.
Runtime

Public Access (optional)
A public IP is assigned when your agent starts.
Add Port Mapping adds more rows; each row can be removed.
Environment Variables (optional)
Supplies configuration and credentials at runtime: things that shouldn’t be baked into an image because they’re secret or change between deployments.
GMI_MAAS_API_KEY row (Auto-generated on deploy, type AUTO). Pass it to your model client as the API key.
GMI provides only the key. Configure the model endpoint in your image:
.env into a Key field. Set each row to TEXT or SECRET; secrets are AES-256 encrypted and never logged.
Summary and Register
The Summary panel on the right mirrors what you enter. Check three things that only fail at launch: the image tag is pushed, Requires sign-in is on for private images, and the Internal Port matches your image. Register saves the template: no billing, nothing public. A dialog shows theGMI_MAAS_API_KEY; the template then shows Creating and a Build Log until it’s ready to launch.


Path B: Connect your agent
Run your agent in your own environment and connect it to GMI’s full model catalog. GMI only meters inference. Registering adds the agent to My Agents; list it separately through List an agent. If you just want GMI’s models, use a MaaS API key directly.