From 5083f51d681baf37a83a083fcd5cb4108eebcbfa Mon Sep 17 00:00:00 2001
From: samypr100 <3933065+samypr100@users.noreply.github.com>
Date: Fri, 1 Mar 2024 20:37:27 -0500
Subject: [PATCH] docs: add note about ssl_cert_file env var (#2124)

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 4395e14f4..43fa4ef7f 100644
--- a/README.md
+++ b/README.md
@@ -369,6 +369,16 @@ to build on aarch64 Windows, but does not consider either platform to be support
 
 uv supports and is tested against Python 3.8, 3.9, 3.10, 3.11, and 3.12.
 
+## Custom CA Certificates
+
+`uv` supports custom CA certificates (such as those needed by corporate proxies) by utilizing the
+system's trust store. To ensure this works out of the box, ensure your certificates are added to the
+system's trust store.
+
+If a direct path to the certificate is required (e.g., in CI), set the `SSL_CERT_FILE` environment
+variable to the path of the certificate bundle, to instruct `uv` to use that file instead of the
+system's trust store.
+
 ## Acknowledgements
 
 uv's dependency resolver uses [PubGrub](https://github.com/pubgrub-rs/pubgrub) under the hood.