> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safesquid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrade SafeSquid

> Upgrade SafeSquid SWG via Web GUI: prerequisites, cleanup, and applying the new tarball package.

# Upgrade SafeSquid application via Web GUI

## Choose the upgrade path

There are two upgrade paths, and they answer different problems. Run the OS upgrade first
where both are due — a SafeSquid version that needs newer kernel or library versions will
not install cleanly on an end-of-life base.

| Path            | Use when                                                                 | Guide                                           |
| --------------- | ------------------------------------------------------------------------ | ----------------------------------------------- |
| Version upgrade | The OS is current and only the SafeSquid application needs updating      | This page                                       |
| OS upgrade      | The base OS is end-of-life, or lacks versions a newer SafeSquid requires | [Upgrade Ubuntu](/use_cases/upgrade/os_upgrade) |

## Version upgrade scope and procedure

SafeSquid SWG upgrade is a newer version of the SafeSquid that offers a significant change or major improvement over your current version. Upgrade your SafeSquid to the latest version which may consists of bugfixes and enhancements. When you upload latest tarball of SafeSquid SWG from WebGUI monit service will automatically restart the SafeSquid service.

## Prerequisites

Monit service should be running and started on your SafeSquid server, you can check it by using below command from your SafeSquid server

```bash theme={null}
pidof monit
```

If you did not find pid of monit, run below command to Start the Monit service

```bash theme={null}
/etc/init.d/monit start
```

The partition size of /tmp/safesquid used must be less than 4%, you can check it by using below command

```bash theme={null}
df -kh
```

After executing the command last line of the output will be similar as shown below

```bash theme={null}
/dev/ram1 62M 1.3M 58M 3% /tmp/safesquid
```

Check the highlighted number which shows the actual usage, if it is greater than 4%, then remove the files from the folder /tmp/safesquid

You can remove files from /tmp/safesquid by going to that folder location using the command:

```bash theme={null}
cd /tmp/safesquid
```

Further delete all the files from the folder by using the command:

```bash theme={null}
rm -rf *
```

## Steps

### [Access the SafeSquid User Interface](/safesquid_swg/interface/configuration_portal)

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image1.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=5017c1748ef8bafce23836e2b724dff2" alt="your current version of safesquid will be shown in the right hand bottom corner in the safesquid interface" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image1.webp" />

### Go to Support Page

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image2.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=0cecaa6e36dff53a3a77147cdb569de9" alt="clicking on support" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image2.webp" />

### Go to upgradation

:::note
Download the latest SafeSquid SWG tarball from here and save into your machine.
:::

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image3.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=a048680280f5b433c5ba5be6dd132848" alt="clicking on upgradation" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image3.webp" />

### Select new tarball

Select the latest SafeSquid tarball downloaded and saved in your machine before.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image4.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=29cdf5470a78a7d15dbc8f337621008d" alt="uploading a new tarball file" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image4.webp" />

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image5.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=62e3bd287a0888c1d4d63a74a8f5aa23" alt="selecting the tarball file from the pc" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image5.webp" />

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image6.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=89b0d0a3ed910fd0e692f7dfd1bc2a66" alt="you can see the browsed tarball beside browse button" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image6.webp" />

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image6.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=89b0d0a3ed910fd0e692f7dfd1bc2a66" alt="Tarball file selected and ready to upload" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image6.webp" />

Click on upload button to upload new tar file.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image7.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=b12b6b7667ede9411dd1b3ad1e6abebf" alt="clicking on upload button to upload" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image7.webp" />

## Testing Upgradation

You can see upgraded version number of SafeSquid SWG at the bottom right corner of interface.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/cI-kUTNiWWPhOtFM/images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image8.webp?fit=max&auto=format&n=cI-kUTNiWWPhOtFM&q=85&s=f777c3c830a83e323668655f9b4d2b02" alt="test if the newer version of the safesquid is showing in the bottom right hand corner" width="939" height="528" data-path="images/How_To/Upgrade_SafeSquid_To_A_Newer_Version/image8.webp" />

## Where should I get the latest version of SafeSquid to upgrade?

You can download **SafeSquid SWG for Windows** package from - [http://downloads.safesquid.net/SWG/windows/setup\_safesquid\_swg\_latest.exe](http://downloads.safesquid.net/SWG/windows/setup_safesquid_swg_latest.exe)

You can download **SafeSquid SWG for Linux** package from - [http://downloads.safesquid.net/appliance/binary/safesquid\_latest.tar.gz](http://downloads.safesquid.net/appliance/binary/safesquid_latest.tar.gz)


## Related topics

- [Welcome to SafeSquid](/getting_started/welcome.md)
- [SafeSquid daemon](/admin_guide/start_here/daemon.md)
- [Upgrade Ubuntu](/use_cases/upgrade/os_upgrade.md)
- [Monit Service Governance](/safesquid_swg/interface/supporting_services_monit.md)
- [Application Binaries and Modules](/safesquid_swg/files_and_folders/application_binaries_and_modules.md)
