https://github.com/agentstation/neovex-machine-os
Neovex machine guest OS image — Fedora bootc with neovex and container tooling pre-installed
https://github.com/agentstation/neovex-machine-os
Last synced: about 2 months ago
JSON representation
Neovex machine guest OS image — Fedora bootc with neovex and container tooling pre-installed
- Host: GitHub
- URL: https://github.com/agentstation/neovex-machine-os
- Owner: agentstation
- License: other
- Created: 2026-04-14T22:50:21.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T00:03:43.000Z (about 2 months ago)
- Last Synced: 2026-04-15T04:35:30.808Z (about 2 months ago)
- Language: Shell
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# neovex-machine-os
Guest OS image for the neovex macOS developer machine. Built on Fedora bootc
with neovex and container tooling pre-installed.
This is the neovex equivalent of
[containers/podman-machine-os](https://github.com/containers/podman-machine-os).
## What's inside
The guest image includes:
- **neovex** — the neovex server binary (from `agentstation/neovex` releases)
- **Container tooling** — crun, conmon, buildah, containers-common, netavark,
aardvark-dns, fuse-overlayfs, catatonit, passt
- **System services** — openssh-server, socat, cloud-init
The image is built from `quay.io/fedora/fedora-bootc:42` and converted to a
raw disk image via `bootc-image-builder`.
## Published artifacts
| Artifact | Location |
|----------|----------|
| Raw-disk OCI image | `ghcr.io/agentstation/neovex-machine-os` |
| Build provenance | GitHub Attestations (via `actions/attest`) |
## Building locally
Requires a Linux host with podman and root access:
```bash
# Download a neovex binary first
curl -fsSL -o /tmp/neovex \
https://github.com/agentstation/neovex/releases/latest/download/neovex_linux_arm64.tar.gz
sudo bash scripts/build.sh \
--neovex-binary /tmp/neovex \
--output-dir /tmp/neovex-machine-os
```
## CI
The GitHub Actions workflow (`.github/workflows/build.yml`) runs on
`ubuntu-24.04-arm` and:
1. **verify-contract** — script syntax, help entrypoints, deterministic
helper tests
2. **build-arm64** — downloads the neovex binary from GitHub Releases,
builds the guest image, packages as OCI layout, publishes to GHCR on
`v*` tags with attestation
Triggered by pushes to main (path-filtered), `v*` tags, and
`workflow_dispatch`.
## License
See [LICENSE](LICENSE).