1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/duniter_ynh.git synced 2024-09-03 18:26:35 +02:00
duniter_ynh/README.md
2023-03-17 11:03:30 +00:00

3.6 KiB

Duniter for YunoHost

Integration level Working status Maintenance status

Install Duniter with YunoHost

Lire ce readme en français.

This package allows you to install Duniter quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Crypto-currency software to operate Ğ1 libre currency

Shipped version: 1.8.5~ynh1

Screenshots

Screenshot of Duniter

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:

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

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