Reference
Diagnostic codes
Every failure zbx reports has one of these codes. zbx explain <code> prints the same text offline.
| Code | Summary | Blame |
|---|---|---|
| ZBX-E0001 | unknown command | user |
| ZBX-E0002 | no command given | user |
| ZBX-E0003 | unexpected arguments | user |
| ZBX-E0004 | unknown option | user |
| ZBX-E0005 | option has a missing or invalid value | user |
| ZBX-E0006 | missing argument | user |
| ZBX-E0007 | unknown diagnostic code | user |
| ZBX-E0008 | command line exceeds the supported limits | user |
| ZBX-E0009 | can't write output | environment |
| ZBX-E0010 | can't use this -e option | user |
| ZBX-E0011 | -e names a variable that is not set | user |
| ZBX-E0012 | not a valid --tmpfs, --bind or --secret value | user |
| ZBX-E0013 | mounts that cannot go together | user |
| ZBX-E0014 | not a valid --mount value | user |
| ZBX-E0015 | not a valid --user value | user |
| ZBX-E0101 | can't create a user namespace | environment |
| ZBX-E0102 | kernel version is unsupported or unknown | environment |
| ZBX-E0103 | cgroup v2 is not set up for this user | environment |
| ZBX-E0104 | can't mount overlayfs in a user namespace | environment |
| ZBX-E0105 | uid and gid mapping is not set up | environment |
| ZBX-E0106 | seccomp is not available | environment |
| ZBX-W0101 | user namespaces work, but only for unconfined users | environment |
| ZBX-W0102 | --net user is not available | environment |
| ZBX-E0201 | the rootfs is missing or not a directory | user |
| ZBX-E0202 | can't run the command in the rootfs | user |
| ZBX-E0203 | can't create the container's namespaces | environment |
| ZBX-E0204 | writing the id maps failed | environment |
| ZBX-E0205 | a container setup step failed | environment |
| ZBX-E0206 | invalid container name | user |
| ZBX-E0207 | can't restrict the container's capabilities | environment |
| ZBX-E0208 | can't install the container's seccomp filter | environment |
| ZBX-E0209 | can't set up the read-only rootfs | environment |
| ZBX-E0210 | a --bind or --secret source can't be used | user |
| ZBX-E0211 | can't set up a --tmpfs, --bind or --secret mount | environment |
| ZBX-E0212 | a --mount source is outside the project | user |
| ZBX-E0213 | a --mount needs the container to run as root | user |
| ZBX-E0214 | a --mount source can't be used | user |
| ZBX-E0215 | can't set up a --mount | environment |
| ZBX-E0216 | the --user is not in the image | user |
| ZBX-E0217 | the container has no log | user |
| ZBX-E0218 | can't read the container's log | environment |
| ZBX-E0219 | bad value for a logs option | user |
| ZBX-E0220 | the container is not running | user |
| ZBX-E0221 | can't join the running container | environment |
| ZBX-E0222 | can't put the command in the container's cgroup | environment |
| ZBX-E0223 | the working directory is not in the container | user |
| ZBX-E0224 | can't give the command a terminal | environment |
| ZBX-W0201 | mapping only your own id into the container | environment |
| ZBX-W0202 | can't save the run record | environment |
| ZBX-W0203 | skipped a run record that can't be read | environment |
| ZBX-W0204 | the container's output is not being kept | environment |
| ZBX-W0205 | older output of the container was dropped | user |
| ZBX-W0206 | the terminal was not logged | user |
| ZBX-W0207 | the exec was not noted in the container's history | environment |
| ZBX-E0301 | can't reach the systemd user manager over D-Bus | environment |
| ZBX-E0302 | the user bus refused to authenticate this user | environment |
| ZBX-E0303 | the user bus answered in a way zbx can't use | external |
| ZBX-E0304 | systemd refused the container's scope, or its job failed | external |
| ZBX-E0305 | a scope with this container's name already exists | user |
| ZBX-E0306 | invalid resource limit | user |
| ZBX-E0307 | a limit needs a cgroup scope, and none can be made | environment |
| ZBX-E0308 | can't write a limit to the container's cgroup | environment |
| ZBX-E0309 | can't make the container's cgroup | environment |
| ZBX-W0301 | running without a cgroup scope | environment |
| ZBX-W0302 | the container's cgroup scope was left behind | environment |
| ZBX-E0401 | a time is not a number of milliseconds | user |
| ZBX-E0402 | no container with that name | user |
| ZBX-E0403 | can't signal the container | environment |
| ZBX-E0404 | the container did not stop in time | environment |
| ZBX-E0405 | can't start the supervisor of a detached run | environment |
| ZBX-E0406 | no schema for that command | user |
| ZBX-E0410 | no tree with that digest | user |
| ZBX-E0411 | that digest prefix matches more than one tree | user |
| ZBX-E0412 | not a digest | user |
| ZBX-E0413 | can't use the store: its format is unknown | environment |
| ZBX-E0414 | can't read the directory to import | user |
| ZBX-E0415 | the directory tree is bigger than an import limit | user |
| ZBX-E0416 | the disk is full while writing the store | environment |
| ZBX-E0417 | can't write the store | environment |
| ZBX-E0418 | a file changed while it was being imported | user |
| ZBX-E0419 | can't run the store worker | environment |
| ZBX-E0420 | that tree is not a root | user |
| ZBX-E0421 | no data directory to keep the store in | environment |
| ZBX-E0422 | a tree in the store is missing or damaged | environment |
| ZBX-E0423 | can't read the store | environment |
| ZBX-E0424 | a file name in the store has too many links | environment |
| ZBX-E0425 | overlayfs can't be mounted for this container | environment |
| ZBX-E0426 | the container has no layer to commit | user |
| ZBX-E0427 | the container is still running | user |
| ZBX-E0428 | the upper layer uses an overlayfs feature a commit can't follow | environment |
| ZBX-E0429 | a file in the store is damaged | environment |
| ZBX-E0430 | the store failed verification | environment |
| ZBX-E0431 | the store changed since that gc plan was made | user |
| ZBX-E0432 | a restore would overwrite something that is back in the store | user |
| ZBX-E0433 | no trash with that id | user |
| ZBX-E0434 | the trash is missing things the gc moved into it | environment |
| ZBX-E0435 | a root record can't be used | environment |
| ZBX-E0436 | the store is in use by another zbx command | user |
| ZBX-E0437 | an image record from a peer was not taken | user |
| ZBX-W0410 | a file was left out of the import | user |
| ZBX-W0411 | an extended attribute was left out of the import | user |
| ZBX-W0412 | some files have an owner or group that could not be mapped | user |
| ZBX-W0413 | a container's upper layer could not be removed | environment |
| ZBX-E0501 | not an image reference | user |
| ZBX-E0502 | the registry's name does not resolve | environment |
| ZBX-E0503 | can't reach the registry | environment |
| ZBX-E0504 | the registry's certificate can't be trusted | environment |
| ZBX-E0505 | the registry answered with an error | external |
| ZBX-E0506 | the registry is rate limiting this host | external |
| ZBX-E0507 | the registry refused anonymous access | external |
| ZBX-E0508 | the registry has no such image | user |
| ZBX-E0509 | the image has no build for this platform | user |
| ZBX-E0510 | the registry sent a type of document zbx does not read | external |
| ZBX-E0511 | downloaded bytes do not match their digest | external |
| ZBX-E0512 | the registry's answer can't be used | external |
| ZBX-E0513 | the registry's answer ended early | external |
| ZBX-E0514 | not a registry mirror | user |
| ZBX-E0515 | a layer entry would leave the image's root | external |
| ZBX-E0516 | a layer can't be unpacked | external |
| ZBX-E0517 | an image's configuration can't be used | external |
| ZBX-E0518 | zbx.lock can't be read | user |
| ZBX-E0519 | zbx.lock and the store disagree about an image | user |
| ZBX-E0520 | the image zbx.lock names is not in the store | user |
| ZBX-E0521 | the image's user is not in the image | external |
| ZBX-E0522 | no image of that name is locked or in the store | user |
| ZBX-E0523 | the image's user needs more ids than this run maps | environment |
| ZBX-E0524 | the image has no command to run | user |
| ZBX-E0525 | zbx.lock can't be written | environment |
| ZBX-E0526 | there is no zbx.lock for this project | user |
| ZBX-W0501 | device nodes in a layer were left out | external |
| ZBX-W0502 | extended attributes in a layer were left out | external |
| ZBX-W0503 | no zbx.lock was found, so one was written | user |
| ZBX-W0504 | warnings from unpacking an image were not shown | external |
| ZBX-E0600 | --publish is not a usable HOST:CONTAINER | user |
| ZBX-E0601 | pasta is not installed | environment |
| ZBX-E0602 | pasta is too old | environment |
| ZBX-E0603 | pasta failed to start | environment |
| ZBX-E0604 | a published host port is already in use | user |
| ZBX-E0605 | the host lets users bind no port this low | environment |
| ZBX-E0701 | no state directory to keep bundles and run records in | environment |
| ZBX-E0702 | can't write the bundle | environment |
| ZBX-E0703 | no run record with that name | user |
| ZBX-E0704 | no runs are recorded yet | user |
| ZBX-E0705 | not a valid state volume name | user |
| ZBX-E0706 | the state volume is in use | user |
| ZBX-E0707 | no state volume with that name | user |
| ZBX-E0708 | a state volume with that name exists already | user |
| ZBX-E0709 | no state volume with that name in the trash | user |
| ZBX-E0710 | the state volume's trash has expired | user |
| ZBX-E0711 | can't make or read the state directory | environment |
| ZBX-E0712 | can't read a state volume's record | environment |
| ZBX-E0713 | can't mount a state volume in the container | environment |
| ZBX-E0714 | won't write the archive to a terminal | user |
| ZBX-E0715 | can't write the archive | environment |
| ZBX-E0716 | can't read the state volume to export it | environment |
| ZBX-W0701 | writing a bundle without redaction | user |
| ZBX-W0702 | a state volume's size could not be counted | environment |
| ZBX-W0703 | a file was left out of the export | user |
| ZBX-E0801 | can't read the build file | user |
| ZBX-E0802 | the build graph is invalid | user |
| ZBX-E0803 | a build input is refused | user |
| ZBX-E0804 | a build step's base is not locked | user |
| ZBX-E0805 | a build step failed | user |
| ZBX-E0806 | a build step's output is refused | user |
| ZBX-E0807 | the image can't be made as declared | user |
| ZBX-W0801 | the build has steps that use the network | user |
| ZBX-E1001 | this zbx is not allowed to run virtual machines | environment |
| ZBX-E1002 | the virtual machine did not start | environment |
| ZBX-E1003 | the virtual machine did not answer in time | environment |
| ZBX-E1004 | another process holds the virtual machine | environment |
| ZBX-E1005 | can't make or write the VM directory | environment |
| ZBX-E1006 | no virtual machine is running | user |
| ZBX-E1007 | the virtual machine's size is out of range | user |
| ZBX-E1008 | can't read the virtual machine's settings | environment |
| ZBX-W1001 | replacing a virtual machine of another version | environment |
| ZBX-E1009 | the connection to the virtual machine was lost | environment |
| ZBX-E1010 | the virtual machine's command service did not answer | environment |
| ZBX-E1011 | the virtual machine could not be set up for this user | environment |
| ZBX-W1002 | the virtual machine has no network | environment |
| ZBX-E1012 | the virtual machine's disk cannot be made smaller | user |
| ZBX-E1013 | the working directory is not shared with the virtual machine | user |
| ZBX-E1014 | the virtual machine's disk is full | environment |
| ZBX-E1015 | the Mac has no room for the virtual machine's disk | environment |
| ZBX-E1016 | Rosetta is not installed on this Mac | environment |
| ZBX-E1017 | a published port cannot be opened on the Mac | user |
| ZBX-W1003 | the Mac has no IPv4 DNS server, so the machine asks public ones | environment |
| ZBX-B0001 | zbx hit an internal error | internal |