# Tutorial: Setting Up a Self-Hosted BTCPay Server with Umbrel

zardoz88

Registered Member
Joined
Jun 22, 2023
Messages
75
Reaction score
90
Setting up a BTCPay Server for your business or personal use can seem daunting, but with Umbrel OS, it's straightforward and doesn't require any coding. Follow these steps to get your BTCPay Server up and running in no time.

**Note:** Umbrel OS and all the apps mentioned in this tutorial are free and open-source. You can find all the code on GitHub.

## Prerequisites

Before you begin, ensure you have the following:

1. A Raspberry Pi 4/5 ( 8GB recommended)
2. A microSD card (32GB or larger)
3. A reliable internet connection
4. An external SSD (recommended for blockchain storage)
5. Basic knowledge of how to connect and power up your Raspberry Pi

## Step 1: Install Umbrel OS

### 1.1 Download Umbrel OS

- Go to the [Umbrel website](https://getumbrel.com) and download the latest Umbrel OS image for Raspberry Pi. Umbrel OS is free and open-source. You can find the source code on [GitHub](https://github.com/getumbrel/umbrel).

### 1.2 Flash Umbrel OS to Your microSD Card

- Use a tool like [Balena Etcher](https://www.balena.io/etcher/) to flash the Umbrel OS image onto your microSD card.
- Insert your microSD card into your computer.
- Open Balena Etcher.
- Select the Umbrel OS image you downloaded.
- Select your microSD card as the target.
- Click "Flash" and wait for the process to complete.

### 1.3 Setup Umbrel

- Insert the flashed microSD card into your Raspberry Pi.
- Connect your external SSD to your Raspberry Pi.
- Connect your Raspberry Pi to your router using an Ethernet cable for a stable connection.
- Power up your Raspberry Pi.

### 1.4 Access Umbrel Dashboard

- Wait a few minutes for Umbrel to start up.
- Open a web browser on your computer and go to `http://umbrel.local`.
- Follow the on-screen instructions to complete the initial setup.

## Step 2: Install Bitcoin Node

### 2.1 Navigate to the Umbrel App Store

- Once you’re on the Umbrel dashboard, click on the "App Store" tab.

### 2.2 Install Bitcoin Node

- Find the "Bitcoin Node" app and click "Install". The Bitcoin Node app is free and open-source, with code available on [GitHub](https://github.com/getumbrel/umbrel/tree/master/apps/bitcoin).
- Wait for the installation to complete. This will take some time as the Bitcoin blockchain needs to download and sync.

## Step 3: Install Lightning Node

### 3.1 Install Lightning Node

- In the Umbrel App Store, find the "Lightning" app (e.g., LND or Core Lightning) and click "Install". These apps are also free and open-source, with their code available on GitHub ([LND](https://github.com/lightningnetwork/lnd), [Core Lightning](https://github.com/ElementsProject/lightning)).
- Wait for the installation to complete.

## Step 4: Install BTCPay Server

### 4.1 Install BTCPay Server

- In the Umbrel App Store, locate the "BTCPay Server" app and click "Install". BTCPay Server is free and open-source, and you can find its code on [GitHub](https://github.com/btcpayserver/btcpayserver).
- Wait for the installation to complete.

## Step 5: Configure BTCPay Server

### 5.1 Access BTCPay Server

- After installation, return to the Umbrel dashboard.
- Click on the "BTCPay Server" app to launch it.

### 5.2 Initial Setup

- Follow the BTCPay Server setup wizard to configure your server.
- Create an admin account.
- Connect your Bitcoin and Lightning nodes (these should be automatically detected if installed via Umbrel).
- Configure any additional settings as needed for your specific use case.

## Step 6: Secure Your Setup

### 6.1 Enable Two-Factor Authentication (2FA)

- Go to the BTCPay Server settings and enable 2FA for added security.

### 6.2 Regular Backups

- Regularly back up your Bitcoin and Lightning node data.
- Use Umbrel’s built-in backup feature to create and download backups of your configuration.

## Conclusion

Congratulations! You’ve successfully set up a fully self-hosted BTCPay Server using Umbrel. This setup not only gives you full control over your payment processing but also ensures
 
Back
Top