Troubleshooting

This article covers common issues and how to resolve them. If you encounter a problem not listed here, see Order Accuracy Issues.

Build Fails (network / pip)

docker compose build --no-cache

Model File Not Found

# Verify models were correctly set up
ls ../ovms-service/models/
ls models/easyocr/
ls models/yolo11n_int8_openvino_model/

OVMS Not Starting

# Check logs
docker logs oa_ovms_vlm

# Verify model files exist
ls -la ../ovms-service/models/

Connection Refused to OVMS (port 8001)

OVMS can take 2–5 minutes to load the model. Wait and check:

docker logs -f oa_ovms_vlm | grep "Serving"

MinIO Bucket Errors

# Recreate MinIO with fresh volumes
make down
docker volume rm take-away_minio_data
make up

GPU Not Detected

sudo usermod -aG render $USER
# Log out and log back in, then restart services
make down && make up

GPU Out of Memory

# Switch to CPU: set both in .env, then re-export model
TARGET_DEVICE=CPU
OPENVINO_DEVICE=CPU
# Then:
cd ../ovms-service && ./setup_models.sh --app take-away
cd ../take-away && make down && make up