This article is for our legacy version, discontinued in 2017 and incompatible with new machines.
Please use the latest setup instructions if you've recently received a machine.
This is a resource for existing operators still on the old generation platform.
Setting up your machine to use a Bitcoin Core wallet enables faster transactions at the machine and greater uptime and reliability when compared to using third-party wallets.
The following guide configures Bitcoin Core with a pruned blockchain of 4GB, which means that it can be installed on the recommended $10/mo DigitalOcean droplet. Existing droplets do not need to be expanded.
SECURITY: Your bitcoins are held exclusively in your server’s wallet. Backups will be emailed to you daily, encrypted using the PGP key you import. Deleting your droplet or otherwise corrupting the contents of your server or bitcoind files will result in the loss of your holdings without a wallet backup and your private PGP key with which it's encrypted. It’s good practice to ensure your private PGP key is securely stored and backed up as well.
Creating a PGP Key
To set up Bitcoin Core, you’ll first need a PGP key to enable secure wallet backups. If you already have one, please publish it to a public key server (as described below).
Linux / Mac OS X
Linux: Create a PGP key following the instructions here.
Mac: Download and run GPGTools: https://gpgtools.org/
Next, on Linux/Mac, open your computer’s terminal and run:
Note the Key ID (e.g., 1234568) of your desired key, and upload using:
gpg --send-keys --keyserver keys.gnupg.net <key ID>
Then upload the key to a public keyserver. In Kleopatra, go to File > Export certificate to server. Click Continue on the warning, and it will be uploaded to keys.gnupg.net.
Installing Bitcoin Core
Import your public PGP key to your Lamassu server. In your server’s console, run, replacing <key ID>:
gpg --search-keys --keyserver keys.gnupg.net <key ID>
Type the number of the key associated with that email address you’d like to import, then hit Enter.
lamassu-core-install <email address>
Bitcoin Core will need to download the blockchain, which may take up to 48 hours. Your machine will continue to operate as normal during this time, using its existing wallet. The current blockcount is here. To check the progress on your server, run:
Switching your wallet to Bitcoin Core
After the blockchain is caught up, switch your wallet to Bitcoin Core by running the following three commands:
curl -#o bitcoind.json https://raw.githubusercontent.com/naconner/cacti/master/switches/bitcoind.json
To retrieve the newly created public address for your wallet:
bitcoin-cli listreceivedbyaddress 0 true
Send a small amount for testing purposes and await confirmation on the blockchain. Then, test a transaction at your machine.
Useful Bitcoin Commands
See the balance of your wallet’s holdings:
Generate a new public address:
View the last 10 transactions:
bitcoin-cli listtransactions '' 10
Send all or part of your wallet balance to an external address (amount is in BTC, not Satoshis!):
bitcoin-cli sendtoaddress <bitcoinaddress> <amount>
List all public addresses of your wallet, including change addresses, and balance:
Backup your wallet, sent to your email address and encrypted with your PGP key: