Installation auf einem Linux-Server #

Nach diesen zwölf Schritten läuft owncloud.online mit HTTPS auf Ihrem Server. Sie brauchen dafür nur einen SSH-Zugang mit Administratorrechten. Jeder Befehl lässt sich kopieren und einfügen.

Die Befehle gelten für Ubuntu 24.04 LTS. Wo Debian 12 abweicht, steht ein Hinweis. Geprüft wurde die Anleitung mit owncloud.online 11.0.25 auf frischen Installationen beider Systeme.

Ersetzen Sie in den Befehlen diese Platzhalter:

Die Schritte im Überblick:

1. Server vorbereiten
2. Programme installieren
3. PHP einstellen
4. Datenbank anlegen
5. owncloud.online herunterladen und prüfen
6. Auspacken und Rechte setzen
7. Installieren
8. Webserver einrichten
9. HTTPS einschalten
10. Hintergrund-Jobs einrichten
11. Zwischenspeicher einschalten
12. Anmelden und prüfen

Die Installation in Schritt 7 läuft über die Kommandozeile, bevor der Webserver die Seite ausliefert. So ist der Einrichtungsassistent zu keinem Zeitpunkt offen im Internet erreichbar.

1. Server vorbereiten #

apt install -y sudo
usermod -aG sudo IHR_BENUTZER

Updates einspielen #

Bringen Sie das System auf den neuesten Stand, bevor Sie etwas installieren:

sudo apt update
sudo apt full-upgrade -y
sudo reboot

Erscheint während der Aktualisierung ein Fenster mit einer Frage zu Diensten oder zum Kernel, bestätigen Sie mit der Eingabetaste. Nach dem Neustart melden Sie sich wieder per SSH an.

Adresse einrichten #

Browser und Let's Encrypt finden den Server über seinen Namen. Dafür braucht er einen Eintrag im DNS.

1. Ermitteln Sie die öffentliche IP-Adresse des Servers. Sie steht im Kundenmenü Ihres Anbieters. Auf den meisten Servern zeigt dieser Befehl sie auch an, die erste Adresse ist die IPv4-Adresse:

   bashKopieren

   hostname -I
   

2. Legen Sie bei Ihrem Domain-Anbieter einen A-Eintrag an, zum Beispiel mit dem Namen cloud und der IPv4-Adresse als Ziel. Einen AAAA-Eintrag für IPv6 legen Sie nur an, wenn der Server unter dieser IPv6-Adresse erreichbar ist.

3. Prüfen Sie den Eintrag auf Ihrem eigenen Rechner:

   bashKopieren

   nslookup cloud.example.com
   

   Die Antwort nennt die IP-Adresse des Servers. Neue Einträge brauchen manchmal bis zu einer Stunde, bis sie überall bekannt sind.

Firewall einschalten #

Die Firewall lässt nur SSH, HTTP und HTTPS durch. Der erste Befehl installiert sie, falls sie fehlt:

sudo apt install -y ufw
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Die Rückfrage Command may disrupt existing ssh connections. Proceed with operation (y|n)? beantworten Sie mit y. Prüfen Sie das Ergebnis:

sudo ufw status

Die Ausgabe beginnt mit Status: active und nennt 22/tcp, 80/tcp und 443/tcp mit ALLOW.

2. Programme installieren #

Paketquelle für PHP 8.4 hinzufügen #

Ubuntu 24.04 bringt PHP 8.3 mit. PHP 8.4 kommt aus der Paketquelle ondrej/php. Ondřej Surý betreut auch die PHP-Pakete von Debian.

sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php

Der zweite Befehl zeigt eine Beschreibung der Paketquelle. Darin steht, dass sie nach packages.sury.org umzieht. Für Ubuntu 24.04 gilt sie weiter.

Prüfen Sie, ob PHP 8.4 jetzt angeboten wird:

apt-cache policy php8.4-fpm

In der Zeile Candidate: steht eine Version, die mit 8.4. beginnt.

sudo apt install -y lsb-release ca-certificates curl
curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

Pakete installieren #

Ein Befehl installiert den Webserver Apache, die Datenbank MariaDB, Redis, PHP mit allen nötigen Erweiterungen, Certbot für das HTTPS-Zertifikat und die Werkzeuge cron, curl und nano, falls sie fehlen:

