BW3-Core/docu/docs/usage.md
KoenigMjr a3f429cbf4 [enh/venv]: feat(install): introduce venv-based runtime setup with proper permissions
Replace the implicit dependency on system-wide Python packages with a
dedicated virtual environment and explicit runtime dependency management.

Changes:
- Create a project-local Python venv during installation
- Install runtime dependencies explicitly via requirements-runtime.txt
- Fix ModuleNotFoundError issues in isolated environments (e.g. requests)
- Detect the actual user when running via sudo (SUDO_USER)
- Assign correct ownership to the BOSWatch directory for venv usage
- Apply setgid (2775) to the log directory so files created with sudo
  remain manageable by the user
- Set explicit permissions for Python scripts and config files

This ensures a reproducible, system-independent installation and prevents
permission issues during runtime and log creation.
2026-03-05 13:33:09 +01:00

25 lines
681 B
Markdown

# 🇩🇪 Start von BOSWatch3
Nach dem Neustart kannst du BOSWatch3 wie folgt starten:
```bash
cd /opt/boswatch3
sudo /opt/boswatch3/venv/bin/python3 bw_client.py -c client.yaml
sudo /opt/boswatch3/venv/bin/python3 bw_server.py -c server.yaml
```
## Optional: Als Dienst einrichten
Weiter gehts mit [als Service einrichten](service.md)
---
# 🇬🇧 Starting BOSWatch3
After reboot, you can start BOSWatch3 as follows:
```bash
cd /opt/boswatch3
sudo /opt/boswatch3/venv/bin/python3 bw_client.py -c client.yaml
sudo /opt/boswatch3/venv/bin/python3 bw_server.py -c server.yaml
```
## Optional: Setup as a Service
For further instructions, see [Setup as a Service](service.md)