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:
hostap.conf
(under config directory): you can use or modify the sample configuration file. Make sure to call ithostap.conf
. Otherwise, you need to change the name of this file in the following config file.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.