beszel-agent 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.

1.1 Debconf (interactive)
-------------------------

  $ sudo dpkg-reconfigure -plow beszel-agent

1.2 Debconf (non-interactive)
-----------------------------

  $ echo "beszel-agent beszel-agent/key string ssh-ed25519 ..." | sudo debconf-set-selections
  $ sudo dpkg-reconfigure -fnoninteractive beszel-agent

1.3 Configuration file (manual)
-------------------------------

  $ echo 'KEY="ssh-ed25519 ..."' > /etc/beszel/agent.conf.d/key.conf

2. Docker support
=================

In order to enable Docker support, you need to add the beszel agent user
account (_beszel-agent) to the Docker group (usually docker) like so:

  $ sudo usermod -aG docker _beszel-agent

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

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

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