# Hack0

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: Distributors and End users.

  • End users are people ultimately running the Hack0 for their own purposes.
  • Distributors are people who buy the different part of the hardware, assemble it together, install Hack0, and distribute a plug-and-play box for End users.

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:

Total: 188.2$

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.

During the 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 end users.

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 http://<ipaddress>.


# 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 root@hack0.local or Putty.

SSH Authorized keys