On this page
It’s easy to set up Linux, aka Crostini, on ChromeOS. First, go to Settings, expand the “Advanced” menu and go to “Developers”. Then “Turn on” Linux:
ChromeOS will automatically download the necessary files and set up your Linux container. When it finishes, you’ll see a new Terminal app and an open terminal window. We recommend pinning the application to your shelf as a handy way to access your Linux container in the future. Right-click on the Terminal app icon and choose “Pin”.
Now your Debian Linux installation is ready to go! A good first thing to do is update the APT repository index and install. APT is a command-line package manager for Debian, and keeping it up to date will ensure you’re always installing the latest versions of tools in its repository:
You’re now set up and ready to use the Linux container!
A simple way to access files in the Linux container is to make a copy. To do so, open the Files app, drag whatever directory or file you want to access, and drop it in “Linux files”.
If you don’t want to make a copy, you can share directories, such as a project folder, from outside the Linux container with the Linux container. To do so:
- Ensure that Linux is set up.
- Open the ChromeOS Files app and find the directory you want to share.
- Right-click on the folder you want to share and select the “Share with Linux” option.
- Within the Linux container, these shared folders will be located at /mnt/chromeos. From the Terminal app run
Now that Linux is set up, it’s time to install your first apps! While you can always install apps and tools in the terminal via
sudo apt install, Linux on ChromeOS supports double-click to install for
.deb files (Debian software package) in the Files app, allowing you to download and install apps like you’re used to. Visual Studio Code, for instance, offers a
.deb package, that you can try this with. Once downloaded and double-clicked, you’ll see a prompt with information about the app you’re looking to install, along with the option to install the app!
If you prefer to find, install, and manage applications and tools through an application with a graphic user interface, you can install GNOME’s Software app and PackageKit. To do so, run the following:
Installing these will add two new applications, Software, which provides an app-store like interface for finding applications that can be installed from multiple sources, and Package and Package Update, which can be used for finding and updating applications, tools, fonts, and lots of other packages.
If you are troubleshooting an issue with Linux, it may be helpful to restart the container without restarting your whole Chromebook. To do so, right-click on the Terminal app in your shelf and click “Shut down Linux”.
Once shut down, the applications should show up in the launcher, and choosing one will start up your Linux container again.
Linux on ChromeOS runs inside a container, sandboxing it from other web pages, applications, and the operating system itself. However, all apps installed in the Linux container share that same sandbox, meaning that they share the permissions of the Linux container, and they can affect each other.
For security reasons, many permissions, such as USB access or microphone access, aren’t shared by default. To ensure you have the correct permissions enabled, go to your device settings and enable them. As always practice appropriate caution with permissions and never enable more than you need. Whenever you’re interacting with Linux on ChromeOS, be especially mindful of user data in the container.
Because Linux on ChromeOS runs inside a container, you can back up your environment and restore it; files, apps, and all. This allows you to set up your Linux environment once, then take it with you without needing to reconfigure it again! For detailed instructions on how to do so, see the Chromebook Help page on backing up and restoring your Linux container
For more help enabling or troubleshooting, please read the Chromebook Help page on setting up the Linux container.