Linux Not Working / Crostini Not Starting
Google Chromebook
Severity:What Does This Error Mean?
Linux on Chromebook (Crostini) failing to start is usually caused by a pending ChromeOS update that blocks the Linux container, or the Linux container needing a restart. Go to Settings > Developers > Linux Development Environment > Restart Linux. If that fails, shut down the Linux container completely and turn it back on.
Affected Models
- All Chromebooks with Linux (Beta) / Crostini support (ChromeOS 69 and later)
Common Causes
- ChromeOS update pending — Linux is blocked until the Chromebook restarts
- Linux container in a crashed or suspended state
- Disk space too low — Linux container requires at least 4GB of free storage
- Linux terminal app itself needs updating
- Linux environment was corrupted by an interrupted update or command
How to Fix It
-
Restart the Chromebook and try again.
A pending ChromeOS update often blocks the Linux container from starting. Restart the Chromebook to apply any pending updates. After restart, open the Linux Terminal from the app launcher — it should start normally.
-
Restart the Linux container from Settings.
Go to Settings > Developers > Linux Development Environment > Restart Linux. This restarts just the Linux container without affecting ChromeOS or your Linux files. Wait 30–60 seconds for the container to fully restart before opening the Terminal.
-
Check available disk space.
Go to Settings > Device > Storage. If available storage is less than 4GB, the Linux container cannot function properly. Free up space by deleting files from Downloads or uninstalling unused apps. You can also increase the Linux disk allocation in Settings > Developers > Linux > Disk Size.
-
Shut down and restart the Linux container.
Right-click the Linux Terminal icon in the taskbar and select Shut down Linux. Wait 10 seconds, then open Terminal from the launcher. The container will perform a cold start which resolves most stuck or frozen Linux states.
-
Delete and reinstall the Linux environment.
As a last resort, go to Settings > Developers > Linux Development Environment > Remove Linux Environment. This deletes all Linux files, apps, and settings. After removal, click Set Up to reinstall a fresh Linux environment. Your ChromeOS files and Android apps are unaffected.
When to Call a Professional
Linux on Chromebook is a developer feature — no hardware repair is needed. Deleting and reinstalling the Linux environment is always an option, though it erases all Linux files and apps.