Markt #

Mit dem Markt installieren, aktualisieren und entfernen Administratoren Apps in der Weboberfläche. Die Apps kommen aus dem Marketplace unter https://marketplace.owncloud.online. Für Server ohne Internetzugang lässt sich stattdessen ein Katalog im Dateisystem einrichten. Die App bringt außerdem die occ-Befehle market:* mit.

Voraussetzungen #

Installation #

Nichts zu tun: Die App gehört zum Server. Wurde sie abgeschaltet:

sudo -u www-data php8.4 occ app:enable market

Solange die App aus ist, fehlen der Eintrag Markt im App-Menü und alle Befehle occ market:*.

Apps installieren und aktualisieren #

Den Markt öffnen Administratoren im App-Menü links oben unter Markt. Andere Konten sehen den Eintrag nicht.

Die Ansicht Entdecken: links Suche, Kategorien und Einstellungen, rechts die Apps aus dem Marketplace.

So installieren Sie eine App:

1. Die App unter Entdecken oder über die Suche finden und Details öffnen.
2. Installieren klicken.

Der Markt lädt das Paket, entpackt es in das beschreibbare App-Verzeichnis und schaltet die App ein. Führt der Katalog eine SHA-256-Prüfsumme (der Marketplace tut das), vergleicht der Markt das Paket vorher damit. Scheitert das Einschalten, löscht er das entpackte Verzeichnis wieder.

Neue Versionen stehen unter Updates. Aktualisieren spielt sie ein.

Dieselben Schritte auf der Kommandozeile:

Alle Befehle laufen als Benutzer des Webservers, zum Beispiel sudo -u www-data php8.4 occ market:list. Was beim Entfernen mit den Daten einer App geschieht, steht unter Apps und Marketplace.

API-Schlüssel eintragen #

Manche Apps zeigt der Marketplace nur mit einem API-Schlüssel. Ihre Seiten in dieser Dokumentation beginnen mit dem Kasten „Nur mit API-Schlüssel“. Ohne Schlüssel fehlen diese Apps im Katalog, und occ market:install meldet „Unbekannte App (…)“.

1. Den Schlüssel bei der BW-Tech GmbH anfragen.
2. Im Markt in der Seitenleiste unter Einstellungen auf API Schlüssel hinzufügen klicken.
3. Den Schlüssel in das Feld Dein persönlicher API-Key einfügen und Speichern klicken.

„API Schlüssel hinzufügen“ öffnet diesen Dialog. Den Schlüssel erhalten Sie von der BW-Tech GmbH.

Der Markt prüft den Schlüssel beim Marketplace und lädt danach den Katalog neu. Ist der Schlüssel angenommen, heißt der Eintrag in der Seitenleiste Bearbeite API Schlüssel, und die zusätzlichen Apps stehen unter Entdecken. Steht dort weiter API Schlüssel hinzufügen, hat der Marketplace den Schlüssel abgelehnt, und der Markt hat ihn nicht gespeichert.

Auf der Kommandozeile:

sudo -u www-data php8.4 occ config:app:set market key --value '<API-SCHLÜSSEL>'

Danach im Markt Cache leeren wählen. Sonst arbeiten Oberfläche und occ market:install bis zu 30 Minuten lang mit dem zwischengespeicherten Katalog ohne die zusätzlichen Apps.

Steht der Schlüssel als 'marketplace.key' => '<API-SCHLÜSSEL>', in config/config.php, hat dieser Eintrag Vorrang. Der Markt blendet API Schlüssel hinzufügen dann aus. Ändern lässt sich der Schlüssel nur noch in config.php.

Einstellungen in config.php #

Geht der Server über einen Proxy ins Internet, nutzt der Markt die Einträge proxy und proxyuserpwd aus derselben Datei.

Benachrichtigung über Updates #

