If you are wondering "What is Crosh?," it's a built-in terminal that Chromebooks have. This terminal, known as the ChromeOS Developer Shell—or Crosh for short—lets you access a command-line interface that you can use to debug your machine, run tests, or just poke around for fun.

So let's test several Chromebook terminal commands that all users should know about for improved productivity and troubleshooting.

Essential Crosh Terminal Commands for Chromebooks

We'll explain how to use all these Crosh commands in more detail, but here's the TL;DR list of Crosh hacks:

Command Description

Command

Open Crosh

Ctrl + Alt + T

Ping

ping [domain]

Test memory

memory_test

Configure modem

modem help

Rollback ChromeOS

rollback

Stop a process in Crosh

Ctrl + C

Open Task Manager

top

Battery Manager

battery_test [seconds]

Developer Mode commands

shell, systrace, packet_capture

Users and uptime

uptime

Time settings

set_time

Network diagnostics

network_diag

Network trace

tracepath

Help

help, help_advanced

Memory information

free, meminfo

Switch to the canary channel

live_in_a_coal_mine

Auto-updates over cellular networks

update_over_cellular [enable|disable]

Bluetooth debugging

bt_console

Connect through SSH

ssh

Test input devices

evtest

Exit Crosh

exit

1. Open Crosh

Wondering how to use Crosh? You won't find it in the regular list of apps in your Chromebook's app drawer. To open Crosh, you need to press Ctrl + Alt + T, which will launch the terminal window in a new tab.

You don't need to have your Chromebook's Developer Mode enabled to access Crosh.

2. Run a Ping Test

Ping Command in Crosh on Chromebook

Type ping [domain] to run a ping test on your Chromebook. To check your network connection using ping, issue the following Crosh command:

        ping google.com
    

In case you don't know, ping tests are an essential tool if you're trying to diagnose network issues. It will let you know how quickly traffic is traveling between your computer and a web server. It will also inform you if there are any dropped packets.

3. Test Your Chromebook's Memory

Although you can see information about your Chromebook's memory using third-party plugins (read our article about how to check your Chromebook's specs to learn more), it might not be enough for some users. If you want a more detailed level of information, use Crosh. Just type the following and hit Enter:

        memory_test
    

4. Configure Your Modem

A critical part of troubleshooting your network is ensuring that your modem is configured correctly.

Type the command mentioned below in the Chromebook's terminal. You will get access to a range of options, including settings to activate your modem, connect your modem, change the modem's firmware, factory reset your modem, and more.

        modem help
    

5. Reinstall an Earlier Version of ChromeOS

installing a previous version of chromeos with rollback in crosh

If a recent ChromeOS update has caused havoc with your computer, you can easily undo the changes and return to a previous version of the operating system using Crosh.

All you need to do is type the following Crosh command and hit Enter:

        rollback
    

6. Stop Any Process in Crosh

Suppose you want to halt any background process such as a ping or a memory test in Crosh. You can do so by pressing Ctrl + C. This method is better and safer than closing the Crosh window altogether.

7. A Better Task Manager

Top command in Crosh on Chromebook

Very few people know that ChromeOS (and the Chrome browser on other operating systems) has its own task manager. It shows you what processes are eating through your CPU and memory. You can find it by opening Chrome and going to More (three vertical dots) > More Tools > Task Manager.

However, even fewer people know that ChromeOS has a secondary task manager hidden in Crosh. You can use it to learn about low-level processes that don't show up in the main task manager app. You can access it by simply typing this cool little Crosh command:

        top
    

8. Battery Management

Battery_test command in Crosh on Chromebook

Again, you can see headline battery data by merely looking at the bottom right-hand corner of your Chromebook's screen.

However, if you want more information, type battery_test [seconds] into Crosh (replace [seconds] with a number). You can test this command by typing the following in the terminal:

        battery_test 10
    

Crosh will show you precisely how much battery power your machine used in the given timeframe, as well as feedback on your remaining battery time and your battery's overall health.

9. Developer Mode Commands

