The Parrot Linux Architect Edition install is the leanest way to get Parrot OS onto a machine: a small network installer that downloads only what you choose, so you end up with exactly the desktop, tools and services you asked for and nothing else. This walkthrough takes you from the ISO download to a first working login, with the decisions explained at each step so you can shape the result to your own hardware and use case.
What the Architect Edition actually is
The other Parrot images (Home, Security, Hack The Box) are live ISOs. They boot a complete desktop from the USB stick and copy that desktop to your disk when you install. The Architect Edition works the other way round. It is a minimal Debian-style installer: it contains the installer, a base system and little else. Everything beyond that, from the desktop environment to the security tool collection, is pulled from the Parrot repositories over the network while you install.
That design has three practical consequences:
- You need a working internet connection for the whole installation. Wired Ethernet is the least fragile choice; Wi-Fi works when the installer has firmware for your chipset.
- Package versions are current on day one. Because the packages are fetched from the mirrors, a fresh Architect install already contains the latest updates and does not need a large upgrade right after the first boot.
- You decide what gets installed. A headless server, a bare window manager with a handful of tools, or a full Security Edition clone are all possible from the same ISO.
If you only want a quick desktop and do not care about trimming it down, the Home Edition live ISO is faster. If you want control, keep reading.
Before you start: hardware and media
Parrot 7.4 (released 3 October 2026) is built on Debian 13 with a Linux 7.1 kernel, and the Architect Edition follows the same base. Check the system requirements for the desktop you plan to pick: a minimal install without a desktop runs comfortably in a fraction of the RAM that KDE Plasma 6 wants.
Download the ISO from the Architect Edition download page and verify the checksum before you write it to a USB stick. The ISO verification guide covers both the SHA checksum and the GPG signature. Then write the image with a tool such as dd, Etcher or Ventoy; the USB drive guide walks through each option.
# Example on Linux: replace the ISO name with the file you downloaded
# and /dev/sdX with your USB device, NOT a hard disk
sudo dd if=Parrot-architect.iso of=/dev/sdX bs=4M status=progress conv=fsyncDouble-check the device name with lsblk first. dd does not ask for confirmation.
Step 1: Boot the installer
Boot from the USB stick (the system boot page lists the common firmware keys). The Architect menu offers a graphical installer and a text-mode installer. They ask identical questions; the text installer is useful on machines with troublesome graphics or very little memory. Pick either.
If you are testing in a virtual machine, give it at least 2 CPUs and enough RAM for the desktop you intend to install. The network installer is noticeably slower on a single-core VM because package unpacking competes with the download.
Step 2: Language, keyboard and network
The first screens set language, location and keyboard layout. Then the installer tries to configure the network. On a wired connection with DHCP this finishes on its own. On Wi-Fi you will be asked to select the network and enter the passphrase; if your adapter is not listed, the installer lacks firmware for it. The usual fix is to plug in an Ethernet cable for the installation and sort out Wi-Fi drivers after the first boot, or use a USB tethered phone.
Give the machine a hostname and, if you have one, a domain name. Both can be changed later with hostnamectl.
Step 3: User accounts
You are asked for a root password and then for a normal user. You can leave the root password empty: the installer then locks the root account and gives the first user sudo rights, which matches how the live editions behave. Choose a strong password for the user either way, because that account will be able to become root.
Step 4: Partitioning
This is the step that deserves the most attention. The installer offers:
- Guided, use entire disk: wipes the chosen disk and creates a root partition plus swap. Fine for a dedicated machine or VM.
- Guided, use entire disk and set up encrypted LVM: the same, but with full disk encryption. If this machine leaves the house, pick this one. The full disk encryption guide explains the passphrase and unlock process.
- Manual: for dual-boot setups or custom layouts (separate
/home, btrfs, existing partitions).
On UEFI machines make sure an EFI System Partition exists and is marked for use as such; on a fresh disk the guided options create it for you. If you are installing alongside another OS, shrink its partition from inside that OS first and then choose Manual, installing into the free space. The dual-boot guide covers the Windows case in detail.
Confirm the summary carefully. Once you accept “Write the changes to disks”, the formatting happens immediately.
Step 5: Choosing a mirror
The base system is installed next, then the installer asks which mirror to use for the rest of the packages. Pick the country closest to you, or the default Parrot mirror director, which redirects you to a nearby server automatically. If you later find downloads slow, you can change the mirror after installation without reinstalling. Enter proxy details only if your network requires them.
Step 6: Software selection, where the Architect Edition earns its name
After the mirror is set, you reach the software selection screen. This is the one screen that makes an Architect install different from the live ISOs. Instead of a fixed desktop, you get a list of checkboxes. Exactly which entries appear depends on the release, but the structure is consistent:
- A desktop environment: KDE Plasma (the default desktop since Parrot 7.0), MATE, LXQt or another option. Tick exactly one, or none for a headless system.
- An edition profile: the Home set (desktop, browser, office and privacy tools) or the Security set (the same plus the penetration-testing collection). The Security set is a large download; budget time accordingly.
- Standard system utilities: keep this ticked unless you know you want an extremely bare system. It brings in the familiar command-line tools.
- Services such as an SSH server, useful for a server or a machine you will manage remotely.
Some reliable combinations:
| Goal | Selection | Notes |
|---|---|---|
| Lightweight daily laptop | LXQt or MATE + Home profile | Low RAM use, full desktop |
| Pentest lab workstation | KDE Plasma + Security profile | Equivalent to the Security live ISO |
| Headless server or VPS-style box | Standard utilities + SSH server only | Add tools later with apt |
| Custom build | Standard utilities only | Install a window manager yourself afterwards |
You are not locked in. Anything you skip here can be added later with apt; the software management page lists the metapackages that correspond to the editions. Starting small and growing is usually the better habit than installing everything “just in case”.
Step 7: Bootloader and reboot
The installer then asks whether to install GRUB and on which device. On a single-OS machine, install it to the primary disk (for example /dev/sda or /dev/nvme0n1, not a partition). On UEFI systems it goes into the EFI partition automatically. If GRUB fails to detect another operating system you expected to see, finish the install and run sudo update-grub after booting; the GRUB troubleshooting page has the recovery steps if the machine does not boot at all.
Remove the USB stick when prompted and reboot.
First boot: what to do in the first ten minutes
Log in with the user you created. Even though the packages are fresh, confirm the system is fully current and that the Parrot tools know about any post-install hooks:
sudo parrot-upgradeparrot-upgrade is a wrapper around apt that handles the full upgrade in the order the distribution expects. If you prefer plain apt, sudo apt update && sudo apt full-upgrade does the same job for most purposes; the differences are explained in the update guide.
Then verify what you have:
cat /etc/os-release # Parrot version and Debian base
uname -r # running kernel
dpkg -l | grep -c '^ii' # number of installed packages
df -h / # disk usage after installA desktop-less Architect install will show a package count far below a live Security install, which is the whole point. If you want to see which metapackages are available to add tools in bulk:
apt search ^parrot- | lessFinally, if you did not enable a firewall during installation, set one up now. The firewall guide shows both nftables and ufw. If you installed the SSH server, disable password login and use keys before you expose the machine to any network you do not control.
Common problems during an Architect install
“No network interfaces detected” or Wi-Fi missing
The installer image carries a limited firmware set. Use Ethernet or USB tethering for the installation, then install the right firmware package afterwards. The supported Wi-Fi chipsets page tells you which package your card needs.
“Bad archive mirror” or failed package downloads
Go back one step and pick a different mirror. Transient mirror sync issues are the usual cause; a different country entry generally fixes it. A captive-portal network (hotel, campus) also triggers this because the installer cannot complete the login page.
Software selection seems to hang
The Security profile is a very large download followed by a long unpack. On a slow link this stage can run for a long time with little visible progress. Switch to the fourth virtual console (Ctrl+Alt+F4) to watch the log and confirm it is still working.
Black screen after the first reboot
Almost always a graphics driver issue, most common on NVIDIA hardware. Boot with the nomodeset kernel parameter once, then follow the black screen fix guide and the NVIDIA driver page.
Architect Edition compared with the live ISOs
| Architect | Home / Security live | |
|---|---|---|
| Download size | Small (installer only) | Large (complete desktop) |
| Internet needed to install | Yes, throughout | No |
| Try before installing | No | Yes, live session |
| Choice of desktop | During install | Fixed per ISO |
| Packages current after install | Yes | Needs an upgrade |
| Best for | Custom, minimal or server setups | Quick desktop installs, rescue use |
FAQ
Can I install the Architect Edition without internet?
No. The ISO contains only the base system; the desktop and tools come from the network. If you must install offline, use a live ISO instead.
Can I turn an Architect install into a full Security Edition later?
Yes. Install the Security metapackage with apt after the first boot. The result is functionally the same as installing the Security profile during setup, and you can do it one tool group at a time instead.
Is the Architect Edition the same as a Debian netinstall?
It uses the same installer family, but it points at the Parrot repositories, applies Parrot’s defaults and offers Parrot’s desktop and edition profiles. You get a Parrot OS system, not a plain Debian one. The What is Debian page explains how the two relate.