Lately I had a need to move the Docker root directory to a different filesystem. After researching the item and saw that the documentation out there was limited and not very clear, I decided to write the necessary steps here.<\/p>\r\n
By default, on most systems, the\u00a0docker<\/strong> root directory is located in the directory\u00a0\/var\/lib\/docker<\/strong>, this directory is used to store thigs like images, volumes, and other different docker runtime items. In order to move this directory to a different location, let’s say\u00a0\/opt\/docker-root<\/strong>, there are few steps required, more specifically:<\/p>\r\n <\/p>\r\n Now, let’s discuss in details how to accomplish each of the items listed above, which they can variate depending on the operating system used, this guide assumes that you are using Ubuntu or Ubuntu derivative. If you are using something else, you might encounter differences in the commands, if you do, refer to the OS documentation for the alternative commands.<\/p>\r\n In order to stop the docker daemon, you would type the following command:<\/p>\r\n systemctl stop docker<\/p>\r\n<\/blockquote>\r\n If you installed docker using an alternative method, you should be familiar on how to stop the background process.<\/p>\r\n This step is heavily dependent on what type of filesystem you are running, the operating system you are using, etc. Create a filesystem goes beyond this guide. Plenty of guides on the internet on how to do that.<\/p>\r\n In order to move the content to the new location, you first copy the existing content with the following command:<\/p>\r\n cp -a \/var\/lib\/docker\/* \/opt\/docker-root\/<\/p>\r\n<\/blockquote>\r\n This command might take a while depending on how big the docker installation is, so be patent!<\/p>\r\n The rename and delete in later steps will complete the move.<\/p>\r\n In this step we will instruct the dockerd command to use an alternative application root directory. If you using a recent Ubuntu distribution, you are using systemd, and the file will be located under \/etc. More precisely:<\/p>\r\n If the file is located elsewhere, refer to the installation of docker used to find the configuration file.<\/p>\r\n Now, use your prefer editor to open and modify the following line in the file.<\/p>\r\n From:<\/p>\r\n ExecStart=\/usr\/bin\/dockerd -H fd:\/\/ –containerd=\/run\/containerd\/containerd.sock<\/p>\r\n<\/blockquote>\r\n To:<\/p>\r\n <\/p>\r\n ExecStart=\/usr\/bin\/dockerd –data-root \/opt\/app\/docker-root -H fd:\/\/ –containerd=\/run\/containerd\/containerd.sock<\/p>\r\n<\/blockquote>\r\n If you notice, the command line argument –data-root \/opt\/app\/docker-root has been added to the ExecStart variable. \/opt\/app\/docker-root is the default this guide is using, but you can use whatever location you prefer.<\/p>\r\n Now on to the next step<\/p>\r\n In order for the change to be picked up by systemd, use the following comand:<\/p>\r\n systemd daemon-reload<\/p>\r\n<\/blockquote>\r\n Now you can start the docker daemon with the new config applied.<\/p>\r\n Much like the stop command, the start command is very similar:<\/p>\r\n systemctl start docker<\/p>\r\n<\/blockquote>\r\n In order to verify that the root directory has been correctly moved. Do the following:<\/p>\r\n At this point, the move is completed.<\/p>\r\n Thank you for following this guide and type away!!!<\/p>\r\n <\/p>\r\n","protected":false},"excerpt":{"rendered":" Lately I had a need to move the Docker root directory to a different filesystem. After researching the item and saw that the documentation out there was limited and not very clear, I decided to write the necessary steps here. By default, on most systems, the\u00a0docker root directory is located in the directory\u00a0\/var\/lib\/docker, this directory … Continue reading “Relocate Docker Data Root Directory”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_uf_show_specific_survey":0,"_uf_disable_surveys":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-245","post","type-post","status-publish","format-standard","hentry","category-unix"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/posts\/245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/comments?post=245"}],"version-history":[{"count":8,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/posts\/245\/revisions"}],"predecessor-version":[{"id":261,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/posts\/245\/revisions\/261"}],"wp:attachment":[{"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/media?parent=245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/categories?post=245"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pipeawk.com\/index.php\/wp-json\/wp\/v2\/tags?post=245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\r\n
Stop the docker daemon<\/h3>\r\n
\r\n
Create the filesystem and mountpoint<\/h3>\r\n
Move the file content to the new location<\/h3>\r\n
\r\n
Update docker startup command<\/h3>\r\n
\r\n
\r\n
\r\n
Refresh systemd configuration<\/h3>\r\n
\r\n
Start the docker daemon<\/h3>\r\n
\r\n
Examine the directory \/var\/lib for the presence of the docker directory<\/h3>\r\n
\r\n