Ein Hintergrund-Job sucht einmal täglich nach neueren Versionen der installierten Apps. Gemeldet werden nur Versionen, die zur laufenden Serverversion passen. Jedes Mitglied der Gruppe admin bekommt dazu eine Benachrichtigung: „Ein Update für … auf Version … ist verfügbar.“ Voraussetzung sind laufende Hintergrund-Jobs (siehe Hintergrund-Jobs) und die eingeschaltete App Benachrichtigungen.

Andere oder zusätzliche Gruppen legen Sie als JSON-Liste fest:

sudo -u www-data php8.4 occ config:app:set market notify_groups --value '["admin","it-betrieb"]'

Ohne Internetzugang #

Einzelne Pakete spielen Sie direkt aus dem Dateisystem ein und schalten die App danach ein:

sudo -u www-data php8.4 occ market:install --local /srv/pakete/configreport-0.4.5.tar.gz
sudo -u www-data php8.4 occ app:enable configreport

Für einen eigenen Katalog legen Sie ein Verzeichnis mit den Dateien apps.json, categories.json und bundles.json an, kopieren die Pakete hinein und tragen das Verzeichnis ein:

sudo -u www-data php8.4 occ config:system:set appstoreurl --value 'file:///srv/app-katalog'

Ein Eintrag in apps.json:

[
  {
    "id": "configreport",
    "name": "Admin Config Report",
    "categories": ["tools"],
    "downloadable": true,
    "releases": [
      {
        "version": "0.4.5",
        "platformMin": "11",
        "platformMax": "11.99",
        "license": "AGPL-3.0",
        "download": "configreport-0.4.5.tar.gz",
        "checksum": "sha256:<Prüfsumme>"
      }
    ]
  }
]

• Jede Kategorie aus categories muss in categories.json stehen, zum Beispiel [{"id": "tools", "translations": {"en": {"name": "Tools"}, "de": {"name": "Werkzeuge"}}}].
• bundles.json enthält [], wenn Sie keine Bundles brauchen.
• download ist ein Pfad relativ zum Katalogverzeichnis oder eine HTTPS-Adresse. Pfade außerhalb des Katalogverzeichnisses lehnt der Markt ab („Local app archive … is not inside the catalog directory.“).
• Mit checksum prüft der Markt jedes Paket nach dem Laden. Den Wert liefert sha256sum <paket>; übernehmen Sie nur die 64 Zeichen vor dem Dateinamen.
• Verzeichnis und Pakete müssen für den Benutzer des Webservers lesbar sein.
• Der Markt liest die drei Dateien bei jedem Aufruf neu.

Das vollständige Format beschreibt die Datei marketplace/README.md im Verzeichnis der App. Mit dem Wert local für appstoreurl zeigt der Markt den Katalog aus diesem Verzeichnis. Er enthält nur einen Beispieleintrag und dient als Vorlage.

Grenzen und Hinweise #

• Den Markt sehen nur Administratoren.
• Die App kann sich nicht selbst entfernen („Market app can not uninstall itself.“). Mitgelieferte Apps lassen sich nur abschalten.
• Der Katalog bleibt bis zu 30 Minuten im Zwischenspeicher. Cache leeren lädt ihn sofort neu.
• Ältere Versionen spielt der Markt nicht ein. Er bietet nur Versionen an, die höher als die installierte sind und zur Serverversion passen.
• Ist das App-Verzeichnis nicht beschreibbar oder steht operation.mode auf clustered-instance, installiert der Markt nichts. Den Weg über ein Paket von Hand beschreibt Apps und Marketplace.
• Ein App-Verzeichnis mit .git löscht occ market:uninstall nie.

Fehlersuche #

Verbindung vom Server aus testen:

curl -sS -o /dev/null -w '%{http_code}\n' https://marketplace.owncloud.online/api/v1/categories.json

Gibt der Befehl 200 aus, stimmen Namensauflösung, Firewall und Zertifikat. Hinter einem Proxy ergänzen Sie -x http://<proxy>:<port>.