So richten Sie den ONLYOFFICE-Arbeitsbereich unter Ubuntu 24.04 LTS ein

ONLYOFFICE Workspace kombiniert die Online-Dokumentenbearbeitung mit einem umfassenden Kollaborationsportal. Unter Ubuntu 24.04 LTS empfiehlt sich die einfachste Serverkonfiguration mithilfe des offiziellen ONLYOFFICE Workspace Community-Installationsskripts in Verbindung mit Docker. Docker führt die Workspace-Komponenten in isolierten Containern aus, wodurch die Bereitstellung einfacher zu reproduzieren und zu aktualisieren ist als mit einem manuell erstellten Stack.

Diese Anleitung verwendet die Community Edition und beginnt mit einer praktischen Empfehlung für Erstadministratoren: Installieren Sie Workspace ohne den optionalen ONLYOFFICE Mailserver. Dadurch entfallen die Anforderungen an DNS und E-Mail-Zustellung bei der ersten Installation. Sie können den Mailserver später bei Bedarf über die Systemsteuerung hinzufügen.

Seit Oktober 2026 unterstützt Docker offiziell Ubuntu 24.04 LTS (Noble). Die aktuelle Dokumentation der ONLYOFFICE Workspace Community empfiehlt einen amd64-Linux-Host mit mindestens einem 4-Kern-Prozessor, 8 GB RAM, 40 GB freiem Festplattenspeicher und 6 GB Swap-Speicher. Für eine reibungslosere Bereitstellung empfiehlt der Hersteller mehr CPU-Leistung und RAM. Lesen Sie vor der Bereitstellung auf einem Produktivserver die aktuelle Installationsanleitung für Docker in der ONLYOFFICE Workspace Community sowie die Docker-Installationsdokumentation für Ubuntu .

Was Sie vor Beginn benötigen

Sie benötigen einen Ubuntu 24.04 LTS-Server oder eine virtuelle Maschine, ein Benutzerkonto mit sudoentsprechenden Berechtigungen, Internetzugang zum Herunterladen von Paketen und Container-Images sowie ausreichend freie Ressourcen für die Workspace-Dienste. Soll das Portal von anderen Computern aus erreichbar sein, benötigt der Server außerdem eine stabile LAN-Adresse oder eine öffentliche IP-Adresse.

amd64 bezeichnet die gängige 64-Bit-x86-Serverarchitektur, die von Intel- und AMD-Prozessoren verwendet wird. Gehen Sie nicht davon aus, dass Docker eine andere Architektur unterstützt, da dies nicht automatisch bedeutet, dass ONLYOFFICE Workspace diese unterstützt. Die aktuellen Workspace-Anforderungen nennen ausdrücklich amd64 Linux.

Schritt 1: Sicherstellen, dass der Ubuntu-Host über genügend Ressourcen verfügt

Öffnen Sie das Terminal oder verbinden Sie sich per SSH mit dem Server. Führen Sie folgenden Befehl aus:

uname -m
free -h
df -h

uname -mzeigt die Prozessorarchitektur an. Auf einem kompatiblen x86-64-Host wird normalerweise angezeigt x86_64. free -hzeigt RAM und Swap an, während df -hden freien Festplattenspeicher in lesbaren Einheiten angibt.

Vermeiden Sie die Fortsetzung auf einem Server mit bereits geringem Arbeitsspeicher oder Speicherplatz. Die Installation kann zwar abgeschlossen werden, schlägt aber später unter Bearbeitungs- oder Indizierungslast fehl. Dies ist schwieriger zu diagnostizieren als die Kapazitätserweiterung im Vorfeld.

Schritt 2: Installieren Sie Docker Engine aus dem offiziellen Ubuntu-Repository von Docker.

Docker Engine ist der Dienst, der die für die Workspace-Bereitstellung benötigten Container erstellt und ausführt. Die aktuellen Ubuntu-Anweisungen von Docker unterstützen Ubuntu 24.04 LTS und empfehlen für eine normale Serverinstallation die Verwendung des Docker-eigenen APT-Repositorys.

