Zum Inhalt springen

Dokumentation / Code und Addons

Addons installieren

Addons von GitHub auf deinen Odoo-Diensten bereitstellen.

Sobald du ein Repository verbunden hast, kannst du dessen Addons auf jedem deiner Odoo-Dienste bereitstellen.

Addon bereitstellen #

1. Dienst öffnen #

Navigiere zum Odoo-Dienst, auf dem du das Addon installieren möchtest.

2. Zum Addons-Tab gehen #

Klicke auf den Addons-Tab, um aktuell installierte und verfügbare Addons zu sehen.

3. Addon auswählen #

Durchsuche die verfügbaren Addons aus deinen verbundenen Repositories. Wähle das gewünschte Addon aus.

4. Bereitstellen #

Klicke auf Bereitstellen. calmo.cloud wird:

  1. Den Addon-Code aus dem Repository herunterladen
  2. Ihn in das Addon-Verzeichnis deines Dienstes kopieren
  3. Ihn in Odoo zur Installation verfügbar machen

Du kannst den Fortschritt im Aktionen-Tab verfolgen.

5. Das Modul installieren #

Das Bereitstellen kopiert den Code des Addons auf den Dienst; in der Datenbank von Odoo ist das Modul damit noch nicht. Öffne den Module-Tab, klicke auf Install modules und gib den technischen Namen des Addons ein. Odoo aktualisiert dabei seine App-Liste, findet also auch ein gerade bereitgestelltes Addon, und installiert das Modul mit den Modulen, von denen es abhängt. Der Dienst steht still, während Odoo es installiert, und startet danach wieder. Siehe Module verwalten.

Du kannst es auch in Odoo über Apps installieren. Ein neu bereitgestelltes Addon führt Odoo dort erst, nachdem die App-Liste aktualisiert wurde: Klicke im Module-Tab auf Refresh apps list oder im Entwicklermodus von Odoo auf Update Apps List.

Module aus dem Odoo App Store oder einem ZIP hinzufügen #

Das Hinzufügen von Modulen ist im Early Access und wird Team für Team freigeschaltet. Wenn du im Tab Repositories eines Dienstes neben den Repositories kein Add Module siehst, ist es für dein Team noch nicht aktiviert. Melde dich bei uns, dann schalten wir es frei.

Module, die noch in keinem Repository liegen, etwa eine kostenlose App aus dem Odoo App Store oder eine, die du dort gekauft hast, kannst du direkt in calmo.cloud einem der Repositories des Dienstes hinzufügen. calmo.cloud committet sie in das Repository und stellt sie danach auf dem Dienst bereit. Das kann nur das Team, das den Dienst hostet; ein Team, mit dem der Dienst geteilt ist, kann es nicht (siehe Dem Hosting-Team vorbehalten).

  1. Öffne den Tab Repositories des Dienstes. Das Repository muss privat und über die calmo.cloud GitHub App verbunden sein. Hat der Dienst noch kein solches Repository, lege zuerst eines auf GitHub an.
  2. Klicke neben dem Repository auf Add Module.
  3. Wähle, woher die Module kommen:
    • Odoo App Store: Gib den technischen Namen der App ein, den letzten Teil ihrer Adresse auf apps.odoo.com. Bei https://apps.odoo.com/apps/modules/19.0/web_responsive ist das web_responsive. calmo.cloud lädt die App für die Odoo-Version des Dienstes herunter, zusammen mit den Community-Apps, von denen sie abhängt.
    • Upload a ZIP: Wähle die ZIP-Datei, zum Beispiel eine gekaufte App, die du heruntergeladen hast.
  4. Klicke auf Add.

calmo.cloud prüft das Archiv und committet alle seine Module in einem Commit in den Branch, aus dem der Dienst das Repository bereitstellt. Danach stellt es die neuen Addons auf dem Dienst bereit, genau wie Deploy Addons: Die Spalte Discovery und die Aktionen „Deploy addon“ zeigen den Fortschritt (siehe Repository zu einem Dienst hinzufügen). Sind die Addons bereitgestellt, installiere sie.

