Installation auf Webhosting ohne Root-Zugriff #

Diese Seite beschreibt die Installation von owncloud.online in einem gewöhnlichen Webhosting-Paket: Sie haben ein Kundenmenü, einen Dateimanager oder FTP-Zugang und eine Datenbankverwaltung — aber keinen Root-Zugriff, keine SSH-Sitzung und keine Möglichkeit, Composer, npm oder occ auszuführen.

Der Weg dorthin führt über das fertige Release-Archiv: herunterladen, Prüfsumme vergleichen, hochladen, entpacken, Datenbank im Kundenmenü anlegen, Einrichtung im Browser abschließen. Gebaut werden muss nichts.

Zwei Dinge vorweg, die diese Variante von einem eigenen Server unterscheiden:

• Ohne Kommandozeile steht occ nicht zur Verfügung. Einige Wartungs- und Reparaturaufgaben sind damit nicht durchführbar, siehe Was ohne SSH anders läuft.
• Sie können PHP nicht selbst konfigurieren. Alles, was owncloud.online an PHP-Einstellungen braucht, muss Ihr Hoster anbieten, siehe PHP-Einstellungen.

Reicht das Hosting-Paket? #

Prüfen Sie diese Punkte, bevor Sie 64 MB hochladen. Jede Zeile ist eine Bedingung, an der die Installation sonst später scheitert.

Diese PHP-Erweiterungen prüft der Server beim Start (OC_Util::checkServer()); fehlt eine davon, kommt keine Seite zustande:

zip, dom, XMLWriter, XMLReader, intl, libxml, mbstring, ctype, JSON,
GD, zlib, iconv, SimpleXML, hash, cURL, PDO

Woran ein Paket sicher zu klein ist #

Trifft einer der ersten beiden Punkte zu oder wird er absehbar zutreffen, planen Sie von vornherein einen Server mit Kommandozeilenzugang ein, siehe Leerer Linux-Server.

1. Release herunterladen #

Alle Fassungen liegen unter https://github.com/BWTECH-github/owncloud.online/releases. Aktuell ist 11.0.13. Ein Release enthält:

Beide Archive enthalten ein einzelnes Verzeichnis owncloud/. Darin stecken der Server, die mitgelieferten Apps unter apps/, die Markt-App unter apps-external/market sowie config/ mit den beiden Beispieldateien config.sample.php und config.apps.sample.php. Eine fertige config/config.php ist nicht enthalten — die schreibt die Einrichtung.

2. Prüfsumme vergleichen #

Vergleichen Sie die Prüfsumme auf Ihrem eigenen Rechner, bevor Sie hochladen. Unter Linux und macOS:

sha256sum owncloud-online-11.0.13.zip
grep 'owncloud-online-11.0.13.zip' SHA256SUMS.txt

Beide Zeilen müssen denselben Wert zeigen. Unter Windows liefert certutil -hashfile owncloud-online-11.0.13.zip SHA256 dieselbe Prüfsumme.

Weicht der Wert ab, ist der Download unvollständig oder verändert — laden Sie ihn erneut und laden Sie ihn nicht hoch.

3. Hochladen und entpacken #

1. Laden Sie die ZIP-Datei in den Webspace, nicht die entpackten Dateien. Die Installation besteht aus mehreren zehntausend Einzeldateien; ein FTP-Upload davon dauert Stunden und bricht regelmäßig ab.
2. Entpacken Sie das Archiv im Dateimanager Ihres Hosters.
3. Verschieben Sie den Inhalt von owncloud/ in das Verzeichnis, das Ihre Domain ausliefert — oder richten Sie die Domain direkt auf owncloud/.
4. Prüfen Sie, dass die Dateien mit Punkt am Anfang mitgekommen sind: .htaccess und .user.ini müssen im Wurzelverzeichnis der Installation liegen. Viele Dateimanager blenden sie aus; es gibt meist eine Einstellung „versteckte Dateien anzeigen".

Ohne .htaccess fehlen die Schutzregeln für config/, lib/ und die Fehlerseiten. Ohne .user.ini gelten die PHP-Vorgaben Ihres Hosters statt der Werte, die owncloud.online mitbringt.

Löschen Sie das ZIP nach dem Entpacken aus dem Webspace.

4. Datenbank im Kundenmenü anlegen #

Legen Sie im Kundenmenü eine leere Datenbank und einen Datenbankbenutzer an. Notieren Sie vier Angaben — die Einrichtung fragt genau diese ab:

Weicht der Port vom Standard ab, hängen Sie ihn mit Doppelpunkt an den Host an (db1234.hoster.example:3307). Das Einrichtungsformular weist ausdrücklich darauf hin.

Die Datenbank muss leer sein. Eine Datenbank, in der bereits Tabellen einer anderen Anwendung liegen, führt zu Fehlern beim Anlegen des Schemas.

5. Datenverzeichnis festlegen #

Das Datenverzeichnis enthält alle hochgeladenen Dateien und das Serverprotokoll. Legen Sie es außerhalb des Webroots an, zum Beispiel:

/home/kundennummer/owncloud-data

