Skip to content

"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files

docs: add tips about outdated certificates

Binbin Qian4af2f01abc97
diff --git a/docs/content/faq.md b/docs/content/faq.md
index 28608f2d9..e2cb94ac2 100644
--- a/docs/content/faq.md
+++ b/docs/content/faq.md
@@ -158,11 +158,14 @@ support an HTTP CONNECT proxy (
[--ftp-http-proxy](https://rclone.org/ftp/#ftp-http-proxy) and
[--sftp-http-proxy](https://rclone.org/ftp/#sftp-http-proxy) )
-### Rclone gives x509: failed to load system roots and no roots provided error
+### Rclone gives x509 SSL root certificates error
-This means that `rclone` can't find the SSL root certificates. Likely
-you are running `rclone` on a NAS with a cut-down Linux OS, or
-possibly on Solaris.
+`x509: failed to load system roots and no roots provided` means that `rclone` can't
+find the SSL root certificates. Likely you are running `rclone` on a NAS with
+a cut-down Linux OS, or possibly on Solaris.
+
+`x509: certificate signed by unknown authority` error may occur on outdated systems,
+where `rclone` can't verify the server with the SSL root certificates.
Rclone (via the Go runtime) tries to load the root certificates from
these places on Linux.
@@ -194,6 +197,16 @@ if it doesn't work without.
curl --insecure -o /etc/ssl/certs/ca-certificates.crt https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt
```
+On macOS, you can install
+[ca-certificates](https://formulae.brew.sh/formula/ca-certificates) with
+Homebrew, and specify the SSL root certificates with the
+[--ca-cert](/docs/#ca-cert-stringarray) flag.
+
+```sh
+brew install ca-certificates
+find $(brew --prefix)/etc/ca-certificates -type f
+```
+
### Rclone gives Failed to load config file: function not implemented error
Likely this means that you are running rclone on Linux version not