From 8db4dd92ea069fce67eedb2ad72509dc3aa5c380 Mon Sep 17 00:00:00 2001
From: M V Midhun <113450475+venkatmidhunmareedu@users.noreply.github.com>
Date: Wed, 18 Feb 2026 15:08:50 +0530
Subject: [PATCH] docs(readme): Document possible TLS certificate errors in
 README

Added a section for possible errors and their fixes related to TLS certificate verification in Termux.
---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 59b9bea7c..7e203533a 100644
--- a/README.md
+++ b/README.md
@@ -113,6 +113,34 @@ termux-chroot ./picoclaw-linux-arm64 onboard
 And then follow the instructions in the "Quick Start" section to complete the configuration!
 <img src="assets/termux.jpg" alt="PicoClaw" width="512">
 
+<details> 
+<summary><b> Possible Errors you may encounter:</b> </summary>
+
+
+**1. tls: failed to verify certificate**
+
+```
+Error: LLM call failed: failed to send request: Post "https://<your-provider>/api/v1/chat/completions": tls: failed to verify certificate: x509: certificate signed by unknown authority
+```
+
+This error indicates that the application (`picoclaw`) cannot verify the security certificate of Your Provider API. This is a very common issue in **Termux** because the environment often lacks the latest root certificate authorities required to validate HTTPS connections.
+
+
+Fix : 
+Run the following 
+```bash
+pkg update && pkg upgrade
+pkg install ca-certificates openssl
+echo 'export SSL_CERT_FILE=/data/data/com.termux/files/usr/etc/tls/cert.pem' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**After running this:**
+
+1. Restart Termux (completely close the app and reopen it).
+2. Try running `picoclaw` again.
+</details>
+
 ### 🐜 Innovative Low-Footprint Deploy
 
 PicoClaw can be deployed on almost any Linux device!