woodstar

module
v0.1.2 Latest Latest
Warning

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

Go to latest
Published: Jun 1, 2026 License: Apache-2.0

README

Woodstar ⭐️

Woodstar is a self-hosted macOS observability and admin surface built around Orbit/osquery first, with Santa and Munki (server) as first class modules.

Development

brew install mise
mise trust
mise install
mise run deps
mise run test
mise run backend

Run locally with Postgres:

docker compose up -d postgres

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

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 the HTTP server.
Package api wires the HTTP server.
api/handlers
Package handlers registers Huma operations for the admin API.
Package handlers registers Huma operations for the admin API.
auth
Package auth handles setup, login, API keys, and sessions.
Package auth handles setup, login, API keys, and sessions.
directory
Package directory syncs people and groups from an identity provider.
Package directory syncs people and groups from an identity provider.
httpjson
Package httpjson provides small JSON helpers for raw net/http endpoints.
Package httpjson provides small JSON helpers for raw net/http endpoints.
logging
Package logging sets up slog.
Package logging sets up slog.
munki/protocol
Package protocol exposes Munki repository endpoints.
Package protocol exposes Munki repository endpoints.
munki/storage
Package storage signs Munki artifact storage URLs.
Package storage signs Munki artifact storage URLs.
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-scoped live queries in-process.
Package livequery runs ephemeral browser-scoped 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.
web
Package web serves the embedded Woodstar frontend.
Package web serves the embedded Woodstar frontend.

Jump to

Keyboard shortcuts

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