Parrot Linux on Raspberry Pi 5: Flash and First Boot Guide

Running Parrot Linux on a Raspberry Pi 5 gives you a small, quiet, low-power box that boots into the same Debian-based environment you get on a laptop, with the same package tools and most of the same security tooling. This guide walks you through the whole process: picking the right Raspberry Pi image, flashing it to a microSD card or USB SSD, booting for the first time, and the handful of fixes that make the install actually comfortable to use. It is written for the Pi 5, but the steps are the same for a Pi 4 if that is what you have on the desk.

What you need before you start

A Raspberry Pi 5 (any RAM size works; 4 GB or more is nicer for a desktop session) with its official 27 W USB-C power supply or an equivalent that can deliver 5 V at 5 A.
A microSD card of at least 32 GB, A2-rated if you can get one, or a USB 3 SSD if you want a faster root filesystem.
Another computer (Linux, Windows or macOS) to download and flash the image.
A micro-HDMI cable, keyboard and mouse for the first boot. You can go headless later, but the first login is far easier with a screen.
Wired Ethernet if possible. Wi-Fi works, but a cable removes one variable while you are still setting things up.

Check the system requirements page as well; the Pi builds are lighter than the x86 ISOs, but the numbers there give you a sense of what a comfortable desktop session needs.

Choosing the right Parrot Linux Raspberry Pi 5 image

Parrot Linux ships dedicated ARM images for the Raspberry Pi rather than a generic ISO, because the Pi does not boot like a PC. There is no BIOS or UEFI firmware to hand off to an installer; the board reads its boot files straight from the first partition of the card. That is why you flash a ready-made disk image instead of running the Debian installer you may know from a laptop install.

The images are listed on the Raspberry Pi images page. As of the 7.x series you will normally see a Home edition build, aimed at everyday desktop use, and a Security edition build that adds the pentesting tool set. Both are 64-bit. Before you download, read the notes beside each image for two things: which Pi models the build has been tested on, and what the default login is. Those details change between releases, so trust the download page over any blog post, including this one.

If you are not sure which edition fits, the edition comparison on this site explains the differences. On a Pi, the honest advice is to start with Home: it boots into a usable desktop faster, uses less of the card, and you can install any individual security tool with apt later on.

The download is an .img.xz file, a compressed raw disk image. You do not need to decompress it by hand; the flashing tools below handle that for you. Do verify the checksum, though. The download page shows the hash, and on Linux or macOS you can compare it with:

sha256sum Parrot-home-*.img.xz

If the printed hash does not match the one on the download page, delete the file and download it again. A corrupt image is the most common reason for a Pi that shows a rainbow screen and nothing else.

Flashing the image to a microSD card or SSD

You have two good options. Raspberry Pi Imager is the easiest for most people and runs on every desktop OS; dd is fine if you prefer the terminal and already have the card device name.

Option A: Raspberry Pi Imager

Install Raspberry Pi Imager from the Raspberry Pi website or, on a Debian-based system, with sudo apt install rpi-imager.
Open it, pick your Pi model, then under Operating System scroll to the bottom and choose Use custom. Select the .img.xz file you downloaded. The tool decompresses it on the fly.
Choose the microSD card or USB SSD as the storage target. Double-check the size; it is easy to pick an external backup drive by mistake.
When Imager offers OS customisation, skip it. Those presets are written for Raspberry Pi OS and can leave a Parrot image in a half-configured state. You will set the hostname, user and Wi-Fi from inside Parrot instead.
Write, wait for the verify pass to finish, and eject the card.

Option B: dd from a Linux terminal

Plug the card in and find its device name first. Never guess this step.

lsblk -o NAME,SIZE,MODEL,MOUNTPOINT

Look for a device whose size matches your card, for example /dev/sdb or /dev/mmcblk0. If any of its partitions are mounted, unmount them, then write the image:

sudo umount /dev/sdb* 2>/dev/null
xzcat Parrot-home-*.img.xz | sudo dd of=/dev/sdb bs=4M status=progress conv=fsync
sync

Replace /dev/sdb with your actual device. Writing to the wrong one wipes it without asking. When the command returns and sync finishes, pull the card.

If you would rather boot from a USB SSD, flash it exactly the same way. The Pi 5 firmware looks at USB drives when no bootable microSD is present, so you do not need any special configuration for that to work. The practical gain is noticeable: package installs and browser start-up are much snappier from an SSD than from even a good microSD card.

First boot on the Raspberry Pi 5

Insert the card, connect the screen, keyboard and Ethernet, then plug in the power last. The first boot takes longer than later ones because the image resizes its root partition to fill the card and generates fresh SSH host keys. Give it a couple of minutes before you decide something is wrong.

