How to Install BTCPay Server on NixOS Latest

BTCPay Server is an open-source and self-hosted Bitcoin payment processor. It's a great option for accepting cryptocurrencies like Bitcoin and Lightning on your website, store or app - without relying on third-party payment processors.

In this tutorial, we'll show you how to install BTCPay Server on NixOS Latest.

Prerequisites

Before we start, make sure you have the following:

  • A server running NixOS
  • Access to the terminal
  • Basic knowledge of command-line interface

Step 1: Update Your System

First, update your NixOS system with the following command: 

sudo nix-channel --update && sudo nixos-rebuild switch

This will ensure that you have the latest updates and packages installed.

Step 2: Install BTCPay Server

To install BTCPay Server, follow these steps:

  1. Clone BTCPay Server's repository from GitHub:
sudo git clone https://github.com/btcpayserver/btcpayserver.git
  1. Change the directory to where the BTCPay Server repository was cloned:
cd btcpayserver
  1. Install the requirements:
sudo make -C BTCPayServer build
  1. Create a symlink to Main/BTCPayServer/BTCPayServer/bin/Release/netcoreapp3.1/BTCPayServer.dll:
sudo ln -s "$(pwd)/Main/BTCPayServer/BTCPayServer/bin/Release/netcoreapp3.1/BTCPayServer.dll" /usr/local/bin/btcpayserver

This will create a symlink to the BTCPay Server executable, so you can easily run it later.

Step 3: Configure BTCPay Server

Now that BTCPay Server is installed, you'll need to configure it to set it up for your specific use case. For a basic configuration, you can use the following commands: 

sudo BTCPayServer.CreateAdmin.sh

sudo BTCPayServer.Run.sh

The first command creates a new admin user for BTCPay Server. You'll be prompted to enter an email address and password.

The second command starts BTCPay Server. You'll see the following message: 

Server started, listening on http://*:23001

This means that BTCPay Server is up and running and listening on port 23001.

Step 4: Access BTCPay Server

To access BTCPay Server, open your web browser and enter the IP address of your NixOS server followed by port 23001. For example: 

http://<your_server_ip>:23001

You should see the BTCPay Server login page. Enter the email address and password you created in Step 3, and you'll be taken to the BTCPay Server dashboard.

Congratulations! You've successfully installed and configured BTCPay Server on NixOS Latest.

Conclusion

BTCPay Server is a powerful and flexible Bitcoin payment processor. With this tutorial, you should be able to install and configure BTCPay Server on your NixOS server. If you run into any issues, feel free to consult the official BTCPay Server documentation.