Installation - matamorphosis/Logchain GitHub Wiki

Logchain currently supports Debian, RHEL, and SUSE based linux distributions. Ubuntu versions >= 18.04 are recommended.

  1. Clone this repository to a location of your choice:
user@linux:~$ git clone https://github.com/matamorphosis/Logchain
  1. Navigate to the installation directory.
user@linux:~$ cd Logchain/install
  1. To execute the installation script simply execute the "setup.sh" script in the "install" directory:
user@linux:~/Logchain/install$ sudo bash setup.sh

This single bash installer is provided to install all components of the Logchain solution. The installer allows the user to install one of the following:

  • Agent
  • Ledger
  • PostgreSQL Database

The solution dictates that there should be one main database server, which all Agents and Ledgers use. Therefore, please do not configure different databases for different ledgers or agents.

  1. Please ensure the details in the configuration file are set correctly. For the agents it is located in /lib/config/agent/config.json, and for the ledgers it is located in /lib/config/ledger/config.json.
  2. Next you will either need to provide certificates or generate a self-signed certificate to use. Either way it is necessary to create a directory called "certs" in the root Logchain directory:
user@linux:~/Logchain$ mkdir certs && cd certs
  1. After which, you will then need to either provide a .key and .crt file to that directory or create the certificates with the command below:
user@linux:~$ openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout privateKey.key -out certificate.crt

For usage information, please refer to the Wiki page found here

Security Information

While Distributed Ledger Technology is considered to be a highly-secure solution for verifying the integrity of information, several security additions have been made to the tools in the Logchain solution. The development of aims to adhere to best security practices as a foundational component of the development. Including the API and database.

Users are encouraged to scrutinise this application and raise issues, whether they are functional or security related.