What Umbrel is
Umbrel is a home server: a small computer at home that runs apps you install from its own app store. One of those apps is a Bitcoin node. The operating system is called umbrelOS.
umbrelOS 2.0 was released on 22 September 2026. Version 2.0.1, a security update, followed on 1 November 2026 and was the current release on 17 November 2026. A 2.1 beta is available to anyone who joins the beta programme.
Umbrel sells two devices with umbrelOS already installed, Umbrel Home and Umbrel Pro. You can also download umbrelOS for free and install it on an Intel or AMD computer (a mini PC, laptop or desktop), a Raspberry Pi 5, or a virtual machine. Umbrel's downloads page also lists the Raspberry Pi 4. The project says the image you install yourself is the same umbrelOS that ships on its own devices. It replaces the computer's operating system: it cannot be installed on top of an existing Linux system.
umbrelOS is published under the PolyForm Noncommercial License 1.0.0. You may read, use, change and share the code for personal and noncommercial purposes, and commercial use needs Umbrel's permission. That makes it source-available: anyone can inspect the code, but the licence does not meet the Open Source Definition, which does not allow a licence to restrict use in a business.
umbrelOS: README ↗ · umbrelOS 2.0.1 release ↗ · umbrelOS: licence ↗ · The Open Source Definition ↗
Before you start
- A computer. Umbrel Home comes with 16 GB of memory and a choice of 1 TB, 2 TB or 4 TB of SSD storage. For your own Intel or AMD machine, Umbrel's minimum is a dual-core 64-bit processor, 4 GB of memory (8 GB or more recommended) and 32 GB for umbrelOS, plus drives for apps and data. The machine needs UEFI firmware with Secure Boot turned off.
- Enough storage. Bitcoin Core 32.1 budgets 897 GB for the main network's block data and another 14 GB for its record of unspent coins. An Electrum server then builds its own index on top. A 1 TB drive is no longer enough for both, so choose 2 TB or more, and an SSD.
- On a Raspberry Pi 5, the blockchain will not fit on the microSD card. Umbrel's Pi guide currently recommends running umbrelOS from a microSD card of 32 GB or more, with an SSD connected as external storage. umbrelOS 2.0 can then move an app's storage to that SSD, which must be formatted as ext4. Umbrel Home, or a mini PC with a 2 TB internal drive, avoids this extra step.
- Time. bitcoin.org's full-node guide says the first sync takes at least several days, and longer on a slow connection or a slow computer. Umbrel says an Electrum server then needs a few hours to build its index the first time.
- Your home network. Both of Umbrel's install guides ask for an Ethernet cable to your router during setup. A node downloads the whole blockchain once and keeps sharing blocks with other nodes afterwards. bitcoin.org notes that nodes on fast connections commonly upload 200 GB or more a month. If your connection has a data cap, the Bitcoin Node app has a setting to limit daily uploads.
Umbrel Home ↗ · Umbrel: installing on Intel or AMD ↗ · Umbrel: installing on Raspberry Pi ↗ · Bitcoin Core 32.1: chain size figures ↗ · bitcoin.org: running a full node ↗
Install umbrelOS and the Bitcoin Node app
- Download umbrelOS for your device from umbrel.com/downloads. Each release on GitHub lists a SHA256SUMS file, so you can check the download is the one Umbrel published. Verifying downloads explains how.
- Write it to a drive. For a Raspberry Pi, Umbrel's guide uses Raspberry Pi Imager or Balena Etcher and a microSD card. For an Intel or AMD machine, write the disk image to a USB drive of 32 GB or more with Balena Etcher. umbrelOS then runs from that drive, which stays plugged in. Umbrel also offers a USB installer that puts umbrelOS on the machine's internal drive. Umbrel Home and Umbrel Pro skip this step.
- Connect Ethernet and power, and wait about five minutes for the first start.
- On a computer on the same network, open http://umbrel.local in a browser.
- On Welcome to umbrelOS, click Get started. Enter your name, a Password and Confirm password, then Create. Umbrel's note under the form: there is no way to reset this password, so store it safely. Finishing setup accepts the umbrelOS Terms of Service. On devices with extra drives, setup also asks how to use them.
- Open the App Store, search for Bitcoin Node and click Install. Its listing reads "Run your personal node powered by Bitcoin Core", and its developer is Umbrel. On a Raspberry Pi, move the app's storage to your SSD under App storage in the app's settings before the sync gets far.
- Open the app. It shows Running, then Synchronizing with a percentage. The app's own note says the percentage tracks verified chain work, not the number of blocks, so it will not rise evenly. The sync is finished when it reads Synchronized at 100%.
The app's settings let you choose which version of Bitcoin Core the node runs, or keep it on the latest one. The Bitcoin Node app update released after Bitcoin Core's 28 October 2026 security fixes added versions 32.1, 31.2, 30.4 and 29.5, and said 29.x no longer receives security fixes. Running Bitcoin Core covers the node itself.
Bitcoin Node: app listing ↗ · Bitcoin Node: source code ↗ · umbrelOS: interface wording ↗
Add an Electrum server
Most wallets look up your balance by asking a server about each of your addresses. An Electrum server indexes the blockchain kept by your node so it can answer those questions quickly, for any address. The Bitcoin Node app's own Connect screen calls an Electrum server "the most widely supported way to connect a wallet to your own node." Unless you set one up, your wallet asks someone else's server, and that server sees your addresses.
The Umbrel App Store offers two:
- Electrs, an official Umbrel app built on Electrs by Roman Zeyde. Its connection port is 50001.
- Fulcrum, by Calin Culianu, packaged for Umbrel by a community contributor. Its connection port is 50002.
One is enough. Both need the Bitcoin Node app and wait for it to finish syncing before building their index. On the local network, both accept plain connections without SSL. When Electrs is ready, it shows Address, Port and SSL, with a switch between Local Network and Tor. Tor shows an .onion address you can use away from home. The local address is umbrel.local unless you renamed the device. If a wallet cannot find umbrel.local, use the Local IP that umbrelOS shows in its settings.
The Connect screen in Bitcoin Node also has RPC Details and P2P Details tabs. Umbrel warns that the Local network RPC option sends your username and password unencrypted, and that you must allow your wallet's IP address in the node's settings. The Electrum route needs no password.
Electrs: app listing ↗ · Fulcrum: app listing ↗ · Electrs app: source code ↗
Connect your wallets
Use these details: address umbrel.local (or the .onion address from the Tor tab), port 50001 for Electrs or 50002 for Fulcrum, SSL off.
Sparrow
- Open File > Settings... > Server and choose Private Electrum.
- Enter the address and port, and leave Use SSL off.
- Click Test Connection. The switch at the bottom right of the main window turns blue when Sparrow is on a private Electrum server.
If you enter the .onion address, Sparrow starts its own Tor connection, so it works away from home too. The Sparrow guide covers the rest of the app.
Liana
Liana's documentation says that if you use Bitcoin Core, it must run on the same computer as Liana. It cannot use your Umbrel's Bitcoin Core over the network, but it can use an Electrum server on another machine.
- When Liana asks how to connect, choose I already have a node and set Node type: to Electrum.
- Enter the address including the port, for example umbrel.local:50001. Liana accepts an optional tcp:// prefix. Do not use ssl://, because Umbrel's server does not use SSL.
You can change this later under Settings > Node. The Liana guide covers the full setup.
BlueWallet on your phone
- Connect the phone to your home Wi-Fi.
- Open Settings, then Network, then Electrum Server.
- Enter the address and port, leave Use SSL off, and tap Save.
- Check that Status reads Connected.
BlueWallet no longer has Tor built in. To use the .onion address away from home, run a Tor app such as Orbot alongside it. The BlueWallet guide has the details, and the privacy guide explains what a server can learn.
Sparrow: FAQ ↗ · Liana: usage ↗ · BlueWallet 8.0.2: the app's own wording ↗
Lightning on Umbrel
The App Store has two Lightning nodes: Lightning Node, Umbrel's official app powered by LND, and Core Lightning. It also has dashboards for managing a node, including Ride The Lightning, ThunderHub and Lightning Terminal.
A Lightning node holds funds on the Umbrel itself, and recovering them needs both its recovery words and an up-to-date channel backup. The Lightning Node app backs up the channel backup file automatically, encrypted on your Umbrel before it is sent, over Tor by default, to a backup server run by Umbrel. Its menu also has Download channel backup file. If you turn automatic backups off, Umbrel's advice is to download a fresh file every time your channels change.
The Lightning wallet map and Lightning, without the surprises help you decide whether to run your own. ZEUS can control a Lightning Node app from your phone.
Lightning Node: app listing ↗ · Lightning Node: automatic encrypted backups ↗
Updates, backups and trust
Updates
Update umbrelOS from Settings > Software update, then Install now when a new version is offered. App updates appear in the App Store, with Update for one app or Update all. Read the release notes before updating the Bitcoin Node app: if it is set to the latest version, an app update can move your node to a new Bitcoin Core version.
Backups
umbrelOS Backups, in Settings > Backups, copies your files, apps and data automatically to another Umbrel, a NAS on your network, or an external USB drive. Backups are encrypted with a password you set, and you need that password to restore. Rewind restores single files and folders from an earlier backup, and a new Umbrel can be restored from a backup during setup.
Some things are left out:
- The Bitcoin Node app excludes its block data, chain state and indexes, and Electrs and Fulcrum exclude their indexes. A restored node has to download and check the blockchain again.
- External drives and network shares are not included, and an app moved to an external drive is no longer backed up by umbrelOS.
- Your wallets' keys are not on the node. Sparrow, Liana and BlueWallet keep them in the wallet or on your signing device, and their recovery words, and Liana's descriptor, are backed up separately. The node only answers questions about the blockchain. A Lightning node is the exception: its keys do live on the Umbrel.
What you trust Umbrel with
- The App Store. umbrelOS installs apps from Umbrel's own app repository on GitHub. Some apps are built by Umbrel, others by outside developers and contributors. Each app page shows the Developer, who it was Submitted by, and a link to its Source code. App updates come through the same store.
- umbrelOS itself. It runs the apps, holds your account, and installs the updates you approve. The code is published for anyone to read under the noncommercial licence above. The 2.1 beta adds reproducible builds, so each release can be rebuilt from source and compared with what Umbrel ships.
- Bitcoin Core. Your node checks every block itself, whatever packages it. Umbrel decides which Bitcoin Core versions the app offers and its default settings.
- Lightning backups, if you use them, go to a server Umbrel runs. They are encrypted before they leave your device.
umbrelOS 1.5: Backups ↗ · umbrelOS 2.1 Beta 1 ↗ · Umbrel App Store repository ↗
Before you rely on it
- Bitcoin Node reads Synchronized at 100%, and your Electrum server reads 100% Synchronized.
- Each wallet shows it is connected to your server, and its balance matches what you expect.
- Your Umbrel password is stored safely. It cannot be reset.
- umbrelOS Backups is set up, and its encryption password is stored separately from the device.
- Your wallets' recovery words, and any descriptor, are backed up away from the node.
- If you run Lightning, you have its recovery words and a recent channel backup.
- You know which Bitcoin Core version your node runs, and you check for updates.
Prefer a different node system? The Start9 guide covers the main alternative.
Sources & further reading
Researched 17 November 2026. Software and services change: check the current documents before you act.
- umbrelOS: README and supported devices ↗
- umbrelOS: licence (PolyForm Noncommercial 1.0.0) ↗
- umbrelOS 2.0 release ↗
- umbrelOS 2.0.1 release ↗
- umbrelOS 2.1 Beta 1 release ↗
- umbrelOS 1.5 release (Backups) ↗
- umbrelOS: interface wording ↗
- Umbrel: downloads ↗
- Umbrel Home ↗
- Umbrel: installing umbrelOS on Intel or AMD ↗
- Umbrel: installing umbrelOS on Raspberry Pi ↗
- Umbrel App Store repository ↗
- Bitcoin Node: app listing ↗
- Bitcoin Node: source code ↗
- Electrs: app listing ↗
- Electrs app: source code ↗
- Fulcrum: app listing ↗
- Lightning Node: app listing ↗
- Lightning Node: automatic encrypted backups ↗
- Bitcoin Core 32.1: chain size figures ↗
- bitcoin.org: running a full node ↗
- The Open Source Definition ↗
- Sparrow: FAQ ↗
- Liana: usage documentation ↗
- Liana 16.0: the app's own wording ↗
- BlueWallet 8.0.2: the app's own wording ↗
Run a node you actually use → · Sparrow: build a wallet you can inspect → · Liana: a wallet with a built-in recovery plan → · BlueWallet: a clearer everyday wallet → · Choose the Lightning setup you can maintain → · Your balance is a collection of stories →
