Reference · the tools · boxes

Reclaim disk space on this box

What it does

Free Docker's build cache, the images nothing references (dangling), and cached template versions older than the newest of their name, and say what was freed and what the disk is at now. Safe by construction: no environment, running or stopped, no container, no tagged image, no starter kit and no draft is touched; an older template version is a copy of what the account keeps, and an install of it fetches it again. The only cost is a slower next build or install. Use when anything said the disk was full, or environment_status shows it high. What it leaves -- the images stopped environments start from, their containers -- is an environment's to free, with destroy_environment.

What it needs to know

box · optional

Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).

session_box · optional

The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named.