doc(gpu): add troubleshooting page (#5661)

* doc(gpu): add troubleshooting page

* Apply suggestions from code review

Co-authored-by: Rowena Jones <[email protected]>

---------

Co-authored-by: Benedikt Rollik <[email protected]>
Co-authored-by: Rowena Jones <[email protected]>

Author: 3 people

pages/gpu/troubleshooting/fix-upgrading-issue.mdx

@@ -0,0 +1,12 @@
+---
+title: Fixing OS upgrading issues on GPUs
+description: Fixing OS upgrading issues on GPUs.
+tags: gpu issue error driver nvidia-driver gpu-instance upgrade
+dates:
+  validation: 2025-10-15
+  posted: 2025-10-15
+---
+
+When upgrading Ubuntu packages with `apt-get upgrade` if Nvidia packages are included in the update, the Nvidia setup can break. 
+
+We recommend upgrading using `apt-get list-upgrade` and then rebooting the Instance.

pages/gpu/troubleshooting/index.mdx

@@ -58,7 +58,8 @@ productIcon: GpuServersProductIcon
 ## GPU Instances troubleshooting pages
 
 <LinksList>
-  - [Fixing GPU issues after installing NVIDIA driver packages](/gpu/troubleshooting/fix-driver-issues)
-  - [Installing NVIDIA drivers on Ubuntu 22.04](/gpu/troubleshooting/install-nvidia-drivers-ubuntu)
-  - [Fixing GPU issues after upgrading GPU Instances with cloud-init](/gpu/troubleshooting/updating-gpu-instance-with-cloud-init)
+  - [Fixing GPU issues after installing NVIDIA driver packages](/gpu/troubleshooting/fix-driver-issues/)
+  - [Fixing upgrading issues on GPU OS](/gpu/troubleshooting/fix-upgrading-issue/)
+  - [Installing NVIDIA drivers on Ubuntu 22.04](/gpu/troubleshooting/install-nvidia-drivers-ubuntu/)
+  - [Fixing GPU issues after upgrading GPU Instances with cloud-init](/gpu/troubleshooting/updating-gpu-instance-with-cloud-init/)
 </LinksList>