Erro ao usar SSH: "Error opening terminal: xterm-kitty" como resolver

Flaviano Rodriges

Flaviano Rodriges

— 1 min de leitura
Compartilhar

Erro ao usar SSH: "Error opening terminal: xterm-kitty" — como resolver

A problemática

Se você usa Linux e costuma acessar servidores via SSH, pode acabar se deparando com o seguinte erro ao tentar usar comandos como htop, nano ou outros programas interativos:

Error opening terminal: xterm-kitty.

Esse erro é mais comum para quem usa terminais modernos como o Kitty, mas também pode acontecer com outros.

Por que isso acontece?

Quando você se conecta via SSH a um servidor, o seu computador informa qual tipo de terminal você está usando através de uma variável chamada:

TERM

No caso do Kitty, ele envia algo como:

xterm-kitty

O problema é que muitos servidores não reconhecem esse tipo de terminal, pois não possuem suporte configurado para ele.
Resultado: alguns programas não conseguem abrir corretamente.

Solução rápida (temporária)

Se você precisa resolver isso rapidamente em uma sessão, basta rodar o seguinte comando após conectar via SSH:

export TERM=xterm-256color

Isso força o servidor a usar um tipo de terminal mais comum e compatível.

Solução definitiva (recomendada)

Para não precisar fazer isso toda vez, você pode configurar o SSH para sempre enviar um terminal compatível.

1. Edite o arquivo de configuração do SSH

nano ~/.ssh/config

2. Adicione o seguinte conteúdo:

Host *
  SetEnv TERM=xterm-256color

O que isso faz?

Essa configuração diz:

  • Para qualquer servidor (Host *)
  • Sempre usar xterm-256color como tipo de terminal

Assim, você evita que o SSH envie xterm-kitty (ou outro terminal específico) que pode não ser reconhecido.

Testando a solução

Após salvar o arquivo:

  1. Feche a conexão SSH atual
  2. Conecte novamente
  3. Teste com:
echo $TERM

Se aparecer:

xterm-256color

Está tudo certo.

Dica extra

Se quiser aplicar essa configuração apenas para um servidor específico, você pode fazer assim:

Host meu-servidor
  HostName 192.168.1.10
  User usuario
  SetEnv TERM=xterm-256color

Conclusão

Esse erro acontece por falta de compatibilidade entre o terminal do seu computador e o servidor remoto.
A solução é simples: usar um tipo de terminal mais padrão, como xterm-256color.

Depois de configurado, você não terá mais problemas com esse tipo de erro ao usar SSH.

Fique ligado

Em breve vamos trazer mais conteúdos sobre:

  • SSH na prática
  • configuração de servidores Linux
  • otimização de terminal
  • ferramentas úteis para desenvolvedores

Se tiver dúvidas ou quiser sugerir novos tutoriais, participe da comunidade!

Veja mais