Home · Getting Started · Cluster Guide · Troubleshooting · About
Goal: five microSD cards, each with Raspberry Pi OS Lite (64-bit), its own hostname, your user, and SSH access with your key, ready to boot without a keyboard or monitor.
Run on: your own computer.
Install Raspberry Pi Imager on your computer (Windows, macOS or Linux). This guide follows Imager 2.
Make an SSH key on your computer if you don’t have one. Imager copies the public half to each card, so you can log in to every node without a password.
ssh-keygen -t ed25519
Press Enter to accept the default file (~/.ssh/id_ed25519). A passphrase is optional but recommended. This works in the macOS and Linux terminal and in Windows PowerShell.
Choose a username for the cluster and use the same one on every node. This guide uses alice. Avoid pi: it was the old default, so it’s the first name attackers try.
Do this five times, once per card. Imager remembers your settings, so after the first card you only change the hostname.
| Setting | Value |
|---|---|
| Hostname | master for the first card, then worker1 to worker4 |
| Location | Your time zone and keyboard layout (for example America/Puerto_Rico) |
| User | Your cluster username (alice) and a strong password. The password is still used for sudo |
| Wi-Fi | Leave empty: the nodes use Ethernet |
| Remote access | Turn on SSH and choose public-key authentication, then add your public key (~/.ssh/id_ed25519.pub) |
| Raspberry Pi Connect | Leave off |
Imager’s screens change between versions, but the settings stay the same. Imager saves them on the card’s boot partition, and the Pi applies them on its first boot.
From your computer, log in to master:
ssh alice@master.local
Answer yes to the question about the host’s fingerprint.
Check: you get the alice@master:~ $ prompt without typing a password. Try ssh alice@worker1.local and the other workers the same way.
If master.local isn’t found, your network may not support these .local names. Find the Pi’s IP address in your router’s list of connected devices and use ssh alice@<ip-address> instead. The Pi Network gives each node a fixed address next.
Log in to each node and run:
sudo apt update
sudo apt full-upgrade -y
sudo reboot
Once the cluster commands are set up, you can do all nodes at once with cluster-cmd. Maintenance has the details, including firmware.
To reuse a card for something else, or to start over, erase it with Imager:
You don’t need to erase a card before flashing it: writing an OS replaces everything on the card.
Cards larger than 32 GB come formatted as exFAT. Erasing them with Imager reformats them as FAT32, which every device can read. To back up a card or copy one card to others, see Back up and restore cards.
Step 2 of 9 · ← Step 1: Hardware List · Step 3: The Pi Network →