SceneScape Deployment Guide (Prebuilt Containers)#

This guide explains how to deploy SceneScape using prebuilt Docker images, primarily from Docker Hub.

1. Set Up Docker Environment#

  1. Ensure Docker is installed and running on your system.

2. Generate secrets and download OpenVINO Model Zoo models#

make init-secrets install-models

3. Use Prebuilt Images for SceneScape Deployment#

SceneScape prebuilt containers can be found here:

3.1 Configure Docker Compose to use prebuilt images#

Update sample_data/docker-compose-dl-streamer-example.yml to use the above prebuilt images. Example:

scene:
  image: docker.io/intel/scenescape-controller:latest
  # ... other service configurations ...
web:
  image: docker.io/intel/scenescape-manager:latest
  # ... other service configurations ...
camcalibration:
  image: docker.io/intel/scenescape-camcalibration:latest
  # ... other service configurations ...

3.2 Configure preloaded scenes at deployment#

  • Skip preloading: Do not set the EXAMPLEDB environment variable.

  • Preload database: Set the EXAMPLEDB environment variable to the path of your database tar file and ensure the folder is mounted. Example:

web:
  image: docker.io/intel/scenescape-manager:latest
  environment:
    - EXAMPLEDB=/home/scenescape/SceneScape/sample_data/exampledb.tar.bz2
    - SUPASS=<password>
  volumes:
    - vol-sample-data:/home/scenescape/SceneScape/sample_data

4. Start Services#

Start the demo services:

SUPASS=<password> make demo

Verify that all containers are running:

docker ps

5. Import Scenes#

After the services are up, scenes can be imported either via API (curl) or the Web UI.

5.1 Using curl#

  1. Obtain an authentication token:

curl --location --insecure -X POST -d "username=admin&password=<password>" https://<ip_address>/api/v1/auth

Note: <password> is the same as used in SUPASS=<password> make demo.

  1. Upload the scene ZIP:

curl -k -X POST \
  -H "Authorization: Token <token>" \
  -F "zipFile=@<path_to_zip>" \
  https://<ip_address>/api/v1/import-scene/

5.2 Using the Web UI#

  1. Log in with admin credentials.

  2. Navigate to Import Scene.

  3. Select and upload the scene ZIP.