Skip to content

Installing XProxy Software

Ask AI

Ready taskDo it with me, step by step

Chat assistants

Open in ChatGPTNew tabOpen in ClaudeNew tab

Coding agents

Claude CodeOpens the desktop appCodexOpens the desktop appCursorOpens the app from the web

Copy

View as MarkdownPlain text for AI tools
See the prompt
Read https://xproxy.io/document/installing-xproxy-software.md, the XProxy guide "Installing XProxy Software". If you cannot open links, download them with curl. Then take me through it one step at a time: tell me exactly what to click or type, wait until I say it is done, and help me when what I see is different from the guide. Start by asking what I have (hardware, XProxy version, what I see now).
Other XProxy guides, each with a Markdown copy at its URL + .md, are listed in https://xproxy.io/llms.txt.

The app opens with the prompt filled in. Nothing runs until you press Enter.

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

  • A USB stick of 8 GB or more.
    Drawing of a USB stick
    SanDisk Cruzer Blade 32 GB USB stickExample product. Any USB stick of 8 GB or more works.View on Amazon
  • 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). On Ubuntu Server, just log in: you are already in a terminal, so start at 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).

1. Download Ubuntu

Step 1 of 21

Download Ubuntu

On any computer, download Ubuntu 24.04 LTS here: ubuntu-24.04.5.1-desktop-amd64.iso (about 6 GB).

If that link stops working, open 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.

Still stuck?

What you seeWhy, and what to do
The PC starts Windows or the old system, not the installerThe 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 stickWait 2 minutes. Still black? Restart and, in the same menu as step 3, choose Ubuntu (safe graphics).
The installer finds no diskOpen 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 passwordThis 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 errorCheck 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 openWait 2 minutes after the PC restarts. Use a computer on the same router. Then follow how to open your dashboard.
Nothing worked? Message us on Telegram (@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 or iProxy) seamlessly. You can keep your hardware and switch to cheaper, more feature-rich XProxy software. Contact support for a migration offer.

Still stuck?A technician can look at your device with a one-time PIN, or chat with us on Telegram.