https://github.com/penguinztech/egpu-fix
Fix script for NVIDIA eGPU (Razer Core X / RTX 5070) Thunderbolt 3 broken PCIe link state on Ubuntu
https://github.com/penguinztech/egpu-fix
Last synced: about 2 months ago
JSON representation
Fix script for NVIDIA eGPU (Razer Core X / RTX 5070) Thunderbolt 3 broken PCIe link state on Ubuntu
- Host: GitHub
- URL: https://github.com/penguinztech/egpu-fix
- Owner: PenguinzTech
- Created: 2026-03-28T01:45:18.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T02:04:10.000Z (3 months ago)
- Last Synced: 2026-03-28T08:30:45.024Z (3 months ago)
- Language: Shell
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# egpu-fix
Fix script for NVIDIA eGPU (Razer Core X / RTX 5070) Thunderbolt 3 broken PCIe link state on Ubuntu.
## The Problem
After rebooting without the eGPU powered on first, the Alpine Ridge TB3 bridge caches a broken PCIe link state. The GPU appears in `lspci` but responds with `Unknown header type 0x7f` — it has "fallen off the bus" and the NVIDIA driver fails to load, causing system freezes.
## Quick Start
```bash
sudo ./egpu-fix.sh
```
## Hardware
| Component | Details |
|-----------|---------|
| GPU | NVIDIA GeForce RTX 5070 (GB205) |
| Enclosure | Razer Core X (Thunderbolt 3) |
| Host | Intel Alder Lake-P, Alpine Ridge 2C (JHL6340) |
| OS | Ubuntu, kernel 6.17.0+ |
| Driver | nvidia-driver-590-open (latest 590+) |
## Files
- [`egpu-fix.sh`](egpu-fix.sh) — Automated 7-step reset script
- [`EGPU_FIX.md`](EGPU_FIX.md) — Full documentation: root cause, manual steps, diagnostics, what doesn't work
## Prevention
Power on the Razer Core X and connect the Thunderbolt cable **before booting** the laptop.