Repository navigation
Voxeltron 0.1.4
0.1.4 is a security release. It fixes checks that could pass when they should
fail, tightens what the assistant and self-healing may do, stops the
deployment scan from printing secrets, and fixes the findings of an
independent security review.
Security
vxl-admin doctor auditjudges HARDEN-SEC-001 by the running daemon's secrets passphrase. Before, it readVOXELTRON_SECRETS_PASSPHRASEfrom the shell that ran the audit, so it passed from any ordinary shell even when the daemon used the debug-default passphrase. The daemon now writessecret-posture.jsonbeside its database at startup (mode 0600, yes or no facts and a length only, never a secret), and the audit reads it when run as root. When it cannot get the daemon's answer, SEC-001 reportsunknownwith the reason, and--fail-on highcounts that as a failure. ASECRET_KEY_BASEis checked only when set: shorter than 64 bytes fails.- The assistant's
exec_shell,apply_patch,write_fileandedit_filetools need the Mutate tier. Before, they were Safe, so any Safe-tier path could write files and run commands insideallowed_roots.write_fileandedit_filestill never write outsideallowed_roots, including through a symlink, and self-healing never gets these tools. vxl scanandvxl deploy --preflightname a suspected secret in a Dockerfile by its variable name and line only. Before, the finding included the whole line, value included, so the secret reached terminal output, JSON and CI logs.ENVandARGlines are both checked, and names match whole words, soKEYCLOAK_URLis no longer a secret.- Every decision on a self-healing proposal is recorded as a
runbook.approvalaudit event, whichever command made it, and an undecided proposal expires afterapproval_timeout_secs(24 hours). - A compose service can mount only volumes, and join only networks, that its own compose file declares. Before, a service could name another project's volume or network by its runtime name and admission let it through.
vxl bootstrapinstalls the daemon as thevoxeltronuser with the same systemd sandbox as the installer. Before, it ran as root with no sandbox. Docker is installed from Docker's apt repository with a pinned signing key instead ofcurl https://get.docker.com | sh.- With
ai.enable_system_tools = true, the system tools needai.system_tool_rootsat every tier, the read tier included, anddocker:<container>targets only containers of a Voxeltron deployment. Before, at the read tier with no roots they could read any host file and run in any container. - The assistant's anomaly diagnosis, verifier and self-healing get only a fixed list of tools that read deployment state, plus the actions the built-in runbooks need. Tools that reach the internet or run commands are never available without a person in the conversation.
- The assistant's git tools read a repository only when every setting in its own config is on a short list of settings that cannot run programs; filters, diff and merge drivers, SSH and editor commands, credential helpers, includes and fsmonitor are refused. Git runs with system and global config, hooks, attributes files, signing programs and all network transports turned off.
db_querystops a query after 10 seconds.- A project Admin can no longer change or remove an Owner. Only an Owner can, and never the last one.
- Viewers see secret names and the redacted database connection string, never secret values or database passwords.
vxl-admin backup createnever follows symlinks or hard links to files owned by someone else, and refuses a file or directory swapped while it runs. Backup files are created 0600 and directories 0700, and a database dump larger than 4 GiB (VOXELTRON_MAX_BACKUP_DUMP_BYTES) fails instead of filling memory.- Docker builds stop after
build.timeout_secs(30 minutes by default). Health.Watchserves at most 64 streams at once.
Upgrade notes
- A compose file that mounts a volume or joins a network it does not declare under top-level
volumesornetworksis now rejected withUNDECLARED_VOLUMEorUNDECLARED_NETWORK. Declare it, then deploy again. - A daemon with
ai.enable_system_tools = trueand an emptyai.system_tool_rootsno longer starts. List the directories the tools may use, or turn the tools off. - Servers set up with an earlier
vxl bootstrapkeep running the daemon as root aftervxl daemon upgrade. A guided move to thevoxeltronuser is planned for 0.1.5. - Viewers (and Responders) can no longer read secret values or managed database passwords.
GetSecretandGetConnectionStringwithredacted = falsenow need the Admin or Owner role, the same roles that write secrets. Viewers still list secret names and get the redacted connection string. Give a person who needs values the Admin role.
Fixed
vxl scanflags end-of-life base images (such as Node 14 and 16, Python 3.7 and 3.8, Debian stretch and buster, Ubuntu 18.04) as High. Before, it only looked at plainubuntuanddebianimages, sonode:14-busterpassed.- The suggested
HEALTHCHECKuses the app's port and thehealthpath from its manifest instead of a fixed port 8080. - Built-in runbooks whose tools are not available, such as
microvm-cold-start-recoveryon Community, are not registered, so self-healing never proposes an action that always fails. The daemon logs which ones it skipped.disk-cleanupis now "Disk Space Investigation" and only reads. - The docs say plainly that
vxl scanis a deployment readiness check and does not look for known vulnerabilities in dependencies or images.
Third-party notice. The Linux voxeltrond and vxl-admin include BusyBox, under the GNU General Public License, version 2 only. Its complete source is attached to this release (busybox_1.36.1-6ubuntu3.1.dsc and its files, with BUSYBOX-SOURCE-README.md); the licence and written offer are in NOTICE-busybox.md.