Merge pull request #6 from thesubtleties/docs/v0.3.0-video-platforms

Author: thesubtleties

README.md

@@ -31,11 +31,13 @@ This documentation site provides comprehensive guides for:
 - **Creating Sessions** - Session scheduling, types, status management, and chat modes
 - **Managing Speakers** - Adding speakers, roles, assignments, and speaker profiles
 
-### Video Streaming
-- **Streaming Overview** - Multi-platform comparison (Vimeo, Mux, Zoom) and decision guide
+### Video Platforms
+- **Video Platforms Overview** - Multi-platform comparison (Vimeo, Mux, Zoom, Jitsi, Other) and decision guide
 - **Vimeo Streaming** - Setup, live streaming, VOD, and troubleshooting
 - **Mux Streaming** - PUBLIC and SIGNED playback, BYOA model, live streams and VOD
 - **Zoom Meetings** - Interactive meeting integration and security settings
+- **Jitsi Meetings (JaaS)** - Embedded conferencing, per-user JWT authentication, moderator controls
+- **Other/External Links** - Link to any external platform (MS Teams, Google Meet, etc.)
 
 ### Networking Features (For Attendees)
 - **Making Connections** - Attendee discovery, connection requests, and icebreakers
@@ -58,7 +60,7 @@ This documentation site provides comprehensive guides for:
 
 ## Documentation Stats
 
-- **25 comprehensive user guides** covering organizer and attendee workflows
+- **27 comprehensive user guides** covering organizer and attendee workflows
 - All guides include real-world scenarios, troubleshooting, and best practices
 - Platform comparison tables and decision guides for streaming options
 - Mobile vs desktop differences documented where applicable
@@ -146,7 +148,7 @@ atria-docs/
 │   ├── event-management/     # Event creation, customization, publishing, chat rooms, icebreakers
 │   ├── attendee-management/  # Invitations, roles, moderation
 │   ├── sessions-speakers/    # Session and speaker management
-│   ├── video-streaming/      # Multi-platform streaming (Vimeo, Mux, Zoom)
+│   ├── video-streaming/      # Multi-platform streaming (Vimeo, Mux, Zoom, Jitsi, Other)
 │   ├── networking-features/  # Connections and privacy (attendee guides)
 │   ├── chat-messaging/       # Chat rooms and DMs (attendee guides)
 │   ├── sponsors/             # Sponsor management

blog/2025-11-08-v0.2.0-release.md

@@ -44,7 +44,7 @@ We're excited to announce **Atria v0.2.0**, a major update bringing flexible mul
 - Mux signing keys never stored in plain text
 
 **New Documentation**
