Skip to main content

Stuck when mounting JuiceFS

If the JuiceFS mounting process getting stuck and continually retries, it may be due to a variety of reasons. When troubleshooting, you can try to upgrade your client version to the latest:

sudo juicefs version --upgrade

If the issue still occurred after upgrading the client to the latest version, add the -f -v parameter to the mount command to run the mounting process in the foreground and output debugging information to troubleshoot the issue. E.g:

sudo juicefs mount VOLUME_NAME /jfs -f -v

If the debug information indicates that resolve the domain name failed, please confirm that the upstream DNS server is working and flush the local DNS cache.

If the domain name can be correctly resolved but unable to connect to the metadata server, it is likely that the firewall has restricted port access and JuiceFS unable to connect to the metadata server. Please make sure that the machine has access permission to the internet 9300 - 9500 range port to enable it to communicate with our metadata server.

If you are using the local iptables firewall, you can execute the following command to allow the 9300 - 9500 range port:

sudo iptables -A OUTPUT -p tcp --match multiport --dports 9300:9500 -j ACCEPT

If you are using the firewall policy of the public cloud platform, log in to the console of the public cloud for configuration. For details, please refer to the documentation of the corresponding public cloud.

If you still can't solve the problem, feel free to reach us using the live chat at the right bottom of our website, or send us an email.