sudo apt install -y apache2 mariadb-server redis-server \
  php8.4-fpm php8.4-cli php8.4-mysql php8.4-curl php8.4-gd php8.4-intl \
  php8.4-mbstring php8.4-xml php8.4-zip php8.4-bcmath php8.4-imagick \
  php8.4-apcu php8.4-redis certbot python3-certbot-apache cron curl nano

Zwischendurch erscheinen Zeilen mit NOTICE, die a2enconf php8.4-fpm empfehlen. Das ist nicht nötig: Schritt 8 bindet PHP-FPM in der Konfiguration der Website ein.

Prüfen Sie das Ergebnis:

php8.4 -v
systemctl is-active apache2 mariadb redis-server php8.4-fpm

Die erste Zeile beginnt mit PHP 8.4. Der zweite Befehl gibt viermal active aus.

3. PHP einstellen #

owncloud.online braucht für große Uploads und für Aktualisierungen längere Zeitgrenzen und mehr Platz im OPcache, als PHP vorgibt. Diese Befehle legen je eine kleine Einstellungsdatei für PHP-FPM und für die Kommandozeile an:

sudo tee /etc/php/8.4/fpm/conf.d/90-owncloud-online.ini > /dev/null <<'EOF'
max_execution_time = 3600
max_input_time = 3600
opcache.memory_consumption = 256
opcache.interned_strings_buffer = 32
opcache.max_accelerated_files = 24000
EOF
echo 'apc.enable_cli = 1' | sudo tee /etc/php/8.4/cli/conf.d/90-owncloud-online.ini > /dev/null
sudo systemctl restart php8.4-fpm

Prüfen Sie, ob PHP-FPM die Werte übernommen hat:

sudo php-fpm8.4 -i | grep max_execution_time

Die Ausgabe lautet max_execution_time => 3600 => 3600.

4. Datenbank anlegen #

owncloud.online speichert Konten, Freigaben und die Dateiliste in MariaDB. Es bekommt eine eigene Datenbank und ein eigenes Datenbankkonto.

Erzeugen Sie zuerst ein zufälliges Passwort für das Datenbankkonto:

openssl rand -hex 20

Notieren Sie die Ausgabe. Sie brauchen sie gleich und in Schritt 7. Öffnen Sie dann die Konsole von MariaDB:

sudo mariadb

Ersetzen Sie in diesen Zeilen DATENBANK_PASSWORT durch das notierte Passwort. Die Anführungszeichen bleiben stehen. Fügen Sie die Zeilen dann ein:

CREATE DATABASE owncloud_online CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'owncloud'@'localhost' IDENTIFIED BY 'DATENBANK_PASSWORT';
GRANT ALL PRIVILEGES ON owncloud_online.* TO 'owncloud'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Jede Zeile antwortet mit Query OK, EXIT mit Bye.

5. owncloud.online herunterladen und prüfen #

Laden Sie das Release und die Prüfsummen herunter und kontrollieren Sie, dass die Datei unverändert angekommen ist:

cd /tmp
curl -fLO https://github.com/BWTECH-github/owncloud.online/releases/download/v11.0.25/owncloud-online-11.0.25.tar.gz
curl -fLO https://github.com/BWTECH-github/owncloud.online/releases/download/v11.0.25/SHA256SUMS.txt
sha256sum --ignore-missing -c SHA256SUMS.txt

Die letzte Zeile lautet owncloud-online-11.0.25.tar.gz: OK.

Steht unter https://github.com/BWTECH-github/owncloud.online/releases eine neuere Version, ersetzen Sie 11.0.25 in diesem und im nächsten Schritt überall durch die neue Nummer.

6. Auspacken und Rechte setzen #

Das Archiv enthält einen einzigen Ordner owncloud. Er wird nach /var/www ausgepackt und umbenannt. Das Datenverzeichnis liegt außerhalb davon, damit der Webserver es nie ausliefert. Beide gehören dem Benutzer www-data, unter dem Webserver und PHP laufen:

sudo tar -xzf /tmp/owncloud-online-11.0.25.tar.gz -C /var/www
sudo mv /var/www/owncloud /var/www/owncloud.online
sudo mkdir -p /var/oco-data
sudo chown -R www-data:www-data /var/www/owncloud.online /var/oco-data
sudo chmod 750 /var/oco-data

Prüfen Sie das Ergebnis:

ls /var/www/owncloud.online

Die Liste enthält unter anderem apps, config, core, index.php und occ.

7. Installieren #

Die Installation legt die Tabellen an, erstellt das Administratorkonto und schreibt die Konfiguration nach config/config.php:

