Raspberry Pi Setup Guide - One Page Setup

Step 1 - Assemble the Raspberry Pi in its case and connect the SSD to your computer

More detailed instructions on completing Step 1 are here.

1a. Assemble the Raspberry Pi in its case.
If your case has a power button, enable the jumper to have it boot automatically when the power is connected - this ensures it will restart automatically after a power outage. (See the case instructions for how to do this.)

1b. Connect the SSD to your computer.
You will need a computer to setup the operating system for the Pi - Mac or Windows is fine. If you are using an external SSD you should be able to use the cable it came with to plug it directly into your computer. If you are using a case with an internal SSD, you may need to purchase a cable for this purpose if you don't already have one. You will need a USB-A to USB-A cable, or USB-A to USB-C cable, depending on the type of USB port available on your computer.

Step 2 - Download and install the 'Raspberry Pi Imager' software

More detailed instructions on completing Step 2 are here for Windows and here for Mac.

2a. Download 'Raspberry Pi imager' on your computer and install it.
Raspberry Pi Imager will work on Mac, Windows or Linux.

Step 3 - Configure and write 'Raspberry Pi OS' to the SSD using 'Raspberry Pi Imager'

More detailed instructions on completing Step 3 are here.

3a. Open 'Raspberry Pi Imager' if it is not already running.

Make sure you are running Raspberry Pi Imager v1.8.3 or newer.

3b. Click 'CHOOSE DEVICE' and select you Raspberry Pi model.

3c. Click 'CHOOSE OS' and select: Raspberry Pi OS Lite (64-bit)

3d. Click 'CHOOSE STORAGE' and select the SSD you are using for your DigiNode.

3e. Click 'NEXT' and then click 'EDIT SETTINGS':

3f. Fill in the following options:

1. Enter 'diginode' for the hostname if you are planning to run a DigiByte Mainnet node OR a Dual Node (both mainnet and Testnet nodes at the same time).
   Enter 'diginode-testnet' if you are planning to run a Digibyte testnet node ONLY. Make sure that the checkbox is ticked.
2. Set the username to 'digibyte' and enter a password. Do not forget it.
3. Wireless LAN is optional. Since your DigiNode is a server that needs a robust connection to the internet, it is recommended to connect it directly to your router using an ethernet cable, rather than using a wifi connection.
4. Set your timezone and keyboard layout, in case you ever need to connect one.

Tip: More information about all these settings can be found here.

3g. Click the 'SERVICES' tab:

3h. Enable SSH by ticking the box, and elect 'Use password authentication'.
For better security, use a public key.

3i. Click the 'OPTIONS' tab:

3j. Untick 'Enable telemety' (OPTIONAL).
This allows the Raspberry Pi Foundation to collect some anonymized data about your setup. It does not collect your IP address.

3k. Click SAVE and then click YES to apply the OS customisations.

3l. Finally, click 'YES' to begin writing the OS to the SSD.
It'll take a few minutes.

You should see this when you are done:

Step 4 - Connect the SSD to the Raspberry Pi, along with power and ethernet cable (if using) and power it on

More detailed instructions on completing Step 4 are here

4a. Connect the SSD to a blue USB3 port on the Raspberry Pi 4.

4b. Connect the Raspberry Pi to your router with an ethernet cable (OPTIONAL).
This is not needed if you are using wifi. If you have the option an ethernet cable is recommnded

4c. Connect a genuine Raspberry Pi power supply and power on the device.
Wait a minute or two while it boots for the first time.

Step 5 - Connect to the Raspberry Pi from your Mac or Windows PC

More detailed instructions on completing Step 5 are here for Windows and here for Mac.

5a. Open a terminal emulator. Windows Terminal ir recommended for Windows. iTerm 2 is reommended on Mac. 

5b. In the terminal, enter: ssh digibyte@diginode.local
If you set the hostname to 'diginode-testnet', use ssh digibyte@diginode-testnet.local.

If this does not find your Raspberry Pi, you will need to connect using its IP address - e.g. ssh digibyte@192.168.1.10. You can find the IP address by checking the list of connected devices in your router's web interface. Alternatively, use a network IP scanner like Advanced IP Scanner (Windows) or LanScan (macOS).

Once you have successfully connected to your Pi, proceed to step 6.

Step 6 - Run the DigiNode Setup script on your Raspberry Pi

More detailed instructions on completing Step 6 are here.

6a. In the terminal enter, enter: curl -sSL setup.diginode.tools | bash
This will launch DigiNode Setup. It will perform some system checks before displaying the setup menu and guide you through the installation process.

Step 7 - Give the Raspberry Pi a Static IP address and setup Port Forwarding

More detailed instructions on completing Step 7 are here.

7a. Assign your Raspberry Pi a static IP address
This make it easy to access your DigiNode on your local network, and can typically be done via the web interface of your router.

7b. Forward Ports on your router (IMPORTANT)
To make your device discoverable by other nodes on the Internet, you need to open two ports on your router. This step is very important if you want to help support the network. If you setup a mainnet DigiNode, the default ports you need to forward are:

• DigiByte Core: 12024
• IPFS: 4001

If you setup a testnet DigiNode, the default ports you need to forward are:

• DigiByte Core: 12026
• IPFS: 4004

7c. Install fan software for your case (OPTIONAL)
The software for the 'Argon One M.2' case can be installed directly from the 'DigiNode Setup' main menu. Run diginode-setup and find it under 'Extras'.

If you have followed all the steps, your DigiNode on your Raspberry Pi should now be up and running! 🍾🥂🚀

Please share your #DigiNode on social media

Use the hashtag: #DigiNode. The more people who run a DigiByte Node, the more robust and decentralized the DigiByte network becomes.

Stay Informed

Please join the DigiNode Telegram Group to be kept informed of updates. You can also follow @DigiNode.Tools on Bluesky or @diginodetools on X.

Please Donate

I created DigiNode Tools because I want to make it easy for everybody to run a DigiByte Node and DigiAsset Node. I have devoted thousands of hours working on this goal, all for the benefit of the DigiByte community. If this guide has helped you, and you find DigiNode Tools useful, please donate so that I can keep improving it. Many thanks, Olly

dgb1qv8psxjeqkau5s35qwh75zy6kp95yhxxw0d3kup

Thank you very much for your support!
Find me on Bluesky @olly.st and X @saltedlolly.