Brothers in ARMs'access point docker image

Overview

This project build a docker container running the hostapd daemon and a dhcpd daemon. It's goal is to configured the 'wlan0' network interface as an wifi access point, which is able to run on any amd64 and arm devices (from arm32v6 to arm64v8).

Current implementation hardcode the usage of the 10.57.0.0/255.255.255.0 sub-network:

• 10.57.0.1 will be the IP of the access point gateway
• Wifi clients will obtain DHCP addresses inside the [10.57.0.10 - 10.57.0.220] range.

This project was hugely inspired from https://gitlab.com/hartek/autowlan.

Usage

You could start your own access point with customized settings thanks to this docker-compose file:

version: '3.7'
services:
  biarms-access-point:
    container_name: biarms-access-point
    image: biarms/access-point
    cap_add: 
      - NET_ADMIN
    stop_grace_period: 2m
    network_mode: "host"
    volumes: 
      - ./your-customized-hostapd.conf-file:/etc/hostapd/hostapd.conf

See for instance the arm-docker-stacks infra access-point configuration.

References:

1. https://gitlab.com/hartek/autowlan / https://fwhibbit.es/en/automatic-access-point-with-docker-and-raspberry-pi-zero-w
2. https://wiki.alpinelinux.org/wiki/Wireless_AP_with_udhcpd_and_NAT
3. https://elinux.org/RPI-Wireless-Hotspot

How to build locally

1. Option 1: with CircleCI Local CLI:
   • Install CircleCI Local CLI
   • Call circleci local execute -e DOCKER_USERNAME=******** -e DOCKER_PASSWORD=********
2. Option 2: with make:
   • Install GNU make. Version 3.81 (which came out-of-the-box on MacOS) should be OK.
   • Call DOCKER_USERNAME=******** DOCKER_PASSWORD=******** make circleci-local-build
   • Call DOCKER_USERNAME=******** DOCKER_PASSWORD=******** make
   • Call docker login && make build
   • Call make build

Release notes:

Version 0.0.1 (corrupted)

• Image build with docker-toolbox version 0.0.2
• Image build on alpine:3.12, building a hostapd version 2.9
• Critical issue: Don't have entry point

Version 0.0.2

• Image build with docker-toolbox version 0.0.2
• Image build on alpine:3.12, building a hostapd version 2.9
• Fix missing entry point issue

Version 0.0.3

• Image build with docker-toolbox version 0.0.5
• Image build on alpine:3.15.3, building a hostapd version 2.10