> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elizaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Containers Command

> Manage ElizaOS Cloud container deployments

## Usage

```bash theme={null}
elizaos containers <subcommand> [options]
```

## Subcommands

| Subcommand | Alias | Description                          |
| ---------- | ----- | ------------------------------------ |
| `list`     | `ls`  | List all container deployments       |
| `delete`   | `rm`  | Delete a container deployment        |
| `logs`     | -     | Get logs from a container deployment |

***

## list

List all container deployments in your ElizaOS Cloud account.

### Usage

```bash theme={null}
elizaos containers list [options]
elizaos containers ls [options]
```

### Options

| Option                | Description           | Default                     |
| --------------------- | --------------------- | --------------------------- |
| `-u, --api-url <url>` | ElizaOS Cloud API URL | `https://www.elizacloud.ai` |
| `-k, --api-key <key>` | ElizaOS Cloud API key | -                           |
| `--json`              | Output as JSON        | `false`                     |

### Examples

```bash theme={null}
# 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

```bash theme={null}
elizaos containers delete [container-id] [options]
elizaos containers rm [container-id] [options]
```

### Arguments

| Argument         | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| `[container-id]` | Container ID to delete (auto-detects from project if omitted) |

### Options

| Option                      | Description                                               | Default                     |
| --------------------------- | --------------------------------------------------------- | --------------------------- |
| `-u, --api-url <url>`       | ElizaOS Cloud API URL                                     | `https://www.elizacloud.ai` |
| `-k, --api-key <key>`       | ElizaOS Cloud API key                                     | -                           |
| `-p, --project-name <name>` | Project name to find container (overrides auto-detection) | -                           |
| `--force`                   | Skip confirmation prompt                                  | `false`                     |

### Examples

```bash theme={null}
# 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

```bash theme={null}
elizaos containers logs [container-id] [options]
```

### Arguments

| Argument         | Description                                         |
| ---------------- | --------------------------------------------------- |
| `[container-id]` | Container ID (auto-detects from project if omitted) |

### Options

| Option                      | Description                      | Default                     |
| --------------------------- | -------------------------------- | --------------------------- |
| `-u, --api-url <url>`       | ElizaOS Cloud API URL            | `https://www.elizacloud.ai` |
| `-k, --api-key <key>`       | ElizaOS Cloud API key            | -                           |
| `-p, --project-name <name>` | Project name to find container   | -                           |
| `--follow`                  | Follow log output (streaming)    | `false`                     |
| `--tail <lines>`            | Number of lines to show from end | `100`                       |

### Examples

```bash theme={null}
# 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

```bash theme={null}
# 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
```

## Related Commands

* [`deploy`](/cli-reference/deploy): Deploy your project to ElizaOS Cloud
* [`login`](/cli-reference/login): Authenticate with ElizaOS Cloud