Comment configurer l'espace de travail ONLYOFFICE sur Ubuntu 24.04 LTS

ONLYOFFICE Workspace combine l'édition de documents en ligne avec un portail de collaboration plus complet. Sous Ubuntu 24.04 LTS, la configuration serveur la plus simple consiste à utiliser le script d'installation officiel ONLYOFFICE Workspace Community avec Docker. Docker exécute les composants Workspace dans des conteneurs isolés, ce qui facilite la reproduction et la mise à jour du déploiement par rapport à une configuration manuelle.

Ce guide utilise l'édition Community et propose une solution pratique pour les administrateurs débutants : installer Workspace sans le serveur de messagerie ONLYOFFICE (optionnel). Cela simplifie la configuration DNS et la distribution du courrier dès le premier déploiement. Vous pourrez ajouter la messagerie ultérieurement depuis le Panneau de configuration si nécessaire.

À compter d'octobre 2026, Docker prend officiellement en charge Ubuntu 24.04 LTS (Noble). La documentation actuelle de l'espace de travail communautaire ONLYOFFICE recommande un hôte Linux amd64 doté d'au moins un processeur quadricœur, 8 Go de RAM, 40 Go d'espace disque disponible et 6 Go de swap. Le fournisseur recommande davantage de ressources processeur et de RAM pour un déploiement plus fluide. Consultez le guide d'installation Docker de l'espace de travail communautaire ONLYOFFICE et la documentation d'installation de Docker pour Ubuntu avant tout déploiement sur un serveur de production.

Ce dont vous avez besoin avant de commencer

Vous avez besoin d'un serveur ou d'une machine virtuelle Ubuntu 24.04 LTS, d'un compte disposant sudodes privilèges nécessaires, d'un accès Internet sortant pour télécharger les paquets et les images de conteneurs, ainsi que de ressources suffisantes pour les services Workspace. Si vous souhaitez que le portail soit accessible depuis d'autres ordinateurs, le serveur doit également disposer d'une adresse IP publique ou d'une adresse réseau stable.

amd64 désigne l'architecture serveur x86 64 bits courante utilisée par les processeurs Intel et AMD. Ne présumez pas que la prise en charge d'une autre architecture par Docker implique automatiquement sa prise en charge par ONLYOFFICE Workspace ; la configuration requise actuelle de Workspace mentionne spécifiquement Linux amd64.

Étape 1 : Vérifier que l’hôte Ubuntu dispose de ressources suffisantes

Ouvrez le terminal ou connectez-vous au serveur via SSH. Exécutez :

uname -m
free -h
df -h

uname -mindique l'architecture du processeur. Sur un hôte x86-64 compatible, vous verrez normalement : `<nom_du_processeur> x86_64`. free -hLa RAM et la mémoire d'échange sont indiquées, tandis que ` df -h<nom_du_processeur>` affiche l'espace disque libre en unités lisibles par l'utilisateur.

Évitez de poursuivre l'installation sur un serveur dont la mémoire ou l'espace de stockage est déjà insuffisant. L'installation peut se terminer correctement, mais échouer ultérieurement lors de tâches d'édition ou d'indexation, ce qui est plus difficile à diagnostiquer que de corriger d'abord la capacité du serveur.

Étape 2 : Installez Docker Engine à partir du dépôt officiel Ubuntu de Docker.

Docker Engine est le service qui crée et exécute les conteneurs utilisés par le déploiement de l'espace de travail. La documentation Docker pour Ubuntu prend actuellement en charge Ubuntu 24.04 LTS et recommande l'utilisation du dépôt APT de Docker pour une installation serveur standard.

Commencez par installer les outils de base du dépôt :

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

Ajoutez la clé de signature et le dépôt actuels de Docker :

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

Installez ensuite Docker Engine et le plugin Compose :

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

Vérifiez que le service est en cours d'exécution :

sudo systemctl status docker --no-pager

Étape 3 : Vérifier Docker avant d’impliquer ONLYOFFICE

Cette simple vérification permet de distinguer les problèmes liés à Docker de ceux liés à l'espace de travail. Exécutez :

sudo docker run --rm hello-world

Docker télécharge une petite image de test, lance un conteneur, affiche un message de confirmation et s'arrête. En cas d'échec, corrigez d'abord Docker avant de poursuivre l'exécution du script Workspace.

