How to Use Crosh on a Chromebook for Troubleshooting

What is Crosh?

Crosh is the ChromeOS developer shell, a command-line window built into ChromeOS. It gives you a text prompt where you can run diagnostic commands that are not part of the main settings screens. On a Chromebook, Crosh is useful when you want a quick look at network connectivity, running processes, memory, storage, or battery behavior.

The shell is separate from the Linux terminal. Linux is an optional feature you turn on from Settings if you want a Debian environment for coding and command-line tools. Crosh works without any setup and is designed for checking the Chromebook itself.

If you are not sure whether a problem is hardware, software, or network related, Crosh gives you a second source of information before you make more involved changes.

How to open Crosh

Press Ctrl+Alt+T on the Chromebook keyboard. A terminal window opens with a crosh prompt. If you are using an external keyboard, use the same key combination. Type help and press Enter to see basic commands. Type help_advanced for a much longer list of diagnostics.

Crosh is available in normal ChromeOS mode for basic diagnostics. You do not need Developer Mode to open it, and you do not need to enable Linux.

• Press Ctrl+Alt+T to open the Crosh window.
• Type help and press Enter to list the available commands.
• Type exit and press Enter to close the window.
• If Crosh does not open, restart the Chromebook and try again.

Diagnostic commands to try

The best Crosh command depends on the symptom. Start with help so you know which commands your current ChromeOS version supports. Commands that only display information are usually safe to run. Commands that change system behavior should only be run when you understand what they do.

For network checks, type ping followed by a hostname to see whether the Chromebook can reach that host. For performance, top shows active processes and lets you spot something consuming most of the CPU. The memory and storage tests take longer and may ask you to restart before they complete. The battery test reports how the battery behaves while the test runs. If you need a record of the results for an administrator, review your system information or follow the built-in diagnostics steps.

Crosh is not the Linux terminal

Because both Crosh and Linux use a terminal window, it is easy to confuse them. Crosh is part of ChromeOS and appears when you press Ctrl+Alt+T. Linux is a separate feature that is off by default. You enable it in Settings, and then you get a Debian environment with its own terminal app. The Linux environment is meant for installing software, writing code, and running command-line tools.

Basic Crosh diagnostics do not require Linux, and enabling Linux does not give you more Crosh commands. If your goal is software development, see the Linux setup guide or the guide to setting up a Linux programming environment. If your goal is troubleshooting, stay in Crosh.

Use Crosh in a simple troubleshooting workflow

Start with the least disruptive fix. Restart the Chromebook and confirm it is running the latest ChromeOS version. If the problem remains, use Crosh to gather information. Compare the output with what you see in Settings, then apply the fix that matches the symptom. For update questions, see how to check and install ChromeOS updates. For Wi-Fi issues, use ping and then move to the Wi-Fi troubleshooting steps. For slowness, use top and then work through the slow performance fix.

If the Chromebook is managed by a school or employer, some settings and terminal features may be restricted. Contact your administrator before changing system-level settings or doing a full reset. If you own the Chromebook and Crosh points to a problem that no setting fixes, you can consider a factory reset as a later step.

• Restart the Chromebook before you assume software is broken.
• Confirm ChromeOS is up to date.
• Open Crosh and type help to see what is available.
• Run the command that matches the symptom.
• Write down the output if you may need to contact support.

Limitations and safety

Crosh is useful, but it is not a repair tool. Most everyday fixes still happen in ChromeOS settings, through updates, or by restarting the device. The command output helps you identify whether the issue is network, memory, storage, or performance, but it does not replace the official troubleshooting paths.

ChromeOS includes security features such as verified boot and sandboxing that keep the system protected. Those protections are a good reason to avoid running unknown commands from random websites. If someone tells you to paste a long Crosh command without explaining what it does, pause before using it.

When to look past Crosh

Some problems cannot be diagnosed from Crosh alone. If the Chromebook will not turn on, a black screen appears, or the system falls into recovery mode, use the dedicated startup and recovery guides instead of trying more Crosh commands. Start with the Chromebook that will not turn on guide, and keep a recovery USB in mind if the system will not start normally.

Older Chromebooks eventually stop receiving new software updates when the hardware can no longer support the latest versions. ChromeOS devices receive 10 years of updates, so check the update schedule in About ChromeOS to see how much official support remains. An unsupported Chromebook is more likely to have issues that no update will fix. If you are deciding whether to replace it, review the current Chromebook buying guides for options.

What to pick for your use

Questions

Is Crosh safe to use?

Basic Crosh commands such as help, ping, and top are diagnostic and do not modify the system. Longer tests like memory_test or storage_test may require a restart. ChromeOS includes protections such as verified boot and sandboxing, but you should not run a command you do not understand.

Do I need Developer Mode to use Crosh?

No. Press Ctrl+Alt+T in normal ChromeOS to open Crosh for basic diagnostics. Developer Mode is a separate option that turns off some protections and is not needed for everyday troubleshooting. If you choose to enable it, read the tradeoffs first.

What should I do if Ctrl+Alt+T does not open Crosh?

Restart the Chromebook and try again. Confirm that the keyboard is working normally. On a Chromebook managed by a school or employer, the administrator may restrict terminal access, so contact the administrator if the shortcut stays blocked.

Is Crosh the same as the Linux terminal?

No. Crosh is the ChromeOS developer shell and opens with Ctrl+Alt+T. Linux is an optional Debian environment that you enable in Settings. The Linux terminal is for installing apps and coding tools and is separate from Crosh.

Which Crosh command should I use for Wi-Fi problems?

Start with ping to test whether network packets reach their destination. You can also use the network diagnostics in ChromeOS settings. If Wi-Fi still drops, work through the dedicated Wi-Fi troubleshooting guide.

Can Crosh fix battery problems?

Crosh can report battery behavior through battery_test, but it does not replace charging hardware or battery replacement. If the battery drains quickly, check the battery-related guides and consider the age of the device.