btcpayserver/README.md

94 lines
3.2 KiB
Markdown
Raw Normal View History

2017-12-19 03:41:33 +01:00
![BTCPay Server](BTCPayServer/wwwroot/img/btc_pay_BG_twitter.png)
2017-09-29 08:21:41 +02:00
[![Docker Automated build](https://img.shields.io/docker/automated/jrottenberg/ffmpeg.svg)](https://hub.docker.com/r/nicolasdorier/btcpayserver/)
2017-12-19 04:41:15 +01:00
[![Deploy to Azure](https://azuredeploy.net/deploybutton.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fbtcpayserver%2Fbtcpayserver-azure%2Fmaster%2Fazuredeploy.json)
2017-09-29 08:13:07 +02:00
2017-09-13 08:47:34 +02:00
# BTCPay Server
## Introduction
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.
2017-09-13 08:47:34 +02:00
2018-10-14 14:26:47 +02:00
BTCPay is a non-custodial invoicing system which eliminates the involvement of a third-party. Payments with BTCPay 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.
2017-09-13 08:47:34 +02:00
The software is built in C# and conforms to the invoice [API of BitPay](https://bitpay.com/api). It allows for your website to be easily migrated from BitPay and configured as a self-hosted payment processor.
2017-10-21 13:30:59 +02:00
You can run BTCPay as a self-hosted solution on your own server, or use a [third-party host](https://github.com/btcpayserver/btcpayserver-doc/blob/master/ThirdPartyHosting.md).
2018-06-23 17:45:57 +02:00
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 or have an in-store POS system.
## Features
* Direct, P2P Bitcoin payments
* Lightning Network support (LND and c-lightning)
* Altcoin support
* Complete control over private keys
2018-10-14 14:28:09 +02:00
* Full compatibility with BitPay API (easy migration)
2018-10-14 14:26:47 +02:00
* Enhanced privacy
* SegWit support
* Process payments for others
* Payment buttons
* Point of sale
* No transaction fees (other than those for the crypto networks)
* No processing fees
* No middleman
* No KYC
## Supported Altcoins
In addition to Bitcoin, BTCPay supports the following cryptocurrencies:
2018-06-23 17:45:57 +02:00
* BGold
* Dash
2018-06-23 17:45:57 +02:00
* Dogecoin
* Feathercoin
* Groestlcoin
* Litecoin
* Monacoin
* Polis
* UFO
2018-07-22 14:18:31 +02:00
* Viacoin
2018-06-23 17:45:57 +02:00
2017-12-19 04:19:08 +01:00
## Documentation
2017-10-21 13:53:48 +02:00
2017-12-19 04:19:08 +01:00
Please check out our [complete documentation](https://github.com/btcpayserver/btcpayserver-doc) for more details.
2018-03-02 21:04:00 +01:00
You can also read the [BTCPay Merchants Guide](https://www.reddit.com/r/Bitcoin/comments/8f1eqf/the_ultimate_guide_to_btcpay_the_free_and/).
2018-03-05 16:58:27 +01:00
## How to build
2018-10-14 14:28:09 +02:00
While the documentation advises to use docker-compose, you may want to build BTCPay yourself.
2018-03-05 16:58:27 +01:00
2018-10-02 15:11:01 +02:00
First install .NET Core SDK v2.1.4 (with patch version >= 402) as specified by [Microsoft website](https://www.microsoft.com/net/download/dotnet-core/2.1).
2018-03-06 15:35:20 +01:00
2018-03-06 15:18:00 +01:00
On Powershell:
2018-03-05 16:58:27 +01:00
```
2018-03-06 15:18:00 +01:00
.\build.ps1
```
On linux:
```
2018-03-06 15:40:21 +01:00
./build.sh
2018-03-05 16:58:27 +01:00
```
## How to run
2018-10-14 14:26:47 +02:00
Use the `run` scripts to run BTCPayServer, this example shows how to print the available command line arguments of BTCPayServer.
2018-03-06 15:18:00 +01:00
On Powershell:
```
.\run.ps1 --help
```
On linux:
2018-03-05 16:58:27 +01:00
```
2018-03-06 15:40:21 +01:00
./run.sh --help
2018-03-05 16:58:27 +01:00
```
2018-03-06 15:40:21 +01:00
## Other dependencies
2018-10-14 14:28:09 +02:00
For more information, see the documentation: [How to deploy a BTCPay server instance](https://github.com/btcpayserver/btcpayserver-doc/#deployment).