WiFi Pineapple Mark VII
  • WiFi Pineapple Mark VII
  • Setup
    • Connecting the WiFi Pineapple
    • Setting up your WiFi Pineapple
    • Connecting to the WiFi Pineapple on Linux
    • Connecting to the WiFi Pineapple on Windows
    • Setting up the WiFi Pineapple over WiFi
    • Setup by USB Disk
  • UI Overview
    • Introduction to the UI
    • Dashboard
    • Campaigns
    • PineAP
    • Recon
    • Handshakes
    • Modules
    • Settings
    • Cloud C²
  • Developer Documentation
    • Developer Resources
    • Contributing to the Module Repository
  • WiFi Basics
    • Introduction to WiFi
    • Radios and Chipsets
    • Stations and APs
    • Transmit Power
    • Antennas
    • Channels and Regions
    • Protocols
    • Modes of Operation
    • Logical Configurations
    • MAC Addresses
    • Broadcast and Multicast MAC Addresses
    • SSIDs
    • 802.11 Frame Types
    • 802.11 Frame Structure
    • Management Frames
    • Frame Injection
    • Association and State
  • FAQ / Troubleshooting
    • MacOS Support
    • Establishing an Internet Connection
      • Configuring a Client Mode Connection
      • ICS on Linux
      • Configuring ICS on Windows
      • Configuring a USB Ethernet Adapter
    • Password Reset
    • Factory Reset and Recovery
    • WiFi Pineapple Updates
    • WiFi Pineapple Beta Updates
    • Compatible 802.11ac Adapters
  • Extras
    • MK7 LED Mod Installation
    • MK7 Kismet Case Installation
Powered by GitBook
On this page
  • WiFi Pineapple Enterprise
  • WiFi Pineapple Mark VII
  • Preparing the USB drive
  • Format the drive
  • Download the firmware
  • Create the config.txt
  • Add the Cloud C2 provisioning file (optional)
  • Power on the WiFi Pineapple with the USB Drive

Was this helpful?

  1. Setup

Setup by USB Disk

Last updated 2 years ago

Was this helpful?

The WiFi Pineapple may be provisioned "headless" — meaning without intervention interactively. This means that you can take a fresh WiFi Pineapple (either Mark VII or Enterprise) out of its box and set it up with the latest firmware and your settings of choice without connecting it to a computer or smartphone.

WiFi Pineapple Enterprise

For USB Setup on the WiFi Pineapple Enterprise, please see this article:

WiFi Pineapple Mark VII

For USB Setup on the WiFi Pineapple Mark VII, please continue below:

Preparing the USB drive

Once prepared, the USB drive will be properly formatted and contain a config.txt file, an upgrade-x.x.x.bin file, and optionally a device.config file (if using with Cloud C2).

Format the drive

The USB drive must contain only a single partition and be formatted as one of the following:

  • ext4

  • exFAT / FAT

  • NTFS

Download the firmware

Make sure you keep the original name of the file (upgrade-x.x.x.bin).

Create the config.txt

On the root of the USB flash disk, create a config.txt file using a standard text editor such as Notepad (Windows), textEdit (Mac), or vim/nano (Linux) containing the below information. Make sure the txt file is saved in ASCII format. Modify the settings as per your desired configuration.

# This file automatically configures the WiFi Pineapple.
# To enroll your WiFi Pineapple automatically, edit the below variables.
# Save as config.txt on the root of an ext4/exFAT/FAT/NTFS USB flash drive.
# Connect to the WiFi Pineapple USB host port before applying power for the
# first time. During firmware installation, the LED will flash Red/Blue.
# DO NOT DISCONNECT POWER DURING FIRMWARE INSTALLATION!
# For more information, visit https://docs.hak5.org
#
# General System Configuration
#
ROOT_PASSWORD="hak5pineapple"
HOSTNAME="pineapple"
TIMEZONE="utc"
#
# Wireless AP Configuration
#
MANAGEMENT_SSID="Pineapple_Management"
MANAGEMENT_PSK="AGoodWPA-PSKPassphrase"
MANAGEMENT_HIDDEN=1
MANAGEMENT_DISABELD=0
OPEN_SSID="Open"
OPEN_HIDDEN=0
COUNTRY_CODE=US
#
# Filters Configuration
#
CLIENT_FILTER="ALLOW"
SSID_FILTER="ALLOW"
#
# Hak5 Cloud C2 Configuration
#
ENABLE_C2=1
#
# Software License Agreement: 
# https://hak5.org/pages/software-license-agreement
#
ACCEPT_LICENSE=TRUE

Add the Cloud C2 provisioning file (optional)

In addition to the config.txt and upgrade-x.x.x.bin files on the root of the USB drive, a Cloud C2 device.config provisioning file may be included.

To generate this file, create a new WiFi Pineapple device on your Cloud C2 instance, then navigate to the device's overview page and click the Setup button from the description card.

Power on the WiFi Pineapple with the USB Drive

From a powered off state, place your USB drive into the USB Type-A port on the WiFi Pineapple, then connect it to a power source. Once the device is fully booted, it will automatically mount and find the upgrade file on the device. If the firmware file is valid, the device will then perform the firmware upgrade and reboot as indicated by the flashing red/blue LED.

During the firmware installation process, as indicated by the red/blue LED status, DO NOT disconnect the power source. Doing so will render the device inoperable.

Once your USB drive has been formatted with a supported filesystem, Download the upgrade file from the to the root of the USB drive.

It is best practice to validate file integrity by of the download.

Once the firmware has installed, you may connect to the WiFi Pineapple network and visit the web interface at .

Hak5 Download Portal
verifying the SHA256 sum
http://172.16.42.1:1471
LogoSetup by USB DiskWiFi Pineapple - Enterprise