---
title: Container
description: Run and manage containers.
canonical: 'https://lightning.ai/docs/cli/stable/command-details/container'
---
# Container {#container}

Run and manage containers.

**Usage:**

```console
lightning container [OPTIONS] COMMAND [ARGS]...
```

## Commands {#container-commands}

| Command | Description |
| --- | --- |
| [`delete`](#container-delete) | Delete the docker container NAME. |
| [`download`](#container-download) | Download a docker container from a teamspace. |
| [`list`](#container-list) | Display the list of available containers. |
| [`upload`](#container-upload) | Upload a container to Lightning AI’s container registry. |

## lightning container delete {#container-delete}

Delete the docker container NAME.

**Usage:**

```console
lightning container delete [OPTIONS] NAME
```

### Arguments {#container-delete-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `NAME` | `text` | yes | Container name to delete. |

### Options {#container-delete-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--teamspace` | `TEXT` | no | `Sentinel.UNSET` | The teamspace to delete the container from. Should be specified as {owner}/{name}. Defaults to the configured teamspace. |
| `--yes`, `-y` | — | no | — | Delete without prompting for confirmation. |

## lightning container download {#container-download}

Download a docker container from a teamspace.

**Usage:**

```console
lightning container download [OPTIONS] CONTAINER
```

### Arguments {#container-download-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `CONTAINER` | `text` | yes | Container name to download. |

### Options {#container-download-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--teamspace` | `TEXT` | no | — | The name of the teamspace to download the container from |
| `--tag` | `TEXT` | no | `'latest'` | The tag of the container to download. |
| `--cloud-account`, `--cloud_account` | `TEXT` | no | — | The name of the cloud account to download the Container from. |

## lightning container list {#container-list}

Display the list of available containers.

**Usage:**

```console
lightning container list [OPTIONS]
```

### Options {#container-list-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--teamspace` | `TEXT` | no | — | the teamspace to list containers from. Should be specified as {owner}/{name}. Defaults to the configured teamspace. |
| `--cloud-account`, `--cloud_account` | `TEXT` | no | — | The name of the cloud account where containers are stored in. |
| `--json` | — | no | — | Output as JSON. |

## lightning container upload {#container-upload}

Upload a container to Lightning AI’s container registry.

**Usage:**

```console
lightning container upload [OPTIONS] CONTAINER
```

### Arguments {#container-upload-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `CONTAINER` | `text` | yes | Container name to upload. |

### Options {#container-upload-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--tag` | `TEXT` | no | `'latest'` | The tag of the container to upload. |
| `--teamspace` | `TEXT` | no | — | The teamspace the studio is part of. Should be of format <OWNER>/<TEAMSPACE\_NAME>. If not specified, tries to infer from the environment (e.g. when run from within a Studio.) |
| `--cloud-account`, `--cloud_account` | `TEXT` | no | — | The name of the cloud account to store the Container in. |
| `--platform` | `TEXT` | no | `'linux/amd64'` | This is the platform the container pulled and push to Lightning AI will run on. |

---

**Navigation**

- Parent: [Command details](/docs/cli/2026.11.04/command-details.md)