Pantalaimon: Difference between revisions
m (Added Categories: Instant Messaging (please amend if inappropriate, Alpine_Linux:IRC is another new member of this tentative new category), Security) |
(1. Pantalaimon indicated to be in testing; need to tag the repo; 2. Style/grammar amendments.) |
||
| Line 3: | Line 3: | ||
== Installation == | == Installation == | ||
Pantalaimon and its auxiliary packages are only available from Edge's testing repository as of December 2025. Therefore, they are unsupported and intended for testing only but could be installed on Edge and on other releases by first [[Repositories#Using_testing_repository|enabling and tagging the testing repo]]. | |||
Pantalaimon could then be installed as follows: | |||
{{Cmd|$ doas add pantalaimon}} | |||
The <code>panctl</code> command line tool is in the {{Pkg|pantalaimon-ui}} package. | |||
== Quickstart == | == Quickstart == | ||
There are two ways pantalaimon can be used: the first is to allow a bot access to an encrypted room | There are two ways in which pantalaimon can be used: the first is to allow a bot access to an encrypted room; and the second is to allow a human to access an encrypted room with a client that doesn't support end-to-end encryption yet. This wiki page currently only covers the second use case. | ||
First, create a | First, create a configuration file for pantalaimon at {{path|~/.config/pantalaimon/pantalaimon.conf}}: | ||
[MyMatrixServer] | [MyMatrixServer] | ||
| Line 18: | Line 21: | ||
This is the minimal configuration file, but <code>man 5 pantalaimon</code> will allow you to explore the various options. | This is the minimal configuration file, but <code>man 5 pantalaimon</code> will allow you to explore the various options. | ||
Then launch <code>pantalaimon</code> as your user. You can then control it through dbus using <code>panctl</code>. | Then, launch <code>pantalaimon</code> as your user. You can then control it through '''dbus''' using <code>panctl</code>. | ||
You should then log in using your regular Matrix client | You should then log in using your regular Matrix client with <code><nowiki>http://localhost:8009</nowiki></code> as your server. | ||
== Related links == | == Related links == | ||
* [https://github.com/matrix-org/pantalaimon/tree/master/README.md | * [https://github.com/matrix-org/pantalaimon/tree/master/README.md The upstream README] | ||
* [https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/8689 | * [https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/8689 The initial MR] | ||
[[Category:Instant Messaging]] | [[Category:Instant Messaging]] | ||
[[Category:Security]] | [[Category:Security]] | ||
Revision as of 02:21, 28 December 2025
Pantalaimon is a Matrix proxy that handles end-to-end encryption support.
Installation
Pantalaimon and its auxiliary packages are only available from Edge's testing repository as of December 2025. Therefore, they are unsupported and intended for testing only but could be installed on Edge and on other releases by first enabling and tagging the testing repo. Pantalaimon could then be installed as follows:
$ doas add pantalaimon
The panctl command line tool is in the pantalaimon-ui package.
Quickstart
There are two ways in which pantalaimon can be used: the first is to allow a bot access to an encrypted room; and the second is to allow a human to access an encrypted room with a client that doesn't support end-to-end encryption yet. This wiki page currently only covers the second use case.
First, create a configuration file for pantalaimon at ~/.config/pantalaimon/pantalaimon.conf:
[MyMatrixServer] Homeserver = https://matrix.myserver.xyz ListenAddress = localhost ListenPort = 8009
This is the minimal configuration file, but man 5 pantalaimon will allow you to explore the various options.
Then, launch pantalaimon as your user. You can then control it through dbus using panctl.
You should then log in using your regular Matrix client with http://localhost:8009 as your server.