Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Running TurtleCoind on Pi
How To Run a TurtleCoin Node on a Raspberry Pi
This guide is going to walk you through the process of installing and setting up a 64 bit OS, downloading the TurtleCoin ARM binaries and syncing your node on a Raspberry Pi. ARM builds just recently got fixed, so this is great news for anyone that has been wanting to run a node on one.
- a raspberry pi with a 64bit processor (Raspberry Pi 2, 3, 3B and 3B+)
- Recommended: Raspberry Pi 3 B
- a microSD card for the OS (keep in mind faster is better here)
- a SATA to USB adapter such at this one
- A 2.5" SATA SSD of at least 120GB (I recommend 240gb to future proof it)
- A 64 bit OS image file (I'm using pi64 lite edition for this tutorial, which you can find here)
- Etcher installed in order to flash the micro SD card easily
Setting Up the OS
Make sure you've downloaded and installed Etcher and have the pi64.img file saved somewhere on your hard drive. Insert your microSD card into your computer, select the image file in Etcher, click flash and wait for completion. When it's finished flashing and validating, remove the microSD from your computer and insert it into the pi.
Connect your ethernet cable and plug in the pi. Either install a keyboard, mouse and monitor in order to do preliminary setup or SSH into the pi from another computer (open-ssh server is installed and enabled by default on pi64.) The default user is
pi and its password
raspberry, it has passwordless root privileges escalation through
Once logged in, you might want to run
sudo pi64-config in order to get assisted with your setup! Otherwise, set up the linux environment to your liking.
Once you're either ssh'd into your OS or using it directly with a mouse and keyboard, we're going to need to download the TurtleCoin software. You can use these commands to do so:
sudo apt install p7zip-full
7z xz Release.7z
and check that it's working ok with
Note: you'll notice we're wgetting this link from discord's servers. With the ARM builds being fixed so recently, none of the official releases have been updated yet. Once a new official released is pushed this link will be updated.
Mount your SSD
TurtleCoind needs alot of space on a fast drive for the database. So plug in your SSD to one of the USB ports on the pi and we'll create a mount point for it.
First, run this command to view your available disks.
Look at the options and take note of which one is your SSD. It should say something about "SCSI Device" and have the correct size as your drive. For me, it was located at /dev/sda1.
I recommend formatting the device to exFAT so that I can access it easily on both windows and linux systems. In order to mount this type of format, we'll need some additional packages...
sudo apt install exfat-fuse exfat-utils
Now, we can create a folder called .blockchain in the home directory and mount the SSD there.
sudo mount /dev/sda1 /home/pi/.blockchain
Note: replace /dev/sda1 with your drive location and pi with your username if you changed it.
That will temporarily mount the drive in ~/.blockchain, but we want it to be permanent. We'll need to edit the fstab file.
sudo nano /etc/fstab
Scroll to the bottom and add
/dev/sda1 /home/pi/.blockchain exFAT defaults 0 2
Save and close by pressing
Run TurtleCoind and Keep it Running
sudo apt install screen
install screen to keep the daemon running in the background
./TurtleCoind --data-dir '/home/pi/.blockchain' --save-config 'daemon.conf'
(point TurtleCoind to use the mount point we made earlier as the database location, and save a config file to do so automatically in the future)
screen -d -m ./TurtleCoind -c daemon.conf
tell turtlecoin to run with the config file we just generated inside of a detached screen session
Now just wait to sync!
Speeding Up Synchronization
There's a couple things you can do to speed up the blockchain sync. One is to use checkpoints: follow the directions here.
Alternatively, if you have another computer that already has a synced blockchain, you can copy the data in the .TurtleCoin or Appdata/Roaming/TurtleCoin folder onto your SSD and enjoy starting with a fully synced chain!
Thanks to LeoCuvee, thinkpol, ibmcd, zpalm, rocksteady, and anyone else who helped get these binaries functional on ARM architecture!