Create Symbolic Link in Linux

You are currently viewing Create Symbolic Link in Linux

What is a symbolic link? A symbolic link, often termed a symlink or soft link, is a type of special file that refers to another file or directory in the form of an absolute or relative path. In simpler terms, it’s like a shortcut that points to another file or directory.

Why use symbolic links? Symbolic links are versatile tools that come with several benefits:

  • Flexibility: They can link across file systems and point to non-existent destinations.
  • Space-saving: Symlinks take up negligible space, allowing you to have multiple references without duplicating the actual content.
  • Ease of management: Useful for creating quick shortcuts or ensuring multiple folders are referencing the same original content, facilitating updates.


Required software and permissions: To create symbolic links, you’ll need:

  • A Linux system or a Unix-like system.
  • Command-line access (typically via a terminal or SSH).
  • Appropriate permissions to read the target and write to the location where the symlink will be created.

Verifying you’re on a Linux system: You can quickly check your system’s details using the following command:

uname -a

This will display details about your operating system, kernel version, and other system specifics.

Understanding Hard Links vs. Symbolic Links

Definitions and Differences:

  • Hard Links: A hard link is essentially an additional name for an existing file on Linux. It’s a direct reference to the data on the disk, and there’s no distinction between the hard link and the original file. Deleting one won’t affect the other unless it’s the last link to the file.
  • Symbolic Links: Unlike hard links, a symbolic link is a separate file that points to another file or directory by its path. If you delete the original file, the symlink becomes a broken link.

Pros and Cons of each:

  • Hard Links:
    • Pros:
      • Multiple names for a single file can be useful for organizations without duplication.
      • Deletion of one hard link won’t delete the actual content.
    • Cons:
      • Cannot cross file systems.
      • Cannot link to directories (with some exceptions).
  • Symbolic Links:
    • Pros:
      • Can link both files and directories.
      • Can cross file systems.
      • Can establish links using relative paths.
    • Cons:
      • This can result in “dangling” links if the source is deleted or moved.
      • Can introduce potential security vulnerabilities if misused.

Creating a Symbolic Link: Step-by-Step Guide

Syntax overview: The primary command used to create symbolic links is ln with the -s option:

ln -s [target] [link_name]


  • [target] is the original file or directory you want to link to.
  • [link_name] is the name of the symbolic link you want to create.


Linking a file:bashCopy codeln -s /path/to/original/file.txt /path/to/link_name.txt

Linking a directory:bashCopy codeln -s /path/to/original/directory/ /path/to/link_directory/

Creating a symbolic link with a relative path: Inside the directory where you want to create the symbolic link:bashCopy codeln -s ../original/file.txt link_name.txt

Viewing and Identifying Symbolic Links

Using ls with appropriate flags: To view and identify symbolic links, the ls command coupled with the -l (long format) flag is quite useful.

ls -l /path/containing/symlink

This will display files and directories in a detailed manner. Symbolic links will be identified with an l at the beginning of their permissions string and will show the path to their target.

Difference in color coding in terminal (if applicable): Many modern terminals differentiate symbolic links by displaying them in a different color, typically cyan. This coloration can be particularly useful for quickly identifying symlinks among a list of files and directories.

Managing and Modifying Symbolic Links

Updating the target of a symbolic link: Unlike hard links, symbolic links can be modified to point to a different target. To do this, you’ll typically remove the old symlink and create a new one with the same name.

rm link_name.txt
ln -s /new/path/to/original/file.txt link_name.txt

Removing a symbolic link: To remove a symbolic link without affecting its target, use the rm command:

rm /path/to/symlink

Handling broken symbolic links: When the target of a symbolic link is deleted or moved, the link becomes “dangling” or “broken”. You can identify such links using the find command:

find /path/to/search/ -xtype l

This command will list all broken symbolic links under the given path.

Potential Issues and Troubleshooting

Common errors and their solutions:

  1. Dangling or Broken Link:
    • Symptom: Accessing a symbolic link results in an error like “No such file or directory.”
    • Solution: Check the target of the symbolic link using ls -l. If the target doesn’t exist, either update the symlink to a valid target or remove the symlink.
  2. Permission Denied:
    • Symptom: Unable to create a symbolic link due to insufficient permissions.
    • Solution: Ensure you have write permissions in the directory where you’re trying to create the symlink. If necessary, use sudo (with caution) or adjust directory permissions.

Checking if the original file or directory exists: Use the file command to check the status of a symlink:

file /path/to/symlink

If the link is broken, it will state something like “broken symbolic link to [target]”.

Permissions issues: Remember, while the symbolic link itself has permissions, they are often ignored in favor of the target’s permissions. Thus, even if a symlink has read permissions, you won’t be able to access it if the target doesn’t have the appropriate permissions.

Use Cases for Symbolic Links

Organizing files and directories: Symbolic links can be valuable organizational tools, helping you structure files across different directories or disks without duplicating data.

Versioning and backups: If you have different versions of a file or directory, symbolic links can point to the current version. This makes switching between versions as simple as updating the symlink’s target.

Application and software management: Many applications use symlinks to reference libraries or other shared resources. When updating software, new versions of these resources can be installed side by side with the old ones, and symlinks updated to point to the new versions without affecting dependent applications.

Security Considerations

Symbolic link vulnerabilities: Symbolic links can sometimes be used maliciously. An attacker might trick a user or system process into overwriting a file by replacing a symlink that was expected to be safe.

Safe practices when using symbolic links:

  • Always verify the target of a symlink before acting upon it.
  • Be wary of symlinks in untrusted directories or from untrusted sources.
  • When writing scripts or software, always validate paths and consider potential symlink attacks.
  • Restrict permissions appropriately. Do not give untrusted users the ability to create or modify symbolic links in sensitive directories.


Symbolic links are powerful tools in the Linux and Unix-like systems, offering flexibility and utility in various scenarios. They play a pivotal role in organizing files, managing software, and facilitating efficient backups and versioning. However, like all tools, they come with their set of challenges and risks. Being aware of these and knowing how to handle them will enable you to make the most of symbolic links.

Frequently Asked Questions (FAQ)

1. What’s the difference between a hard link and a symbolic link?

  • A hard link is another reference to the same inode (and therefore the data) as the original file, whereas a symbolic link is a separate file that points to another file or directory by its path.

2. How can I identify a broken symbolic link?

  • Use the find command: find /path/to/search/ -xtype l to list all broken symbolic links under the specified path.

3. Do symbolic links work across different file systems?

  • Yes, symbolic links can point to files or directories across different file systems. This is one of their advantages over hard links.

4. If I delete a symbolic link, will it delete the original file or directory?

  • No, deleting a symbolic link only removes the link itself, not the target it points to.

5. Can symbolic links pose a security risk?

  • Yes, if not used carefully. For instance, an attacker might exploit a symlink to trick a system process into overwriting a critical file. Always validate paths and be cautious of symlinks from untrusted sources.

6. Why are some symbolic links displayed in a different color in the terminal?

  • Many terminal configurations use color to differentiate file types. Typically, symbolic links appear in cyan or another distinctive color to help users easily identify them.

Atiqur Rahman

I am MD. Atiqur Rahman graduated from BUET and is an AWS-certified solutions architect. I have successfully achieved 6 certifications from AWS including Cloud Practitioner, Solutions Architect, SysOps Administrator, and Developer Associate. I have more than 8 years of working experience as a DevOps engineer designing complex SAAS applications.

Leave a Reply