Skip to main content

Upgrade SafeSquid application or OS

Administrators can upgrade SafeSquid SWG in two ways: OS upgrade (when the underlying OS must be updated) or version upgrade (when only the SafeSquid application is updated). The documents below describe each path and when to use it.

Upgrade guides​

OS Upgrade​

The base OS may reach end-of-life or lack kernel and library versions required by newer SafeSquid. OS Upgrade documents non-interactive upgrade of the host (e.g. Ubuntu 20.04 to 24.04) so SafeSquid remains supported and secure. Configuration is retained and restored after the system upgrade. Follow the OS Upgrade document when the OS must be modernized.

Version Upgrade​

SafeSquid software updates deliver bug fixes, security patches, and new features. Version Upgrade describes upgrading the SafeSquid application via the Support page and tarball upload while keeping the OS unchanged. Monit restarts the service after upload. Follow the Version Upgrade document to update SafeSquid when the OS is already current.

Next steps​

After upgrade, verify with Verify Your Setup and Troubleshooting if issues appear.