Une erreur fréquente chez les débutants est de considérer une erreur d'autorisation comme dockerune défaillance d'ONLYOFFICE. Ce guide utilise intentionnellement ONLYOFFICEsudo docker ; vous n'avez donc pas besoin d'ajouter votre compte au groupe Docker. Docker avertit que l'appartenance à ce groupe confère de fait un contrôle total (niveau root) ; n'ajoutez donc pas d'utilisateurs à la légère, simplement pour raccourcir les commandes.

Étape 4 : Téléchargez le programme d’installation officiel d’ONLYOFFICE Workspace

ONLYOFFICE met à disposition un script d'installation sur son propre domaine de téléchargement. Téléchargez-le directement :

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

Avant d'exécuter un script d'administration téléchargé, il est recommandé de l'inspecter :

less workspace-install.sh

Appuyez sur Entrée qpour quitter less. Cela ne prouve pas qu'un script est sûr, mais cela vous donne la possibilité de vérifier la source et de repérer les commandes inattendues avant de lui accorder les privilèges root.

Étape 5 : Installez d’abord Workspace sans le serveur de messagerie.

Pour un premier déploiement, exécutez le script officiel en ignorant ONLYOFFICE Mail :

sudo bash workspace-install.sh -ims false

Ce -ims falseparamètre signifie « ne pas installer le composant Serveur de messagerie ». Ainsi, la configuration initiale reste axée sur le portail Espace de travail, les éditeurs de documents et les composants d'administration. Les documents ONLYOFFICE permettent d'installer le serveur de messagerie ultérieurement depuis le Panneau de configuration.

Si vous disposez déjà d'un domaine de service de messagerie correctement configuré et que vous souhaitez spécifiquement l'installation complète, ONLYOFFICE documente plutôt ce formulaire :

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

Remplacez ` mx1.example.com<nom_hôte>` par le nom d'hôte réel de votre service de messagerie. Ce nom d'hôte doit pointer vers le serveur et le domaine de messagerie doit disposer des enregistrements DNS appropriés. N'utilisez pas un nom d'hôte fictif pour forcer l'installation. Une configuration DNS incorrecte est l'une des causes les plus fréquentes de la défaillance d'un déploiement Workspace, même réussi, et de l'apparition d'un problème de distribution de courriels.

Étape 6 : Vérifiez que les conteneurs sont bien en cours d’exécution.

Une fois le script terminé, inspectez les conteneurs en cours d'exécution :

sudo docker ps

Ne vous inquiétez pas si les noms de vos conteneurs diffèrent des exemples que vous trouvez en ligne. Les noms et les composants internes peuvent changer d'une version à l'autre. L'important est que les conteneurs ONLYOFFICE attendus soient présents et en cours d'exécution, sans redémarrages ni arrêts intempestifs.

Si un conteneur redémarre sans cesse, examinez son nom réel docker ps -apuis exécutez :

sudo docker logs --tail 100 CONTAINER_NAME

Remplacez CONTAINER_NAMEce nom par celui affiché par Docker. C'est plus sûr que de copier un ancien nom de conteneur trouvé dans un tutoriel.

Étape 7 : Ouvrez le portail en utilisant l’adresse réseau réelle du serveur.

Trouvez les adresses des serveurs avec :

hostname -I

Depuis un navigateur pouvant accéder au serveur, ouvrez :

http://SERVER_IP

Le guide Docker d'ONLYOFFICE recommande d'utiliser l'adresse IP réseau de la machine plutôt que `/ localhostetc/docker` 127.0.0.1lors de la vérification du portail. Le démarrage initial peut prendre quelques minutes après l'installation ; un court délai n'indique donc pas automatiquement un échec du déploiement.

Étape 8 : Terminer la configuration de l’administrateur

La page de première utilisation vous invite à créer le compte administrateur du portail. Choisissez un mot de passe robuste, saisissez une adresse e-mail valide, sélectionnez la langue et le fuseau horaire, puis acceptez les conditions de la licence. ONLYOFFICE précise que la politique de mot de passe par défaut exige entre 8 et 120 caractères ; vous pourrez renforcer les paramètres de sécurité ultérieurement.

Après l'assistant de configuration initiale, vérifiez que vous pouvez ouvrir le module Documents et créer un document de test. Une connexion réussie suffit à prouver que le portail est accessible ; l'ouverture et la modification d'un document permettent également de vérifier que le composant d'édition de documents est correctement connecté.

Sécurisez l'installation avant d'inviter les utilisateurs

Si le serveur est destiné à une utilisation autre qu'un environnement de test temporaire, passez du protocole HTTP simple au protocole HTTPS. Le panneau de contrôle d'ONLYOFFICE peut générer et appliquer un certificat Let's Encrypt ou accepter un certificat et une clé privée existants. Pour le processus Let's Encrypt intégré, le port 80 doit être accessible lors de l'émission du certificat. Consultez le guide de configuration HTTPS officiel d'ONLYOFFICE .

