Raspiblitz Setup Tutorial 2026

Why Build a RaspiBlitz Node?

Running your own Bitcoin and Lightning node gives you financial sovereignty. No third party validates your transactions. No corporate server sits between you and the network. A RaspiBlitz puts you in full control for under $300 in hardware, and this tutorial walks through every step from unboxing to opening your first Lightning channel.

The RaspiBlitz project, maintained by Christian Rotzoll and the Fulmo team, packages Bitcoin Core, LND, and dozens of additional services into a Raspberry Pi-based node with an LCD display and a clean web interface. Unlike Umbrel or Start9, RaspiBlitz gives you raw access to the command line and configuration files, making it the preferred choice for users who want to understand what their node actually does.

Hardware Bill of Materials

Before ordering parts, verify compatibility with the current RaspiBlitz release (v1.11.x as of early 2026). The project targets the Raspberry Pi 4 or Pi 5.

Required Components

• Raspberry Pi 4 Model B (4 GB or 8 GB RAM) — The 8 GB version handles initial blockchain sync faster. The Pi 5 also works but check the RaspiBlitz GitHub for confirmed support on your release version.
• MicroSD card (32 GB minimum) — Used only for the operating system. A Class 10 / A2 rated card from Samsung or SanDisk is sufficient.
• SSD drive (1 TB minimum) — The Bitcoin blockchain exceeds 600 GB. A 1 TB Samsung 870 EVO or equivalent SATA SSD works well. NVMe drives require a USB-to-NVMe enclosure.
• USB 3.0 to SATA adapter or enclosure — Connects the SSD to the Pi. The Sabrent USB 3.0 to SATA adapter is widely tested. Avoid adapters with the ASMedia ASM1153E chipset, which causes data corruption on some Pi 4 units.
• Official Raspberry Pi power supply — 5V / 3A USB-C for Pi 4, 5V / 5A for Pi 5. Underpowered supplies cause random crashes during blockchain sync.
• Ethernet cable — Wi-Fi is technically possible but strongly discouraged. A wired connection ensures reliable sync and Lightning channel stability.
• LCD display (optional) — The RaspiBlitz 3.5″ LCD HAT provides status info directly on the device. The web UI works fine without it.
• Heatsink case or fan — The Pi throttles under sustained load. A passive aluminum case like the Flirc or an active fan case keeps temperatures below 60°C during initial sync.

Total cost ranges from $200–$350 depending on whether you already own some components. If you are deciding between node hardware options, the home Bitcoin node guide covers broader considerations.

Estimated Budget Breakdown

Step 1: Flash the RaspiBlitz Image

Download the latest RaspiBlitz image from the official GitHub releases page. The file is named something like raspiblitz-v1.11.1-2026-01-15.img.gz. Always verify the SHA-256 checksum before flashing.

# Download the image and checksum
wget https://github.com/raspiblitz/raspiblitz/releases/download/v1.11.1/raspiblitz-v1.11.1-2026-01-15.img.gz
wget https://github.com/raspiblitz/raspiblitz/releases/download/v1.11.1/raspiblitz-v1.11.1-2026-01-15.img.gz.sha256

# Verify integrity
sha256sum -c raspiblitz-v1.11.1-2026-01-15.img.gz.sha256

Flash the image to your microSD card using Balena Etcher, Raspberry Pi Imager, or the command line:

# Identify your SD card device (BE CAREFUL - wrong device = data loss)
lsblk

# Flash the image (replace /dev/sdX with your actual device)
gunzip -c raspiblitz-v1.11.1-2026-01-15.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync

On macOS, use /dev/rdiskN (raw disk) instead of /dev/diskN for significantly faster write speeds. On Windows, Balena Etcher handles the compressed image directly.

Step 2: Assemble and Boot

1. Insert the flashed microSD card into the Raspberry Pi.
2. Connect the SSD via the USB 3.0 adapter to one of the blue USB 3.0 ports.
3. Attach the LCD display to the GPIO header if you have one.
4. Plug in the Ethernet cable to your router.
5. Connect the power supply last — the Pi boots immediately when powered.

The first boot takes 2–5 minutes. If you have the LCD, it displays the RaspiBlitz logo followed by the device’s IP address. Without the LCD, find the IP from your router’s DHCP client list or use a network scanner:

# Find the RaspiBlitz on your network (Linux/macOS)
sudo nmap -sn 192.168.1.0/24 | grep -B2 "Raspberry"

