# Self-Hosted Applications et services auto-hébergés # Diacamma Diacamma Syndic est un logiciel libre qui permet de gérer simplement une copropriété # Diacamma - Clôture de l'exercice en cours et report à nouveau

Guide rapide pour clôturer l'exercice en cours, créer un nouvel exercice comptable et effectuer le report à nouveau.

Dans `Comptabilité > Écritures comptables`, contrôler et clôturer toutes les écritures comptables de l'exercice en cours. Dans `Administration > Configuration comptable`, créer un nouveau plan comptable en important le précédent afin de conserver tous les codes et comptes du plan comptable précédent. Dans `Comptabilité > Plan comptable` : 1. clôturer l'exercice en cours et choisir comment ventiler le résultat de l'exercice 2. choisir le nouvel exercice créé précédemment et faire le `Report à nouveau` 3. cliquer sur `Commencer` pour démarrer le nouvel exercice Dans `Administration > Configuration comptable`, activer le nouvel exercice. Dans `Gestion > Catégories de charges`, reporter et corriger si nécessaire les budgets sur le nouvel exercice.

Le nouvel exercice comptable est prêt à être utilisé et les appels de fonds peuvent être créés

# Diacamma - mise à jour des modules et sauvegarde des instances Diacamma est fourni avec un script, disponible dans /var/lucterios2 (launch\_lucterios.sh), permettant d'effectuer les opérations courantes de maintenance telles que ajouter et modifier des instances, mettre à jour les modules, archiver et restaurer une instance. ### Mise à jour des modules Vérifier la présence de nouvelles versions des modules ``` cd /var/lucterios2 ./launch_lucterios.sh check ``` Exemple de sortie de la commande check ``` check list: lucterios 2.3.0.18073018 => 2.3.0.18073018  lucterios-standard 2.3.0.18070322 => 2.3.0.18070322  lucterios-documents 2.3.0.18070422 => 2.3.0.18070422  lucterios-contacts 2.3.0.18070609 => 2.3.0.18070609  diacamma-syndic 2.3.0.18073020 => 2.3.0.18073020  diacamma-financial 2.3.0.18072813 => 2.3.0.18072813  diacamma-asso 2.3.0.18070322 => 2.3.0.18070322 => No upgrade ``` Lister en détails les modules installés ``` ./launch_lucterios.sh installed ``` Mettre à jour tous les modules installés ``` ./launch_lucterios.sh update ``` Suite à la mise à jour des modules il faut redémarrer gunicorn pour prendre en compte les nouvelles versions ``` sudo killall gunicorn cd ~ ./Diacamma/lancer.sh ``` Script lancer.sh à créer dans /home/username/Diacamma ``` #!/bin/bash cd /var/lucterios2/ source virtual_for_lucterios/bin/activate DJANGO_SETTINGS_MODULE='copro.settings' gunicorn lucterios.framework.wsgi --bind=127.0.0.1:8000 --daemon --timeout 120 deactivate ``` Rendre le script exécutable ``` chmod +x Diacamma/lancer.sh ``` #### Sauvegarde des instances Lister les instances actives ``` ./launch_lucterios.sh listing ``` Archiver (sauvegarder) une instance (copro) ``` ./launch_lucterios.sh archive -n copro -f save_copro.tar.gz ``` Restaurer la sauvegarde d'une instance (copro) ``` ./launch_lucterios.sh restore -n copro -f save_copro.tar.gz ``` ###### `./launch_lucterios.sh --help` ``` Usage: lucterios_admin.py lucterios_admin.py [option] Options: --version show program's version number and exit -h, --help show this help message and exit -n NAME, --name=NAME Instance name -p APPLI, --appli=APPLI Instance application -d DATABASE, --database=DATABASE Database configuration 'sqlite', 'MySQL:...' or 'PostGreSQL:...' -m MODULE, --module=MODULE Modules to add (comma separator) -e EXTRA, --extra=EXTRA extra parameters (=value,...).For 'security': 'MODE=,PASSWORD='( equals to 0,1 or 2) -f FILENAME, --file=FILENAME file name for restor or archive -i INSTANCE_PATH, --instance_path=INSTANCE_PATH Directory of instance storage ``` # Installation de Diacamma sur serveur Linux Ubuntu/Debian ### Installation de Diacamma --- #### Prérequis Avoir un serveur PostgreSQL installé et configuré avec une base de données créée et vide (DB diacamma). Installer PostgreSQL et les bibliothèques spécifiques suivantes : ``` sudo apt-get install postgresql python-psycopg2 libpq-dev libssl-dev ``` ##### Créer la base de données Connexion à l'utilisateur postgres et à l'invite de commande PostgreSQL. ``` sudo -i -u postgres sudo psql ``` Sur l'invite de commande de PostgreSQL ("postgres=#" est l'invite de commande, il ne faut pas le retaper), création d'un utilisateur "diacamma" et attribution de droits de création de DB. ``` postgres=# CREATE USER diacamma; postgres=# ALTER ROLE diacamma WITH CREATEDB; ``` Création de la base de données "diacamma" associée à l'utilisateur "diacamma". ``` postgres=# CREATE DATABASE diacamma OWNER diacamma; ``` Attribution d'un mot de passe à l'utilisateur pour qu'il puisse se connecter à la DB. Bien mettre le mot de passe entre ' '. ``` postgres=# ALTER USER diacamma WITH ENCRYPTED PASSWORD 'mot_de_passe'; ``` Quitter l'invite de commande PostgreSQL et vérifier la création de la DB, l'encodage doit être en UTF8. ``` postgres=# \q psql -l ``` Se déconnecter de l'utilisateur postgres. ``` exit ``` ##### Installation via les scripts pour linux Télécharger les scripts d'installation / désinstallation depuis l'adresse [https://download.sd-libre.fr/Diacamma\_setup.tar.gz](https://download.sd-libre.fr/Diacamma_setup.tar.gz) et décompresser l'archive. ``` wget http://www.sd-libre.fr/download/Diacamma_setup.tar.gz tar -xf Diacamma_setup.tar.gz ``` Rendre les scripts exécutables. ``` cd Diacamma chmod +x install.sh uninstall.sh ``` Lancer l'installation de Diacamma en exécutant le script install.sh ``` sudo ./install.sh ``` Installer le driver PostgreSQL pour Django. ``` cd /var/lucterios2/ source virtual_for_lucterios/bin/activate pip install psycopg2 deactivate ``` ##### Créer et modifier une instance Pour créer une instance "copro", activer les modules nécessaires et configurer la base de données PostgreSQL, utiliser la commande suivante. Ne pas oublier de renseigner le mot de passe PostgreSQL. ``` ./launch_lucterios.sh add -n copro -m "lucterios.contacts,lucterios.documents,lucterios.mailing,diacamma.condominium,diacamma.accounting,diacamma.payoff" -p diacamma.syndic -d "PostGreSQL:name=diacamma,user=diacamma,password=mot_de_passe,host=localhost" ``` Pour corriger une instance existante, remplacer le paramètre "add" par "modif". #### Configurer Diacamma en mode serveur Installer l'outil Gunicorn ``` cd /var/lucterios2/ source virtual_for_lucterios/bin/activate pip install gunicorn deactivate ``` Ajouter les options ci-dessous dans le fichier de configuration copro/settings.py pour ne pas avoir une erreur d'hôte non autorisé et l'interface en français. ``` ALLOWED_HOSTS = ['192.168.1.50', 'localhost', '127.0.0.1'] LANGUAGE_CODE = 'fr' ``` Lancer l'instance "copro" en tâche de fond avec les commandes suivantes. ``` cd /var/lucterios2/ source virtual_for_lucterios/bin/activate DJANGO_SETTINGS_MODULE='copro.settings' gunicorn lucterios.framework.wsgi --bind=127.0.0.1:8000 --daemon --timeout 120 deactivate ``` L'instance devrait être accessible à l'adresse locale du serveur sur le port 8000. [http://192.168.1.50:8000](http://192.168.1.50:8000) # Nextcloud Nextcloud est un logiciel libre de site d'hébergement de fichiers et une plateforme de collaboration. # Installation et mise à jour de Collabora pour Nextcloud ### Installation de Collabora (version CODE) pour Nextcloud --- ##### Prérequis Liste des prérequis pour installer Collabora Online Developement Edition et l'utiliser avec un serveur Nextcloud : - Un serveur capable de faire tourner un conteneur Docker - Un sous-domaine pour le serveur Collabora Online - Un serveur Apache - Un certificat SSL pour le sous-domaine Collabora Online - Un certificat SSL pour le sous-domaine Nextcloud ##### Installer le serveur Collabora Online Étapes pour télécharger et lancer le docker Collabora Online. ``` docker pull collabora/code docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=nextcloud\\.choukajohn\\.me' --dns=192.168.1.50 --restart always --cap-add MKNOD collabora/code ``` Avec domain=domaine serveur Nextcloud et --dns=adresse serveur dns (si serveur dns local ou modifié sur l'hôte Nextcloud). ##### Installer le reverse proxy Apache Étapes pour installer Apache et activer les modules nécessaires. ``` sudo apt-get install apache2 a2enmod proxy a2enmod proxy_wstunnel a2enmod proxy_http a2enmod ssl ``` Ensuite, configurer un Virtualhost pour rediriger le trafic. ``` sudo nano /etc/apache2/sites-available/office.conf ``` ``` ServerName office.nextcloud.com:443 # SSL configuration, you may want to take the easy route instead and use Lets Encrypt! SSLEngine on SSLCertificateFile /path/to/signed_certificate SSLCertificateChainFile /path/to/intermediate_certificate SSLCertificateKeyFile /path/to/private/key SSLProtocol all -SSLv2 -SSLv3 SSLCipherSuite ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS SSLHonorCipherOrder on # Encoded slashes need to be allowed AllowEncodedSlashes NoDecode # Container uses a unique non-signed certificate SSLProxyEngine On SSLProxyVerify None SSLProxyCheckPeerCN Off SSLProxyCheckPeerName Off # keep the host ProxyPreserveHost On # static html, js, images, etc. served from loolwsd # loleaflet is the client part of LibreOffice Online ProxyPass /loleaflet https://127.0.0.1:9980/loleaflet retry=0 ProxyPassReverse /loleaflet https://127.0.0.1:9980/loleaflet # WOPI discovery URL ProxyPass /hosting/discovery https://127.0.0.1:9980/hosting/discovery retry=0 ProxyPassReverse /hosting/discovery https://127.0.0.1:9980/hosting/discovery # Main websocket ProxyPassMatch "/lool/(.*)/ws$" wss://127.0.0.1:9980/lool/$1/ws nocanon # Admin Console websocket ProxyPass /lool/adminws wss://127.0.0.1:9980/lool/adminws # Download as, Fullscreen presentation and Image upload operations ProxyPass /lool https://127.0.0.1:9980/lool ProxyPassReverse /lool https://127.0.0.1:9980/lool ``` Après avoir configuré le Virtualhost : ``` a2ensite office.conf sudo service apache2 stop sudo service apache2 start ``` ##### Configurer l'application dans Nextcloud - Dans la section "Application", "Bureautique & texte", installer Collabora Online. - Dans les paramètres, section "Collabora en ligne", configurer le sous-domaine du Virtualhost : https://office.choukajohn.me #### Mise à jour de Collabora Online --- Télécharger la dernière image Docker : ``` docker pull collabora/code ``` Lister les images en cours d'exécution : ``` docker ps ``` Stopper et supprimer l'image en cours d'exécution : ``` docker stop NAME docker rm NAME ``` Lister espace disque utilisé et nettoyer Docker : ``` docker system df docker system prune ``` Démarrer la nouvelle image ``` docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=nextcloud\\.choukajohn\\.me' --dns=192.168.1.50 --restart always --cap-add MKNOD collabora/code ``` # Mise à jour manuelle serveur Nextcloud ### Procédure de mise à jour manuelle --- Procédure issue de la documentation officielle de [Nextcloud](https://docs.nextcloud.com/). Télécharger la dernière version de **Nextcloud** sur [https://nextcloud.com/install](https://nextcloud.com/install/#instructions-server) ``` cd /var/www sudo su wget https://download.nextcloud.com/server/releases/nextcloud-xx.x.x.zip ``` Arrêter le serveur web ``` service apache2 stop ``` Supprimer l'ancien dossier de sauvegarde et renommer le dossier actuel ``` rm -r nextcloud-old mv nextcloud nextcloud-old ``` Extraire la dernière version de Nextcloud dans **/var/www/nextcloud** ``` unzip nextcloud-xx.x.x.zip ``` Copier le fichier **config.php** depuis le répertoire **-old** vers le nouveau ``` cp nextcloud-old/config/config.php nextcloud/config/ ``` Copier les applications tierces depuis le répertoire **-old** vers le nouveau ``` cp -r nextcloud-old/apps/bruteforcesettings nextcloud/apps cp -r nextcloud-old/apps/richdocuments nextcloud/apps ``` Ajuster le propriétaire et les permissions des fichiers ``` chown -R www-data:www-data nextcloud find nextcloud/ -type d -exec chmod 750 {} \; find nextcloud/ -type f -exec chmod 640 {} \; ``` Redémarrer le serveur web ``` service apache2 start ``` Lancer la mise à jour depuis la console avec **occ** ``` cd nextcloud sudo -u www-data php occ upgrade ``` Attendre la fin de la mise à jour et se loguer pour vérifier la version. # Installer, configurer et mettre à jour FlexGet FlexGet est un outil d'automatisation polyvalent pour tous les médias. Il permet par exemple de télécharger des séries ou des films automatiquement à partir de fichiers torrent ou de flux RSS de torrent. --- ### Installation de FlexGet sous Linux #### Prérequis ##### Python Versions de Python supportées : - 3.10 | 3.11 | 3.12 | 3.13 | 3.14 Pour connaitre la version de Python installée et installer une version spécifique : ``` python -V sudo apt-get install python3.x ``` ##### PIP Le prérequis suivant est l'outil Python package manager dénommé PIP. Installation : ``` sudo apt-get install python-pip ``` #### Installer FlexGet Commencer par mettre à jour l'outil setuptools puis installer FlexGet avec les commandes suivantes : ``` sudo pip install --upgrade setuptools sudo pip install flexget ``` #### Lancer FlexGet en mode daemon FlexGet est conçu pour être exécuté depuis le user crontab. Avec FlexGet en mode daemon, utiliser le plugin scheduler pour définir l'exécution des tâches directement dans le fichier de configuration. Pour lancer le daemon au démarrage du système, éditer le fichier cron avec la commande : ``` crontab -e ``` Ajouter les lignes suivantes au crontab. La seconde ligne est utile pour relancer le Daemon toutes les heures en cas de plantage. ``` @reboot /usr/local/bin/flexget daemon start -d 0 */1 * * * /usr/local/bin/flexget daemon start -d >/dev/null 2>&1 ``` #### Gestion du daemon FlexGet Pour lancer le daemon FlexGet utiliser la commande *start*. Utiliser le paramètre *-d* pour lancer le daemon en arrière plan. Utiliser le paramètre *--autoreload-config* pour forcer le rechargement du fichier de configuration avant l'exécution de chaque tâche. ``` flexget daemon start [-d, --autoreload-config] ``` Pour stopper le daemon en cours d'exécution : ``` flexget daemon stop ``` Pour vérifier l'état du daemon : ``` flexget daemon status ``` Pour recharger le fichier de configuration : ``` flexget daemon reload-config ``` Pour exécuter immédiatement les tâches du fichier de configuration : ``` flexget execute ``` ### Configuration de FlexGet #### Introduction Afin d'utiliser FlexGet il faudra créer un fichier de configuration. FlexGet utilise le format [YAML](https://fr.wikipedia.org/wiki/YAML) dans le fichier de configuration. YAML est une façon de définir une suite de clés (des noms de plugin ou des options) et de valeurs (noms de séries ou répertoire de téléchargement). #### Localisation Par défaut FlexGet essaye de trouver le fichier de configuration *config.yml* depuis plusieurs emplacement, dans l'ordre suivant : 1. Le répertoire courant 2. ~/.flexget/ 3. ~/.config/flexget/ Possibilité de créer un lien symbolique dans ~/.flexget/ vers un fichier de configuration sur un emplacement réseau partagé afin de le modifier facilement. #### Config.yml Exemple de fichier de configuration créé à partir de la documentation sur [https://flexget.com/Configuration](https://flexget.com/Configuration) ```yaml schedules: - tasks: '*' interval: minutes: 10 tasks: Téléchargement auto torrents: rss: https://rss.URL.com/cats=118.119.107.1.2.100.4.5.7.3.8.6.94.95.12.33.31.9.104.13.15.14.110.32.101.109.34.30.98.17.16.20.24.96.99.116.102.103.25.111.27.112.26.28.29.117.21.22.23&type=dl&torrent_pass=xxx accept_all: yes filesystem: path: - /home/partage/Telechargement/torrents/ mask: '*.torrent' plugin_priority: if: 2 series: 1 if: - "'1080p' in title": set: path: /home/partage/Telechargement/Films/ - "'720p' in title": set: path: /home/partage/Telechargement/Films/ - "'x264' in title": set: path: /home/partage/Telechargement/Films/ - "'x265' in title": set: path: /home/partage/Telechargement/Films/ - "'eBook' in title": set: path: /home/partage/Telechargement/Magazines Journaux/ - "'.pdf' in title": set: path: /home/partage/Telechargement/Magazines Journaux/ - "'Epub' in title": set: path: /home/partage/Telechargement/Magazines Journaux/ - "'mp3' in title": set: path: /media/disqueUSB/Telechargement/Musique/ - "'MP3' in title": set: path: /media/disqueUSB/Telechargement/Musique/ - "'Mp3' in title": set: path: /media/disqueUSB/Telechargement/Musique/ series: - Game of Thrones: set: path: /home/partage/Telechargement/Series TV/Game of Thrones/Saison 7 - Black Mirror: set: path: /home/partage/Telechargement/Series TV/Black Mirror/Saison 4 - Supernatural: set: path: /home/partage/Telechargement/Series TV/Supernatural/Saison 13 - The Originals: set: path: /home/partage/Telechargement/Series TV/The originals/Saison 5 - Doctor Who: set: path: /home/partage/Telechargement/Series TV/Doctor who/Saison 11 - The Handmaids Tale: set: path: /home/partage/Telechargement/Series TV/The Handmaids Tale/Saison 1 - Vikings: set: path: /home/partage/Telechargement/Series TV/Vikings/Saison 5 transmission: host: localhost port: 9091 username: xxx password: xxx addpaused: no notify: entries: title: "{{title}}" #Nouveau torrent en téléchargement message: "Téléchargement dans {{path}}" what: accepted via: - pushbullet: api_key: xxx # task: # always_send: no # via: # - pushbullet: # api_key: xxx abort: via: - pushbullet: api_key: xxx ``` ##### Top-Level Keys et Plugins - schedules : top-level key permettant de définir l’intervalle d'exécution des tâches, utilisable en mode daemon uniquement. - tasks : top-level key permettant de créer différentes tâches. - rss : plugin permettant de lire un flux rss en entrée. - filesystem : plugin permettant de lire les fichiers .torrent présents dans un répertoire. - plugin\_priority : option permettant de définir l'ordre d'exécution des plugins. - if : plugin permettant de définir des paramètres en fonction d'un mot clé présent dans le titre du torrent. - series : plugin permettant de définir des paramètres en fonction du titre de la série. - transmission : plugin permettant de communiquer avec le daemon de transmission. - notify : plugin permettant d'envoyer des notifications via Pushbullet. #### Vérifier et tester config.yml Après avoir modifié ou créé le fichier *config.yml* il faut le recharger, vérifier la syntaxe et tester l'exécution avec les commandes suivantes : ``` flexget daemon reload-config flexget check flexget --test execute ``` ### Mise à jour de FlexGet #### Vérifier la version actuelle Commencer par vérifier la version actuellement installée, la commande donne également le numéro de la dernière version disponible. ``` flexget -V ``` #### Mettre à jour avec PIP Dans l'ordre, stopper le daemon FlexGet, mettre à jour le setuptools et enfin mettre à jour flexget. Redémarrer le daemon FlexGet. ``` flexget daemon stop sudo pip install --upgrade setuptools sudo pip install --upgrade flexget flexget daemon start -d ``` #### Vérifier le fichier de configuration Suite à une mise à jour, vérifier la validité du fichier de configuration, il faudra éventuellement lui apporter des corrections. ``` flexget check ``` Si le fichier de configuration échoue au test, vérifier sur [https://flexget.com/UpgradeActions](https://flexget.com/UpgradeActions) si des corrections sont nécessaires.