Restore files from the Code42 agent

Overview

Use the Code42 agent to restore files whenever you have access to one of your devices. The Code42 console is convenient for restoring files when you are not near one of your devices. However, the Code42 agent offers you the most flexibility. This article describes how to restore files from the Code42 agent.

Videos

Watch the short video below to learn how to restore files from the Code42 agent. For more videos, visit the Code42 University.

Considerations

Restore files from the Code42 agent

Restore a single file

  1. Sign in to the Code42 agent.
  2. See a list of backed-up files:
  1. Click Restore Files.
  2. (Applies only if you have multiple devices) From the menu, select the device that originally backed up the files you want to restore.
  1. If you back up to multiple destinations, select the destination from Restore files from.
    The backup set list appears after Restore files from if you have multiple backup sets that use the same destination. Select the backup set that contains the files you want.

  2. (Optional) If you want to restore an earlier version of your files, click As of Today to select a previous date from a calendar.
  3. Navigate to the file you wish to restore.
    Learn more about finding files (including hidden or deleted files) below.
  4. Mouse over the file, and click the download icon Download icon.
    Your download is added to Downloads with the default files options. Download Activity displays the status of your download.

Restore multiple files

  1. Sign in to the Code42 agent.
  2. See a list of backed-up files:
  1. Click Restore Files.
  2. (Applies only if you have multiple devices) From the menu, select the device that originally backed up the files you want to restore.
  1. If you back up to multiple destinations, select the destination from Restore files from.
    The backup set list appears after Restore files from if you have multiple backup sets that use the same destination. Select the backup set that contains the files you want.

  2. (Optional) If you want to restore an earlier version of your files, click As of Today to select a previous date from a calendar.
  3. Select the checkboxes for the folders and files you want to restore.
    Learn more about finding files (including hidden or deleted files) below.
  4. Select Restore Files.
    The Restore Files Options (or Get Files Options) window appears.
    Restore multiple files
  5. Update the options to specify the restore location, naming guidelines, and permissions for your restored files.
  6. Click Go.
    Your download is added to Downloads. Download Activity displays the status of your download.
 Restore tips
  • It is safe to close the Code42 agent while the files restore in the background.
  • If you are restoring a large amount of data, consider optimizing your computer settings to prevent disruptions.
  • Alternatively, if you don't want to restore all of the files at once, you can shut down or put your device to sleep and restoration will resume where it left off when it is powered on again.

Find files to restore

Search

To restore a specific file, first search for it by providing all or part of the file name or extension. Click the search icon and enter your search term.

Restore search bar

Search Rule Example Results
Search for any part of a file name win winter.txt, winters.txt, winner.txt
Searches are not case-sensitive Winter.txt winter.txt
Spaces are treated the same as any other character

winter c

winte c

Winter Campaign-Ad 1.mp4

(0 results found)

Question mark ( ? ) is a placeholder for one character

winter?.txt

winters.txt

Asterisk ( * ) is a placeholder for any number of characters, including no character win*.txt winter.txt, winters.txt, winner.txt
Toggle between searching and browsing
You can click a folder within your search results to resume browsing. To return to your search results, click the search icon. Your search term is retained until you clear the term, close the search bar, or exit the Restore files or Get files view. Files selected for restoration remain selected when toggling between search and browse.

Deleted files

The Code42 agent stores deleted files based on your deleted file retention settings. To see or search for deleted files:

  1. From Home, navigate to a list of backed-up files:
  1. Click Restore Files.
  2. (Applies only if you have multiple devices) From the menu, select the device that originally backed up the files you want to restore.
  1. If you back up to multiple destinations, select the destination from Restore files from.
    The backup set list appears after Restore files from if you have multiple backup sets that use the same destination. Select the backup set that contains the files you want.

  2. Click the options menu.
    Restore deleted files
  3. Choose Include deleted files.
    Deleted files are shown with a trash can icon to the right of the Date Modified column.
  4. Select the files that you want to restore. 
  5. Click Restore Files.

After you enable Include deleted files, your deleted files appear in the file browser and can be restored. You may also search for deleted files by entering a term in the search bar.

Previous file version

To browse all of the file versions backed up for a particular file, mouse over the file in the Restore files and click the versions icon Versions icon. All versions of the file backed up prior to the selected As Of date display.

View versions of a file in the Code42 app

To restore a previous version, you can either:

  • Mouse over the version and click the download icon Downloads icon to add the file to Downloads.
  • Select the radio button for the version. Then, either browse back to the folder containing the file to select additional files, or click Restore Files or Get Files to view options for restoring the file.

