linux:egpu

This is an old revision of the document!


Updated procedure for Linux Mint 22 and eGPU running Nvidia GTX 1060 6GB

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.

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
  • linux/egpu.1777112764.txt.gz
  • Last modified: 2026/04/25 12:26
  • by mh