Sobre o conteúdo

Nesse post, vou mostrar como é fácil instalar e configurar o wayland no Gnome 48 com placa de vídeo NVIDIA no Debian 12/13.

Primeiro, é importante ressaltar que essa instalação será feita em uma máquina com as seguintes configurações:

  • OS: Debian sid
    • Kernel: 6.16.7
    • DE: Gnome 48.5
    • Greeter: GDM3
    • Display Server: Xorg
  • GPU: RTX 3070
    • Driver: 580.82.09
  • SecureBoot: Ativado
  • DKMS: Ativado

Instalação do driver NVIDIA

No momento que escrevo esse post, já tenho o sistema rodando com driver NVIDIA usando o Xorg como servidor gráfico.

Antes de tudo vou atualizar o driver para a versão mais recente, que no momento é a 580.82.09.

O download do driver você pode fazer diretamente no site da NVIDIA aqui.

Para instalar o driver, após o download, primeiramente torne o arquivo executável com permissão de execução:

chmod +x NVIDIA-Linux-x86_64-580.82.09.run

após isso, execute o arquivo como superusuário:

sudo ./NVIDIA-Linux-x86_64-580.82.09.run

E siga o passo a passo da instalação.

A primeira etapa ele irá questionar sobre qual módulo vocẽ deseja utilizar, pois nesse sistema há duas opções: NVidia Proprietário e MIT/GPL. Eu geralmente utiliza o módulo de kernel open source (MIT/GPL), mas você pode escolher o que melhor se adequa a sua necessidade. Módulo de kernel NVIDIA

A próxima etapa ele avisa que estou executando o instalador em um ambiente gráfico e que é recomendado sair do ambiente gráfico para evitar possíveis problemas. Porém eu costumo instalar direto no ambiente gráfico e nunca tive problemas. Aviso de ambiente gráfico

Logo após vem outro aviso sobre o módulo de kernel ‘nvidia-uvm’ que está carregado e que é necessário descarregá-lo para continuar a instalação. Novamente, eu costumo prosseguir com a instalação mesmo com o módulo carregado e nunca tive problemas. Aviso de módulo carregado

Mais um aviso, que é sobre continuar a instalação mesmo sem a possibilidade de rodar as sanity checks, novamente eu costumo prosseguir e nunca tive problemas. Aviso de sanity checks

E o último aviso apenas reforçando que algumas sanitiy checks não poderão ser executadas e que é recomendado reiniciar o sistema após a instalação. Aviso final

Se você tem algum receio, pode seguir as recomendações e sair do ambiente gráfico, descarregar o módulo e então rodar o instalador, mas como eu disse, nunca tive problemas em prosseguir com a instalação mesmo com esses avisos.

O modo mais fácil é iniciar o sistema em modo de recuperação (recovery mode) e então prosseguir com a instalação.

Após todos os avisos iniciais, vem mais um aviso kkkkkk Agora sobre o sistema já possuir um driver instalado e que ele será removido durante a instalação. Aviso de driver existente

Então ele começa a construir o módulo de kernel. Construção do módulo de kernel

E ao concluir ele solicita se você deseja assinar o módulo de kernel. Aqui é importante assinar o módulo, pois caso contrário, se você estiver com o SecureBoot habilitado na BIOS, o módulo não será carregado. Assinatura do módulo de kernel

Ao assinar o módulo, ele irá solicitar se você já possui uma chave criada ou se deseja criar uma nova. Se você já usa DKMS e já possui outros módulos assinados, pode usar a mesma chave.

Veja meu artigo sobre como assinar módulos de kernel com DKMS. Chave para assinatura do módulo

Ao selecionar a opção de usar um par de chaves existentes, ele irá solicitar primeiro o arquivo da chave privada e depois o arquivo da chave pública. Seleção da chave privada Seleção da chave pública