Step 3: Initial SSH Setup

Connect to your RaspiBlitz via SSH. The default credentials are user admin with password raspiblitz.

ssh [email protected]

The setup wizard launches automatically on first login. It walks you through:

1. Setting passwords — You create separate passwords for the admin user (SSH access), the Bitcoin RPC interface, and the LND wallet. Use strong, unique passwords for each. Write them down and store them with your seed phrase backup.
2. Naming your node — Pick a name for your Lightning node. This is publicly visible on the network.
3. Blockchain sync method — Choose between syncing from the network (IBD — Initial Block Download) or copying a pre-synced blockchain from another drive. IBD takes 2–5 days on a Pi 4 with a good internet connection. The copy method takes 6–12 hours depending on USB transfer speeds.
4. Lightning implementation — The default is LND. CLN (Core Lightning) is available as an alternative. This guide assumes LND.

Step 4: Wait for Blockchain Sync

The initial block download is the longest part of the setup. Bitcoin Core downloads and validates every block since January 2009. On a Raspberry Pi 4 with 8 GB RAM and a decent internet connection, expect 3–5 days for full sync.

Monitor progress through the LCD, the web UI, or SSH:

# Check Bitcoin sync status
bitcoin-cli getblockchaininfo | grep -E "blocks|headers|verificationprogress"

The verificationprogress field shows a decimal between 0 and 1. When it reaches 0.999999, your node is synced. During sync, keep the Pi powered on continuously. Interrupting sync does not corrupt data, but it extends total sync time.

For a deeper understanding of what your node does during this process, Bitcoin Core software verification explains the validation mechanics.

Step 5: Access the Web Interface

Once Bitcoin Core syncs (or even during sync), access the RaspiBlitz web UI by navigating to https://192.168.1.XXX in your browser. Accept the self-signed certificate warning — this is expected for a local device.

The web dashboard shows:

• Bitcoin blockchain sync status and block height
• Lightning node status, channels, and balances
• System resource usage (CPU, RAM, disk, temperature)
• Installed services and their status

The web UI provides most functionality you need for daily operations. For advanced configuration, SSH remains necessary.

Step 6: Fund Your Lightning Wallet

After blockchain sync completes and LND initializes, you need on-chain bitcoin to open Lightning channels.

# Generate a new on-chain receiving address
lncli newaddress p2wkh

# Check your on-chain balance after sending bitcoin
lncli walletbalance

Send a small amount first (50,000–100,000 sats) to verify everything works. Wait for at least 3 confirmations before opening channels. The Lightning node operation guide covers funding strategies in more detail.

Step 7: Open Lightning Channels

Lightning channels are the payment rails of the network. Opening a channel locks bitcoin in a 2-of-2 multisig with another node. Channel capacity determines how much you can send and receive.

Finding Good Peers

Connect to well-connected, reliable nodes. Use sites like Amboss, 1ML, or LightningNetwork+ to find peers. Look for nodes with:

• High uptime (99%+)
• Multiple existing channels
• Reasonable fee policies
• Geographic and network diversity

Opening a Channel

# Connect to a peer (get their pubkey@host:port from Amboss or 1ML)
lncli connect 03e7156ae33b0a208d0744199163177e909e80176e55d97a2f221ede0f934dd9ad@1.2.3.4:9735

# Open a channel with 500,000 sats capacity
lncli openchannel --node_key 03e7156ae33b0a208d0744199163177e909e80176e55d97a2f221ede0f934dd9ad --local_amt 500000

# Check pending channels
lncli pendingchannels

# List active channels after confirmation
lncli listchannels

Start with 2–3 channels of 500,000–2,000,000 sats each. Channels below 200,000 sats are generally uneconomical because on-chain fees for opening and closing consume a disproportionate share. For advanced channel strategies, see the Lightning channel management guide.

Step 8: Install Additional Services

RaspiBlitz supports dozens of optional services. Access them through the SSH menu or the web UI. Common additions include:

• Ride The Lightning (RTL) — A web-based Lightning node manager with a polished interface for channel management, payments, and invoices.
• ThunderHub — An alternative web interface with strong analytics and accounting features.
• BTC-RPC-Explorer — A self-hosted block explorer that queries your own node. No privacy leakage to third-party explorers.
• Electrs or Fulcrum — Electrum server implementations that let you connect hardware wallets like Coldcard or Sparrow Wallet directly to your own node.
• Mempool.space — Self-hosted mempool visualizer and fee estimator.
• LNbits — A Lightning accounts system for creating wallets, payment links, and point-of-sale interfaces.

