How to Copy a Directory in Linux

A directory is a file system structure that contains files and other directories. Directories organize files in a hierarchical structure, which helps users and operating systems manage data. Each directory can contain both files and other directories, also called subdirectories, creating a tree-like structure with branches that lead to various levels of data.

This article explains how to copy a directory in Linux using the cp command and Rsync.

Prerequistes

Before you begin, you need to:

• Have access to a Linux-based instance as a non-root sudo user.

Commands for Copying Directories in Linux

The following are the commands for copying directories in Linux.

cp Command

The copy command cp is used to copy files and directories in Linux. The copy command is available in all Linux distributions and follows the syntax below:

cp [OPTIONS]... [SOURCE] [DESTINATION]

• OPTIONS: Flags that modify the command's behavior.
• SOURCE: Specifies the file or directory you want to copy.
• DESTINATION: Directory path you want to copy the source to or a filename if you want to copy and rename a file. The cp command automatically creates a destination directory if it does not exist.

cp Command Options

The following are the options you can use with the cp command.

To learn more about cp, check our detailed article on using the cp command.

rsync Command

The rsync command synchronizes files and directories between two locations, either locally or remotely. Below is the syntax for different use cases. It can copy files locally and between a local and a remote system. Rsync compares timestamps and file sizes to determine what needs to be copied, making it suitable for backups and large-scale data transfers.

• Local Copy

  rsync [OPTIONS]... [SOURCE_DIRECTORY]/ [DESTINATION_DIRECTORY]/

• Local to Remote Copy

  rsync [OPTIONS]... [SOURCE_DIRECTORY]/ [USER@REMOTE_HOST]:[DESTINATION_DIRECTORY]/

• Remote to Local Copy

  rsync [OPTIONS]... [USER@REMOTE_HOST]:[SOURCE_DIRECTORY]/ [DESTINATION_DIRECTORY]/

Syntax Explanation

• OPTIONS: Flags that modify the command's behavior, such as -a (enables archive mode to preserve permissions and attributes), -v (displays verbose output), or -r (performs recursive copy).
• SOURCE_DIRECTORY/: The directory from which to copy. The trailing slash (/) copies the directory's contents, not the directory itself.
• DESTINATION_DIRECTORY/: The target directory to copy contents. Rsync creates it if it doesn't exist.
• USER@REMOTE_HOST: Specifies the remote system with the username, hostname, or IP address for remote transfers.

rsync Command Options

You can use the following options with the rsync command.

Check our detailed article on using rsync to learn more about the command.

Copy a Directory Using the cp Command

In this section, you will create a directory structure, add files and content, and copy directories using the cp command and various flags.

1. Create a new directory in your present working directory.

   console Copy

   $ mkdir sample
   

2. Navigate to the created directory.

   console Copy

   $ cd sample
   

3. Create a file named file1.txt.

   console Copy

   $ touch file1.txt
   

4. Add content to the file1.txt file.

   console Copy

   $ echo "This is a sample file in the main directory." > file1.txt
   

5. Create a subdirectory such as folder1 inside the sample directory.

   console Copy

   $ mkdir folder1
   

6. Create a file inside folder1.

   console Copy

   $ touch folder1/file2.txt
   

7. Add content to the file.

   console Copy

   $ echo "This file is inside folder1." > folder1/file2.txt
   

8. Copy folder1 into the folder1-backup directory using the cp command.

   console Copy

   $ cp -r folder1 folder1-backup
   

   The -r option enables recursive copying, which copies all the content of the sample directory.

9. List the content of the directory to verify the copy.

   console Copy

   $ ls -R
   

10. Navigate back to the parent directory.

    console Copy

    $ cd ..
    

11. Copy the entire sample directory into the sample-copy directory.

    console Copy

    $ cp -r sample sample-copy
    

12. Copy the sample directory using the -v and -p flags.

    console Copy

    $ cp -rvp sample sample-copy-rvp
    

    This command recursively copies the sample directory to sample-copy-rvp, preserving file attributes and showing detailed output.

13. Copy using the sample directory using the -a flag.

    console Copy

    $ cp -a sample sample-copy-a
    

    This command copies the sample directory to sample-copy-a in the archive mode.

