Setting up as an Unofficial User Repository

BlackArch is compatible with normal Arch installations. It acts as an unofficial user repository. If you want an ISO instead, see the ISO section.
If you wish to install BlackArch on an ARM device, see the ARM section.

1.Run as root. Example:

curl -s | sudo sh

2. Append the following lines to your /etc/pacman.conf file:


Server = <mirror_site>/$repo/os/$arch

Replace <mirror_site> with a mirror site of your choosing. Please use one of our official mirrors. See Mirror Sites.

3. Now run:

# pacman -Syyu

Installing Packages

You may now install tools from the blackarch repository.

To list all of the available tools, run

# pacman -Sgg | grep blackarch | cut -d' ' -f2 | sort -u

To install all of the tools, run

# pacman -S blackarch

To install a category of tools, run

# pacman -S blackarch-<category>

To see the blackarch categories, run

# pacman -Sg | grep blackarch

Installing packages from source (PKGBUILD)

As part of an alternative method of installation, you can build the blackarch packages from source. You can find the PKGBUILDs on github.

To build the entire repo, you can use the blackman tool.
First, you must install blackman. If the BlackArch package repository is setup on your machine (see above), you can install blackman like so:

pacman -S blackman

You can build and install blackman from source like so:

mkdir blackman

cd blackman


# Make sure the PKGBUILD has not been maliciously tampered with.

makepkg -si

You use blackman like so:
Download, compile and install packages:

# blackman -i package

Download, compile and install whole category:

# blackman -g group

Download, compile and install all of the BlackArch tools:

# blackman -a

To see the blackarch categories:

$ blackman -l

To see category tools:

$ blackman -p category


BlackArch is compatible with ArchLinuxARM, meaning it effectively supports all of the platforms listed here.

In order to install BlackArch on an ARM platform, follow the install instructions for your device on and install BlackArch as an unofficial user repository. Soon we will release adaptations of the ArchLinuxARM images with BlackArch packages pre-installed.


The following list contains official BlackArch live-ISO and netinstall-ISO images. The images can be burned to a DVD, mounted as an ISO file, or be directly written to a USB stick using a utility like `dd`.

Do not use UNetBootIn to write the ISO file to a disk. UNetBootIn modifies the bootloader configuration, which is bad. You can use this instead (where /dev/sdX is your flashdrive):

# dd bs=512M if=file.iso of=/dev/sdX


# dd bs=512M if=file.iso of=/dev/sde

====== Default username/password for all ISOs: root:blackarch ======

blackarchlinux-live-2014.04.21-x86_64.iso - SHA1: a78ed45f6bac28a5242aaa74e85a963f9dabd35f - Size: 2.5 GB
blackarchlinux-live-2014.04.21-i686.iso - SHA1: ed535702d1a929ac8d886ceae7e37dcf1898b88d - Size: 2.9 GB

blackarchlinux-netinst-2014.04.21-x86_64.iso - SHA1: 42ed6c8914cdeb24d17abf00b68a3c7b5620545e - Size: 345 MB
blackarchlinux-netinst-2014.04.21-i686.iso - SHA1: 1205c7a3d1823732743225ad4e9e9181647db277 - Size: 305 MB

Installing BlackArch Linux using Live-ISO, Netinstall-ISO or ArchLinux

Install blackarch-install-scripts package:

# pacman -S blackarch-install-scripts


# blackarch-install

Mirror Sites

The following list contains official BlackArch Linux mirror sites.