Installieren Sie zunächst die grundlegenden Repository-Tools:

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Fügen Sie den aktuellen Signaturschlüssel und das Repository von Docker hinzu:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Installieren Sie anschließend Docker Engine und das Compose-Plugin:

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

Prüfen Sie, ob der Dienst ausgeführt wird:

sudo systemctl status docker --no-pager

Schritt 3: Docker vor der Einbindung von ONLYOFFICE überprüfen

Diese kleine Überprüfung trennt Docker-Probleme von Workspace-Problemen. Ausführen:

sudo docker run --rm hello-world

Docker lädt ein kleines Test-Image herunter, startet einen Container, gibt eine Bestätigungsmeldung aus und beendet sich. Falls dies fehlschlägt, beheben Sie das Problem zuerst mit Docker, anstatt mit dem Workspace-Skript fortzufahren.

Ein häufiger Anfängerfehler ist, einen Berechtigungsfehler fälschlicherweise dockerals ONLYOFFICE-Fehler zu interpretieren. Diese Anleitung verwendet bewusst sudo dockerdie Docker-Gruppe ONLYOFFICE, sodass Sie Ihr Konto nicht hinzufügen müssen. Docker weist darauf hin, dass die Mitgliedschaft in dieser Gruppe faktisch Root-Rechte gewährt. Fügen Sie daher nicht wahllos Benutzer hinzu, nur um Befehle zu verkürzen.

Schritt 4: Laden Sie den offiziellen ONLYOFFICE Workspace-Installer herunter.

ONLYOFFICE stellt ein Installationsskript auf seiner eigenen Download-Domain bereit. Laden Sie es direkt herunter:

curl -O https://download.onlyoffice.com/install/workspace-install.sh

Vor der Ausführung eines heruntergeladenen administrativen Skripts empfiehlt es sich, dieses zu überprüfen:

less workspace-install.sh

Drücken Sie qzum Verlassen less. Dies beweist nicht, dass ein Skript sicher ist, gibt Ihnen aber die Möglichkeit, den Quellcode zu überprüfen und unerwartete Befehle zu erkennen, bevor Sie ihm Root-Rechte erteilen.

Schritt 5: Workspace zunächst ohne Mailserver installieren

Führen Sie bei der ersten Bereitstellung das offizielle Skript aus und überspringen Sie dabei ONLYOFFICE Mail:

sudo bash workspace-install.sh -ims false

Der -ims falseParameter bedeutet „E-Mail-Server-Komponente nicht installieren“. Dadurch konzentriert sich die Ersteinrichtung auf das Workspace-Portal, die Dokumenteditoren und die Verwaltungskomponenten. ONLYOFFICE weist darauf hin, dass die E-Mail-Server-Komponente später über die Systemsteuerung installiert werden kann.

Falls Sie bereits über eine korrekt konfigurierte E-Mail-Dienstdomäne verfügen und die vollständige Installation wünschen, verwenden Sie bitte stattdessen dieses Formular von ONLYOFFICE:

sudo bash workspace-install.sh -md "mx1.example.com"

Ersetzen Sie [Platzhalter mx1.example.com] durch Ihren tatsächlichen E-Mail-Dienst-Hostnamen. Der Hostname muss zum Server aufgelöst werden, und die E-Mail-Domäne benötigt die entsprechenden DNS-Einträge. Verwenden Sie keinen fiktiven Hostnamen, nur damit die Installation fortgesetzt wird. Falsche DNS-Einstellungen sind einer der häufigsten Gründe, warum eine ansonsten erfolgreiche Workspace-Bereitstellung zu Problemen bei der E-Mail-Zustellung führen kann.

Schritt 6: Überprüfen Sie, ob die Container tatsächlich ausgeführt werden.

Wenn das Skript abgeschlossen ist, überprüfen Sie die laufenden Container:

sudo docker ps

