# Software

# 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.

<table id="bkmrk-distribution-debian-"><thead><tr><th>Distribution</th><th>Debian version</th><th>Kernel version</th><th>RaspAP version</th><th>Size</th></tr></thead><tbody><tr><td>Raspberry Pi OS (64-bit) Lite</td><td>12 (bookworm)</td><td>6.6</td><td>Latest</td><td>777 MB</td></tr><tr><td>Raspberry Pi OS (32-bit) Lite</td><td>12 (bookworm)</td><td>6.6</td><td>Latest</td><td>805 MB</td></tr></tbody></table>

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 &gt; 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.

<table id="bkmrk-distribution-release"><thead><tr><th>Distribution</th><th>Release</th><th>Architecture</th><th>Support</th></tr></thead><tbody><tr><td>Raspberry Pi OS</td><td>(64-bit) Lite Bookworm</td><td>ARM</td><td>Official</td></tr><tr><td>Raspberry Pi OS</td><td>(32-bit) Lite Bookworm</td><td>ARM</td><td>Official</td></tr><tr><td>Raspberry Pi OS</td><td>(64-bit) Desktop Bookworm</td><td>ARM</td><td>Official</td></tr><tr><td>Raspberry Pi OS</td><td>(64-bit) Lite Bullseye</td><td>ARM</td><td>Official</td></tr><tr><td>Raspberry Pi OS</td><td>(32-bit) Lite Bullseye</td><td>ARM</td><td>Official</td></tr><tr><td>Armbian</td><td>23.11 (Jammy)</td><td>[ARM](https://www.armbian.com/rpi4b/)</td><td>Beta</td></tr><tr><td>Debian</td><td>Bookworm</td><td>ARM / x86\_64</td><td>Beta</td></tr><tr><td>Ubuntu</td><td>Server 23.04 (Lunar)</td><td>ARM / x86\_64</td><td>Beta</td></tr></tbody></table>

![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).

# Pi-hole



# Quick Install

### Installation
##### **One-Step Automated Install**

Those who want to get started quickly and conveniently may install Pi-hole using the following command:

```bash
curl -sSL https://install.pi-hole.net | bash
```

>Piping to bash is a controversial topic, as it prevents you from reading code that is about to run on your system.

If you would prefer to review the code before installation, we provide these alternative installation methods.

##### **Alternative 1: Clone our repository and run**
```bash
git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole
cd "Pi-hole/automated install/"
sudo bash basic-install.sh
```
##### **Alternative 2: Manually download the installer and run**
```bash
wget -O basic-install.sh https://install.pi-hole.net
sudo bash basic-install.sh
```
##### **Alternative 3: Use Docker to deploy Pi-hole**

Please refer to the [Pi-hole docker](https://bookstack.lionelsgroup.co.za/books/docker/page/pi-hole) repo to use the Official Docker Images.