blackarch

# Table of Contents
- [Description](#description)
- [Overview](#overview)
- [Download and Installation](#download-and-installation)
- [Key Features](#key-features)
- [Installation Instruction](#installation-instruction)
- [Usage](#usage)
- [Get Involved](#get-involved)
- [Contributing](#contributing)
- [Contact](#contact)
- [License](#license)
- [Disclaimer](#disclaimer)
- [Conclusion](#conclusion)

---

# Description
**BlackArch Linux** is an Arch Linux–based penetration testing distribution for
penetration testers and security researchers. The repository contains [2865
tools](https://www.blackarch.org/tools.html). You can install tools individually
or in groups. BlackArch Linux is compatible with existing Arch installations.
For more information, see the installation instructions.

---

# Overview
To report bugs and request new tools, visit the issue tracker on
[GitHub](https://github.com/BlackArch/blackarch/issues), stop by
[Matrix](https://matrix.to/#/#BlackArch:matrix.org), or [email
us](mailto:team@blackarch.org).

**BlackArch Linux** is specifically designed for **penetration testers** and
**security researchers**. The repository contains over **2,800 tools**,
organized by category, allowing users to install them individually or in
**groups**.

**BlackArch** is fully compatible with existing Arch Linux installations, making
it a versatile choice for those who want to enhance their existing systems with
security tools.

---

# Download and Installation
Whether you're a cybersecurity professional, enthusiast, or researcher,
**BlackArch** offers the tools you need for a variety of tasks, such as
**penetration testing**, **forensics**, **reverse engineering**, **network
analysis**, and more.

BlackArch Linux only takes a moment to set up.

---

# Key Features
- **Over 2,800 Tools** – categorized for different testing scenarios
- **Arch Linux–based** – benefits from Arch’s rolling release updates
- **Compatibility** – integrates seamlessly with existing Arch setups
- **Customizable Installation** – Full, Slim, or Repo-based options
- **Live ISO** – test BlackArch without installing it

---

# Installation Instruction
Setting up **BlackArch Linux** is quick and easy. There are three primary
installation methods depending on your preference.

To start developing for BlackArch, refer to the [Developer
Guide](./docs/HOWTO-DEV.md).

## 1. Install on an Existing Arch Machine
If you're running **Arch Linux**, you can install **BlackArch tools** directly
onto your system using the BlackArch repository.

**Website:** https://www.blackarch.org/

```bash
# Sync the BlackArch repository
curl -s https://blackarch.org/strap.sh | sudo bash

# Install all BlackArch tools or specific ones
sudo pacman -S blackarch
```
## 2. Live ISO Installation

The Live ISO allows you to try BlackArch without installation.

Download the Live ISO from the official website and boot from it to start
penetration testing immediately.

## 3. Full, Netinstall, or Slim ISOs

Full ISO