This is an old revision of the document!
Razer Core X eGPU
Updated procedure for Linux Mint 22 and eGPU running Nvidia GTX 1060 6GB
Regarding hot-plug
Thunderbolt (TB3/TB4) is explicitly designed for hot-plugging.
It uses :
- Hot-plug–safe PCIe tunneling
- Overcurrent protection
- Digital handshaking before enabling high-power lanes
- Cable and device negotiation before link-up
- Mandatory protective circuitry required by Intel’s TB certification
You are supposed to plug and unplug TB devices while the system is powered — that’s how eGPUs, docks, displays, and drives are meant to work.
There is no scenario in which hot-plugging a functioning Thunderbolt cable damages the hardware.
Plug-in sequence
- Power on laptop normally - Log into desktop - Turn ON the eGPU enclosure - Wait 2–3 seconds (GPU initializes) - Plug in the Thunderbolt cable - Wait for the OS to detect/authorize the eGPU
Unplug sequence
- Close any apps using the eGPU (optional but safer) - Save your work - Unplug the Thunderbolt cable - Wait 2–3 seconds - Power OFF the eGPU enclosure if desired
Note: On older Thunderbolt 3 laptops (e.g. 2017 Razer Blade Stealth), the eGPU must be plugged after boot, otherwise the system may hang during startup.
Setup Procedure (Linux Mint 22 + Razer Core X + GTX 1060)
1. Install Thunderbolt tools
sudo apt install bolt thunderbolt-tools
Ensure the bolt service is running:
systemctl status bolt
2. Verify Thunderbolt controller
lspci | grep -i thunderbolt lsmod | grep thunderbolt
Expected:
- Intel Thunderbolt controller listed
- thunderbolt kernel module loaded
3. BIOS configuration
In BIOS:
- Thunderbolt: Enabled
- Security Level: No Security (SL0)
⚠️ Required, otherwise devices may not enumerate under Linux.
4. Connect and authorize the eGPU
Boot the laptop without the eGPU connected.
Then:
- Power ON the Core X
- Plug the Thunderbolt cable
Check detection:
boltctl list
If needed:
sudo boltctl authorize <UUID>
Verify PCIe device:
lspci | grep -i nvidia
5. Install NVIDIA driver
Install the recommended driver (for GTX 1060):
sudo apt install nvidia-driver-535
⚠️ Do NOT use NVIDIA .run installer (breaks package management and updates)
6. Disable nouveau driver
echo "blacklist nouveau" | sudo tee /etc/modprobe.d/blacklist-nouveau.conf echo "options nouveau modeset=0" | sudo tee -a /etc/modprobe.d/blacklist-nouveau.conf sudo update-initramfs -u
Reboot (without eGPU connected).
7. Create PRIME offload helper
Linux Mint 22 does not provide prime-run by default.
Create it manually:
sudo nano /usr/local/bin/prime-run
Content: