h1. LibreOfficeOnline

h2. Objectifs

Si Etherpad et Ethercalc peuvent suffire à des besoins ponctuels, ils se montrent parfois insuffisant pour des groupes de travail plus important et manquent de fonctionnalités.

Les services de Google (Drive, ...) sont souvent utilisé à leur place, mais si l'on veux s'en défaire, la solution LibreOffice Online est une alternative viable.

Ce document explique comment installer sur une VM une instance de NextCloud et LibreOffice Online à destination d'un petit groupe - dans mon cas un groupement d'achat local bio appelé "poivron rouge".

h2. Principe

Ce projet https://github.com/smehrbrodt/nextcloud-libreoffice-online a servi de modèle.

Les choix sont les suivants:

* VM sous Debian 9. 1.5Go de RAM, 8Go de disque minimum
* Nexcloud pour la gestion des utilisateurs & la présentation des fichiers
* Base de donnée sqlite
* HTTPS à travers LetsEncrypt (non détaillé ici - utilisation de nginx)
* IPv6 activé
* Utilisation de docker & de docker-compose

h2. Installation de Docker

Les étapes suivantes se feront en tant que root:

* Après avoir créé la VM sous Debian (Buster), mettre à jour:

<pre>
# apt-get update; apt-get dist-upgrade
</pre>

* Installer docker-ce et docker-compose:

<pre>
# apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
# curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
# add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
# apt-get update
# apt-get install docker-ce docker-ce-cli containerd.io docker-compose
</pre>

* Configurer docker pour activer l'IPv6

Dans @/etc/docker/daemon.json@ : (bien sur remplacer les xxxx par votre préfixe IPv6)

<pre><code class="json">
{
"ipv6": true,
"fixed-cidr-v6": "2a03:xxxx:xxxx:xxxx::1/64"
}
</code></pre>

Puis relancer le service docker :

<pre>
# systemctl reload docker
</pre>

* Ajouter l'utilisateur par défaut "debian" dans le groupe docker :

<pre>
# adduser debian docker
</pre>

* Installer git :

<pre>
# apt-get install git
</pre>

h2. Installation de nginx

<pre>
# apt-get install nginx-light
# apt-get install certbot python3-certbot-nginx
</pre>

La mise en place du certificat LetsEncrypt est nécessaire à ce moment, mais ne fait pas partie de la procédure.
@TODO (TODO : Insérer un tuto certbot + nginx@ nginx)

h2. Installation de Nextcloud

Le choix a été fait d'installer nextcloud manuellement:
@TODO: (TODO: Trouver ici un tuto correct pour nextcloud sous debian en HTTPS@ HTTPS)

h2. Instanciation du dock "LibreOffice Online"

Les étapes suivantes se feront en tant qu'utilisateur , ici @debian@. Il faut que cet utilisateur appartienne au groupe @docker@.

<pre>
# git clone https://github.com/smehrbrodt/nextcloud-libreoffice-online.git
</pre>

* Créer le ficher @.env@ suivant dans @/home/debian/nextcloud-libreoffice-online/libreoffice-online@ :

<pre>
NEXTCLOUD_DOMAIN=FQDN NEXTCLOUD_DOMAIN=@FQDN du domaine de la VM VM@
LO_ONLINE_USERNAME=admin
LO_ONLINE_PASSWORD=mot LO_ONLINE_PASSWORD=@mot de passe admin admin@
</pre>

* Vérifier que le ficher @docker-compose.yml@ suivant dans @/home/debian/nextcloud-libreoffice-online/libreoffice-online@ :

<pre><code class="yaml">
version: '2'

services:
online:
image: libreoffice/online:master
environment:
domain: ${NEXTCLOUD_DOMAIN}
username: ${LO_ONLINE_USERNAME}
password: ${LO_ONLINE_PASSWORD}
extra_params: ${LO_ONLINE_EXTRA_PARAMS}
DONT_GEN_SSL_CERT: 1
volumes:
- config-volume:/etc/loolwsd
cap_add:
- MKNOD
ports:
- "9980:9980"
restart:
unless-stopped

volumes:
config-volume:
</code></pre>

* Lancer l'assemblage:

<pre>
~$ docker-compose up -b
</pre>

Le lancement initial est assez long. Il est possible de vérifier le déroulement des opérations avec @docker-compose logs -f@ .

Si tout se passe bien, l'instance nextcloud est disponible sur https://FQDN .
Le 1er login requiert le choix du compte administrateur et de la base de donnée.

* Une fois loggué en tant qu'administrateur (et près une phase d'administration basique : passage en Français, ...) , il faut installer le connecteur collabora et les Group Folders :

<pre>
Menu de droite -> Applications -> Bureautique et Texte -> Collabora Online .
Menu de droite -> Applications -> Fichers -> Group Folders .
</pre>

* Toujours en tant qu'administrateur, il faut associer le connecteur collabora avec l'instance LibreOffice Online :

<pre>
Menu de droite -> Paramètres -> Collabora en Ligne
</pre>

Puis dans le champ @URL (et port) su serveur Collabora Online@ , inscrire @http://FQDN:9980 , et appliquer.

Désormais il est possible de créer (ou importer) dans Nextcloud un fichier .odt, et l'ouvrir en ligne.

La gestion des groupes & des utilisateurs se fait sur l'instance Nextcloud, l'utilisation du plugin Group Folder permet à des utilisateurs de modifier le même document y compris simultanément.

L'URL http://FQDN:9980/loleaflet/dist/admin/admin.html permet d'obtenir quelques statistiques sur l'instance LibreOffice Online, néanmoins il est souhaitable de bloquer l'accès à ce port depuis internet à l'aide d'une règle de firewall.