---
title: Charmhub | Deploy Docker Registry using Charmhub - The Open Operator Collection
description: Deploy the latest version of Docker Registry on any cloud.
url: https://charmhub.io/docker-registry/actions
---

# Docker Registry

[Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

* [Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

Platform:

jammy

24.04

22.04

20.04

18.04

16.04

stable 95bea90

```
juju deploy docker-registry
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [clean-containers](https://charmhub.io/docker-registry/actions#clean-containers)
* [clean-images](https://charmhub.io/docker-registry/actions#clean-images)
* [debug](https://charmhub.io/docker-registry/actions#debug)
* [images](https://charmhub.io/docker-registry/actions#images)
* [push](https://charmhub.io/docker-registry/actions#push)
* [rmi](https://charmhub.io/docker-registry/actions#rmi)
* [start](https://charmhub.io/docker-registry/actions#start)
* [stop](https://charmhub.io/docker-registry/actions#stop)
* [upgrade-docker](https://charmhub.io/docker-registry/actions#upgrade-docker)

[Learn about actions >](https://juju.is/docs/juju/action)

* clean-containers

  Garbage collect non-running containers
* clean-images

  Garbage collect non-running images
* debug

  Collect debug data
* images

  List images known by this registry.

  Params

  + options
    string

    Space separated options to pass to the underlying 'docker images'
    command. For example, to list all images (including intermediates)
    along with digests, run this action with 'options="--all --digests"'.
  + repository
    string

    Optional [REPOSITORY[:TAG]] to list images in a given repository. If
    unspecified, all images known to the registry are listed.
* push

  Tag and push an image to this registry.

  Params

  + image
    string

    Image name, which may include an optional :version string. If the
    version is omitted, docker will assume ':latest'. This may be an
    unqualified local image (e.g. ubuntu:18.04) or a fully qualified
    remote registry (e.g. myregistry.example.com:5000/myimage:latest).
  + pull
    boolean

    Pull the given image before tag/push.
  + tag
    string

    Tag name to use. By default, images are tagged with
    'net\_location/name:version'.

  Required

  image
* rmi

  Remove image(s) from this registry.

  Params

  + image
    string

    Image (or space separated images) to remove. This can be be an image
    id, tag, or digest.
  + options
    string

    Space separated options to pass to the underlying 'docker rmi'
    command. For example, to force image removal, run this action with
    'options="--force"'.

  Required

  image
* start

  Start a named registry container. With no arguments, this action starts
  the registry container configured by the charm 'registry-name' option.

  Params

  + name
    string

    Optional name of the registry container to start.
* stop

  Stop a named registry container. With no arguments, this action stops
  the registry container configured by the charm 'registry-name' option.

  Params

  + name
    string

    Optional name of the registry container to stop.
  + remove
    boolean

    Remove the registry container after stopping.
* upgrade-docker

  Force upgrades Docker to latest repository version