BlackArch is a Linux pentesting distribution based on ArchLinux. If you're not familiar with ArchLinux, or Linux in general, we strongly suggest you avoid BlackArch due to the learning curve for new users.
You must first get an ISO on the downloads page and install it by following the instructions of the installation script. You can find a tutorial to show the process step by step at this URL BlackArch installation. If you encounter any problems and need help, the best place to ask is our Matrix channel.
BlackArch is constantly being updated and offers the latest packages available on Github. We release a new ISO four times a year (quarterly). These new images contain packages that are up to date, and usually include bug fixes. If you find any package that is outdated and wish to see it up to date, please report it as an issue on our Github repository Github.
By simply running pacman -Syu --needed --overwrite='*' blackarch. This command requires root privileges.
It could happen for a wide range of reasons. Below you will find a few suggestions.

  • You don't have an internet connection (as you can imagine, a rare problem and can be verified quickly).
  • You may have a DNS problem, that can't resolve accordingly. Please check your DNS settings ( works best with DNS Server).
  • You may have a network issue, different from the above one, which is hard for us to help since it can be a myriad of things. For example: DNS caching.
  • You may have a clock/time issue.
  • You may have something blocking your communication with server, for instance: a firewall.
  • If you're connected through a VPN, try to temporarily disable it and run again.
After testing all the items described above if you still have problems using, try the options below:

1st option:
# rm -rf /etc/pacman.d/gnupg
# pacman-key --init
# pacman-key --populate archlinux blackarch
# pacman-key --update --keyserver

2nd option:
You could try to change to's IP address using the following command:
# curl -O
# chmod +x
# sha1sum it should match with the information on downloads
# sh

3rd option:
You could try to temporarily switch to another mirror:
$ sudoedit /etc/pacman.d/blackarch-mirrorlist
It's very important to follow the suggestions above as well as checking the Archlinux Wiki pages to assist you as needed. If you still encounter any problems, pay us a visit at #BlackArch.
Depending on the problem you're facing, you can visit our Github and submit an issue on our Issue page, such as:
  • BlackArch Site repository: related to our website. For example: If a link is broken or an image isn't loading.
  • BlackArch repository: related to our packages. For example: a package hasn't been updated for a while or failed to run.
  • BlackArch Installer repository: related to our installer. For example: the installation failed or you can not boot after a successful installation.
You can also take some time to browse our other repositories.
If you still cannot find a solution to your problem, visit our Matrix channel and ask for help. But please be advised, BlackArch users are in different parts of the globe (different time zones). Therefore, be patient. Ask your question and wait for a reply.
BlackArch Linux is a huge project, we are adding new applications and features everyday.
If you would like to help us with anything, visit our Matrix channel. Just remember to wait for a reply, we are in different time zones.

BlackArch Linux 2013-2024