# Installing RaspAP

Quick Start
-----------

RaspAP gives you two different ways to get up and running quickly. The simplest approach is to use a [custom OS image](https://github.com/RaspAP/raspap-webgui/releases/latest) with RaspAP preinstalled. This option eliminates guesswork and gives you a base upon which to build. An alternative method is to execute the Quick installer on an existing [compatible OS](#distros).

### Custom OS

Custom Raspberry Pi OS Lite images with the latest RaspAP are available for [direct download](https://github.com/RaspAP/raspap-webgui/releases/latest). This includes both 32- and 64-bit builds for ARM architectures.

| Distribution | Debian version | Kernel version | RaspAP version | Size
|---|---|---|---|----|
Raspberry Pi OS (64-bit) Lite | 12 (bookworm) | 6.6 | Latest | 777 MB
Raspberry Pi OS (32-bit) Lite | 12 (bookworm) | 6.6 | Latest | 805 MB

These images are automatically generated with each release of RaspAP and are made [available here](https://github.com/RaspAP/raspap-webgui/releases/latest). You may choose between an `arm64` or `armhf` (32-bit) based build.

After downloading your desired image, use a utility such as the Raspberry Pi Imager or [balenaEtcher](https://www.balena.io/etcher) to flash the OS image onto a microSD card. Insert the card into your device and boot it up. The latest RaspAP release with the most popular components will be active and ready for you to configure.

### Quick installer

Alternatively, begin with a clean install of the latest release of a [supported Linux distribution](#distros). In the example below, [Raspberry Pi OS (64-bit) Lite](https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit) 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](https://docs.raspap.com/quick/) will complete the steps in the [manual installation](https://docs.raspap.com/manual/) for you. At the end of the install process, accept the prompt to reboot your system.

### Initial settings

After completing either of these setup options, 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](https://docs.raspap.com/ap-basics/) and many [advanced options](https://docs.raspap.com/ap-basics/#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](https://www.armbian.com/rpi4b/) | Beta
Debian | Bookworm | ARM / x86\_64 | Beta
Ubuntu | Server 23.04 (Lunar) | ARM / x86\_64 | Beta

![Linux distributions](https://raspap.com/assets/images/supported-distros.png)

You are also encouraged to try RaspAP's community-led [Docker container](https://github.com/RaspAP/raspap-docker).