Skip to content
Open
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
806a388
Revise Data Recovery guide with updates
maria-deguzman-009 Nov 6, 2025
f9871b8
fixed some lit issues and updated the table of contents
thomas-zimmerman Nov 7, 2025
887cd66
many more lit fixes
thomas-zimmerman Nov 7, 2025
b40b13e
lit fixes
thomas-zimmerman Nov 7, 2025
7028609
additional link fixes
thomas-zimmerman Nov 7, 2025
6d60e8f
Merge branch 'master' into maria-deguzman-009-patch-1
thomas-zimmerman Nov 7, 2025
f6914e1
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
98d4083
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
6247668
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
7cc3672
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
b1fbd68
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
1c88964
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
be9c07b
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
c269357
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
db8111b
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
389bb94
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
fc95404
Update content/disaster-recovery.md
maria-deguzman-009 Dec 11, 2025
9e1e2e3
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
5bfa529
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
e049890
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
dced946
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
eec3a7d
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
36010b7
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
b9df381
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
e8bfca0
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
57ca14a
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
482a353
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
a675adc
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
182e311
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
52fca38
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
32765e3
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
9e509b9
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
564ea87
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
b8a3723
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
4d207f1
Update disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
4c531fa
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
23cbfc3
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
71b5b29
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
9d56e42
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
9b48c13
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
89fd73c
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
574f17a
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
7f9f32b
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
51c7548
Update content/disaster-recovery.md
maria-deguzman-009 Dec 12, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
147 changes: 86 additions & 61 deletions content/disaster-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,111 +15,136 @@
tableOfContents: true
---

This article covers ways to extract and save your data in the event of an OS failure, update failure, or similar situation. If you are having issues reaching your login screen, this [article](/articles/login-loop-pop) may be helpful instead.
This guide helps users recover data and restore system functionality after _OS failure, update issues, bootloader errors, or hardware problems.

## If you can't boot your installed OS

If you are not able to boot into your installed OS, then we will want to boot from a live disk. If you have Pop!\_OS installed we can use the Pop!\_OS Recovery Partition.
# Pop!\_OS

Check failure on line 22 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Multiple top-level headings in the same document [Context: "# Pop!\_OS"]

Check failure on line 22 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "# Pop!\_OS"]
Use Recovery Partition:

Check failure on line 23 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Trailing spaces [Expected: 0 or 2; Actual: 1]
1. Hold <kbd>Spacebar</kbd>or press <kbd>ESC</kbd> at boot menu. Select **Pop!\_OS Recovery**

Check failure on line 24 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Lists should be surrounded by blank lines [Context: "1. Hold <kbd>Spacebar</kbd>or ..."]
_If Recovery is missing_: Download Pop!\_OS and create a Live USB from this [link](https://pop.system76.com/).

Check failure on line 25 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Lists should be surrounded by blank lines [Context: "_If Recovery is missing_: Down..."]
# Ubuntu

Check failure on line 26 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Multiple top-level headings in the same document [Context: "# Ubuntu"]

Check failure on line 26 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Above] [Context: "# Ubuntu"]
Use Live USB:

