Comment installer ONLYOFFICE Docs Enterprise avec Docker Compose

ONLYOFFICE Docs Enterprise peut être déployé via Docker Compose à partir du Docker-DocumentServerdépôt officiel. La procédure consiste à commencer par le fichier Compose spécifique à la version Enterprise, puis à configurer le stockage persistant, un jeton JWT stable et le fichier de licence avant de considérer le serveur comme prêt pour la production. Cette installation inclut Docs, le service d'édition en ligne, mais pas le portail ONLYOFFICE Workspace complet.

Les étapes ci-dessous ont été vérifiées par rapport au guide Docker Enterprise d'ONLYOFFICE et au dépôt officiel le 6 octobre 2026. La branche par défaut du dépôt peut changer, donc pour un serveur à longue durée de vie, utilisez une version ou une étiquette approuvée et conservez cette version dans vos notes de déploiement.

Liste de vérification rapide des exigences

Le guide actuel d'ONLYOFFICE pour les entreprises répertorie ces exigences d'hébergement. Les besoins en capacité augmentent avec le nombre d'utilisateurs simultanés, la complexité des documents et les intégrations ; il convient donc de considérer la configuration de base du fournisseur comme un point de départ plutôt que comme une garantie de dimensionnement.

1. Installez Docker Compose et obtenez les fichiers de déploiement officiels

Si Docker Engine est déjà installé sur Debian ou Ubuntu depuis le dépôt de paquets Docker, installez le plugin Compose avec :

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

Pour toute autre distribution Linux, suivez les instructions d'installation Docker correspondantes. Le plugin actuel utilise la commande avec espacedocker compose ; l'ancienne commande autonome docker-composeest conservée pour assurer la compatibilité ascendante et n'est pas celle utilisée par la commande Enterprise d'ONLYOFFICE présentée ici.

Clonez le dépôt ONLYOFFICE et accédez à son répertoire. Si votre politique de gestion des changements exige une version fixe, consultez l'étiquette de version approuvée après le clonage et avant de modifier les fichiers :

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git
cd Docker-DocumentServer
# Optional: select the approved release tag for your deployment
git checkout <release-tag>

Vérifiez que la révision extraite contient bien le fichier docker-compose.enterprise.yml. Ne remplacez pas docker-compose.yml, qui est le fichier Compose de l'édition communautaire dans ce dépôt.

2. Préparer les secrets, le stockage des données et la licence

Avant le premier démarrage, vérifiez la configuration docker-compose.enterprise.yml. Dans le fichier officiel actuel, l'application et le service PostgreSQL utilisent un mot de passe de base de données fictif, et les lignes relatives au JWT sont commentées. Remplacez ce mot de passe par une valeur forte dans les DB_PWDparamètres de l'application et de PostgreSQL POSTGRES_PASSWORD. Ces valeurs doivent correspondre. Décommentez ou ajoutez une ligne JWT_ENABLED=trueet définissez un jeton JWT long et unique JWT_SECRET. Conservez ce même jeton pour l'application ou le connecteur qui s'intégrera à Docs.

Générez des secrets plutôt que de réutiliser un mot de passe de connexion. Par exemple, exécutez la commande openssl rand -hex 32et placez le résultat dans un fichier d'environnement privé, puis référencez-le dans le fichier Compose comme `<secret>` ${JWT_SECRET}et ` ${DB_PASSWORD}<secret>`. Protégez le fichier d'environnement des autres utilisateurs de l'hôte et ne l'ajoutez pas à Git. La configuration clé est conceptuellement la suivante :

# In a private .env file beside the Compose file
JWT_SECRET=replace_with_a_long_random_value
DB_PASSWORD=replace_with_a_different_long_random_value

Mettez à jour les deux entrées de mot de passe de la base de données afin qu'elles fassent référence ${DB_PASSWORD}à `<nom_du_mot_de_passe>` et définissez les entrées d'environnement du serveur sur JWT_ENABLED=true` JWT_SECRET=${JWT_SECRET}<nom_du_serveur>` et `<nom_du_serveur>`. Le fichier Compose en amont définit déjà ses services internes PostgreSQL, RabbitMQ et Redis ; conservez les noms de services et les dépendances associés si vous le personnalisez.

Rendez les données importantes de l'application persistantes sur l'hôte. Dans le onlyoffice-documentserverservice, remplacez les entrées de volume anonymes pour /var/www/onlyoffice/Dataet /var/log/onlyofficepar des montages de liaison tels que :

volumes:
  - ./data:/var/www/onlyoffice/Data
  - ./logs:/var/log/onlyoffice

Conservez les autres entrées de volume et le volume PostgreSQL nommé défini par le fichier officiel, sauf si vous avez une raison valable et testée de les modifier. Créez les répertoires hôtes et copiez la licence que vous avez reçue dans le répertoire de données monté :

mkdir -p data logs
cp /secure/path/license.lic data/license.lic

Assurez-vous que le conteneur puisse lire la licence et écrire dans ses répertoires de données et de journaux. Les exigences relatives à la propriété des fichiers peuvent varier selon l'image et l'hôte ; en cas d'erreurs d'autorisation, vérifiez l'utilisateur du conteneur en cours d'exécution et les instructions du dépôt officiel plutôt que d'appliquer des autorisations trop générales. Conservez la licence et les données confidentielles hors des répertoires racine web publics et du système de gestion de versions.

3. Validez et démarrez les services Enterprise

Depuis le répertoire du référentiel, validez la configuration Compose, puis lancez la pile Enterprise :

docker compose -f docker-compose.enterprise.yml config
docker compose -f docker-compose.enterprise.yml up -d

