Installation on Debian

2.1.1. Installation on Debian#

2.1.1.1. Video tutorial#

2.1.1.2. Have a Debian server#

Ensure you have a Debian server up and running with root access before proceeding.

2.1.1.3. Add the Taler repository to the apt sources list#

To add the Taler repository to your apt sources, run:

echo 'deb [signed-by=/etc/apt/keyrings/taler-systems.gpg] https://deb.taler.net/apt/debian bookworm main' | sudo tee /etc/apt/sources.list.d/taler.list

2.1.1.4. Import the Taler Systems SA public key and install packages#

You must import the Taler Systems SA package signing key and then update/upgrade packages:

wget -O /etc/apt/keyrings/taler-systems.gpg https://taler.net/taler-systems.gpg
apt update
apt upgrade -y
apt install postgresql nginx taler-merchant certbot python3-certbot-nginx -y

2.1.1.5. Configure the Taler merchant database#

For the Taler merchant backend, configure the PostgreSQL database by running:

taler-merchant-dbconfig

2.1.1.6. Start the Taler merchant services#

Enable and start the Taler merchant services:

systemctl enable --now taler-merchant.target

2.1.1.7. Check that Taler merchant is running#

Verify that the merchant service is active:

systemctl status taler-merchant-httpd.service

If you see active (running), the Backend is installed successfully. Press q to exit the status screen.

2.1.1.8. Configure a DNS record#

Create a new DNS record with your domain registrar:

  • Type: A

  • Name: backend (or a subdomain of your choice, in this tutorial we are using tutorial)

  • Value: Your server’s IP address

Return to this guide after the DNS record is set up.

2.1.1.9. Set-up Taler Merchant with taler-merchant-rproxy-setup#

Run the following command to set up the Taler merchant with the reverse proxy, do not forget to replace backoffice.your.domain with your domain name:

taler-merchant-rproxy-setup --domain backoffice.your.domain --nginx

This command will set up the reverse proxy for the Taler merchant backend and configure Nginx to serve the backend.

If you would like to set up the Taler merchant backend with a apache reverse proxy, you can run the following command instead:

taler-merchant-rproxy-setup --domain backoffice.your.domain --apache

For other modification please refer to the taler-merchant-rproxy-setup documentation.

2.1.1.10. Access the Taler merchant#

Open your browser and navigate to the domain you entered before. You should see the Taler merchant interface if everything is configured correctly.