Introduction
The on-premises mode comes in two versions: Community and Enterprise.
| Feature | Community | Enterprise |
|---|---|---|
| On-premises deployment | ✅ | ✅ |
| Core Hublot features | ✅ | ✅ |
| Customization | ⚠️ | ✅ |
| Monitoring & audit | ⚠️ | ✅ |
| Support | ❌ | ✅ |
Legend
- ✅ : included
- ⚠️ : basic / limited
- ❌ : not included
The Enterprise version requires a license key provided by our team. Each key is sized for a defined number of application users.
Variables you must provide to Hublot
LOG_LEVEL=trace
PORT=3000
ROOT_URL=https://...
MONGO_URL=mongodb://....
MONGO_DB_NAME=db_name
LIVEKIT_API_HOST=http://localhost:7880
LIVEKIT_API_KEY=...
LIVEKIT_API_SECRET=...
OPENWEATHERMAP_API_KEY=...
FIREBASE_FILE=./firebase/hublot-push-firebase-adminsdk.json
MINIO_ACCESS_KEY=...
MINIO_SECRET_KEY=...
MINIO_ENDPOINT=s3_endpoint
OIDC_DISCOVERY_URL=https://.../oidc/.well-known/openid-configuration
General configuration
-
LOG_LEVEL Verbosity level for application logs. Common values:
trace,debug,info,warn,error. Example:LOG_LEVEL=trace -
PORT HTTP listen port for the Hublot application. Example:
PORT=3000 -
ROOT_URL Main public URL for Hublot, used to generate links, redirects, and callbacks. Example:
ROOT_URL=https://hublot.example.com
Database (MongoDB)
-
MONGO_URL Connection string to the MongoDB cluster (replica set recommended in production). Example:
MONGO_URL=mongodb://mongo1,mongo2,mongo3/?replicaSet=rs0 -
MONGO_DB_NAME Database name used by Hublot. Example:
MONGO_DB_NAME=hublot
Real-time communication (LiveKit)
-
LIVEKIT_API_HOST LiveKit API URL used by Hublot to manage rooms, participants, and tokens. Example:
LIVEKIT_API_HOST=http://localhost:7880 -
LIVEKIT_API_KEY LiveKit API key associated with the project.
-
LIVEKIT_API_SECRET LiveKit API secret associated with the key above. ⚠️ Must be kept strictly confidential.
External services
-
OPENWEATHERMAP_API_KEY OpenWeatherMap API key used to display weather information. Example:
OPENWEATHERMAP_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -
FIREBASE_FILE Path to the Firebase Admin SDK configuration file (JSON), used by Hublot to send push notifications. This file must be mounted in the container or present on the filesystem at the given path.
Example:
FIREBASE_FILE=/firebase/hublot-push-firebaseadminsdk.json
Object storage (MinIO / S3)
-
MINIO_ACCESS_KEY Access key for the object storage service (MinIO or S3 compatible).
-
MINIO_SECRET_KEY Secret key associated with the access key above. ⚠️ Must be kept strictly confidential.
-
MINIO_ENDPOINT Object storage endpoint (URL or hostname). Example:
MINIO_ENDPOINT=s3.hublot.local
Authentication (OIDC)
- OIDC_DISCOVERY_URL
URL of the OpenID Connect discovery document, allowing Hublot to automatically retrieve
identity provider configuration (endpoints, public keys, scopes, etc.).
Example:
OIDC_DISCOVERY_URL=https://auth.example.com/oidc/.well-known/openid-configuration