duniter_ynh/README_fr.md

<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/readme_generator
It shall NOT be edited by hand.
-->

# Duniter pour YunoHost

[![Niveau d’intégration](https://dash.yunohost.org/integration/duniter.svg)](https://dash.yunohost.org/appci/app/duniter) ![Statut du fonctionnement](https://ci-apps.yunohost.org/ci/badges/duniter.status.svg) ![Statut de maintenance](https://ci-apps.yunohost.org/ci/badges/duniter.maintain.svg)

[![Installer Duniter avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=duniter)

*[Read this readme in english.](./README.md)*

> *Ce package vous permet d’installer Duniter rapidement et simplement sur un serveur YunoHost.
Si vous n’avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l’installer et en profiter.*

## Vue d’ensemble

Logiciel de cryptomonnaie pour faire fonctionner la monnaie libre Ğ1

**Version incluse :** 1.8.7~ynh0

## Captures d’écran

![Capture d’écran de Duniter](./doc/screenshots/duniter_admin_g1.png)

## Avertissements / informations importantes

## Première synchronisation
La première synchronisation pouvant demander beaucoup de temps, il peut être envisagé de la faire en ligne de commande par ssh plutôt que par l'interface graphique WEB. Afin de pouvoir laisser la synchronisation se faire sans garder la fenêtre du terminal ouverte connecté en ssh, il est recommandé d'utiliser `tmux` ou `screen`.
`screen -S duniter` afin d'ouvrir un nouvel "écran".
Dans cet écran appelé "duniter" :
```
sudo systemctl stop duniter
sudo su - duniter -c "duniter --home \$HOME sync g1.duniter.org" && sudo systemctl start duniter
```
Pendant la synchronisation, vous pouvez faire CTRL+SHIFT+a+d afin de quitter sans fermer l'écran "duniter", vous pouvez alors quitter la connexion ssh.
Pour revenir à votre écran "duniter" pour voir si la synchro est terminée, vous devez lancer la commande
`screen -d duniter`

## Configurations
- Afin de calculer des blocs, il faut configurer ses identifiants membre avec `sudo su - duniter -c "duniter --home \$HOME wizard key"` ou via l’interface d’administration web.
- BMA, l’API client est accessible via `https://duniter.domain.tld/bma/` si activé. Le dernier `/` est nécessaire à son fonctionnement. Cette URL peut être utilisée dans Cesium et Silkaj.
- L’interface d’administration web est accessible à l’adresse `https://duniter.domain.tld/` et est uniquement accessible à l’administrateur spécifié lors de l’installation.
- **Attention** : dans le cas où l’interface d’administration web vous notifie que votre configuration réseau est incorrecte et propose de la corriger, ne le faites pas, autrement ça cassera la configuration spécifique au bon fonctionnement de ce paquet.
Dans le cas où vous auriez appliqué cette correction, vous pouvez manuellement remettre en place la configuration avec la commande suivante :
`sudo su - duniter -c "duniter --home \$HOME config --bma --ipv4 127.0.0.1 --port CHOSEN_PORT --remoteh YOUR_DOMAIN --remotep 443 --noupnp"`

## Cesium
Cesium est une application portefeuilles web. Vous pouvez l’installer :
- [avec l’application YunoHost](https://github.com/YunoHost-Apps/cesium_ynh)

## Documentations et ressources

* Site officiel de l’app : <https://duniter.org>
* Dépôt de code officiel de l’app : <https://git.duniter.org/nodes/typescript/duniter>
* YunoHost Store: <https://apps.yunohost.org/app/duniter>
* Signaler un bug : <https://github.com/YunoHost-Apps/duniter_ynh/issues>

## Informations pour les développeurs

Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/duniter_ynh/tree/testing).

Pour essayer la branche testing, procédez comme suit.

``` bash
sudo yunohost app install https://github.com/YunoHost-Apps/duniter_ynh/tree/testing --debug
ou
sudo yunohost app upgrade duniter -u https://github.com/YunoHost-Apps/duniter_ynh/tree/testing --debug
```

**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>