You should land on a login screen. Use the default credentials listed on the download page. The very first thing to do once you are in is change that password, because every copy of the image shares the same default:

passwd

Then confirm that the root filesystem actually grew to use the whole card. If the size shown is still a few gigabytes, the automatic resize did not run and you can do it by hand:

df -h /
# only if / is still tiny:
sudo growpart /dev/mmcblk0 2
sudo resize2fs /dev/mmcblk0p2

Adjust the device name if you booted from USB (it will be something like /dev/sda and /dev/sda2).

Update the system

The image on the download page is a snapshot taken at release time, so there will be updates waiting. Parrot Linux provides its own wrapper for the full upgrade that handles the distribution’s package pinning correctly:

sudo parrot-upgrade

If you prefer plain apt, the equivalent is sudo apt update && sudo apt full-upgrade. On a first upgrade this can take a while on a microSD card. Reboot afterwards so the new kernel and firmware are in use. The software management page explains the difference between the two commands in more detail.

Set locale, keyboard and time zone

Pi images usually default to a US keyboard and UTC. Fix all three with the standard Debian tools:

sudo dpkg-reconfigure locales
sudo dpkg-reconfigure keyboard-configuration
sudo timedatectl set-timezone Asia/Dhaka

Replace the time zone with your own; timedatectl list-timezones prints the valid names. Because the Pi has no battery-backed clock, it relies on NTP after each boot, so a working network connection also keeps the time right.

Connect to Wi-Fi

If you are using the desktop, the network applet in the panel works as expected. From a terminal or over SSH, NetworkManager’s command-line tool is the quickest route:

nmcli device wifi list
nmcli device wifi connect "YourNetworkName" password "YourPassphrase"

The connection is saved and comes back after a reboot.

Enable SSH for headless use

Once you have a password you chose yourself, turning on SSH lets you unplug the monitor and manage the Pi from your main machine:

sudo systemctl enable --now ssh
hostname -I

The second command prints the Pi’s IP address so you know where to connect. For anything beyond a home lab, switch to key-based login and disable password authentication in /etc/ssh/sshd_config.

Making the Pi install comfortable

A few optional tweaks turn a working install into one you will actually enjoy using.

Lighter desktop. If the default session feels heavy on a Pi with 4 GB, install a lighter environment such as LXQt or MATE from the repositories and pick it at the login screen. The desktop environments page lists what is available.
Swap. The image may ship without swap. On a 4 GB board a modest zram swap keeps a browser with many tabs from stalling: sudo apt install zram-tools and reboot.
Cooling. The Pi 5 throttles when it gets hot, and a long apt upgrade is enough to warm it. The official active cooler or any heatsink-and-fan case is worth the small cost. You can watch the temperature with vcgencmd measure_temp if that utility is present, or cat /sys/class/thermal/thermal_zone0/temp on any kernel.
Card lifespan. Heavy logging wears microSD cards. Moving /var/log to RAM with log2ram or simply booting from an SSD both help.

Common problems on first boot

Symptom	Likely cause	What to try
No HDMI output, green LED blinks in a pattern	Corrupt or incomplete image on the card	Re-verify the checksum and flash again; try a different card
Boots, then reboots in a loop	Power supply cannot hold 5 V under load	Use the official 27 W supply; unplug USB devices while testing
Wi-Fi adapter missing	Firmware package not yet installed on an older image	Connect by Ethernet, run `parrot-upgrade`, reboot
Desktop very slow	Slow microSD card or full RAM	Switch to an A2 card or USB SSD; use a lighter desktop
Wrong characters when typing	Keyboard layout still US	`sudo dpkg-reconfigure keyboard-configuration`

For deeper hardware issues, the Raspberry Pi and other builds page and the general troubleshooting section cover kernel, GRUB and driver problems that are not specific to the Pi.

FAQ

Does the Parrot Linux Raspberry Pi 5 image include all the security tools?

The Security edition build does; the Home build does not. Either way, anything missing can be installed later with apt, since both editions share the same repositories. Some tools that depend on x86-only binaries or on GPU acceleration will not be available on the Pi’s ARM processor.

Can I install Parrot Linux on the Pi from the regular ISO instead?

No. The x86 ISO will not boot on a Raspberry Pi at all. Use the ARM image from the Raspberry Pi images page and flash it as described above. The same goes for the Architect edition, which is an x86 network installer.

Is a Raspberry Pi 5 fast enough for Parrot Linux as a daily desktop?

For browsing, terminal work, scripting and running the lighter security tools, yes, especially from an SSD with a lighter desktop. For heavy virtualisation, password cracking or anything that leans on a discrete GPU, a laptop or desktop running the standard build is the better fit. If you want to compare it with a virtual machine on your main computer first, the VirtualBox guide gets you there in a few minutes.