Ao finalizar ele assina o módulo e solicita se você deseja instalar as bibliotecas de 32 bits. Eu geralmente instalo, mas se você não for usar algum software que precise dessas bibliotecas, pode optar por não instalar. Instalação das bibliotecas de 32 bits

Então ele irá desinstalar o driver antigo. Desinstalação do driver antigo

E ao terminar a desinstalação, ele pergunta se você deseja registrar os módulos do kernel no DKMS. Aqui é importante selecionar “Yes”, assim o módulo será registrado no DKMS e sempre que houver uma atualização do kernel, o módulo será reconstruído automaticamente. Registro no DKMS

Ao aceitar o registro então ele prossegue com a instalação. Registro no DKMS Instalação do driver

Ao finalizar a instalação, ele pergunta se você deseja executar o utilitário de configuração nvidia-xconfig para atualizar o arquivo xorg.conf. Aqui é importante selecionar “No”, pois se você selecionar “Yes”, ele irá criar um arquivo xorg.conf que é de uso do Xorg (X11), e como queremos usar o Wayland, não precisamos desse arquivo.

Ademais, já temos esse arquivo criado pois por padrão o gnome usa o Xorg como servidor gráfico quando utilizado um driver proprietário da NVIDIA. nvidia-xconfig

E no final apenas temos a confirmação de que a instalação foi concluída com sucesso e novamente um lembrete para reiniciar o sistema. Instalação concluída Reiniciar o sistema

Habilitando o módulo kernel nvidia-drm

No debian 12/13, o módulo nvidia-drm não é carregado por padrão, e ele é essencial para que o Wayland funcione corretamente com o driver proprietário da NVIDIA.

Para incializar o módulo nvidia-drm durante a inicialização do sistema, podemos editar o editar o arquivo do gerenciador de inicialização.

No meu caso eu utilizo o GRUB, então edito o arquivo /etc/default/grub e adiciono a seguinte linha:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash ... nvidia-drm.modeset=1"

Veja um exemplo do meu arquivo /etc/default/grub:

Exemplo do arquivo grub

Após editar o arquivo, salve e então atualize o GRUB com o comando:

sudo update-grub

Verificando os serviços adicionais da NVIDIA

Também é importante verificar se os serviços adicionais da NVIDIA estão habilitados e rodando corretamente. Esses serviços são: nvidia-hibernate.service, nvidia-resume.service e nvidia-suspend.service.

Para verificar o status desses serviços, rode o comando:

systemctl status nvidia-hibernate.service nvidia-resume.service nvidia-suspend.service

Se eles não estiverem habilitados, você pode habilitá-los com o comando:

sudo systemctl enable nvidia-hibernate.service nvidia-resume.service nvidia-suspend.service

Além disso, você precisará verificar se o parâmetro PreserveVideoMemoryAllocations do módulo NVIDIA está ativado. Para isso, rode o seguinte comando:

echo 'options nvidia NVreg_PreserveVideoMemoryAllocations=1' > /etc/modprobe.d/nvidia-power-management.conf

Esses serviços são importantes para o gerenciamento de energia e para evitar problemas de tela preta ao suspender ou hibernar o sistema. E caso não estejam habilitados, o GDM não irá habilitar a opção de usar o Wayland no Gnome.

As regras podem ser vistas no arquivo /usr/lib/udev/rules.d/61-gdm.rules.

Finalizando

Após todas essas configurações, reinicie o sistema e na tela de login do GDM, clique no ícone de engrenagem e selecione a opção “GNOME”. Você verá que além dessa opção, também estará disponível a opção “GNOME sobre Xorg”, que é o backend X11.

Só selecionar a opção “GNOME” e fazer login normalmente. Ao visualizar as informações do sistema, você verá que o Wayland está ativo. Wayland ativo

E é isso galera, espero que esse post tenha ajudado vocês a configurar o Wayland no Gnome com placa de vídeo NVIDIA no Debian 12/13.

Abraços! ❤️