NL-TCH / raspap-docker

A community-led docker container for RaspAP

raspap-docker

A community-led docker container for RaspAP. Read the documentation or jump straight into the usage notes.

Usage

docker run --name raspap -it -d --privileged --network=host -v /sys/fs/cgroup:/sys/fs/cgroup:ro --cap-add SYS_ADMIN ghcr.io/raspap/raspap-docker:latest

Web GUI should be accessible on http://localhost by default

Workaround for ARM devices

To use this container on ARM devices you have to make cgroups writable:

docker run --name raspap -it -d --privileged --network=host --cgroupns=host -v /sys/fs/cgroup:/sys/fs/cgroup:rw --cap-add SYS_ADMIN ghcr.io/raspap/raspap-docker:latest

Web GUI should be accessible on http://localhost by default

Allow WiFi-clients to connect to LAN and internet

Because of docker isolation and security defaults the following rules must be added on the docker host:

iptables -I DOCKER-USER -i src_if -o dst_if -j ACCEPT
iptables -t nat -C POSTROUTING -o eth0 -j MASQUERADE || iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
iptables -C FORWARD -i eth0 -o wlan0 -m state --state RELATED,ESTABLISHED -j ACCEPT || iptables -A FORWARD -i eth0 -o wlan0 -m state --state RELATED,ESTABLISHED -j ACCEPT
iptables -C FORWARD -i wlan0 -o eth0 -j ACCEPT || iptables -A FORWARD -i wlan0 -o eth0 -j ACCEPT
iptables-save

Deploying using docker-compose

Use the docker-compose.yaml file to deploy RaspAP using docker compose. Do not use docker-compose but rather docker compose. For ARM devices, be sure to uncomment the cgroup: host line before executing docker compose:

git clone https://github.com/RaspAP/raspap-docker.git
cd raspap-docker
docker compose up -d