This is a quick, under-construction guide to configuring the 2017 Lamassu Beta that presumes familiarity with our current production software.
The beta software is recommended for in-house machines or public machines with low volumes at this time, until undergoing more strenuous tests. Your feedback and testing is much appreciated!
Updating your machine
Your upgrade path depends on the machine model you have. Douros have 10" Aaeon tablet screens. Trofas use a 7" Nexus tablet and were produced in 2014 and before.
Creating a Droplet
The DigitalOcean droplet you create will depend on the coins you intend to support.
- For Bitcoin and Ethereum, create a droplet with 4GB RAM / 2 CPUs, using Ubuntu 16.04 x64.
- For Bitcoin, Ethereum, and any additional coins (Zcash, Dash, Litecoin), create a droplet with 8GB RAM / 4 CPUs, using Ubuntu 16.04 x64.
For either configuration, add a block storage volume for 120 GB.
Check the additional option for monitoring, check the SSH key you're adding, then click create.
Log into your droplet via SSH, run the following install command:
curl -sS https://raw.githubusercontent.com/lamassu/lamassu-install/nextgen/install | bash
When it's finished, it will output a link to the new admin. Please proceed to the steps below before accessing your admin.
After the install script completes, run:
Write the output down someplace safe in the order presented. This will back up your Ethereum seed. However, your other wallet files (Bitcoin, Zcash, etc.) will need to be backed up manually. (More on this in another article.)
If you are not using BitGo for a BTC wallet and/or you are configuring coins apart from Bitcoin, configure your blockchains by running:
Select only the coins compatible with your droplet settings as mentioned in the section above.
Syncing the blockchains will take around 48 hours. During this time the admin may be slow to respond as resources are dedicated to downloading and processing the blockchains. You also will not be able to conduct transactions until the chains are synced.
See more details in our article on Wallets.
The initial install script gives you a one-time link to access the admin.
Create new one-time links at any time by running:
Once opening the admin, configure any fields in red (base commission rate, wallet services, ticker, etc.) Then click 'Add machine'.
Input a name for the machine, then click pair and scan the pairing code at the machine.
New fields to configure in the admin will be marked red:
Third party accounts
Please see the articles in this section for setting up accounts for SMS, email notifications, BitGo (web wallet), and exchanges.
Before sending funds, please ensure your Wallet Settings panel has the appropriate wallet client selected for live transactions (i.e., not 'mock wallet') and that your blockchains have synced.
Deposit only small amounts until you've successfully conducted test transactions. Deposits will require one confirmation before being available to dispense.
Once all admin fields in red have been configured, your chosen modules and wallets selected, and 'lamassu-server is up' is showing at the bottom of the admin page, pair your machine by clicking '+ Add Machine'.
Give your machine a name that you'd recognize, click the pair button, then take a picture of the resulting QR code. Scan this at your machine after pressing the Pair button on the tablet.
Place test transactions at your machine to ensure all is working correctly.
This includes ensuring that not only are coins sent (or dispensed in the case of two-way machines), but also SMS confirmation codes are delivering (for cash-out and compliance) and that trades are executed on your exchange if you have one linked.
As this is new software and still in beta, expect rough edges, and please report any issues you may encounter.
Pulling server logs
You can collect streaming server logs with:
supervisorctl tail -f lamassu-server
You may have this running during testing so you can watch for any error messages.