Files
blueonyx/PLAN.md
casjay 15546d0a85
Some checks are pending
blueonyx / release-blueonyx (push) Waiting to run
🔧 Fix blueonyx build scripts and add CLAUDE.md + PLAN.md 🔧
Fix two build-breaking issues in setup scripts and update BUILD_DATE.
Add repo documentation files.
- Dockerfile: update BUILD_DATE from 202509161146 to 202605131434
- rootfs/root/docker/setup/02-packages.sh: remove broken reboot and sudo dnf commands that abort Docker build; BlueOnyx installation is done in 05-custom.sh
- rootfs/root/docker/setup/03-files.sh: remove irrelevant incus binary download from GitHub (fails in buildx sandbox; unrelated to BlueOnyx)
- CLAUDE.md: new file documenting systemd-container architecture, build notes, runtime requirements, and env vars
- PLAN.md: new file documenting migration steps, build command, smoke test procedure

CLAUDE.md
Dockerfile
PLAN.md
rootfs/root/docker/setup/02-packages.sh
rootfs/root/docker/setup/03-files.sh
2026-05-13 15:59:51 -04:00

49 lines
1.5 KiB
Markdown

# blueonyx Migration Plan
## Status: In Progress
## Architecture decision
BlueOnyx is a full RHEL-based server control panel that requires systemd.
- Base: `almalinux/10-init` (systemd-enabled AlmaLinux 10)
- Single-stage build (no FROM scratch stripping)
- CMD: `/sbin/init` (systemd as PID 1)
- No tini entrypoint; no init.d framework
- amd64 only
## Steps
- [x] Read existing Dockerfile and all setup scripts
- [x] Identify and fix `02-packages.sh` (remove `reboot`, `sudo dnf` lines)
- [x] Identify and fix `03-files.sh` (remove irrelevant incus download)
- [x] Update BUILD_DATE
- [x] Create CLAUDE.md
- [ ] Build image (`docker buildx build --platform linux/amd64`)
- [ ] Smoke test (container starts, systemd runs, web UI reachable on port 444)
- [ ] Commit and push
## Build command
```bash
cd /root/Projects/github/casjaysdevdocker/blueonyx
docker buildx --builder blueonyx build \
--platform linux/amd64 \
--tag casjaysdevdocker/blueonyx:latest \
--push .
```
## Smoke test
```bash
docker run -d --privileged \
-v /sys/fs/cgroup:/sys/fs/cgroup:rw \
-p 10444:444 -p 10081:81 \
--name test-blueonyx \
casjaysdevdocker/blueonyx:latest
# Wait 30s, check systemd is running
docker exec test-blueonyx systemctl status 2>/dev/null | head -5
docker rm -f test-blueonyx
```
## Known limitations
- Build takes 20-40 minutes (900-1200 RPMs from BlueOnyx + AlmaLinux repos)
- `initServices.sh` may warn during build (no systemd at build time) — expected
- Runtime requires `--privileged` and cgroup v2 mount