mirror of
https://github.com/casjaysdevdocker/blueonyx
synced 2026-08-23 14:05:48 -04:00
CLAUDE.md
This commit is contained in:
@@ -1,49 +0,0 @@
|
|||||||
# 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
|
|
||||||
Reference in New Issue
Block a user