btcpayserver-doc/docs/Deployment
Nicolas Dorier 33b2b599d3
Some checks failed
Build / build (push) Has been cancelled
Simplify instructions
2026-06-24 15:16:10 +09:00
..
Azure.md Fix embed links 2023-04-14 12:32:46 +02:00
AzurePennyPinching.md Fix embed links 2023-04-14 12:32:46 +02:00
Clovyr.md Update docs/Deployment/Clovyr.md 2023-05-03 12:24:47 +02:00
CometCash.md docs: add Comet Cash deployment guide 2026-05-31 14:00:46 +02:00
DynamicDNS.md Format project using prettier 2023-03-27 16:15:18 +02:00
GoogleCloud.md chore: fix a large number of spelling issues in comments 2025-10-17 23:45:25 +08:00
Hack0.md Update Hack0.md EMMC requirement 2024-02-20 17:01:49 +09:00
Hardware.md Format project using prettier 2023-03-27 16:15:18 +02:00
HardwareAsAService.md chore: fix a large number of spelling issues in comments 2025-10-17 23:45:25 +08:00
LightningInABox.md Remove scam/gambling link. 2025-03-17 12:00:58 +01:00
LunaNode.md chore: remove transmuter 2025-10-20 11:29:47 +02:00
ManualDeployment.md Simplify instructions 2026-06-24 15:16:10 +09:00
ManualDeploymentExtended.md Update refs from dotnet 8.0 to 10.0 2026-06-24 15:12:04 +09:00
RaspberryPi4.md Format project using prettier 2023-03-27 16:15:18 +02:00
README.md docs: add Comet Cash deployment guide 2026-05-31 14:00:46 +02:00
ReverseProxyToTor.md Use $BTCPAY_BASE_DIRECTORY consistently 2023-06-14 10:25:55 +02:00
ReverseSSHtunnel.md chore: fix some spelling issues in comments 2025-07-30 17:23:48 +08:00
ThirdPartyHosting.md docs: fix outdated third-party hosts directory links 2026-03-18 11:57:30 +00:00
voltagecloud.md Fix embed links 2023-04-14 12:32:46 +02:00
webdeployment.md docs: add Comet Cash deployment guide 2026-05-31 14:00:46 +02:00

Choosing a Deployment Method

There are several different deployment methods available, all using the same BTCPay Server software. Because BTCPay is a free and open-source cryptocurrency payment processor, we support diversity in deployment methods for users. Different solutions work best for different use cases.

Business deployment methods can vary by setup, maintenance, support, price, etc. You can run BTCPay 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 a payment processor for others.

BTCPay is a non-custodial invoicing system which eliminates the involvement of a third-party when managing funds. Payments with BTCPay go directly to your wallet. Your private keys are never uploaded to the server. Meaning 3rd Party BTCPay hosts do not control user funds, they are simply hosting your instance of the BTCPay software for you.

Decision diagram

:::warning PLEASE NOTE Manual deployments and Hardware builds are not recommended for production environments and require the user to have technical knowledge related to the build. :::

To choose one that will best suit your needs, consider the following:

Deployment method Difficulty Production/Dev All features
available
Approx. cost
per month
Lunanode
1-click install
Easy Production Yes $10
Voltage-Cloud
1-click install
Easy Production No $10-$30
Clovyr
1-click install
Easy Production Yes $20
Comet Cash
1-click install
Easy Production Yes $30 (Basic plan - up to 4 instances)
Third-Party Hosts
What is this ?
Easy Production Host: Yes
Hostee: No
Free or Paid hosting,
depending on provider.
Hardware & Cloud As A Service:
- embassyOS
- Lightning in a Box
- Nodl.it
- Nodl.cloud
- Voltage.cloud
Easy to Moderate Production Yes Varies on provider
Virtual Private Server:
OpenVZ not supported
- LunaNode
- Microsoft Azure
- Digital Ocean
- Google Cloud
- Other VPS
(minimal requirements)
Moderate to Hard Production Yes $10-70
depending on provider
Manual Deployment:
- Install From Command Line
- Build Without Docker Image
Very hard Development Yes Components + Electricity
Hardware build:
- Raspberry Pi 4
- Hack0
- LightningInABox
hard Development Yes Components + Electricity

Notes:
- VPS providers that use OpenVZ are not supported.
- Fast Sync can be used to accelerate the initial setup sync time for most deployments.