OpenSource-Hub
B

BTCPay Server

7.5k stars·Privacy Protection·SHA-256 checksum verified

BTCPay Server is a free, open-source Bitcoin payment processor that lets you accept Bitcoin payments directly, without fees or third parties.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Free, self-hosted Bitcoin payment processor that eliminates middlemen and fees.

Core Features

  • Direct peer-to-peer Bitcoin payments, zero transaction fees (only network fees)
  • Non-custodial: you control private keys, enhancing privacy and security
  • Lightning Network support for instant, low-fee transactions
  • Self-hosted with Tor support for anonymity
  • Multi-tenant: share instance with friends or customers

What It Can't Do

  • Self-hosting requires technical skills (Linux, Docker) — not for non-technical users. 2. Full Bitcoin node needs ~500GB+ disk space and good bandwidth. 3. Lightning Network channel management is complex and locks funds. 4. No official support; rely on community. 5. Compared to BitPay (centralized), BTCPay offers more privacy but lacks convenience and customer service.

Use Cases

  • Accept Bitcoin payments on e-commerce sites without paying processor fees
  • Creators and nonprofits accept donations with no intermediary
  • Retail stores use POS app to scan QR codes for payment
  • Crowdfunding campaigns manage transparent payment requests

Detailed Introduction

BTCPay Server is a self-hosted, non-custodial Bitcoin payment processor. It allows you to accept Bitcoin payments peer-to-peer, with no transaction fees (only network fees), no middleman, and no KYC requirements. You maintain full control over your private keys, enhancing privacy and security. It supports SegWit, Lightning Network (LND, CLN, Eclair), Tor, and multi-tenant sharing. Features include invoice management, payment requests, Point-of-Sale apps, crowdfunding, donation buttons, and a full-node wallet with hardware wallet integration. It’s built entirely for Bitcoin, with a separate community-maintained altcoin build available.

Troubleshooting & FAQ (2)

Troubleshooting
Why does BTCPay show "The calculated rate should not be 0" and disable payment methods?

This happens when the primary exchange rate provider returns a zero or negative rate (e.g., yadio returns BTC_USD = 0). A temporary workaround is to switch to a different primary rate provider that does not return zero rates. Track issue #7376 for a permanent fix that will treat non-positive rates as invalid and allow fallback providers to run.

GitHub Issue #7376
Troubleshooting
Why does BTCPay Server show 'Your nodes are syncing' and not display Bitcoin blocks?

This indicates your underlying Bitcoin node (e.g., bitcoind) is still syncing the blockchain. Check sync status: for Docker deployments, run docker logs bitcoind; for Umbrel, check the Bitcoin Node app in the dashboard. Wait until fully synced. If stuck, restart the node service: docker restart bitcoind or reboot the Umbrel device. Ensure disk space and network connectivity are adequate. Once sync completes, the message disappears and wallet functions resume.

GitHub Issue #7371

Tags

bitcoinpayment-processorlightning-networkself-hostedopen-sourcenon-custodial

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Decide between self-hosting or using a third-party host (try third-party first if new)

4

Step 2: For self-hosting, follow deployment docs (https://docs.btcpayserver.org/Deployment/) using Docker or one-click scripts

5

Step 3: After deployment, register an account, follow the setup wizard to connect your Bitcoin node and wallet

Install Guide
  1. Step 1: Decide between self-hosting or using a third-party host (try third-party first if new)
  2. Step 2: For self-hosting, follow deployment docs (https://docs.btcpayserver.org/Deployment/) using Docker or one-click scripts
  3. Step 3: After deployment, register an account, follow the setup wizard to connect your Bitcoin node and wallet
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

For Docker deployment, run `docker-compose down -v` to remove containers and volumes. For manual install, delete installation directory, database files, and system service. Always backup wallet private keys first.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-26 11:45:23
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects