beszel-hub for Debian
#####################

1. SSH Key
==========

In order to have beszel hub to be able to connect to a beszel agent, you need
to tell the beszel agent the SSH public key of the key generated in beszel hub.

First, in order to optain the public key, use the following command on the
system where you have installed beszel hub:

  $ sudo beszel-hub-key

It will out something like:

  ssh-ed25519 ...

There are multiple ways to tell beszel-agent to make use of it, see
/usr/share/doc/beszel-agent/README.Debian

2. Apache Reverse Proxy
=======================

If you use apache2 as your webserver, you can run beszel-hub behind it as a
reverse proxy by enabling the following modules:

  $ sudo a2enmod proxy_http proxy_http2 proxy_wstunnel rewrite
  $ sudo service apache2 reload

In your apache2 config, you can include an example config for port 8090:

  | <VirtualHost ...>
  | ...
  |
  |         Include /etc/apache2/conf-available/beszel-hub.conf
  |
  | </VirtualHost>

3. Debug logs
=============

In order to show debug logs, you can add LOG_LEVEL="debug" in
/etc/beszel/hub.conf.

 -- Daniel Baumann <daniel@debian.org>  Wed, 01 Jul 2026 11:43:04 +0200
