Installation via Git (odoo.sh)

Wenn Sie Odoo auf der Cloud-Plattform odoo.sh betreiben, erfolgt die Modulinstallation über Git. Diese Anleitung führt Sie Schritt für Schritt durch den Prozess — auch wenn Sie noch nie mit Git gearbeitet haben.

Warum Git?

odoo.sh ist eng mit Git verzahnt. Jeder Push in einen Branch löst automatisch einen neuen Build aus. Das bringt drei große Vorteile:

  • Versionierung: Jede Änderung ist nachvollziehbar.
  • Einfache Updates: Neue Modul-Version einspielen ist ein Befehl.
  • Rückrollmöglichkeit: Bei Problemen springen Sie auf den letzten funktionierenden Stand zurück.

Was ist Git?

Git ist eine Versionsverwaltungssoftware. Stellen Sie sich Git wie ein “Logbuch für Dateien” vor: Es speichert nicht nur die aktuelle Version eines Ordners, sondern auch dessen komplette Historie. Jeder kann sehen, wer wann was geändert hat — und Änderungen lassen sich jederzeit rückgängig machen.

Git installieren

Betriebssystem Installation
macOS Bereits vorinstalliert. Test: git --version im Terminal
Windows git-scm.com/download/win herunterladen und installieren
Linux sudo apt install git (Debian/Ubuntu) oder sudo dnf install git (Fedora)

Schritt 1: Repository klonen

Öffnen Sie das Terminal (macOS/Linux) bzw. Git Bash (Windows) und führen Sie folgende Befehle aus:

git clone -b IHR-BRANCH https://github.com/IHR-USER/IHR-REPO.git
cd IHR-REPO

Was passiert hier?
Dieser Befehl lädt eine Kopie Ihres odoo.sh-Repositories aus dem angegebenen Branch auf Ihren Computer. Anschließend wechseln Sie in diesen Ordner.

Ersetzen Sie IHR-USER/IHR-REPO durch den tatsächlichen Pfad Ihres Repositories. Diesen finden Sie in der odoo.sh-Konsole oder direkt auf GitHub.

Hinweis zum Branch

Ersetzen Sie IHR-BRANCH durch den Namen Ihres Produktions- oder Staging-Branches (z.B. main, production oder staging). Diesen finden Sie in Ihrer odoo.sh-Konsole unter “Branches”.

Schritt 2: Altes Modul entfernen (falls vorhanden)

rm -rf itscope_connector

Was passiert hier?
Dieser Befehl löscht eine eventuell vorhandene alte Version des Moduls. Das ist nötig, damit beim Entpacken keine Reste vermischt werden.

Schritt 3: Neues Modul entpacken

unzip ~/Downloads/itscope_connector-*.zip -d .

Was passiert hier?
Entpackt die heruntergeladene ZIP-Datei in den aktuellen Ordner. Die ZIP haben Sie zuvor aus dem Connector-Portal heruntergeladen.

Falls Sie die ZIP per Doppelklick entpackt haben

Wenn Sie die ZIP-Datei nicht im Terminal, sondern per Doppelklick entpackt haben (z.B. im Finder auf Mac oder Explorer auf Windows), liegt der Ordner itscope_connector/ noch in Ihrem Downloads-Ordner — nicht im Git-Repository!

Sie müssen den Ordner manuell verschieben:

  • Mac (Finder): Ziehen Sie den Ordner itscope_connector aus dem Downloads-Ordner in den Ordner Ihres geklonten Repositories (z.B. IHR-REPO/)
  • Windows (Explorer): Schneiden Sie den Ordner itscope_connector aus (Strg+X) und fügen Sie ihn im Repository-Ordner ein (Strg+V)
  • Oder im Terminal:
    mv ~/Downloads/itscope_connector IHR-REPO/

Danach weiter mit Schritt 4 (“Prüfen”).

Schritt 4: Prüfen

ls itscope_connector/__manifest__.py

Was passiert hier?
Prüft, ob das Modul korrekt entpackt wurde. Wenn der Pfad ausgegeben wird, ist alles in Ordnung. Erscheint stattdessen “No such file or directory”, wiederholen Sie Schritt 3.

Schritt 5: Änderungen hochladen

git add -A
git commit -m "Update ITscope Connector"
git push origin IHR-BRANCH

Was passiert hier?

  • git add -A — Markiert alle geänderten und neuen Dateien für den nächsten Commit.
  • git commit -m "..." — Speichert die Änderungen lokal mit der angegebenen Beschreibung.
  • git push origin IHR-BRANCH — Lädt die lokalen Änderungen auf den Server (in Ihren Branch).

Was passiert danach?

Sobald der Push abgeschlossen ist, erkennt odoo.sh die Änderung und startet automatisch einen neuen Build. Sie können den Fortschritt in der odoo.sh-Konsole verfolgen. Nach erfolgreichem Build ist das aktualisierte Modul unter Apps verfügbar.

Branch-Konzept

Branch bedeutet “Zweig”. In Git sind Branches parallele Entwicklungslinien. Ihr Produktionsbranch (z.B. main oder production) steuert, was Ihre Endkunden sehen. Daneben gibt es oft staging (Vorschau) und Feature-Branches für Tests.

Troubleshooting

Fehler Ursache Lösung
Permission denied (publickey) SSH-Key fehlt oder Token zu schwach SSH-Key bei GitHub hinterlegen oder Personal Access Token mit repo-Scope erstellen
Merge conflict Lokal und auf Server unterschiedliche Stände git pull --rebase origin IHR-BRANCH ausführen, dann erneut pushen
Modul in Odoo nicht sichtbar Addon-Liste veraltet Im Odoo-Backend: Apps → Addon-Liste aktualisieren
Build schlägt fehl Manifest-Fehler oder Syntax odoo.sh-Build-Log prüfen, Modul-ZIP erneut herunterladen

Weiterführende Artikel