Wireguard and wifiman-desktop Installation Guide for Fedora

This guide provides step-by-step instructions for installing and running wifiman-desktop (originally distributed as a .deb package) on Fedora, including troubleshooting for common dependency and SELinux issues.

This guide was created on Fedora 42 with WIFIman 1.1.3.

---

1. Download the original deb file

First download the deb file from UniFi.

---

2. Install Required Tools

Install alien to convert .deb packages to .rpm:

sudo dnf install -y alien rpmrebuild

---

3. Convert the .deb Package to .rpm

Replace the filename as needed:

sudo alien -r --scripts wifiman-desktop-1.1.3-amd64.deb

---

4. Rebuild the RPM Package

This step allows you to remove problematic file entries from the package:

rpmrebuild -pe wi-fiman-desktop-1.1.3-2.x86_64.rpm

During the interactive editor step, remove entries related to /usr, /usr/bin, and /usr/lib as needed.

---

5. Install the Rebuilt RPM Package

Update the package dependencies and WIFIman itself:

sudo dnf install -y webkit2gtk4.0 libayatana-appindicator-gtk3
sudo rpm -i ~/rpmbuild/RPMS/x86_64/wi-fiman-desktop-1.1.3-2.x86_64.rpm

---

6. Launch wifiman-desktop

Via desktop launcher or via

wi-fiman-desktop

---

7. Resolve SELinux Errors

If journalctl -xe shows SELinux errors for the wifiman service, then adjust selinux context:

sudo semanage fcontext -a -t bin_t "/usr/lib/wi-fiman-desktop/wifiman-desktopd"
sudo restorecon -v /usr/lib/wi-fiman-desktop/wifiman-desktopd
sudo systemctl daemon-reload
sudo systemctl restart wifiman-desktop.service

---

8. Log In and Enable Teleport

At this point, you should be able to use wifiman-desktop on Fedora!

If you get no Internet connection on the first try, disable teleport and enable it again.