Corrigir travamento do Element Desktop no Linux Wayland

Como seria uma correção bem-sucedida?

O Element Desktop deve permanecer aberto durante a ação que costumava causar a falha: iniciar sessão, participar de uma chamada, compartilhar a tela ou deixar o aplicativo ocioso em segundo plano. Uma única inicialização bem-sucedida não é suficiente para confirmar a correção. Teste o mesmo gatilho mais de uma vez e verifique se o aplicativo permanece estável após o computador ser suspenso e retomado.

Wayland não é a única causa possível. O Element Desktop é um aplicativo Electron, e uma falha pode envolver o compositor Wayland, o Xwayland, os drivers gráficos, uma atualização recente do aplicativo ou uma compilação específica do pacote. Os passos abaixo utilizam testes pequenos e reversíveis para restringir as possibilidades. Eles não comprovam que toda falha do Element no Linux seja um defeito do Wayland.

Verificado em 6 de outubro de 2026. O Electron 38 alterou o padrão para que os aplicativos Electron sejam iniciados nativamente no Wayland quando a sessão reportar XDG_SESSION_TYPE=wayland. O Electron documenta --ozone-platform=x11como uma forma de usar o Xwayland. Essa alteração só é relevante se a versão do Electron incluída na sua compilação do Element a contiver; a versão do Element e a origem do pacote determinam isso. Consulte as notas de lançamento do Electron 38 e as notas de alterações significativas do Electron .

1. Confirme se a sessão da área de trabalho é Wayland.

Abra um terminal e execute o seguinte comando:

echo $XDG_SESSION_TYPE

Se a saída for wayland, continue. Se disser x11, o login atual já está usando X11, portanto, um teste de inicialização específico para Wayland não explicará a falha. Você também pode identificar os detalhes da área de trabalho e da sessão com:

echo "$XDG_CURRENT_DESKTOP"
loginctl show-session "$XDG_SESSION_ID" -p Type

Anote o ambiente de trabalho, o hardware gráfico e como você instalou o Element. Esses detalhes ajudam a distinguir uma falha geral de um problema limitado a um compositor, driver de GPU ou versão de pacote específico.

2. Compare o Wayland nativo com o Xwayland.

Primeiro, feche qualquer janela do Element que esteja aberta. Para um pacote Debian ou Ubuntu que forneça o element-desktopcomando, execute-o a partir de um terminal com:

element-desktop --ozone-platform=x11

Deixe o terminal aberto para que quaisquer erros de inicialização permaneçam visíveis. Use o Element normalmente e repita a ação que geralmente causa a falha. Se a execução do Xwayland permanecer estável enquanto uma inicialização normal falhar, isso é uma evidência útil de um problema de caminho ou integração do Wayland. É um resultado de diagnóstico, não uma prova do defeito subjacente exato.

Para retornar ao comportamento normal, feche o Element e inicie-o a partir do iniciador de aplicativos padrão. O parâmetro se aplica somente ao processo iniciado com esse comando. O Electron documenta a opção Xwayland em suas notas de plataforma BrowserWindow .

Se sua instalação for Flatpak ou outro pacote da comunidade, não assuma que o comando acima se destina ao aplicativo em sandbox. Verifique o comando de inicialização do pacote ou use o método específico do pacote para passar um argumento de aplicativo. A página de downloads do Element lista as instruções para o pacote Debian/Ubuntu e identifica o Flatpak e vários outros pacotes Linux como mantidos pela comunidade: Downloads do Element Desktop .

3. Atualize o elemento a partir da mesma fonte do pacote.

Se a mudança para o Xwayland alterar o resultado, ou se a falha começou após uma atualização, instale a versão estável mais recente oferecida pela fonte que você já utiliza. Atualizar a partir da mesma fonte evita a execução acidental de duas versões com launchers, caminhos de configuração ou versões do Electron diferentes.

Para sistemas Debian ou Ubuntu instalados a partir do repositório oficial do Element, atualize o índice de pacotes e atualize o Element:

sudo apt update
sudo apt install --only-upgrade element-desktop

Para Flatpak, atualize através da central de software ou execute o comando flatpak update. Para Arch, Fedora, openSUSE ou outra distribuição, use o gerenciador de pacotes e o repositório que você escolheu originalmente. Não instale uma versão "nightly" não relacionada como correção de falha; a Element rotula suas versões nightly como versões de teste instáveis.