cd /var/www/owncloud.online
sudo -u www-data php8.4 occ maintenance:install \
  --database mysql \
  --database-name owncloud_online \
  --database-user owncloud \
  --admin-user admin \
  --data-dir /var/oco-data

Der Befehl fragt zwei Passwörter ab. Die Eingabe bleibt unsichtbar.

1. What is the password to access the database with user <owncloud>?: das Datenbank-Passwort aus Schritt 4.
2. What is the password you like to use for the admin account <admin>?: ein neues, langes Passwort für das Administratorkonto. Notieren Sie es.

Nach kurzer Zeit erscheint owncloud.online was successfully installed.

Die Installation kennt Ihre Adresse noch nicht. Tragen Sie sie ein und schalten Sie Adressen ohne index.php ein:

sudo -u www-data php8.4 occ config:system:set trusted_domains 0 --value cloud.example.com
sudo -u www-data php8.4 occ config:system:set overwrite.cli.url --value https://cloud.example.com
sudo -u www-data php8.4 occ config:system:set htaccess.RewriteBase --value /
sudo -u www-data php8.4 occ maintenance:update:htaccess

Jeder config:system:set-Befehl bestätigt mit einer Zeile, die mit System config value beginnt. Der letzte meldet .htaccess has been updated.

sudo rm /var/www/owncloud.online/config/config.php
sudo mariadb -e "DROP DATABASE owncloud_online; CREATE DATABASE owncloud_online CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"

8. Webserver einrichten #

Apache liefert owncloud.online unter Ihrer Adresse aus und gibt PHP-Dateien an PHP-FPM weiter. Schalten Sie zuerst die nötigen Module ein:

sudo a2enmod rewrite headers env dir mime setenvif proxy_fcgi ssl

Öffnen Sie dann eine neue Konfigurationsdatei im Editor nano:

sudo nano /etc/apache2/sites-available/owncloud-online.conf

Fügen Sie diesen Inhalt ein und ersetzen Sie cloud.example.com durch Ihre Adresse. Speichern Sie mit Strg+O und der Eingabetaste, beenden Sie nano mit Strg+X.

<VirtualHost *:80>
    ServerName cloud.example.com
    DocumentRoot /var/www/owncloud.online

    <Directory /var/www/owncloud.online>
        Require all granted
        AllowOverride All
        Options FollowSymLinks
    </Directory>

    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.4-fpm.sock|fcgi://localhost"
    </FilesMatch>

    # Große Uploads: keine Größengrenze, Zeit für das Zusammensetzen
    TimeOut 3600
    LimitRequestBody 0

    ErrorLog  ${APACHE_LOG_DIR}/owncloud-online-error.log
    CustomLog ${APACHE_LOG_DIR}/owncloud-online-access.log combined
</VirtualHost>

Schalten Sie die neue Konfiguration ein und die Standardseite von Apache aus:

sudo a2ensite owncloud-online
sudo a2dissite 000-default
sudo apache2ctl configtest
sudo systemctl restart apache2

configtest meldet Syntax OK. Eine Warnung, die mit AH00558 beginnt, können Sie ignorieren. Prüfen Sie dann, ob owncloud.online antwortet:

curl -s http://cloud.example.com/status.php

