Skip to content

Workstation Overview

In addition to the core hardware scripts, the repository includes a suite of workstation provisioning scripts located in the workstation/ directory.

Available Modules

ScriptPurposeStatusRun AsDocs
05-desktop-base.shDesktop FoundationRecommendedsudoReference
00-ai-dev-workstation.shAI/LLM & Dev StackOptionalsudoReference
10-gnome-productivity.shGNOME Speed & UI TweaksOptionalUserReference
20-devops-tools.shK8s & Terraform StackOptionalsudoReference
30-security-tools.shFirewall & SecretsOptionalsudoReference
40-dotfiles-link.shSymbolic Config LinksOptionalUserReference
50-mise-plugins.shMise Plugin InfrastructureOptionalUserReference

Integration

Workstation scripts run independently via their Makefile targets (e.g., make ai-dev, make mise-plugins). The interactive Iceunit installer (make install) handles core hardware scripts only. Run workstation modules individually or in sequence as needed.

Design Principles

  • Developer First: Tools are chosen for modern, high-performance engineering workflows.
  • System-Aware: Scripts detect existing configurations and skip redundant steps.
  • Idempotent: Safe to run multiple times without side effects.