---
title: Fixing GPU issues after installing nvidia-driver packages
description: Resolve GPU issues on Scaleway GPU Instances after installing Nvidia drivers with our troubleshooting guide.
tags: gpu issue error driver nvidia-driver sleep gpu-instance
dates:
  validation: 2025-07-15
  posted: 2022-12-01
---

All Scaleway [GPU Instances](/gpu/quickstart/) come with a Nvidia driver preinstalled. This means you do not have to install them by yourself.

The drivers installed on each Instance are from the `nividia-headless-<driver version>` packages. These are intended for use on Instances without a Windows Desktop or display server.

<Message type="important">
    NVIDIA Blackwell architecture based GPU Instances (B300) require the latest open-source version of the [Nvidia drivers](https://developer.nvidia.com/blog/nvidia-releases-open-source-gpu-kernel-modules/#:~:text=This%20release%20is%20a%20significant,modules%20increase%20ease%20of%20use) to work properly on GPU Instances.
</Message>

<Message type="important">
    The manual installation of a `nvidia-driver` package forces the installation of the `xorg` display server and other Gnome packages. As there is no physical display connected to the GPU of your Instance, this may cause side effects such as your Instance entering into sleep mode after a while. The user will get disconnected as a result.
</Message>

If you have `nvidia-driver-*` packages installed on your GPU Instance, remove them from the Instance using the `apt purge` command and make sure to install and use `nvidia-headless-*` packages instead.

<Message type="tip">
  If you want to use `ffmpeg` in a Docker container on your GPU Instance, make sure to install the `libnvidia-encode` library corresponding to the driver version installed on your Instance.
  For example: `apt install -y libnvidia-encode-525`  (with GPU OS12).
  You also need to specify the driver capabilities to launch your containers (By default graphics and video are not enabled):
  ```
  docker run --rm --runtime=nvidia -e NVIDIA_DRIVER_CAPABILITIES=graphics,video
  ```
</Message>