diff --git a/RPi-Zero-W-AP-STA-mode.md b/RPi-Zero-W-AP-STA-mode.md new file mode 100644 index 0000000..3526827 --- /dev/null +++ b/RPi-Zero-W-AP-STA-mode.md @@ -0,0 +1,23 @@ +### Preamble + +This walkthrough describes an installation of RaspAP on the [Raspberry Pi Zero W](https://www.raspberrypi.org/products/raspberry-pi-zero-w/). A managed mode AP, also known as **WiFi client AP mode** or simply **AP-STA**, works "out-of-the-box" with the Quick Installer if the steps below are _followed exactly_. This feature was added to RaspAP specifically to support Internet of Things (IoT) and embedded applications for the Pi Zero W, however it is equally useful for a broad range of projects. + +![](https://i.imgur.com/Y2p2wFp.png) +### Installation + +1. Begin by flashing an SD card with a fresh install of the latest release of [Raspbian Buster Lite](https://www.raspberrypi.org/downloads/raspbian/). +2. Prepare the SD card to connect to your WiFi network in headless mode [according to this FAQ](https://github.com/billz/raspap-webgui/wiki/FAQs#headless-mode). +3. Enable `ssh` access by creating an empty file called "ssh" (no extension) in the SD card's root. +4. Insert the SD card into the Pi Zero W and connect it to power. **Note:** the standard power supply for the Raspberry Pi is 5.1V @ 2.5A. Other power sources may result in undervoltage or other issues. Do _not_ use the micro USB connection. +5. Connect to your Pi via ssh. `ssh pi@raspberrypi.local` is typical. +6. Follow the [project prerequisites](https://github.com/billz/raspap-webgui#prerequisites) exactly. Do _not_ skip any of these steps. +7. Invoke the [Quick Installer](https://github.com/billz/raspap-webgui/wiki/Quick-Installer-usage) as normal: `curl -sL https://install.raspap.com | bash`. +8. The installer automatically detects a Pi (or other device) without an active `eth0` interface. In this case, you will _not_ be prompted to reboot you Pi. +9. Open the RaspAP admin interface in your browser, usually http://raspberrypi.local. +10. The status widget should indicate that hostapd is _not_ active. This is expected. +11. Confirm that the **Wireless Client** dashboard widget displays an active connection. +12. choose **Hotspot > Advanced** and slide the **WiFi client AP mode** toggle. +13. Optionally, enable **Logfile output** as this is often helpful for troubleshooting. +14. Choose **Save settings** and **Start hotspot**. +15. Wait a few moments and confirm that your AP has started. +