Skip to content

ChromeOS Shell (Crosh)

The ChromeOS Shell, also known as Crosh, is a command line interface built into ChromeOS. It is designed for basic system diagnostics and debugging. It is not a full shell and cannot be used to run scripts or install software. Please note, this is different than the ChromeOS Linux Terminal, which offers a full featured Linux Instance with the ability to install software and run scripts.

The commands below may vary slightly depending your ChromeOS device features and enterprise/educational enrollment status.

ChromeOS Shell CommandDescriptionCommand Details
arcThe arc command in ChromeOS provides powerful tools for managing and monitoring the Android Runtime environment. This chapter explores how to use these tools effectively through the Chrome OS Shell (crosh).arc
autestThe autest command is a powerful but potentially risky tool in ChromeOS that allows users to trigger system updates against a test update server. This chapter explains its usage and important considerations.autest
authpolicy_debugThe authpolicy_debug command in the ChromeOS Shell is a powerful tool for diagnosing issues related to Active Directory authentication and policy application.authpolicy_debug
battery_firmwareThe battery_firmware command in ChromeOS provides access to detailed battery information through the Chrome OS Shell (crosh). This chapter explains how to use this command to query and understand your device's battery information.battery_firmware
battery_testmeasure and analyze battery discharge rates through the Chrome OS Shell (crosh). This chapter explains how to use this diagnostic tool effectively.battery_test
builtin_corpsshThe builtin_corpssh command in ChromeOS facilitates secure SSH connections tailored for enterprise environments.builtin_corpssh
bt_consoleThe bt_console command provides access to a specialized debugging console for Bluetooth functionality in ChromeOS.bt_console
ccd_passThe ccd_pass command in ChromeOS provides functionality to manage the Case Closed Debugging (CCD) password.ccd_pass
chaps_debugThe chaps_debug command in ChromeOS provides control over the logging level of the ChromeOS PKCS #11 implementation (chapsd).chaps_debug
connectivityThe connectivity command in ChromeOS provides tools for monitoring and analyzing network connectivity statusconnectivity
crasThe cras command in ChromeOS provides control over the ChromeOS Audio Server (CRAS), allowing users to manage audio features and simulate telephony eventscras
diagThe diag command in ChromeOS provides access to system diagnostics tools and routines.diag
display_debugThe display_debug command in the ChromeOS Shell provides a suite of tools for diagnosing and troubleshooting display-related issues on ChromeOS devices.display_debug
dlc_listThe dlc_list command in ChromeOS provides information about supported Downloadable Content (DLC) packages available for your systemdlc_list
dlc_installThe dlc_install command in the ChromeOS Shell enables users to trigger the installation of DLCs (Downloadable Content) for testing purposesdlc_install
dmesgThe dmesg command in ChromeOS provides access to the kernel message buffer, allowing users to view and analyze system messages.dmesg
dump_emkThe dump_emk command in the ChromeOS Shell is used to retrieve the Enterprise Enrollment Key (EMK) from a ChromeOS device.dump_emk
enroll_statusThe enroll_status command in ChromeOS provides information about device enrollment status and configuration.enroll_status
evtestThe evtest command in ChromeOS provides a safe mode interface for testing and monitoring input device events.evtest
exitThe exit command in ChromeOS provides a clean way to close the Chrome OS Shell (crosh).exit
ff_debugThe ff_debug command in ChromeOS manages debug tags and logging levels for flimflam, the network management system.ff_debug
freeThe Linux free command displays the total amount of free and used memory in the system, including physical memory, swap space, and buffers used by the kernel.free
force_activate_fipsThe force_activate_fips command in ChromeOS enables FIPS (Federal Information Processing Standards) mode for the device's built-in security key (on devices with a supported internal security key).force_activate_fips
gesture_propThe gesture_prop command in the ChromeOS Shell is used to view and configure gesture-related properties for attached input devices.gesture_prop
helpThe help command in the ChromeOS Shell provides users with a quick way to access general help or detailed information about specific commands.help
help_advancedThe help_advanced command in the ChromeOS Shell provides users with detailed guidance on advanced and debugging-focused commands.help_advanced
hibernateThe hibernate command in the ChromeOS Shell allows users to manage hibernation settings on supported devices.hibernate
ipaddrsThe ipaddrs command in ChromeOS provides a straightforward way to display IP addresses assigned to your device through the Chrome OS Shellipaddrs
meminfoThe meminfo command in ChromeOS provides detailed information about system memory usage through the Chrome OS Shellmeminfo
memory_testThe memory_test command in the ChromeOS Shell performs an extensive diagnostic test on the system's available memory. This tool helps identify memory issues by testing free memory regions.memory_test
modemThe modem command in the ChromeOS Shell enables users to interact with the 3G modem for tasks such as diagnostics, configuration, and status checks.modem
network_diagThe network_diag command in the ChromeOS Shell is a comprehensive tool for diagnosing network connectivity and performance issues.network_diag
p2p_updateThe p2p_update command in the ChromeOS developer shell (crosh) is used to enable or disable peer-to-peer (P2P) sharing of updates over a local network.p2p_update
packet_captureThe packet_capture command in ChromeOS provides a way to capture network packets for debugging purposes.packet_capture
pingThe ping command in the ChromeOS Shell is a diagnostic tool used to test network connectivity by sending ICMP echo request packets to a specified host and measuring the response.ping
printscan_debugThe printscan_debug command in ChromeOS assists with diagnosing and debugging issues related to printing and scanning.printscan_debug
rlzThe rlz command in ChromeOS was used for managing cohort tagging to analyze promotions. This feature was deprecated in 2013 but remains available in the ChromeOS developer shell (crosh) for legacy purposesrlz
rollbackThe rollback command in ChromeOS allows users to revert their device to a previously cached update.rollback
routeThe route command in the ChromeOS Shell provides insights into the system's network routing tables.route
set_apnThe set_apn command in the ChromeOS Shell is used to configure Access Point Name (APN) settings for mobile network connections. APN settings are essential for establishing a successful connection to cellular data networksset_apn
set_arpgwThe set_arpgw command in ChromeOS enables or disables additional network state checks to ensure the default gateway is reachable.set_arpgw
set_cellular_pppThe set_cellular_ppp command in the ChromeOS Shell is used to configure Point-to-Point Protocol (PPP) settings for cellular connections.set_cellular_ppp
set_timeThe set_time command in the ChromeOS Shell allows users to manually set the system time.set_time
set_wake_on_lanThe set_wake_on_lan command in the ChromeOS Shell enables users to manage the Wake on LAN (WoL) feature for Ethernet devices.set_wake_on_lan
shellThe shell opens a Linux Shell on ChromeOS devices that have the ChromeOS Developer Mode active.shell
storage_test_1The storage_test_1 command in the ChromeOS Shell is used to initiate a short offline SMART (Self-Monitoring, Analysis, and Reporting Technology) test.storage_test_1
storage_test_2The storage_test_2 command in the ChromeOS Shell initiates an extensive readability test to thoroughly evaluate the health of storage devices.storage_test_2
swapThe swap command in the ChromeOS Shell provides tools to manage compressed swap (zram) settings and control memory management parameters.swap
syncThe sync command in the ChromeOS Shell forces the system to synchronize cached writes to persistent storage.sync
syslogThe syslog command in the ChromeOS Shell allows users to log custom messages directly to the system log.syslog
time_infoThe time_info command in the ChromeOS Shell displays the current synchronization state of the system time.time_info
topThe top command provides a dynamic, real-time view of system processes, displaying information such as CPU and memory usage, process ID, and running time, helping to monitor system performance and resource consumption.top
tracepathThe tracepath command in the ChromeOS Shell is a network diagnostic tool used to trace the path packets take to a destination host.tracepath
u2f_flagsThe u2f_flags command in the ChromeOS developer shell provides options to customize the configuration of the second-factor authentication (U2F) daemon.u2f_flags
unameThe uname command in the ChromeOS Shell provides essential details about the system, such as kernel version, operating system, and architecture.uname
upload_crashesThe upload_crashes command in the ChromeOS Shell triggers the upload of available crash reports to the ChromeOS crash server.upload_crashes
upload_devcoredumpsThe upload_devcoredumps command in the ChromeOS Shell enables users to control whether devcoredump reports are uploaded to the crash server.upload_devcoredumps
uptimeThe uptime command in ChromeOS displays information about how long the system has been running and its current load.uptime
verify_roThe verify_ro command in ChromeOS provides a way to verify the read-only (RO) firmware for both the Application Processor (AP) and Embedded Controller (EC) through the Chrome OS Shellverify_ro
vmcThe vmc command in ChromeOS provides a comprehensive command-line interface for managing virtual machines on ChromeOS.vmc
vmstatThe Linux vmstat command reports information about processes, memory, paging, block I/O, traps, and CPU activity, providing a detailed view of system performance and resource utilization.vmstat
vshThe vsh command in the ChromeOS Shell provides a powerful interface for connecting to shells within virtual machines (VMs) or containers hosted inside VMs.vsh
wifi_fw_dumpThe wifi_fw_dump command in ChromeOS collects a firmware dump of the WiFi module, providing valuable diagnostic information for troubleshooting wireless connectivity issues.wifi_fw_dump
wifi_power_saveThe wifi_power_save command in the ChromeOS Shell allows users to enable, disable, or check the status of WiFi power saving mode.wifi_power_save
wireguardThe wireguard command in crosh provides a comprehensive set of tools for managing WireGuard VPN connection.wireguard