Technical Anshu
Tutorials Blog
📄 Configuration OnlyOffice + Nextcloud

Installez OnlyOffice Document Server et connectez-le à Nextcloud

Votre Nextcloud stocke les fichiers mais ne peut pas modifier correctement les documents. OnlyOffice Document Server est le moteur d'édition manquant. Voici l'installation complète de Docker ainsi que la configuration du connecteur qui relie les deux, avec la seule erreur de clé secrète qui interrompt la plupart des premières tentatives.

✍️ Technical Anshu🐧 Linux Server + Docker⏱️ One sitting setup
🎥 Regardez le processus complet d'installation et d'intégration dans la vidéo ci-dessus, étape par étape

Nextcloud à lui seul vous offre le stockage et le partage, mais l'ouverture d'un fichier Word ou Excel à l'intérieur nécessite un véritable éditeur. Cet éditeur est OnlyOffice Document Server, un deuxième service que vous hébergez vous-même, avec lequel Nextcloud communique via une petite application de connecteur. Ce guide suit le parcours exact à partir de la vidéo : installez Document Server avec Docker, puis connectez-le à Nextcloud. Un avertissement honnête avant de commencer : Document Server est un service lourd, pas un petit plugin. Donnez-lui un serveur approprié et sa propre adresse, et le reste de cette page se déroulera sans problème.

Nextcloud — Settings — ONLYOFFICE (connector app)
Document Server addresshttps://office.example.com
Secret keymust match JWT_SECRET on the server
Connection check on SaveOK
Editor opens inside NextcloudDocs, Sheets, Slides
Le panneau des paramètres du connecteur dans Nextcloud - valeurs illustratives présentées à titre d'exemple.
1

Comprenez d’abord les deux pièces

Il y a deux serveurs distincts dans cette configuration, et la plus grande confusion vient de leur mélange. Nextcloud stocke vos fichiers, vos utilisateurs et vos partages ; il ne modifie jamais lui-même un document. Le OnlyOffice Document Server (également appelé OnlyOffice Docs) est le moteur d'édition : il affiche l'éditeur de documents dans le navigateur, applique chaque frappe et renvoie le fichier terminé à Nextcloud pour l'enregistrer.

L'application de connecteur dans Nextcloud est le pont entre eux. Il indique à Nextcloud où réside le serveur de documents et prouve, avec une clé secrète partagée, que les deux serveurs sont autorisés à communiquer entre eux. Lorsqu'un utilisateur clique sur un fichier Word ou Excel, l'éditeur se charge à partir du serveur de documents tandis que le fichier reste stocké dans Nextcloud.

2

Donnez au serveur de documents sa propre adresse

Le serveur de documents a besoin de sa propre adresse de sous-domaine ou de serveur, par exemple office.example.com, distincte de votre adresse Nextcloud comme cloud.example.com. Créez d’abord l’enregistrement DNS et laissez-le pointer vers la machine qui exécutera OnlyOffice. Essayer de masquer les deux services sous une seule adresse avec des chemins est l'endroit où la plupart des premières installations restent bloquées, alors restez simple : un nom pour Nextcloud, un nom pour le serveur de documents.

3

Installer le serveur de documents avec Docker

L'itinéraire présenté dans la vidéo est l'installation de Docker sur un serveur Linux, qui est également l'itinéraire officiellement documenté par OnlyOffice. Une seule commande démarre tout :

  1. Assurez-vous que Docker est installé et exécuté sur le serveur
  2. Choisissez un long secret aléatoire — cela devient la clé partagée entre les deux serveurs
  3. Exécutez explicitement le conteneur avec votre ensemble de secrets :

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=your-own-secret-here -v /app/onlyoffice/logs:/var/log/onlyoffice -v /app/onlyoffice/data:/var/www/onlyoffice/Data -v /app/onlyoffice/lib:/var/lib/onlyoffice onlyoffice/documentserver

La définition de JWT_SECRET vous-même n’est pas une décoration facultative. Si vous l'ignorez, le conteneur génère un secret aléatoire — et depuis la version 7.2, ce secret est régénéré à chaque redémarrage, ce qui interrompt silencieusement la connexion Nextcloud après le premier redémarrage. Les trois montages de volume -v conservent les journaux, les certificats et le cache en dehors du conteneur afin qu'une mise à jour ne les efface pas.

4

Vérifiez que le serveur de documents est actif

