💰 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 60c05cab55
Merge pull request #2477 from dennisreimann/lightning-setup-redesign
1 day ago
.circleci Add Better Version Build Support 8 months ago
.github Apply Kukk's suggestions from code review 4 months ago
.run Plugins flexibility PR (#2129) 3 months ago
.vscode Make vscode open the browser automatically 8 months ago
BTCPayServer Merge pull request #2477 from dennisreimann/lightning-setup-redesign 1 day ago
BTCPayServer.Abstractions Fix some NRE in the FileService 1 month ago
BTCPayServer.Client Fix typo of webhook events property 3 days ago
BTCPayServer.Common Refactor TorService (#2388) 5 days ago
BTCPayServer.Data FIDO2/WebAuthN Support (#2356) 3 days ago
BTCPayServer.PluginPacker Plugins flexibility PR (#2129) 3 months ago
BTCPayServer.Plugins.Test fix compile errors 3 months ago
BTCPayServer.Rating bump NBitcoin 3 days ago
BTCPayServer.Tests Final tweaks and test fix 3 days ago
Build Changelog 3 weeks ago
docs add greenfield authorize UI docs and fix small issues (#2156) 4 months ago
.dockerignore Remove launch profile from docker 3 years ago
.editorconfig Modifying launchSettings.json to follow 2 space indent convention 9 months ago
.gitattributes shebang and fix line ending 3 years ago
.gitignore BTCPay Extensions Part 2 (#2001) 6 months ago
Changelog.md Changelog 3 weeks ago
LICENSE Update year (#2184) 3 months ago
README.md add Coincards supporter to readme 1 month ago
RELEASE-CHECKLIST.md Add missing file 9 months ago
SECURITY.md Fix typo in SECURITY.md 1 year ago
amd64.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 5 months ago
arm32v7.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 5 months ago
arm64v8.Dockerfile Plugins: Recommended plugins and github Remote config options (#2045) 5 months ago
btcpayserver.sln Fix plugin projects reference in solution (#2292) 2 months ago
build.ps1 Add build and run scripts 3 years ago
build.sh shebang and fix line ending 3 years ago
docker-entrypoint.sh Fix docker-entrypoint for raspberry 1 year ago
nuget.config Add a test catching expirationTime bug (#1336) 1 year ago
publish-docker.ps1 Remove stable and latest branch 3 weeks ago
run.ps1 Add build and run scripts 3 years ago
run.sh fix run.sh 2 years ago

README.md

BTCPay Server

BTCPay Server

Accept Bitcoin payments ₿

BTCPay Server is a free and open-source Bitcoin payment processor which allows you to accept bitcoin without fees or intermediary.

"This is lies, my trust in you is broken, I will make you obsolete" 💚

View Demo · Report a bug · Request a feature · FAQ

💼 Table of Contents

🎨 Features

  • Direct, peer-to-peer Bitcoin payments
  • No transaction fees (other than the network fee)
  • No fees, middleman or KYC
  • Non-custodial (complete control over the private key)
  • Enhanced privacy & security
  • Self-hosted
  • SegWit support
  • Lightning Network support (LND, c-lightning, Eclair, and Ptarmigan)
  • 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 and SegWit support
  • Bitcoin-only build, separate community-maintained altcoin build (supported altcoins)

🚀 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, there are plenty of documented 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.

📗 Documentation

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

If you have trouble using BTCPay Server, consider joining communities listed on the official website to get help from other contributors. Only create a GitHub issue 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, 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 or start a GitHub discussion to get early feedback, discuss 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. To get the big-picture of the project development, visit our evolving roadmap. We organize different types of community calls several times a month. Subscribe to our calendar and feel free to join our calls to discuss development, design, documentation and more.

🧑‍💻 Developing

To begin developing locally, visit our local development guide. There are also several video-tutorials:

How to build

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

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

On Powershell:

.\build.ps1

On linux:

./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:

.\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.

🧪 API

BTCPay Server has two API's:

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. 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. We're also on GitHub discussions.

📝 License

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

🙏 Supporters

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

Kraken
Kraken
Square Crypto
Square Crypto
BTSE
BTSE
OKCoin
OKCoin
DG Lab
DG Lab
ACINQ
ACINQ
LunaNode
LunaNode
Wallet of Satoshi
Wallet of Satoshi
Nomics
Nomics
Coincards
Coincards

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