BTCPay Server is an open-source, self-hosted Bitcoin payment processor that allows secure and private Bitcoin payment acceptance. This guide walks you through the installation process on Fedora Server.
Prerequisites
Before beginning the installation, ensure your system meets these prerequisites:
- Fedora Server Latest (at least Fedora 32)
- Access to the root user account or a user account with sudo privileges
Installation Step 1: Install Dependencies
First, install necessary dependencies. Use the following commands with root or sudo privileges:
sudo dnf update
sudo dnf install git curl docker-compose
Step 2: Clone BTCPay Server Repository
Clone the BTCPay Server repository from GitHub:
git clone https://github.com/btcpayserver/btcpayserver.git
Step 3: Run BTCPay Server
Navigate to the cloned project's directory and run BTCPay Server using Docker Compose:
cd btcpayserver
sudo docker-compose up -d
This step might take a few minutes based on your internet speed.
Step 4: Verify BTCPay Server is Running
Check the status of the server using Docker logs:
sudo docker logs -f btcpayserver_mainnet
If successful, you'll see a message indicating BTCPayServer started at URL: along with the server URL. Note this URL for future reference.
To see the status of Docker containers, use:
sudo docker ps
You should see a container named btcpayserver_mainnet running.
Step 5: Access BTCPay Server’s Dashboard
Open a web browser and go to the URL from Step 4. You will be redirected to the BTCPay Server’s login page. Use the default admin credentials:
- Email Address:
admin@btcpayserver.org - Password:
default
Upon login, you'll be prompted to create a secure admin account.
Conclusion
In this tutorial, you have successfully installed BTCPay Server on Fedora Server Latest using Docker Compose. BTCPay Server is a robust and user-friendly Bitcoin payment processor that ensures secure and private Bitcoin payment acceptance.







