> ## Documentation Index
> Fetch the complete documentation index at: https://www.halite-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Halite

<div style={{ textAlign: "center", marginTop: "0.25rem", marginBottom: "1.5rem" }}>
  <img className="block dark:hidden" src="https://mintcdn.com/acme-7a2b8e9d/Q6c81eBXgu_wstgA/logo/lockup-horizontal-light.svg?fit=max&auto=format&n=Q6c81eBXgu_wstgA&q=85&s=0619e049e1b21840b07b9db1744a1eba" alt="Halite" noZoom style={{ width: "460px", maxWidth: "100%" }} width="880" height="280" data-path="logo/lockup-horizontal-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/acme-7a2b8e9d/Q6c81eBXgu_wstgA/logo/lockup-horizontal.svg?fit=max&auto=format&n=Q6c81eBXgu_wstgA&q=85&s=00dabb90c6527caf833e595bb4d8a13a" alt="Halite" noZoom style={{ width: "460px", maxWidth: "100%" }} width="880" height="280" data-path="logo/lockup-horizontal.svg" />
</div>

Halite is a self-hosted web console that manages a SaltStack deployment end-to-end from one UI — covering minion status, key management, job dispatch, a live activity feed, package inventory, fleet health, and user access control, all in a single browser tab.

<Card horizontal icon="play" href="https://demo.halite-app.com" title="Try the live demo">
  Explore a fully functioning Halite instance at [demo.halite-app.com](https://demo.halite-app.com), backed by a simulated Salt deployment — no install required.
</Card>

## Why "Halite"?

Halite (/ˈheɪlaɪt/) is the mineralogical name for rock salt — sodium chloride in its natural crystalline form. The mineral grows in perfect cubes, with sodium and chloride ions locked in a regular three-dimensional lattice. That structure mirrors the topology of a SaltStack deployment: a master at the center orchestrating a constellation of minions arranged across the network. The same diagram you would draw for an NaCl unit cell is the diagram you would draw for a Salt master surrounded by its minions.

<Frame caption="Halite dashboard overview">
  <img src="https://mintcdn.com/acme-7a2b8e9d/4xzIOjqA4Plf6uKO/images/index-dashboard-v2.png?fit=max&auto=format&n=4xzIOjqA4Plf6uKO&q=85&s=95f7c611a2b11ad1320e9a5f2edd11d7" alt="Halite dashboard showing KPIs, minion-status donut, 24-hour job-activity chart, and key-status bar" width="5486" height="3856" data-path="images/index-dashboard-v2.png" />
</Frame>

## Features

<CardGroup cols={2}>
  <Card title="Overview" icon="gauge" href="/features/overview">
    KPIs (online minions, pending keys, running jobs, jobs in 24h) plus interactive charts. Auto-refreshes every 30 seconds.
  </Card>

  <Card title="Activity" icon="activity" href="/features/activity">
    A live feed of Salt event-bus activity — jobs, keys, and minions — streamed straight to your browser.
  </Card>

  <Card title="Minions" icon="server" href="/features/minions">
    Live status of every connected minion, with grains drilled down on demand.
  </Card>

  <Card title="Keys" icon="key" href="/features/keys">
    Accept, reject, or delete pending minion keys.
  </Card>

  <Card title="Jobs" icon="list-checks" href="/features/jobs">
    Browse recent jobs, inspect per-minion results with highstate parsing, and kill running jobs mid-flight.
  </Card>

  <Card title="Timeline" icon="chart-gantt" href="/features/timeline">
    A visual grid of recent job activity over a time window, grouped by function or user and colored by category.
  </Card>

  <Card title="Run" icon="terminal" href="/features/run">
    Dispatch any Salt execution module function against any target, with full target-type support.
  </Card>

  <Card title="Inventory" icon="package" href="/features/inventory">
    3-level drill-down through installed packages across the fleet (package → versions → installed-on, or minion → packages).
  </Card>

  <Card title="Fleet Health" icon="heart-pulse" href="/features/fleet">
    Fleet-wide highstate health derived from recent job history.
  </Card>

  <Card title="Users & Roles" icon="users" href="/features/users-roles">
    Permission-driven access with built-in admin / operator / viewer roles plus arbitrary custom roles using verb:resource permission globs.
  </Card>
</CardGroup>

<Card horizontal icon="rocket" href="/quickstart" title="Quickstart">
  Run Halite with Docker in minutes.
</Card>