Hidden files

Some temporary and system files are hidden in the Restore Files view because you do not typically need to interact with these files. Hidden files and locations do not appear in the file selection list by default. To view hidden files:

  1. Choose the options menu Options menu.
  2. Select Show hidden files to view hidden files.
    Hidden Windows files are always listed
    Code42 does not support metadata for hidden Windows files. Therefore, hidden files in Windows always appear on Restore screens in the Code42 agent and Code42 console, regardless of whether you've chosen to show or hide them.

Files options

The Code42 agent suggests default settings for restoring your files. You can change these settings before restoring your files.

Customize options for restore or get files
If you modify the default settings, the Code42 agent will use the modified settings until you either exit the Restore files view or close the Code42 agent. However, when you use the download icon Download icon for a single file, the Code42 agent will always use the default options.

Restore files options

Save selected files to

By default, the Code42 agent restores files to your device's Downloads folder. To change the restore location, select Downloads.

Choose one of the following locations:

  • Desktop
  • Original location
    Original location is disabled if you are restoring files to a different operating system than the original device.
  • Other (opens a file browser for selecting a folder on your device)

Original Location No Longer Exists
If you restore files to their original location, but that location no longer exists, the Code42 agent recreates the folders used by the original location.

For example, suppose you back up the folder C:\Users\Jim\Documents. Later, you replace your device and use a different username. Your new Documents folder is located at C:\Users\James\Documents. If you restore your Documents folder to the original location, the Code42 agent creates a folder labeled Jim under the C:\Users directory and restore the Documents folder there. In this scenario, you probably don't want to restore files to their original location.

If file already exists

If a file is restored to a location that already contains a file with the same name, the Code42 agent defaults to renaming the existing file on the device with the prefix original1. Choose how the Code42 agent handles matching file names by clicking Rename:

  • Overwrite: If a duplicate name is detected, the Code42 agent replaces the existing file with the restored file.
  • Rename: If a duplicate name is detected, the name of the restored file remains unchanged but the Code42 agent renames the existing file on the device with the prefix original1.
Rename your files
If you aren't sure whether you want to rename or replace, choose the rename option. You can always delete the duplicate original* files later.

Permissions

To change permissions, you must have write permissions to the files. Two settings are available:

  • Current: (Best practice) When the file is restored, its ownership is changed to be the user doing the restore. 
  • Original: When the file is restored, it retains the ownership that the user had on the file when it was backed up. 

Restore files with Current permissions instead of Original permissions to avoid file access issues. For example:

  • If you did not originally have permissions to a directory where files were backed up, restore the files using Current permissions to give yourself access to the restored files in that directory.
  • If files were originally backed up on a different device, restore the files using Current permissions to give yourself access to the restored files on your current device.

Restore files to a different operating system

These considerations apply if you are, for example, moving from a Windows device to a Mac device.

  • Restore your files to a specific location rather than the original location because the device you are restoring to has a different file-system structure than the original device.
  • The option to save selected files to Original Location is automatically disabled when restoring files from a different operating system.
  • Some file metadata may be lost when restoring files to a different operating system. To preserve all file metadata, restore to a device with the same operating system as the original.
  • Filenames containing characters that are illegal on the operating system you restore to cannot be restored to that device. Restore those files to a device of the same operating system or use the Code42 console to restore those files.
How to restore Mac files to a Windows device
If you plan to restore Mac files to a Windows device, use the more restrictive Windows naming rules with your Mac files to prevent any potential problems.
Only Linux devices honor case-sensitivity
Files whose names differ only in capitalization are recognized as distinct files on Linux devices when you select files for backup, as well as when you select files for download. On Windows and Mac devices, files whose names differ only in capitalization are treated as the same file. When you restore two Linux files whose names differ only in capitalization to a Windows or Mac device, the files have "original<number>" prefixed to their names to differentiate them from one another.

Restore an external hard drive

If you try to restore files that were originally stored on an external hard drive, and that hard drive is not currently connected to the source device, the Code42 agent treats the files as missing. To restore:

  • If you are replacing the original drive (due to failure or another loss), see our guide to Download files after replacing a drive
  • If you are not replacing the drive, but it is not currently available (or you don't want to connect it because you are only restoring a few files), you can select Show deleted files to restore the files.

Restore order 

When restoring files, the Code42 agent gives priority to newer files. Files backed up less than 7 days ago are restored first (smallest to largest), followed by files backed up more than 7 days ago (smallest to largest). 

External resources