ownCloud Infinite Scale mit Docker Compose installieren

Für eine Serverinstallation verwenden Sie zunächst das offizielle ocis_fullDocker Compose-Beispiel von ownCloud für die stabile Dokumentationsreihe 8.2. Es beinhaltet den Infinite Scale-Dienst, einen Reverse-Proxy und optionale Dienste für die Zusammenarbeit im Büro. Konfigurieren Sie Ihre Domains, den SMTP-Absender und die Datenpfade in der zugehörigen .envDatei, bevor Sie das Projekt starten docker compose up -d. Diese Konfiguration ist für eine Einzelinstanz ausgelegt und benötigt öffentliche DNS-Server sowie erreichbare Ports für vertrauenswürdige Let's Encrypt-Zertifikate. Für eine interne Evaluierung ohne Domain beachten Sie bitte die unten beschriebene Einschränkung für selbstsignierte Zertifikate.

Bevor Sie installieren

Diese Vorgehensweise orientiert sich an ownClouds Compose-Anleitung für die Infinite Scale 8.2-Produktionsumgebung (Stand: 9. Oktober 2026). Die Anleitung ist für Ubuntu LTS 24.04 oder 22.04 mit bereits installierter Docker Engine und Docker Compose ausgelegt. Es werden mindestens 4–6 GB Arbeitsspeicher empfohlen. Die standardmäßig aktivierten Dienste benötigen ca. 2,4 GB Festplattenspeicher, bevor Benutzerdateien, Protokolle, Backups und zukünftiges Wachstum berücksichtigt werden.

Wählen Sie dieses vollständige Beispiel, wenn Sie DNS, Firewall-Regeln und einen Linux-Host verwalten können. Es umfasst mehr als nur die Kerndateiplattform; für die domainfreie Evaluierung verwendet ownCloud laut eigenen Angaben selbstsignierte Zertifikate.

• Host: Ubuntu 24.04 LTS oder 22.04 LTS mit SSH- und sudo-Zugriff.
• Netzwerk: Eine Domäne, deren erforderliche DNS-Einträge zur WAN-Adresse des Servers aufgelöst werden; eingehende TCP-Ports 22, 80 und 443 in der Firewall und auf allen vorgelagerten Routern zulassen.
• Software: Docker Engine und das Compose-Plugin. Unter Linux dokumentiert Docker die Installation über sein Paket-Repository; nach der Installation überprüfen Sie, ob Compose mit . antwortet docker compose version.
• Für dieses Beispiel ist ein Wert für E-MailSMTP_SENDER erforderlich. Vervollständigen Sie die übrigen SMTP-Einstellungen, wenn Benachrichtigungs-E-Mails versendet werden sollen.

1. Docker Compose installieren und den Host vorbereiten

Falls Docker Engine bereits installiert ist, installieren Sie das Compose-Plugin gemäß der Anleitung in der offiziellen Compose-Installationsanleitung von Docker für Ihre Linux-Distribution . Für Ubuntu- oder Debian-Systeme, auf denen das Docker-Repository konfiguriert ist, lautet der dokumentierte Paketbefehl:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker empfiehlt für aktuelle Installationen das Plugin und die docker composeBefehlsform. Installieren Sie Docker Engine gegebenenfalls gemäß der offiziellen Ubuntu-Anleitung .

Bevor Sie die Konfiguration herunterladen, verweisen Sie die Domain oder Subdomains, die Sie verwenden möchten, auf die öffentliche IP-Adresse des Hosts. Das ownCloud-Beispiel benötigt dies OCIS_DOMAIN; es kann auch COLLABORA_DOMAINund verwenden, ONLYOFFICE_DOMAINwenn diese Office-Dienste konfiguriert sind. Die DNS-Namen müssen mit den Werten in übereinstimmen .env. Stellen Sie sicher, dass Ihr Router die Ports 80 und 443 an diesen Host weiterleitet und dass Ihre lokale Firewall diese Ports zulässt.

2. Holen Sie sich das offizielle Compose-Beispiel.

Verwenden Sie das ocis_fullVerzeichnis aus dem stable-8.2Branch der offiziellen ownCloud-Bereitstellungsbeispiele . Laden Sie die ZIP-Datei auf einen Computer mit Browser herunter, übertragen Sie sie mit dem Befehl `npm run dev` auf den Server ohne grafische Benutzeroberfläche scpund extrahieren Sie sie dort /opt/compose/ocis/ocis_fullwie in der ownCloud-Anleitung beschrieben.

Speichern Sie die aktuelle Datei, .envbevor Sie eine aktualisierte Kopie erstellen: ownCloud warnt davor, dass die Datei überschrieben werden kann. Führen Sie Compose-Befehle aus dem Projektverzeichnis aus.

3. Domänen, Zertifikate, E-Mail und Datenpfade konfigurieren

Öffnen Sie die Datei /opt/compose/ocis/ocis_full/.envin einem Texteditor. Behalten Sie die Variablennamen und die Syntax des Beispiels bei und bearbeiten Sie nur die Werte, die für Ihre Installation relevant sind:

