# Installing XProxy Software

> For AI tools: this is the Markdown copy of https://xproxy.io/document/installing-xproxy-software. Every XProxy guide has one at its URL + `.md`; the index of all guides is https://xproxy.io/llms.txt.

Install Ubuntu 24.04 on a PC, then install XProxy with 3 commands, with a screenshot for every step.

Install XProxy on a PC in about 30 minutes, even if you have never used Ubuntu. First you install Ubuntu, then you open the Terminal and type 3 short commands.

**You need:**

- A PC or mini PC with a 64-bit Intel or AMD chip, 4 GB RAM or more, and 25 GB of free disk. **It will be erased.**

  **Tip: planning to use many USB modems?** Choose an AMD PC. AMD platforms from AM4 onwards (Ryzen) have more USB controllers. Older Intel PCs (around 4th generation) also work well. Newer Intel PCs usually handle fewer devices, about 25 to 30 USB modems. [More on choosing a PC](https://xproxy.io/document/purchase-my-self#server-pc)
- A USB stick of 8 GB or more.

  ![Drawing of a USB stick](https://media1.xproxy.io/docs/install/usb-stick.webp)

  **SanDisk Cruzer Blade 32 GB USB stick** Example product. Any USB stick of 8 GB or more works. [View on Amazon](https://www.amazon.com/dp/B005FYNT3G)
- A second computer to prepare the USB stick.
- An internet cable from your router to the PC.
- About 30 minutes.

**Any Ubuntu from 22.04 to 26.04 works, Desktop or Server.** Already know how to install Ubuntu? Install it your usual way, then go straight to [open the Terminal](#step-16) (step 16). On Ubuntu Server, just log in: you are already in a terminal, so start at [step 17](#step-17). New to Ubuntu? Follow every step below: we use Ubuntu 24.04 Desktop.

The guide has 4 parts: **get Ubuntu** (steps 1 to 3), **install Ubuntu** (steps 4 to 15), **use the Terminal** (steps 16 and 17) and **install XProxy** (steps 18 to 21).

**Step 1: Download Ubuntu**

On any computer, download Ubuntu 24.04 LTS here: [**ubuntu-24.04.5.1-desktop-amd64.iso**](https://releases.ubuntu.com/24.04/ubuntu-24.04.5.1-desktop-amd64.iso) (about 6 GB).

If that link stops working, open [releases.ubuntu.com/noble](https://releases.ubuntu.com/noble/) and click the file that ends in **desktop-amd64.iso**.

You get one big file that ends in **.iso** (about 6 GB). An ISO is a copy of the Ubuntu install disc. Save it in your **Downloads** folder.

> This guide uses **24.04 LTS** (64-bit), so every picture matches what you see. Any version from 22.04 to 26.04 also works.

**Step 2: Put Ubuntu on a USB stick**

A USB stick is the small drive you plug into a computer. Use one of **8 GB or more**. Everything on it will be erased.

Plug the USB stick into the second computer. Then follow these steps:

1. Download and open [balenaEtcher](https://etcher.balena.io) (Windows, Mac, Linux). Click **Flash from file**.
2. Click the.iso file. Then click **Open**.
3. Etcher picks your USB stick by itself. Wrong drive, or no drive? Click **Select target** (or **Change**). Tick your USB stick and click **Select**.
4. Check that the name and size are your USB stick. Click **Flash!**. If your computer asks for permission, say **Yes** or type your password.
5. Wait while the bar fills. This takes about 5 to 10 minutes.
6. When you see **Flash Completed!**, close Etcher and pull out the USB stick.

**Windows only, another way:** open [Rufus](https://rufus.ie). Under **Device**, pick your USB stick. Click **SELECT** and pick the.iso file. Click **START**. If it asks, keep **Write in ISO Image mode** and click **OK**.

![balenaEtcher home screen with the Flash from file button](https://media1.xproxy.io/docs/install/usb1-flash-from-file.webp)

> Not sure which drive is your USB stick? Look at the size. A 16 GB stick shows as 16 GB. Or unplug it, look at the list, plug it in again and see what appears. Etcher erases the drive you pick.

**Step 3: Start the PC from the USB stick**

This is the PC where you will install XProxy. **It will be erased**, so use a PC you do not need for anything else.

Plug in the USB stick and an **internet cable** (from your router to the PC). Switch the PC off.

1. Switch the PC on. When the logo shows, tap your **boot menu key** again and again until a menu appears. Find your PC brand in the picture. Not on the list? Try **F12**, then **Esc**, then **F7**.
2. Use the arrow keys to pick the line with **USB** in its name. Press **Enter**. Two USB lines? Pick the one that starts with **UEFI**.
3. The line **Try or Install Ubuntu** is already chosen. Press **Enter**.

The first two pictures are examples. The screens of your PC look different. The last picture is real: it is what Ubuntu shows.

After about a minute the Ubuntu installer opens. It looks like the next picture.

![Example list of boot menu keys: Dell F12, HP Esc then F9, Lenovo F12, ASUS Esc on a laptop or F8 on a desktop, Acer F12, MSI F11, Intel NUC F10, Beelink and mini PCs F7 (Del opens the BIOS setup)](https://media1.xproxy.io/docs/install/boot-keys.webp)

> The PC starts Windows or the old system instead? You were too late or picked the wrong line. Switch it off and try again. More help is at the end of this page.

**Step 4: Choose your language**

Click your language in the list. English is already selected. Then click **Next**.

![Ubuntu installer, Choose your language, with English selected and the Next button](https://media1.xproxy.io/docs/install/u1-language.webp)

**Step 5: Keyboard**

Click **Next** on the Accessibility page. You do not need to change anything there.

On the next page, check that your keyboard layout is right (**English (US)** for most keyboards). Click **Next**.

![Ubuntu installer, Accessibility page with the Next button](https://media1.xproxy.io/docs/install/u2-accessibility.webp)

> Not sure about your layout? Type a few letters in **Type here to test your keyboard** and look at what you get.

**Step 6: Connect to the internet**

Choose **Use wired connection** and click **Next**.

If the installer says **An update is available for the installer**, click **Skip**.

![Ubuntu installer, Connect to the internet, Use wired connection selected and the Next button](https://media1.xproxy.io/docs/install/u4-network.webp)

> The internet cable must stay plugged in for the whole install. No wired option? Check that the cable clicks in and that the lights on the PC and the router are on.

**Step 7: Choose Install Ubuntu**

Select **Install Ubuntu** (not Try Ubuntu). Click **Next**.

![Ubuntu installer, Try or install Ubuntu, Install Ubuntu selected and the Next button](https://media1.xproxy.io/docs/install/u5-install.webp)

**Step 8: Keep the default choices**

Three pages follow. Do not change anything. Only click **Next** on each one:

1. **Interactive installation**: click **Next**.
2. **Default selection**: click **Next**.
3. Third-party software: leave both boxes empty and click **Next**.

![Ubuntu installer, Interactive installation selected and the Next button](https://media1.xproxy.io/docs/install/u6-interactive.webp)

**Step 9: Choose the disk**

Select **Erase disk and install Ubuntu**.

Next to **Advanced features** it must say **None selected**. Do not click that button. Then click **Next**.

![Ubuntu installer, Disk setup, Erase disk and install Ubuntu selected, Advanced features None selected, and the Next button](https://media1.xproxy.io/docs/install/u9-disk.webp)

> **This erases everything on the PC.** Windows, files, all of it. Back up what you need before you click Next.

**Step 10: Create your account**

Fill in the form:

- **Your name**: for example `XProxy`
- **Your computer's name**: for example `xproxy-pc`
- **Your username**: small letters only, for example `xproxy`
- **Password** and **Confirm password**: the same password twice. Click **Show** to see what you type.

Then click **Next**.

![Ubuntu installer, Create your account, the form filled in and the Next button](https://media1.xproxy.io/docs/install/u10-account.webp)

> **Write the password down.** You need it again in step 17.

**Step 11: Check the time zone**

Ubuntu finds your place by itself. If **Location** is wrong, click your country on the map. Then click **Next**.

![Ubuntu installer, Select your timezone with a world map set to New York, America/New_York, and the Next button](https://media1.xproxy.io/docs/install/u11-timezone-v2.webp)

**Step 12: Start the install**

The last page lists your choices. **Disk setup** should say **Erase disk and install Ubuntu**. Click **Install**.

![Ubuntu installer, Ready to install, the list of choices and the Install button](https://media1.xproxy.io/docs/install/u12-review.webp)

**Step 13: Wait for the install**

The installer copies files. This takes **10 to 20 minutes**. Do not switch the PC off and do not unplug anything.

When it is done, the screen says **Ubuntu is installed and ready to use**.

![Ubuntu installer copying files, with the progress bar at the bottom](https://media1.xproxy.io/docs/install/u13-copying.webp)

> The screen goes dark or the picture does not move for a few minutes? That is normal. Wait.

**Step 14: Restart the PC**

Click **Restart now**.

The screen shows **Please remove the installation medium, then press ENTER**. Pull out the USB stick, then press **Enter**.

![Ubuntu installer, Installation complete, with the Restart now button](https://media1.xproxy.io/docs/install/u14-done.webp)

> Forgot to pull out the USB stick? The PC may open the installer again. Switch it off, pull out the stick and switch it on.

**Step 15: Log in**

Click your name, type your password and press **Enter**. You see the Ubuntu desktop. Ubuntu is ready.

If a welcome window opens, click **Next** until you can click **Finish**.

![Ubuntu login screen with the user name](https://media1.xproxy.io/docs/install/u16-login.webp)

**Step 16: Open the Terminal**

The **Terminal** is the window where you type commands. Pick one way:

1. **Keyboard:** hold **Ctrl** and **Alt**, then press **T**.
2. **Mouse:** click **Show Apps** (the dots at the bottom left), type `terminal`, then click **Terminal**.

A dark window opens. It ends with `$` and a blinking cursor.

![Ubuntu Show Apps with terminal typed in the search box and the Terminal icon](https://media1.xproxy.io/docs/install/t1-showapps.webp)

> A window says **Ubuntu 26.04 LTS Upgrade Available** (third picture)? Click **Don't Upgrade** for now, so the install goes quickly. XProxy works on 26.04 too, so you can upgrade later. For other update pop-ups, click **Remind Me Later**.

**Step 17: Become root**

Root is the administrator account. It is allowed to install software. In the Terminal, type this and press **Enter**:

Terminal

```
sudo su
```

It asks for a password. Type the password from the account step and press **Enter**. **Nothing shows while you type.** That is normal.

The last line now ends with `#` instead of `$`. You are root.

![Terminal after sudo su, the last line ends with a hash sign](https://media1.xproxy.io/docs/install/t4-root2-v2.webp)

> You can paste into the Terminal with **Ctrl+Shift+V**. Normal **Ctrl+V** does not work there. Or just type the command.

**Step 18: Install curl**

curl is a small tool that downloads files. Type this and press **Enter**:

Terminal

```
apt-get update && apt-get install curl -y
```

Your command is at the top. Wait for the last line to show `root@...#` again. It takes about 1 minute.

![Terminal after the apt-get command, ending with the root prompt](https://media1.xproxy.io/docs/install/x1-apt-v2.webp)

> See **Could not resolve host**? The PC has no internet. Check the cable. See **Could not get lock**? Ubuntu is updating in the background. Wait 3 minutes, then run the command again.

**Step 19: Install XProxy**

Type this and press **Enter**:

Terminal

```
curl -s https://x-proxy.io/install | bash
```

The XProxy installer starts and shows its steps. It takes **1 to 5 minutes**. Do not close the window.

![Terminal with the XProxy install command typed](https://media1.xproxy.io/docs/install/x2-curl-v2.webp)

**Step 20: See that it worked**

When it is done you see **Installation completed successfully** and the **Dashboard Access URLs**. That address is the way to your XProxy panel. Write it down or take a photo. Yours is different from the one in the picture.

The PC may restart by itself now. That is normal. If it does, log in again and wait 2 minutes.

![The XProxy installer finished: Installation completed successfully, and the Dashboard Access URLs](https://media1.xproxy.io/docs/install/x4-done-v2.webp)

> **XProxy is installed.** The last step: open the dashboard.

**Step 21: Open your dashboard**

On a computer or phone that uses the same router, open your browser and type the address from **Dashboard Access URLs** (for example `http://192.168.1.50`).

Can't open it? See [how to open your dashboard](https://xproxy.io/document/how-access-dashboard-xproxy).

The software starts unactivated. To unlock all features, follow [Activate your device and buy a plan](https://xproxy.io/document/how-active-upgrade-license).

> Your PC must stay on and plugged in to the router for XProxy to work.

**What's next?**

Activate your device and pick a plan: [Activate your device and buy a plan](https://xproxy.io/document/how-active-upgrade-license).

## Still stuck?

| What you see | Why, and what to do |
| --- | --- |
| The PC starts Windows or the old system, not the installer | The PC did not boot from the USB stick. Switch it off, switch it on and press the boot menu key (step 3) again and again. Choose the line with **USB**. Try another USB port, best one at the back of the PC. Still nothing? Make the USB stick again with balenaEtcher. |
| The screen stays black after you choose the USB stick | Wait 2 minutes. Still black? Restart and, in the same menu as step 3, choose **Ubuntu (safe graphics)**. |
| The installer finds no disk | Open the PC's setup screen (BIOS): switch the PC on and press **Del** or **F2** again and again. Change **SATA Mode** from **RAID** or **Intel RST** to **AHCI**. Then start again. This is common on Dell, HP and Lenovo PCs. |
| No wired connection, or "Could not resolve host" | The PC has no internet. Plug the cable in again, check the lights on the PC and the router, and restart the router. To test, type `ping -c 3 x-proxy.io` in the Terminal. You should see replies. |
| Ubuntu does not show anything when I type my password | This is normal in the Terminal. Type it and press Enter. "Sorry, try again" means a wrong password: it is the one you made in the account step. |
| "Permission denied" | You are not root. Type `sudo su` (step 17). The last line must end with `#`. |
| "curl: command not found" | Step 18 did not finish. Run `apt-get update && apt-get install curl -y` again. |
| "Could not get lock /var/lib/dpkg/lock" | Ubuntu is updating in the background. Wait 3 minutes and run the command again. |
| "Unsupported operating system. Ubuntu / Debian / Armbian is required" | The PC does not run Ubuntu, Debian or Armbian. Install Ubuntu 24.04 LTS first (steps 1 to 15). |
| The XProxy install stops with an error | Check the internet, then run `curl -s https://x-proxy.io/install \| bash` again. It is safe to run it more than once. |
| The dashboard does not open | Wait 2 minutes after the PC restarts. Use a computer on the same router. Then follow [how to open your dashboard](https://xproxy.io/document/how-access-dashboard-xproxy). |

**Nothing worked?** Message us on [Telegram (@xproxyio)](https://t.me/xproxyio) and send:

1. The step number you are on.
2. A photo or screenshot of the whole screen, with the error visible.
3. The brand and model of your PC.

## Other devices

XProxy runs on most Ubuntu-, Debian- or Armbian-based devices. Using an ARM board such as an Orange Pi or Raspberry Pi? Install a 64-bit Armbian or Ubuntu image made for your board, then start at step 16.

XProxy also supports other vendors' devices or configurations (e.g. [Proxidize](https://xproxy.io/alternative/proxidize) or [iProxy](https://xproxy.io/alternative/iproxy)) seamlessly. You can keep your hardware and switch to cheaper, more feature-rich XProxy software. Contact support for a migration offer.

---

Source: https://xproxy.io/document/installing-xproxy-software
