Skip to main content

​
Usage

elizaos containers <subcommand> [options]

​
Subcommands

SubcommandAliasDescription
listlsList all container deployments
deletermDelete a container deployment
logs-Get logs from a container deployment

​
list

List all container deployments in your ElizaOS Cloud account.

​
Usage

elizaos containers list [options]
elizaos containers ls [options]

​
Options

OptionDescriptionDefault
-u, --api-url <url>ElizaOS Cloud API URLhttps://www.elizacloud.ai
-k, --api-key <key>ElizaOS Cloud API key-
--jsonOutput as JSONfalse

​
Examples

# List all containers
elizaos containers list

# List with JSON output for scripting
elizaos containers list --json

# Use custom API URL
elizaos containers list --api-url https://custom.elizacloud.ai

​
delete

Delete a container deployment. Can auto-detect the container from your project or specify it explicitly.

​
Usage

elizaos containers delete [container-id] [options]
elizaos containers rm [container-id] [options]

​
Arguments

ArgumentDescription
[container-id]Container ID to delete (auto-detects from project if omitted)

​
Options

OptionDescriptionDefault
-u, --api-url <url>ElizaOS Cloud API URLhttps://www.elizacloud.ai
-k, --api-key <key>ElizaOS Cloud API key-
-p, --project-name <name>Project name to find container (overrides auto-detection)-
--forceSkip confirmation promptfalse

​
Examples

# Delete container by ID
elizaos containers delete abc123

# Delete container from current project (auto-detect)
elizaos containers delete

# Delete with force (skip confirmation)
elizaos containers delete abc123 --force

# Delete by project name
elizaos containers delete --project-name my-agent

​
logs

Get logs from a container deployment. Supports streaming and tail options.

​
Usage

elizaos containers logs [container-id] [options]

​
Arguments

ArgumentDescription
[container-id]Container ID (auto-detects from project if omitted)

​
Options

OptionDescriptionDefault
-u, --api-url <url>ElizaOS Cloud API URLhttps://www.elizacloud.ai
-k, --api-key <key>ElizaOS Cloud API key-
-p, --project-name <name>Project name to find container-
--followFollow log output (streaming)false
--tail <lines>Number of lines to show from end100

​
Examples

# Get recent logs from container
elizaos containers logs abc123

# Stream logs in real-time
elizaos containers logs abc123 --follow

# Get last 500 lines
elizaos containers logs abc123 --tail 500

# Get logs from current project's container
elizaos containers logs --follow

​
Authentication

All container commands require authentication with ElizaOS Cloud. You can provide credentials in two ways:
  1. API Key option: Use -k, --api-key option
  2. Environment variable: Set ELIZA_CLOUD_API_KEY
  3. Login command: Run elizaos login to authenticate
# Using API key option
elizaos containers list -k your-api-key

# Using environment variable
export ELIZA_CLOUD_API_KEY=your-api-key
elizaos containers list
  • deploy: Deploy your project to ElizaOS Cloud
  • login: Authenticate with ElizaOS Cloud