BTCPay Server is a free and open-source Bitcoin payment processor which allows you to accept bitcoin without fees or intermediaries.
View Demo ยท Report a bug ยท Request a feature ยท FAQ
## ๐ผ Table of Contents * [Features](#-features) * [Getting Started](#-getting-started) * [Documentation](#-documentation) * [Contributing](#-contributing) * [Developing](#-developing) * [API](#-api) * [Community](#-community) * [License](#-license) * [Supporters](#-supporters)  ## ๐จ Features * Direct, peer-to-peer Bitcoin payments * No transaction fees (other than the [network fee](https://en.bitcoin.it/wiki/Miner_fees)) * No fees, middleman or KYC * Non-custodial (complete control over the private key) * Enhanced privacy & security * Self-hosted * SegWit support * Lightning Network support (LND, Core Lightning (CLN), Eclair) * Tor support * Share your instance with friends (multi-tenant) * Invoice management and Payment requests * Apps: Point of sale, crowdfunding, donation button * Full-node reliant wallet with [hardware wallet integration](https://docs.btcpayserver.org/Vault/) and SegWit support * Bitcoin-only build, separate community-maintained altcoin build ([supported altcoins](https://docs.btcpayserver.org/FAQ/FAQ-Altcoin/)) ## ๐ Getting Started Firstly, decide if you want to host an instance yourself or use a [third-party host](https://docs.btcpayserver.org/ThirdPartyHosting/). If you've chosen to self-host, there are plenty of documented [ways to deploy BTCPay Server](https://docs.btcpayserver.org/Deployment/). After successful deployment, make sure to check our [getting started](https://docs.btcpayserver.org/RegisterAccount/) and [walkthrough](https://docs.btcpayserver.org/Walkthrough/) guides. In case you would like to use Lightning Network, see [Lightning guide](https://docs.btcpayserver.org/LightningNetwork/). ## ๐ Documentation Please check out our [official website](https://btcpayserver.org/), [complete documentation](https://docs.btcpayserver.org/) and [FAQ](https://docs.btcpayserver.org/FAQ/) for more details. If you have trouble using BTCPay Server, consider joining [communities listed on the official website](https://btcpayserver.org/#communityCTA) to get help from other contributors. Only create a [GitHub issue](https://github.com/btcpayserver/btcpayserver/issues/new/choose) for technical issues you can't resolve through other channels or feature requests you've validated with other members of the community. ## ๐ค Contributing BTCPay Server 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](https://github.com/btcpayserver/btcpayserver/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22), 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 join [our community chat](https://chat.btcpayserver.org/) or [start a GitHub discussion](https://github.com/btcpayserver/btcpayserver/discussions) to get early feedback, discuss the best ways to tackle the problem, and ensure there is no work duplication. There are many other ways to get involved with the project. Check our [contribution guidelines](https://docs.btcpayserver.org/Contribute/). To get the big-picture of the project development, visit our [evolving roadmap](https://github.com/orgs/btcpayserver/projects/16). ## ๐งโ๐ป Developing To begin developing locally, visit our [local development guide](https://docs.btcpayserver.org/Development/LocalDevelopment/). There are also several video-tutorials: * [Setting up development environment on Windows](https://www.youtube.com/watch?v=ZePbMPSIvHM) * [Setting up development environment Linux (Ubuntu)](https://www.youtube.com/watch?v=j486T_Rk-yw&t) * [Setting up development environment MacOS](https://www.youtube.com/watch?v=GWR_CcMsEV0) ### How to build While the documentation advises using docker-compose, you may want to build BTCPay Server yourself. First, install .NET SDK v8.0 as specified by the [Microsoft website](https://dotnet.microsoft.com/download/dotnet/8.0). On Powershell: ```powershell .\build.ps1 ``` On linux: ```sh ./build.sh ``` ### How to run Use the `run` scripts to run BTCPay Server, this example shows how to print the available command-line arguments of BTCPay Server. On Powershell: ```powershell .\run.ps1 --help ``` On linux: ```sh ./run.sh --help ``` ### How to debug If you want to debug, use Jetbrain's Rider or Visual Studio 2022. You need to run the development time docker-compose as described [in the test guide](./BTCPayServer.Tests/README.md). You can then run the debugger by using the Launch Profile `Docker-Regtest`. If you need to debug ledger wallet interaction, install the development time certificate with: ```bash # 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](https://docs.btcpayserver.org/Deployment/). ### ๐งช API BTCPay Server has two APIs: - **Greenfield API (New)** - [Greenfield API documentation](https://docs.btcpayserver.org/API/Greenfield/v1/) - [Greenfield API examples with CURL](https://docs.btcpayserver.org/GreenFieldExample/) - **Legacy API** The **Greenfield API** is our brand-new API which is still in development. Once complete, it will allow you to run BTCPay Server headlessly. The **Legacy API**, is fully compatible with [BitPay's API](https://bitpay.com/api/). It has limited features, but allows instant migration from BitPay. ## ๐ Community Our community is the โค๏ธ of the project. To chat with other community members in real-time, join our [Mattermost chat](https://chat.btcpayserver.org). We're also on [GitHub discussions](https://github.com/btcpayserver/btcpayserver/discussions). ## ๐ License BTCPay Server software, logo and designs are provided under [MIT License](https://github.com/btcpayserver/btcpayserver/blob/master/LICENSE). ## ๐ Supporters The BTCPay Server Project is proudly supported by these entities through the [BTCPay Server Foundation](https://foundation.btcpayserver.org/). [](https://spiral.xyz) [](https://opensats.org) [](https://www.bailliegifford.com) [](https://tether.to) [](https://hrf.org) [](https://lunanode.com) [](https://walletofsatoshi.com/) [](https://coincards.com/) [](https://ivpn.net/) [](https://unbank.com/) If you'd like to support the project, please visit the [donation page](https://btcpayserver.org/donate/).