-- Comprehensive [Video Streaming Overview](https://docs.atria.gg/docs/video-streaming/streaming-overview) with platform comparison
+- Comprehensive [Video Platforms Overview](https://docs.atria.gg/docs/video-streaming/platforms-overview) with platform comparison
 - [Vimeo Streaming Guide](https://docs.atria.gg/docs/video-streaming/vimeo-streaming) - Setup and troubleshooting
 - [Mux Streaming Guide](https://docs.atria.gg/docs/video-streaming/mux-streaming) - PUBLIC and SIGNED playback
 - [Zoom Meetings Guide](https://docs.atria.gg/docs/video-streaming/zoom-meetings) - Interactive sessions
@@ -130,7 +130,7 @@ Live, interactive meetings with two-way audio and video.
 Visit [atria.gg](https://atria.gg) to try the platform with multi-platform streaming, or check out the [installation guide](https://docs.atria.gg/docs/getting-started/installation) to self-host your own instance.
 
 **Links:**
-- [Video Streaming Documentation](https://docs.atria.gg/docs/video-streaming/streaming-overview)
+- [Video Platforms Documentation](https://docs.atria.gg/docs/video-streaming/platforms-overview)
 - [Full Documentation](https://docs.atria.gg)
 - [GitHub Repository](https://github.com/thesubtleties/atria)
 - [API Reference](https://docs.atria.gg/docs/api/atria-api)

blog/2025-11-27-v0.3.0-release.md

@@ -0,0 +1,122 @@
+---
+slug: v0.3.0-release
+title: Atria v0.3.0 Released - Embedded Video Conferencing with Jitsi
+authors: [steven]
+tags: [release, announcement, streaming, video, jitsi]
+---
+
+We're excited to announce **Atria v0.3.0**, bringing embedded video conferencing to your events with Jitsi (JaaS) integration! This release also adds flexible external platform linking, bringing Atria's total streaming options to five platforms.
+
+<!-- truncate -->
+
+## What's New in v0.3.0
+
+### Added
+
+**Jitsi (JaaS) Integration**
+- Embedded video conferencing directly within Atria - the only platform that keeps attendees fully in your event experience
+- BYOA (Bring Your Own Account) model with JaaS credentials
+- Per-user JWT authentication with automatic token generation
+- Role-based moderator permissions tied to Atria event roles:
+  - **Admin/Organizer** = Moderator (recording, livestreaming, file upload, kick/mute)
+  - **Attendee/Speaker** = Participant (standard conferencing features)
+- Token expiration tied to session duration (+ 1 hour buffer)
+- Full two-way audio/video with screen sharing
+
+**External Platform Links ("Other")**
+- Link to any HTTPS streaming or meeting platform
+- Perfect for MS Teams, Google Meet, self-hosted Jitsi, or custom solutions
+- Simple setup - just paste the URL
+- Opens in a new tab with security attributes (noopener, noreferrer)
+
+**Organization JaaS Credential Management**
+- Secure storage for JaaS credentials (App ID, API Key ID, RSA Private Key)
+- Same Fernet encryption used for Mux credentials
+- Credentials never viewable after entry (must re-enter to update)
+- Owner/Admin-only access to sensitive credentials
+
+**New Documentation**
+- [Jitsi Meetings (JaaS) Guide](https://docs.atria.gg/docs/video-streaming/jitsi-meetings) - Setup, moderator permissions, and troubleshooting
+- [Other/External Links Guide](https://docs.atria.gg/docs/video-streaming/other-external) - Linking to any platform
+- Updated [Video Platforms Overview](https://docs.atria.gg/docs/video-streaming/platforms-overview) with 5-platform comparison
+- Updated [Organizations Guide](https://docs.atria.gg/docs/core-concepts/organizations) with JaaS credential setup
+
+### Changed
+
+**Data Model Updates**
+- Session model extended with Jitsi room name field
+- Organization model extended with encrypted JaaS credential fields (App ID, API Key, Private Key)
+- StreamingPlatform enum now includes JITSI and OTHER options
+
+**Content Security Policy**
+- Added Jitsi domains to CSP configuration: `*.8x8.vc`, `*.jitsi.net`
+- Pre-configured for embedded Jitsi iframe and media streams
+
+## Platform Highlights
+
+### Jitsi (JaaS)
+Embedded video conferencing that keeps attendees within Atria. The only option for two-way interactive sessions without leaving your event platform.
+
+**Use when:**
+- You want interactive workshops, Q&A, or team sessions
+- Keeping attendees in Atria matters for your event experience
+- You need role-based moderator controls (recording, livestreaming)
+- You prefer open-source conferencing technology
+
+**Key features:**
+- Per-user JWT tokens with automatic permission assignment
+- Moderators (Admin/Organizer) can record, livestream to YouTube, and manage participants
+- Recording costs approximately $0.01/minute through JaaS
+- No app required - runs in browser
+
+### Other/External
+Maximum flexibility - link to any HTTPS platform your organization uses.
+
+**Use when:**
+- Your team uses MS Teams, Google Meet, or other platforms
+- You have a self-hosted Jitsi instance (non-JaaS)
+- Different sessions need different external tools
+- You need to link to a custom or niche streaming solution
+
+## Platform Summary
+
+Atria now supports **5 streaming platforms** for every use case:
+
+| Platform | Embedding | Interaction | Best For |
+|----------|-----------|-------------|----------|
+| **Vimeo** | Embedded | One-way (watch) | Pre-recorded content, Vimeo Live |
+| **Mux** | Embedded | One-way (watch) | Professional streaming with analytics |
+| **Zoom** | External | Two-way | Zoom users, large meetings |
+| **Jitsi** | Embedded | Two-way | Workshops, staying in-platform |
+| **Other** | External | Varies | MS Teams, Google Meet, any URL |
+
+## Migration Notes
+
+**For Existing Installations:**
+
+1. **JaaS credentials (if using Jitsi):**
+   - Sign up at [jaas.8x8.vc](https://jaas.8x8.vc)
+   - Add credentials in Organization Settings
+   - Uses same `ENCRYPTION_KEY` from v0.2.0 (no new env vars needed)
+
+2. **Content Security Policy:**
+   - Jitsi domains are pre-configured in `frontend/csp-header.conf`
+   - If you customized CSP, add: `*.8x8.vc`, `*.jitsi.net`
+
+3. **Database migrations:**
+   - Automatic migrations add new fields on first startup
+   - No data loss - existing sessions unaffected
+
+**No breaking changes** - existing deployments upgrade seamlessly.
+
+## Try Atria Today
+
+Visit [atria.gg](https://atria.gg) to try the platform with all five streaming options, or check out the [installation guide](https://docs.atria.gg/docs/getting-started/installation) to self-host your own instance.
+
+**Links:**
+- [Video Platforms Documentation](https://docs.atria.gg/docs/video-streaming/platforms-overview)
+- [Jitsi Meetings Guide](https://docs.atria.gg/docs/video-streaming/jitsi-meetings)
+- [Full Documentation](https://docs.atria.gg)
+- [GitHub Repository](https://github.com/thesubtleties/atria)
+- [API Reference](https://docs.atria.gg/docs/api/atria-api)
+- [Changelog](https://github.com/thesubtleties/atria/blob/main/CHANGELOG.md)

docs/core-concepts/organizations.md

@@ -184,13 +184,27 @@ To remove someone from your organization:
 
 ## Organization Settings
 
-### Updating Organization Details
+Organization settings are accessed through the **collapsible header panel** on your organization page.
 
-To update your organization information:
+### Accessing Settings
 
-1. Go to **Organization → Settings**
-2. Update the organization name
-3. Click **"Save Changes"**
+1. Go to your **Organization Dashboard**
+2. Look for the **dropdown chevron** (▼) in the header area next to your organization name
+3. Click the chevron to expand the settings panel
+4. You'll see cards for:
+   - **Organization Name** - Edit your organization's display name
+   - **Mux Video Signing** - Configure Mux streaming credentials
+   - **Jitsi Video Conferencing (JaaS)** - Configure Jitsi meeting credentials
+
+### Updating Organization Name
+
+To change your organization's name:
+
+1. Expand the settings panel (click the chevron in the header)
+2. Find the **Organization Name** card
+3. Click **"Edit Name"**
+4. Enter the new name
+5. Click **"Save Name"**
 
 :::info Future Settings
 Additional organization settings (logo, description, custom branding) are coming soon!
@@ -238,16 +252,14 @@ Log into your [Mux Dashboard](https://dashboard.mux.com):
 
 **Step 2: Add Credentials to Atria**
 
-1. Go to your **Organization Settings** in Atria
-2. Scroll to **Mux Streaming Credentials** section
-3. Click to expand the section
-4. Enter the required signing key:
+1. Go to your **Organization Dashboard**
+2. Click the **dropdown chevron** (▼) in the header to expand settings
+3. Find the **Mux Video Signing** card
+4. Click **"Add Credentials"** (or **"Update Credentials"** if already configured)
+5. Enter the required signing key:
    - **Mux Signing Key ID** (required)
    - **Mux Signing Private Key** (required)
-5. Optionally enter token credentials:
-   - **Mux Token ID** (optional)
-   - **Mux Token Secret** (optional)
-6. Click **Save Credentials**
+6. Click **"Save Credentials"**
 
 ### Security
 
@@ -306,11 +318,151 @@ Log into your [Mux Dashboard](https://dashboard.mux.com):
 ### Learn More
 
 - [Mux Streaming Guide](../video-streaming/mux-streaming) - Complete Mux integration documentation
-- [Streaming Overview](../video-streaming/streaming-overview) - Compare all streaming platforms
+- [Video Platforms Overview](../video-streaming/platforms-overview) - Compare all platforms
 - [Mux Documentation](https://docs.mux.com/) - Official Mux docs
 
 ---
 
+## Jitsi (JaaS) Credentials
+
+If you plan to use [Jitsi embedded conferencing](../video-streaming/jitsi-meetings) for interactive video sessions, you'll need to configure your organization's JaaS (Jitsi as a Service) credentials.
+
+### What is Jitsi (JaaS)?
+
+Jitsi as a Service (JaaS) provides:
+- **Embedded video conferencing** - Meetings embedded directly in Atria (unlike Zoom)
+- **Per-user authentication** - Unique JWT tokens for each attendee
+- **Role-based moderator controls** - Admins/Organizers get recording and livestreaming capabilities
+- **Bring Your Own Account (BYOA)** - Use your own JaaS account and credentials
+
+:::note When Do You Need This?
+You only need JaaS credentials if you plan to use **Jitsi** for embedded conferencing. Vimeo, Mux, Zoom, and Other don't require JaaS credentials.
+:::
+
+### Setting Up JaaS Credentials
+
+**Prerequisites:**
+- A JaaS account at [jaas.8x8.vc](https://jaas.8x8.vc)
+- Organization Owner or Admin role in Atria
+
+**Step 1: Get Your JaaS Credentials**
+
+Log into your [JaaS Dashboard](https://jaas.8x8.vc):
+
+1. **Get your App ID:**
+   - Found on your JaaS dashboard
+   - Format: `vpaas-magic-cookie-xxxxxxxxxxxxx`
+   - This is your JaaS application identifier
+
+2. **Get your API Key ID:**
+   - Go to **API Keys** section
+   - Create a new API key or select existing
+   - Copy the **Key ID** (this is the "kid" for JWT tokens)
+
+3. **Get your Private Key:**
+   - When creating an API key, download the RSA private key
+   - This is a PEM-encoded file starting with `-----BEGIN RSA PRIVATE KEY-----`
+   - Save it securely - you can't retrieve it later!
+
+**Step 2: Add Credentials to Atria**
+
+1. Go to your **Organization Dashboard**
+2. Click the **dropdown chevron** (▼) in the header to expand settings
+3. Find the **Jitsi Video Conferencing (JaaS)** card
+4. Click **"Add Credentials"** (or **"Update Credentials"** if already configured)
+5. Enter your credentials:
+   - **JaaS App ID** (required) - Format: `vpaas-magic-cookie-xxxxx...`
+   - **JaaS API Key** (required) - Your API Key ID
+   - **JaaS Private Key (PEM format)** (required) - Paste the complete RSA private key
+6. Click **"Save Credentials"**
+
+### Security
+
+**Credential Encryption:**
+- All JaaS credentials are encrypted using Fernet encryption before storage
+- Encryption uses the `ENCRYPTION_KEY` configured during installation
+- Private key is only decrypted when generating JWT tokens
+
+**Access Control:**
+- Only organization Owners and Admins can access the credentials section
+- **Credentials are NEVER viewable after entry** - they're immediately encrypted
+- To update credentials, you must enter new values (can't retrieve old ones)
+- Credentials are never exposed to regular members or attendees
+- Each organization has separate, isolated credentials
+
+### Managing Credentials
+
+**Updating Credentials:**
+- You can update any or all credential fields at any time
+- Changes take effect immediately for new token generation
+- Existing active sessions will continue working until tokens expire
+
+**Deleting Credentials:**
+- Click **Delete Credentials** to remove all JaaS credentials
+- This will prevent creating new sessions with Jitsi
+- Existing Jitsi sessions may stop working
+- To restore access, you must re-enter your JaaS credentials
+
+**Testing Your Setup:**
+1. After saving credentials, create a test session
+2. Select Jitsi as the streaming platform
+3. Enter a room name
+4. View the session page - Jitsi meeting should embed
+5. Verify moderators get appropriate controls
+
+### Moderator Permissions
+
+JaaS tokens include feature permissions based on Atria event roles:
+
+**Moderators (Admin/Organizer):**
+- Recording (costs via JaaS billing)
+- Livestreaming to external platforms
+- File upload in Jitsi chat
+- Full participant management
+
+**Participants (Attendees, Speakers):**
+- Standard video/audio participation
+- View participant list
+- No recording or livestreaming access
+
+### Troubleshooting
+
+**"Invalid token" error:**
+- Double-check all credential fields are filled in correctly
+- Verify private key includes full PEM content (including headers)
+- Ensure API key is active in your JaaS dashboard
+- Try regenerating credentials in JaaS and re-entering them
+
+**Meeting not loading:**
+- Verify organization has JaaS credentials configured
+- Check room name is entered (minimum 3 characters)
+- Ensure "Jitsi" is selected as streaming platform
+- Check browser console for CSP or loading errors
+
+**No moderator controls:**
+- Verify you have Admin or Organizer role in the event
+- Refresh page to get new token with current permissions
+- Moderator status is determined when token is generated
+
+### JaaS Costs
+
+JaaS has usage-based pricing. Key costs:
+- **Video conferencing** - Free tier available
+- **Recording** - Approximately $0.01/minute
+- **Livestreaming** - Standard streaming costs
+
+Only moderators can initiate recordings, protecting against unexpected costs.
+
+**View pricing:** [jaas.8x8.vc](https://jaas.8x8.vc/#pricing)
+
+### Learn More
+
+- [Jitsi Meetings (JaaS) Guide](../video-streaming/jitsi-meetings) - Complete Jitsi integration documentation
+- [Video Platforms Overview](../video-streaming/platforms-overview) - Compare all platforms
+- [JaaS Documentation](https://developer.8x8.com/jaas/) - Official JaaS docs
+
+---
+
 ## Cross-Organization Events
 
 Atria's multi-tenant architecture provides powerful collaboration features: