picaptiveportal

Offline Raspberry Pi Captive Portal / Physical Web Space inspired by Anyfesto Pi.

wget --no-check-certificate https://raw.githubusercontent.com/mauricecyril/picaptiveportal/master/install.sh

sudo bash install.sh

Requirements

Raspberry Pi Zero W, Raspberry Pi 3, or Raspberry Pi 2 with Redbear WifiHat
16GB Micro SD Card
Latest version of Raspbian Lite (Tested on Raspbian Stretch Lite)
A Windows, OSX or Linux machine to write the Raspbian Lite image and activate ssh and setup wifi
An internet connection
SSH client to run the script after first boot

Installation Instructions

Step 1

Download latest version of Raspbian Lite: https://www.raspberrypi.org/downloads/raspbian/

Step 2

Unzip and write the downloaded image to an SD Card (ie. using Etcher, etc) Instructions: https://www.raspberrypi.org/documentation/installation/installing-images/README.md

Step 3

After the image has been written to the SD Card, eject the card and re-insert.

Manual Mounting Instructions on Linux

Insert SD Card and list all visible drives

Step 4

Once the SD card has been mounted (or automounted) open up the /boot partition on the card

Step 5

Create a blank file called SSH on the /boot partition of the SD card to make sure SSH is active on first boot.

For example:

df
cd /media/{your-username}/boot

Create the ssh file

sudo touch ssh

Step 6

Create a file on the /boot partition called "wpa_supplicant.conf" Put your wifi details to make the raspberry pi connect to the internet / your router after the first boot (ie. headless mode).

Example wpa_supplicant.conf:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US

network={
    ssid="Your network SSID"
    psk="Your WPA/WPA2 security key"
    key_mgmt=WPA-PSK
}

Step 7

Unmount the SD Card and insert the card into a Raspberry Pi

Step 8

If you're connected to a screen and have a keyboard plugged into your Pi skip to step 9

If you're connecting to the Pi via SSH wait till your router registers the Pi as a client. Log into your router and find out the ip address of the raspberry pi. Once you've deteremined the ip of the Pi on your network ssh into the device.

Step 9

wget --no-check-certificate  https://raw.githubusercontent.com/mauricecyril/picaptiveportal/master/install.sh

Run the script as super user (sudo):

sudo bash install.sh

Step 10

Once the script completes, reboot the Pi and you should see a wifi SSID called "picaptiveportal"

mauricecyril / picaptiveportal

readme