Skip to content

Templates Troubleshooting

TitleDescriptionRelated Issues
Custom tpl create-from-image keeps timing outTwo common root causes: (1) the custom image either ships no envd or doesn't start it at container startup — the default readiness probe hits envd at 49983/health, so without it the probe connection refused until timeout; (2) the host is in a nested-virt environment (e.g. AWS EC2) — missing instruction-set bits (XSAVE family) panic the MicroVM, and doubled VM-exits on page faults slow the in-guest agent enough to blow VsockServerReady / probe budget. Fixes: follow the Bring Your Own Image tutorial for the image; switch to PVM deployment to avoid nested virt.#312, #95, #94, #161, #253
Template build fails due to insufficient disk spaceBuilding a template requires unpacking the OCI image and writing it to disk, which consumes a lot of temporary space. When the partition holding /tmp, /data/cubelet or /usr/local/services/cubetoolbox/ runs low, the template can stall at UNPACKING / BUILDING_EXT4, or surface as mkfs.ext4 errors such as directory block checksum mismatch or "Ext2 inode is not a directory".#240, #251
Template Creation Times Out When the Sandbox CIDR Overlaps the LANThe one-click deployment defaults the sandbox network to 192.168.0.0/18. If the host LAN also uses 192.168.1.x, Cube may allocate sandbox IPs that overlap the physical network, causing template creation or port probing to fail with context deadline exceeded. Change the Cubelet CIDR to a non-overlapping range and remove the old TAP devices plus cube-dev before restarting.Guide