Disclaimer: Modifying your Xbox One’s internal drive can void your warranty, violate Microsoft’s terms of service, and result in a console ban if done incorrectly or for piracy. This guide is for educational purposes regarding legitimate repairs/upgrades (e.g., replacing a failed drive). Proceed at your own risk.
In the Linux terminal:
# Install git (if not present)
sudo apt update && sudo apt install git -y
Hardware
- New internal drive (2.5” SATA): Max 2TB for original Xbox One, up to 8TB+ for One S/X (officially 16TB max via USB, but internal upgrades >2TB may cause issues; 2TB is safest).
- USB-to-SATA adapter or a desktop PC with SATA ports.
- 8GB+ USB flash drive (for Offline System Update – OSU).
- A computer running Linux (Ubuntu Live USB works perfectly) – xboxonehddmaster9 is a bash script for Linux.
Final Notes
- Do not use xboxonehddmaster9 for piracy – it only repairs/upgrades legitimate hardware.
- SSD upgrade is possible but yields minimal speed gains due to SATA II interface (original) or SATA III (One S/X).
- Always keep the original drive until the new one is fully working.
- If you only need more game storage, an external USB 3.0 drive (128GB+ – up to 16TB) is much easier and risk-free.
For the latest script version and community help, search for “xboxonehddmaster9” on GitHub or r/360hacks (Xbox One storage discussions also appear there). xboxonehddmaster9 install
To install a new internal drive using the xboxonehdd-master script (specifically version 8 or 9), you must partition the drive on a PC before installing it in your console. This process is used for replacing a faulty drive or upgrading to an SSD on the original Xbox One, One S, and One X. Prerequisites Replacement Drive
: A 2.5" SATA HDD or SSD (500GB, 1TB, or 2TB are officially supported). Connection : A SATA-to-USB adapter or an internal SATA port on a PC. xboxonehdd-master-9 script (available on (Offline System Update) file from the official Xbox Support site USB Flash Drive : At least 8GB, formatted to NTFS. Step 1: Partition the Drive on PC Connect your new drive to your Windows PC. Extract the xboxonehdd-master-9.zip file to your desktop. Administrative Command Prompt PowerShell Navigate to the folder inside the extracted directory: cd %USERPROFILE%\Desktop\xboxonehdd-master\win Run the script by typing .\create_xbox_drive.bat Follow the on-screen prompts carefully: Select the correct drive number for your new HDD/SSD to avoid wiping your PC's main drive. Disclaimer: Modifying your Xbox One’s internal drive can
Choose the option to format for your desired size (e.g., 500GB, 1TB, 2TB). Step 2: Transfer System Files (Optional)
If you are upgrading from a working drive and want to keep your data, you can use the script's backup/restore features to copy the System Update System Support User Content folders from the old drive to the new one. Step 2 – Download Required Files In the
Installation & usage (assumes user has a PC and a spare drive)
-
Requirements
- A Windows PC (some tools may work on Linux with extra steps).
- USB-to-SATA adapter or enclosure for the drive.
- The target drive (HDD/SSD) with sufficient capacity.
- The XboxOneHDDMaster9 package and any dependencies (e.g., .NET runtimes, drivers).
- Basic familiarity with disk imaging and command-line or GUI tools.
-
Preparation
- Backup any important data on the target drive (the process can overwrite partitions).
- Install necessary drivers for USB-SATA adapters.
- Disable antivirus or sandboxing if it obstructs the tool (temporarily).
-
Typical install steps
- Download XboxOneHDDMaster9 from a trusted source (verify checksums if available).
- Extract the package and read any included README or instructions.
- If an installer is provided, run as Administrator; if portable, run the executable as Administrator.
- Connect the source (original Xbox drive) and target drive to the PC via adapters.
- Use the tool’s interface or command-line to select source and target drives and begin the cloning/partition operation.
- Monitor for errors; cloning large drives can take hours.
-
Post-install
- Safely disconnect the drive after the tool reports completion.
- Install the drive back in the Xbox One (or connect externally as required).
- Power-cycle the console and check that games/apps and system boot normally.