Table of Contents

Improve Helium Syncing Speeds by Creating a Helium Blockchain Cache

Today, we will demonstrate how to install the official Helium Miner Docker container on a VPS or Linux virtual machine. This approach offers the advantage of having a centralized and secure copy of the Helium blockchain, under our control. By implementing this setup, we will also enhance syncing speeds by having multiple devices download blockchain data. This solution is highly scalable and can accommodate multiple miners, simply by duplicating the cron script outlined below.


  • General Linux Knowledge
  • A Port Forwarded and Not Relayed Helium Miner
  • A VPS or Linux VM

Setting up a Linux VM:

I’m going to assume that you have some basic linux skills and know how to set up a VPS or linux vm. If you need some help, check out the following resources to create a ubuntu VPS for as little as $5/month:

Setting up the Helium Blockchain “Cache”:

Installing the Required Software:

> Note: Anywhere where you see “” replace it with your helium miner’s public IPv4 address. Run the following commands to install docker and install the docker, the helium docker container, and watchtower for automatic updates:

#Install Docker
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
curl -fsSL | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli

#Install the helium docker container
sudo mkdir /root/miner_data
docker run -d --env REGION_OVERRIDE=US915 --restart always --publish 1680:1680/udp --publish 44158:44158/tcp --name miner --mount type=bind,source=/root/miner_data,target=/var/data

#Set the miner to auto restart when the host restarts
sudo docker update --restart unless-stopped $(docker ps | grep miner | awk '{print $1}')

#Install Watchtower for auto docker container updates
docker run --detach --name watchtower --volume /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower

Creating the Syncing Script:

Now we have the miner docker container setup, we’ll need to set up syncing to and from your helium miners. Modify this script with your helium miners public IPv4 addresses:

docker exec miner miner peer connect /ip4/ 

docker exec miner miner peer sync /ip4/

docker exec miner miner peer fastforward /ip4/

docker exec miner miner peer book -s

docker exec miner miner repair sync_state
docker exec miner miner info p2p_status
docker exec miner miner info height
docker exec miner miner versions
docker exec miner miner info summary

then run nano ./ paste your modified script and hit ctrl+x and y to save.

Testing the script:

chmod +x ~/

Setting Up the Cron Job:

Now we need to set up a cron job to run this every 30 minutes at least. How long is up to you but use crontab guru to figure out the cron syntax to change the interval if you’d like.

Run the following command:

crontab -e

Select your editor of choice, then paste the following as the last line of the script. */30 * * * * ~/ >> ~/synclog.txt Save the file and exit.

Now the script will run every thirty minutes and sync from and to each of your miners.