Install RANZER on Linux

Step 1 - Choose your version

Which processor does your machine have?

Not sure? Most laptops and PCs use amd64. Raspberry Pi and Apple Silicon VMs use arm64.

Coming Soon

Linux amd64

For Intel and AMD processors - desktops, laptops, and most cloud VMs.

Ubuntu 20.04+ / Debian 11+ / Kali 2022+ Coming Soon

Available Now

Linux arm64

For ARM processors - Raspberry Pi 4/5, Apple Silicon Linux VMs, AWS Graviton.

Ubuntu 22.04+ / Debian 12+ / Raspberry Pi OS Download arm64 .deb

To check your architecture: open a terminal and run uname -m - x86_64 means amd64, aarch64 means arm64.

Installation Guide

Follow these steps carefully

Takes about 1 minute. The most common mistake is double-clicking the .deb - it won't install on most distros. Use the terminal command in Step 2.

Download the .deb file

Click the download button above to save ranzer_1.0_arm64.deb to your Downloads folder. The package is fully self-contained - no Python installation required.

Install with one terminal command

Open a terminal, and run:

cd ~/Downloads
sudo dpkg -i ranzer_1.0_arm64.deb

Enter your password when prompted. If you see dependency errors, run this to fix them automatically:

sudo apt-get install -f

Why not just double-click? On some distros (Kali, minimal Ubuntu) double-clicking a .deb opens the Archive Manager instead of an installer - it just shows the internal files. The terminal command above works reliably on every apt-based distro.

Launch RANZER

After installation, RANZER is available from your Applications menu under System or Security. You can also launch it directly from a terminal:

# Open the graphical interface
ranzer gui

# Or check available commands
ranzer --help

Optional - enable double-click installs

If you want future .deb downloads to open a proper install GUI when double-clicked, install GDebi:

sudo apt install gdebi

After that, double-clicking any .deb file will open a one-click install window.

Compatible distributions

Tested and working on the following. Any apt-based distro should work.

Ubuntu 20.04+

Ubuntu 22.04 LTS

Ubuntu 24.04 LTS

Kali Linux 2022+

Debian 11 Bullseye

Debian 12 Bookworm

Linux Mint 21+

Pop!_OS 22.04

Raspberry Pi OS

Uninstalling RANZER

sudo apt remove ranzer

Use sudo apt purge ranzer to also remove any remaining configuration files.

Troubleshooting

Dependency errors during install - Run sudo apt-get install -f after the failed install to auto-resolve missing dependencies.

'ranzer' not found after install - Run hash -r or open a new terminal to refresh your shell's command cache.

GUI doesn't open - Ensure you have a desktop environment running. On headless servers, RANZER's GUI requires a display. Use CLI mode instead: ranzer monitor --dir ~/Documents.

Double-click opens Archive Manager - This is normal on some distros. Use sudo dpkg -i ranzer_1.0_arm64.deb in the terminal, or install GDebi (Step 4 above).