Use NFSEstimated reading time: 2 minutes
You can configure DTR to store Docker images in an NFS directory.
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.6.2 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 upgrading from a previous version of DTR that is already using NFS, you can continue using the same configurations. To support NFS v4, additional NFS reconfiguration options have been added to the CLI. See docker/dtr reconfigure for more details.
To take advantage of the new DTR built-in support for NFS, you can reconfigure DTR to use NFS:
docker run -it --rm docker/dtr:2.6.2 reconfigure \ --nfs-storage-url <nfs-storage-url>
To reconfigure DTR to stop using NFS storage, leave the
docker run -it --rm docker/dtr:2.6.2 reconfigure \ --nfs-storage-url ""
If the IP address of your NFS server changes with the DNS address staying the same, you should still reconfigure DTR to stop using NFS storage, and then add it back again.