Donnez au conteneur quelques minutes pour démarrer, puis ouvrez http://office.example.com dans un navigateur. Vous devriez voir la page d'accueil d'OnlyOffice Docs confirmant que les services sont en cours d'exécution. Vous pouvez également vérifier sur le serveur avec sudo docker ps — le conteneur onlyoffice/documentserver doit être répertorié comme étant actif. Ne passez pas à Nextcloud avant le chargement de cette page ; la connexion d'un serveur mort ne crée que des erreurs déroutantes plus tard.

5

Installez l'application Connector dans Nextcloud

Passez maintenant à Nextcloud. Connectez-vous en tant qu'administrateur, ouvrez la section Applications, recherchez ONLYOFFICE, puis installez et activez l'application de connecteur officielle. Cette application est gratuite et est publiée dans la boutique d'applications Nextcloud — il n'y a rien à télécharger manuellement.

6

Entrez l'adresse et la clé secrète

Ouvrez Paramètres → ONLYOFFICE dans Nextcloud et remplissez deux éléments :

  1. Adresse du serveur de documents : l'adresse de l'étape 2, par exemple https://office.example.com
  2. Clé secrète : exactement la même valeur que vous avez transmise comme JWT_SECRET lors du démarrage du conteneur. Un caractère différent et la connexion est refusée
  3. Appuyez sur Enregistrer : le connecteur teste immédiatement la connexion et indique si elle a réussi.

Si la sauvegarde réussit, l'intégration est active. En cas d'échec, le message d'erreur vous indique de quel côté enquêter : un problème d'adresse ou une incompatibilité de secret (l'erreur JWT a son propre guide détaillé lié à nos pages de cas).

7

Ouvrir un document et tester une véritable modification

Terminez par un vrai test, pas seulement une coche verte. Téléchargez un fichier Word ou Excel sur Nextcloud, cliquez dessus et confirmez que l'éditeur OnlyOffice s'ouvre. Tapez quelque chose, fermez le document, attendez quelques secondes que l'enregistrement soit terminé et téléchargez le fichier pour vérifier que votre modification est à l'intérieur. Essayez également d'ouvrir le même document dans un deuxième profil de navigateur : la co-édition devrait afficher les deux curseurs. Si tout cela fonctionne, votre bureau auto-hébergé est prêt à accueillir l'équipe.

🔴 L'ensemble de l'intégration repose sur un seul secret. Le JWT_SECRET dans la commande Docker et la clé secrète dans les paramètres du connecteur Nextcloud doivent être identiques, caractère pour caractère. L'inadéquation est la principale raison pour laquelle une nouvelle installation refuse de se connecter - et si vous laissez le conteneur générer un secret aléatoire au lieu de définir le vôtre, la connexion sera interrompue d'elle-même au prochain redémarrage du serveur.

🎥 Regardez la configuration complète dans la vidéo

L'installation complète d'OnlyOffice Document Server et l'intégration Nextcloud, présentées en direct étape par étape.

▶️ Watch Full Video
❓ Questions courantes (FAQ)

OnlyOffice Document Server peut-il s’auto-héberger gratuitement ?

L'édition communautaire d'OnlyOffice Docs et l'application de connecteur Nextcloud sont gratuites à installer et à utiliser. L'édition gratuite est conçue pour les petites équipes et présente des limites par rapport aux éditions Enterprise payantes : vérifiez la page des limites actuelles de votre version avant de planifier un déploiement à grande échelle.

OnlyOffice et Nextcloud peuvent-ils fonctionner sur le même serveur ?

Oui, de nombreuses petites configurations s'exécutent à la fois sur une seule machine, avec le serveur de documents dans Docker et son propre sous-domaine. N'oubliez pas que Document Server est gourmand en ressources : la machine a besoin de suffisamment de RAM et de CPU pour les deux services, sinon l'édition semblera lente pour tout le monde.

Pourquoi le connecteur demande-t-il une clé secrète ?

Le secret signe les requêtes entre Nextcloud et Document Server (JWT), de sorte qu'un site Web aléatoire ne peut pas demander à votre Document Server d'ouvrir ou de convertir des fichiers. Les deux parties doivent détenir le même secret : cette valeur partagée est ce qui prouve que les deux serveurs se font confiance.

Ce guide est basé sur la vidéo technique Anshu sur l'installation d'OnlyOffice Document Server avec Nextcloud. • Vous êtes bloqué sur une étape ? Demandez dans les commentaires de la vidéo — vous y obtiendrez une réponse 🙏