Der Pfad muss absolut sein; ein relativer Pfad wird mit „Dein Datenverzeichnis muss ein absoluter Pfad sein" abgelehnt. Den ermittelten absoluten Pfad zeigt Ihnen der Dateimanager oder der FTP-Zugang an.

Ist ein Verzeichnis außerhalb des Webroots nicht möglich, bleibt data/ innerhalb der Installation. Dann hängt der Schutz allein an der .htaccess: Der Server legt beim Einrichten und bei jedem Update eine data/.htaccess mit Require all denied an. Greift .htaccess bei Ihrem Hoster nicht, sind Ihre Dateien öffentlich abrufbar. Der Selbsttest dafür steht in Nach der Einrichtung prüfen; fällt er negativ aus, ist das Paket für owncloud.online ungeeignet.

6. Einrichtung im Browser #

Rufen Sie Ihre Domain auf. Es erscheint das Einrichtungsformular:

Der Abschnitt Speicher & Datenbank ist zunächst zugeklappt. Mit Installation abschließen startet der Vorgang; er dauert je nach Hoster ein bis zwei Minuten und darf nicht abgebrochen werden.

Dabei schreibt die Einrichtung config/config.php und setzt darin unter anderem:

Damit das gelingt, muss config/ für PHP beschreibbar sein. Andernfalls bricht die Einrichtung mit „Das Schreiben in das „config"-Verzeichnis ist nicht möglich" ab.

Nach der Einrichtung prüfen #

Rufen Sie https://ihre-domain.example/status.php auf. Die Antwort ist ein JSON-Objekt und enthält unter anderem diese Felder:

{
  "installed": true,
  "maintenance": false,
  "needsDbUpgrade": false,
  "version": "11.0.13",
  "versionstring": "11.0.13",
  "productname": "owncloud.online",
  "product": "owncloud.online"
}

Steht installed auf false, ist die Einrichtung nicht durchgelaufen; steht needsDbUpgrade auf true, fehlt noch ein Aktualisierungslauf.

Melden Sie sich anschließend an und öffnen Sie Einstellungen → Administration → Allgemein. Diese Seite führt beim Aufruf mehrere Selbsttests aus. Erscheint dort

Dein Datenverzeichnis und deine Dateien sind wahrscheinlich vom Internet aus erreichbar. Die .htaccess-Datei funktioniert nicht.

dann greift .htaccess nicht. Verschieben Sie das Datenverzeichnis aus dem Webroot, oder wechseln Sie den Hoster — diese Warnung darf nicht stehen bleiben. Weitere Meldungen derselben Seite betreffen fehlende Internetverbindung des Servers, fehlenden Memory Cache und eine defekte WebDAV-Schnittstelle; was dahintersteckt, steht unter Sicherheit und Setup-Warnungen.

Cron einrichten #

Ohne Hintergrund-Jobs werden Papierkorb und alte Dateiversionen nie geleert, Freigaben laufen nicht ab und es gehen keine Benachrichtigungs-Mails hinaus. Welche Aufgaben das im Einzelnen sind, steht unter Hintergrund-Jobs (Cron).

Der Betriebsmodus steht unter Einstellungen → Administration → Allgemein im Abschnitt Cron. Zur Auswahl stehen AJAX, Webcron und Cron. Welchen Sie brauchen, hängt davon ab, was Ihr Hoster anbietet.

Fall A: Der Hoster kann nur URLs aufrufen #

Das ist der häufigste Fall. Tragen Sie im Cron-Menü des Hosters diese Adresse ein:

https://ihre-domain.example/cron.php

Stellen Sie den Modus in owncloud.online auf Webcron. Das ist zwingend: Steht der Modus auf Cron, antwortet der Aufruf über HTTP nur mit „Background jobs are using system cron!" und führt nichts aus.

Ein Aufruf über HTTP arbeitet genau einen Job ab (core/Controller/CronController.php). Wählen Sie deshalb ein kurzes Intervall — fünf Minuten, wenn Ihr Hoster es zulässt. Bei einem 15-Minuten-Takt räumt sich eine Warteschlange, die sich einmal aufgebaut hat, nur sehr langsam ab.

Fall B: Der Hoster kann PHP-Dateien ausführen #

Manche Pakete bieten einen Cronjob, der eine PHP-Datei mit dem Kommandozeilen-PHP aufruft, ohne dass Sie SSH haben. Tragen Sie dort die cron.php Ihrer Installation ein, Intervall 15 Minuten. Dieser Weg arbeitet pro Lauf so viele Jobs ab, wie in 14 Minuten hineinpassen, und ist damit dem URL-Aufruf deutlich überlegen.

Zwei Eigenheiten: cron.php ruft auf der Kommandozeile intern occ über die PHP-Funktion system() auf. Sperrt Ihr Hoster diese Funktion, passiert nichts. Und der erste erfolgreiche Lauf stellt den Modus selbsttätig auf Cron um — wechseln Sie später zurück auf den URL-Aufruf, müssen Sie den Modus von Hand wieder auf Webcron stellen.

Ob es läuft #

