# apt-add-repository(1) - man - phpman > **TLDR:** This command is an alias of `add-apt-repository`. > - View documentation for the original command: `tldr add-apt-repository` *Source: tldr-pages* --- [add-apt-repository(1)](https://www.chedong.com/phpMan.php/man/add-apt-repository/1/markdown) General Commands Manual [add-apt-repository(1)](https://www.chedong.com/phpMan.php/man/add-apt-repository/1/markdown) ## NAME add-apt-repository - Adds a repository into the /etc/apt/sources.list or /etc/apt/sources.list.d or removes an existing one ## SYNOPSIS **add-apt-repository** _[OPTIONS]_ _[LINE]_ ## DESCRIPTION **add-apt-repository** is a script which adds an external APT repository to either /etc/apt/sources.list or a file in /etc/apt/sources.list.d/ or removes an already existing repository. ## OPTIONS Note that the **--list**, **--ppa**, **--cloud**, **--uri**, **--sourceslist**, and **LINE** parameters are mutually exclusive; only one (or none) of them may be specified. ### -h, --help Show help message and exit. ### -d, --debug Print debug information to the command line. ### -r, --remove Remove the specified repository. This first will disable (comment out) the matching line(s), and then any modified file(s) under sources.list.d/ will be removed if they contain only empty and commented lines. Note that this performs differently when used with the _--enable-source_ and/or _--compo__‐ _nent_ parameters. Without either of those parameters, this removes the specified repository, including any **deb-src** line(s), and all components. If _--enable-source_ is used, this disables **only** the 'deb-src' line(s). If _--component_ is used, this removes **only** the specified component(s), and only removes the repository if no components re‐ main. If both _--enable-source_ and _--component_ are used with _--remove_, the actions are per‐ formed separately: the specified component(s) will be removed from both **deb** and **deb-** **src** lines, and **deb-src** lines will be disabled. ### -y, --yes Assume yes to all queries. ### -n, --no-update After adding the repository, do not update the package cache. ### -l, --login Login to Launchpad (this is only needed for private PPAs). ### -s, --enable-source Allow downloading of the source packages from the repository. This adds and enables a 'deb-src' line for the repository. If this parameter is used without any repository, it will enable all currently exist‐ ing disabled source repository (_deb-src_) entries that have a corresponding enabled bi‐ nary repository (_deb_) entry. If this parameter is used twice without any repository, it will also add missing source repository entries for all existing binary repository (_deb_) entries. ### -c, --component Which component(s) should be used with the specified repository. If not specified, this will default to _main_. This may be used multiple times to spec‐ ify multiple components. If this is used without any repository, it will add the component(s) to all currently existing (enabled) repositories, but only if listed in the main sources.list file. ### -p, --pocket What pocket to use. Defaults to none, which is equivalent to the _release_ pocket. If this is used without any repository, it will add the pocket to all currently exist‐ ing repositories, but only if listed in the main sources.list file. It will use the components currently configured with the release pocket, or if that is not currently configured, it will use the _main_ and _restricted_ components. ### --dry-run Show what would be done, but don't make any changes. ### -L, --list List currently configured repositories. This will only list enabled repositories; it will not show disabled repository lines. By default, this shows only binary (_deb_) repositories. If _--enable-source_ is also used, this will also show source (_deb-src_) repositories. ### -P, --ppa Add an Ubuntu Launchpad Personal Package Archive. Must be in the format **ppa:USER/PPA**, **USER/PPA**, or **USER**. The **USER** parameter should be the Launchpad team or person that owns the PPA. The **PPA** parameter should be the name of the PPA; if not provided, it defaults to 'ppa'. The GPG public key of the PPA will also be downloaded and added to apt's keyring. To add a private PPA, you must also use the _--login_ parameter, and of course you must also be subscribed to the private PPA. ### -C, --cloud Add an Ubuntu Cloud Archive. Must be in the format **cloud-archive:CANAME**, **uca:CANAME**, or **CANAME**. The **CANAME** parameter should be the name of the Cloud Archive. The **CANAME** parameter may optionally be suffixed with the pocket, as either **-updates** or **-proposed**. If not specified, the pocket defaults to **-updates**. ### -U, --uri Add an archive, specified as a single URI. If the URI provided is detected to be a PPA, this will operate as if the _--ppa_ parame‐ ter was used. ### -S, --sourceslist Add an archive, specified as a full source entry line in one-line sources.list format. This must follow the _ONE-LINE-STYLE_ format as described in the **sources.list** manpage. If the URI provided is detected to be a PPA, this will operate as if the _--ppa_ parame‐ ter was used. ## LINE _LINE_ is a deprecated method to specify the repository to add/remove, provided only for back‐ wards compatibility. It can be specified in any of the supported formats: sources.list line, plain uri, ppa shortcut, or cloud-archive shortcut. It can also be specified as one or more valid component(s). The script will attempt to detect which format is provided. This is not recommended as the autodetection of which line format is intended can be ambigu‐ ous, but older scripts may still use this method of specifying the repository. One special case of _LINE_ is providing the value **-**, which will then read the _LINE_ from stdin. ## EXAMPLES add-apt-repository -P ppa:user/repository add-apt-repository -P user/repository add-apt-repository -C cloud-archive:queens add-apt-repository -C uca:queens add-apt-repository -C queens add-apt-repository -S 'deb stable main' add-apt-repository -S deb stable main add-apt-repository -U -c main add-apt-repository -U -c free -c non-free add-apt-repository -U add-apt-repository -s add-apt-repository -L add-apt-repository -s -r add-apt-repository -c universe add-apt-repository -r -c multiverse ## DEPRECATED EXAMPLES add-apt-repository deb stable main add-apt-repository main add-apt-repository free non-free add-apt-repository add-apt-repository multiverse ## SEE ALSO [**sources.list**(5)](https://www.chedong.com/phpMan.php/man/sources.list/5/markdown) [**apt-get**(8)](https://www.chedong.com/phpMan.php/man/apt-get/8/markdown) ## COPYRIGHT This manual page was written by Chow Loong Jin <> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses. [add-apt-repository(1)](https://www.chedong.com/phpMan.php/man/add-apt-repository/1/markdown)