# Install services via SSH menu
raspiblitz

# Or install directly
config.scripts/bonus.electrs.sh on
config.scripts/bonus.btc-rpc-explorer.sh on

Step 9: Connect Your Wallet to Your Node

The real power of a RaspiBlitz emerges when you connect your daily wallets to it. Instead of trusting Electrum’s public servers or a hardware wallet vendor’s backend, every transaction query goes through your own validated copy of the blockchain.

To connect Sparrow Wallet to your RaspiBlitz Electrs instance:

1. Install Electrs on your RaspiBlitz (see Step 8).
2. In Sparrow, go to File → Preferences → Server.
3. Select Private Electrum Server.
4. Enter your RaspiBlitz IP and port 50002 with SSL enabled.
5. Test the connection and apply.

For mobile wallets, many support connecting to your own node via Tor. The RaspiBlitz automatically configures Tor hidden services for Bitcoin and Lightning, giving you remote access without exposing your home IP address.

Maintenance and Backups

A running node requires minimal ongoing maintenance, but a few tasks keep things healthy:

• Update RaspiBlitz — Check the GitHub releases page periodically. Major updates typically come every few months. The update process is handled through the SSH menu under UPDATE.
• Monitor disk space — The blockchain grows roughly 50–80 GB per year. A 1 TB drive provides several years of headroom. Check usage with df -h.
• Back up Lightning channels — LND creates static channel backups (SCB) automatically. The RaspiBlitz can push these to a USB drive or cloud storage. Losing channel state without a backup means losing channel funds.
• Monitor temperature — High CPU temperatures (above 80°C) cause thermal throttling. The web UI shows current temps. If consistently high, improve cooling.

# Check system temperature
vcgencmd measure_temp

# Check disk usage
df -h /mnt/hdd

# Back up channel state manually
lncli exportchanbackup --all --output_file /tmp/channel-backup.bak

Security Hardening

Your RaspiBlitz is a financial server. Treat it accordingly with basic security measures:

• Change the default SSH port — Edit /etc/ssh/sshd_config and change Port 22 to a non-standard port (e.g., 2222). This reduces automated SSH brute-force attempts from bots scanning your network.
• Disable password authentication — After setting up SSH key-based authentication, disable password logins entirely. This prevents all password-based attacks.
• Keep the Pi behind your router’s firewall — Do not expose any ports to the public internet unless you specifically need them for Lightning routing. Tor hidden services handle remote access securely without port forwarding.
• Use a dedicated network segment — If your router supports VLANs, isolate the RaspiBlitz from IoT devices and guest networks. This limits lateral movement if another device on your network is compromised.

The RaspiBlitz automatically configures UFW (Uncomplicated Firewall) with sensible defaults. Verify the firewall status with sudo ufw status and ensure only necessary ports are open.

Troubleshooting Common Issues

Pi won’t boot after flashing

Re-flash the SD card. Verify the SHA-256 hash matches the published checksum. Try a different SD card — cheap cards fail silently.

Bitcoin sync stalls

Check your internet connection and available disk space. Restart Bitcoin Core with sudo systemctl restart bitcoind. If sync consistently stalls at the same block height, your SSD adapter may have compatibility issues — try a different USB-to-SATA enclosure.

LND fails to start

Check logs with sudo journalctl -u lnd -f. Common causes include insufficient disk space, Bitcoin Core not fully synced, or wallet password issues. The RaspiBlitz SSH menu has a repair option under REPAIR that handles most LND issues.

Cannot connect to the web UI

Verify the Pi’s IP address has not changed (set a static IP or DHCP reservation on your router). Clear your browser cache if the certificate has changed after an update. Try accessing via a different browser.

Remote Access via Tor

RaspiBlitz automatically configures Tor hidden services for SSH, the web UI, Bitcoin RPC, and Lightning. This means you can access your node remotely from anywhere in the world without exposing your home IP address or opening ports on your router.

To find your Tor addresses:

# View all configured Tor hidden services
sudo cat /mnt/hdd/tor/web_ui/hostname
sudo cat /mnt/hdd/tor/ssh/hostname

Use these .onion addresses with a Tor-capable browser or SSH client (e.g., torsocks ssh [email protected]). Tor access is slower than local network access but provides strong privacy and security for remote management.

