Skip to main content

Clear Update Caches

Clear Update Caches frees disk space on an endpoint by removing update downloads and caches that TridentStack Control and the operating system no longer need. Nothing that is installed is changed, and removed downloads are fetched again the next time an install needs them.

Clear Update Caches runs on Linux and macOS endpoints. It is not yet available on Windows endpoints, where the action shows as disabled with "Not yet available on Windows endpoints".

Running it​

You can start the action from three places:

  • The Actions menu on an endpoint's row in the Endpoints table
  • The bulk actions menu, after selecting one or more endpoints
  • The Actions menu on the endpoint's own page

A confirmation dialog lists what will be removed.

Linux and macOS endpoints running an older agent version show the action as disabled with "Requires a newer agent version". In a bulk selection, those endpoints are skipped and counted in the result message.

What is removed​

PlatformRemoved
Linux and macOSPre-staged update downloads, application installer downloads, leftover installer files, and temporary and cached files kept by the agent
LinuxThe package manager's downloaded package cache
macOSThe Homebrew download cache and leftover installer packages in the temporary folder

What is never removed​

  • Script working folders
  • The agent's own update and backup files
  • A downloaded macOS OS installer

When the action is skipped​

To avoid interfering with servicing, Clear Update Caches does nothing while an install is running or a reboot is pending on the endpoint. The result in History explains why it was skipped. Run it again once the install finishes or the endpoint has rebooted.

Results​

Each run appears in the endpoint's History tab as Clear Update Caches, with the amount of space freed for each area cleaned.

Clearing automatically when disk space runs low​

Under Settings > Client Settings, the setting Clear update caches automatically when disk space runs low lets TridentStack Control run the cleanup for you. It is off by default.

When it is on, a Linux or macOS endpoint is cleaned automatically when its free space on the system drive drops below 10% of the drive or 5 GB, whichever is larger.

Automatic runs happen at most once every 7 days for each endpoint, and skip endpoints with an install running or a reboot pending. They appear in History as Clear Update Caches, labelled as triggered automatically because of low disk space.