Machen Sie sich keine Sorgen, wenn Ihre Containernamen von den Online-Beispielen abweichen. Namen und interne Komponenten können sich mit jeder neuen Version ändern. Wichtig ist, dass die erwarteten ONLYOFFICE-Container vorhanden sind und ihren Status „Läuft“ haben, anstatt ständig neu zu starten oder beendet zu werden.

Wenn ein Container ständig neu startet, überprüfen Sie den tatsächlichen Namen docker ps -aund führen Sie dann Folgendes aus:

sudo docker logs --tail 100 CONTAINER_NAME

Ersetzen Sie den Platzhalter CONTAINER_NAMEdurch einen von Docker angezeigten Namen. Dies ist sicherer, als einen alten Containernamen aus einem Tutorial zu kopieren.

Schritt 7: Öffnen Sie das Portal mit der tatsächlichen Netzwerkadresse des Servers.

Ermitteln Sie die Serveradressen mit:

hostname -I

Öffnen Sie in einem Browser, der den Server erreichen kann, Folgendes:

http://SERVER_IP

localhostDie Docker-Anleitung von ONLYOFFICE empfiehlt ausdrücklich, beim Verifizieren des Portals die Netzwerk-IP-Adresse des Rechners anstelle der IP-Adresse zu verwenden 127.0.0.1. Der erste Start kann nach der Installation einige Minuten dauern; eine kurze Verzögerung bedeutet daher nicht automatisch, dass die Bereitstellung fehlgeschlagen ist.

Schritt 8: Administrator-Einrichtung abschließen

Auf der ersten Seite werden Sie aufgefordert, ein Administratorkonto für das Portal anzulegen. Legen Sie ein sicheres Passwort fest, geben Sie eine gültige E-Mail-Adresse ein, wählen Sie die richtige Sprache und Zeitzone aus und akzeptieren Sie die Lizenzbedingungen. ONLYOFFICE weist darauf hin, dass die Standardpasswortrichtlinie eine Länge zwischen 8 und 120 Zeichen vorschreibt; Sie können die Sicherheitseinstellungen später anpassen.

Nach dem ersten Assistenten überprüfen Sie, ob Sie das Modul „Dokumente“ öffnen und ein Testdokument erstellen können. Eine erfolgreiche Anmeldung beweist bereits die Erreichbarkeit des Portals; das Öffnen und Bearbeiten eines Dokuments prüft zudem, ob die Komponente zur Dokumentbearbeitung korrekt verbunden ist.

Stellen Sie die Installation sicher, bevor Sie Benutzer einladen.

Soll der Server über eine temporäre Testumgebung hinaus genutzt werden, wechseln Sie von unverschlüsseltem HTTP zu HTTPS. Das ONLYOFFICE Control Panel kann ein Let's Encrypt-Zertifikat generieren und anwenden oder ein vorhandenes Zertifikat und den zugehörigen privaten Schlüssel akzeptieren. Für den integrierten Let's Encrypt-Workflow muss Port 80 während der Zertifikatsausstellung erreichbar sein. Weitere Informationen finden Sie im offiziellen ONLYOFFICE HTTPS-Konfigurationsleitfaden .

Prüfen Sie außerdem, welche Netzwerkports Sie tatsächlich benötigen. ONLYOFFICE stellt eine Portreferenz für die Workspace Community bereit . Geben Sie Datenbank- oder interne Dienstports nicht im Internet frei, nur weil sie in dieser Tabelle aufgeführt sind.

Ubuntu enthält UFW, eine Host-Firewall. Wichtig ist jedoch eine Einschränkung speziell für Docker: Die Docker-Dokumentation warnt davor, dass veröffentlichte Container-Ports UFW-Regeln umgehen können. Das bedeutet: „Ich habe den Port in UFW blockiert“ ist kein ausreichender Beweis dafür, dass ein von Docker veröffentlichter Port nicht erreichbar ist. Überprüfen Sie das Firewall-Verhalten von Docker und verwenden Sie für einen Server mit Internetzugang eine korrekt konzipierte Host- oder Upstream-Firewall-Richtlinie, anstatt anzunehmen, dass UFW allein jeden Container-Port kontrolliert. Die Firewall-Referenz von Ubuntu finden Sie in der Ubuntu Server-Firewall-Dokumentation .

