ln Command in Linux: Create Symbolic Links

When a tool, configuration file, or release directory moves, you do not always want to chase every script and shortcut that points at it. A symbolic link gives you a stable name to keep pointing at the right target, and the ln command is what creates those links on Linux.

This guide explains how to create symlinks in Linux with the ln command, how to overwrite or update them safely, and how to clean up broken links.

Link Types #

There are two types of links in Linux/UNIX systems:

• Hard links. You can think of a hard link as an additional name for an existing file. Hard links are linking two or more file names with the same inode . Hard links are for files, and most systems do not allow hard links to directories. One file can have one or more hard links.
• Soft links. A symbolic link, also referred to as a soft link, is a type of file that acts as a reference to another file or directory in the file system. It is comparable to a shortcut in the Windows operating system, as it allows you to access a file or directory from a different location without creating a copy of it. Symbolic links are useful for organizing files, as well as for making it easier to access frequently used files or directories. Unlike a hard link, a symbolic link can point to a file or directory on a different partition or filesystem.

How to Use the ln Command #

ln is a command-line utility for creating links between files. By default, the ln command creates hard links. To create a symbolic link, use the -s (--symbolic) option.

The ln command syntax for creating symbolic links is as follows:

ln -s [OPTIONS] FILE LINK

• If both the FILE and LINK are given, ln will create a link from the file specified as the first argument (FILE) to the file specified as the second argument (LINK).
• If only one file is given as an argument or the second argument is a dot (.), ln will create a link to that file in the current working directory . The symlink will have the same name as the file it points to.

By default, on success, ln does not produce any output and returns zero.

Creating a Symlink to a File #

To create a symbolic link to a given file, open your terminal and type:

ln -s source_file symbolic_link

Replace source_file with the name of the existing file for which you want to create the symbolic link and symbolic_link with the name of the symbolic link.

The symbolic_link parameter is optional. If you do not specify the symbolic link, the ln command will create a new link in your current directory:

In the following example, we are creating a symbolic link named my_link.txt to a file named my_file.txt:

ln -s my_file.txt my_link.txt

To verify that the symlink was successfully created, use the ls command:

ls -l my_link.txt

The output will look something like this:

lrwxrwxrwx 1 linuxize users  4 Nov  2 23:03  my_link.txt -> my_file.txt

The l character is a file type flag that represents a symbolic link. The -> symbol shows the file the symlink points to.

You can use either absolute or relative paths. Relative links are easier to move as long as the file layout stays the same.

Creating Symlinks to a Directory #

The command for creating a symbolic link to a directory is the same as for creating a symbolic link to a file. Specify the directory name as the first parameter and the symlink as the second parameter.

For example, if you want to create a symbolic link from the /mnt/my_drive/movies directory to the ~/my_movies directory you would run:

ln -s /mnt/my_drive/movies ~/my_movies

Creating Hard Links #

Without the -s flag, ln creates a hard link instead of a symbolic one. A hard link points to the same inode as the original file, so both names refer to exactly the same data on disk.

To create a hard link, drop the -s:

ln my_file.txt my_hardlink.txt

If you list the file with ls -li, both names share the same inode number:

ls -li my_file.txt my_hardlink.txt

1234567 -rw-r--r-- 2 linuxize users 12 Apr 29 10:00 my_file.txt
1234567 -rw-r--r-- 2 linuxize users 12 Apr 29 10:00 my_hardlink.txt

The 2 in the link-count column shows that two names point to the same inode. Hard links cannot cross filesystems and, on most systems, cannot point to directories. Reach for symlinks when you need either of those.

Overwriting and Updating Symlinks #

If you attempt to create a symbolic link that already exists , the ln command will output an error message.

ln -s my_file.txt my_link.txt

ln: failed to create symbolic link 'my_link.txt': File exists

To overwrite the destination path of the symlink, use the -f (--force) option.

ln -sf my_file.txt my_link.txt

If the existing link points to a directory, plain -f will not do what you expect. ln follows the symlink and creates the new link inside the target directory instead of replacing the link itself. To swap the link in place, add the -n (--no-dereference) flag:

ln -sfn /opt/app/releases/2.1.0 /opt/app/current

This pattern is common in simple deployment scripts. /opt/app/current is a symlink that always points at the active release directory, and ln -sfn replaces it with a link to the new release.

For a stricter atomic swap, create a temporary symlink and move it over the existing link:

ln -s /opt/app/releases/2.1.0 /opt/app/current.tmp
mv -Tf /opt/app/current.tmp /opt/app/current

