====== Kresus ======

Attention, copier-coller : [[Kresus|https://kresus.org/fr/]] est un gestionnaire de finances personnelles gratuit et libre qui tourne sur votre serveur. Il récupère automatiquement et quotidiennement toutes vos nouvelles transactions bancaires et vous permet de les catégoriser, étudier via des graphiques, et établir un budget. 
Pour se connecter à votre compte et récupérer les opérations bancaires, il utilise le logiciel Woob.

Le gros avantage de Kresus comparé au site de votre banque, c'est qu'il permet de conserver tout l'historique de votre compte (là où les sites de banques ne gardent que 2 ou 3 mois), permet de créer des catégories de dépenses (courses, essences, travaux, EDF, crédit, etc), de les attribuer automatiquement et de centraliser tous vos comptes en un seul site si vous avez des comptes dans plusieurs banques.

Le gros inconvénient c'est que Kresus a besoin de l'identifiant et du mot passe d'accès au site de la banque pour pouvoir fonctionner. Et les deux sont stockés dans la base de données avec le cookie de double authentification de session. Si par malheur une personne malveillante arrive à accéder à la base PostgreSQL de Kresus, il a tout ce qu'il lui faut pour accéder à votre compte en banque.
Vous êtes prévenus.

===== Installation des dépendances =====

Vous allez avoir besoin de plusieurs logiciels pour l'installation :
<code bash>sudo aptitude install git npm postgresql python3 python3-pdfminer</code>


===== Installation de Kresus =====

On va créer un utilisateur qui exécutera Kresus :
<code bash>sudo useradd -m kresus</code>

Connectez vous avec cet utilisateur :
<code bash>sudo -i -u kresus</code>

Lancez l'installation :
<code bash>
npm install --prefix /home/kresus/ kresus
</code>

===== Installation de Woob =====

Woob est plus simple à installer. Toujours avec l'utilisateur kresus, lancez la commande suivante :
<code bash>pip install --user woob</code>

===== Création de la base de données =====

Kresus a besoin d'une base de données Postgresql pour fonctionner.


Connectez-vous avec l'utilisateur postgres :
<code bash>sudo -i -u postgres</code>

Lancez PostgreSQL :
<code bash>psql</code>

Créez l'utilisateur :
<code sql>CREATE ROLE kresus LOGIN PASSWORD 'mot_de_passe';</code>

Créez la base de données :
<code sql>CREATE DATABASE kresus OWNER kresus;</code>

Quittez PostgreSQL :
<code bash>exit</code>

Déconnectez-vous de l'utilisateur postgres :
<code bash>exit</code>

===== Configuration de Kresus =====

Dans le dossier d'installation, vous trouverez un fichier config.ini.
Vous devez modifier, si besoin : 
  * la ligne "datadir" pour indiquer l'emplacement du dossier data (/home/kresus/database)
  * la partie [email] si vous souhaitez activer les alarmes par mail
  * la partie [db] pour indiquer les informations de connexion à la base (adresse, nom utilisateur, mot de passe, etc)

===== Configuration d’Apache2 =====

Créez le fichier 
<code>/etc/apache2/sites-available/kresus.domaine.fr.conf</code>
Remplacez domaine.fr par votre nom de domaine

Collez les lignes suivantes dedans (en remplaçant de nouveau domaine.fr par votre nom de domaine)
<code apache>
<VirtualHost *:80>

        ServerName kresus.domaine.fr
        
        Redirect / https://kresus.domaine.fr/

</VirtualHost>


<VirtualHost *:443>

        ServerName kresus.domaine.fr
        
        LogLevel warn
        CustomLog ${APACHE_LOG_DIR}/kresus.access.log combined
        ErrorLog ${APACHE_LOG_DIR}/kresus.error.log

        SSLEngine on

        SSLCertificateFile /etc/letsencrypt/live/domaine.fr/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/domaine.fr/privkey.pem

        ProxyPass / http://localhost:9876/
        <Location />
                ProxyPassReverse http://localhost:9876/
                AuthType Digest
                AuthName "Kresus"
                AuthDigestDomain /home/kresus/kresus/ https://kresus.domaine.fr
                AuthDigestProvider file
                AuthUserFile /etc/apache2/passwords
                Require valid-user
                SetEnv R_ENV "/home/kresus/kresus"              
        </Location>

</VirtualHost>
</code>

Créez le mot de passe d'accès à Kresus (remplacez nomutilisateur) :
<code bash>sudo htdigest /etc/apache2/passwords Kresus nomutilisateur</code>

Activez le fichier de conf Apache
<code bash>a2ensite kresus.nomdedomaine.fr.conf</code>

Redémarrez Apache
<code bash>systemctl restart apache2</code>

===== Lancement de Kresus via Systemd =====

Créez le fichier 
<code>/etc/systemd/system/kresus.service</code>

Copiez les lignes suivantes dedans
<code>
[Unit]
Description=Personal finance manager
After=network.target postgresql.service

[Service]
WorkingDirectory=/home/kresus/
Environment=NODE_ENV=production
ExecStartPre=/bin/sleep 60
ExecStart=/home/kresus/node_modules/kresus/bin/kresus.js --config /home/kresus/config.ini

Type=simple
Restart=always

User=kresus

StandardOutput=journal
StandardError=inherit
SyslogIdentifier=kresus

[Install]
WantedBy=multi-user.target

</code>

Activez le service au démarrage
<code bash>sudo systemctl enable kresus.service</code>

Démarrez le service
<code bash>sudo systemctl start kresus.service</code>

Vous pouvez maintenant accéder à Kresus à l'adresse kresus.domaine.fr

===== Mise à jour =====

Lorsqu'une nouvelle version sort, pour mettre à jour Kresus, il vous suffit de relancer les étapes d'installation.
Connectez vous avec l'utilisateur kresus :
<code bash>sudo -i -u kresus</code>

Lancez l'installation :
<code bash>
npm install --prefix /home/kresus/ kresus
</code>

S'il ne vous installe pas la dernière version disponible (voir [[https://www.npmjs.com/package/kresus|ici]] pour les versions), lancez la commande en ajoutant le numéro de la dernière version. Exemple avec la version 0.19.0 :
<code bash>
npm install --prefix /home/kresus/ kresus@0.19.0
</code>