14. Verify that the copies exist and contain the correct structure with the command below.

    console Copy

    $ ls -l sample sample-copy sample-copy-rvp sample-copy-a
    

    This command lists each directory and its contents in a detailed format.

    In the output, notice that sample-copy has a newer timestamp. This is because the copy command did not use the -p or -a flags. Both sample-copy-rvp and sample-copy-a preserved the original timestamps and permissions from the sample directory.

Copy a Directory using Rsync

Rsync is a powerful command-line tool for synchronizing files and directories. It is more advanced than cp and useful for backups, partial updates, and large-scale data transfer. Unlike cp, rsync only copies differences between source and destination directories, which saves time and bandwidth. Follow the steps below to copy directories using Rsync.

1. Rsync is installed by default on most Linux distributions. Confirm if it is available on your instance.

   console Copy

   $ rsync --version
   

   If Rsync is missing, refer to the Rsync installation steps to install it.

2. Ensure you are in the directory that contains the sample directory.

3. View the contents of sample to confirm its structure.

   console Copy

   $ ls -R sample
   

4. Copy the sample directory to a new directory using Rsync.

   console Copy

   $ rsync -av sample/ sample-rsync/
   

   This command copies the contents of the sample directory to sample-rsync/ in archive mode, preserving file attributes and showing verbose output.

5. Verify the contents after copying.

   console Copy

   $ ls -R sample-rsync
   

   This command lists the contents of the sample-rsync directory.

6. Add a new file to the sample directory.

   console Copy

   $ echo "This is a new file." > sample/extra.txt
   

   This creates a file that does not exist in the sample-rsync directory.

7. Preview changes without applying them using the --dry-run flag. The --dry-run flag in rsync simulates what will happen during a copy without making any changes to files or directories.

   console Copy

   $ rsync -av --dry-run sample/ sample-rsync/
   

   Output:

   sending incremental file list
   ./
   extra.txt
   
   sent 254 bytes  received 24 bytes  556.00 bytes/sec
   total size is 123  speedup is 0.44 (DRY RUN)

   Note

   extra.txt appears in the output because it is new and not in the sample-rsync directory. Rsync identifies and lists the changes, in this case, just the extra.txt file, and copies the changes, making the transfer efficient.

8. Use rsync to update the sample-rsync directory and view real-time file transfer progress using the --progress flag.

   console Copy

   $ rsync -av --progress sample/ sample-rsync/
   

   Output:

   sending incremental file list
   ./
   extra.txt
               20 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=5/7)
   
   sent 314 bytes  received 40 bytes  708.00 bytes/sec
   total size is 123  speedup is 0.35

   From the output, you can see that Rsync only copies the newly created extra.txt file

9. Check if the new file appears in the copied directory.

   console Copy

   $ ls -R sample-rsync
   

10. Delete a file from the sample directory.

    console Copy

    $ rm sample/extra.txt
    

11. Use the --delete flag to remove files in sample-rsync that no longer exist in sample. Rsync updates the destination by deleting the file.

    console Copy

    $ rsync -av --delete sample/ sample-rsync-copy/
    

12. Confirm that both directories are in sync by running the following command.

    console Copy

    $ ls -l sample sample-rsync
    

    Output:

    sample:
    total 12
    -rw-rw-r-- 1 user user   45 May  7 06:06 file1.txt
    drwxrwxr-x 2 user user 4096 May  7 06:06 folder1
    drwxrwxr-x 2 user user 4096 May  7 06:07 folder1-backup
    
    sample-rsync:
    total 12
    -rw-rw-r-- 1 user user   45 May  7 06:06 file1.txt
    drwxrwxr-x 2 user user 4096 May  7 06:06 folder1
    drwxrwxr-x 2 user user 4096 May  7 06:07 folder1-backup

    You can see that extra.txt has been removed from both directories, and the rest of the structure remains unchanged.

Conclusion

You have copied directories in Linux using the cp command and Rsync. You can use these commands based on your use cases. For more command options, run the man cp command to view the cp manual page and the man rsync command to view the Rsync manual page.