Após a atualização, feche completamente o Element e abra-o novamente. No Element, abra Configurações → Ajuda e Sobre para verificar a versão do cliente, caso o aplicativo permaneça aberto por tempo suficiente. Isso é útil para comparar relatórios ou entrar em contato com o suporte. Evite fazer o downgrade para uma versão antiga, a menos que os mantenedores da distribuição ou o suporte do Element recomendem especificamente; versões antigas podem não conter correções e atualizações de segurança.

4. Teste a aceleração gráfica e colete evidências de falhas.

Se o aplicativo ainda apresentar falhas tanto normalmente quanto com o Xwayland ativado, tente executá-lo com a aceleração de GPU do Chromium desativada:

element-desktop --disable-gpu

Este é um teste temporário de resolução de problemas, não uma configuração permanente recomendada. Se a falha desaparecer apenas com esta opção ativada, o resultado indica um problema de interação com a placa gráfica ou o driver; ele não identifica se a culpa é do driver, do compositor, do Electron ou do código do aplicativo. A reprodução de vídeo e outros recursos que exigem muito processamento gráfico também podem se comportar de maneira diferente. Feche o processo e reinicie-o sem a opção ativada para desfazer o teste.

Para travamentos que ocorrem durante chamadas ou compartilhamento de tela, teste essas ações separadamente. Um problema histórico do Element descreveu um travamento durante o compartilhamento de tela no Wayland em uma versão anterior do Element; isso não deve ser interpretado como uma confirmação de que as versões atuais compartilham o mesmo defeito. O repositório do projeto foi arquivado, portanto, use os canais de suporte e pacotes atuais para novos relatos: relatório histórico de compartilhamento de tela no Wayland .

Capture os registros próximos ao momento da falha. Em sistemas que utilizam o journal do systemd, tente:

journalctl --user -b --since "10 minutes ago" | grep -iE 'element|wayland|gpu'

Se o sistema registrou um despejo de memória (core dump), ele poderá ser listado aqui:

coredumpctl list element-desktop

Os registros podem incluir nomes de usuário, caminhos de arquivos, detalhes da sala ou do servidor, ou outras informações privadas. Revise e edite-os antes de publicá-los. Se a busca no registro não retornar nada, isso não prova que não houve falha; alguns pacotes e sistemas registram as informações de forma diferente. O relatório de falhas ou os registros do sistema da sua distribuição podem ser mais úteis.

Proteja os dados da sua sessão local.

Não comece excluindo `/etc/fstab` ~/.config/Element, ~/.config/Riot`/etc/fstab` ou um diretório de dados Flatpak. Esses locais podem conter o estado local do aplicativo e removê-los pode encerrar sua sessão ou afetar as chaves de criptografia e configurações armazenadas localmente. Uma redefinição é um recurso de diagnóstico de último caso, não uma correção rotineira para o Wayland. Antes de considerar uma redefinição, confirme se você consegue fazer login novamente e se suas chaves de criptografia ou chave de recuperação estão salvas. Prefira etapas que não alterem o perfil.

Se o Element abrir, mas apresentar comportamento estranho, utilize as configurações e orientações de suporte do próprio aplicativo antes de alterar os arquivos de perfil. Para obter informações sobre configurações de conta e versão, consulte a documentação atual de configurações do cliente Element .

Como saber se a correção funcionou?

Use a mesma sequência que anteriormente causou a falha: inicie o Element, faça login, deixe-o em segundo plano, participe do tipo de chamada relevante e teste o compartilhamento de tela, caso esse fosse o problema. Repita a sequência após reiniciar o aplicativo normalmente. Na prática, o Element permanece responsivo e nenhum novo travamento ou despejo de memória ocorre durante essas verificações.

• Estável apenas com --ozone-platform=x11: mantenha isso como uma solução alternativa temporária, se necessário, e relate a versão do Element, a origem do pacote, a distribuição Linux, o ambiente de desktop, a GPU e as etapas de reprodução por meio de um canal de suporte atual.
• Estável apenas com --disable-gpu: investigar atualizações de drivers gráficos e compositores e incluir o resultado do teste em um relatório de suporte. Espere possíveis concessões gráficas enquanto a flag estiver ativa.
• O problema persiste em ambos os testes: atualize através da sua fonte de pacotes existente, capture os logs e verifique se a mesma conta funciona no Element Web. Se apenas o Desktop apresentar falhas, inclua os logs e a causa exata do problema em uma solicitação de suporte; se ambos falharem, investigue também as causas relacionadas à conta, ao servidor ou à rede.

Não existe um único comando que garanta a correção de todas as falhas do Linux Wayland. O resultado útil é uma melhoria de estabilidade reproduzível e evidências suficientes para identificar qual camada precisa de atenção.