Home › For AI Agents
System facts
The layout of an Animux system in one page. Release, base, users, important paths, Animux packages, services, ports, boot roles and how to tell a live session from an installed one.
AIagentsreferencepathsservicessystem
Identity
|
|
| Release |
Animux Genesis64 r16.3, ISO animux-genesis64-deb_28.iso |
| Base |
Debian 12 "bookworm", amd64, Linux 6.1, systemd |
| Desktop |
Xfce 4.18 on X11, LightDM |
/etc/os-release |
ID=animux, ID_LIKE=debian, PRETTY_NAME="Animux Genesis64" |
| Release in machine-readable form |
release in /usr/share/animux/docs/api/software.json |
Users
| Situation |
User |
Password |
sudo |
| Live session |
user (display name "Animator"), auto-login |
user |
without password |
| Installed |
chosen in the installer |
chosen |
with password |
Important paths
| Path |
Contents |
/usr/share/animux/docs/ |
this guide (HTML, Markdown, JSON, llms.txt) |
/usr/share/animux/samples/ |
sample scenes for every renderer and format |
~/animux-selftest/<date-time>/ |
self-test results, images, logs, summary.txt |
/opt/animux/blender/ |
Blender 5.2.3 (/usr/bin/blender), extensions in 5.2/extensions/system/ (MPFB) |
/opt/animux/gaffer/ |
Gaffer 1.7.5 with Cortex, OSL, OpenUSD, Alembic; wrappers in /usr/bin (usdview, oslc, abcls…) |
/opt/animux/vfx-env/ |
Python 3.11 venv: Mitsuba, LuxCore, usd-core, OIIO, OpenEXR, OCIO, MaterialX (animux-vfx-python) |
/opt/animux/makehuman2/ |
MakeHuman II (makehuman2) |
/opt/animux/flamenco/ |
Flamenco Manager and Worker |
/opt/animux/appleseed/, /opt/animux/pbrt/ |
appleseed CLI, pbrt-v4 |
/opt/animux/avidemux/, /opt/animux/cinelerra-gg/, /opt/animux/djv/ |
video tools |
/opt/farmerjoe/ |
Farmerjoe |
/usr/lib/animux/ |
role selector, installer launcher, helper scripts |
/etc/apt/sources.list.d/animux.sources |
Animux repository (Enabled: no in r16) |
/usr/share/keyrings/animux-archive-keyring.gpg |
repository signing key (fingerprint B47E D034 EDD3 3360 7502 EE4B F334 23FB B235 4B3B) |
Animux packages
dpkg-query -W 'animux-*' upscayl lists them: animux-archive-keyring, animux-branding, animux-menus, animux-roles, animux-docs, animux-samples, animux-farmerjoe, animux-flamenco, animux-blender, animux-blender-mpfb, animux-gaffer, animux-vfx-python, animux-makehuman2, animux-appleseed, animux-pbrt, animux-avidemux, animux-cinelerra-gg, animux-djv, and upscayl.
Services and ports
| Service |
Port |
Notes |
animux-docs.service |
8765/tcp on 127.0.0.1 |
this guide; read-only |
animux-role-config.service |
— |
reads animux.role= at boot, writes /run/animux/role |
ssh.service |
22/tcp |
enabled |
| Flamenco Manager (when started) |
8080/tcp |
web interface and API |
isc-dhcp-server, nfs-kernel-server |
— |
masked, except in the Render Farm Master role |
Boot roles
The kernel parameter animux.role= selects the role; the current one is in /run/animux/role.
| Role |
Desktop |
Purpose |
workstation (default) |
yes |
normal use |
install |
yes, installer opens |
Calamares installation |
master |
no (display manager masked) |
render farm head; DHCP and NFS unmasked |
slave |
no |
render node |
Live or installed?
test -d /run/live/medium && echo live || echo installed
A live session keeps all changes in RAM (overlay) and loses them at shutdown.
Hardware notes
- Blender 5, appleseed: need SSE4.2. Mitsuba, LuxCore: need SSE4.2 and AVX.
- OpenCL: Debian's software drivers (Mesa, PoCL) are hidden from
animux-vfx-python programs because they crash LuxCore. Set ANIMUX_KEEP_ALL_OPENCL=1 to see all drivers.
- No NVIDIA proprietary driver on the ISO; GPU rendering in Cycles needs it (
nvidia-driver from Debian non-free).
- No VirtualBox/VMware guest tools on the ISO.
