From 9d943bdce003430c56ce7eafa4c9a640ffa777d0 Mon Sep 17 00:00:00 2001 From: Ilya Zlobintsev Date: Tue, 6 Feb 2024 08:58:17 +0200 Subject: [PATCH] doc: add socket permission notes to README (#260) --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 25e3b7e..da7fae8 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,16 @@ sudo systemctl enable --now lactd ``` You can now use the GUI to change settings and view information. +**Socket permissions setup:** + +By default, LACT uses either ether the `wheel` or `sudo` group (whichever is available) for the ownership of the unix socket that the GUI needs to connect to. + +On most configurations (such as the default setup on Arch-based, most Debian-based or Fedora systems) you do not need to do anything. + +However, some systems may have different user configuration. In particular, this has been reported to be a problem on OpenSUSE. + +To fix socket permissions in such configurations, edit `/etc/lact/config.yaml` and add your username or group as the first entry in `admin_groups` under `daemon`, and restart the service (`sudo systemctl restart lactd`). + # Configuration There is a configuration file available in `/etc/lact/config.yaml`. Most of the settings are accessible through the GUI, but some of them may be useful to be edited manually (like `admin_groups` to specify who has access to the daemon)