Derselbe Abschnitt Cron zeigt „Letzte Cron-Job-Ausführung: …". Steht dort „Cron wurde bis jetzt noch nicht ausgeführt!" oder liegt der Zeitpunkt mehr als eine Stunde zurück, färbt sich die Anzeige rot.

Was ohne SSH anders läuft #

Die übrigen Seiten dieser Dokumentation schreiben Wartungsbefehle in der Form sudo -u www-data php8.4 occ … (siehe occ – die Kommandozeile). Das setzt einen eigenen Linux-Server voraus. Im Webhosting gibt es weder sudo noch den Benutzer www-data, und in aller Regel überhaupt keine Kommandozeile. Damit entfällt eine Reihe von Aufgaben:

Zwei weitere Unterschiede:

• Adressen mit index.php. Die Regeln, die index.php aus den Adressen entfernen, entstehen nur beim Einrichten und beim Aktualisieren aus dem Schlüssel htaccess.RewriteBase — nachträglich anstoßen ließe sich das nur mit sudo -u www-data php8.4 occ maintenance:update:htaccess. Lassen Sie den Schlüssel deshalb unangetastet.
• Mailversand. Die Vorgabe mail_smtpmode => 'php' ruft ein lokales sendmail auf, das es auf Webhosting meist nicht gibt. Tragen Sie den SMTP-Zugang Ihres Hosters unter Einstellungen → Administration → Allgemein → E-Mail-Server ein, siehe E-Mail-Versand.

Was Sie stattdessen von Hand in config/config.php eintragen, beschreibt Konfiguration (config.php). Bearbeiten Sie die Datei nur bei angehaltenem Betrieb und legen Sie vorher eine Kopie an — ein Syntaxfehler darin macht die Instanz unerreichbar.

PHP-Einstellungen, die der Hoster bereitstellen muss #

owncloud.online bringt eine .user.ini mit. Wertet Ihr Hoster diese Datei aus — bei PHP als FPM oder CGI ist das der Regelfall —, sind die wichtigsten Werte damit bereits gesetzt:

upload_max_filesize=513M
post_max_size=513M
memory_limit=512M
default_charset='UTF-8'
output_buffering=0

Andernfalls müssen Sie dieselben Werte im PHP-Menü des Kundenmenüs setzen. Die Regeln im Einzelnen:

Die .htaccess kann diese Werte auf PHP 8.4 nicht setzen: Die php_value-Zeilen darin stehen in Blöcken für mod_php5 und mod_php7 und greifen nur, wenn PHP als Apache-Modul dieser Generationen läuft.

Apps nachinstallieren #

Im Release stecken der Server, die mitgelieferten Apps unter apps/ und die Markt-App unter apps-external/market. Alles Weitere — etwa Aktivitäten, Galerie, Texteditor, Gäste-Konten oder benutzerdefinierte Gruppen — kommt aus dem Markt.

Für Verwaltungskonten erscheint im App-Menü links oben der Eintrag Markt. Von dort werden Apps gesucht und installiert. Zwei Voraussetzungen:

• Der Server muss https://marketplace.owncloud.online erreichen dürfen. Sperrt Ihr Hoster ausgehende Verbindungen, bleibt der Katalog leer.
• apps-external/ muss für PHP beschreibbar sein. Ist es das nicht, bricht die Installation mit „Installing apps is not supported because the app folder is not writable." ab.

Ist der Markt nicht nutzbar, geht es auch von Hand: App-Paket als .tar.gz besorgen, örtlich entpacken, das enthaltene Verzeichnis nach apps-external/ hochladen und die App unter Einstellungen → Administration → Apps aktivieren. Der Verzeichnisname muss der <id> aus appinfo/info.xml entsprechen. Einzelheiten in Apps verwalten.

Aktualisieren ohne SSH #

1. Sicherung anlegen: Datenbank über das Kundenmenü exportieren, config/ und das Datenverzeichnis herunterladen.
2. Wartungsmodus einschalten — dazu 'maintenance' => true, in config/config.php eintragen.
3. Neues Release herunterladen, Prüfsumme vergleichen, hochladen, entpacken.
4. Alle Verzeichnisse aus dem Archiv — apps/, core/, lib/, ocs/, ocs-provider/, ocm-provider/, resources/, settings/ und apps-external/market — sowie die Dateien im Wurzelverzeichnis durch die neuen ersetzen. config/, das Datenverzeichnis und selbst installierte Apps in apps-external/ bleiben unangetastet.
5. Wartungsmodus wieder ausschalten.
6. Domain im Browser aufrufen. Es erscheint die Meldung, dass owncloud.online auf die neue Version aktualisiert wird, mit dem Knopf Aktualisierung starten.

Der Assistent verweigert den Dienst bei mehr als 50 Konten oder installierter App user_ldap; dann führt nur sudo -u www-data php8.4 occ upgrade weiter, was ohne Kommandozeile ausscheidet. Zum Ablauf im Übrigen siehe Backups und Updates.

Fehlersuche #

Findet sich die Ursache nicht, steht sie fast immer im Protokoll: <datadirectory>/owncloud.log, eine Zeile je Ereignis. Die Anfragekennung vom Fehlerbildschirm führt zum passenden Eintrag.