# VPS Firmware Updates

Theseus continually improves performance of the VPS software. New software updates can be installed on the Micro VPS device via the Theseus GCS app.&#x20;

Navigate to the "Update Firmware" tab on the left menu.

<figure><img src="/files/qN8bT12VJ1Zhw317bPRe" alt=""><figcaption></figcaption></figure>

This brings you to the firmware updating dashboard. Click on the "Test Connection" button on the left side of the screen to verify the health of your connection to the compute module.

<figure><img src="/files/8IHRVayIq6peBQeRXhuL" alt=""><figcaption></figcaption></figure>

## Over-the-air (OTA) Updates

Signing in to your [Theseus Account](/gcs-software/legacy-software/theseus-gcs-app/feature-list/theseus-account.md) allows us to automatically check for updates to the Micro VPS.\
Once you are signed in, the dashboard will check if your software is out of date. You will see a warning badge on the Update Firmware tab prompting you to update.

<figure><picture><source srcset="/files/rzfDiEtTPPwKmij7y5Fv" media="(prefers-color-scheme: dark)"><img src="/files/TVPxRzJzcD2Olwhx8SVq" alt=""></picture><figcaption><p>Highlighting update firmware tab</p></figcaption></figure>

Click the "Download Update" button to begin updating your Micro VPS. The update process needs an internet connection to download the software, and for you to be signed in to your Theseus account.

<figure><picture><source srcset="/files/avQ6O0NVdnu01EGwpcyA" media="(prefers-color-scheme: dark)"><img src="/files/o9n6OQ7yf9sLqrinGdEl" alt=""></picture><figcaption></figcaption></figure>

Downloading the update can take up to few minutes. When the update has been downloaded successfully, you'll be prompted to install it. Click "Install Firmware" to proceed with the update.

<figure><picture><source srcset="/files/RmM2FJV3S2VcFyfkd1xP" media="(prefers-color-scheme: dark)"><img src="/files/1zxa82iCgYXN3TKFEEYA" alt=""></picture><figcaption></figcaption></figure>

You can view the status updates while the software is being updated.

<figure><picture><source srcset="/files/4Al4WMsdX0CVTN8eSc1a" media="(prefers-color-scheme: dark)"><img src="/files/jcPIDRaLW1sI1Pf3WXJr" alt=""></picture><figcaption></figcaption></figure>

Once the software update is complete, you will be prompted to reboot the device. This ensures all services have been properly refreshed and are using the up-to-date code.

<figure><picture><source srcset="/files/M2VVOeCccHifdtGohMhi" media="(prefers-color-scheme: dark)"><img src="/files/d6hkqA7nQKPPEAb6VpPz" alt=""></picture><figcaption></figcaption></figure>

## Uploading New Software

{% hint style="info" %}
This section is for manually installing a .deb binary. You can also update software with [#over-the-air-ota-updates](#over-the-air-ota-updates "mention").
{% endhint %}

If you'd prefer manually updating the Micro VPS software, you need to go and download the [latest software release](/gcs-software/legacy-software/theseus-maps-app/releases.md#latest-release) from our website. The Micro VPS software is a contained in a **.deb** file which should be uploaded to the Micro VPS using the "Update Firmware" page.

Click on the "Update Controls" panel to select your .deb file and upload it to the device.

<figure><img src="/files/LcpwfScfIK5eR0Fg5Qsg" alt=""><figcaption></figcaption></figure>

Once you select your file, it will be uploaded to the device.

<figure><img src="/files/XYeh5YXvoBobtOWzNDoJ" alt=""><figcaption></figcaption></figure>

Once your binary is uploaded, it is ready to be deployed. Click the "Update VPS" button to deploy the software.

<figure><img src="/files/Wk2dBv58Rcr09qVC8Kix" alt=""><figcaption></figcaption></figure>

All versions of the software present on the device are shown at the bottom of the page. You may select another version and choose to install it as you see fit.

<figure><img src="/files/RKsZSrC0kRX8eEHgJ6wr" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
We recommend **always using the** [**latest version**](/gcs-software/legacy-software/theseus-maps-app/releases.md#latest-release) **of the VPS software**.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.theseus.us/gcs-software/legacy-software/theseus-gcs-app/feature-list/vps-firmware-updates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