mv -T treats the destination as a normal path instead of moving the temporary link into a directory. The final rename is atomic on the same filesystem.

Listing and Finding Symlinks #

To check whether a single file is a symlink, use ls -l. Symlinks show up with an l as the first character and an arrow pointing at the target:

ls -l /usr/bin/python3

lrwxrwxrwx 1 root root 10 Mar 14 09:12 /usr/bin/python3 -> python3.12

To list every symlink under a directory, ask find for the file type l:

find /etc -type l

To find broken symlinks (links whose target no longer exists), use find with -xtype l:

find /etc -xtype l

-xtype l evaluates the type after dereferencing, so a symlink whose target is missing reports as a link rather than a regular file or directory.

Resolving the Target with readlink #

When a symlink points to another symlink, or you want to know the absolute path it resolves to, ls -l only shows the immediate target. The readlink command gives you that one hop, and readlink -f walks the whole chain to the final canonical path.

readlink /usr/bin/python3

python3.12

readlink -f /usr/bin/python3

/usr/bin/python3.12

readlink -f is the form most scripts want, since it returns a path you can pass to other commands without worrying about how many indirection steps it took to get there.

Symlink Permissions #

The mode you see on a symlink (lrwxrwxrwx) is misleading. It always reads as 777 because Linux ignores the link’s own permissions and uses the target’s permissions for any read, write, or execute operation. Running chmod on a symlink follows the link and changes the target’s mode, not the link’s.

On Linux, you normally cannot change the symlink node permissions with GNU chmod. Change the permissions on the target file instead, and treat the symlink mode shown by ls -l as informational.

Removing Symlinks #

To delete/remove symbolic links , use either the unlink or rm command.

The syntax of the unlink is very simple:

unlink symlink_to_remove

Removing a symbolic link using the rm command is the same as when removing a file:

rm symlink_to_remove

No matter which command you use, when removing a symbolic link do not append the / trailing slash at the end of its name.

If you delete or move the source file to a different location, the symbolic file will be left dangling (broken) and should be removed.

Quick Reference #

For a printable quick reference, see the ln cheatsheet .

Troubleshooting #

File exists when creating a link
The destination path is already in use. Use ln -sf to overwrite it, or remove the existing file or link first.

Broken or dangling symlink
The target was renamed, moved, or deleted. Either point the link at the new location with ln -sfn, or delete the link with unlink.

Too many levels of symbolic links
A symlink eventually points back at itself, forming a loop. Use readlink -f to trace the chain and break the cycle.

Permission denied when creating a link
You do not have write permission on the parent directory of the link path. Either run the command with sufficient privileges, or place the link somewhere you own.

chmod on a symlink does not change the link
On Linux, chmod follows the symlink and modifies the target. GNU chmod does not provide a portable way to change the symlink node permissions, and Linux ignores those permissions for normal access checks.

FAQ #

What is the difference between ln -sf and ln -sfn?
ln -sf overwrites the destination, but if the destination is itself a symlink to a directory, ln follows that symlink and writes the new link inside the target directory. Adding -n tells ln not to dereference the destination, so the link itself is replaced. Use ln -sfn when the destination might already be a symlink to a directory. For deployment paths where readers may hit the link during the update, use the temporary symlink plus mv -T pattern shown above.

What is the difference between a hard link and a symbolic link?
A hard link is another name for the same inode, so both names refer to the same data on disk and share permissions and ownership. A symbolic link is a small file that stores the path to its target, can cross filesystems, and can point at directories. If the target of a symlink is removed, the symlink becomes broken; deleting one hard link still leaves the data accessible through the others.

Does sudo ln do anything different?
sudo only changes the user that runs the command. The link itself behaves the same way. Reach for sudo ln when you need to create a link inside a directory you do not own, such as /usr/local/bin.

How do I find every symlink in a directory?
Run find /path -type l to list them, or find /path -xtype l to list only the broken ones.

Can a symlink point to a file that does not exist yet?
Yes. ln -s does not check that the target exists at creation time. The link will resolve as broken until the target is created, which is sometimes useful when laying out a directory tree before populating it.

Conclusion #

ln -s source link_name covers most day-to-day symlink work, and ln -sfn is the safe form for updating a link that may already exist. For the full set of options, see the ln man page or type man ln in your terminal.

About the authors

Dejan Panovski

Dejan Panovski is the founder of Linuxize, an RHCSA-certified Linux system administrator and DevOps engineer based in Skopje, Macedonia. Author of 800+ Linux tutorials with 20+ years of experience turning complex Linux tasks into clear, reliable guides.

View author page