Skip to content

armgit / dashy

Public Imported from GitHub
0

πŸš€ A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!

πŸ“ Adds troubleshooting note for widget cert errors

Alicia Sykesa2e459cbf4a5
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 7294449f..ac946a36 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -85,6 +85,7 @@
- [Fixing Widget CORS Errors](#widget-cors-errors)
- [CORS Proxy connect ECONNREFUSED or ENOTFOUND](#cors-proxy-connect-econnrefused--or-getaddrinfo-enotfound-)
- [CORS Proxy Target-URL host blocked or scheme rejected](#cors-proxy-target-url-host--is-blocked--must-use-http-or-https)
+ - [CORS Proxy TLS certificate errors](#cors-proxy-unable_to_verify_leaf_signature-or-err_tls_cert_altname_invalid)
- [Widget Shows Error Incorrectly](#widget-shows-error-incorrectly)
- [Weather Forecast Widget 401](#weather-forecast-widget-401)
- [Widget Displaying Inaccurate Data](#widget-displaying-inaccurate-data)
@@ -920,6 +921,10 @@ The variable is named so loudly because flipping it on a Dashy instance that's e
Note that this is an all-or-nothing escape hatch, not a per-host allowlist. If you only need to reach one specific host that's currently blocked, please open a feature request describing the use case.
+### CORS Proxy `UNABLE_TO_VERIFY_LEAF_SIGNATURE` or `ERR_TLS_CERT_ALTNAME_INVALID`
+
+The target's certificate can't be verified - it's self-signed, issued by a private CA, or issued for a different hostname than the one you're requesting. If you trust the host, add `allowInsecure: true` to the widget (`useProxy: true` is needed too). To keep verification on instead, mount your CA into the container and point `NODE_EXTRA_CA_CERTS` at it. See [Ignoring Certificate Errors](/docs/widgets.md#ignoring-certificate-errors).
+
### Widget Shows Error Incorrectly
When there's an error fetching or displaying a widgets data, then it will be highlighted in yellow, and a message displayed on the UI.