# 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. 

*Note*: nix-shell depends on the nix channel version, to force it to 19.03 (if you're on a different one) use `nix-shell -I nixpkgs=https://github.com/NixOS/nixpkgs-channels/archive/nixos-19.03.tar.gz`

# 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.