106 lines
2.4 KiB
Markdown
106 lines
2.4 KiB
Markdown
# Preliminaries for Ubuntu 16.04
|
|
|
|
Installation for other distros may be slightly different. This assumes NodeJS 8.3 or higher and npm 5.6 are already installed. All of this is done in the lamassu-server directory.
|
|
|
|
## Packages
|
|
|
|
```
|
|
sudo apt-get update
|
|
sudo apt-get install postgresql postgresql-contrib postgresql-server-dev-9.5 libpq-dev git
|
|
```
|
|
|
|
## 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
|
|
```
|
|
|
|
# Preliminaries for MacOS
|
|
|
|
## Postgres
|
|
|
|
Use Postgres.app: https://postgresapp.com/
|
|
|
|
**psql** is automatically installed. You won't need to set up users.
|
|
|
|
## NodeJS
|
|
|
|
```
|
|
curl -L https://git.io/n-install | bash -s -- -y lts
|
|
. ~/.bash_profile
|
|
```
|
|
|
|
# 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.
|