Skip to content

(bug) Fix analytics callback URL in HA deployments behind proxy #1229 #1230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jfederico wants to merge 2 commits into
base: master
Choose a base branch
from
Open

(bug) Fix analytics callback URL in HA deployments behind proxy #1229 #1230

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b6b2175
GIT-1229: Fix analytics callback URL in HA deployments behind proxy
jfederico Feb 18, 2026
655fabc
Merge branch 'master' into GIT-1229
jfederico Mar 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion app/handlers/analytics_callback_event_handler.rb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,9 @@ def initialize(params, meeting_id, tenant = nil)
def handle
return if analytics_callback_url.nil?

host_name = Rails.configuration.x.url_host
# Use ANALYTICS_CALLBACK_URL_HOST if set (for HA/proxy deployments)
# Otherwise fall back to URL_HOST (for direct deployments)
host_name = Rails.configuration.x.analytics_callback_url_host || Rails.configuration.x.url_host

params['meta_analytics-callback-url'] = if tenant.present?
"https://#{tenant.name}.#{host_name}/bigbluebutton/api/analytics_callback"
Expand Down
4 changes: 4 additions & 0 deletions config/application.rb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,10 @@ class Application < Rails::Application
# Scalelite Host name
config.x.url_host = ENV.fetch('URL_HOST', nil)

# Analytics callback URL host (for HA deployments behind proxy)
# Falls back to URL_HOST if not set. Use for deployments where URL_HOST is internal.
config.x.analytics_callback_url_host = ENV.fetch('ANALYTICS_CALLBACK_URL_HOST', nil)

# DB connection retry attempt counts
config.x.db_connection_retry_count = ENV.fetch('DB_CONNECTION_RETRY_COUNT', '3').to_i

Expand Down
1 change: 1 addition & 0 deletions docs/configuration-README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,7 @@ These variables are used by the service startup scripts in the Docker images, bu
* `USE_EXTERNAL_VOICE_BRIDGE`: Whether or not to try to use the `voiceBridge` number passed by the BigBlueButton API client. Defaults to `false`. If your API client generates numbers compatible with your BigBlueButton configuration, you can change this to `true` to use them. Note that Scalelite will ignore the voice bridge number provided, and generate a new one, if the number is already in use by a different meeting.
* `FSAPI_PASSWORD`: Password (for "Basic" authentication) to access the freeswitch dialplan API. Default is to use the first `LOADBALANCER_SECRET` as the password. You can set this to the empty string to disable authentication.
* `FSAPI_MAX_DURATION`: Maximum duration for voice calls handled by the freeswitch dialplan integration in minutes. Defaults to `MAX_MEETING_DURATION` if that is set, otherwise no limit. You probably want to set a limit here to ensure you do not have excess expenses due to people not hanging up calls.
* `ANALYTICS_CALLBACK_URL_HOST`: The hostname used to construct the analytics callback URL sent to BigBlueButton servers. This is useful for High Availability deployments where `URL_HOST` is set to an internal hostname for DNS rebinding protection, but the analytics callbacks need to reach a public-facing hostname. If not set, falls back to `URL_HOST`. Example: In HA deployments set `URL_HOST=scalelite-api` (internal) and `ANALYTICS_CALLBACK_URL_HOST=sl.example.com` (public). Defaults to the value of `URL_HOST` if not specified.

### Configure your Front-End to use Scalelite

Expand Down