[feature] Allow root installation for SAF K1 environment (#613)

Updates the installer to support SAF K1 environments by permitting root execution when K1 OS is detected.

Author: ejsears

CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2026-01-22]
+### Changed:
+- The install-afc.sh script will now allow users to install as root if it detects the user is running a SAF K1 environment.
+
 ## [2026-01-15]
 ### Added:
 - The afc-debug.sh script will now upload the AFC statistics from moonraker for easier troubleshooting.

include/check_commands.sh

@@ -24,6 +24,12 @@ check_root() {
   # If the script is run as root, it prints an error message and exits with status 1.
   # This is to ensure the script is run by a normal user for security reasons.
 
+  check_for_k1
+  # On K1 OS, allow running as root but warn the user instead of exiting.
+  if [ "$is_k1_os" == "True" ] && [ "$EUID" -eq 0 ]; then
+    print_msg WARNING "K1 OS detected, skipping root user check."
+    return
+  fi
   if [ "$EUID" -eq 0 ]; then
     print_msg ERROR "  Do not run as root, use a normal user"
     exit 1

include/constants.sh

@@ -37,6 +37,7 @@ installation_options=("BoxTurtle (4-Lane)" "BoxTurtle (8-Lane)" "NightOwl" "HTLF
 invalid_name="False"
 minimum_python_major="3"
 minimum_python_minor="8"
+is_k1_os="False"
 
 # AFC default configs
 park_macro="True"

include/utils.sh

@@ -219,4 +219,10 @@ del_var_file() {
     fi
   fi
   export unit_message
+}
+
+check_for_k1() {
+  if grep -Fqs "ID=buildroot" /etc/os-release; then
+    is_k1_os="True"
+  fi
 }

install-afc.sh

@@ -60,13 +60,12 @@ main() {
   moonraker_config_file="${printer_config_dir}/moonraker.conf"
   afc_path="$HOME/AFC-Klipper-Add-On"
 
-
   # Make sure necessary directories exist
-  echo "Ensuring we are not running as root.."
+  echo "Ensuring we are not running as root (except on K1 OS)..."
   check_root
-  echo "Ensuring no conflicting software is present.."
+  echo "Ensuring no conflicting software is present..."
   check_for_hh
-  echo "Checking to ensure crudini and jq are present.."
+  echo "Checking to ensure crudini and jq are present..."
   check_for_prereqs
   if [ "$test_mode" == "False" ]; then
     check_python_version