woodstar βοΈ
Manages macOS devices with Munki, Santa, and Orbit/osquery.
[!WARNING]
This project may be unstable or have bugs, use with caution.
Also expect breaking changes between releases for now.
π± What's inside
- Host enrollment, hardware, software, users, and query results
- Munki repositories, manifests, packages, and assignments
- Santa rules, client configuration, sync, and events
- osquery reports, checks, live queries, and dynamic labels
- Entra directory sync for people, groups, and user affinity
- Distribution-point workers for local package delivery
π Usage
Start with the example environment and a storage capability key:
cp .env.example .env
openssl rand -hex 32
docker compose up -d
docker compose exec woodstar /woodstar user create \
--email you@example.com \
--name "Your Name" \
--role admin
Compose uses the published rolling image. The Docker Compose guide covers certificates, hostnames, storage, and first sign-in.
βοΈ Configuration
The documentation covers configuration, client protocols, AutoPkg, and the API.
Use the environment reference and storage guide for deployment settings.
π§βπ» Development
Mise owns the toolchain and commands:
mise install
mise run dev
mise run test
mise run lint
Backend code lives under cmd/woodstar and internal/; the React app lives under web/; the documentation site lives under docs/.
See the development setup and command reference for PostgreSQL, end-to-end, storage, generation, and docs workflows.
π License
Licensed under the Apache License 2.0.
π Acknowledgments
- Munki - Managed software installation for macOS
- MunkiAdmin - Graphical editor for Munki repositories
- AutoPkg - Automation framework for macOS software packaging
- Santa - Binary authorization and endpoint security for macOS
- osquery - SQL-powered operating system instrumentation
- Fleet - Open-source device management platform and home of Orbit
- Zentral - Event-driven platform for endpoint management