Mobile wallets like Zeus and BlueWallet can connect to your LND node over Tor, giving you full Lightning wallet functionality on your phone backed by your own node rather than a third-party server.

Frequently Asked Questions

How much does it cost to run a RaspiBlitz monthly?

A Raspberry Pi 4 consumes roughly 5–7 watts. At $0.12/kWh, that is approximately $0.50–$0.60 per month in electricity. Add your internet connection cost (which you likely already pay) and the total ongoing cost is negligible.

Can I run RaspiBlitz on a Raspberry Pi 5?

The RaspiBlitz team is actively working on Pi 5 support. Check the latest release notes for confirmed compatibility. The main considerations are updated GPIO libraries for the LCD display and power supply requirements (the Pi 5 requires 5V/5A).

Is RaspiBlitz better than Umbrel or Start9?

It depends on your priorities. RaspiBlitz gives you more direct control over the underlying system and is preferred by users who want to learn the command line. Umbrel and Start9 offer smoother graphical interfaces with app-store models. All three achieve the same core goal: running your own full Bitcoin node.

Do I need a static IP address?

Not for basic operation. RaspiBlitz configures Tor hidden services automatically, which work behind NAT without port forwarding or a static IP. If you want to run a public-facing Lightning node for routing, a static IP or dynamic DNS setup helps with uptime and peer connectivity.

What happens if my RaspiBlitz goes offline?

Your Bitcoin node simply stops syncing and resumes when power returns. Lightning channels remain open but cannot route payments while offline. Extended downtime (days to weeks) does not cause channel closures — your peers wait for your return. However, if a peer attempts a fraudulent channel close while you are offline, you need a watchtower service monitoring on your behalf.

Can I migrate from Umbrel to RaspiBlitz?

Direct migration is not officially supported, but you can transfer your blockchain data to avoid re-syncing. Copy the Bitcoin blocks directory from Umbrel’s data folder to the RaspiBlitz SSD. For Lightning channels, the safest approach is to close all channels on Umbrel, set up RaspiBlitz fresh, and reopen channels.

For a broader perspective, explore our running a Lightning node guide.

{“@context”: “https://schema.org”, “@type”: “FAQPage”, “mainEntity”: [{“@type”: “Question”, “name”: “How much does it cost to run a RaspiBlitz monthly?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “A Raspberry Pi 4 consumes roughly 5–7 watts. At $0.12/kWh, that is approximately $0.50–$0.60 per month in electricity. Add your internet connection cost (which you likely already pay) and the total ongoing cost is negligible.”}}, {“@type”: “Question”, “name”: “Can I run RaspiBlitz on a Raspberry Pi 5?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “The RaspiBlitz team is actively working on Pi 5 support. Check the latest release notes for confirmed compatibility. The main considerations are updated GPIO libraries for the LCD display and power supply requirements (the Pi 5 requires 5V/5A).”}}, {“@type”: “Question”, “name”: “Is RaspiBlitz better than Umbrel or Start9?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “It depends on your priorities. RaspiBlitz gives you more direct control over the underlying system and is preferred by users who want to learn the command line. Umbrel and Start9 offer smoother graphical interfaces with app-store models. All three achieve the same core goal: running your own full Bitcoin node.”}}, {“@type”: “Question”, “name”: “Do I need a static IP address?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “Not for basic operation. RaspiBlitz configures Tor hidden services automatically, which work behind NAT without port forwarding or a static IP. If you want to run a public-facing Lightning node for routing, a static IP or dynamic DNS setup helps with uptime and peer connectivity.”}}, {“@type”: “Question”, “name”: “What happens if my RaspiBlitz goes offline?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “Your Bitcoin node simply stops syncing and resumes when power returns. Lightning channels remain open but cannot route payments while offline. Extended downtime (days to weeks) does not cause channel closures — your peers wait for your return. However, if a peer attempts a fraudulent channel close while you are offline, you need a watchtower service monitoring on your behalf.”}}, {“@type”: “Question”, “name”: “Can I migrate from Umbrel to RaspiBlitz?”, “acceptedAnswer”: {“@type”: “Answer”, “text”: “Direct migration is not officially supported, but you can transfer your blockchain data to avoid re-syncing. Copy the Bitcoin blocks directory from Umbrel’s data folder to the RaspiBlitz SSD. For Lightning channels, the safest approach is to close all channels on Umbrel, set up RaspiBlitz fresh, and reopen channels. For a broader perspective, explore our running a Lightning node guide.”}}]}