Skip to content

troubleshooting.md

Latest commit

 

History

History
81 lines (54 loc) · 2.58 KB

troubleshooting.md

File metadata and controls

81 lines (54 loc) · 2.58 KB

Get Help

This page provides comprehensive support and troubleshooting information for the Smart NVR Sample Application. It is divided into the following sections:

  • Common Issues: General troubleshooting steps for resolving issues like container failures, port conflicts, and missing dependencies.
  • Troubleshooting Docker Deployments: Steps to address problems specific to Docker deployments.

Troubleshooting Common Issues

1. Containers Not Starting

  • Issue: The application containers fail to start.

  • Solution:

    docker ps
docker logs <container-id>

    Check the logs for errors.

2. Port Conflicts

  • Issue: Port conflicts with other running applications.
  • Solution: Update the ports section in the Docker Compose file.

3. Description not coming in UI

  • Check logs for frigate container
  • Check if VLM microservice is running and reachable.
  • Verify that NVR_GENAI=true is set and frigate config has genai.enabled: true

4. GenAI Event Descriptions Not Working

  • Issue: AI-powered event descriptions are not being generated or displayed.
  • Solution:
    • Ensure NVR_GENAI=true environment variable is set before starting the application
    • Verify the frigate configuration file has genai.enabled: true
    • Check VLM microservice logs for connectivity issues: docker logs <vlm-container-id>
    • Verify the model specified in frigate config matches the one deployed in VLM service
    • Note: This is an experimental feature with known stability issues

5. Object not getting detected

  • Check the label in frigate config.yaml for the specific camera.
  • Check the top_score parameter .

6. "No video footage available" warning during Summarize/Search Clip

  • Ensure the browser’s date and time are correctly set and in sync with the system time of the machine running the NVR services.
  • Video clips are only available from the time the NVR services started running. If a past time (before service start) is selected, this warning will be shown.

Troubleshooting Docker Containers

1. Containers Failing

  • Check the Docker logs for errors:

    docker ps
docker logs <container-id>

2. Port Conflicts in Docker

  • Update the ports section in the Compose file to resolve conflicts.

3. Reset Application

  • Follow these steps to reset the application to the initial state

    ./setup.sh stop
docker volume rm docker_mosquitto_data docker_mosquitto_log docker_redis_data