Hack0 is an alternative to Raspberry Pi deployments. It greatly simplifies the installation steps by providing the hardware and the operating system to run your BTCPay Server with docker deployment.
This project is maintained by DG Lab (opens new window), if you need help, come on our support chat (opens new window).
Hack0 aims at two different kind of users:
End usersare people ultimately running the Hack0 for their own purposes.
Distributorsare people who buy the different part of the hardware, assemble it together, install Hack0, and distribute a plug-and-play box for
If you buy the different piece of hardware for your Hack0, assemble, install hack0, then use it yourself, you are both a
distributor and a
end users as far as this documentation is concerned.
You can watch an introduction here:
# Hardware specification (for distributors)
Here is the advised parts for running a Hack0:
- RockPro64 4GB (Link (opens new window))
- USB adapter for EMMC Module (Link (opens new window))
- EMMC 16GB (Link (opens new window))
- Fan For ROCKPro64 20mm Mid Profile Heatsink (Link (opens new window))
- ROCKPro64 20mm Mid Profile Heatsink (Link (opens new window))
- SSD 500GB PCIe NVMe (Link (opens new window))
- M.2 to PCIe adapter (Link (opens new window))
It is possible to replace the EMMC module and adapter by a microSD. But tests has shown that microSD aren't reliable on long term and may cease to work after 2-3 years of use.
# Factory installation (for distributors)
Once you have your hardware, you need to flash the Hack0 image.
The Hack0 is based on the armbian distribution. You can build the image yourself by following instruction on our github page (opens new window). You can also find pre-built image (opens new window) ready to download to save time on this page.
Once you have the image, you can flash it on the EMMC module thanks to the USB adapter for EMMC Module.
During the first start, hack0 is in
setup mode, the setup mode will:
⚠️ When you first boot a pre-built images, the hack0 will be in
setup mode, which will wipe all data in the SSD drive.
setup mode, observe the two leds positioned next to the ethernet connector. You will see the red led staying on, while the white led is blinking.
Once the setup mode succeed, the red led turns off and the white led turns on without blinking. At this point, you can safely disconnect the Hack0. It is now ready to be used by
If the setup failed, then the red led will turns on, while the white turns off.
# End user setup
As a end user, you only need to plug you hack0 with a ethernet cable to your network.
After waiting 5 minutes, you should be able to access
http://hack0.local which will show you the registration form of your BTCPay Server instance.
In some case,
hack0.local might not work, and you need to use a tool such as Angry IP Scanner (opens new window) to locate the IP address of your hack0, then connect to it. If your internet router has a configuration page, you can also find the IP of your hack0 there. You can then connect to
# How to connect via SSH to your hack0?
You need to add your public ssh key to
http://hack0.local/server/services/ssh. Do not remove the
btcpayserver key that already exists.
After this, you should be able to connect via ssh with
ssh firstname.lastname@example.org or Putty.