Skip to content

Installation

7h30th3r0n3 edited this page Nov 14, 2026 · 8 revisions

🛠 Installation

Which path do I follow?

  • M5Stack CardputerZero → use the App Store (one-tap) just below. No flashing, no terminal.
  • Raspberry Pi (Zero 2 W / 3B+ / 4B) → follow Part 1 onward for the manual install.

🏪 CardputerZero App Store (one-tap)

If you have a M5Stack CardputerZero, RaspyJack is published on the official CardputerZero App Store and installs in one tap. Nothing to flash, no SSH, no git.

  1. Power on the CardputerZero and connect it to Wi-Fi.
  2. Open the App Store from the launcher.
  3. Search for RaspyJack (or enter the share code RJAK), then tap Install.
  4. Wait for the install to finish, then launch RaspyJack from the apps list.

The store build ships the full toolkit and runs its own first-boot provisioning (extra packages, drivers) with an on-screen progress feed, so the first launch after install takes a few minutes before the menu appears. Updates are delivered through the store too: when a new version is published, the App Store offers the upgrade.

⚠️ RaspyJack runs once but no longer launches after a reboot?

This is a known CardputerZero issue, and it is a sudo-permission difference between factory images, not a bug in the app.

RaspyJack needs root, so the launcher starts it with sudo. Some CardputerZero factory images do not grant the first user passwordless sudo. At boot, sudo then asks for a password that nobody can type, the app exits immediately, and APPLaunch drops straight back to the menu (the screen may freeze for a couple of seconds first). It works right after install, or when you launch it once over SSH, because sudo is still authenticated from that session, but it does not survive a reboot.

How to tell it is this: over SSH, sudo -l returns nothing (no NOPASSWD), and the launcher journal shows sudo: a password is required right after launching run-raspyjack.sh.

Fix (run once over SSH, no reboot needed). Grant passwordless sudo to the device group RaspyJack runs as. %gpio covers the launching user whatever its name is (pi, or a custom one set in the imager / first-boot wizard):

echo '%gpio ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/010-raspyjack
sudo chmod 0440 /etc/sudoers.d/010-raspyjack
sudo visudo -c   # must report "parsed OK" for every file; if it errors, delete the file above before rebooting

Launch RaspyJack from the icon again: it now starts every time, including after a reboot. A permanent fix that removes this manual step is coming in a store update.

Prefer a manual install on CardputerZero?

The App Store is the easy path, but you can still install from scratch on the CardputerZero if you want (for example to run the latest git HEAD instead of the published release, or for development). The device already ships with Debian, so skip Part 1 (no OS flashing needed) and go straight to Part 2: Install RaspyJack. Open a terminal on the device or connect over SSH, then run the same git clone + install_raspyjack.sh steps as on a Raspberry Pi.

The App Store path is CardputerZero only. On a Raspberry Pi, use the manual install below.


🧱 Part 1: Setup OS (Raspberry Pi Imager)

These steps are copied from the original README, with the same images.

Install Raspberry Pi Imager


Select Raspberry Pi Zero 2 W


Go in Raspberry Pi OS (other)


Select Raspberry Pi OS Lite (32-bit)


Select your SD card


Change settings to configure user and enable SSH



Set username and password and enable SSH

You can now connect via SSH:

ssh raspyjack@<IP>

🛠 Part 2: Install RaspyJack

Run as root (RaspyJack expects /root/Raspyjack).

sudo apt install git
sudo su
cd /root
git clone https://github.com/7h30th3r0n3/raspyjack.git
mv raspyjack Raspyjack
cd Raspyjack
chmod +x install_raspyjack.sh
sudo ./install_raspyjack.sh
sudo reboot

The installer will ask which LCD screen you have:

  • 1) ST7735_128 — Waveshare 1.44" 128x128 (original)
  • 2) ST7789_240 — Waveshare 1.3" 240x240

You can change the screen type later from the LCD menu: Payload → Utilities → display_selector

Note: depending on how the repo is downloaded, the folder name can differ. Make sure the directory is /root/Raspyjack.


🔄 Update

⚠️ Back up your loot before updating.

sudo su
cd /root
rm -rf Raspyjack
git clone https://github.com/7h30th3r0n3/raspyjack.git
mv raspyjack Raspyjack
sudo reboot

📡 Part 3: WiFi Attack Setup (Optional)

WiFi attacks require a USB WiFi dongle (monitor mode).

  1. Plug in USB WiFi dongle (see hardware requirements).
  2. Run WiFi Manager from the RaspyJack menu.
  3. Configure WiFi profiles for auto-connect.
  4. Test interface switching between wlan0/wlan1.
  5. Run deauth attacks on target networks.

Quick test:

cd /root/Raspyjack/payloads
python3 fast_wifi_switcher.py

Clone this wiki locally