💰 A cross platform, self-hosted server compatible with Bitpay API
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
nicolas.dorier 7147dadb2a
Remove dependency to DBriize
19 hours ago
.circleci Add Better Version Build Support 5 months ago
.github Apply Kukk's suggestions from code review 1 month ago
.run Plugins flexibility PR (#2129) 1 week ago
.vscode Make vscode open the browser automatically 5 months ago
BTCPayServer Remove dependency to DBriize 19 hours ago
BTCPayServer.Abstractions Plugins flexibility PR (#2129) 1 week ago
BTCPayServer.Client Revert "GreenField API: Configure Store Lightning Payment Method" 2 days ago
BTCPayServer.Common Plugins flexibility PR (#2129) 1 week ago
BTCPayServer.Data More Options refactoring (#2179) 1 week ago
BTCPayServer.PluginPacker Plugins flexibility PR (#2129) 1 week ago
BTCPayServer.Plugins.Test fix compile errors 3 days ago
BTCPayServer.Rating Add Bitcoin Output descriptor support (#2169) 1 week ago
BTCPayServer.Tests Remove dependency to DBriize 19 hours ago
Build bump 2 days ago
docs add greenfield authorize UI docs and fix small issues (#2156) 3 weeks ago
.dockerignore Remove launch profile from docker 3 years ago
.editorconfig Modifying launchSettings.json to follow 2 space indent convention 6 months ago
.gitattributes shebang and fix line ending 2 years ago
.gitignore BTCPay Extensions Part 2 (#2001) 3 months ago
Changelog.md changelog 2 days ago
LICENSE Update year (#2184) 2 weeks ago
README.md Add new supporter, re-arrange old one 4 months ago
RELEASE-CHECKLIST.md Add missing file 6 months ago
SECURITY.md Fix typo in SECURITY.md 1 year ago
amd64.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 2 months ago
arm32v7.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 2 months ago
arm64v8.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 2 months ago
btcpayserver.sln Plugins flexibility PR (#2129) 1 week ago
build.ps1 Add build and run scripts 2 years ago
build.sh shebang and fix line ending 2 years ago
docker-entrypoint.sh Fix docker-entrypoint for raspberry 1 year ago
nuget.config Add a test catching expirationTime bug (#1336) 10 months ago
publish-docker.ps1 Only push the released tag 1 year ago
run.ps1 Add build and run scripts 2 years ago
run.sh fix run.sh 2 years ago


BTCPay Server

Docker Automated build Deploy to Azure CircleCI

BTCPay Server


BTCPay Server is a free and open-source cryptocurrency payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, transaction cost or a middleman.

BTCPay Server is a non-custodial invoicing system which eliminates the involvement of a third-party. Payments with BTCPay Server go directly to your wallet, which increases the privacy and security. Your private keys are never uploaded to the server. There is no address re-use, since each invoice generates a new address deriving from your xpubkey.

The software is built in C# and conforms to the invoice API of BitPay. It allows for your website to be easily migrated from BitPay and configured as a self-hosted payment processor.

You can run BTCPay Server as a self-hosted solution on your own server, or use a third-party host.

The self-hosted solution allows you not only to attach an unlimited number of stores and use the Lightning Network but also become the payment processor for others.

Thanks to the apps built on top of it, you can use BTCPay to receive donations, start a crowdfunding campaign or have an in-store Point of Sale.

What is BTCPay

Table of Contents


  • Direct, peer-to-peer Bitcoin payments
  • No transaction fees (other than the network fee)
  • No processing fees
  • No middleman
  • No KYC
  • Non-custodial (complete control over the private key)
  • Enhanced privacy
  • Enhanced security
  • Self-hosted
  • SegWit support
  • Lightning Network support (LND, c-lightning, Eclair and Ptarmigan)
  • Tor support
  • Opt-in altcoin integrations
  • Full compatibility with BitPay API (easy migration)
  • Process payments for others
  • Easy-embeddable Payment buttons
  • Point of sale app
  • Crowdfunding app
  • Payment Requests
  • Internal, full-node reliant wallet with hardware wallet integration

Getting Started

Firstly, decide if you want to host an instance yourself or use a third-party host. If you've chosen to self-host, we documented plenty ways to deploy BTCPay Server.

After successful deployment, make sure to check our getting started and walkthrough guides. In case you would like to use Lightning Network, see Lightning guide.


Please check out our official website, our complete documentation and FAQ for more details.

If you have trouble using BTCPay, consider joining communities listed on official website to get help from BTCPay community members. Only file Github issue for technical issues you can't resolve through other channels or feature requests you've validated with other members of community.

Main community chat is located on Mattermost.


BTCPay is built and maintained entirely by volunteer contributors around the internet. We welcome and appreciate new contributions.

If you're a developer looking to help, but you're not sure where to begin, check the good first issue label, which contains small pieces of work that have been specifically flagged as being friendly to new contributors.

Contributors looking to do something a bit more challenging, before opening a pull request, please create an issue or join our community chat to get early feedback, discuss best ways to tackle the problem and to ensure there is no work duplication.

You also have an awesome video of our contributors which explains how to get started. Rockstar Dev and Britt Kelly - BTCPay Server Code Along

Here is some info about how to extend the themes.

How to build

While the documentation advises to use docker-compose, you may want to build BTCPay Server yourself.

First install .NET Core SDK v3.1 as specified by Microsoft website.

On Powershell:


On linux:


How to run

Use the run scripts to run BTCPayServer, this example shows how to print the available command line arguments of BTCPayServer.

On Powershell:

.\run.ps1 --help

On linux:

./run.sh --help

How to debug

If you want to debug, use Visual Studio Code or Visual Studio 2019.

You need to run the development time docker-compose as described in the test guide.

You can then run the debugger by using the Launch Profile Docker-Regtest on either Visual Studio Code or Visual Studio 2017.

If you need to debug ledger wallet interaction, install the development time certificate with:

# Install development time certificate in the trust store
dotnet dev-certs https --trust

Then use the Docker-Regtest-https debug profile.

Other dependencies

For more information, see the documentation: How to deploy a BTCPay server instance.

Supported altcoins

Bitcoin is the only focus of the project and its core developers. However, opt in integrations are present for several altcoins. Altcoins are maintained by their respective communities.


BTCPay Server software, logo and designs are provided under MIT License.


The BTCPay Server Project is proudly supported by these entities through the BTCPay Server Foundation.

Square Crypto
Square Crypto
DG Lab
DG Lab
Wallet of Satoshi
Wallet of Satoshi

If you'd like to support the project, please visit the donation page.