You don't need to be a developer to use Crosh. But, if you do have Developer Mode turned on, you will have three new commands available to you:

  • shell: Opens a full Bash shell
  • systrace: Starts a system trace
  • packet_capture: Captures and logs data packets

10. Users and Uptime

viewing how long the user session has been active with uptime in crosh

When was the last time you turned off your Chromebook? It might be days or even weeks between reboots.

You can use the below-mentioned command to see how long your computer has been running since its last shutdown. The results will also provide information about the users who are currently logged in.

        uptime
    

11. Change the Time

Do you have problems with your machine's display time? Perhaps you live on a border between time zones or have an internet connection with an IP address that frequently moves.

Enter set_time into Crosh, and you can override the operating system's time settings. For example, run the following command to change the time:

        set_time 26 May 2023 11:21am
    

12. More Network Diagnostics

Network_diag command in Crosh on Chromebook

If you've run a ping test and tried configuring your modem, but are still encountering issues, type this command to run a complete diagnosis on your network:

        network_diag
    

The output will be saved as a TXT file in your Chromebook's storage.

13. Trace the Packet Route

The final Crosh networking command on this list lets you trace the route of the received data packets across a network. Run this command to check the packet route for google.com:

        tracepath google.com
    

14. Get Command-Line Help

Help command in Crosh on Chromebook

If you are looking for a command not covered in this list, you can get a short or full list of all the Crosh commands that are available to you.

To get a brief list of commands:

        help
    

To get a full list of commands, type:

        help_advanced
    

15. Memory Information

requesting information about available memory space in crosh with free command

If you are looking to get information about your Chromebook's memory usage, you can go for one of the following two Crosh commands.

For an overview:

        free
    

For detailed information:

        meminfo
    

16. Switch to the Canary Channel

You can subscribe to different software distribution channels depending on what kind of updates you want on your Chromebook. There are four main channels available.

  • Stable is for reliable and tested updates
  • With Beta, you get tested and fairly reliable latest features
  • Dev channel offers the latest updates that might not be very reliable
  • Then, there is the Canary channel, which offers experimental updates with bleeding-edge features but very little reliability

The name of this experimental channel is derived from the proverb, "Canary in a coal mine." You can switch to this channel and live on the edge using the command below:

        live_in_a_coal_mine
    

17. Auto-Updates Over Cellular Networks

By default, ChromeOS doesn't update the system while you are on a cellular network. It's the same as on Android. If using mobile internet is not an issue for you, you can turn automatic updates over cellular networks on or off using these commands:

        update_over_cellular enable
update_over_cellular disable

18. Debug Your Connection to Bluetooth Devices

viewing nearby bluetooth devices with bt_console in crosh

It's possible to debug your connection to Bluetooth devices with the help of Crosh commands on your Chromebook.

You can enter a Bluetooth debugging console by entering the first command in Crosh. Entering help will cause the Terminal to list all Bluetooth console commands.

        bt_console
scan on
pair [device number]

19. Connect to Remote Servers With SSH

You don't need any advanced Crosh hacks to connect to remote servers. You can use SSH Crosh commands on your Chromebook by opening the Crosh shell with Ctrl + Alt + T and entering ssh.

Afterward, you'll need to enter information about the host on new lines. Enter the following commands without the brackets:

        ssh
host [SSH hostname or IP address]
user [username]
port [port number]
dynamic-forward [port number]

20. Monitor and Test Input Devices

monitoring input from input devices with evtest in crosh

Still wondering how to use Crosh to make your workflow faster? Using it to monitor, test, and troubleshoot your input devices is one great way.

The evtest command allows you to select a device and monitor it for input. You can use this information printed in the terminal to diagnose and resolve input device issues.

        evtest
    

21. Exit Crosh

When you've finished exploring and want to close the shell, just type:

        exit
    

It's as simple as that.

Make Backups Before You Start Using Crosh Commands

It goes without saying that if you change settings in the ChromeOS Developer Shell without knowing what you're doing, you could render your system unusable.

Luckily, Chromebooks are remarkably easy to restore, but you would lose any locally-saved data. As such, make sure you create backups before you do too much poking around. So enjoy exploring your Chromebook by tinkering with the Crosh commands listed above.