diff options
| author | Christophe Besson <cbesson@gmail.com> | 2026-08-09 21:43:31 +0200 |
|---|---|---|
| committer | Christophe Besson <cbesson@gmail.com> | 2026-08-09 21:43:31 +0200 |
| commit | 5f671267730e2d73b951f7d97d437ce8e47873a2 (patch) | |
| tree | 65112f0c1fa3cc6e7f78c27606b65817e41c91f9 /docs/QUICKSTART.md | |
| parent | 44b9e74153f5e32b3665f319429b3b08fd3662d5 (diff) | |
| download | meshbay-5f671267730e2d73b951f7d97d437ce8e47873a2.tar.gz | |
fix: document pip SSL_CERT_FILE workaround for Python 3.14 on Ubuntu/Fedora
pip + Python 3.14 fails with FileNotFoundError in certifi.where() on fresh
venvs (truststore bug). Fix: SSL_CERT_FILE pointing to system CA bundle.
Documented in CLAUDE.md (Python environment section) and QUICKSTART.md.
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Diffstat (limited to 'docs/QUICKSTART.md')
| -rw-r--r-- | docs/QUICKSTART.md | 21 |
1 files changed, 17 insertions, 4 deletions
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md index 2f1a728..b5ca327 100644 --- a/docs/QUICKSTART.md +++ b/docs/QUICKSTART.md @@ -13,13 +13,26 @@ Le node tourne sur votre machine et héberge vos fichiers. - Un accès à `https://meshbay.org` ```bash -git clone <url-du-repo> ~/meshbay -cd ~/meshbay +cd ~/meshbay # le dépôt local (pas encore publié sur GitHub) python3 -m venv .venv && source .venv/bin/activate -pip install -e packages/meshbay-common -e packages/meshbay-node -pip install httpx blake3 uvicorn ``` +> **Bug pip + Python 3.14 (Ubuntu & Fedora)** : pip peut échouer avec +> `FileNotFoundError` dans `certifi`. Fix : passer la variable `SSL_CERT_FILE` +> pointant vers les CA système. + +```bash +# Sur Ubuntu / meshbay.org +SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt \ + pip install -e packages/meshbay-common -e packages/meshbay-node httpx blake3 uvicorn + +# Sur Fedora (machine locale) +SSL_CERT_FILE=/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem \ + pip install -e packages/meshbay-common -e packages/meshbay-node httpx blake3 uvicorn +``` + +Une fois `certifi` correctement installé, les `pip install` suivants n'ont plus besoin de `SSL_CERT_FILE`. + --- ## Étape 1 — Setup (alice crée le groupe et invite bob) |