Configure DTR image storageEstimated reading time: 2 minutes
By default DTR uses the local filesystem of the node where it is running to store your Docker images. You can configure DTR to use an external storage backend, for improved performance or high availability.
If your DTR deployment only has a single replica, you can continue using the local filesystem to store your Docker images. If your DTR deployment has multiple replicas, for high availability, you need to ensure all replicas are using the same storage backend. When a user pulls an image, the node serving the request needs to have access to that image.
DTR supports these storage systems:
- Local filesystem
- Amazon S3 or compatible
- Google Cloud Storage
- Microsoft Azure Blob storage
- OpenStack Swift
To configure the storage backend, you can log into the DTR web UI as an administrator user, navigate to the Settings page, and choose Storage.
The storage configuration page in the DTR web UI has options for the most common configuration options, but you can also upload a yaml configuration file.
The format of this configuration file is similar to the one used by Docker Registry.
By default, DTR creates a volume names
dtr-registry-<replica-id> to store
your images using the local filesystem. You can customize the name and path of
the volume used by DTR, using the
docker/dtr reconfigure --dtr-storage-volume
If you’re deploying DTR with high-availability, you need to use NFS or any other centralized storage backend so that all your DTR replicas have access to the same images.
To check how much space your images are taking in the local filesystem, you can ssh into the node where DTR is deployed and run:
# Find the path to the volume docker volume inspect dtr-registry-<replica-id> # Check the disk usage du -hs <path-to-volume>
You can configure your DTR replicas to store images on a NFS partition, so that all replicas can share the same storage backend.
DTR supports AWS3 or other storage systems that are S3-compatible like Minio. Learn how to configure DTR with Amazon S3.