Table of Contents

• Overview
• Prerequisites
• Windows
  • Installing WSL
  • Install and Setup Debian
  • Clone the Installation Repo
  • Install Bitcoin Knots and Datum
  • Configuring systemd
  • Networking
  • Run WSL at Startup
• Debian
  • Install Git and Clone the Installation Repo
  • Run the Installation Scripts

Overview

Get DATUM running in various different setups!

---

Prerequisites

The Bitcoin node itself should have at least 16GB of ram.

You will need an additional 1GB of ram per 1000 miners.

---

Windows

Installing WSL

1. Open up a PowerShell
2. Install WSL with wsl --install
3. Hit "Yes"
4. Restart your machine

Install and Setup Debian

1. Open PowerShell again and type wsl --install -d Debian
2. Start Debian with wsl.exe -d Debian
3. It will request a username - here we will use Bitcoin
4. Enter and retype a password for this user (typed characters will not appear)
5. Go root with sudo -i
6. It will request the password you just created
7. Run apt update
8. Run apt upgrade -y

Clone the Installation Repo

1. Install git by running apt install git -y
2. Clone the repo with git clone https://github.com/Com320/OC-mech-datum-boxes/

Install Bitcoin Knots and Datum

1. Change directory into the repo with cd OC-mech-datum-boxes
2. Modify the scripts to make them executable with chmod +x *.sh
3. Run the installation script with ./main.sh

The installation script will now run and the configuration files for Bitcoin Knots and DATUM will be generated requesting your input along the way. The configuration files can be modified later if desired.

4. Once the script has successfully been run, you will see the following
5. You will now begin syncing the Blockchain - you can monitor its progress with tail -f /home/bitcoin/.bitcoin/data/debug.log
6. Hit ctrl C to stop watching the logs

Configuring systemd

1. Ensure that systemd is configured to run automatically with cat /etc/wsl.conf
2. Skip to the Networking if you see the above output. If you do not see the output in the above picture:

If `systemd=false` change it to "true" by doing the following:
  -  `nano /etc/wsl.conf`
  -  Change "false" to "true"
  -  Hit `ctrl X` then `Y` then `enter` to save the file. 
  
If the file "/etc/wsl.conf" does not exist:
  - `nano /etc/wsl.conf`
  - Then enter the following:
[boot]
systemd=true
  - Hit `ctrl X` then `Y` then `enter` to save the file

3. Restart wsl with wsl.exe --shutdown
4. Confirm it is working with systemctl status

Networking

1. Enter "WSL Settings"
2. Click "Networking" and change "Networking mode" to "Mirrored"
3. Right click on "Terminal" and click "Run as administrator"
4. Click "Yes" when asked if you want to allow Terminal to make changes
5. Enter "wsl --shutdown"
6. Open "Windows Defender Firewall with Advanced Security"
7. Click on "Inbound Rules" and then "New Rule..."
8. Click "Port" and click "Next"
9. Enter "23334" for "Specific local ports" and click "Next"
10. "Allow the connection" and click "Next"
11. Under "When does this rule apply?" leave all three enabled and click "Next"
12. Name the new rule and click "Finish"
13. Finally, go back to Terminal and enter ipconfig /all and make a note of the IPv4 Address - this is where you will point your miners

Note: You will want to assign your Windows machine a static IP on your network to ensure that it doesn't change.

Run WSL at Startup

1. Right click on the Windows button
2. Unfurl "Task Scheduler"
3. Left click then right click on "Task Scheduler Library" and click "Create Task"
4. Name the task startWSL and check "Run whether user is logged on or not"
5. Click "Triggers" then "New"
6. Open the "Begin the task" drop down menu and select "At startup"
7. Click "Actions" then "New"
8. Click "Browse"
9. Search for "wsl.exe" and click "Open"
10. Click "OK"
11. Uncheck "Start the task only if the computer is on AC power" if desired
12. Copy the below settings - modify as desired
13. Click "OK", enter your password and click "OK" again

You can now connect your miners to your DATUM gateway once your node has finished syncing!

Debian

Important: This is designed to work on a brand new installation of Debian. Do not attempt to run this on a machine you've already been using for other stuff, especially if it's already been running a Bitcoin node.

Note: If you make a mistake with the folllowing steps, start over with a fresh install of Debian.

Install Git and Clone the Installation Repo

1. Go root with su -
2. Run apt update
3. Run apt upgrade -y
4. Run apt install git -y
5. Run git clone https://github.com/Com320/OC-mech-datum-boxes
6. Change into the cloned repo cd OC-mech-datum-boxes

Run the Installation Scripts

Make sure you are still root! If not - do it again with su -

1. Run ./main.sh
2. Follow the onscreen prompts to install and configure your Bitcoin Knots node and your DATUM gateway!

For instructions on how to answer the questions and configure your node/gateway see here.

Your node will now sync. Check its progress with bitcoin-cli getblockcount Note: You will need to do this as the bitcoin user - or whatever you called the user created when running the script. su - bitcoin to switch to that user.

You can follow along with tail -f /var/lib/bitcoind/debug.log also.

Once your node has finished syncing you will be able to connect your miners to your DATUM gateway!

Typically you can just type ip a and find the local IP of the Debian machine that way and point your miner to stratum+tcp://your_local_ip:23334