> For the complete documentation index, see [llms.txt](https://docs.money-printer-go-brrr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.money-printer-go-brrr.com/readme/bitcoin-node/setup-your-bitcoin-node-from-source/flash-raspberry-pi-os.md).

# Flash Raspberry Pi OS

Download and flash Raspberry Pi OS onto the SSD.

## Download Pi Imager

To flash the OS onto the portable SSD we will use a software utility called ***Raspberry Pi Imager***. You can download it [here](https://www.raspberrypi.com/software/).

## Choose OS image

Now connect the portable SSD to your computer and launch the Pi Imager. First you have to select 3 options:

* **Raspberry Pi Device**: Choose *Raspberry Pi 5* or *Raspberry Pi 4* depending on the model you use.
* **Operating System**: Choose *Raspberry Pi OS Lite (64-bit)*
* **Storage**: Select your portable SSD

{% hint style="info" %}
Raspberry Pi OS Lite does not include a GUI or extra utilities, allowing us to conserve system resources.
{% endhint %}

## Apply custom settings

Click on ***Next***. The imager will now show a popup to ask you if you want to apply customisation settings. Click on ***Edit Settings.***

### General Tab

* Set a hostname for the Pi on your local network
* Set a username and password (this will create a new user)
* Add your Wi-fi settings (that way the Pi will auto-connect at boot)
* Set locale settings by inputing your timezone and keyboard layout

### Services Tab

In the previous tab, we ensured the creation of a new user and automatic Wi-Fi connection at boot. In this tab, we will set up an SSH service to enable direct login to the Pi after it boots.

{% hint style="warning" %}
We won't use password authentication. It's better practice and safer to use public-key authentication.
{% endhint %}

First we must generate a pair of keys for our user:

```
ssh-keygen -t ed25519 -C "youremail@whatever.com"
```

Next we must copy the content of the public key (`*.pub`). Now in the ***Services*** tab of the Pi Imager:

* Click ***Enable SSH***
* Choose ***Allow public-key authentication only***
* Copy the content of the public key

Click ***Save***, we are now done with the customizations.

## Flash the OS

Back on the customisation popup, click ***Yes*** to apply the settings you just inputed. Click ***Yes*** again to flash the OS onto the SSD.

Once it's done, safely eject the SSD from your computer.

{% hint style="danger" %}
Make sure to safely backup your user credentials and your SSH private key.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.money-printer-go-brrr.com/readme/bitcoin-node/setup-your-bitcoin-node-from-source/flash-raspberry-pi-os.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.