mirror of
https://github.com/YunoHost-Apps/duniter_ynh.git
synced 2024-09-03 18:26:35 +02:00
72 lines
3.6 KiB
Markdown
72 lines
3.6 KiB
Markdown
<!--
|
|
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 for YunoHost
|
|
|
|
[](https://dash.yunohost.org/appci/app/duniter)  
|
|
|
|
[](https://install-app.yunohost.org/?app=duniter)
|
|
|
|
*[Lire ce readme en français.](./README_fr.md)*
|
|
|
|
> *This package allows you to install Duniter quickly and simply on a YunoHost server.
|
|
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
|
|
|
|
## Overview
|
|
|
|
Crypto-currency software to operate Ğ1 libre currency
|
|
|
|
**Shipped version:** 1.8.5~ynh1
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
## Disclaimers / important information
|
|
|
|
## First synchronization
|
|
|
|
The first synchronization can be very time consuming, it can be considered to do it from the command line via ssh rather than via the graphical WEB interface. In order to let the synchronization be done without keeping the terminal window open connected in ssh, it is recommended to use `tmux` or `screen`. `screen -S duniter` in order to open a new "screen". In this screen called "duniter":
|
|
|
|
```
|
|
sudo systemctl stop duniter
|
|
sudo su - duniter -c "duniter --home \$HOME sync g1.duniter.org" && sudo systemctl start duniter
|
|
```
|
|
|
|
During the synchronization, you can press CTRL+SHIFT+a+d to exit without closing the "duniter" screen, you can then leave the ssh connection.
|
|
To come back to your "duniter" screen to see if the sync is finished, you have to run the command `screen -d duniter`
|
|
|
|
## Configurations
|
|
- In order to compute blocks you will have to set your member credentials with `sudo su - duniter -c "duniter --home \$HOME wizard key"` or from the webadmin.
|
|
- BMA, the client API is accessible from `https://duniter.domain.tld/bma/` if enabled . The last `/` is necessary. It can be used in Cesium and Silkaj.
|
|
- The web administration interface is accessible via `https://duniter.domain.tld/` and is only accessible to the administrator specified at the installation.
|
|
- **Warning**: In case the Webui tells you your network configuration is wrong and proposes to correct it, do not apply it, otherwise it breaks the specific configuration made for this package.
|
|
You can manually reset the configuration with following command:
|
|
`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 is a wallet webapp. You can install it with:
|
|
- [With the YunoHost app](https://github.com/YunoHost-Apps/cesium_ynh)
|
|
|
|
## Documentation and resources
|
|
|
|
* Official app website: <https://duniter.org>
|
|
* Upstream app code repository: <https://git.duniter.org/nodes/typescript/duniter>
|
|
* YunoHost documentation for this app: <https://yunohost.org/app_duniter>
|
|
* Report a bug: <https://github.com/YunoHost-Apps/duniter_ynh/issues>
|
|
|
|
## Developer info
|
|
|
|
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/duniter_ynh/tree/testing).
|
|
|
|
To try the testing branch, please proceed like that.
|
|
|
|
``` bash
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/duniter_ynh/tree/testing --debug
|
|
or
|
|
sudo yunohost app upgrade duniter -u https://github.com/YunoHost-Apps/duniter_ynh/tree/testing --debug
|
|
```
|
|
|
|
**More info regarding app packaging:** <https://yunohost.org/packaging_apps>
|