K3s Linux Toggle

A lightweight, system-agnostic desktop toggle for K3s (Kubernetes).

Why?

Running a Kubernetes cluster (even a light one like K3s) consumes background resources (CPU/RAM). This tool gives you a Physical Switch on your Linux desktop to turn K3s ON only when you need it.

• ON: Service starts, Icon turns BLUE (official K8s color) or GREEN (configurable).
• OFF: Service stops, Icon turns RED.

Features

• 🐧 Universal Linux Support: Works on Arch, Ubuntu, Fedora, Debian, Mint (any Systemd distro).
• 🎨 Dynamic Icon: The desktop icon changes color instantly to reflect the cluster state.
• 🔐 Password-less: Includes a Polkit rule so you don't need to type sudo every time.
• 🚀 Zero Dependencies: Takes 0MB of RAM when not in use (it's just a shell script).

Installation

1. Clone the repository:

   git clone https://github.com/birdman/k3s-linux-toggle.git
   cd k3s-linux-toggle

2. Run the installer:

   ./install.sh

   • First Time: You'll be asked to choose your status color (Official Blue or Neon Green).
   • Already Installed? You'll see a maintenance menu to Change Color, Update, or Uninstall.

Usage

Search for "K3s Toggle" in your application menu or look on your Desktop. Click the icon to Toggle the cluster.

• Blue/Green Wheel: Kubernetes is RUNNING.
• Red Wheel: Kubernetes is STOPPED.

Management & Uninstallation

To make changes or remove the tool, simply run ./install.sh again. It will detect your installation and offer:

1. Change Color: Switch between Blue/Green without reinstalling.
2. Reinstall / Update: Refresh the scripts from the repo.
3. Uninstall: Remove the icons, scripts, and shortcuts cleanly.