diff --git a/HowtoCollaboraCode.md b/HowtoCollaboraCode.md new file mode 100644 index 00000000..33455d6e --- /dev/null +++ b/HowtoCollaboraCode.md @@ -0,0 +1,151 @@ +--- +title: How to Collabora Code +--- + +Collabora Online Development Edition (CODE) est une suite bureautique utilisable dans son navigateur. Le logiciel est basé sur Libre Office Online (lool) + +## Installation + +Collabora propose des paquets via leur dépôt pour installer le logiciel : + +~~~ +# echo 'deb https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian10 ./' >> /etc/apt/sources.list.d/collabora-code.list +# apt-key adv --keyserver http://keyserver.ubuntu.com --recv-keys 0C54D189F4BA284D +# apt update + +# apt install loolwsd code-brand collaboraofficebasis6.0-fr collaboraoffice6.0-dict-fr +~~~ + +Pour les versions de Debian antérieures à Debian 10, tout est expliqué sur [leur site](https://www.collaboraoffice.com/code/linux-packages/) + + +## Configuration + +Fichiers de configuration : + +~~~ +/etc/loolwsd/ +├── loolkitconfig.xcu +└── loolwsd.xml +~~~ + +Le fichier de configuration principal se trouve être `/etc/loolwsd/loolwsd.xml`. Juste après installation, le service loolwsd.service ne fonctionnera pas, car la configuration du service écoute en HTTPS par défaut, mais aucun certificat n'est présent. + +Il est plus simple d'utiliser un serveur web comme [Nginx](HowtoNginx) en reverse proxy en amont pour faire la terminaison SSL avant de transférer le trafic à collabora-code localement, sans HTTPS. + +Pour cela, il faut passer changer les paramètres suivants de la section `` : + +* `` : de *true* à **false** +* `` de *false* à **true** + + +~~~.xml + +(...) + + false + true + +(...) +~~~ + + + +Côté Nginx, on utilisera le vhost proposé par les [développeurs de collabora code](https://www.collaboraoffice.com/code/nginx-reverse-proxy/) : + +~~~ +server { + listen 443 ssl; + server_name collabora.example.org; + + ssl_certificate /etc/letsencrypt/live/collabora00.evolix.org/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/collabora00.evolix.org/privkey.pem; + + root /var/www/collabora00.evolix.org; + + access_log /var/log/nginx/access.collabora00.evolix.org.log; + error_log /var/log/nginx/error.collabora00.evolix.org.log; + + + # static files + location ^~ /loleaflet { + proxy_pass http://localhost:9980; + proxy_set_header Host $http_host; + } + + # WOPI discovery URL + location ^~ /hosting/discovery { + proxy_pass http://localhost:9980; + proxy_set_header Host $http_host; + } + + # Capabilities + location ^~ /hosting/capabilities { + proxy_pass http://localhost:9980; + proxy_set_header Host $http_host; + } + + # main websocket + location ~ ^/lool/(.*)/ws$ { + proxy_pass http://localhost:9980; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "Upgrade"; + proxy_set_header Host $http_host; + proxy_read_timeout 36000s; + } + + # download, presentation and image upload + location ~ ^/lool { + proxy_pass http://localhost:9980; + proxy_set_header Host $http_host; + } + + # Admin Console websocket + location ^~ /lool/adminws { + proxy_pass http://localhost:9980; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "Upgrade"; + proxy_set_header Host $http_host; + proxy_read_timeout 36000s; + } +} +~~~ + + +## Utilisation + +#### Avec Nextcloud et le connecteur Collabora + +Dans Nextcloud, il y a une application nommée ["Collabora Online"](https://apps.nextcloud.com/apps/richdocuments) permet de faire connecteur entre l'installation Nextcloud et le service Collabora Code fraîchement installé. Cela permettra de consulter et modifier des fichiers directement depuis l'interface de Nextcloud. + +##### Configuration dans Nextcloud + +##### Configuration dans Collabora Code + +Dans le fichier de configuration `/etc/loolwsd/loolwsd.xml`, il faut autoriser l'adresse de l'instance Nextcloud à travailler avec Collabora. + +Dans la sous-section `` de la section ``, il faut rajouter un élément `` qui contient une regex d'hôtes à autoriser + +~~~.xml + +(...) + + + + nextcloud.example.net + sharedcloud[0-9]{4}.example.org + +(...) +~~~ + +## Monitoring + +### Nagios + +### Munin + +## Plomberie + +## FAQ + +