Operate your own BTCPay server
This chapter is about how to set up and administer your own BTCPay server. It is about the setting options of the BTCPay Payment Server via the web backend. This guide is helpful if you want to know how to set up and administrate your own BTCPay server.
If you do not want to set up and operate your own BTCPay server, but use a third-party solution, you can skip this chapter and go directly to the chapter BTCPay-Shop Administren.
Set up BTCPay Server
If you want to set up, set up and operate your own BTCPay server, we recommend the BTCPay Server Hostingpost. For instructions on how to set up your own BTCPay server at LunaNode, see the article to host BTCPay Server at LunaNode.
If you have set up a BTCPay server, you will learn in this chapter how to set up and administer a BTCPay server.
Set up BTCPay Server
After the BTCPay server has been set up, you can set up the BTCPay server. After logging in as administrator, you will see the menu item Server Settings in the navigation quiet. This menu item does not appear if you have logged in with a user account.
After clicking on Server Settings, you will be able to enter the user administration:
BTCPay Server User Management
In user management, all users logged on to the server are administered. A distinction is made between the normal users who are assigned to the respective shops and admin users.
Rates of Bitcoinaverage
The Menu item Conditions (Rates) deals with the settings for the conversion rates or exchange rates.
The provider Bitcoinaverage was deposited here. Bitcoinaverage has calculated an average price of all major exchanges and provided these rates real-time. This service was free until the beginning of 2020. In the meantime, this has become a paid service, starting at a monthly fee of .12.- per month.
If you want to do without this edition, you can do so without any problems. When setting at the shop level, free alternatives can be selected that provide the exchange rates.
We recommend that you do not use Bitcoinaverage’s paid services, as the alternative offers that can be discontinued at the shop level are a very good and free alternative.
Configure email servers
A central e-mail address can be stored here, which is used for communication with users. This is useful, for example, if a user wants to reset a password.
The Policies pane determines how the Payment Server is used.
If you want to use the payment server exclusively for your own business, no changes are made to the basic settings.
The BTCPay server is suitable for multi-shop. This means that an unlimited number of shops can be used for different users.
If you want to offer other users the possibility to run their own Bitcoin shop on this server, some functions need to be released.
By default, registering from the home page is disabled. As an admin, new users can then be created manually via the User setting. If you deactivate the button, new users can log in directly.
This makes sense if you provide the multi-shop function for other shop operators. If these new users are to verify the email address, “Requires a confirmation mail for registering” must be set.
If search engines are to be prevented from indexing the site, “Discourage search engines from indexing this site” must be activated.
If you run several online shops yourself and would like to offer all these shops the payment option Lightning, you activate the function “Allow non-admins to use the internal lightning node in their stores”.
The Lightning payment option is reserved for the operator of your own server, as all Lightning payments are only paid to one Lightning wallet. If you run several shops, the sales can converge in a wallet. This makes no sense if the other shops are not economically related to the operator of the payment server. This function must then remain disabled.
The same applies to the item “Allow non-admins to create hot wallets for their stores”. Ordinary users are referred to as non-admins. If you want to allow the operators of your own shop to send the Bitcoin sales to your wallet, this point is activated.
Services – Crypto Services
This section is about the settings for using Lightning. As already stated above, the payment by Lightning can only be offered by the operator of the payment server to its customers.
If you run a shop as a non-admin on this server, you can only accept Bitcoin payments, but not Lightning payments.
When installing the BTCPay server, there was the option to choose the Lightning variant from the provider LND or C-Lightning.
If you have chosen the LND variant, you will then be presented with this view:
If you have chosen the C-Lightning variant, you will see this view:
This allows you to use the following applications, which were presented under application examples.
For more information about Lightning and the different applications on LND and C-Lightning, see the Lightning chapter
In the Theme chapter, you can customize the look of the BTCPay server. This is not about the design of the individual shops and applications. The design of the shops or payment page is administered under Stores.
At this point, the login page can be changed to the BTCPay server.
If you have set up your own payment server, then this server runs on a hoster or on a different computer than the online shop. If you want to operate the payment server on a unique url, you can define the domain at this point.
In DNS management, you then generate an A-record and enter the name of the sub-domain. This can be, for example, demo for the address https://demo.coincharge.io.
Then, in addition to the DNS entry, the sub-url must also be entered here.
Here is the log file of the server and documents the activities on the server.
Further data can be stored in the Files area, which is required to use the server. These can be logos or images for the visual appearance of the server and the shops. The files can also be stored here if you want to sell files, images, software or downloads.
To use the space, this feature must be shared in the Services pane beforehand.
If this function is released, then files can be saved under Files.
The next chapter explains how to set up a BTCPay shop.