Nextcloud OCC-Befehle leicht erklärt – Dein Admin-Guide für die Konsole

1. Grundlagen

• Was ist OCC? OCC steht für ownCloud Console und ist ein PHP-Skript im Nextcloud-Verzeichnis (/var/www/nextcloud/occ).
• Aufruf:

sudo -u www-data php occ

sudo -u www-data php occ

• www-data ist der Standard-Webserver-User unter Debian/Ubuntu.
• Andere Distributionen nutzen z. B. apache (CentOS) oder http (Arch Linux).
• Tipp: Mit php occ list siehst du alle verfügbaren Befehle. Mit php occ help <befehl> bekommst du Details.

2. Wichtige Befehle im Alltag

3. Typische Anwendungsfälle

• Upgrade durchführen:

sudo -u www-data php occ maintenance:mode --on sudo -u www-data php occ upgrade sudo -u www-data php occ maintenance:mode --off

sudo -u www-data php occ maintenance:mode --on sudo -u www-data php occ upgrade sudo -u www-data php occ maintenance:mode --off

• Neue App aktivieren:

sudo -u www-data php occ app:enable contacts

sudo -u www-data php occ app:enable contacts

• Benutzer hinzufügen:

sudo -u www-data php occ user:add made

sudo -u www-data php occ user:add made

4. Best Practices

• Immer im Nextcloud-Verzeichnis arbeiten (/var/www/nextcloud).
• Vor riskanten Befehlen Backup einspielen – besonders bei upgrade oder files:scan.
• Wartungsmodus aktivieren, wenn du größere Änderungen vornimmst.
• Automatisierung: OCC-Befehle lassen sich in Skripten nutzen, z. B. für Backups oder Cronjobs.

5. Sicherheitshinweise

• Manche Befehle können Daten löschen oder Konfiguration ändern. Nextcloud zeigt Warnungen an.
• OCC sollte nur von Administratoren mit ausreichenden Rechten ausgeführt werden.

🛠 Übersicht: Kategorien von OCC-Befehlen

Die Befehle sind in Funktionsgruppen gegliedert. Hier ein Überblick:

• Allgemein & System
  • list – zeigt alle Befehle
  • status – zeigt Nextcloud-Status (Version, Wartungsmodus etc.)
  • check – prüft Serverumgebung
  • setupchecks – führt Installationsprüfungen durch

• Wartung & Updates
  • maintenance:mode --on|--off – Wartungsmodus aktivieren/deaktivieren
  • maintenance:repair – Reparaturroutinen ausführen
  • upgrade – Upgrade nach Installation einer neuen Version

• Benutzer & Gruppen
  • user:add <name> – Benutzer anlegen
  • user:delete <name> – Benutzer löschen
  • user:resetpassword <name> – Passwort zurücksetzen
  • group:add <name> – Gruppe erstellen
  • group:adduser <group> <user> – Benutzer zu Gruppe hinzufügen

• Apps
  • app:list – Liste aller Apps
  • app:enable <id> – App aktivieren
  • app:disable <id> – App deaktivieren
  • app:update – Apps aktualisieren

• Dateien
  • files:scan --all – Dateiscan für alle Benutzer
  • files:cleanup – Bereinigt Dateisystemeinträge
  • files:transfer-ownership – Dateien zwischen Benutzern übertragen

• Datenbank & Konfiguration
  • db:add-missing-indices – fehlende Indizes hinzufügen
  • config:system:get <key> – Konfigurationswert auslesen
  • config:system:set <key> – Konfigurationswert setzen

• Sicherheit
  • encryption:enable – Verschlüsselung aktivieren
  • encryption:disable – Verschlüsselung deaktivieren
  • twofactor:disable <user> – Zwei-Faktor-Authentifizierung für Nutzer deaktivieren

• Logging & Debugging
  • log:manage – Logging-Einstellungen verwalten
  • log:owncloud – Logdateien anzeigen
  • config:system:get loglevel – aktuelles Log-Level prüfen

• LDAP & Federation
  • ldap:test-config – LDAP-Konfiguration testen
  • federation:sync-addressbooks – Adressbücher synchronisieren

📋 Beispiel: Häufig genutzte Befehle

sudo -u www-data php occ status
sudo -u www-data php occ maintenance:mode --on
sudo -u www-data php occ upgrade
sudo -u www-data php occ app:list
sudo -u www-data php occ files:scan --all

sudo -u www-data php occ status
sudo -u www-data php occ maintenance:mode --on
sudo -u www-data php occ upgrade
sudo -u www-data php occ app:list
sudo -u www-data php occ files:scan --all

🔑 Best Practices

• Immer als Webserver-User ausführen (z. B. www-data unter Ubuntu/Debian).
• Vor Upgrades Wartungsmodus aktivieren.
• Regelmäßig files:scan nutzen, wenn Dateien manuell ins Dateisystem kopiert wurden.
• Mit list und help <command> kannst du jederzeit alle verfügbaren Befehle und deren Optionen einsehen.

© 2025 MaDe-Online