Häufige Probleme und was Sie zuerst überprüfen sollten

Der Installateur meldet, dass ein benötigter Anschluss bereits belegt ist.

Prüfen Sie die Listener, bevor Sie zufällige Dienste stoppen:

sudo ss -ltnp | grep -E ':(80|443)\b'

Falls Apache, Nginx, ein anderer Container oder ein Management-Panel den Port bereits belegt, entscheiden Sie, welcher Dienst ihn behalten soll. Schalten Sie einen produktiven Webserver nicht einfach ab.

Das Portal lädt nach der Installation nicht.

Überprüfen Sie zuerst Docker:

sudo systemctl is-active docker
sudo docker ps -a

Wenn Docker inaktiv ist, starten Sie es und überprüfen Sie das Protokoll. Falls die Workspace-Container laufen, die Seite aber nicht erreichbar ist, stellen Sie sicher, dass Sie die korrekte Server-IP verwenden und dass Routing, Cloud-Sicherheitsgruppen und vorgelagerte Firewalls den erforderlichen Webverkehr zulassen.

Während der Installation geht dem Server der Speicherplatz aus.

Bitte überprüfen Sie dies erneut free -h. Die skriptbasierte Anleitung für Workspace empfiehlt mindestens 6 GB Swap-Speicher und 8 GB RAM als Minimum. Eine sehr kleine VM kann instabil werden, wenn mehrere Images gleichzeitig initialisiert werden. Der Wechsel zu einer größeren VM ist in der Regel sauberer, als jeden Dienst aufgrund von Speichermangel zu optimieren.

Sie benötigen später NUR OFFICE Mail.

Sie müssen Workspace nicht neu installieren. ONLYOFFICE beschreibt, wie Sie den Mailserver über die Update-Seite der Systemsteuerung hinzufügen. Bereiten Sie zuvor einen gültigen Hostnamen und die zugehörigen DNS-Einträge vor. Weitere Informationen finden Sie in der ONLYOFFICE-Anleitung zum Hinzufügen von Mail zu einer bestehenden Workspace-Installation .

Sie bevorzugen Docker Compose anstelle des Installationsskripts.

Dies ist eine sinnvolle Alternative, wenn Sie mehr Kontrolle über die Bereitstellungsdefinition wünschen. Die aktuellen Compose-Anweisungen von ONLYOFFICE setzen Docker Compose 2.16.0 oder höher für Ubuntu 22.04 und höher voraus und weisen Administratoren an, die entsprechende cgroupZeile in der Workspace-YAML-Datei zu aktivieren. Ubuntu 24.04 fällt in diese Kategorie „22.04 und höher“. Befolgen Sie die offizielle ONLYOFFICE Docker Compose-Anleitung, anstatt eine veraltete Compose-Datei aus einem anderen Tutorial zu kopieren.

Woran man erkennt, dass die Einrichtung wirklich abgeschlossen ist

Eine erfolgreiche Installation weist mehrere unabhängige Statusindikatoren auf: Docker ist aktiv; die Workspace-Container laufen weiter; das Portal lässt sich von einem anderen Rechner über die tatsächliche Netzwerkadresse des Servers öffnen; der Administrator kann sich anmelden; und ein Testdokument lässt sich im Browser-Editor öffnen. Wenn Sie den Dienst öffentlich zugänglich machen möchten, sollte HTTPS mit einem von Browsern als vertrauenswürdig eingestuften Zertifikat funktionieren.

Bei einer ersten Installation von Ubuntu 24.04 ist es ratsam, nach diesen Prüfungen aufzuhören, anstatt sofort E-Mail, benutzerdefinierte Reverse-Proxys, Drittanbieter-Speicher und Authentifizierungsintegrationen hinzuzufügen. Installieren Sie jeweils nur eine Funktion, überprüfen Sie diese und protokollieren Sie alle Änderungen an DNS, Firewall und Containern. Dadurch wird die spätere Fehlersuche deutlich einfacher.