This is a quick guide to configuring our next-gen platform that presumes familiarity with the current production software.
If you are unfamiliar with creating an SSH key or logging into the terminal, please review our production setup guide for details on those individual processes, then set up your droplet and install according to the guide below.
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. Options are: Bitcoin, Ethereum, Zcash, Bitcoin Cash, Dash, and Litecoin.
- For a maximum of two coins, create a droplet with 4GB RAM / 2 CPUs, using Ubuntu 16.04 x64.
- To support three coins or more, create a droplet with 8GB RAM / 4 CPUs, using Ubuntu 16.04 x64.
For either configuration, add a block storage volume for 150 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.
Configure your wallets 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.
If you've installed Ethereum, 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 an upcoming article.)
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, 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 being delivered (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.