Apps — images#

The Images tab of Services → Apps lists the container images on the router, in the panel Images on the router, with their number. An image is downloaded when an app is installed, when its image is changed in Edit settings, and when Check for update finds a newer one. It stays on the router until it is removed here.

The list#

Column	Shows
Image	The image's name, with its registry.
Tag	Its tag.
Size	Its size on the router.
(button)	Remove.

The same list supplies Image ID, Image created and Image size in the Details panel of an app's page.

With no images, the tab shows "No images" and "Images are downloaded when an app is installed."

Removing an image#

Press Remove on the image's row. It needs the operator role; a viewer sees it disabled, with "Your role is read-only".
Press Remove image? within five seconds to confirm.

The image is deleted at once: this is not a pending change. The notice says "Image removed". Each removal the router carries out or rejects is recorded in the audit log.

An image that an installed app uses cannot be removed: the notice says "Could not remove the image", with a reason such as "adguard still uses this image. Uninstall it first." Uninstalling is a pending change, so apply it before removing the image. The check compares images by name and ignores tags, so while an app is installed, no image of the same name can be removed, including an older one left behind by Check for update or by a changed image.

Any other failure shows the same notice, with the router's reason.

An image outlives its app#

Uninstalling an app keeps its image, so installing it again needs no download. An image downloaded for an install whose change was never applied stays too. To free the space, remove the images no app uses.

What the tab does not do#

It does not download images: they arrive with an install, a changed image, or Check for update.
It removes one image at a time; there is no bulk removal.
It shows each image's tag, not its digest.

For automation#

DELETE /api/apps/image?image=docker.io/adguard/adguardhome:latest removes an image: the reference is a query parameter, not a body. It needs the operator role and a licence, and answers 409 when an installed app uses the image. The list is images in GET /api/apps/installed.