How to Use chmod Command
Modify File Permissions with chmod
The chmod command allows users to change read and write permissions in Unix systems. In this guide, we will show you how to modify file and directory permissions with chmod.
This guide provides a brief overview of file permissions and the operation of the
chmod command in addition to a number of practical examples and applications of
Basics of Linux File Permissions
All file system objects on Unix-like systems have three main types of permissions: read, write, and execute access. Permissions are bestowed upon three possible classes: the owner, the group, and all other system users.
To view the file permissions of a set of files, use:
drwxr-xr-x 2 owner group 4.0K 2009-08-13 10:16 docs
-rw-r--r-- 1 owner group 8.1K 2009-07-09 16:23 roster.py
lrwxrwxrwx 2 owner group 4.0K 2009-08-13 10:16 team.docs
A way to understand the meaning of this column is to divide the bits into groups.
|- Regular file
|l Symbolic Link
The first character represents the type of file. The remaining nine bits in groups of three represent the permissions for the user, group, and global respectively. Each stands for:
Note that access to files targeted by symbolic links is controlled by the permissions of the targeted file, not the permissions of the link object.
How to Use chmod
In this guide, chmod refers to recent versions of chmod such as those provided by the GNU project.
Changing File Permissions with chmod
To change the file permissions using chmod, run
chmod <permission> <directory or filename>, swapping in the desired file permissions and the directory or file. The owner can change file permissions for any user, group or others by adding
- to remove or
+ to add certain permissions. These permissions are categorized into read, write, or executable.
In the next few sections, we are going to dive deep into chmod syntax.
Using Symbolic Notation Syntax with chmod
The format of a chmod command is:
chmod [who][+,-,=][permissions] filename
Consider the following chmod command:
chmod g+w ~/example.txt
This grants all members of the usergroup that owns the file
~/example.txt write permissions. Other possible options to change permissions of targeted users are:
+ operator grants permissions whereas the
- operator takes away permissions. Copying permissions is also possible:
chmod g=u ~/example.txt
g=u means grant group permissions to be same as the user’s.
Multiple permissions can be specified by separating them with a comma, as in the following example:
chmod g+w,o-rw,a+x ~/example-files/
This adds write permissions to the usergroup members, and removes read and write permissions from the “other” users of the system. Finally the
a+x adds the execute permissions to all categories. This value may also be specified as
+x. If no category is specified, the permission is added or subtracted to all permission categories.
In this notation the owner of the file is referred to as the
chmod -R +w,g=rw,o-rw, ~/example-files/
-R option applies the modification to the permissions recursively to the directory specified and to all of its contents.
Using Octal Notation Syntax with chmod
Another method for setting permissions is through octal notation.
Here is example of a file permission that is equivalent to
chmod 750 ~/example.txt
The permissions for this file are
- rwx r-x ---.
Disregarding the first bit, each bit that is occupied with a
- can be replaced with a
x is represented by a
1. The resulting conversion is:
111 101 000
This is called octal notation because the binary numbers are converted to base-8 by using the digits 0 to 7:
Each digit is independent of the other two. Therefore,
750 means the current user can read, write, and execute, the group cannot write, and others cannot read, write, or execute.
744, which is a typical default permission, allows read, write, and execute permissions for the owner, and read permissions for the group and “world” users.
Either notation is equivalent, and you may choose to use whichever form more clearly expresses your permissions needs.
Examples of Common Permissions with chmod
chmod 600 (
600 permissions means that only the owner of the file has full read and write access to it. Once a file permission is set to 600, no one else can access the file. Example chmod commands (in octal and symbolic notions) setting permissions to 600:
chmod 600 example.txt
chmod u=rw,g=,o= example.txt
chmod a+rwx,u-x,g-rwx,o-rwx example.txt
chmod 664 (
rw-rw-r--) enables the following permissions: read and write for the owner; read and write for the group; read for others. If you trust other users within the same group and everyone needs write access to the files, this is a common setting to use. Otherwise
644 permissions can be used to restrict write access to the group. Example chmod commands (in octal and symbolic notions) setting permissions to 664:
chmod 664 example.txt
chmod u=rw,g=rw,o=r example.txt
chmod a+rwx,u-x,g-x,o-wx example.txt
chmod 777 (
chmod 777 is used to grant permissions to everyone to read, write, and execute a file. While using these permissions is a quick way to overcome a permissions-based error, it’s not a best practice for securing most files and applications. Example chmod commands (in octal and symbolic notions) setting permissions to 777:
chmod 777 example.txt
chmod u=rwx,g=rwx,o=rwx example.txt
chmod a=rwx example.txt
Making a File Executable
The following examples changes the file permissions so that any user can execute the file “~/example.py”:
chmod +x ~/example.py
Restore Default File Permissions
The default permissions for files on a Unix system are often
644. Permissions of
600 mean that the owner has full read and write access to the file, while no other user can access the file. Permissions of
644 mean that the owner of the file has read and write access, while the group members and other users on the system only have read access.
Issue one of the following chmod commands to reset the permissions on a file back to one of the likely defaults:
chmod 600 ~/example.txt
chmod 644 ~/example.txt
For executable files, the equivalent settings would be
755 which correspond to
644 except with execution permission.
Use one of the following examples to achieve these executable “default” permissions:
chmod 700 ~/example.py
chmod 755 ~/example.py
Removing File Permissions with chmod
In order to remove read write permissions given to a file, use the following syntax:
chmod o-rw example.txt
For our file example.txt, we can remove read write permissions using chmod for group by running the following command:
chmod g-rx example.txt
To remove chmod read write permissions from the group while adding read write permission to public/others, we can use the following command:
chmod g-rx, o+rx example.txt
But, if you wish to remove all permissions for group and others, you can do so using the go= instead:
chmod go= example.txt
Restrict File Access: Remove all Group and World Permissions
There are a number of cases where administrators and users should restrict access to files, particularly files that contain passwords and other sensitive information. The configuration files for msmtp and Fetchmail (
~/.fetchmailrc) are two common examples.
You can remove all access to these files with commands in one of the following forms:
chmod 600 .msmtprc
chmod g-rwx,o-rwx .fetchmail
Understanding Linux Directory Permissions
While directory permissions within Linux are similar to file permissions, there are a few key differences regarding how these permissions affect user operations:
- Read (
r): User can list the items in a directory (such as when using the
- Write (
w): User can add, delete, or rename files in a directory - provided the user also has execute permissions.
- Execute (
x): User can navigate to the directory (such as when using the
To view permissions of all files and directories within the working directory, run
ls -la. The output will be similar to snippet below. Directories are differentiated from files by the first bit within the permissions. As was covered previously,
d stands for directory and
- denotes the item is a file.
drwxr-xr-x 3 user group 4096 Apr 16 12:34 .
drwxr-xr-x 4 user group 4096 Apr 16 12:33 ..
drwxr-xr-x 2 user group 4096 Apr 16 12:34 example-directory
-rw-r--r-- 1 user group 0 Apr 16 12:34 file1.txt
Permissions on an individual directory can also be viewed by running
ls -dl example-directory.
How To Change Directory Permissions using chmod
Directory permissions can be adjusted using the same chmod commands as were previously outlined for modifying file permissions. The following example changes permissions on a directory to 755 (owner has read, write and execute permissions, while users with the group or any other user have read and execute permissions):
chmod 755 /example-directory/
In many cases, the permissions should also be changed recursively on all files and subdirectories. This can be done through chmod by using the
-R option. To change all permissions for files within a directory to read and write for the owner, read for the group, and read for other users, run the following command:
sudo chmod -R 644 /var/www/html/
- Welcome to visit the knowledge base of SRE and DevOps!
- License under CC BY-NC 4.0
- Made with Material for MkDocs and improve writing by generative AI tools
- Copyright issue feedback me#imzye.com, replace # with @