Check failure on line 27 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Trailing spaces [Expected: 0 or 2; Actual: 1]
1. Download Ubuntu ISO from this [link](https://ubuntu.com/download) and create a live [USB](https://support.system76.com/articles/live-disk) using Rufus or Startup Disk Creator.

Check failure on line 28 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Lists should be surrounded by blank lines [Context: "1. Download Ubuntu ISO from th..."]
2. Boot from USB and select **Try Ubuntu**.

Check failure on line 29 in content/disaster-recovery.md

View workflow job for this annotation

GitHub Actions / Lint (Markdown)

Inconsistent indentation for list items at the same level [Expected: 2; Actual: 0]

### Creating the live disk (Bootable OS)
### Connect to Internet

We can use this [article](/articles/live-disk) to create a live disk of Ubuntu if you aren't using Pop. For more information about accessing Recovery see [here](/articles/pop-recovery). For Ubuntu, refer to this [article](/articles/bootloader).
1. Use the **top-right system menu** to connect to Wi-Fi or ethernet.
_A stable connection is recommended for installing backup tools or uploading data._

We do not need to chroot into the installed OS to back up data, only mount the OS drive. Once this is done, we can install the software used for the backup process: <u>Deja Dup</u> (see below).
### Mount the Installed OS Drive

### Connect to the Internet
# If Disk is Encrypted:
1. Open a terminal by pressing <kbd>Super</kbd> + <kbd>T</kbd> and type the following commands:

![Top Left Menu](/images/disaster-recovery/Dialog.png)
```bash
sudo cryptsetup luksOpen /dev/sdX ubuntu-root sudo mount /dev/mapper/ubuntu-root /mnt
```

Use the top-right menu (as shown above) to connect to your Wi-Fi once booted into the live disk.
# If Disk is not Encrypted:
1. Open **Files** > **Other Locations** and locate your system drive.

### Mount the installed OS
### Install Backup Software
# Deja Dup
_ Supports local, remote, and cloud backups and has ability to schedule automatic backups._
1. Open **Pop! Shop** if using Pop!\_OS
2. Search for **Deja Dup** in Pop! Shop and download the application. If using Ubuntu, open the **Backups** application, which is also Deja Dup.

Once connected to the Internet, open <u>Firefox</u> and access the [bootloader](/articles/bootloader) article.
Then copy and paste the encryption commands (if the OS is encrypted) and the mount commands.
# Rsync
_Command line utility that reserves file permissions and supports resumable transfers_
1. Install rsync if not already installed.
```bash
sudo apt install rsync

> **NOTE:** If you own System76 hardware and/or have a System76 Account, this will also allow you to access Support Tickets, copy/paste commands from those tickets or upload log files, etc.
Deja Dup

## Software
* Available via **Pop!_Shop** or **Ubuntu Software Center**.
* Supports local, remote, and cloud backups.
* Can be scheduled for automatic backups.

Once the drive is mounted, we can install software to back up files.
### Installing Deja Dup

### Deja Dup
* Appears as **Backups** in the Activities menu.

[Déjà Dup](https://wiki.gnome.org/Apps/DejaDup) is a popular, straightforward backup option. It can be used to back up user data locally, remotely, or to a cloud server. It can also be set up to run automatically on a regular basis.
```bash
sudo apt install deja-dup
```

### Rsync
### Rsync (CLI)

[rsync](https://www.digitalocean.com/community/tutorials/how-to-use-rsync-to-sync-local-and-remote-directories) is a popular command-line tool to copy data while keeping the permissions. It is useful if the system is powering down or if you want a command-line tool to copy the files.
* Preserves file permissions and supports resumable transfers

```bash
rsync -avxP \
/path/to/directory/to/backup \
/path/to/directory/for/storing/backup
```
_Note:_ Upload speeds can vary depending on your internet provider, cloud service, or physical location and may even be subject to throttling. For faster and more reliable file transfer, it's recommended to use a wired Ethernet connection whenever possible.

> **NOTE:** Depending on your ISP/Cloud Provider or physical location. Upload speeds may vary or even be throttled. If possible, connect via Ethernet for a faster, more stable connection when transferring files.

#### Installation

To install <u>Deja Dup</u>, search for it in the <u>Pop!\_Shop</u>, <u>Ubuntu Software</u> or run this command:

```bash
sudo apt install deja-dup
```

Once Deja Dup is installed, it will be labeled as "Backups" in the Activities overview.

#### Selecting Data to Backup

With Deja Dup (Backups) open, you can select the folders you wish to save or ignore using the pages listed on the left. By default, Deja Dup will backup your entire home directory, which includes your Documents, Pictures, Music, and Videos folders. It ignores your Downloads folder and any items in the Trash. Use the plus (+) and minus (-) buttons as needed to modify both categories.

![Selecting data to backup in Deja-Dup](/images/backup/deja_selection.png)

#### Choosing a Backup Location
### Additional backup Tool Options

On the **Storage location** page, you can configure the location where your backup will be stored.

![Selecting a backup location in Deja-Dup](/images/backup/deja_location.png)
**Timeshift** -- ideal for system snapshots and rollback
**Duplicati** -- web-based interface, encrypted backups, supports cloud storage

## Hardware
## Command Line Tools

An external or internal drive can be used as a local backup location.
**BorgBackup** -- deduplication, compression, encryption; great for data recovery
**Restic** -- fast, secure, cross-platform; supports many backends (SFTP, AWS, etc.)
**Rsync** -- highly customizable; ideal for scripted or incremental backups

### External
## Enterprise-grade Solutions

The specs below offer an idea on what to look for when purchasing external storage:
* Amanda/Zamanda -- centralized backup management, tape support
* Veeam Agent for Linux -- commercial-grade, agent-based backups with recovery tools

- USB 3.0/2.0
- Match your OS drive size or larger. If you have a 1TB drive, purchase a 1TB drive or a 2TB+ drive, if you want to store multiple backups.
### Select Data to Back Up

### Internal
By default, Deja Dup backs up the **Home** directory. This excludes **Downloads** and **Trash**.
Use (+) and (-) to customize included/excluded folders.

If your system included a second drive beside the OS drive, we have this [article](/articles/extra-drive/) that goes over setting up the drive to auto-mount once the OS is either repaired or reinstalled.
If we have the installed OS mounted in the live disk open the <u>Files</u> application then go to ***Other Locations*** to access the secondary drive. Unless you've changed the name of your drive, System76 systems ship with secondary drives labelled "Extra Drive" or "Extra Drive #."
### Choose a Backup Location

#### Restoring Your Data
## External Drive

Once we have our data backed up we can reinstall the OS. This [article](/articles/install-pop) goes over the usual install process whether you're intalling from Recovery or a Live Disk:
Use USB 3.0 or 2.0 hard drive that matches the capacity of your current operating system drive.

Now that we reinstalled the OS we can start restoring our data. To restore your data with Deja Dup, select the **Overview** page, then click the **Restore...** button. This will allow you to select the location containing the Deja Dup backup folder, and will copy the data from the most recent backup to its original location.
## Internal Drive

![Restoring data in Deja-Dup](/images/backup/deja_overview.png)
1. Open **Files** > **Other Locations**
* Look for secondary drives or partitions.
* On System76 devices, secondary drives may be labeled **Extra Drive**.
* If you are troubleshooting boot or recovery issues, temporarily removing the secondary drive can help isolate the problem and prevent conflicts during the recovery process.
* Refer to your model's service manual to remove the drive safely.

## If the System Doesn't Power On
* Use a USB-to-SATA adapter to connect it to another system.
### Initiate the Backup

Refer to your models [service manual](/articles/guides) for removing the drive(s). Once you have moved the drives containing your data to another system, you can transfer them to an external hard drive (or other location) with the steps in our [backup article](/articles/backup-files).
## If the Drive is the Problem

## What if the Drive is the Problem?
* Stop using the drive immediately.
* Contact a professional data recovery service.

If signs are pointing to the drive itself being the issue, and your files are corrupted, or no longer accessible, a data recovery service may be the only viable option. If that is the case, remove the drive, and stop using it until it can be taken to a data recovery site. Continued use of the drive may exacerbate bad sectors, or overwrite existing, partially retrievable data.
_Note:_ System76 and Ubuntu do not offer or partner with recovery service. Drive manufacturers may offer recovery options under warranty.

> **NOTE:** Data recovery services are not guarantees of data recovery, and may be cost-prohibitive for some users. System76 is not a data recovery service. Nor do we partner with any. A data recovery service is not a substitute for having robust backups. However, your drive manufacturer may provide data recovery services as part of your service agreement or warranty.
### Set Up Scheduled Backups

## Future Steps
Use Deja Dup or rsync to automate backups on a daily or weekly schedule. This ensures your data is protected without manual effort.
Follow the **3-2-1** Backup Rule
To protect your data against hardware failure, theft, or unexpected events:

Now that we have our data, and a clean install of the OS, let's prepare for if this issue happens again. It's good practice to set up scheduled backups. Our [backup article](/articles/backup-files) can help.
* **3 total copies** of your important files
* **2 stored locally** (e.g., internal drive + external USB)
* **1 stored off-site**, such as:
* A cloud storage service (e.g., Dropbox, Google Drive, Backblaze)
* An external drive kept at a trsuted relative's house
* A secure location like a safety deposit box
**This layered approach ensures that even if one or two copies are compromised, your data remains recoverable.**

> **NOTE** Good practice to prevent data loss is to ensure that any important files are backed up in at least three (3) places. Two (2) copies on-site, and one (1) copy off-site. This off-site backup could be through a cloud storage solution, or a drive that's kept at a relative's house, or in a safety deposit box.
## Restoring Data after Reinstall

<!--Rsync/Your Script? Let's also link to the service manuals page in case they need to pull the drive.-->
1. Open **Backups**.
2. Click **Restore**
3. Select the backup location.
4. Deja Dup will restore the most recent backup to its original location.
Loading