• Legen Sie OCIS_DOMAINden Hostnamen fest, den die Benutzer eingeben werden. Legen Sie die Hostnamen für Collabora oder OnlyOffice nur dann fest, wenn diese Dienste im Beispiel aktiviert sind.
• Bei einem Server mit Internetanbindung kommentieren Sie die INSECUREentsprechenden Einstellungen gemäß dem Beispiel aus. Lassen Sie die unsichere Einstellung nicht für die öffentliche Nutzung aktiviert.
• Verwenden Sie TRAEFIK_ACME_MAILeine E-Mail-Adresse, über die Sie die Kontrolle haben. Für erste Zertifikatstests verwenden Sie TRAEFIK_ACME_CASERVERden Staging-Server von Let's Encrypt. Staging-Zertifikate sind für den normalen Gebrauch nicht vertrauenswürdig; sie dienen dazu, DNS und Erreichbarkeit zu testen, bevor Produktionszertifikate angefordert werden.
• Führen Sie diese Konfiguration durch SMTP_SENDER, auch wenn Sie noch keinen funktionierenden Mail-Relay-Server eingerichtet haben. Laut offizieller Anleitung startet die Bereitstellung ohne diese Einstellung nicht. Fügen Sie SMTP-Host, Port, Anmeldeinformationen, Authentifizierung und Sicherheitseinstellungen hinzu, sobald diese verfügbar sind. Ohne die übrigen Mail-Einstellungen kann die Instanz zwar starten, aber keine Benachrichtigungen senden.
• Überprüfen Sie OCIS_DOCKER_IMAGEdie Bild-Tags im Beispiel. Wechseln Sie während der Installation einer stabilen Version nicht willkürlich den Release-Kanal.
• Für einen Produktionsserver empfiehlt es sich, die geplanten Hostpfade auf Speichermedien mit ausreichender Kapazität und Backup-Abdeckung zuzuweisen OCIS_DATA_DIR. OCIS_CONFIG_DIRStandardmäßig werden Docker-verwaltete Volumes verwendet, was zwar praktisch ist, ownCloud weist jedoch darauf hin, dass deren Speicherort, Snapshots, Backups, Wiederherstellungen, Zurücksetzungen und Migrationen vom Speicher des Docker-Hosts abhängen.

Beschränken Sie den Zugriff auf den Server und seine Konfigurationsdatei. Ein selbstsigniertes Zertifikat eignet sich nur für interne Evaluierungszwecke, nicht für den vertrauenswürdigen öffentlichen Einsatz.

Überprüfen Sie im Projektverzeichnis die zusammengeführte Konfiguration, bevor Sie die Container starten:

cd /opt/compose/ocis/ocis_full
docker compose config

Beheben Sie gemeldete Variablen- oder YAML-Fehler, bevor Sie fortfahren. Dieser Befehl rendert die Compose-Konfiguration zur Überprüfung; er beweist nicht, dass DNS, Zertifikate, Speicherberechtigungen oder die SMTP-Verbindung funktionieren.

4. Starten Sie die Dienste und schließen Sie die Zertifikatseinrichtung ab.

Den Stack im Hintergrund starten:

docker compose up -d

Beim ersten Start werden Images heruntergeladen und die Dienste gestartet, daher kann dies länger dauern als spätere Neustarts. Überprüfen Sie den Dienststatus mit:

docker compose ps -a

Überprüfen Sie anschließend die Protokolle, falls ein Dienst beendet wird oder die Webadresse nicht geladen wird:

docker compose logs --follow

Beginnen Sie mit den Traefik-Logs. Zertifikatfehler deuten häufig auf fehlerhafte DNS-Einträge und .envWerte, blockierte Ports 80/443 oder eine ungültige ACME-E-Mail-Adresse hin. Beheben Sie die Ursache, bevor Sie es erneut versuchen. Verwenden Sie diese Funktion nicht docker compose down -vzum Zurücksetzen: Dadurch werden alle Projektvolumes inklusive der Daten gelöscht.

Wenn die Prüfung der Staging-Zertifikate erfolgreich war, befolgen Sie die Zertifikatsprozedur von ownCloud: Stoppen Sie die Bereitstellung, entfernen Sie nur das Zertifikat-Volume des Beispiels ( ocis_full_certs), löschen Sie die Einstellung der Staging-CA und starten Sie den Vorgang erneut, um vertrauenswürdige Produktionszertifikate anzufordern. Bestätigen Sie den genauen Volume-Namen, docker volume lsbevor Sie ihn entfernen. Entfernen Sie nicht die Daten- oder Konfigurations-Volumes.

Zugriff überprüfen und Bereitstellung schützen

Öffnen Sie die in der Konfiguration festgelegte URL OCIS_DOMAIN. Bei erfolgreicher Anmeldung erreicht der Browser die Anmeldeseite über HTTPS ohne Zertifikatswarnung und docker compose ps -azeigt die erforderlichen Dienste an. Melden Sie sich mit den von ownCloud dokumentierten Anmeldedaten an ( admin/ admin, sofern Sie kein anderes Passwort festgelegt haben) und ändern Sie anschließend umgehend das Administratorpasswort.

Wenn die Website nicht erreichbar ist, überprüfen Sie DNS, Portweiterleitung, die ACME-Protokolle von Traefik und anschließend die Protokolle des Infinite Scale-Dienstes. Falls die Anmeldung funktioniert, E-Mail-Benachrichtigungen jedoch nicht, überprüfen Sie die SMTP-Einstellungen.

Bevor Sie wichtige Dateien speichern, vergewissern Sie sich, dass Ihr Backup sowohl die Konfiguration als auch die Daten umfasst. Docker-verwaltete Volumes eignen sich gut für die Überprüfung; explizite Hostpfade lassen sich einfacher auf einer separaten Festplatte speichern und in Host-Backups einbinden. Sie sind bereit, wenn HTTPS funktioniert, Dienste nach einem Neustart weiterhin verfügbar sind, die Administratoranmeldung funktioniert und die Backups den gewählten Speicher abdecken.