BlackArch Install script

readme.md

abstract	date
shamefully stolen from the actual BlackArch docs	2025-12-16

Which docs may be found on the actual BlackArch docs website

Installing on top of ArchLinux

BlackArch Linux is compatible with existing/normal Arch installations. It acts as an unofficial user repository. Below you will find instructions on how to install BlackArch in this manner.

# Run https://blackarch.org/strap.sh as root and follow the instructions.
curl -O https://blackarch.org/strap.sh

# Verify the SHA1 sum
echo e26445d34490cc06bd14b51f9924debf569e0ecb strap.sh | sha1sum -c

# Set execute bit
chmod +x strap.sh

# Run strap.sh
sudo ./strap.sh

# Enable multilib following https://wiki.archlinux.org/index.php/Official_repositories#Enabling_multilib and run:
sudo pacman -Syu

Usage

You may now install tools from the blackarch repository.

# To list all of the available tools, run
sudo pacman -Sgg | grep blackarch | cut -d' ' -f2 | sort -u

# To install a category of tools, run
sudo pacman -S blackarch-<category>

# To see the blackarch categories, run
sudo pacman -Sg | grep blackarch

# To search for a specific package, run
pacman -Ss <package_name>

# Note - it maybe be necessary to overwrite certain packages when installing blackarch tools. If
# you experience "failed to commit transaction" errors, use the --needed and --overwrite switches
# For example:
sudo pacman -Syyu --needed --overwrite='*' <wanted-package> 

The complete tool list of the BlackArch Linux repository can be found in the complete list of all BlackArch packages.

blackarch-install.sh

#!/bin/bash

curl -O https://blackarch.org/strap.sh
echo e26445d34490cc06bd14b51f9924debf569e0ecb strap.sh | sha1sum -c
chmod +x strap.sh
sudo ./strap.sh
sudo pacman -Syu