Déployez ONLYOFFICE Docs Enterprise avec son fichier de composition officiel

Pour un déploiement sur un seul serveur, utilisez la version officielle d'ONLYOFFICE docker-compose.enterprise.ymldisponible dans le dépôt Docker-DocumentServer et lancez-la avec Docker Compose v2. Avant de mettre la pile en ligne, remplacez les identifiants d'exemple, définissez un secret JWT stable pour votre intégration et montez le répertoire qui contiendra votre licence Enterprise et vos données persistantes. Le lancement du conteneur n'est qu'une première étape : vérifiez l'état de santé de Compose et ouvrez la page d'accueil de la documentation avant de connecter une plateforme de production.

Que commence le fichier Enterprise Compose ?

Le fichier officiel définit le service Document Server Enterprise ainsi que ses dépendances PostgreSQL, RabbitMQ et Redis. Il publie les ports HTTP et HTTPS de l'éditeur et inclut un contrôle d'intégrité pour le point de terminaison interne d'informations Docs. Ces dépendances rendent ce fichier Compose pratique pour une petite installation sur un seul serveur ; il ne configure pas à lui seul votre connecteur de plateforme, votre DNS public ni votre certificat TLS de production.

Vérifié le 9 octobre 2026, le fichier officiel utilise PostgreSQL 15, RabbitMQ 3 et Redis 7. Les fichiers de référentiel peuvent changer, il est donc conseillé de consulter le fichier Enterprise Compose actuel avant tout déploiement ou mise à niveau.

1. Vérifiez l'hôte et installez Docker Compose

La configuration requise pour ONLYOFFICE Enterprise Docker indique un serveur Linux amd64 avec noyau 3.10 ou version ultérieure, Docker pris en charge par ses mainteneurs, au moins 4 Go de RAM, 40 Go d'espace disque disponible et au moins 4 Go de swap. Cette configuration de référence varie également en fonction du nombre de documents ouverts simultanément et de leur type ; il convient donc de l'utiliser comme point de départ, et non comme une garantie de capacité. Un portail de production avec des charges de travail plus importantes peut nécessiter davantage de ressources.

Installez Docker Engine et le plugin Compose en suivant les instructions officielles de Docker pour votre distribution Linux. Vérifiez que les deux commandes fonctionnent avant de cloner le dépôt :

docker --version
docker compose version

Si l'hôte dispose déjà d'un serveur web, vérifiez que les ports 80 et 443 sont disponibles ou prévoyez un proxy inverse et une configuration de ports différente côté hôte. Le fichier Compose démarre également les services de base de données, de file d'attente et de cache ; ces services doivent rester sur le réseau privé Compose et ne pas être exposés sur des ports publics.

2. Obtenez le fichier Compose officiel

Clonez le dépôt ONLYOFFICE et déplacez-vous dans son répertoire :

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

Vérifiez sa docker-compose.enterprise.ymlprésence. Le fichier README du dépôt indique la commande suivante pour l'édition Enterprise :

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

3. Définir les informations d'identification, le jeton JWT et un emplacement de licence permanent

Ne déployez pas la configuration Compose d'exemple sans la modifier sur un hôte accessible depuis Internet. Le fichier publié contient des identifiants de base de données d'exemple et commente les valeurs JWT explicites. Remplacez le mot de passe PostgreSQL dans le service de base de données et dans les DB_PWDparamètres du serveur de documents par une valeur robuste identique. Gardez les ports de la base de données, de RabbitMQ et de Redis privés.

Pour l'intégration, définissez un secret JWT stable dans le service Serveur de documents et configurez le même secret dans le connecteur ONLYOFFICE de votre plateforme. Une méthode simple consiste à stocker la valeur dans un .envfichier local non inclus dans Git, puis à utiliser la substitution de variables Compose. Ajoutez ces entrées à la section Environnement du Serveur de documents, en adaptant le format d'environnement existant si nécessaire :

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

Saisissez une valeur longue et unique . Ne copiez pas l'espace réservé littéral dans une configuration en production. ONLYOFFICE indique que JWT est activé par défaut dans la version 7.2 et les versions ultérieures .env, JWT_SECRET=...avec un secret généré automatiquement ; spécifier votre propre valeur stable évite toute incohérence lors de la recréation du conteneur. Consultez le guide de configuration JWT .

Pour enregistrer Enterprise avec une licence achetée license.lic, montez un répertoire hôte dans le service Serveur de documents . /var/www/onlyoffice/DataPar exemple, remplacez le montage de données anonymes par `/etc ./documentserver-data:/var/www/onlyoffice/Data/docker/ document/lib/doc ...license.lic

4. Démarrez la pile Enterprise

Depuis le répertoire du dépôt, validez la configuration Compose en mode silencieux afin que les secrets développés ne soient pas affichés, puis démarrez les services. La validation silencieuse vérifie le modèle Compose ; elle ne garantit pas le démarrage des conteneurs. Docker documente cette option dans sa documentation de référence sur la configuration Compose .

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

Le premier démarrage peut prendre plus de temps, le temps que les images soient créées ou téléchargées et que les dépendances s'initialisent. Si la validation de la configuration signale une variable non définie, vérifiez votre .envfichier et les noms des variables dans le fichier Compose. N'ajoutez pas de guillemets autour des secrets, sauf s'ils font partie de la valeur attendue.

5. Vérifiez la disponibilité avant de connecter votre plateforme.

Vérifier les services et l'état de santé :

docker compose -f docker-compose.enterprise.yml ps

Attendez que le contrôle d'intégrité du serveur de documents soit réussi. Le contrôle officiel des fichiers Compose s'effectue http://localhost:8000/info/info.jsondepuis le conteneur, avec un délai de démarrage de 60 secondes. Si le service reste défaillant, consultez ses journaux et l'état des dépendances :

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

Ouvrez ensuite http://localhostl'URL sur l'hôte ou dans un navigateur permettant d'accéder au serveur. Les instructions Compose d'ONLYOFFICE utilisent la page d'accueil comme vérification initiale de l'installation. Pour une utilisation en production à distance, exposez le service via HTTPS sur votre domaine plutôt que de laisser le trafic de l'éditeur en HTTP simple. Consultez le guide des ports Docker Enterprise et le guide d'installation de Docker pour configurer l'accès réseau et TLS.

Enfin, configurez l'URL du serveur de documents de votre plateforme et le secret JWT correspondant, puis ouvrez, modifiez et enregistrez un document de test via cette intégration. La page d'accueil seule ne garantit pas la configuration correcte du connecteur, du proxy inverse, du JWT ou de l'URL de rappel. Si les services sont opérationnels mais que l'éditeur ne s'ouvre pas depuis la plateforme, vérifiez que celle-ci peut accéder à l'URL du serveur de documents et que les deux parties utilisent le même secret JWT et le même en-tête. Pour un déploiement multi-hôtes ou à haute disponibilité, considérez cette configuration Compose comme un point de départ et consultez les recommandations de déploiement d'ONLYOFFICE plutôt que de supposer qu'un seul hôte Compose assure le clustering.