BTCPay Frequently Asked Questions and Common Issues
This document contains a Table of contents to all FAQ and common issues.
General, non-technical questions about BTCPay. What it is, how it works, what are its features, why is it different and who can use it.
- What is BTCPay Server?
- Why should I choose BTCPay over other processors?
- Why is everyone so excited about BTCPay?
- Who can use BTCPay?
- How much does it cost to run BTCPay Server?
- How to install BTCPay?
- What are the minimal requirements?
- What e-commerce integrations are available?
- Do I need to have an online store to accept cryptocurrencies?
- Which cryptocurrencies are supported in BTCPay?
- Why can't I just give my public address to a buyer?
- Does BTCPay need my private key?
- Does BTCPay Server support crypto to fiat conversion?
- Where can I get help and support?
- How can I contribute to BTCPay?
Questions and solutions to BTCPay installation.
- How much does it cost to run BTCPay Server?
- What are the minimal requirements for BTCPay?
- What is the easiest method to deploy a self-hosted BTCPay Server?
- How to choose a proper deployment method?
- Can I run BTCPay on my hardware?
- Can I deploy on my existing VPS?
- Are there free hosts where I can test?
- After initial deployment, I can't register and I don't have a login yet?
- With the docker deployment, how to use a different volume for the data?
- How do I activate Tor on my BTCPay Server?
- Why activate Tor? Does it mean that nobody knows who I am?
- How can I modify/deactivate environment variables?
- Getting 500 nginx error on a local server https and for http (BTCPay is expecting you to access this website from)
- How to manually install BTCPay on Ubuntu 18.04?
- Error: BTCPay is expecting you to access this website from...
Common questions and issues that may occur during the initial sync of BTCPay.
- Why does BTCPay sync?
- Can I skip/speed up the sync?
- How do I know that the sync is finished?
- BTCPay takes forever to synchronize
- BTCPay Server keep showing that my node is always starting
- I already have a synced full node, can I use it with BTCPay?
Questions about e-commerce and other integrations.
- Which integrations are available in BTCPay?
- Does BTCPay have a Shopify plugin?
- Can I use BTCPay without an integration
- How to configure order status in WooCommerce?
- How to customize e-mail confirmations in WooCommerce?
- Error: If you use an alternative order numbering system, please see class-wc-gateway-btcpay.php to apply a search filter
Common problems and questions server admins have.
- How to update BTCPay Server
- How can I check my BTCPay Server version?
- How can I check my BTCPay Server version via terminal?
- What is BTCPay SSH key file
- Error the BTCPAY_SSHKEYFILE variable is not set/ Unable to update
- Forgot BTCPay Admin password
- How to configure SMTP settings in BTCPay?
- How to customize my BTCPay theme style
- How to add Google Analytics code to BTCPay
- How to modify BTCPay checkout page
- How to customize POS app theme?
Store settings explained.
- How to create a store in BTCPay?
- How many stores can I create?
- Store General Settings
- Add network fee to invoice (vary with mining fees)?
- Allow anyone to create invoice?
- Invoice expires if the full amount has not been paid after ... minutes?
- Payment invalid if transactions fails to confirm ... minutes after invoice expiration?
- Consider the invoice confirmed when the payment transaction?
- Consider the invoice paid even if the paid amount is ... % less than expected?
Here are some of the questions and problems about wallets in BTCPay.
- What is BTCPay wallet
- Recommended external wallets
- How to connect my wallet
- Missing payments in wallet
- Electrum and Zap show different addresses
- How to see payments on a mobile device
Frequent questions about the applications in BTCPay.
- What are the Apps in BTCPay?
- Is there a limit on the number of Apps I can deploy?
- Is there a Point of Sale feature in BTCPay?
- How can I use BTCPay in a physical store?
- How to customize the appearance of POS in BTCPay?
- What is a Payment Button?
- How to fix empty spacing around payment button
- How to integrate WooCommerce Store in BTCPay Crowdfund app?
- How to create Pay button with a custom amount?
Lightning Network troubleshooting and common problems.
- How many users can use Lightning Network in BTCPay?
- How to find node info and open a direct channel with a store using BTCPay?
- As a merchant, do I need to open direct channels?
- How can I get inbound capacity to my node?
- Previously installed BTCPay without the integrated LN support, can I migrate?
- Can I use a pruned node with LN in BTCPay?
- How to change from c-lightning to LND or vice-versa?
- Switched Lightning Network implementation, getting "no payment available" error
- WARNING: The LIGHTNING_ALIAS variable is not set. Defaulting to a blank string" when starting container
- How to display my Lightning Node information so that others can connect to me?
- Where can I find recovery seed backup for my Lightning Network wallet in BTCPay Server?
- How to disable on-chain payments and use LN payments only?
- Where can I get Lightning Network Support?
- How to restart my LND?
- How to see LND logs?
- What’s the default LND Directory in BTCPay?
- LND connection issue - cannot get macaroon: root key with id 0 doesn’t exist
- How to change LND Node alias