Die Antwort beginnt mit {"installed":true. Melden Sie sich noch nicht im Browser an. Ohne HTTPS ginge Ihr Passwort unverschlüsselt über das Netz.

9. HTTPS einschalten #

Certbot holt ein kostenloses Zertifikat von Let's Encrypt, trägt es in Apache ein und leitet HTTP auf HTTPS um:

sudo certbot --apache --redirect -d cloud.example.com

Beim ersten Aufruf stellt Certbot drei Fragen:

1. nach einer E-Mail-Adresse für Hinweise zum Zertifikat,
2. ob Sie den Nutzungsbedingungen von Let's Encrypt zustimmen: Y,
3. ob Certbot Ihre Adresse an die Electronic Frontier Foundation weitergeben darf. Das ist freiwillig, N genügt.

Am Ende steht Congratulations! You have successfully enabled HTTPS on https://cloud.example.com.

Certbot erneuert das Zertifikat danach selbst. Ob das klappen wird, prüft dieser Probelauf:

sudo certbot renew --dry-run

Er endet mit Congratulations, all simulated renewals succeeded.

10. Hintergrund-Jobs einrichten #

owncloud.online erledigt alle 15 Minuten Arbeiten im Hintergrund: Papierkorb und alte Versionen aufräumen, abgelaufene Freigaben entfernen, Benachrichtigungen und Mails verschicken. Ohne diesen Zeitplan wächst die Instanz unbegrenzt und verschickt keine Mails.

echo '*/15 * * * * /usr/bin/php8.4 /var/www/owncloud.online/occ system:cron' | sudo crontab -u www-data -
sudo -u www-data php8.4 /var/www/owncloud.online/occ background:cron

Der zweite Befehl antwortet mit Set mode for background jobs to 'cron'. Der erste ersetzt einen vorhandenen Zeitplan des Benutzers www-data. Auf einem neuen Server gibt es keinen. Prüfen Sie den Eintrag:

sudo crontab -u www-data -l

Nach spätestens 15 Minuten zeigt Einstellungen → Administration → Allgemein im Abschnitt Cron die Zeile „Letzte Cron-Job-Ausführung: …“ mit einem grünen Punkt.

Ausgewählt ist die Option Cron. Sie bedeutet, dass der Cron-Dienst des Systems die Hintergrund-Jobs startet.

sudo -u www-data php8.4 /var/www/owncloud.online/occ system:cron

11. Zwischenspeicher einschalten #

APCu hält häufig gelesene Daten im Arbeitsspeicher von PHP. Redis verwaltet die Dateisperren, damit sich gleichzeitige Zugriffe auf dieselbe Datei nicht in die Quere kommen:

cd /var/www/owncloud.online
sudo -u www-data php8.4 occ config:system:set memcache.local --value '\OC\Memcache\APCu'
sudo -u www-data php8.4 occ config:system:set memcache.locking --value '\OC\Memcache\Redis'
sudo -u www-data php8.4 occ config:system:set redis host --value 127.0.0.1
sudo -u www-data php8.4 occ config:system:set redis port --value 6379 --type integer

Jeder Befehl bestätigt mit einer Zeile, die mit System config value beginnt. Prüfen Sie, ob Redis antwortet:

redis-cli ping

Die Antwort lautet PONG.

12. Anmelden und prüfen #

Öffnen Sie https://cloud.example.com im Browser. Geben Sie unter Benutzername oder E-Mail den Namen des Administratorkontos aus Schritt 7 ein, darunter das Passwort, und klicken Sie auf Anmelden.

Öffnen Sie danach oben rechts über Ihren Namen Einstellungen und links Administration → Allgemein. Im Abschnitt Sicherheits- & Einrichtungswarnungen steht nach dieser Anleitung keine Warnung, sondern nur „Alle Checks bestanden.“ oder, bei der Anrede mit Du, „Alle Überprüfungen bestanden.“ Was eine andere Meldung bedeutet, steht unter Sicherheit und Setup-Warnungen.

Zum Schluss prüfen Sie den Zustand auf der Kommandozeile:

cd /var/www/owncloud.online
sudo -u www-data php8.4 occ status
sudo -u www-data php8.4 occ check

occ status zeigt installed: true und versionstring: 11.0.25. occ check gibt nichts aus, wenn alle Voraussetzungen erfüllt sind.

sudo -u www-data php8.4 /var/www/owncloud.online/occ user:resetpassword admin

Strengere Rechte (freiwillig) #

Wer andere Benutzer des Servers ganz aussperren will, setzt jetzt strengere Rechte. Nach jedem Update sind die beiden Befehle zu wiederholen:

sudo find /var/www/owncloud.online -type d -exec chmod 750 {} \;
sudo find /var/www/owncloud.online -type f -exec chmod 640 {} \;

Danach öffnet nur noch www-data das Programmverzeichnis. Ihr eigenes Konto erhält bei cd /var/www/owncloud.online die Meldung Permission denied. Rufen Sie occ deshalb mit vollem Pfad auf:

sudo -u www-data php8.4 /var/www/owncloud.online/occ status

Wie es weitergeht #

nginx statt Apache #

nginx liest keine .htaccess. Alles, was dort steht, muss deshalb in der Konfiguration von nginx stehen. Der Ablauf weicht an vier Stellen ab:

1. Schritt 2: Installieren Sie nginx statt apache2 und python3-certbot-nginx statt python3-certbot-apache.

2. Schritt 7: Die letzten beiden Befehle zu htaccess.RewriteBase und maintenance:update:htaccess entfallen. Kurze Adressen schaltet unter nginx die Zeile fastcgi_param front_controller_active true; ein.

3. Schritt 8: Legen Sie statt der Apache-Konfiguration diese Datei an:

   bashKopieren

   sudo nano /etc/nginx/sites-available/owncloud-online
   

   Inhalt, wieder mit Ihrer Adresse statt cloud.example.com:

   nginxKopieren

   upstream php-handler {
       server unix:/run/php/php8.4-fpm.sock;
   }
   
   server {
       listen 80;
       listen [::]:80;
       server_name cloud.example.com;
   
       root /var/www/owncloud.online;
       index index.php index.html;
   
       # Ersatz für die Kopfzeilen der .htaccess
       add_header Strict-Transport-Security "max-age=15552000; includeSubDomains" always;
       add_header X-Content-Type-Options "nosniff" always;
       add_header X-XSS-Protection "0" always;
       add_header X-Frame-Options "SAMEORIGIN" always;
       add_header X-Robots-Tag "none" always;
       add_header X-Download-Options "noopen" always;
       add_header X-Permitted-Cross-Domain-Policies "none" always;
   
       # Große Uploads
       client_max_body_size 0;
       client_body_timeout 300s;
   
       # Umleitungen unter /.well-known
       location = /.well-known/host-meta      { rewrite ^ /public.php?service=host-meta last; }
       location = /.well-known/host-meta.json { rewrite ^ /public.php?service=host-meta-json last; }
       location ^~ /.well-known/carddav { return 301 /remote.php/dav/; }
       location ^~ /.well-known/caldav  { return 301 /remote.php/dav/; }
       location ^~ /.well-known/acme-challenge/ { }
       location ^~ /.well-known/pki-validation/ { }
   
       # Gesperrte Pfade wie in der .htaccess
       location ~ ^/(?:build|tests|config|lib|3rdparty|templates|changelog)/ { return 404; }
       location ~ ^/(?:\.|autotest|occ|issue|indie|db_|console) { return 404; }
       location = /core/signature.json { return 404; }
       location ^~ /core/skeleton/ { return 404; }
       location ^~ /data/ { return 404; }
       location ~ ^/(?:core|apps|apps-external)/.*/(?:package|package-lock|composer|bower|\.bower|installed|testem)\.json$ { return 404; }
       location ~ ^/(?:core|apps|apps-external)/.*/(?:composer|yarn)\.lock$ { return 404; }
       location ~ ^/(?:apps|apps-external)/[^/]+/(?:vendor|tests)/ { return 404; }
   
       # Vorhandene Dateien direkt ausliefern, alles andere über index.php
       location / {
           rewrite ^/remote/(.*) /remote.php last;
           try_files $uri /index.php$request_uri;
       }
   
       location ~ \.php(?:$|/) {
           fastcgi_split_path_info ^(.+?\.php)(/.*)$;
           try_files $fastcgi_script_name =404;
           include fastcgi_params;
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           fastcgi_param PATH_INFO $fastcgi_path_info;
           fastcgi_param PATH /usr/local/bin:/usr/bin:/bin;
           fastcgi_param HTTPS $https if_not_empty;
           fastcgi_param HTTP_AUTHORIZATION $http_authorization;
           fastcgi_param front_controller_active true;
           fastcgi_param modHeadersAvailable true;
           fastcgi_pass php-handler;
           fastcgi_read_timeout 3600s;
           fastcgi_request_buffering off;
       }
   
       # Föderation: diese Ordner liefern ihre eigene index.php aus
       location ~ ^/(?:ocs-provider|ocm-provider)(?:$|/) {
           try_files $uri/ =404;
           index index.php;
       }
   
       location ~ \.(?:css|js|mjs|woff2?|svg|gif|png|jpg|jpeg|ico|map)$ {
           try_files $uri /index.php$request_uri;
           access_log off;
           expires 7d;
       }
   }
   

   Schalten Sie die Konfiguration ein und die Standardseite aus:

   bashKopieren

   sudo ln -s /etc/nginx/sites-available/owncloud-online /etc/nginx/sites-enabled/
   sudo rm /etc/nginx/sites-enabled/default
   sudo nginx -t
   sudo systemctl reload nginx
   

   nginx -t meldet syntax is ok und test is successful.

4. Schritt 9: Certbot rufen Sie mit --nginx auf:

   bashKopieren

   sudo certbot --nginx --redirect -d cloud.example.com
   

Fehlersuche #

Die meisten Fehler stehen mit Ursache im Protokoll /var/oco-data/owncloud.log, Fehler des Webservers in /var/log/apache2/owncloud-online-error.log. Mehr unter Serverprotokoll und Fehlermeldungen.