casjaysdevdocker/blueonyx

Fork 0

mirror of https://github.com/casjaysdevdocker/blueonyx synced 2026-05-15 02:47:44 -04:00

Files

casjay 15546d0a85

blueonyx / release-blueonyx (push) Waiting to run

Details

🔧 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

1.5 KiB

Raw Permalink Blame History

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

Read existing Dockerfile and all setup scripts
Identify and fix 02-packages.sh (remove reboot, sudo dnf lines)
Identify and fix 03-files.sh (remove irrelevant incus download)
Update BUILD_DATE
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

cd /root/Projects/github/casjaysdevdocker/blueonyx
docker buildx --builder blueonyx build \
  --platform linux/amd64 \
  --tag casjaysdevdocker/blueonyx:latest \
  --push .

Smoke test

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

1.5 KiB Raw Permalink Blame History