# Upgrade Onsite Proxy

When a newer Onsite Proxy release is available, you can move an existing installation up to it directly from the host's command line. The Onsite Proxy sits on the same local network as your IP phones and relays their traffic to Cloud Voice, so keeping it current makes sure you have the latest fixes and features. The upgrade keeps your current setup intact, so there is no need to reconnect or reconfigure the service afterward.

:::caution
An upgrade briefly takes the running Onsite Proxy offline while the new version starts. IP phones that rely on it to reach Cloud Voice can lose service during that short window, so plan the upgrade for a maintenance period or a time when few calls are active.
:::

## Before you begin

Confirm that the [Onsite Proxy is already installed](/pbx/onsite-proxy-guide/install-onsite-proxy/) on the host you want to upgrade.

## Upgrade the Onsite Proxy

1. Open a command line session on the host where the Onsite Proxy is running.
2. Switch to the root user by running:

   ```bash
   sudo -i
   ```

   :::note
   If you are prompted for a password, enter the password for your current user account and press `Enter`.
   :::
3. Download the latest installation package to a directory of your choice. Use the command that matches the host's CPU architecture (the instruction set of its processor), replacing `<download_url>` with the download location provided by Cloud Voice and `<desired_directory>` with the folder where you want the package saved.

   | Architecture | Command |
   | --- | --- |
   | x86_64 | `wget <download_url>/onsiteproxy-x86_64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz` |
   | ARM64 | `wget <download_url>/onsiteproxy-aarch64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz` |

   :::tip
   Not sure which architecture the host uses? Run `uname -m`. A result of `x86_64` means use the x86_64 command, and `aarch64` means use the ARM64 command.
   :::

   For example, to save an x86_64 package to the desktop:

   ```bash
   wget <download_url>/onsiteproxy-x86_64.tar.gz -O /home/user/Desktop/onsiteproxy.tar.gz
   ```
4. Start the upgrade by pointing the upgrade command at the package you just downloaded. Replace `<your_package_path>` with the actual location of the new package:

   ```bash
   onsite-proxy-upgrade <your_package_path>/onsiteproxy.tar.gz
   ```

   For the example above, this would be:

   ```bash
   onsite-proxy-upgrade /home/user/Desktop/onsiteproxy.tar.gz
   ```
5. When the **Onsite Proxy Upgrade** window appears, check that the new version shown is correct, then select **&lt;Yes&gt;** and press `Enter`.

   :::note
   Selecting **&lt;No&gt;** cancels the upgrade and leaves the current version and settings unchanged.
   :::

   ![Upgrade window showing the target version with Yes and No options](/images/pbx/onsite-proxy-upgrad.png)
6. Once the **Upgrade Complete** message appears, press `Enter` to finish.

   ![Message confirming the Onsite Proxy upgrade has finished](/images/pbx/onsite-proxy-upgrade-complete.png)

The Onsite Proxy now runs the new version. All of its previous settings, including connection information and which services are enabled, carry over automatically, so no further configuration is required.