Installing XProxy Software
Ask AI
Ready taskDo it with me, step by step
Chat assistants
Open in ChatGPTNew tabOpen in ClaudeNew tabCoding agents
Claude CodeOpens the desktop appCodexOpens the desktop appCursorOpens the app from the webCopy
View as MarkdownPlain text for AI toolsSee 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.
- 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.
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.
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
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.
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. |
- The step number you are on.
- A photo or screenshot of the whole screen, with the error visible.
- 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.

