ix templates

Manage the region's templates

Usage: ix templates [OPTIONS] [COMMAND]

also answers to template

Manage the region's templates.

Everything bootable by name or by ix new <flake-ref> is a template: a flake build is cached per region, keyed on the pinned rev, and later ix new runs of the same rev boot from it in seconds. Removing an entry frees its stored build.

commands

ix templates ls List the region's templates: region-shared entries (the platform base and other named templates) plus your own
ix templates rm Delete one template. The entry is the stored build's GC pin, so removal releases it; the next `ix new` of the same rev rebuilds it
ix templates warm Pin one template warm: the region's prewarm sweep stages it, so `ix new` on it boots without the cold materialization. Shared templates can be pinned too. A pin holds staged capacity while you hold it, so the number you can hold is capped
ix templates unwarm Remove your warm pin from one template, freeing the capacity it held. The entry stays cached, and anyone else's pin on it stays; the next `ix new` on it materializes cold again once no pin is left

options

--region <REGION> Region whose template cache should be checked (templates build and cache per region) default: us-west-1 env: IX_REGION
--output <OUTPUT> Output format one of: human, json default: human
--message-format <MESSAGE_FORMAT> Error format one of: human, short, json default: human