summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTommaso Sciortino <[email protected]>2025-08-13 10:30:15 -0700
committerGitHub <[email protected]>2025-08-13 17:30:15 +0000
commit74a13fb535b255797d6c9aa3499acfea6aadc58d (patch)
tree758a98446a32141bddea1810a4fa6bdc1c4341dc /docs
parentf81ccd8d7a996dc3f8b9dbc2fab1e428d482d6a5 (diff)
Document certificate issue workaround (#6157)
Diffstat (limited to 'docs')
-rw-r--r--docs/troubleshooting.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index dde2a8ef..9506859a 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -19,6 +19,11 @@ This guide provides solutions to common issues and debugging tips, including top
[Google AI Studio](http://aistudio.google.com/app/apikey), which also includes a
separate free tier.
+- **Error: `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` or `unable to get local issuer certificate`**
+ - **Cause:** You may be on a corporate network with a firewall that intercepts and inspects SSL/TLS traffic. This often requires a custom root CA certificate to be trusted by Node.js.
+ - **Solution:** Set the `NODE_EXTRA_CA_CERTS` environment variable to the absolute path of your corporate root CA certificate file.
+ - Example: `export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt`
+
## Frequently asked questions (FAQs)
- **Q: How do I update Gemini CLI to the latest version?**