Skip to main content
Version: DeepHub 2024 R1 - 2.5.4

Configuration

The two DeepHub UIs can be configured via environment variables. Typically, these are defined in the docker-compose.yml file used to start and orchestrate the overall system with the DeepHub container, the DeepHub UI containers, and the Apache reverse proxy container.

The environment variables address different aspects:

  • Basic setup
  • OpenID settings
  • Mapping provider settings

See the sections below for details.

Basic Setup​

DEEPHUB_ROOT_URL​

The base path where the DeepHub's REST API endpoints and the WebSocket API can be reached.

The actual pathes are then

  • DEEPHUB_ROOT_URL/v2 for the REST API endpoints and
  • DEEPHUB_ROOT_URL/v2/ws/socket for the WebSocket API.

DEEPHUB_WEBSOCKET_URL​

Usually not set because the URL and path can be derived automatically from the DEEPHUB_ROOT_URL. See above.

  • Optional
  • Default: empty

NGINX_BASE_HREF​

The base href that the nginx web server should use for serving the DeepHub UI.

  • Optional
  • Default: /

NGINX_UPLOAD_MAX_FILESIZE​

Flag for the used nginx web server: The upload file size limit for a single file. This is relevant for the floorplan image upload feature. The default is set to 100 MB.

note

Use this parameter together with the following one. Both should be in-sync concerning the chosen file size limits!

  • Optional
  • Default: 100M

ROCKET_LIMITS​

Flag for the used nginx web server: rate limits. This is relevant for the floorplan image upload feature. The default is set to 100 MB.

  • Optional
  • Default: {form=100MB,file=100MB,data-form=100MB}

OpenID Settings​

note

The OpenID setup only works if all three variables are set. If none are set, OpenID functionality is completely switched off.

DEEPHUB_AUTH_ISSUER​

When using OpenID, this is the URL that reaches the OpenID server to authenticate the user.

  • Optional
  • Default: empty

DEEPHUB_AUTH_CLIENT_ID​

When using OpenID, this is the CLIENT ID with which the DeepHub UI identifies itself.

  • Optional
  • Default: empty

Mapping Provider Settings for Admin UI and Kiosk UI​

DEEPHUB_MAP_PROVIDER​

The provider of the background mapping service. We support mapbox and maptiler.

  • Optional
  • Default: maptiler

DEEPHUB_MAP_ACCESS_TOKEN​

Your personal access token from a mapping service provider.

  • Optional
  • Default: empty

DEEPHUB_MAP_DEFAULT_STYLE​

The background map style to be used.

  • Optional
  • Default: empty

DEEPHUB_MAP_UPDATES_PER_SECOND​

The number of background map updates per second to use. A number > 0 is expected.

  • Optional
  • Default: 10

DEEPHUB_MAP_ENABLE_GEOENCODER_SEARCH_FIELD​

This options enables or disables the geo encoder search field. A boolean value, true or false, is expected.

  • Optional
  • Default: true

Mapping Provider Settings for Kiosk UI​

DEEPHUB_MAP_MINZOOM​

The minimum zoom level that can be reached when zooming out. A number between 1 and 24 is expected.

  • Optional
  • Default: 1

DEEPHUB_MAP_MAXZOOM​

The maximum zoom level that can be reached when zooming in. A number between 1 and 24 is expected, and it must be larger than the value specified for DEEPHUB_MAP_MINZOOM.

  • Optional
  • Default: 24