# 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

```bash
# 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
```