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
Within DigitalOcean, click Create to start a new droplet.
Choose Ubuntu 16.04 x64 as the distribution:
The DigitalOcean droplet you create will depend on which coins you intend to support. Options are: Bitcoin, Ethereum, Zcash, Bitcoin Cash, Dash, and Litecoin.
- For coins up to three coins not including Ethereum, use 8 GB RAM / 4 vCPUs.
- To support Ethereum and/or four coins or more, use 16 GB RAM / 6 vCPUs.
If you are not running Ethereum, you may choose a 150 GB block storage volume:
If you are running Ethereum, add a block storage volume for 350 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 22.214.171.124 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 between 24 – 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.
You may check the synchronization status of the coins you've installed: Checking Wallet Synchronization
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.) ought to be backed up by hand: Wallet Backups
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 our multi-coin software is still relatively new, 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.