diff options
| author | Christophe Besson <cbesson@gmail.com> | 2026-08-09 21:55:12 +0200 |
|---|---|---|
| committer | Christophe Besson <cbesson@gmail.com> | 2026-08-09 21:55:12 +0200 |
| commit | a4dbeb368d19f6afc0f6da3819c8e0d6242b0732 (patch) | |
| tree | 10a346747bdd8f6eea548ba99f08eedb1941e312 /docs | |
| parent | 5f671267730e2d73b951f7d97d437ce8e47873a2 (diff) | |
| download | meshbay-a4dbeb368d19f6afc0f6da3819c8e0d6242b0732.tar.gz | |
fix: venv --clear required when copying repo across OS (Fedora→Ubuntu)
Root cause: certifi.where() in the Fedora venv points to
/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem which does not
exist on Ubuntu. 'python3 -m venv .venv' without --clear keeps the
Fedora certifi paths. Fix: always use --clear when recreating a venv
on a different OS.
Documented in QUICKSTART.md and CLAUDE.md.
rsync command updated to exclude .venv/ (in QE/server-state, not versioned).
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/QUICKSTART.md | 19 |
1 files changed, 8 insertions, 11 deletions
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md index b5ca327..2fa5af0 100644 --- a/docs/QUICKSTART.md +++ b/docs/QUICKSTART.md @@ -17,21 +17,18 @@ cd ~/meshbay # le dépôt local (pas encore publié sur GitHub) python3 -m venv .venv && source .venv/bin/activate ``` -> **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. +> **Important — ne pas copier `.venv/` entre machines d'OS différents.** +> Le venv est spécifique à l'OS. Si vous avez cloné/copié le repo depuis une machine Fedora +> vers Ubuntu (ou inversement), le venv doit être recréé avec `--clear` : ```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 +python3 -m venv .venv --clear # ← --clear force la recréation propre +source .venv/bin/activate +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`. +Sans `--clear`, pip peut échouer avec `FileNotFoundError` dans `certifi` parce qu'il +cherche les certificats CA à un chemin valide sur l'OS d'origine mais absent sur l'OS cible. --- |