RaspAP

The easiest, full-featured wireless router setup for Debian-based devices. Period.

More than an access point

RaspAP is feature-rich wireless router software that just works on many popular Debian-based devices, including the Raspberry Pi. Customizable, mobile-friendly interface in 20+ languages. Sets up in minutes.

Multiple VPN options

Both OpenVPN and cutting edge WireGuard encrypted tunnels may be configured to securely connect your client devices.

Ad block integration

Streamline AP throughput for your clients by sending requests for ads, trackers and other undesirable hosts to DNS blacklist oblivion.

Bridged mode

Want your upstream router to assign IP addresses? RaspAP lets you change the default routed configuration to an alternate bridged AP mode.

Easy to customize

Modify RaspAP to suit your needs with a completely exposed default configuration, many installation options, themes and more.

Docker ready

Deploy RaspAP quickly in a portable, lightweight and isolated Docker container for all your application needs.

Made for IoT

Small on memory utilization yet big on features, RaspAP is ideal for IoT applications where wireless connectivity and data sharing are a must.

Integrated API

RaspAP includes support for stateless client-server data exchange via a high performance RESTful API based on FastAPI.

Custom user plugins

Want to extend RaspAP's functionality? A plugin manager and sample plugin make it easy for developers to create their own custom plugins.

VPN provider control

Administer several of the most popular VPN providers via their Command Line Interfaces (CLIs) directly in RaspAP's UI.

Additional Features

Quick Start

Begin with a clean install of the latest release of a supported Linux distribution. In the example below, Raspberry Pi OS (64-bit) Lite is used. Update your OS to its latest version, including the kernel and firmware, followed by a reboot:.


 sudo apt-get update
 sudo apt-get full-upgrade
 sudo reboot
              

Set the WiFi country in raspi-config's Localisation Options:


   sudo raspi-config
                

Invoke RaspAP's Quick Installer:


   curl -sL https://install.raspap.com | bash
                

The Quick Installer will complete the steps in the manual installation for you.

Following a reboot, the wireless AP network will be configured as follows:

  • IP address: 10.3.141.1
  • Username: admin
  • Password: secret
  • DHCP range: 10.3.141.50 — 10.3.141.254
  • SSID: raspi-webgui
  • Password: ChangeMe

It is strongly recommended that you change these default credentials in RaspAP's Authentication and Hotspot > Security panels.

Your AP's basic settings and many advanced options may now be modified by RaspAP.

Supported Distributions

RaspAP was originally made for Raspberry Pi OS, but now also installs on the following Debian-based distros.

Distribution Release Architecture Support
Raspberry Pi OS (64-bit) Lite Bookworm ARM Official
Raspberry Pi OS (32-bit) Lite Bookworm ARM Official
Raspberry Pi OS (64-bit) Desktop Bookworm ARM Official
Raspberry Pi OS (64-bit) Lite Bullseye ARM Official
Raspberry Pi OS (32-bit) Lite Bullseye ARM Official
Armbian 23.11 (Jammy) ARM Beta
Debian Bookworm ARM / x86_64 Beta
Ubuntu Server 23.04 (Lunar) ARM / x86_64 Beta

Linux distributions

You are also encouraged to try RaspAP's community-led Docker container.

Documentation and more

Our frequently asked questions (FAQ) are continuously updated and are a great place to start. Need help not covered in the FAQ, have an idea or want to share your project with the RaspAP community? Head over to our GitHub Discussions. For everything else, dive into our official documentation.

RaspAP docs

License

RaspAP/raspap-webgui is licensed under the GNU General Public License v3.0.

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

RaspAP is created by a team of dedicated developers who contribute their time and expertise to improving this project.

Contact

Follow RaspAP on X for updates.