# How to upgrade ESSO?

## Introduction

Once ESSO is installed, configured and operational, it is very likely that **an update will be required** at some point.

There are many **reasons** for updating:

- To keep up to date with the latest versions.
- To adapt to changes in the operating system.
- To resolve bugs or fixes.
- To adapt to new versions of Soffid.
- To include new features.
- How to upgrade ESSO in Linux?

## How to upgrade ESSO in Linux?

Installation on Linux or Windows is very simple, you just need to run the new installer again.

This is explained in more detail below.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">1. </span> **Download** the new version of the installer, please go to the Soffid [Enterprise downloads](https://download.soffid.com/download/enterprise/) page in the Enterprise Single Sign On (ESSO seccion).

<p class="callout warning">Please note that in Linux, the installer depends on the version of Linux.</p>

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">2.</span> Execute the **installer** of the new version.

Open a Terminal, navigate to the directory where your downloaded file is located, and run the installer command:

```
sudo dpkg -i "the-name-of-your-file.deb"
```

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">3.</span> Now, for the system to apply the changes, you need to **log out** and then **log in** again.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">4.</span> To **veify** that you are using the correct version, you can check this information by clicking on the Soffid ESSO component icon in your browser, which will open a popup window displaying the version.

## How to upgrade ESSO in Windows?

Installation on Linux or Windows is very simple, you just need to run the new installer again.

This is explained in more detail below.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">1. </span> **Download** the new version of the installer, please go to the Soffid [Enterprise downloads](https://download.soffid.com/download/enterprise/) page in the Enterprise Single Sign On (ESSO seccion).

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">2.</span> Execute the **installer** of the new version.

<p class="callout warning">Please note that administrator permissions are required to run the administrator.</p>

Please follow these steps:

- Go to the **directory** where the downloaded file is located
- Double click to **install**
- In the first Windows pop-up, click on "**More information**" and then "**Run anyway**".
- In the next popup from the installer, follow the steps, click **Next**, **Accept**, **Install**, **OK**, **Finish**, **Yes**.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">3.</span> After the final "Yes", the system wil **restart** to apply the changes.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">4.</span> To **veify** that you are using the correct version, you can check this information by clicking on the Soffid ESSO component icon in your browser, which will open a popup window displaying the version.

## Unable to select a soffid user after the update?

If, after updating, the option to use Soffid users does not appear, it is very likely that you have an old configuration.

<details id="bkmrk-image"><summary>Image</summary>

![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-01/scaled-1680-/LzZsMnzMW5niTtOx-image.png)

</details>You will probably need to update the ESSO configuration so that it points to Soffid's idp instead of Syncserver.

<p class="callout info">For further information, please refer to the [ESSO installation](https://bookstack.soffid.com/books/esso "ESSO") page.</p>

Finally, this will be the correct option.

<details id="bkmrk-image-1"><summary>Image</summary>

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-01/scaled-1680-/MDL9X6wGYGzC8LaU-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-01/MDL9X6wGYGzC8LaU-image.png)

</details>