# Docker Health Check Fix - Complete

## Problem

The `start-docker-apps.sh` script was failing because:
1. Health checks were too impatient (only 5 seconds wait)
2. The script exited with error if services weren't ready immediately
3. Services like Grafana and SearXNG need 30-60 seconds to fully start
4. Fedimint image had a platform mismatch warning on ARM64 Macs

## Solutions Applied

### 1. Improved Health Check Logic (`start-docker-apps.sh`)

**Before:**
```bash
# Wait 5 seconds, check once, fail if not ready
sleep 5
check_service "Grafana" "http://localhost:3000"
check_service "SearXNG" "http://localhost:8082"
# If not ready, exit with error
```

**After:**
```bash
# Wait up to 60 seconds with retries
MAX_ATTEMPTS=30
ATTEMPT=0

while [ $ATTEMPT -lt $MAX_ATTEMPTS ]; do
    READY_COUNT=0
    
    check_service "Grafana" "http://localhost:3000" && ((READY_COUNT++)) || true
    check_service "SearXNG" "http://localhost:8082" && ((READY_COUNT++)) || true
    check_service "Endurain" "http://localhost:8084" && ((READY_COUNT++)) || true
    check_service "MorphOS" "http://localhost:8081" && ((READY_COUNT++)) || true
    
    if [ $READY_COUNT -ge 2 ]; then
        echo "   ✅ Core services are ready!"
        break
    fi
    
    sleep 2
    ((ATTEMPT++))
done

# Non-blocking - informational only
if [ $READY_COUNT -lt 2 ]; then
    echo "   ℹ️  Some services are still starting (this is normal)"
    echo "   💡 They will be available shortly. Check with: docker compose ps"
fi
```

**Key improvements:**
- Retries up to 30 times (60 seconds total)
- Non-blocking (doesn't fail if services aren't ready)
- Informational messages to reassure users
- Continues startup even if services are still initializing

### 2. Fixed Fedimint Platform Warning (`docker-compose.yml`)

**Before:**
```yaml
fedimint:
  image: fedimint/fedimintd:v0.3.0
  container_name: archy-fedimint
  ports:
    - "8173:8173"
```

**After:**
```yaml
fedimint:
  image: fedimint/fedimintd:v0.3.0
  container_name: archy-fedimint
  platform: linux/amd64  # Emulate x86 on ARM Macs
  ports:
    - "8173:8173"
```

This tells Docker to use x86 emulation for Fedimint on ARM Macs, eliminating the warning.

## Testing

Run the dev server again:

```bash
cd scripts
bash dev-start.sh
# Choose option 2 (Full stack)
```

**Expected behavior:**
1. Docker containers create and start successfully
2. Health check waits patiently for services
3. Script continues even if some services are still initializing
4. No platform mismatch warnings
5. Backend and frontend start without errors

## Files Modified

- `/Users/dorian/Projects/archy/start-docker-apps.sh` - Improved health check logic
- `/Users/dorian/Projects/archy/docker-compose.yml` - Added platform specification for Fedimint

## Next Steps

Once you confirm this works:
1. Bitcoin Core should appear in the My Apps section
2. You should be able to launch it and see the custom UI
3. Stop/Start functionality should work
4. All 13 Docker apps should be running in the background