| |```````````````|     |
                           | |               |     |
                           | |      >_<      |     |
                           | |               |     |
                           | |_______________|     |
                           |                   ::::|

                            hterm and Secure Shell
                          Additional information  for
                         Chrom(e|ium) OS 'crosh' Users

This document explains in a little more detail how hterm relates to and interacts with the “crosh” command on ChromeOS and ChromiumOS.

From here on, this document will only mention ChromeOS. You can assume that it applies to ChromiumOS as well.

The “crosh” shell

ChromeOS comes with a small set of command line commands accessible from the “crosh” shell. You can open a new crosh instance with the Ctrl+Alt+T key sequence.

The crosh commands are intended to be used for troubleshooting ChromeOS. Because it is not intended for frequent use, the crosh shell does not have an associated icon in the app launcher. The only way to get to it is via the Ctrl+Alt+T sequence.

You do not need to install any additional applications to access crosh. This is critical for debugging network connectivity issues. It also means we can avoid a “go install this tool” step from diagnostic procedures.

SSH command

The crosh shell used to include an “ssh” command. For security and stability reasons, you must use the “Secure Shell” application instead. See below.

The “Secure Shell” application.

The Secure Shell application is a dedicated ssh client that works on Chrome on all platforms (Windows/Linux/macOS/ChromeOS/etc...).

Unlike the crosh shell, the Secure Shell application does NOT ship with ChromeOS. You've got to manually install it from the Chrome Web Store from this link:


Once installed you should see a new “Secure Shell” icon in your application launcher.

You can get to crosh from Secure Shell by typing >crosh as the host name. (This won't work on non-ChromeOS systems, of course.)

If ChromeOS notices that you have installed Secure Shell, it'll launch that instead of the built-in crosh command. This allows you to upgrade the terminal emulator portion of the crosh shell without waiting for the next ChromeOS release.

If you would like to revert to the built-in crosh terminal emulator, uninstall or disable the Secure Shell application.