Public Repository

Last pushed: a year ago
Short Description
This emulator is intended to help developers build captive portal for devices that use Homie ESP8266
Full Description


Running the Container

We highly recommend you to use Docker to run the emulator. To do so, you have two options:

  • With docker-compose by downloading the file docker-compose.yml file and running the following command at the same dir you downloaded the file:
    docker-compose up -d

  • Running directly the docker run command as follows:

    docker run -d -p 5000:5000 -v [absolute_path_to_your_ui_bundle_gz]:/usr/src/app/captive/ui_bundle.gz stutzlab/homie-esp8266-config-emulator

Environment Variables

FAILURE_RATE - The rate that the endpoints will fail.

Useful to emulate the resilience handling of the captive portal

Example using environment variables:

docker run -d -p 5000:5000 -e  FAILURE_RATE=0.01 -v [absolute_path_to_your_ui_bundle_gz]:/usr/src/app/captive/ui_bundle.gz stutzlab/homie-esp8266-config-emulator

The emulator will be up and listening in the port 5000

Docker Pull Command