thechromeguideBeginner's Guide for ChromeOS

How to Set Up Linux on a Chromebook

By thechromeguide teamPublished

To set up Linux on a Chromebook, open Settings, select About ChromeOS, then Developers, and select Set up next to “Linux development environment”. Follow the on-screen steps. Google’s Linux help page says setup can take 10 minutes or more, and when it finishes a Terminal window opens.

What is Linux on a Chromebook, and who is it for?

Linux is another operating system, like ChromeOS or Windows. On a Chromebook it runs in its own protected space, called a sandbox. Google describes it as a feature for developing software: it lets you install command line tools, code editors and other programming tools.

You type commands into the Terminal, a window where you give the computer instructions as text. The version of Linux you get is Debian, and you install programs with a tool called APT (a package manager, which downloads and installs programs for you).

Linux is useful if you are learning to code or want a program made for Linux. If you only browse the web and use apps from the Google Play Store, you can leave it off.

What you need

  • A Chromebook that supports Linux. According to the Chromium Projects, all Chromebooks launched in 2019 and later support it unless stated otherwise, and some older models do too.
  • An internet connection, because ChromeOS downloads the files it needs during setup.
  • A personal account. Google says you might not be able to use Linux on a work or school Chromebook. ChromeOS.dev says the Terminal does not work on child accounts.

How do I install Linux on a Chromebook?

Step 1: Select the time at the bottom right of the screen.

Step 2: Select Settings.

Step 3: Select About ChromeOS, then Developers.

Step 4: Next to “Linux development environment”, select Set up.

Step 5: Follow the on-screen instructions and wait. This can take 10 minutes or more.

Step 6: When a Terminal window opens, Linux is ready.

Linux is off until you turn it on, and you can turn it on at any time.

How do I open the Linux Terminal and update it?

Updating first means you install the latest versions of programs. The Terminal is in your Launcher (press the Search or Launcher key to open it).

Step 1: Open the Launcher and select Terminal.

Step 2: Type this command and press Enter:

sudo apt update

Step 3: Wait until the Terminal shows a new line where you can type again.

The word sudo at the start runs the command with permission to change the system. Google’s help page gives this longer command for updating everything Linux has installed:

sudo apt-get update && sudo apt-get dist-upgrade

How do I install my first Linux app?

You install programs by name with sudo apt install. A good first app is GNOME Software, which ChromeOS.dev suggests for anyone who prefers an app store with buttons to typing commands.

Step 1: Open the Terminal.

Step 2: Type this command and press Enter:

sudo apt install -y gnome-software gnome-packagekit

Step 3: Wait for the install to finish.

Step 4: Open the Launcher and look for the new Software app.

Software works like an app store for Linux programs. You can also install any program from the Terminal once you know its package name, which is the short name APT uses for it. Our restored guide to installing Linux apps has more examples.

How do I remove a Linux app?

Step 1: Open the Terminal.

Step 2: Type sudo apt remove followed by the package name, then press Enter. For the app above:

sudo apt remove gnome-software

Step 3: If the Terminal asks you to confirm, follow its prompt.

The Debian handbook explains that apt remove also removes packages that depend on the one you remove, and sudo apt purge removes the program’s settings files too.

Back up your Linux files and apps

A backup saves your Linux files and apps as one file, so you can restore them later. You can also restore it on another Chromebook if both have the same type of processor (Google gives x86 and ARM as examples).

Step 1: Select the time at the bottom right of the screen.

Step 2: Select Settings, then About ChromeOS, then Developers.

Step 3: Select Linux development environment.

Step 4: Select Back up and restore. If you do not see it there, Google’s backup help page lists it under Settings, Advanced, Developers, Linux.

Step 5: Select Back up.

Step 6: Under My files on the left, choose where to save the backup.

Step 7: Type a name for the backup and select Save.

A notification at the bottom right shows the backup’s progress. To restore, go back to the same page and select Restore next to “Restore from a previous backup”. Restoring deletes your current Linux apps and files and replaces them with the backup, which is a .tini file.

How do I remove Linux from a Chromebook?

Before you remove Linux, back up any Linux files you want to keep.

Step 1: Select the time at the bottom right of the screen.

Step 2: Select Settings, then About ChromeOS, then Developers.

Step 3: Select Linux development environment.

Step 4: Under “Remove Linux development environment”, select Remove.

What is different on newer Chromebooks?

From ChromeOS 147, Google’s Linux news page says new installs use a setup called Baguette by default. It runs Linux directly in its own protected space without the extra “container” layer older versions used. Google says this brings faster installs and start-up. For now Baguette is only for new installs, and Google says instructions for upgrading existing installs will follow.

What this means for you:

  • Older guides tell you to select “penguin” in the Terminal app. That was the name of the old container, so a new install may not show it.
  • Google has deprecated installing and uninstalling Linux apps (.deb files) from ChromeOS menus. Use the Terminal commands above instead.
  • Google no longer supports graphics acceleration for Linux. It may still work, but Google will not fix it if it breaks.
  • Older guides send you to Settings, then Advanced, then Developers. On current ChromeOS, Developers is under About ChromeOS.

If it does not work

  • Restart your Chromebook, then try again.
  • Update your Linux programs with sudo apt-get update && sudo apt-get dist-upgrade in the Terminal.
  • If a backup fails with “More storage space needed”, delete some files in the Files app to make room.
  • On a school or work Chromebook, ask your administrator, because they can turn Linux off.

Questions people ask

Is Linux on a Chromebook safe?

Google runs all Linux apps together in their own sandbox, a protected space kept apart from the rest of your Chromebook. A harmful Linux app can affect other Linux apps, but not the rest of your Chromebook.

Do I need developer mode to use Linux?

No. ChromeOS.dev says Linux works with your Chromebook in its normal mode, so you do not need to turn on developer mode.

Can I use my microphone in Linux?

Yes. Turn on Allow Linux to access your microphone in the Linux development environment settings. Our guide to turning on the microphone in Linux walks through it.

Can I run Windows programs with Linux?

ChromeOS.dev suggests trying a Linux tool called WINE, but says how well it works depends on WINE, and asks people not to come to Google for support with it.

Next, if you want a game to try, see our guide to Minecraft on a Chromebook.

You did it!

You reached the end of this guide. Want to learn one more thing?