casjaysdevdocker/blueonyx

Fork 0

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

Files

casjay 15546d0a85

blueonyx / release-blueonyx (push) Has been cancelled

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

2.0 KiB

Raw Blame History

blueonyx — Docker Migration Notes

What this image is

BlueOnyx 5212R control panel running on AlmaLinux 10 with systemd (almalinux/10-init). BlueOnyx is a full server control panel managing Apache, Postfix, ProFTPD, BIND, MariaDB, Dovecot, etc.

Special architecture: systemd container

Base: almalinux/10-init (systemd init variant)
Single-stage build — no FROM scratch final stage (systemd images cannot be stripped)
PID 1: CMD ["/sbin/init"] — systemd, not tini+entrypoint.sh
No init.d scripts — systemd units handle all service lifecycle
Only supports linux/amd64 (BlueOnyx is x86-only)

Build notes

05-custom.sh downloads and installs BlueOnyx via dnf groupinstall -y blueonyx (~900-1200 RPMs)
BlueOnyx RPM repo: http://devel.blueonyx.it/pub/5212R.rpm
Build takes 20-40 minutes
initServices.sh may fail during build (no systemd at build time) — error is caught

Runtime requirements

docker run --privileged -v /sys/fs/cgroup:/sys/fs/cgroup:rw \
  -p 444:444 -p 81:81 -p 80:80 -p 443:443 \
  casjaysdevdocker/blueonyx

Must run with --privileged for systemd
Cgroup v2 mount required

Volumes

/data — persistent data (mariadb, mail, web, dns)
/config — service configs
/logs — all service logs

Key scripts

rootfs/usr/local/bin/blueonyx-env-config — applies env vars to BlueOnyx at runtime
rootfs/usr/local/bin/blueonyx-startup — container startup tasks (runs via systemd unit)
rootfs/usr/local/bin/blueonyx-info — displays access info
rootfs/root/docker/setup/05-custom.sh — main BlueOnyx installer

Env vars (runtime)

BLUEONYX_HOSTNAME — hostname (default: blueonyx)
BLUEONYX_DOMAIN — domain (default: local)
BLUEONYX_ADMIN_PASS — admin password
BLUEONYX_VERSION — BlueOnyx version (default: 5212R)

What was fixed (2026-05-13)

02-packages.sh: Removed broken reboot and sudo dnf update commands
03-files.sh: Removed irrelevant incus binary download (fails in buildx)
Dockerfile: Updated BUILD_DATE to 202605131434

2.0 KiB Raw Blame History