99% aller Nextcloud-Aufgaben lassen sich über die Web-GUI erledigen — wir haben das so designt, dass Du als Kunde keinen Shell-Zugang brauchst. Bei sehr seltenen Edge Cases ist OCC (das CLI-Tool von Nextcloud) trotzdem das richtige Werkzeug. Hier wie wir das handhaben.
Die Grund-Regel
Bei xaweho gilt:
Den Server-Unterbau betreuen wir. Du als Nextcloud-Admin arbeitest in der GUI. SSH-Zugang auf den Server gibt es nicht — OCC-Aufgaben übernehmen wir per Ticket.
Heißt:
- Updates, Backup, Performance-Tuning, OS-Patches: machen wir
- App-Verwaltung, User-Management, Sharing: machst Du in der GUI
- OCC-Aufgaben: auf Anfrage via Support-Ticket — wir führen aus
Das ist bewusst so. Damit:
- Du nicht aus Versehen das Setup zerschießt
- Wir das Setup vorhersehbar pflegen können
- Backup-Mechanismen nicht durch unbekannte Manuelle Eingriffe gebrochen werden
OCC — was das ist
occ (offiziell: occ Command, Abkürzung für „ownCloud Console” — historischer Name) ist das Kommandozeilen-Tool von Nextcloud. Damit gehen Aufgaben, die in der GUI nicht angeboten werden:
- Volle Konfiguration in
config.phpändern - File-Scan / Re-Indexierung erzwingen
- User-Aktionen ohne GUI (Massen-Imports, etc.)
- Cron-Jobs manuell triggern
- Reparatur-Befehle (
occ maintenance:repair) - Volltext-Suche neu indexieren
- Theming-Reset
- Verschlüsselungs-Schlüssel verwalten
Funktional sehr mächtig — gefährlich, wenn falsch genutzt.
Wann OCC sinnvoll ist
Typische Fälle, wo wir per Ticket OCC-Befehle ausführen:
Datenbank-Index-Probleme
Symptom: Performance schlecht trotz neuer Hardware. Ursache: fehlende DB-Indizes nach App-Update.
Lösung: occ db:add-missing-indices. Wir führen aus.
Datei-Scan nach Storage-Manipulation
Wenn Files manuell auf Storage gelandet sind (sehr selten — z.B. Migration), kennt Nextcloud sie nicht. Lösung: occ files:scan --all. Stundenlanger Vorgang bei großen Setups.
App-Verwaltung in der GUI gestört
Manchmal hängt die App-Verwaltung nach fehlgeschlagenen Updates. Lösung: occ app:disable <appname> + Re-Install.
LDAP-/SAML-Konfiguration
Bei komplexen Identity-Provider-Setups manchmal CLI-Konfig nötig.
Recognize-Modell neu trainieren
occ recognize:reanalyze — bei Fehl-Erkennungen oder neu hinzugefügten Personen.
Reparatur nach abgebrochenem Update
occ maintenance:repair — bei sehr seltenen Fällen, wo Update mittendrin abgebrochen wurde (Strom weg, etc.).
Wie ihr OCC-Befehle bei uns anstoßt
Per Support-Ticket: schreib was Du erreichen willst (am besten mit Beispiel oder Fehlermeldung). Wir prüfen, führen aus, geben Bescheid.
Beispiel-Ticket:
Hi, wir haben gestern eine größere Nextcloud-App installiert (Recognize), seitdem ist die Galerie sehr langsam. Könnt ihr
occ db:add-missing-indiceslaufen lassen? Danke!
Wir machen das typisch innerhalb 1 Werktags, in dringenden Fällen schneller.
SSH-Zugang — geht das?
Nein. Deine Nextcloud läuft voll managed — Shell-Zugriff aufs System würde unsere Wartung, Updates und Backups unkalkulierbar machen. Alles, was per OCC geht, führen wir für Dich per Ticket aus (siehe oben); Logs siehst Du in der Admin-GUI unter Verwaltungs-Einstellungen → Protokollierung. Wenn Du einen Anwendungsfall hast, der scheinbar zwingend eine Shell braucht: Beschreib uns das Problem im Ticket — in fast allen Fällen gibt es einen Weg ohne.
Welche OCC-Kommandos solltet ihr im Tutorial-Modus selbst kennen
Als Nextcloud-Admin (auch ohne Shell-Zugang) ist es trotzdem nützlich, die Befehle zu verstehen — falls wir sie in Mails/Tickets erwähnen:
| Befehl | Was er tut |
|---|---|
occ status | Versions-Info, Maintenance-Modus |
occ db:add-missing-indices | Fehlende DB-Indizes ergänzen, Performance |
occ files:scan --all | Komplett-Re-Scan aller Files |
occ app:list | Alle Apps mit Status |
occ app:enable <app> | App aktivieren |
occ app:disable <app> | App deaktivieren |
occ user:list | User-Liste |
occ user:resetpassword <user> | Passwort-Reset für User |
occ maintenance:mode --on/--off | Wartungs-Modus aktivieren/deaktivieren |
occ config:list system | System-Config anzeigen |
Mehr in der offiziellen Nextcloud-Doku.
Was wir aus Erfahrung gelernt haben
Aus unseren Setups:
- 90% aller „ich brauche SSH”-Anfragen sind tatsächlich GUI-Aufgaben, die der Kunde nicht kennt. Wir helfen erst per GUI-Walk-through.
- 8% sind tatsächliche OCC-Cases — die machen wir per Ticket.
- 2% sind Spezialfälle (Custom-Migration, sehr eigenwillige Setup-Wünsche) — die lösen wir gemeinsam per Ticket, mit Plan statt Shell.
Das heißt: Schreib uns das Problem, nicht die gewünschte Zugriffsart — meist gibt’s eine elegantere Lösung.
Backup-Restore
Wenn etwas wirklich schiefgegangen ist (durch eigenen Eingriff oder durch uns):
- Wir halten sieben tägliche Backups, von uns betreut und ausschließlich für uns zugänglich; längere Aufbewahrung oder kürzere Intervalle richten wir auf Wunsch ein
- Die Sicherungen werden standortübergreifend gespiegelt — ein Standort-Ausfall trifft nie alle Kopien gleichzeitig
- Wiederherstellung kostet Zeit (großes Setup: 1–4 Stunden), aber funktioniert zuverlässig
- Schreib uns Ticket „bitte Restore von
”
Mehr in den Tarif-Details auf der Nextcloud-Seite.
Häufige Fragen
Kann ich occ in der Web-GUI ausführen?
Es gibt eine kleine Admin-Web-OCC-App, aber wir aktivieren sie nicht standardmäßig — das Risiko ist zu groß, dass jemand Maintenance-Mode aktiviert und nicht mehr deaktiviert.
Wie lange dauert ein typischer OCC-Befehl bei euch? Schnelle Befehle (status, app:enable): unter 1 Min nach Ticket-Bearbeitung. Lange Befehle (files:scan auf 1 TB Storage): mehrere Stunden, wir geben Zwischenstände.
Was kostet ein OCC-Befehl? Im Standard-Tarif: enthalten in der Support-Pauschale. Bei häufigen oder komplexen Anfragen können Sonderkosten anfallen — wir sagen vorher Bescheid.
Logs einsehen — wie geht das?
In der Admin-GUI: Verwaltungs-Einstellungen → Protokollierung. Zeigt die letzten Log-Einträge, mit Filter-Möglichkeit. Für tieferes Log-Diving (apache_access.log, php-fpm.log): Ticket an uns, wir liefern die relevanten Ausschnitte.
Cron-Jobs manuell triggern? GUI hat dafür meist keine Option. Per Ticket können wir Cron sofort triggern (z.B. nach Recognize-Update).
Was passiert mit OCC-Befehlen, die wir ausführen — Audit-Log? Wir haben interne Logs, was wir ausführen — pro Ticket nachvollziehbar.
App-Update via OCC vs GUI? Beide gleich. GUI-Update ist üblicher Weg. OCC nur, wenn GUI hängt oder bei Mehrbatch-Updates.
Weiter geht’s
Erste Anmeldung als Nextcloud-Admin
Was Du nach der Bereitstellung Deiner Nextcloud machst — Login, Profil, wichtige erste Einstellungen, was wir machen und was Du machst.
Admin-GUI Übersicht — was Du wo findest
Die Verwaltungs-Einstellungen in Nextcloud sind groß. Hier eine Tour durch die wichtigsten Bereiche und was sie tun.
Benutzer und Gruppen anlegen
User für Familie, Verein oder Team anlegen, Gruppen organisieren, Quotas setzen, Login-Verhalten kontrollieren.
Sharing — Files mit anderen teilen, intern und extern
Files in Nextcloud teilen — innerhalb Deiner Cloud mit anderen Usern, mit Gruppen, oder extern per Sharing-Link.