Congrats on your new machine!
For remote control over your machine's settings and wallet, let's set up the server and admin software.
Note: Before pairing your machine to the server, we will need to remotely update the machine to the latest version. Contact us at firstname.lastname@example.org to arrange.
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.
Digital Ocean & SSH
Sign up for an account at DigitalOcean.com and update your billing info.
Create an SSH key. If you are using Linux or Mac OS X, follow the directions on DigitalOcean here. If using Windows, follow the directions for using PuTTYgen here. Copy the public key portion to a text file.
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 three coins, create a droplet with 4GB RAM / 2 CPUs, using Ubuntu 16.04 x64.
- To support four 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 250 GB.
Check the additional option for monitoring. Click 'New SSH Key' and paste your public SSH key that was generated earlier.
Click 'Create' and note the IP address of the new droplet.
Logging into your server
Note the IP address of the droplet on next screen.
Then, log into the droplet's terminal using your Mac or Linux terminal (replacing 184.108.40.206 with the IP of your droplet):
If using PuTTY on Windows, follow the section in this video. (Note: the rest of the video references an old version of our software, so please refer to the rest of the instructions in the article here rather than the video.)
You'll be prompted for the passphrase you set when creating the SSH key.
After arriving at the command prompt for your droplet, 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.