> For the complete documentation index, see [llms.txt](https://docs.synteq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.synteq.com/virtualization-platform/server-management/reinstalling-the-os/reinstalling-the-os-using-an-iso-file/installing-linux-on-your-vps.md).

# Installing Linux on your VPS

In this guide, we'll show you how you can install any generic linux OS on your VPS using an ISO from our ISO Library. This should work for most linux based ISOs but you may also need to check the documentation for your specific linux distribution.

### 1. Rebuild the VPS

Login to our VPS Control Panel & Click `Manage` for the VPS you want to reinstall.

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

Next, on the `Overview` tab, click on the `Rebuild` option.

<figure><img src="/files/6r8PVJ3i5SUyRL2mdO5E" alt=""><figcaption></figcaption></figure>

On the pop-up, click `Continue` to proceed to the next step.

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

Now that you're on the setup page, Enter the `Name` of your VPS \[1], `HostName` \[2] & the `Timezone` \[3] in their respective fields as shown in the image. Then Click on the `Self Install` button \[4].

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

Afterward, Click on the `Self Install` button as shown in the image below.

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

Lastly, Click on `Prepare for Self Install` on the popup.

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

### 2. Mounting the ISO

Once the VPS is rebuilt, it should take you to the `Overview` page for your server. Click on the `Media` \[1] Tab and select the ISO image that you want to mount from the DropDown \[2] as shown in the image.

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

Then, with the image selected, click on `Insert` \[1] and `Restart` \[2] your server.

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

On the popup, confirm the restart by clicking on the `Restart` button

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

### 3. Access the VNC Console

Go back to the `Overview`  \[1] tab and click on the VNC button \[2] to start the installation on the VNC Console.

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

More details on how to use the VNC Console can be found here: [Entering the VNC console](/virtualization-platform/server-management/entering-the-vnc-console.md)

### 4. Install the OS

Then, follow the on-screen instructions within the VNC window to install the OS. This step will vary based on which OS distribution you chose.&#x20;

### 5. Ejecting the ISO

Once you've successfully installed the ISO. Go back to the `Media` \[1]Tab and click on `Eject` \[2] to eject the iso from your server.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.synteq.com/virtualization-platform/server-management/reinstalling-the-os/reinstalling-the-os-using-an-iso-file/installing-linux-on-your-vps.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.