Installation auf eigenem Server

Wenn Sie Odoo auf einem eigenen Server (oder bei einem Hoster mit SSH-Zugriff) betreiben, installieren Sie den Connector direkt im Addons-Verzeichnis Ihrer Odoo-Instanz.

Voraussetzungen

Voraussetzung Bedeutung
SSH-Zugang Terminal-Zugriff auf den Server (ssh user@server)
root- oder sudo-Rechte Zum Stoppen/Starten des Odoo-Dienstes und zum Schreiben in /opt/odoo
Pfad zum Addons-Verzeichnis Z. B. /opt/odoo/custom-addons — hängt von Ihrer Installation ab
ZIP-Datei Aktuelle Version aus dem Connector-Portal

SSH (Secure Shell) ist ein verschlüsseltes Protokoll für den Fernzugriff auf Server. Sie öffnen damit eine Kommandozeile auf dem Server, als säßen Sie davor.

Schritt 1: Odoo stoppen

Bevor Sie Module ändern, sollte der Odoo-Dienst gestoppt werden.

sudo systemctl stop odoo

Schritt 2: Modul auf den Server hochladen

Vom lokalen Rechner aus per SCP (Secure Copy):

scp ~/Downloads/itscope_connector-*.zip user@server:/tmp/

Alternativ können Sie ein SFTP-Programm wie FileZilla oder Cyberduck verwenden und die ZIP-Datei nach /tmp/ auf dem Server schieben.

Schritt 3: ZIP entpacken

Auf dem Server (per SSH eingeloggt):

sudo unzip /tmp/itscope_connector-*.zip -d /opt/odoo/custom-addons/

Passen Sie den Zielpfad an Ihre Installation an. Häufige Pfade sind /opt/odoo/custom-addons, /mnt/extra-addons oder /usr/lib/python3/dist-packages/odoo/addons.

Schritt 4: Addons-Pfad prüfen

Der Ordner, in den Sie entpackt haben, muss in der Odoo-Konfiguration unter addons_path eingetragen sein. Öffnen Sie:

sudo cat /etc/odoo/odoo.conf

Suchen Sie nach einer Zeile wie:

addons_path = /usr/lib/python3/dist-packages/odoo/addons,/opt/odoo/custom-addons

Fehlt Ihr Zielpfad, ergänzen Sie ihn (kommagetrennt). Achten Sie außerdem auf die Dateirechte:

sudo chown -R odoo:odoo /opt/odoo/custom-addons/itscope_connector

Schritt 5: Odoo neustarten

sudo systemctl start odoo
sudo systemctl status odoo

active (running) bedeutet, dass Odoo erfolgreich gestartet ist.

Schritt 6: Modul in Odoo aktivieren

  1. Öffnen Sie Odoo im Browser und melden Sie sich als Administrator an.
  2. Aktivieren Sie den Entwicklermodus (Einstellungen → ganz unten “Entwicklermodus aktivieren”).
  3. Gehen Sie zu Apps.
  4. Klicken Sie auf Apps → Addon-Liste aktualisieren.
  5. Suchen Sie nach ITscope Connector.
  6. Klicken Sie auf Installieren.

Troubleshooting

Fehler Ursache Lösung
Modul nicht in der App-Liste Addons-Pfad nicht aktualisiert Schritt 4 prüfen, Addon-Liste in Odoo neu aufbauen
ImportError beim Start Dependency-Konflikt Odoo-Log prüfen (/var/log/odoo/odoo.log)
Permission denied Falsche Dateirechte sudo chown -R odoo:odoo ausführen
Odoo startet nicht mehr Manifest-Fehler ZIP erneut entpacken oder vorherige Version wiederherstellen

Weiterführende Artikel