Skip to main content
Code42 Support

How to use soft and hard links with the Code42 app

Available in:

Small Business
Applies to:


File links are used to create shortcuts from one file location to another on your device. If used unwisely, these links can cause many types of software—including the Code42 app—to interact with the same files more than once.

This article describes how to use soft and hard links in order to avoid problems for the Code42 app.

How file links work

Your device uses files to physically locate information on the hard drive (or other storage drive, like a solid state drive). For an in-depth examination of exactly how your device works with files and file links, check our External Resources.

File links refer to files, but they don't contain much information themselves. There are two different types of file links that operate slightly differently: soft links and hard links.

Soft links

A soft link is a type of file link that references another file. Soft links are also called "symlinks" in some environments. Soft links can point to any file on your system, even supporting links from one hard drive or logical volume to another. In fact, soft links can also point to a file or path that doesn't exist yet. Because soft links are so versatile, they are used throughout many UNIX operating systems, including Mac and many Linux distros.

Soft link backup considerations

Mac and Linux

  • The Code42 app backs up soft links, but not the target of the soft link. If you back up a soft link with the Code42 app, be aware that only the link is backed up—not the target file.
  • Soft links can link to files with relative paths or absolute paths. When you download a soft link, it is downloaded in the same state it was backed up in (relative or absolute). It is possible to download a soft link and its target in such a way that the link does not accurately point to the target.


The Code42 app backs up the targets of soft links, but not the soft links themselves. When files are restored, only the targets are restored, not the soft links. (The Code42 app handles junction points the same way.)

Hard links

A hard link is a type of file link that references a specific physical location on a storage drive. Hard links are more efficient than soft links because they don't deal with the complexities supported by soft links. Hard links are also limited in some ways, such as being restricted from hard linking directly to a folder. However, hard links represent another instance of a file without actually being a separate copy, and that can cause problems for some software.

Hard link backup considerations

  • The Code42 app follows hard links when examining your drive for files to back up. As a result, using lots of hard links can quickly increase the total file count that the Code42 app backs up, and an abnormally high file count can cause poor performance or other unexpected behavior from the Code42 app.
  • The Code42 app follows hard links when examining your drive for files to back up. As a result, using hard links can cause the Code42 app to examine the same information more than once, which can add to backup processing time.
  • Some software and utilities, such as Apple's Time Machine utility, use hard links to accomplish their tasks.

De-duplication and hard links

Hard links can cause the Code42 app to examine the same file more than once, but the Code42 app will not waste space by backing up the same information multiple times. The Code42 app uses data de-duplication to back up all your information as efficiently as possible.

For more information on data de-duplication, read How Backup Works.


Always avoid backing up hard links

If your backup selection includes multiple hard links to the same file, the Code42 app processes the links individually, which can cause poor performance.

To prevent this, deselect files and folders that contain hard links with the Code42 app's file selection feature.

Consider avoiding use of hard links

Many types of software can exhibit strange behavior when working with hard links. If your system can operate well without using hard links, you may want to avoid using them altogether.

Be aware of your soft links

Soft links can trick you into thinking some information is backed up, but in fact only the soft link is backed up. You may want to test your backups by making sure that you can download files from your backup.

Soft links do not carry the same risks as hard links, but they can cause you potential complications when downloading unless you plan ahead and carefully consider your use of soft links.

Still unsure?

If you have more questions about how the {{cpclient}} works with soft and hard links, contact our Customer Champions for Code42 for Enterprise support.

External resources