politictalk/local/README.md

Local PoliticTalk Jitsi

This folder contains the tracked overrides used to test PoliticTalk Jitsi locally with the official Docker Jitsi stack.

The downloaded Docker stack and generated runtime config are intentionally ignored by Git:

local/docker-jitsi-meet/
local/.jitsi-meet-cfg/

First Run

Install Docker Desktop first if docker --version is not available.

Then run:

cd /Users/amardeep/work/pg/jitsi
./scripts/local-jitsi-setup.sh
./scripts/local-jitsi-start.sh

Open:

https://localhost:8443/pt-local-test

The browser may warn about a self-signed certificate. That is expected for local Docker testing.

After Editing Overrides

When you edit local/custom-config.js, local/custom-interface_config.js, or local assets, run:

./scripts/local-jitsi-sync.sh
./scripts/local-jitsi-restart-web.sh

Stop

./scripts/local-jitsi-stop.sh

What This Tests

• PoliticTalk branding assets
• prejoin behavior
• audio-only policy
• muted microphone/camera startup
• toolbar restrictions
• chat, polls, raise hand, fullscreen, noise suppression
• E2EE UI availability

Final production verification still happens on the VPS because real WebRTC networking, domain, HTTPS, and future JWT auth depend on the server environment.