2016-06-13 20:24:23 -04:00
---
layout: doc
title: How to Create a BlackArch VM
permalink: /doc/blackarch/
---
2016-06-17 12:19:35 -04:00
**General Remainder:**
- The installation scripts and provided tools may have bugs, be vulnerable to Man in the Middle (MitM) attacks or other vulnerabilities.
- Adding additional repositories or tools for installing software extends your trust to those tool provider.
Please keep in mind that using such a VM or VM's based on the template for security and privacy critical tasks is not recommended.
2016-06-13 20:24:23 -04:00
How to Create a BlackArch VM
============================
[BlackArch ](http://www.blackarch.org ) Linux is an [Arch Linux ](http://www.archlinux.org/ )-based distribution for penetration testers and security researchers. The repository contains [1434 ](http://www.blackarch.org/tools.html ) tools.
- List of [tools ](http://www.blackarch.org/tools.html )
- [Installation Instructions ](http://www.blackarch.org/downloads.html )
Create ArchLinux Based BlackArch Template
-----------------------------------------
0 - Create ArchlLinux Template
- Follow the [Archlinux Template instructions ](/doc/templates/archlinux/ )
1 - Update Template
~~~
sudo pacman -Syyu
~~~
2 - Clone template
1. Via Qubes VM Manager
2. Via command line
~~~
qvm-clone archlinux blackarch
~~~
3 - Install BlackArch repository
~~~
$ curl -O https://blackarch.org/strap.sh
# The SHA1 sum should match: 86eb4efb68918dbfdd1e22862a48fda20a8145ff
$ sha1sum strap.sh
# Set execute bit
$ chmod +x strap.sh
# Run strap.sh
$ sudo ./strap.sh
~~~
4 - Install tools
- install all tools
~~~
sudo pacman -S blackarch
~~~
- or by category:
~~~
# list available categories
pacman -Sg | grep blackarch
# install category
sudo pacman -S blackarch-< category >
# example
sudo pacman -S blackarch-forensic
~~~
- or specific tool
~~~
# Search for tool
pacman -Ss < tool-name >
# Install tool
sudo pacman -S < tool-name >
# Example
pacman -Ss burpsuite
sudo pacman -S burpsuite
~~~
5 - Create a AppVMs based on the `ptf` template
- (Optional) Attach necessary devices
Alternative Options to BlackArch
--------------------------------
- [Kali ](/doc/kali/ )
- [PenTester Framework (PTF) ](/doc/ptf/ )
