Skip to main content
aion serve reads aion.yaml, starts one process per configured agent, and starts a proxy server for unified routing.

​
Usage

aion serve [OPTIONS]

​
Options

OptionDescription
--portFixed proxy port. Agent ports are allocated after this port.
--port-range-startStart of auto-assignment range for proxy and agents.
--port-range-endEnd of auto-assignment range for proxy and agents.
--startup-timeoutSeconds to wait for startup confirmation (0 to skip).

​
Examples

# Default dynamic ports
aion serve

# Fixed proxy port, sequential agent ports
aion serve --port 10000

# Restrict all services to range
aion serve --port-range-start 7000 --port-range-end 7100

# Skip startup confirmation
aion serve --startup-timeout 0

​
Startup Behavior

  • Validates and loads aion.yaml.
  • Loads environment variables from system or .env.
  • Reserves proxy and agent ports.
  • Starts agent server processes and proxy process.
  • Prints direct and proxy URLs for each agent.
  • If control plane credentials are present, attempts deployment metadata lookup, platform websocket connection, and manifest registration.
  • Without control plane credentials, local direct and proxy A2A endpoints still start, but control plane connectivity and automatic registration are unavailable.