---
description: Push and pull images from Roboto's private container registry.
sidebar:
  order: 7
title: roboto images
---
```bash
roboto images [-h]
              {delete-image,delete-repository,list,list-repos,login,pull,push} ...
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |

## roboto images delete-image

Delete a container image hosted in Roboto's image registry. Requires Docker CLI.

```bash
roboto images delete-image [-h] [--org ORG] remote_image
```

**Arguments**

| Argument | Description |
| --- | --- |
| `remote_image` Required | Specify the remote image to delete, in the format `<repository>:<tag>`. |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |

## roboto images delete-repository

Delete an image repository hosted in Roboto's image registry. Requires Docker CLI.

```bash
roboto images delete-repository [-h] [--org ORG] [--force]
                                repository_name
```

**Arguments**

| Argument | Description |
| --- | --- |
| `repository_name` Required | The name of the image repository to delete. |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |
| `--force` | Force deletion of the repository, even if it is not empty. |

## roboto images list

List container images hosted in Roboto's image registry.

```bash
roboto images list [-h] [--org ORG] [--repository-name REPOSITORY_NAME]
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |
| `--repository-name <repository_name>` | Filter list of images by repository name. |

## roboto images list-repos

List image repositories hosted in Roboto's image registry.

```bash
roboto images list-repos [-h] [--org ORG]
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |

## roboto images login

Temporarily login to Roboto's image registry. Requires Docker CLI. Login is valid for 12 hours and is scoped to a particular repository.

```bash
roboto images login [-h] [--org ORG] --repository-uri REPOSITORY_URI
                    [--permissions {ReadOnly,ReadWrite}]
```

**Arguments**

| Argument | Description |
| --- | --- |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |
| `--repository-uri <repository_uri>` Required | Image repository within Roboto's image registry. Login credentials will be scoped to this repository. |
| `--permissions {ReadOnly,ReadWrite}` | Specify the access level for the temporary credentials. Default: `ReadWrite`. |

## roboto images pull

Pull a container image hosted in Roboto's image registry. Requires Docker CLI.

```bash
roboto images pull [-h] [--org ORG] remote_image
```

**Arguments**

| Argument | Description |
| --- | --- |
| `remote_image` Required | Specify the remote image to pull, in the format `<repository>:<tag>`. |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |

## roboto images push

Push a local container image into Roboto's image registry. Requires Docker CLI.

```bash
roboto images push [-h] [--org ORG] [-q] local_image
```

**Arguments**

| Argument | Description |
| --- | --- |
| `local_image` Required | Specify the local image to push, in the format `<repository>:<tag>`. If no tag is specified, `latest` is assumed. Image must exist locally (i.e. `docker images` must list it). |
| `-h, --help` | show this help message and exit |
| `--org <org>` | The calling organization ID. Gets set implicitly if in a single org. The `ROBOTO_ORG_ID` environment variable can be set to control the default value; without it, the default is the `org_id` of the config file profile in use, which `roboto setup` saves. |
| `-q, --quiet` | Only output the image URI, terminated by a newline, if successful. |