baby-monitor/docs/DOCKER_USAGE.md

Baby Monitor - Self-Contained Docker Image

This Docker image is a self-contained service ready for deployment with all optional dependencies pre-installed.

Quick Start

docker run -p 8000:8000 baby-monitor

Access the application at http://localhost:8000

Features

This image includes all optional dependencies:

• ✅ Redis support for distributed token storage
• ✅ PostgreSQL support for scalable database backend
• ✅ SQLite built-in for single-instance deployments

Configuration

Configure the service using environment variables:

Basic Configuration

Variable	Default	Description
ENVIRONMENT	production	Set to development to enable API docs
DATA_DIR	/data	Directory for SQLite database
ADMIN_USERNAME	admin	Admin username
ADMIN_PASSWORD	(required)	Admin password (required in production)

Redis Configuration (Optional)

Variable	Description
REDIS_URI	Redis connection URI (e.g., redis://redis:6379/0)

When REDIS_URI is set, the application uses Redis for token storage instead of in-memory storage.

PostgreSQL Configuration (Optional)

Coming soon

Examples

Basic Deployment

docker run -d \
  -p 8000:8000 \
  -e ADMIN_PASSWORD=your_secure_password \
  -v ./data:/data \
  baby-monitor

With Redis

# Start Redis
docker run -d --name redis redis:7-alpine

# Start Baby Monitor with Redis
docker run -d \
  -p 8000:8000 \
  -e ADMIN_PASSWORD=your_secure_password \
  -e REDIS_URI=redis://redis:6379/0 \
  --link redis \
  baby-monitor

Using Docker Compose

version: "3.8"

services:
  app:
    image: baby-monitor
    ports:
      - "8000:8000"
    environment:
      - ADMIN_PASSWORD=your_secure_password
      - REDIS_URI=redis://redis:6379/0
    volumes:
      - ./data:/data
    depends_on:
      - redis

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data

volumes:
  redis-data:

Health Checks

The image provides several endpoints for monitoring:

• GET /health - Basic health check (returns {"status": "healthy"})
• GET /ready - Readiness check for orchestration
• GET /info - Service information including installed features

Example:

curl http://localhost:8000/info

Response:

{
  "service": "baby-monitor",
  "version": "0.1.0",
  "features": {
    "redis": true,
    "postgresql": true
  },
  "config": {
    "environment": "production",
    "data_dir": "/data",
    "redis_configured": true
  }
}

Volumes

• /data - Persistent storage for SQLite database

Mount this directory to preserve data across container restarts:

docker run -v /path/on/host:/data baby-monitor

Ports

• 8000 - HTTP API server

Security Notes

1. Always set ADMIN_PASSWORD in production
2. Use strong passwords (minimum 16 characters)
3. Run behind a reverse proxy with HTTPS
4. Use Redis for multi-instance deployments
5. Back up the /data directory regularly

Troubleshooting

Check installed features

curl http://localhost:8000/info

View logs

docker logs <container-name>

Verify Redis connection

Look for startup message:

✓ Connected to Redis at redis://...

Test authentication

curl -X POST http://localhost:8000/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}'

Support

For issues and feature requests, please visit the project repository.