How to Back Up and Restore Linux Containers on a Chromebook

Why back up your Linux container

Your Linux container on a Chromebook holds your files, code, and installed applications. It lives inside a sandboxed environment that is separate from ChromeOS, but it can still be erased when you reset your Chromebook. For example, a powerwash or a recovery operation wipes the entire drive, including the Linux container. According to Google, recovery permanently erases everything on your Chromebook's hard drive. That is why you need a backup: to restore your Linux environment if something goes wrong.

ChromeOS updates themselves rarely remove the Linux container, but they can occasionally cause issues. A backup gives you peace of mind before you install a major update or perform any system-level reset. For a deeper understanding of the difference between a powerwash and a recovery, see our guide on powerwash vs. recovery. You can also learn more about ChromeOS update support to know how long your device will receive updates. Generally, Chromebooks receive updates for 10 years from the platform release date, but the exact end date for your model appears in the settings under About ChromeOS. Knowing that date helps you plan when to back up more frequently.

Another reason to back up is that Linux on ChromeOS is still a developer feature. Google states that Linux is off by default, and you turn it on from Settings. The container is isolated, but all Linux apps run inside the same sandbox, so a harmful app might affect other Linux apps. If you ever need to remove and recreate the container, a backup lets you get back to work without reinstalling everything from scratch.

How to export a Linux container

ChromeOS includes a built-in backup and restore feature for Linux. To export your container, follow these steps:

• Open the Settings app by clicking the time in the bottom-right corner and then selecting the gear icon.
• Navigate to About ChromeOS, then choose Developers.
• In the Linux development environment section, find the option to back up the container.
• Select 'Export to .tini file' and choose a destination, such as Google Drive or an external drive.
• Wait for the process to finish. The backup creates a single file containing your entire Linux environment.
• You can check the progress in the notification center. The time it takes depends on the size of your container and the speed of your storage.

How to import a Linux container

To restore your Linux container on the same or a different Chromebook, go back to the same Linux development environment settings and choose 'Import from .tini file'. Select the backup file you created earlier. The system will restore the container, including your files and installed packages. You may need to restart your Chromebook after the import is complete. During the import, you might see a message that the system is restoring your environment. Do not turn off the Chromebook until it finishes.

If you are importing to a new Chromebook, make sure Linux is already set up on that device. Follow the on-screen instructions to enable Linux first, as described in Google's help page. Once the import is done, you can open the Terminal app to verify that your files and applications are back.

What the backup includes and limitations

The .tini backup includes your Linux files, applications, and system settings. It does not include anything outside the container, such as your ChromeOS apps or user profile. It also does not include hardware-level configurations. For most users, this is sufficient for recovery. However, note that the Linux environment on ChromeOS has some limitations, such as no camera support and limited hardware acceleration, according to Google's Linux documentation. If you are new to Linux on ChromeOS, check our guide to setting up Linux to understand the environment first.

The backup file can be large, especially if you have installed many packages or keep large projects inside the container. Therefore, make sure you have enough free space on the destination. You can also use the backup as a way to move your Linux environment to a bigger Chromebook. If you plan to keep several backups, consider using an external drive or cloud storage with high capacity.

Manual backup alternatives

If you prefer to back up only specific files, you can use the Files app to copy them to Google Drive or an external drive. This is useful when you want to share or store individual projects. You can also use the command line inside the Linux container to create a compressed archive, but the built-in export is simpler for a full snapshot. For example, you might use the tar command to compress a folder, but that requires you to remember the exact command and destination. The built-in export handles everything automatically.

For advice on managing storage for your backups, see our explanation of storage options. Also, if you are running out of space inside the container, you can follow the troubleshooting steps in our guide on Linux container running out of space.

Best practices for updates and recovery

Before you perform a powerwash, a recovery, or a major ChromeOS update, export a backup of your Linux container. Store the backup file in a safe location, such as Google Drive or an external USB drive, so it is available even if your Chromebook is lost or damaged. After you set up a new Chromebook or reset your current one, import the backup to restore your Linux environment. This process helps you avoid losing your work when you move to a new device or troubleshoot a problem.

It is also a good idea to back up the container before you install new Linux packages or make significant changes. That way, if the new software breaks something, you can go back to the previous working state. Many developers export a backup weekly or before every major project change. You can schedule reminders or simply make it a habit to export after you finish a session.

If you are considering a new Chromebook with enough capacity for large backups, take a look at our buying guide for high-capacity storage models. For a good balance of performance and storage, you might also explore models with 8GB of RAM, which handle multiple Linux processes smoothly.

Troubleshooting backup and restore problems

If the export fails, check that you have enough free space on the destination drive. A common issue is trying to save the .tini file to a location that is too small. You can also try exporting to a different folder or device. If the import fails, make sure you are selecting the correct .tini file and that the file is not corrupted. You may need to copy the file to the Chromebook's local storage before importing.

If you cannot find the backup option in settings, confirm that Linux is enabled on your Chromebook. Some managed devices, such as school or work Chromebooks, might not allow you to use Linux at all. In that case, contact your administrator. For personal devices, you can enable Linux from the same Developers section.

For a complete walkthrough of enabling Linux, see our instruction on enabling Linux. If you need to delete the container entirely and start over, the backup and restore feature still works, but you will need to import the .tini file after you recreate the container.

What to pick for your use

Questions

Will a Linux backup restore my installed applications?

Yes, the built-in export creates a full snapshot of your Linux container, including all installed packages, files, and system settings. When you import the .tini file, your applications and configurations are restored exactly as they were.

Can I back up only certain files from my Linux container?

Yes, you can use the ChromeOS Files app to manually copy files from the Linux folder to Google Drive or an external drive. This is useful if you only need to save specific projects rather than the entire container.

How often should I back up my Linux container?

It depends on how frequently you create or modify files. A good rule is to export a backup before any major system change, such as a powerwash, a recovery, or a major ChromeOS update. For ongoing work, consider weekly or monthly backups to avoid losing recent changes.

Can I import a Linux backup to a different Chromebook?

Yes, as long as the Chromebook supports Linux (most modern devices do). You can create the export on one device and import it on another, provided you have enabled Linux on the target device and have enough storage space.

Where should I store my Linux backup file?

Store it in a location that survives a device failure, such as Google Drive, an external USB drive, or a network-attached storage drive. Avoid keeping the only copy on the Chromebook itself, because a hardware failure or recovery would erase it.

What if I have multiple Linux containers?

ChromeOS supports only one Linux container per device, so the backup and restore feature covers that container. If you need isolation for different projects, consider using virtual environments or separate user accounts inside the container, but you will still back up everything together.

Does the backup include files stored in Google Drive that I access from Linux?

No, the backup only includes files that are physically inside the Linux container. If you mount Google Drive within Linux, the cloud files are not part of the .tini export. Your Drive files remain safe in the cloud and are not affected by a powerwash.