I saw the documentation and they recommend a USB drive, however the videos I watch use the micro SD…
By the way, if I install on a USB drive, can I still use an SSD?
I’d follow the path to creating a flash or usb, whatever you have - as you’ll typically use it just once (USB). From there, you’ll install Umbrel onto the flash or SSD, and that’s where it will boot in the future. The usb will just be a backup. Umbrel needs to run on the ssd for quick read/write of the file system.
Let’s walk through installing Umbrel on your Raspberry Pi 5 with a USB drive, flash drive, and 2 TB SSD. I had to make a few assumptions.
What You’ll Need
- Raspberry Pi 5 (powered off for now)
- USB drive or flash drive (at least 8 GB; we’ll use this to boot umbrelOS)
- 2 TB SSD (for storing data, connected via USB)
- Computer (to prepare the drive)
- Ethernet cable (for a stable internet connection)
- Official Raspberry Pi power supply (third-party ones can cause issues)
- MicroSD card reader (if your computer needs it to access the USB/flash drive)
Step-by-Step Guide
Step 1: Download umbrelOS and Balena Etcher
- On your computer, go to umbrel.com and find the download section for umbrelOS for Raspberry Pi 5. It’s usually labeled clearly, like “umbrelOS for Raspberry Pi 5.”
- Download the latest umbrelOS image file (it’ll be a .zip file).
- Next, download Balena Etcher from balena.io/etcher. This tool flashes the umbrelOS image onto your USB or flash drive. Install it on your computer.
Step 2: Flash umbrelOS to the USB or Flash Drive
- Plug your USB drive or flash drive into your computer. (I’ll assume you’re using the USB drive for this, but the process is identical for the flash drive.)
- Open Balena Etcher.
- Click “Flash from file” and select the umbrelOS .zip file you downloaded.
- Click “Select target” and choose your USB drive. Double-check it’s the right one—everything on it will be erased!
- Click “Flash!” and wait. It’ll take a few minutes. When done, Etcher will say “Flash Complete.” Safely eject the USB drive from your computer.
Step 3: Set Up the Raspberry Pi 5
- Insert the flashed USB drive into one of the USB ports on your Raspberry Pi 5 (any port works, but use a blue USB 3.0 port for speed).
- Connect your 2 TB SSD to another USB port on the Pi (again, a blue USB 3.0 port is best).
- Plug the Ethernet cable into the Pi and your router for internet.
- Connect the official power supply to the Pi and plug it in. The Pi will power on and start booting from the USB drive.
Step 4: Access Umbrel
- Wait 5-10 minutes for the Pi to boot up and install umbrelOS. It’s setting itself up on the USB drive and will format the 2 TB SSD to store data (like the Bitcoin blockchain if you use that app).
- On your computer (connected to the same network), open a web browser and type http://umbrel.local in the address bar. Hit Enter.
- If it loads, you’ll see the Umbrel setup page! Follow the on-screen instructions to create a password and set up your node. You’re done!
Step 5: Verify It’s Working
- Once set up, the Umbrel dashboard should show your 2 TB SSD as the storage drive. You can install apps like Nextcloud or a Bitcoin node from the App Store on the dashboard.
- If it’s running smoothly, congrats—you’ve got Umbrel installed!
What Ifs: Troubleshooting Common Issues
What If http://umbrel.local Doesn’t Work?
- Fix: The .local address sometimes fails depending on your network. Find your Pi’s IP address instead:
- Log into your router (usually via 192.168.1.1 in a browser; check your router’s manual for the exact address).
- Look for connected devices and find the Raspberry Pi’s IP (e.g., 192.168.1.100).
- In your browser, type http://[that IP address] (e.g., http://192.168.1.100) and try again.
- Why: Network settings can block .local resolution, but the IP always works.
What If the Pi Doesn’t Boot?
- Fix: No lights or activity on the Pi means it’s not booting from the USB drive.
- Double-check the USB drive is plugged in securely.
- Re-flash the USB drive with Etcher—sometimes the first flash fails silently.
- Ensure you’re using the official power supply; underpowered Pi’s won’t boot.
- Why: The Pi 5 prioritizes booting from USB if it’s set up right, but a bad flash or power issue can stop it.
What If Umbrel Says “No External Drive Found”?
- Fix: Umbrel needs the 2 TB SSD to store data and might not see it.
- Unplug the SSD, wait 10 seconds, and plug it back into a different USB port (preferably blue).
- Restart the Pi by unplugging and replugging the power.
- If it still fails, the SSD might need reformatting. Plug it into your computer, use Disk Utility (Mac) or Disk Management (Windows) to erase it to exFAT or NTFS, then retry.
- Why: Umbrel expects a compatible, empty drive. Some SSDs have weird partitions from prior use.
What If the Setup Hangs or Takes Forever?
- Fix: If it’s stuck for over 30 minutes:
- Power off the Pi, remove the USB drive, and re-flash it with Etcher.
- Check your internet connection—plug the Ethernet directly into your modem if possible.
- Start over with the SSD unplugged, then plug it in after the dashboard loads.
- Why: A bad flash or network hiccup can stall the initial setup.
What If I Want to Use the Flash Drive Instead of the USB Drive?
- Fix: No change needed! Just use the flash drive in Step 2 instead of the USB drive. The process is the same.
- Why: Both work as boot drives; it’s just a matter of which you prefer.
Tips for Success
- Use the 2 TB SSD for data—it’s big enough for heavy apps like a Bitcoin node (which needs 1 TB+).
- Stick to the USB drive or flash drive for booting; microSD cards wear out faster and aren’t recommended for umbrelOS.
- If you’re nervous, watch a YouTube tutorial (search “Umbrel Raspberry Pi 5 setup”) alongside these steps for visuals.
That’s it! You should be up and running with Umbrel. If anything else goes wrong, let me know what you see, and I’ll guide you through it simply—no Linux wizardry required.
Hi,
Is Umbrel on a Raspberry Pi still a thing? Where are the instructions on umbrel.com? I don’t see them anymore?