pantalaimon is a daemon that acts as a reverse proxy between a Matrix homeserver and a Matrix client. The
daemon transparently handles end-to-end encryption tasks on behalf of the client.
pantalaimon is supposed to run as your own user and listen to connections on a non-privileged port. A
client needs to log in using the standard Matrix HTTP calls to register itself to the daemon, such a
registered user is called a pan user and will have it's own sync loop to keep up with the server.
Multiple matrix clients can connect and use the same pan user.
If user interaction is required pantalaimon will send out OS notifications which the user can react to.
pantalaimon also provides a D-Bus API that is used for encryption related tasks that require user
interference (e.g. device verification).
pantalaimon requires a homeserver to be configured. Multiple homeservers can be configured, each
configured homeserver needs to listen on a separate port. Each homeserver can handle end-to-end
encryption for multiple users. The configuration file format is specified in pantalaimon(5), the default
location of the configuration file can be found in the “FILES” section.
Options
The command line flags to change the behaviour of pantalaimon are as follows:
-c, --configfile
Use the supplied file as the configuration file instead of the default one.
--log-levellevel
Set the log level of the daemon, can be one of error, warning, info, debug. Defaults to warning.
--data-pathpath
Set the directory for the pantalaimon database. This config option takes precedence over the XDG
environment variables.
--version
Display the version number and exit.
--help Display the help and exit.