Was das Archiv enthalten darf #

  • Einen Ordner pro Modul auf oberster Ebene des ZIP, jeder mit einer __manifest__.py, so wie der Odoo App Store sie ausliefert. Ein ZIP mit einem zusätzlichen Ordner um die Module oder mit Dateien neben ihnen wird abgelehnt.
  • Bis zu 25 MB, 100 MB entpackt und 5.000 Dateien, keine davon größer als 20 MB. Höchstens 75 der Dateien dürfen Bilder, Schriften oder andere Binärdateien sein, die noch nicht im Repository liegen. Größere Module pushst du mit git.
  • Ordner __pycache__, kompilierte Python-Dateien, .git-Dateien und der Ordner __MACOSX, den macOS hinzufügt, werden weggelassen.
  • Abgelehnt werden Pfade, die aus den Ordnern des Archivs herausführen würden, Links, Archive mit Passwort, Module für eine andere Odoo-Version (eine Version wie 18.0.1.0.0 auf einem Odoo-19.0-Dienst) und Module, die wie eines von Odoos eigenen heißen.

Außerdem begrenzt GitHub, wie viel calmo.cloud in deinen Repositories innerhalb einer Minute und innerhalb einer Stunde anlegen darf, und jedes Bild, jede Schrift und jede andere Binärdatei, die noch nicht im Repository liegt, zählt dazu. Fügst du in kurzer Zeit viele solche Module hinzu, sagt dir calmo.cloud, wann du es wieder versuchen kannst. Bis dahin kannst du sie mit git pushen.

Ein Modul, das schon im Repository liegt, wird übersprungen. Um es auf die Version des Archivs zu bringen, schalte Replace modules that are already in the repository ein: Sein Ordner wird dann genau der des Archivs, und Dateien, die das Archiv nicht hat, werden gelöscht. Ein Dienst, der ein ersetztes Modul schon hat, zeigt dafür im Tab Addons ein Update an (siehe Addon aktualisieren).

Ein Modul, das ein anderes Repository des Dienstes schon liefert, wird ebenfalls übersprungen. Der Odoo App Store packt die Community-Apps, von denen eine App abhängt, mit ins Archiv, und ein OCA-Repository auf dem Dienst hat sie vielleicht schon. Ein Repository, das das Modul nur für eine andere Odoo-Version hat, zählt nicht: Dann wird die Kopie aus dem Archiv hinzugefügt.

Kostenpflichtige Apps #

Ohne Anmeldung gibt der Odoo App Store nur kostenlose Apps heraus. Bei einer kostenpflichtigen App, einer App, die es unter diesem Namen nicht gibt, oder einer ohne Release für die Odoo-Version des Dienstes meldet calmo.cloud, dass das Modul nicht kostenlos heruntergeladen werden kann. Kaufe eine kostenpflichtige App auf apps.odoo.com, lade dort ihr ZIP herunter und lade stattdessen das hoch.

Begrenzt oder verweigert der Odoo App Store die Downloads von calmo.cloud, meldet calmo.cloud stattdessen das. Versuche es später noch einmal, oder lade das ZIP der App auf apps.odoo.com herunter und lade es hoch.

Kostenpflichtige Apps stehen meist unter der Lizenz OPL-1, die verbietet, sie zu veröffentlichen oder weiterzugeben. Deshalb fügt calmo.cloud Module nur privaten Repositories hinzu: Lass das Repository privat. Prüfe in den Bedingungen des Anbieters, für wie viele Datenbanken ein Kauf gilt, denn Kopien, Previews und Testsysteme des Dienstes bekommen das Modul auch.

Der Download kostenloser Apps ist keine offizielle Schnittstelle des Odoo App Store. Funktioniert er nicht mehr, lade das ZIP der App auf apps.odoo.com herunter und lade es hoch.

Die API und KI-Assistenten fügen Module genauso hinzu (siehe KI-Assistenten (MCP)). Über ein API-Token braucht das die Berechtigungen Manage repositories und Manage Odoo services. Ein Team kann bis zu 30-mal pro Stunde Module hinzufügen, gezählt über calmo.cloud, die API und KI-Assistenten zusammen.

Addon aktualisieren #

Wenn eine neue Version eines Addons verfügbar ist (neue Commits im Repository), kannst du es aktualisieren:

  1. Gehe zum Addons-Tab des Dienstes
  2. Finde das Addon mit einem verfügbaren Update
  3. Klicke auf Aktualisieren, um die neueste Version bereitzustellen
  4. Starte den Dienst bei Aufforderung neu

Addon-Status #

Jedes Addon auf einem Dienst hat einen Bereitstellungsstatus:

Status Bedeutung
Bereitgestellt Das Addon ist installiert und aktiv
Ausstehend Das Addon steht in der Warteschlange zur Bereitstellung
Fehler Die Bereitstellung ist fehlgeschlagen — prüfe das Aktionsprotokoll

Das Bereitstellen eines Addons kopiert seinen Code auf den Dienst. Um es zu nutzen, installiere das Modul im Module-Tab oder über das Apps-Menü von Odoo.

Repositories Module verwalten