DockerHostAP

DockerHostAP VNF: a docker-based Wifi Access Point service.

Installation

To install/use this VNF you need to have an up and running Docker. To read more about Docker, please visit this link https://docs.docker.com/

First, you need to clone this repository:

1
git clone https://gitlab.forge.orange-labs.fr/lucy/caas/dockerhostap.git

Then you need to add/modify two configuration files:

  1. hostap.conf (under config directory): you can use or modify the sample configuration file. Make sure to call it hostap.conf. Otherwise, you need to change the name of this file in the following config file.
  2. envrc: you can modify the existant file to adapt it to your specific environment.

Once you setup configuration, you can run the service by typing:

1
sudo ./service start

To stop the service you can type:

1
sudo ./service stop

Example of output

This is an example of the service output:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 ____             _              _   _           _      _    ____
|  _ \  ___   ___| | _____ _ __ | | | | ___  ___| |_   / \  |  _ \
| | | |/ _ \ / __| |/ / _ \ '__|| |_| |/ _ \/ __| __| / _ \ | |_) |
| |_| | (_) | (__|   <  __/ |   |  _  | (_) \__ \ |_ / ___ \|  __/
|____/ \___/ \___|_|\_\___|_|   |_| |_|\___/|___/\__/_/   \_\_|

[INFO] Ckecking service dependencies
[INFO] Docker doemon is up and running
[INFO] Docker image lucy/hostap:0.1 found
[INFO] Creating container's netwoking bridge hostap0 with subnet 192.168.100.0/24
62e953234e3938886bf3a8cf4c7688612ccfc8c9fe2d3f5d4d2b5ef986c9907c
[INFO] Lanching the docker container hostap
9d35facb26c8be200311d79806ade111ea35f7553c13601435c954ae4851eb59
[INFO] Getting hostap container's PID
[INFO] Unblocking wireless interface
[INFO] Setting wireless interface up
[INFO] Assigning phy wireless interface to the container hostap
[+] Configuring wlx74da3860223b with IP address 192.168.10.1
[+] Adding a NAT rule to container's iptables
[+] Enabling IP forwarding at the vnf's container level
[+] Starting hostapd in the docker container hostap
 * Starting advanced IEEE 802.11 management hostapd
   ...done.

Notes

The Docker image contains some utility/networking tools. You can remove them if you want.

DockerHostAP authors

  • Ayoub Bousselmi, Orange
  • Sofiane Imadali, Orange

Original DockerAP authors

  • fgg89

Release notes

  • Version 0.1 provides basic docker-based Access Point service for x86_64 architecture.