Hotspot plus proxy
Start with RaspAP Lite and add WebOne, a web proxy intended to help older browsers and devices reach more of today’s web.
Raspberry Pi · Linux · MIT
A retro-web hotspot, ready to flash.
One Bash builder combines the official 64-bit RaspAP Lite image with WebOne, then writes a Raspberry Pi image you can flash. Choose a graphical window or drive the build from the terminal.
One flashable imageRaspAP hotspot plus WebOne proxy
GUI or CLIChoose a window or terminal workflow
Resume-friendlyCheckpoints, validation, and checksums
From a Debian script to a Pi
Build the network in one pass.
Customize the hotspot and access settings before writing the image, with progress and recovery built into the build flow.
Graphical or command line
Use the Tk interface to configure a build, or pass the same settings as CLI flags. Launchers can elevate permissions and start the required host workflow.
Configure before flashing
Set a hostname, login, hotspot name and password, Wi-Fi country, and SSH mode before the image is written. Choose password, public-key, both, or no SSH.
Verify downloads
The builder checks GitHub release SHA-256 checksums for downloaded components unless you deliberately skip verification.
New, update, or resume
Build a fresh image, update an existing one, or rerun the same command after an interrupted build. Checkpoints help pick up where the process stopped.
Flash a single arm64 image
Write the finished .img to a microSD card with Raspberry Pi Imager, then configure the Pi and connect the network.
Installation & Setup
Build and deploy your image.
One Debian/Ubuntu Bash builder with a Tkinter window or pure CLI interface.
Installation Steps
-
1. Clone on Debian, Ubuntu, or macOS (Docker)
git clone https://github.com/mob5824m-wq/RaspAP-WebOne.git && cd RaspAP-WebOne -
2. Make launcher scripts executable
Requires sudo permissions and ~9 GB free disk space.chmod +x build.sh launch-gui.sh launch-cli.sh
How to Use
-
1. Build via GUI Wizard
Launches the graphical configuration builder (escalates with sudo automatically)../launch-gui.sh -
2. Or build headless in terminal
Downloads RaspAP Lite, loop mounts with qemu/binfmt, and injects WebOne proxy.sudo ./build.sh -
3. Flash to MicroSD Card
Use Raspberry Pi Imager to write the output
.imgfile fromoutput/to your SD card. -
4. Boot and connect vintage devices
Connect to the RaspAP Wi-Fi network (default IP
10.3.141.1), and configure retro browsers to HTTP proxy port8080.
From host machine to hotspot
Build. Flash. Connect.
The builder runs on a Debian or Ubuntu host, or on macOS using Docker Desktop. It needs elevated permissions and roughly 9 GB of free space for a full new build.
Choose network settings
Set the hostname, account, Wi-Fi details, country, and SSH policy in the GUI or CLI. Check inputs before the build starts.
Create the image
The script downloads and customizes the official image, installs WebOne, verifies downloads, and saves the finished image with a checksum.
Boot the Raspberry Pi
Flash the image with Raspberry Pi Imager, enable any desired first-boot SSH settings, then connect to the hotspot and proxy.
Review the first-boot security settings.
Choose your own hostname, account, and Wi-Fi credentials in the build. The official RaspAP image uses a default web-admin login, so change it in RaspAP as soon as the device starts.