agent launch command deploys your agent to Novita Sandbox. It reads the project configuration produced by agent configure, builds the agent template, and deploys it, reporting the resulting agent, template, and build identifiers. Run it from your project root.
Prerequisites
- Set the
NOVITA_API_KEYenvironment variable. - A configured project ā run
agent configurefirst so the configuration file and Dockerfile exist.
Usage
CLI
CLI
Options
What it does
When you runagent launch, the CLI performs the deployment in sequence:
- Checks prerequisites ā the configuration file and Dockerfile must exist.
- Loads and validates the agent configuration.
- Verifies the
NOVITA_API_KEYand checks service health. - Builds the agent template and deploys it (unless
--dry-runis set).
Output
On success, the CLI reports the deployment identifiers and status:Output
With
--dry-run, no template is built or deployed. The command validates the project and configuration and reports a dry-run result, so you can confirm everything is in order before a real deployment.