README.md

🛠️ Desk Management REST API (Mirrored Repository)

This repository mirrors and publishes the Desk Management REST API automatically, simulating desks with configurable properties and real-time state tracking. It builds and publishes the simulator as a Docker image. For full details, visit the main branch.

🚀 Quick Start

🐳 Run with Docker:

docker run -p 8000:8000 respectmathias/wifi2ble-box-simulator:latest

🔧 Pass options via ARGS:

docker run -e ARGS="--port 8080 --speed 100" -p 8080:8080 respectmathias/wifi2ble-box-simulator:latest

🛠️ Run with Docker Compose:

Add this to your docker-compose.yml:

services:
  desk-simulator:
    image: respectmathias/wifi2ble-box-simulator:latest
    ports:
      - "8000:8000"
    environment:
      ARGS: "--port 8000 --speed 60"

Start the simulator:

docker-compose up

⚠️ Disclaimer

The simulator’s main.py is slightly modified automatically to bind to 0.0.0.0 (required for Docker) instead of localhost. This ensures compatibility with containerized environments.