This document covers all the questions and issues related to Server Settings. This option is only available to server admin. Take a look at the walkthrough page to easier understand the navigation
- 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 disable U2F and 2FA for a user
- How to configure SMTP settings in BTCPay?
- How to SSH into my BTCPay running on VPS?
- How to customize my BTCPay theme style
- How to add Google Analytics code to BTCPay
- How to modify BTCPay checkout page
There are 2 ways to update your BTCPay Server :
- Updating through the front end: Server Settings > Maintenance > Update.
2.Updating through SSH: Login into your virtual machine with ssh, then apply following commands:
sudo su -
btcpay-update.sh
You can see your BTCPay version in the bottom right of the page footer when you're logged in as a server admin.
In the btcpayserver-docker folder:bitcoin-cli.sh getnetworkinfo
BTCPay SSH key, enables users to update their server or quickly change the domain name from btcpay website, the front-end.
First, register a new user on your BTCPay Server, by clicking "Register", for example: "[email protected]".
If you can't create a new user because registrations are disabled in your Server Settings > Policies, you need to reset the policies settings. Please skip this step if you can create a new user on the front-end home page using the register button. Run the following command (It also deletes any other server settings currently being used):
# In root
sudo su -
cd $BTCPAY_BASE_DIRECTORY/btcpayserver-docker/
# Re-open registrations
./btcpay-admin.sh reset-server-policyHead back to your BTCPay Server and click on the "Register" button which should now be enabled. In case you don't see the Register link in the menu, that's probably because of the caching. Restart your btcpay with btcpay-restart.sh.
Next, add the newly registered user [email protected] as an admin:
# Set new user as admin
./btcpay-admin.sh set-user-admin [email protected]Now you can access with [email protected] as admin.
When you apply the changes, you'll noticed that newly created user isn't the member of any stores. In that case, follow this guide to add the new users to all or certain stores.
Remove U2F and 2FA settings for a registered user, for example [email protected] with the following commands:
# In root
sudo su -
cd $BTCPAY_BASE_DIRECTORY/btcpayserver-docker/
# Disable U2F and 2FA
./btcpay-admin.sh disable-multifactor [email protected]BTCPAY_SSHKEYFILE is not set when running the docker install, or unable to update through Server Settings / Maintenance
You may see such the following message when you run your docker-compose (either via btcpay-up.sh or btcpay-setup.sh):
WARNING: The BTCPAY_SSHKEYFILE variable is not set. Defaulting to a blank string.
WARNING: The BTCPAY_SSHTRUSTEDFINGERPRINTS variable is not set. Defaulting to a blank string.BTCPay Server requires SSH access, to allow you to perform the following tasks from the front-end:
- Updating the server
- Changing the domain name of the server
You can run the following command line to give access to BTCPay to your server via SSH.
sudo su -
cd $BTCPAY_BASE_DIRECTORY/btcpayserver-docker
git checkout master
# Setup SSH access via private key
ssh-keygen -t rsa -f /root/.ssh/id_rsa_btcpay -q -P "" -m PEM
echo "# Key used by BTCPay Server" >> /root/.ssh/authorized_keys
cat /root/.ssh/id_rsa_btcpay.pub >> /root/.ssh/authorized_keys
BTCPAY_HOST_SSHKEYFILE=/root/.ssh/id_rsa_btcpay
. ./btcpay-setup.sh -iEach e-mail provider has different configuration, so we can't provide you with exact setup, but here's the configuration for gmail which should work:
SMTP Host: smtp.gmail.com
SMTP Port: 587
SSL Protocol: ON
TLS Protocol: ON
SMTP Username: (your Gmail username)
SMTP Password: (your Gmail password)
If by any chance you have 2-step verification added to your gmail account, visit this article.
Follow these instructions to connect via SSH into your virtual machine.
There are two ways to customize the theme of your BTCPay. The easy way is to head over to the Server Settings > Theme and follow the instructions on how to change your Bootstrap theme.
For advanced theme changes, you'll most likely need to fork BTCPay repository and apply desired design changes. Build and publish the docker image to Docker Hub. Set the BTCPAY_IMAGE environment variable to your docker image tag(export BTCPAY_IMAGE="your custom btcpay docker image") and run the setup (. ./btcpay-setup.sh -i) as usual from BTCPay Docker. Modify generated docker compose to use your custom docker image. You will need to create a new image manually and follow these steps for EACH BTCPay update so it is advised to stick with the default setup.
You should be able to do what you want by injecting your GA code to ~/wwwroot/checkout/js/core.js. Might be the easiest way but you have to redo it every time you update BTCPay to the latest version. Then you won’t have the hassle of forking the code, deploying it manually. Every time there is an update. Just do the docker update and add the same lines to the js file.
You can easily change the appearance of your BTCPay's checkout page by following the instructions here
To allow other users to register and use your server, in Server Settings > Policies enable registration. If you configured SMTP properly, you can request users e-mail confirmation to prevent spam or bot registrating on your instance.
Discouraging search engines from indexing your site in Server Settings > Policies, adds <meta name="robots" content="noindex"> to your server header, which informs search engines not to index your pages.
It is up to search engines to honor this request, and may take time for your pages to disappear completely. Unfortunatelly, the exact time is beyond our control, it depends on crawl bots of particular search engine like Google.
If you're using an external wallet which allows BTC-P2P connection, you can easily connect it to your BTCPay full node. By doing this, you avoid leaking information to third-party servers and are soley relying on your own full node. To connect to a compatible BTC-P2P wallet, go to Server Settings > Services > Full node P2P Reveal the QR code and scan it with a BTC-P2P compatible wallet, or input it by copy-pasting it.
If you do not see Full node P2P in your Services, you probably have to activate Tor on your server.
To upload files to your BTCPay Server instance, first under Server Settings > Services, enable the External Storage feature and choose which storage service provider you would like to use. Next, go to Server Settings > Files to browse and upload local files. Depending on the limitations of your storage system, you may have difficulty uploading large files.