Kali Network Repositories (/etc/apt/sources.list)
The topic of repositories is always a large one, and comes up frequently. It is an item which people often get wrong and confused with. Please take the time to read the information below and any references which is linked to before acting on anything.
Default Network Repository Value
On a standard, clean install of Kali Linux, with network access, you should have the following entry present in
kali@kali:~$ grep -v '#' /etc/apt/sources.list | sort -u deb http://http.kali.org/kali kali-rolling main non-free contrib kali@kali:~$
If the output doesn’t exactly match up to the above output, you may not be able to install any new additional packages or receive updates. This may happen for any number of reasons, such as:
You will probably want to read the “switching branches” section to alter this.
Since Kali 2020.3, after Kali’s setup is complete, network repositories will be enabled by default, even if there was no network access during installation.
Switching Branches/Regular Repositories
Kali has various different branches to choose from (please take the time to read which one would be the best option for your setup), and you may be able to switch or include additional repositories.
kali-rolling (Default & frequently updated):
kali@kali:~$ echo "deb http://http.kali.org/kali kali-rolling main non-free contrib" | sudo tee /etc/apt/sources.list
kali-last-snapshot (Point release so more “stable” & the “safest”):
kali@kali:~$ echo "deb http://http.kali.org/kali kali-last-snapshot main non-free contrib" | sudo tee /etc/apt/sources.list
kali-experimental (Packages which are under testing - often used with the rolling repository):
kali@kali:~$ echo "deb http://http.kali.org/kali kali-experimental main non-free contrib" | sudo tee /etc/apt/sources.list.d/kali-experimental.list
deb http://http.kali.org/kali kali-rolling main non-free contrib <Archive> <Mirror> <Branch> <Component>
- Archive is going to be
deb(Regular Binary) or
deb-src(Source), depending if you want a package or the source of the package.
- Mirror should be
http.kali.org/kalias this is our load balancer, which will direct you to best mirror.
- Branch is what version of Kali you wish to use.
- Component is what packages you wish to use, based on the Debian Free Software Guidelines (DFSG). Kali defaults to everything.
Default Offline Install Values
During the Kali setup process, if you don’t have access to a network connection to reach a repository, you will perform an offline installation of Kali Linux. You will be limited to the packages & the version which is on the medium you installed Kali from. This will then configure Kali to continue to use this medium to install packages from, even after Kali has been installed.
This means you will not get any updates to packages, or any new additional tools, which can be frustrating. You can see if you the offline media enabled if your values match up with whats below (or if you want to enable this option):
kali@kali:~$ cat /etc/apt/sources.list # # deb cdrom:[Kali GNU/Linux 2020.1a _Kali-last-snapshot_ - Official amd64 DVD Binary-1 with firmware 20200213-14:56]/ kali-rolling main non-free #deb cdrom:[Kali GNU/Linux 2020.1a _Kali-last-snapshot_ - Official amd64 DVD Binary-1 with firmware 20200213-14:56]/ kali-rolling main non-free # This system was installed using small removable media # (e.g. netinst, live or single CD). The matching "deb cdrom" # entries were disabled at the end of the installation process. # For information about how to configure apt package sources, # see the sources.list(5) manual. kali@kali:~$ kali@kali:~$ sudo apt-cdrom add Using CD-ROM mount point /media/cdrom/ Identifying... [ea19ff4bedaa6c8f4662c0e8c58ed44c-2] Scanning disc for index files... Found 2 package indexes, 0 source indexes, 0 translation indexes and 0 signatures This disc is called: 'Kali GNU/Linux 2020.1a _Kali-last-snapshot_ - Official amd64 DVD Binary-1 with firmware 20200213-14:56' Reading Package Indexes... Done Writing new source list Source list entries for this disc are: deb cdrom:[Kali GNU/Linux 2020.1a _Kali-last-snapshot_ - Official amd64 DVD Binary-1 with firmware 20200213-14:56]/ kali-rolling main non-free Repeat this process for the rest of the CDs in your set. kali@kali:~$
If your output matches whats above, please see the switching branch section, if you wish to receive updates.
However, if you do have network connection, which has access to network repositories, it will be enabled for you. You don’t need to do anything.
If you want to install additional tools and software (such as signal) outside of what Kali has to offer, you may need to include an extra repository for this to happen. Please do not alter
/etc/apt/sources.list, as this is used for the Kali Linux Operating System. Any extra tools and software needs to be placed into their own file in the directory
/etc/apt/sources.list.d/ (such as
repo-name with the mirror name). It is highly recommended that each mirror should be in its own file.
By adding Kali’s repository to a non-Kali OS (such as trying to add Kali to Ubuntu), this will highly increase the chance of your system not working. It may not happen straight away, but without any warning, it may break. We will not be able to offer support (and based on what we have seen over the years, most other OS will not help too).
Likewise, adding other operating system’s repositories into Kali (such as trying to put Ubuntu on Kali), will break your installation. This is the single most common reason why Kali Linux systems break.
If any guides are telling you to do anything else than the above, this is unofficial advice, and completely not supported by Kali Linux. More often than not, users in this case end up doing a reinstall after learning this lesson.
We have a list of official Kali Linux mirrors, as well as a guide on how to setup your own. This may be kept as a local repository which is only accessible on a LAN, or a remote private one, or if you have the ability to, you may wish to share back to the community and make it public allowing for anyone else in your geographical area to benefit from it.
By using a
deb in the repositories, it will allow for binary packages to be downloaded. However, should you require the source to a package (so you can compile the package yourself if you so wish, or look into debugging a problem with a package), you can add
deb-src as a extra line in the repositories.
kali@kali:~$ echo "deb-src http://http.kali.org/kali kali-rolling main non-free contrib" | sudo tee -a /etc/apt/sources.list
kali-rolling for the branch above, but you can select any value you wish.
Updated on: 2021-Oct-23