This tutorial uses VirtualBox, but you can also use other software if you prefer to virtualize.
We assume you have already burned the iso onto a USB or DVD and you are ready for the installation. When you boot to the image it should display something similar to the following screen. Select your architecture and press enter. [Example: Blackarch (x86_64) for 64bit]
If you want to install BlackArch using VirtualBox, make sure to choose the right ISO. Check if your hardware supports virtualization. If so enable it in your UEFI/BIOS settings. If not, you must use the 32 bit ISO. Qemu with KVM was successfully tested and can be used instead of VirtualBox
Wait until the login prompt appears, requesting the
login. The default BlackArch credentials are
Login: root Password: blackarch
To start the installation, you must execute the Blackarch install script. In order to avoid any problems that can cause you to restart the installation, make sure to have internet available on the machine where you want to install Blackarch. You can list the available network interfaces with the command
ip a. If you want or only have wifi available as an option, you may read the arch wiki to know how to setup a wireless connection.(ie: wifi-menu/netctl) If your keyboard differs from the default one,
qwerty us, you can set the keymap corresponding to your language/country. For example, enter the command
loadkeys following the 2 letters of your country code. Execute the command
blackarch-install to start the Blackarch install script.
Throughout this tutorial, you may want to execute some shell commands while the script is running. You can do it at any time without the need to stop it by simply switching
tty's by pressing these keys simultaneously
ctrl + alt + f2 (f1 is the default tty where you ran the
blackarch-install script (if you did not execute it in another tty…), f2, f3, f4, f5 or f6 will bring a new tty where you can execute any command you may need. This is just a tip in case you didn’t know)
3 options should now be displayed:
You now have to select the
keymap you want. If you have a qwerty based keyboard, you can stick with the
us keycode, however, this may be not always be the case. If you are unsure, you may
List available keymaps on Blackarch by selecting 2. Most of the time, the english country code is used. For a french azerty, the keymap will be
fr, for a spanish
es etc… If you know the keymap, set
You have to write the keymap as explained above
The hostname is basically the name you want to give to your computer on your local network. It will resolve as the name given. You may choose whatever you like and this can be changed at any time by editing the
A list of the available network interfaces will be displayed. As explained earlier, you should select your ethernet interface if possible, the script doesn’t provide any support for wifi. It’s still possible to use wifi, but you will have to set it up by yourself.
In some cases involving, a virtual environment such as VirtualBox or Qemu, some rules in your firewall may drop ICMP, which will deny the
ping and will block the install at this step since the script will exit, thinking your network interface is misconfigured. You can solve by this problem by editing the script located in
/usr/bin/blackarch-install</span>` at the line 545 witch start as
if ! ping -c 1 github.com > /dev/null 2>&1
until the next fi (line 548), you have to comment each line of the block condition or remove it. Once the edit made and save, run the
blackarch-install and repeat the install.
Pacman will now update each repo, download and install some basic system packages needed for the next step of the Blackarch install. If you have a slow download speed, this can take some time. Go grab a coffee!
Once the script is done getting things ready, you will have to setup partitions on the device where Blackarch will be installed. You will have to choose between having 2 or 3 partitions
* The swap partition is optional and can be avoided on a virtual machine. It’s still recommended to make a small one to avoid any crash due to a potential problem with your ram.
In case more than 2 devices get listed and you are not sure which is the right one you want to install to, you can use
fdisk to display the size of the target device, for exemple, if you have sda listed and want to know the size of it and optionally, the filesystem if any, enter
fdisk -l -o device,size /dev/sda
y when the script asks you if you want to create your partition with
n will stop the install.
If your storage device already has a label type, you won’t see this, otherwise set it to
You now have to setup the partitions. The example given is a basic one and should work in most cases. You will need to create at least 2 partitions (boot and root) but we will use 3 in this example including the swap partition. Let’s start with the first one, boot.
Using the arrow, go to
New, push enter and write
500M, This is enough space for most users since you won’t have more than 3 different kernels at the same time.
primary and press enter.
You need to mark this partition as bootable. Go to the option
bootable and press enter. The * should appear as on the screen, afterwards go to the second partition, press the down arrow to select the free space then select
This will be our swap partition. Press enter and write
512M. Press enter again and select
For this partition you need a different type. Using the arrow, go to
Type and press enter. A list will be displayed. Select
Linux swap, solaris and press enter. Let’s go for the last partition. Same process, as we did earlier, select the free space in green, go to
New and press enter. This time you don’t need to write anything. We want to take all the free space available. Simply press enter twice.
Before you quit
cfdisk you must save this partition table. Go to
Write and press enter. It will ask you to confirm your changes. Write
yes and press enter and you may now quit.
You have the choice to fully encrypt your root partition with
LUKS. It’s recommended to set
y as your data may be sensitive and you want to keep it private from anyone (in case your computer gets stolen or is taken by some agency…). Do not make something too easy as it can be bruteforced. Be aware that if you forget the password to unlock your
LUKS partition, the data nor the password can be recovered, a good move would be to write down the password on a piece of paper, and hide it somewhere safe. This can save you from trouble in case you can’t remember it.
If you have an SSD, if you encrypt the data with luks it will drastically reduce the lifetime of the SSD. Encrypting the stored data requires a lot of disk writing (uncrypt as well), you can fix this problem by adding
root_trim=yes as option in your bootloader.
For grub, look for the line of the current used kernel, similar of the following:
linux /vmlinuz ... root=/dev/mapper/ ... root_trim=yes (add it at the end of the line)
The filesystem for each of those partitions must be defined. Ext4 is the default choice since it’s the most recent. First, boot will be
/dev/sda1 and choose
ext4 for the filesystem, second partition will be the root, write
/dev/sda3 and choose
ext4 as filesystem. The last one will be the swap, write
/dev/sda2 or just push enter if you haven’t created one.
(If you choose to use LUKS) The script will ask you 3 times to confirm. The last one must be confirmed with
YES (capital letters required).
If you have chose the full encrypted root option, you will have to define the password. A prompt asking for it at each boot will be displayed soon after the bootloader.
When you confirm the password, the root partition will immediately be encrypted. After it fully encrypts the partition the install script needs to mount the device, enter your password again to unclock the root partition so the install script can mount it and complete the installation.
Now the script will download the latest necessary packages for your system. This will take a little time depending on your internet speed. When the install is finished with this task, you will be asked to set the password of your root account.
Next, you need to create a normal account, using the root as the only user of your system is wrong and you should never do it.
When the script asks you to choose a mirror, (press enter for the default) You can change this later.
From now on, the last 3 steps before the end are optional.
The script will now ask you if you want a X display (graphical environment, a desktop), before you type
y and press enter, make sure nobody is looking at your screen, this is very important.
You will have the choice to download the VirtualBox guest additions/packages, if you are not interested, press
n and hit enter. If you want the Blackarch packages, saying
y will download and install more than 1500 packages from the Blackarch repo, you can fetch those later if you want. This is an option that can be skipped.
If you ever wonder what the meaning of that is. It’s just a “Joke” made by a developer. In other words, this means that its the end of the installation. You can now reboot and access your new Blackarch system.
If you chose the fully encrypted root option, it will prompt you for your partition’s LUKS password on each boot.
Enjoy Blackarch, and remember the developers/contributors of BlackArch are volunteers. All the work provided is free and was done in their free time. You can help us by making a donation which will be used for this project only.