woodstar

module
v0.1.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 17, 2026 License: Apache-2.0

README

Woodstar ⭐️

Self-hosted macOS management for the gaps Intune leaves: Munki for software and patching, Santa for what's allowed to run, and osquery for inventory. Built at Woodleigh to fill the holes after moving Mac management from Jamf to Intune.

Quick start

brew install mise
mise trust
mise install
mise run deps

Run against local Postgres:

docker compose up -d postgres

WOODSTAR_DATABASE_URL='postgres://woodstar:woodstar@localhost:5432/woodstar?sslmode=disable' \
WOODSTAR_PUBLIC_URL='http://localhost:8080' \
WOODSTAR_SESSION_SECRET='replace-with-at-least-32-characters' \
  mise exec -- go run ./cmd/woodstar serve

Documentation

The full documentation is a Docusaurus site under docs/: how it fits together, the agent protocols, configuration, AutoPkg, and a generated API reference. Start with docs/content/intro.md.

Directories

Path Synopsis
cmd
woodstar command
internal
agentauth
Package agentauth manages shared secrets accepted by agent-facing protocols.
Package agentauth manages shared secrets accepted by agent-facing protocols.
api
Package api wires Woodstar's HTTP server and app API surface.
Package api wires Woodstar's HTTP server and app API surface.
auth
Package auth handles setup, login, API keys, and sessions.
Package auth handles setup, login, API keys, and sessions.
enrollment
Package enrollment owns shared host-enrollment primitives.
Package enrollment owns shared host-enrollment primitives.
httpx
Package httpx provides helpers for raw net/http endpoints that bypass Huma.
Package httpx provides helpers for raw net/http endpoints that bypass Huma.
logging
Package logging configures the application's slog logger.
Package logging configures the application's slog logger.
munki/clientresources
Package clientresources owns Munki's singleton Managed Software Center branding archive.
Package clientresources owns Munki's singleton Managed Software Center branding archive.
munki/mdp
Package mdp manages Munki distribution points: ordered mirror nodes that Woodstar redirects Munki clients to for package installers.
Package mdp manages Munki distribution points: ordered mirror nodes that Woodstar redirects Munki clients to for package installers.
munki/mdp/grant
Package grant mints and verifies Munki distribution point download grants.
Package grant mints and verifies Munki distribution point download grants.
munki/mdp/protocol
Package protocol serves the Munki distribution point worker protocol.
Package protocol serves the Munki distribution point worker protocol.
munki/mdp/worker
Package worker runs the `woodstar mdp` face: it mirrors the desired Munki package installers from Woodstar, verifies them, reports its state, and serves them under per-DP grants.
Package worker runs the `woodstar mdp` face: it mirrors the desired Munki package installers from Woodstar, verifies them, reports its state, and serves them under per-DP grants.
munki/objectupload
Package objectupload ingests objects into the Munki repository.
Package objectupload ingests objects into the Munki repository.
munki/protocol
Package protocol exposes Munki repository endpoints.
Package protocol exposes Munki repository endpoints.
openapischema
Package openapischema provides Huma schema helpers for API-facing model metadata.
Package openapischema provides Huma schema helpers for API-facing model metadata.
orbit/protocol
Package protocol exposes Orbit endpoints.
Package protocol exposes Orbit endpoints.
osquery
Package osquery implements service behavior for Orbit-managed osquery.
Package osquery implements service behavior for Orbit-managed osquery.
osquery/checks
Package checks persists query-backed pass/fail policies and per-host results.
Package checks persists query-backed pass/fail policies and per-host results.
osquery/livequery
Package livequery runs ephemeral browser-session live queries in-process.
Package livequery runs ephemeral browser-session live queries in-process.
osquery/protocol
Package protocol exposes osquery TLS-plugin endpoints.
Package protocol exposes osquery TLS-plugin endpoints.
randtoken
Package randtoken creates URL-safe random tokens.
Package randtoken creates URL-safe random tokens.
santa/protocol
Package protocol exposes Santa sync endpoints.
Package protocol exposes Santa sync endpoints.
storage
Package storage is woodstar's blob store: a small backend-agnostic interface over local files or S3, plus a database registry of the objects it holds.
Package storage is woodstar's blob store: a small backend-agnostic interface over local files or S3, plus a database registry of the objects it holds.
storage/capability
Package capability signs and verifies short-lived HMAC transfer tokens.
Package capability signs and verifies short-lived HMAC transfer tokens.
validation
Package validation provides the shared structural validation boundary.
Package validation provides the shared structural validation boundary.
webui
Package webui serves the embedded Woodstar frontend.
Package webui serves the embedded Woodstar frontend.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL