Skip to content

# Integrations

Changemaker Lite integrates with several self-hosted services. Each runs as a Docker container and can be enabled independently.

## Team Chat (Rocket.Chat)

Self-hosted team chat for volunteer coordination. Enable with `enableChat` in Settings.

- Channels & DMs — organize conversations by topic, team, or campaign
- Iframe integration — embedded in the admin dashboard and volunteer portal
- Floating widget — minimizable chat FAB on admin pages (toggleable in Settings)
- SSO-ready — iframe authentication for seamless login
- Mobile apps — native Rocket.Chat apps work with your instance
- Routes: `/app/services/rocketchat`, `/volunteer/chat`

## Video Conferencing (Jitsi Meet)

Self-hosted video calls integrated with Rocket.Chat via JWT authentication. Enable with `enableMeet` in Settings.

- One-click calls — start a call from any Rocket.Chat channel or DM
- JWT auth — participants join automatically with no separate login
- 4 containers — jitsi-web, jitsi-prosody (XMPP/JWT), jitsi-jicofo (conference focus), jitsi-jvb (video bridge)
- Setup: Generate secrets, start containers, configure the Jitsi marketplace app in Rocket.Chat, set token expiration to `now + 1hour`

Token Expiration

Set the Jitsi app's Token Expiration to `now + 1hour`. A raw number like `120` is interpreted as Unix timestamp 120 (Jan 1970), causing all tokens to appear expired.

## Password Manager (Vaultwarden)

Bitwarden-compatible password vault for secure team credential sharing.

- Bitwarden client compatible — use official browser extensions, desktop apps, and mobile apps
- Auto-invite — initial admin user invited on first startup
- User provisioning — new platform users can be auto-invited when provisioning is enabled
- Client setup: Point Bitwarden clients to `https://vault.DOMAIN`

## Whiteboard (Excalidraw)

Collaborative whiteboard for brainstorming and campaign planning.

- Real-time collaboration — multi-user drawing with WebSocket support
- Embedded in admin — full-screen iframe at `/app/services/excalidraw`
- Desktop only — requires a desktop browser for the drawing experience
- Route: `/app/services/excalidraw`

## Git Hosting (Gitea)

Self-hosted Git repository hosting for campaign code and configuration.

- Lightweight Git forge — repositories, issues, pull requests, and wikis
- User provisioning — platform users can be auto-provisioned as Gitea accounts
- Embedded — accessible at `git.DOMAIN` or embedded in admin at `/app/services/gitea`

## Workflow Automation (n8n)

Self-hosted workflow automation for connecting platform events to external services.

- Visual workflow editor — drag-and-drop automation builder
- Webhook triggers — respond to platform events
- Embedded — accessible at `n8n.DOMAIN` or embedded in admin at `/app/services/n8n`

## QR Code Generator (Mini QR)

Built-in QR code generation for walk sheets, volunteer invites, and campaign links.

- Public API — QR code PNG generation at `/api/qr`
- Walk sheet integration — QR codes embedded in printable walk sheets
- Volunteer quick join — QR codes for instant volunteer onboarding
- Embedded — admin interface at `/app/services/qr`