Vérifiez également quels ports réseau vous sont réellement nécessaires. ONLYOFFICE publie un guide des ports pour Workspace Community . N'exposez pas les ports de bases de données ou de services internes sur Internet simplement parce qu'ils figurent dans ce tableau.

Ubuntu intègre UFW, un pare-feu hôte, mais il existe une mise en garde importante concernant Docker : la documentation de Docker indique que les ports de conteneurs publiés peuvent contourner les règles d'UFW. Autrement dit, le simple fait de bloquer un port dans UFW ne suffit pas à garantir qu'il est inaccessible. Il est donc essentiel d'examiner le comportement du pare-feu de Docker et, pour un serveur exposé à Internet, d'utiliser une politique de pare-feu hôte ou amont correctement configurée plutôt que de supposer qu'UFW contrôle à lui seul tous les ports de conteneurs. La documentation relative au pare-feu d'Ubuntu est disponible dans la documentation du pare-feu d'Ubuntu Server .

Problèmes courants et points à vérifier en premier

Le programme d'installation indique qu'un port requis est déjà utilisé.

Vérifiez les écouteurs avant d'arrêter des services aléatoires :

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

Si Apache, Nginx, un autre conteneur ou un panneau de gestion utilise déjà le port, déterminez quel service doit le conserver. N'arrêtez pas brutalement un serveur web en production.

Le portail ne se charge pas après l'installation.

Vérifiez d'abord Docker :

sudo systemctl is-active docker
sudo docker ps -a

Si Docker est inactif, démarrez-le et consultez son journal. Si les conteneurs Workspace sont opérationnels mais que la page est inaccessible, vérifiez que vous utilisez la bonne adresse IP du serveur et que le routage, les groupes de sécurité cloud et les pare-feu en amont autorisent le trafic web requis.

Le serveur manque de mémoire pendant l'installation

Vérifiez à nouveau free -h. Le guide basé sur les scripts Workspace requiert au moins 6 Go de swap et 8 Go de RAM comme minimum. Une machine virtuelle de très petite taille peut devenir instable lors de l'initialisation simultanée de plusieurs images. Il est généralement plus simple de migrer vers une machine virtuelle plus grande que d'essayer d'optimiser chaque service en fonction d'une mémoire insuffisante.

Vous n'aurez besoin que du courrier OFFICIEL plus tard

Il n'est pas nécessaire de réinstaller Workspace. ONLYOFFICE explique comment ajouter le serveur de messagerie depuis la page Mise à jour du panneau de configuration. Avant cela, préparez un nom d'hôte valide pour le service et ses enregistrements DNS. Consultez le guide ONLYOFFICE pour ajouter la messagerie à une installation Workspace existante .

Vous préférez Docker Compose au lieu du script d'installation

C'est une alternative valable si vous souhaitez un contrôle plus précis de la définition du déploiement. Les instructions Compose actuelles d'ONLYOFFICE requièrent Docker Compose 2.16.0 ou une version ultérieure pour Ubuntu 22.04 et versions ultérieures, et indiquent aux administrateurs d'activer la cgroupligne correspondante dans le fichier YAML de l'espace de travail. Ubuntu 24.04 fait partie de cette catégorie « 22.04 et versions ultérieures ». Suivez le guide officiel d'ONLYOFFICE pour Docker Compose plutôt que de copier un ancien fichier Compose provenant d'un tutoriel non pertinent.

Comment savoir si l'installation est réellement terminée ?

Une installation fonctionnelle présente plusieurs signes indépendants de bon fonctionnement : Docker est actif ; les conteneurs Workspace restent en cours d'exécution ; le portail s'ouvre depuis une autre machine en utilisant l'adresse réseau réelle du serveur ; l'administrateur peut se connecter ; et un document de test s'ouvre dans l'éditeur du navigateur. Si vous prévoyez d'exposer le service publiquement, le protocole HTTPS doit également fonctionner avec un certificat reconnu par les navigateurs.

Pour un premier déploiement d'Ubuntu 24.04, il est préférable de s'arrêter après ces vérifications plutôt que d'ajouter immédiatement la messagerie, des proxys inverses personnalisés, un stockage tiers et des intégrations d'authentification. Ajoutez une fonctionnalité à la fois, vérifiez-la et conservez une trace des modifications apportées au DNS, au pare-feu et aux conteneurs. Cela facilitera grandement le dépannage ultérieur.