home-automation/PORTS.md

Port Configuration

This document describes the port allocation for the home automation services.

Port Scan Results (31. Oktober 2025)

Ports in Use

• 8000: In use (likely API server)
• 8021: In use (system service)
• 8080: In use (system service)
• 8100: In use (system service)
• 8200: In use (system service)
• 8770: In use (system service)

Free Ports Found

• 8001: FREE ✓
• 8002: FREE ✓
• 8003: FREE ✓
• 8004: FREE ✓
• 8005: FREE ✓

Service Port Allocation

Service	Port	Purpose
API	8001	FastAPI REST API for capabilities and health checks
UI	8002	FastAPI web interface with Jinja2 templates
(Reserved)	8003	Available for future services
(Reserved)	8004	Available for future services
(Reserved)	8005	Available for future services

Access URLs

• API: http://localhost:8001

  • Health: http://localhost:8001/health
  • Spec: http://localhost:8001/spec
  • Docs: http://localhost:8001/docs

• UI: http://localhost:8002

  • Main page: http://localhost:8002/

Starting Services

# Start API
poetry run uvicorn apps.api.main:app --reload --port 8001

# Start UI
poetry run uvicorn apps.ui.main:app --reload --port 8002

# Start Abstraction Worker (no port - MQTT client)
poetry run python -m apps.abstraction.main