woodstar

module
v0.8.6 Latest Latest
Warning

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

Go to latest
Published: Aug 9, 2026 License: Apache-2.0

README ΒΆ

Woodstar ⭐️

Self-hosted macOS management for the gaps Intune leaves. Woodstar brings together Munki for software, Santa for execution policy, and Orbit with osquery for enrollment, inventory, and checks.

[!WARNING] This project may be unstable or have bugs, use with caution. Also expect breaking changes between releases for now.

🌱 What's inside

  • Hosts and inventory from Orbit or osquery, with hardware, software, users, and query results in one place.
  • Munki manifests, catalogs, packages, icons, client resources, and software assignments.
  • Santa rules, client configuration, sync, and execution events.
  • osquery reports, scheduled checks, live queries, and dynamic labels.
  • Labels shared across software, rules, reports, and checks.
  • Entra directory sync for people, groups, user affinity, and label membership.

🏑 Running Locally

Start with the example environment and a storage capability key:

cp .env.example .env
openssl rand -hex 32

Add the generated key to WOODSTAR_STORAGE_CAPABILITY_KEY, check the URL and certificate paths, then start Woodstar and PostgreSQL:

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. Uncomment the build block in docker-compose.yml to build the current checkout instead.

The Docker Compose guide covers certificates, hostnames, storage, and first sign-in.

πŸ“š Documentation

The Woodstar docs cover the web app, configuration, client protocols, AutoPkg, and the API. For code changes, head to the development setup and command reference.

πŸ§‘β€πŸ’» Development

mise owns the toolchain and everyday 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 full command list includes the PostgreSQL, end-to-end, and storage integration lanes.

🀝 Contributing

Contributions are welcome! Please open an issue before starting a larger change.

πŸ“„ License

Woodstar is licensed under the Apache License 2.0 - see the LICENSE file for details.

πŸ™ 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

Jump to

Keyboard shortcuts

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