This repository provides an automated way to repackage the official Ubiquiti WiFiman Desktop .deb installer into a Fedora-compatible .rpm package. It specifically addresses common issues like directory conflicts and SELinux denials that prevent Teleport (VPN) from working on RHEL-based systems.
The official WiFiman Desktop is only provided as a Debian package. Converting it using tools like alien often results in:
- Directory Conflicts: Errors during installation regarding /usr/bin, /usr/lib, etc.
- SELinux Denials: Teleport (WireGuard) failing to initialize because the binaries lack the correct security context.
- Broken Systemd Integration: Services being placed in non-standard locations.
Automated CI/CD: Triggered by simply dropping a .deb file into the deb/ folder.
- Clean RPM Structure: No system directory ownership conflicts.
- SELinux Ready: Automatically applies unconfined_exec_t to the daemon and WireGuard binaries via %post scripts.
- Systemd Support: Correctly installs and enables the wifiman-desktop.service.
- Build your own
- Clone this repository.
- Download the latest .deb from Ubiquiti Downloads.
- Place the .deb file in the deb/ directory.
- Push the changes to GitHub:
git add deb/*.deb
git commit -m "Upload WiFiman v1.2.8"
git push origin master
- GitHub Actions will trigger, build the RPM, and create a new Release with the .rpm file attached.
- Installation
Download the .rpm from the Releases tab and install it:
sudo dnf install ./wifiman-desktop-1.2.8-1.fcXX.x86_64.rpm
To allow Teleport to create tunnels and manage network interfaces, the RPM applies the following labels during installation:
-
/usr/lib/wifiman-desktop/wifiman-desktopd -> unconfined_exec_t -
/usr/lib/wifiman-desktop/wireguard-go -> unconfined_exec_t
This allows the daemon to transition to a domain with sufficient privileges to manage WireGuard interfaces without disabling SELinux.
The CI/CD workflow avoids alien to ensure a clean build:
- Extracts the .deb using ar and tar.
- Reconstructs the file tree in a Fedora-compliant way.
- Uses rpmbuild with a custom .spec file to generate the final package.
This project is not affiliated with Ubiquiti. WiFiman is proprietary software owned by Ubiquiti Inc. This repository only contains the build logic to repackage the software for personal use on Fedora Linux.
- Software Ownership: WiFiman and WiFiman Desktop are proprietary software owned by Ubiquiti Inc.. This repository is not affiliated with, sponsored by, or endorsed by Ubiquiti.
- Purpose: This project is intended for personal use and interoperability purposes only. It provides scripts to repackage an officially downloaded Debian package into an RPM format for use on Fedora Linux.
- Distribution: This repository does not host the WiFiman source code. Any binaries produced by these scripts contain proprietary code. Users are responsible for complying with Ubiquiti's End User License Agreement (EULA).
- No Warranty: The build scripts are provided "as is" under the MIT License. Use them at your own risk.