meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
fractal [2020/08/15 09:20]
linmob Added instructions for setting up Pantalaimon
fractal [2020/10/15 10:44] (current)
a-wai Update pantalaimon instructions
Line 47: Line 47:
 Pantalaimon works as the "good man in the middle",​ between your client and the Matrix Server. It deals with de- & encryption and forwards the unencrypted messages to Fractal (or encrypted ones to the room). This also works with media. Pantalaimon works as the "good man in the middle",​ between your client and the Matrix Server. It deals with de- & encryption and forwards the unencrypted messages to Fractal (or encrypted ones to the room). This also works with media.
  
-Pantalaimon is a daemon, written in Python, that can directly run as a systemd process on Mobian. ​It can be installed with pip (''​sudo apt install python3-pip''​). The setup is a bit trickyhowever and the [[https://​github.com/​matrix-org/​pantalaimon/​|Repository'​s notes]] do not go into great detail.+Pantalaimon is a daemon, written in Python, that can directly run as a systemd process on Mobian.. The setup is a bit tricky howeverand the [[https://​github.com/​matrix-org/​pantalaimon/​|Repository'​s notes]] do not go into great detail.
  
 === Setting up Pantalaimon === === Setting up Pantalaimon ===
  
 It's recommended to do this via SSH, as it involves a lot of copying and typing. It's recommended to do this via SSH, as it involves a lot of copying and typing.
- 
-== Enable the sid-repo ==  
- 
-Just follow the [[https://​wiki.mobian-project.org/​doku.php?​id=tweaks&​s[]=sid#​add-sid-repository|instructions]] (make sure to not forget setting the priorities). 
-Afterwards ''​sudo apt update''​. 
  
 == Install Pantalaimon == == Install Pantalaimon ==
Line 79: Line 74:
 ListenAddress = localhost ListenAddress = localhost
 ListenPort = 8009 ListenPort = 8009
-SSL = False 
 # UseKeyring = True # UseKeyring = True
 # IgnoreVerification = True # IgnoreVerification = True
Line 90: Line 84:
 == Optional: systemd service == == Optional: systemd service ==
  
-Optional: In order to start pantalaimon automatically via systemd, ​create a file pantalaimon.service ​in /lib/​systemd/​user/​pantalaimon.service+Optional: In order to start pantalaimon automatically via systemd, ​copy the sample service ​file provided by the package (''/​usr/​share/​doc/​pantalaimon/​examples/​pantalaimon.service''​) into ''​/etc/​systemd/​user/​''​.
  
 +Then execute the following commands to reload the systemd daemon and start the service:
 +<​code>​
 +systemctl --user daemon-reload
 +systemctl --user enable --now pantalaimon.service
 +</​code>​
 +
 +== Log In ==
 +
 +In Fractal, set your homeserver to ''​http://​localhost:​8009''​ (if you set a different ListenPort, you need to adjust it here, too) and login with your username and password. To access encrypted messages from other devices/​sessions,​ you will need to establish trust on your other logged in Matrix clients.
 +
 +== Troubleshooting:​ CPU spikes ==
 +
 +When using Pantalaimon through the systemd service, it is always running in the background, even if you do not actively using Fractal (or any other Matrix client). This can become a CPU hog, if you receive a lot of encrypted messages or media and drain your battery. There is no concrete solution to this, but you can work around it by limiting the CPU power dedicated to the Pantalaimon process:
 +
 +Install the cpulimit tool:
 +<​code>​
 +sudo apt install cpulimit
 +</​code>​
 +
 +Edit your systemd service file, described above to:
 <​code>​ <​code>​
 [Unit] [Unit]
Line 97: Line 111:
  
 [Service] [Service]
-ExecStart=/​usr/​bin/​pantalaimon+ExecStart=/​usr/​bin/​cpulimit --limit=25 --lazy --foreground -- /​usr/​bin/​pantalaimon
  
 [Install] [Install]
Line 103: Line 117:
 </​code>​ </​code>​
  
-and start the service ​with ''​systemctl --user ​enable ​--now pantalaimon.service''​. ​ +Then reload the systemd daemon ​and restart ​the service
- +<​code>​ 
-== Log In == +systemctl --user ​daemon-reload 
- +systemctl ​--user restart ​pantalaimon.service 
-In Fractal, set your homeserver to ''​http:​//​localhost:​8009''​ (if you set a different ListenPort, you need to adjust it here, too) and login with your username and password. To access encrypted messages from other devices/​sessions,​ you will need to establish trust on your other logged in Matrix clients. +</code>