axon deploy
Deploy the agent project at the current directory to Axon Cloud. axon deploy
is a project command: Axon identifies the project from the working directory,
then requires that it is an agent because only agents can run as deployments.
It is not nested under an agent subcommand.
axon deploy
Builds the agent, pushes it to Axon's infrastructure, and returns a public URL and API
key. Requires axon login.
On first deploy:
Deployed: https://<your-agent-url>
API key: axon_...
Subsequent deploys replace the running revision in the same deployment slot; they do not create another cloud deployment for the agent.
Options
| Flag | Default | Description |
|---|---|---|
--json | false | Print one line of JSON to stdout and nothing else |
What changes in the cloud
The agent source is identical. The runtime environment changes:
- No TUI — the agent is accessed over HTTP using the server routes you defined
- Environment values are read from the agent project's
.envat deploy time and are never included in source - Durable data persisted to GCS —
data/is backed by cloud storage, survives restarts - Isolated process — each agent runs in its own container
See Axon Cloud for the full deployment guide.