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) |
(Added the requirement to tag the packages with @testing) |
||
| (One intermediate revision by the same user not shown) | |||
| 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@testing}} | |||
The <code>panctl</code> command line tool is in the {{Pkg|pantalaimon-ui}} package, which could be installed similarly, using the {{ic|@testing}} tag. | |||
== 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]] | ||
Latest revision as of 02:26, 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@testing
The panctl command line tool is in the pantalaimon-ui package, which could be installed similarly, using the @testing tag.
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.