🛠️ Workstation Starter Kit

By friends, for friends—now for everyone.

Setting up a Linux workstation shouldn't be a chore. This project started as a simple script to help friends get their Fedora 43 KDE systems up and running perfectly. Today, it’s a fully-fledged GTK application designed to automate the "boring stuff" while keeping your system secure and lean.

Key Features:

One-Click Setup: From gaming essentials to developer environments.

Fedora-Centric: Optimized for Fedora 43’s specific repos and packages.

Safe Execution: Uses a Polkit-authorized backend to ensure you stay in control of system changes.

---

📚 Quick Navigation

• 🚀 Quick Start
• 📦 Installation Methods
• 🧩 Supported Platform
• 🧰 Included Features
• 🔐 Privilege & Security Model
• ❓ FAQ
• 📜 License

---

🚀 Quick Start (Recommended)

1️⃣ Download the RPM

Go to the project releases page:

https://github.com/KernelChief/Workstation-Starter-Kit/releases

Download the RPM named like:

• workstation-starter-kit-X.X.X-X.fc43.noarch.rpm

Where:

• X.X.X = app version
• -X = RPM release number

---

2️⃣ Install the RPM

From the directory where the file was downloaded:

sudo dnf install ./workstation-starter-kit-X.X.X-X.fc43.noarch.rpm

This installs:

• the GUI launcher (workstation-starter-kit)
• the helper (/usr/libexec/workstation-starter-kit-helper)
• the polkit policy
• the desktop entry

---

3️⃣ Launch the App

Launch from app menu:

• Workstation Starter Kit

Or via terminal:

workstation-starter-kit

---

📦 Installation Methods

Depending on feature, Workstation Starter Kit uses:

• DNF package installs/removals
• Official URL RPM installs (e.g. Chrome, Zoom)
• Flatpak installs (user or system scope)
• COPR enable + package install for selected tools
• Service enable/disable via systemctl
• System config actions (e.g. ZRAM profile, SELinux mode)

---

🧩 Supported Platform

• Primary target: Fedora 43 KDE Workstation
• Best effort: Other RPM-based distributions using dnf

---

🧰 Included Features

Includes install/remove workflows for:

• Essential and Monitoring setup bundles
• SELinux helper flow (including enforcing → permissive/disabled prompt)
• ZRAM profile
• 1Password, Proton Pass, Tailscale
• Gaming stack (Steam, Lutris, Wine, GameMode, Gamescope, MangoHud, GOverlay, etc.)
• Utility/media apps (OBS Studio, VLC, Btrfs Assistant, Distrobox, Chrome, Zoom)
• Flatpak apps (Spotify, LibreOffice, Discord, Slack, Mattermost, Boxflat, BoxBuddy)

The in-app list is the source of truth.

---

🔐 Privilege & Security Model

• GUI process runs as normal user
• Privileged actions are routed through:
  • pkexec /usr/libexec/workstation-starter-kit-helper ...
• Polkit action:
  • org.workstationstarterkit.manager
• Authentication is requested only when needed

---

❓ FAQ

Why does it ask for admin credentials?
Installing/removing packages, editing system config, and enabling services require elevated privileges.

Does the app itself run as root?
No. The UI is unprivileged; only helper actions are elevated through polkit.

Can I apply items one-by-one instead of bundles?
Yes. Every listed feature/app can be installed or removed individually.

What if I only want Flatpak apps?
You can install only Flatpak rows; each prompts for user/system scope.

---

🤝 Community

• Code of Conduct
• Contributing
• Maintainer/developer workflow: see CONTRIBUTING.md

---

📜 License

This project is licensed under the GNU GPL v3.0. See LICENSE.