Use NFSEstimated reading time: 3 minutes
You can configure DTR to store Docker images in an NFS directory. Starting in DTR 2.6, changing storage backends involves initializing a new metadatastore instead of reusing an existing volume. This helps facilitate online garbage collection. See changes to NFS reconfiguration below if you have previously configured DTR to use NFS.
Before installing or configuring DTR to use an NFS directory, make sure that:
- The NFS server has been correctly configured
- The NFS server has a fixed IP address
- All hosts running DTR have the correct NFS libraries installed
To confirm that the hosts can connect to the NFS server, try to list the directories exported by your NFS server:
showmount -e <nfsserver>
You should also try to mount one of the exported directories:
mkdir /tmp/mydir && sudo mount -t nfs <nfs server>:<directory> /tmp/mydir
Install DTR with NFS
One way to configure DTR to use an NFS directory is at install time:
docker run -it --rm docker/dtr:2.7.3 install \ --nfs-storage-url <nfs-storage-url> \ <other options>
Use the format
nfs://<nfs server>/<directory> for the NFS storage URL. To support NFS v4, you can now specify additional options when running docker/dtr install with
When joining replicas to a DTR cluster, the replicas will pick up your storage configuration, so you will not need to specify it again.
Reconfigure DTR to use NFS
When running DTR 2.5 (with experimental online garbage collection) and 2.6.0 to 2.6.3, there is an issue with reconfiguring and restoring DTR with
--nfs-storage-urlwhich leads to erased tags. Make sure to back up your DTR metadata before you proceed. To work around the
--nfs-storage-urlflag issue, manually create a storage volume. If DTR is already installed in your cluster, reconfigure DTR with the
--dtr-storage-volumeflag using your newly-created volume.
See Reconfigure Using a Local NFS Volume for Docker’s recommended recovery strategy.
In DTR 2.6.4, a new flag,
--storage-migrated, has been added to
docker/dtr reconfigure which lets you indicate the migration status of your storage data during a reconfigure. Upgrade to 2.6.4 and follow Best practice for data migration in 2.6.4 when switching storage backends. The following shows you how to reconfigure DTR using an NFSv4 volume as a storage backend:
docker run --rm -it \ docker/dtr:2.7.3 reconfigure \ --ucp-url <ucp_url> \ --ucp-username <ucp_username> \ --nfs-storage-url <dtr-registry-nf> --async-nfs --storage-migrated
To reconfigure DTR to stop using NFS storage, leave the
docker run -it --rm docker/dtr:2.7.3 reconfigure \ --nfs-storage-url ""
Where to go next
- Switch storage backends
- Create a backup
- Restore from a backup
- Configure where images are stored
- CLI reference pages