La première commande vérifie que Compose peut analyser le fichier et résoudre ses variables. Elle peut afficher les secrets résolus ; exécutez-la donc dans un terminal privé et ne copiez pas sa sortie dans les journaux publics ni dans les forums d'assistance. La seconde commande crée ou démarre les services décrits dans le fichier Enterprise. La définition officielle inclut le serveur de documents ainsi que ses dépendances : PostgreSQL, RabbitMQ et Redis.

Vérifier l'état du service et les messages récents :

docker compose -f docker-compose.enterprise.yml ps
docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Recherchez les conteneurs bloqués en cours de redémarrage ou présentant des anomalies, les échecs d'authentification de la base de données, les messages de licence manquants ou les erreurs d'autorisation. Un service marqué comme « Actif » indique que son processus conteneur est en cours d'exécution ; toutefois, cela ne prouve pas à lui seul que l'édition via navigateur ou une intégration externe fonctionne.

4. Placez le service derrière un protocole HTTPS et limitez l'accès.

Pour un déploiement en production, configurez un nom DNS pointant vers docs.example.comle serveur et activez le protocole HTTPS en utilisant la méthode de certificat que vous utilisez : un proxy inverse de confiance ou la configuration de certificat documentée d'ONLYOFFICE. Remplacez le nom d'hôte d'exemple dans les commandes et les paramètres d'intégration par le vôtre. N'exposez pas un point de terminaison HTTP simple de l'éditeur sur Internet pour une utilisation courante.

Le fichier Enterprise Compose officiel expose les ports 80 et 443 pour le serveur de documents. Ses services de base de données, Redis et RabbitMQ sont des dépendances internes et ne doivent pas être exposés sur le réseau public. Vérifiez la configuration du pare-feu et des groupes de sécurité cloud afin que seul le trafic entrant nécessaire atteigne l'hôte. Si un autre proxy inverse utilise déjà les ports 80 et 443, modifiez la configuration de Compose pour utiliser un port réservé à l'hôte ou un port inutilisé, puis configurez le proxy pour qu'il redirige vers ce point de terminaison local. Le proxy doit prendre en charge le trafic WebSocket utilisé pour l'édition de documents.

HTTPS et JWT protègent des éléments différents. HTTPS chiffre le trafic entre les clients et le serveur. JWT valide les requêtes échangées entre Docs et la plateforme connectée. Laissez JWT activé et configurez exactement la même clé secrète dans le connecteur ou la plateforme. Ne désactivez pas JWT simplement pour réussir un test d'intégration ; corrigez plutôt la clé secrète, l'en-tête ou l'URL incorrects.

5. Vérifiez le service, puis testez une intégration.

Le fichier Compose officiel définit un contrôle d'intégrité au http://localhost:8000/info/info.jsonsein du conteneur du serveur de documents. Vérifiez que le service est opérationnel docker compose ... ps. Vous pouvez également utiliser votre navigateur pour accéder au nom d'hôte HTTPS public. L'affichage d'une page d'accueil Docs indique que le service web répond, mais ne teste pas les rappels de documents depuis votre plateforme de stockage.

Pour terminer la vérification, connectez-vous à une plateforme compatible en utilisant l'URL publique de Docs et le même secret JWT. Ouvrez un fichier DOCX de test, effectuez une modification mineure, enregistrez-le, puis rouvrez-le depuis la plateforme. Cela permet de vérifier que la plateforme peut accéder à Docs et que Docs peut renvoyer les modifications enregistrées au service de stockage. Si la page se charge mais qu'aucun éditeur ne s'ouvre, examinez la console du navigateur, la configuration du proxy WebSocket, l'accord JWT et les journaux du serveur. Utilisez un document de test temporaire et n'y intégrez aucune donnée sensible lors de la configuration initiale.

Notes sur le fonctionnement et le dépannage

• Licence non détectée : vérifiez qu’elle license.licse trouve bien dans le répertoire hôte monté /var/www/onlyoffice/Data, puis consultez les journaux du conteneur.
• Erreurs JWT : comparez le secret, l’en-tête et l’URL du serveur et du connecteur. Assurez-vous que le secret reste stable même après un redémarrage.
• Échecs au démarrage de la base de données : vérifiez que le mot de passe de la base de données est identique dans l’environnement PostgreSQL et dans l’environnement du serveur de documents.
• Les données disparaissent après la recréation : vérifiez que le fichier Enterprise Compose utilise toujours votre montage de données et conserve le volume PostgreSQL nommé. Sauvegardez les deux avant les mises à niveau.
• L'éditeur s'ouvre mais ne peut pas enregistrer : vérifiez que l'URL de rappel de la plateforme est accessible depuis le conteneur Docs et que le proxy transmet les connexions WebSocket.

Suivez la procédure de mise à jour spécifique à l'entreprise et consultez les notes de version avant de modifier la version de l'image. Évitez cette opération, docker compose down -vsauf si vous prévoyez de supprimer les volumes gérés par Compose ; cette option peut supprimer le volume de données PostgreSQL nommé. Sauvegardez votre répertoire de données, les journaux (le cas échéant) et la base de données avant toute mise à niveau.

Références officielles

Pour plus de détails spécifiques à votre version, consultez le guide d'installation Docker Enterprise d'ONLYOFFICE , ses instructions d'activation de licence et le fichier Enterprise Compose officiel . Le fichier README du dépôt documente la commande Compose et les paramètres du conteneur. Le guide d'installation du plugin Docker Compose couvre l'installation sous Linux ; si Docker n'est pas installé, suivez les instructions du moteur Docker pour votre distribution.