diff --git a/README.md b/README.md new file mode 100644 index 0000000..d96d5eb --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +Um die Library sauber in einer isolierten Umgebung auf deinem neuen Server zu installieren, gehst du in dein Projektverzeichnis und führst diese drei Schritte aus. Das verhindert, dass sich verschiedene Python-Projekte in die Quere kommen. + +### 1. Die Umgebung erstellen +Zuerst erstellst du einen Ordner (meist `venv` genannt), der eine eigene Kopie von Python und `pip` enthält: + +```bash +# Erstellt die virtuelle Umgebung +python3 -m venv venv +``` + +### 2. Die Umgebung aktivieren +Damit dein Terminal weiß, dass es ab jetzt das Python aus diesem Ordner nutzen soll, musst du es aktivieren. Du erkennst den Erfolg am `(venv)` vor deinem Prompt: + +```bash +source venv/bin/activate +``` + +### 3. Die Library installieren +Jetzt kannst du `pip` nutzen. Da die Umgebung aktiv ist, wird die Library **nur** in diesem Ordner installiert und nicht systemweit: + +```bash +pip install inwx-domrobot +``` + +--- + +### Kurzer Check zur Sicherheit +Du kannst sofort prüfen, ob alles an der richtigen Stelle gelandet ist: + +* **Paket-Check:** `pip list` (Hier sollte `inwx-domrobot` auftauchen). +* **Pfad-Check:** `which python3` (Sollte den Pfad zu deinem Projektordner anzeigen, nicht `/usr/bin/python3`). + +### Wie geht es weiter? +Wenn du fertig bist oder das Terminal schließt, kannst du die Umgebung mit dem Befehl `deactivate` wieder verlassen. Wenn du das Skript später erneut ausführen willst, musst du vorher nur wieder den `source`-Befehl aus Schritt 2 eingeben. + +**Tipp für den neuen Server:** Falls `python3 -m venv` eine Fehlermeldung ausgibt ("venv not found"), musst du das entsprechende System-Paket unter Ubuntu/Debian einmalig nachinstallieren: +`sudo apt update && sudo apt install python3-venv -y` +