Image and disk pruning
Disk space on edge hardware is limited. Edgelet supports scheduled and on-demand pruning of unused images and orphaned volume data.
Prune from the orchestrator
Trigger an immediate image prune on one Edgelet node:
potctl prune agent zebra-1
Prune using a detached agent record:
potctl prune agent zebra-1 --detached
See potctl prune agent for flags.
Scheduled prune via AgentConfig
Set pruningFrequency in AgentConfig (hours between cycles). v3.8 uses pruningFrequency, not legacy dockerPruningFrequency.
spec:
pruningFrequency: 24
availableDiskThreshold: 20
watchdogEnabled: true
The Edgelet pruning manager runs containers → volumes → images on the embedded engine. See Configuration updates.
On-device prune (break-glass)
When SSH access is available and you need local cleanup without the orchestrator:
edgelet system prune images
edgelet system prune volumes
edgelet system prune all
Orphaned VOLUME data under /var/lib/edgelet/volumes/data/ is not removed on microservice delete. Use volume prune or see Edgelet volumes.
See also
- AgentConfig fields -
pruningFrequency,availableDiskThreshold - Edgelet configuration reference -
pruningFrequency,watchdogEnabled - Troubleshooting - disk growth after deletes
See anything wrong with the document? Help us improve it!