Tullio Facchinetti

xterm-kitty: unknown terminal type

by Tullio Facchinetti

Categories: article lang_en article_en software tips

[CREDIT: This is mostly a re-post from an article of Lars O. Overskeid to keep the information handy]

Like in the original post, I’m also using kitty as my terminal emulator. There are some really cool features in this terminal emulator.

However, using ssh to connect to a remote host, I find that some keys (backspace), and keyboard shortcuts are not working, and I get the following error from my remote debian host:

'xterm-kitty': unknown terminal type.

This is because my remote host does not know how to handle kitty by default. Luckily, there’s a way to communicate what capabilities your terminal emulator have, using terminfo.

In order to copy over a terminfo file to your remote host’s ~/.terminfo folder, run the following:

kitty +kitten ssh your.remote.server

This will open a new session, and you should now have a file called ~/.terminfo/x/xterm-kitty, which will be loaded on every session from kitty in the future. Also, all normal keyboard shortcuts are working as intended.

ALERT: as noted in this issue on kitty’s github issue tracker, make sure to close all tmux session and open a new one after the copy of terminfo files.


  • Students and theses
  • Publications
  • Thesis topics
  • Curated awesome list of CLI apps
  • Last updates (English)

  • Speed up the compilation of LaTex Beamer presentations ()
  • Students and theses ()
  • Students and theses - English ()
  • Learn enough C to survive ()
  • Workflow for writing theses collaboratively ()
  • Guidelines for theses and presentations ()
  • Projects ()
  • Last updates (Italian)

  • Risultati FdI 8 e 11 aprile 2024 ()
  • Risultati FdI 20 Febbraio 2024 ()
  • Risultati FdI 02 Febbraio 2024 ()
  • Risultati FdI 20-27 Novembre 2023 ()
  • Risultati FdI 28 Settembre 2023 ()
  • Risultati FdI 01 Settembre 2023 ()
  • Risultati FdI 27 Luglio 2023 ()
  • List of categories

    Article Article_en Article_it C Courses Fdi Lang_en Lang_it Latex Programming Project Research Results Robotics Software Teaching Thesis Tips