Quick Start¶

Get your GreenThumb greenhouse running in 5 minutes.

Prerequisites¶

Complete the Installation guide first.

1. Start the System¶

cd /opt/greenthumb   # or wherever you cloned rasp5
make up

2. Access the Local Dashboard¶

Open your browser and navigate to:

http://<raspberry-pi-ip>

The local dashboard (React SPA) shows live sensor cards, sparkline charts, an MJPEG camera feed, threshold editor, and sync status.

3. View Live Video¶

The MJPEG stream is embedded in the dashboard. Direct URL:

http://<raspberry-pi-ip>:8080/video/stream

4. Check System State¶

Get Current State (Sensors + Thresholds)¶

curl http://localhost:8080/state/

Response:

{
  "sensors": {...},
  "thresholds": [...],
  "safety_mode": false,
  "timestamp": "2026-02-03T12:00:00"
}

Get Latest Sensor Data¶

curl http://localhost:8080/data/latest

Response:

{
  "device_id": 1,
  "data": {
    "Temperature": {"value": 25.3, "unit": "°C", "collected_at": "..."},
    "Humidity": {"value": 65.2, "unit": "%", "collected_at": "..."}
  }
}

5. Control Actuators¶

Set RGB LED Color¶

curl -X POST "http://localhost:8080/state/actuators/1/command" \
  -H "Content-Type: application/json" \
  -d '{"r": 255, "g": 0, "b": 128}'

Set Pump Duty Cycle¶

curl -X POST "http://localhost:8080/state/actuators/2/command" \
  -H "Content-Type: application/json" \
  -d '{"duty_cycle": 50}'

6. Monitor Logs¶

# All services
make logs

# Specific services
make logs-api    # API logs
make logs-ctrl   # Controller logs

Common Commands¶

Command	Description
`make up`	Start all services
`make down`	Stop all services
`make logs`	View all logs
`make logs-api`	View API logs
`make logs-ctrl`	View controller logs
`make update`	Pull latest images + restart
`make status`	Container health + last sync times
`make backup`	Dump local DB to `/data/backups/`
`make db-shell`	PostgreSQL shell

Trigger a Manual Cloud Sync¶

curl -X POST http://localhost:8080/settings/sync

Or click Sync Now in the local dashboard Settings page.

Troubleshooting¶

Camera Not Working¶

# Check if camera is detected
ls -la /dev/video0

# Check container logs
make logs-api

Sensors Not Reading¶

# Check I2C devices
i2cdetect -y 1

# Expected addresses:
# 0x38 - AHT10
# 0x39 - TSL2561
# 0x76 - BMP280

Controller Not Connecting¶

# Check controller logs
make logs-ctrl

# Verify API is healthy
curl http://localhost:8080/

Safety Mode Activated¶

If actuators turn off unexpectedly, the controller may have crashed:

# Check controller status
docker compose ps controller

# Restart controller
make restart-controller

Database Connection Issues¶

# Check database container
docker compose logs db

# Restart database
docker compose restart db