Installing the Agent: Zero Dependencies, Total Control

Installing the Agent: Zero Dependencies, Total Control

StateWarden does not require you to pre-install heavy runtimes like Java, .NET, or Python on your servers. Our Agent is written entirely in Rust and compiled directly to a standalone, zero-dependency binary. This means it has an incredibly small footprint, operates with near-zero overhead, and is memory-safe by design.

It is a lightweight daemon that runs silently in the background, governed entirely by the Control Plane (Artemis) via your Dashboard.

1. Windows Installation (The WiX Installer)

For Windows servers and workstations, StateWarden provides a streamlined MSI installer built with the WiX Toolset. It handles everything natively.

  1. Download: Grab the latest StateWarden-Installer.msi from your Dashboard.
  2. Execute: Run the installer. It automatically configures the StateWarden Launcher service (sw-launcher).
  3. The Watchdog Architecture: The sw-launcher acts as a highly resilient supervisor. It automatically ensures the core agent (sw.exe) is running and handles atomic self-updates seamlessly in the background. It serves as a Dead Man's Switch—if the primary agent encounters an issue, the launcher instantly restarts it.

2. Linux Installation (Native Daemon)

On Linux, StateWarden integrates directly with systemd to ensure it starts early in the boot process and maintains continuous uptime.

  1. Download & Execute: Run the one-line installation script provided in the Dashboard:
    bash
    curl -sL https://dist.statewarden.net/install.sh | sudo bash
  2. Systemd Integration: The script installs the binary, configures the sw-launcher systemd service, and ensures the agent starts natively (using After=local-fs.target for maximum reliability).
  3. Opt-In Capabilities: For advanced use cases, the Linux installation includes optional hooks for initramfs to enable advanced RootFS Proxy support for instant recovery.

3. The Recovery ISO (Kiosk Mode BMR)

When an entire server burns down, you don't have time to reinstall an OS just to run a backup agent. StateWarden provides the Recovery ISO.

This is a complete, bootable Alpine Linux environment (under 300MB) with the StateWarden Agent and a dedicated Text-based User Interface (TUI) pre-injected.

  • Autostart: It boots directly into "Kiosk Mode", automatically loading the Agent and the TUI.
  • Hardware Native: It gives you immediate access to raw disks (e.g., /dev/sda, \.\PhysicalDrive0) without any OS interference.
  • Bare Metal Recovery (BMR): You can restore a full system image directly to bare metal in minutes.

Was this article helpful?