install(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON

INSTALL(1)                    User Commands                    INSTALL(1)

NAME         top

       install - copy files and set attributes

SYNOPSIS         top

       install [OPTION]... [-T] SOURCE DEST
       install [OPTION]... SOURCE... DIRECTORY
       install [OPTION]... -t DIRECTORY SOURCE...
       install [OPTION]... -d DIRECTORY...

DESCRIPTION         top

       This install program copies files (often just compiled) into
       destination locations you choose.  If you want to download and
       install a ready-to-use package on a GNU/Linux system, you should
       instead be using a package manager like yum(1) or apt-get(1).

       In the first three forms, copy SOURCE to DEST or multiple
       SOURCE(s) to the existing DIRECTORY, while setting permission
       modes and owner/group.  In the 4th form, create all components of
       the given DIRECTORY(ies).

       Mandatory arguments to long options are mandatory for short
       options too.

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install--backup\--backup[=CONTROL]]8;;\
              make a backup of each existing destination file

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-b\-b]8;;\     like --backup but does not accept an argument

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-c\-c]8;;\     (ignored)

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-C\-C, --compare]8;;\
              compare content of source and destination files, and if no
              change to content, ownership, and permissions, do not
              modify the destination at all

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-d\-d, --directory]8;;\
              treat all arguments as directory names; create all
              components of the specified directories

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-D\-D]8;;\     create all leading components of DEST except the last, or
              all components of --target-directory, then copy SOURCE to
              DEST

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install--debug\--debug]8;;\
              explain how a file is copied.  Implies -v

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-g\-g, --group=GROUP]8;;\
              set group ownership, instead of process' current group

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-m\-m, --mode=MODE]8;;\
              set permission mode (as in chmod), instead of rwxr-xr-x

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-o\-o, --owner=OWNER]8;;\
              set ownership (super-user only)

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-p\-p, --preserve-timestamps]8;;\
              apply access/modification times of SOURCE files to
              corresponding destination files

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-s\-s, --strip]8;;\
              strip symbol tables

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install--strip-program\--strip-program=PROGRAM]8;;\
              program used to strip binaries

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-S\-S, --suffix=SUFFIX]8;;\
              override the usual backup suffix

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-t\-t, --target-directory=DIRECTORY]8;;\
              copy all SOURCE arguments into DIRECTORY

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-T\-T, --no-target-directory]8;;\
              treat DEST as a normal file

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-v\-v, --verbose]8;;\
              print the name of each created file or directory

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install--preserve-context\--preserve-context]8;;\
              preserve SELinux security context

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install-Z\-Z]8;;\     set SELinux security context of destination file and each
              created directory, to default type

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#install--context\--context[=CTX]]8;;\
              like -Z, or if CTX is specified then set the SELinux or
              SMACK security context to CTX

       ]8;;https://www.gnu.org/software/coreutils/install#install--help\--help]8;;\ display this help and exit

       ]8;;https://www.gnu.org/software/coreutils/install#install--version\--version]8;;\
              output version information and exit

       The backup suffix is '~', unless set with --suffix or
       SIMPLE_BACKUP_SUFFIX.  The version control method may be selected
       via the --backup option or through the VERSION_CONTROL environment
       variable.  Here are the values:

       none, off
              never make backups (even if --backup is given)

       numbered, t
              make numbered backups

       existing, nil
              numbered if numbered backups exist, simple otherwise

       simple, never
              always make simple backups

AUTHOR         top

       Written by David MacKenzie.

REPORTING BUGS         top

       Report bugs to: bug-coreutils@gnu.org
       GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
       General help using GNU software: <https://www.gnu.org/gethelp/>
       Report any translation bugs to
       <https://translationproject.org/team/>

COPYRIGHT         top

       Copyright © 2026 Free Software Foundation, Inc.  License GPLv3+:
       GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO         top

       cp(1)

       Full documentation
       <https://www.gnu.org/software/coreutils/install>
       or available locally via: info '(coreutils) install invocation'

COLOPHON         top

       This page is part of the coreutils (basic file, shell and text
       manipulation utilities) project.  Information about the project
       can be found at ⟨http://www.gnu.org/software/coreutils/⟩.  If you
       have a bug report for this manual page, see
       ⟨http://www.gnu.org/software/coreutils/⟩.  This page was obtained
       from the tarball coreutils-9.11.tar.xz fetched from
       ⟨http://ftp.gnu.org/gnu/coreutils/⟩ on 2026-05-24.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

GNU coreutils 9.11              April 2026                     INSTALL(1)

Pages that refer to this page: cp(1)