Add nix config files

This commit is contained in:
Rafael Taranto 2019-10-16 14:59:20 +01:00 committed by Josh Harvey
parent 91fc4e7cc2
commit 95a23a964b
2 changed files with 102 additions and 0 deletions

88
INSTALL-NIX.md Normal file
View file

@ -0,0 +1,88 @@
# Preliminaries for using nix
For a dev environment with nix package manager a postgres install on the base system is required, this guide does not cover a postgresql server running with nix-shell.
## Set up PostgreSQL
```
sudo -u postgres createdb lamassu
sudo -u postgres psql postgres
```
In ``psql``, run the following and set password to ``postgres123``:
```
\password postgres
ctrl-d
```
## Starting up environment
shell.nix script provided, all you need to do to setup the environment is to run `nix-shell` on the folder.
# Installation
## Install node modules
Make sure you're running NodeJS 8.3 or higher. Ignore any warnings.
```
npm install
```
## Generate certificates
```
bash bin/cert-gen.sh
```
Notes:
- This will create a ``.lamassu`` directory in your home directory.
- The script uses the current openssl LTS version (1.0.2g) and will not work on v1.1.
## Set up database
Important: lamassu-migrate currently gripes about a QueryResultError. Ignore this, it works anyway. Also, ignore Debug lines from lamassu-apply-defaults.
```
node bin/lamassu-migrate
node bin/lamassu-apply-defaults
```
## Register admin user
You'll use this generated URL in the brower in moment.
```
node bin/lamassu-register admin
```
## Run lamassu-admin-server
In first terminal window:
```
node bin/lamassu-admin-server --dev
```
## Complete configuration
Paste the URL from lamassu-register exactly as output, into a browser (chrome or firefox).
**Important**: the host must be localhost. Tell your browser to trust the certificate even though it's not signed by a recognized CA.
Go to all the required, unconfigured red fields and choose some values. Choose mock services whenever available.
## Run lamassu-server
In second terminal window:
```
node bin/lamassu-server --mockSms
```
## Add a lamassu-machine
Click on ``+ Add Machine`` in the sidebar. Type in a name for your machine and click **Pair**. Open up development tools to show the JavaScript console and copy the totem. You will use this to run lamassu-machine. This pairing totem expires after an hour.
Now continue with lamassu-machine instructions from the ``INSTALL.md`` file in lamassu-machine.