From ab58ae5b03b655632ab6941129aa5ebca032261e Mon Sep 17 00:00:00 2001 From: remygrandin Date: Tue, 26 Nov 2024 20:56:10 +0100 Subject: [PATCH] docs: add docker volume plugin troubleshooting steps This proposal expand the current docker volume plugin troubleshooting possible steps to include a state cleanup command and a reminder that a un/reinstall don't clean up those cache files. Co-authored-by: albertony <12441419+albertony@users.noreply.github.com> --- docs/content/docker.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/content/docker.md b/docs/content/docker.md index 4c502b9a0..973df188b 100644 --- a/docs/content/docker.md +++ b/docs/content/docker.md @@ -537,6 +537,13 @@ sudo curl -H Content-Type:application/json -XPOST -d {} --unix-socket /run/docke ``` though this is rarely needed. +If the plugin fails to work properly, and only as a last resort after you tried diagnosing with the above methods, you can try clearing the state of the plugin. **Note that all existing rclone docker volumes will probably have to be recreated.** This might be needed because a reinstall don't cleanup existing state files to allow for easy restoration, as stated above. +``` +docker plugin disable rclone # disable the plugin to ensure no interference +sudo rm /var/lib/docker-plugins/rclone/cache/docker-plugin.state # removing the plugin state +docker plugin enable rclone # re-enable the plugin afterward +``` + ## Caveats Finally I'd like to mention a _caveat with updating volume settings_.