99% aller Nextcloud-Aufgaben lassen sich über die Web-GUI erledigen — wir haben das so designt, dass Du als Kunde keinen SSH-Zugang brauchst. Bei sehr seltenen Edge Cases ist OCC (das CLI-Tool von Nextcloud) oder eine Server-Shell 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 gehört nicht zum Standard-Tarif.
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?
Im Standard-Tarif: nein. Auf expliziten Wunsch und gegen Aufpreis: ja, mit Vereinbarungen:
- Wo liegt das Risiko? Du kannst alles tun — auch das Setup unbrauchbar machen. Wenn das passiert, kommen wir nicht raus von Backup-Restore — und Backup-Restore beim Support-Tarif kostet Zeit.
- Was Du nicht solltest: System-Pakete updaten, Firewall-Regeln ändern, fremde Software installieren, OS-Konfig modifizieren.
- Was sinnvoll ist: Logs einsehen, OCC-Befehle ausführen, Files manuell scannen.
Wir vereinbaren bei SSH-Setup individuell, was Du tun darfst und was nicht. Schreib ein Ticket bei Bedarf.
Welche OCC-Kommandos solltet ihr im Tutorial-Modus selbst kennen
Als Nextcloud-Admin (auch ohne SSH) 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 echte SSH-Cases (Custom-Migration, sehr eigenwillige Setup-Wünsche).
Das heißt: bevor Du SSH-Zugang willst, schreib uns das Problem — meist gibt’s eine elegantere Lösung.
Backup-Restore
Wenn etwas wirklich schiefgegangen ist (durch eigenen Eingriff oder durch uns):
- Wir haben tägliche Server-Backups, je nach Tarif 14–30 Tage Retention
- Wiederherstellung kostet Zeit (großes Setup: 1–4 Stunden), aber funktioniert zuverlässig
- Schreib uns Ticket „bitte Restore von
”
Wichtig: bei Tarifen ohne explizites Off-Site-Backup ist Restore lokal — wenn das ganze Rechenzentrum ausfällt (sehr selten), gibt’s andere Mechanismen. 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.
Wer kann SSH-Zugang freigeben — auch wir, ihr? Beide. SSH-Setup machen wir, aber Du als Hauptverantwortlicher entscheidest. Bei Mehr-Personen-Setups: wir freigeben nur, was der Hauptauftraggeber autorisiert.
Logs einsehen — geht das ohne SSH?
Ja, 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): SSH oder unseren Support fragen.
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.