Files
reflector/docs/docs/concepts/modes.md
Igor Monadical 407c15299f docs: docs website + installation (#778)
* feat: WIP doc (vibe started and iterated)

* install from scratch docs

* caddyfile.example

* gitignore

* authentik script

* authentik script

* authentik script

* llm doc

* authentik ongoing

* more daily setup logs

* doc website

* gpu self hosted setup guide (no-mistakes)

* doc review round

* doc review round

* doc review round

* update doc site sidebars

* feat(docs): add mermaid diagram support

* docs polishing

* live pipeline doc

* move pipeline dev docs to dev docs location

* doc pr review iteration

* dockerfile healthcheck

* docs/pr-comments

* remove jwt comment

* llm suggestion

* pr comments

* pr comments

* document auto migrations

* cleanup docs

---------

Co-authored-by: Mathieu Virbel <mat@meltingrocks.com>
Co-authored-by: Igor Loskutov <igor.loskutoff@gmail.com>
2026-01-06 17:25:02 -05:00

3.0 KiB

sidebar_position, title
sidebar_position title
2 Operating Modes

Operating Modes

Reflector operates in two distinct modes to accommodate different use cases and security requirements.

Public Mode

Public mode provides immediate access to core transcription features without requiring authentication.

Features Available

  • File Upload: Process audio files
  • Live Transcription: Stream audio from microphone
  • Basic Processing: Transcription and diarization
  • Temporary Storage: Temporary data retention (configurable)

Limitations

  • No persistent storage
  • No meeting rooms
  • Limited to single-user sessions
  • No team collaboration features

Use Cases

  • Quick transcription needs
  • Testing and evaluation
  • Individual users
  • Public demonstrations

Private Mode

Private mode unlocks the full potential of Reflector with authentication and persistent storage.

Additional Features

  • Virtual Meeting Rooms: Whereby and Daily.co integration
  • Team Collaboration: Share transcripts with team
  • Persistent Storage: Long-term transcript archive
  • Meeting History: Search and browse past transcripts
  • Custom Integration: Webhooks and API access
  • User Management: Role-based access control

Authentication Options

Authentik Integration

Enterprise-grade SSO with support for:

  • SAML 2.0
  • OAuth 2.0 / OIDC
  • LDAP / Active Directory
  • Multi-factor authentication

Room Management

Virtual rooms provide dedicated spaces for meetings:

  • Persistent URLs: Same link for recurring meetings
  • Access Control: Invite-only or open rooms
  • Recording Consent: Automatic consent management
  • Custom Settings: Per-room configuration

Mode Selection

The mode is determined by your deployment configuration:

# Public Mode (no authentication)
AUTH_BACKEND=none

# Private Mode (with authentication)
AUTH_BACKEND=jwt

See Authentication Setup for configuring JWT authentication.

Feature Comparison

Feature Public Mode Private Mode
File Upload
Live Transcription
Speaker Diarization
Summarization
Meeting Rooms
Persistent Storage
Team Collaboration
API Access Limited Full
User Management
Custom Branding
Meeting History
Webhooks

Security Considerations

Public Mode Security

  • File size restrictions
  • Automatic cleanup of old data

Private Mode Security

  • Access control lists
  • Data retention policies

Choosing the Right Mode

Choose Public Mode if:

  • You need quick, one-time transcriptions
  • You're evaluating Reflector
  • You don't need persistent storage
  • You're processing non-sensitive content

Choose Private Mode if:

  • You need team collaboration
  • You require persistent storage
  • You're processing sensitive content
  • You need meeting room functionality
  • You want searchable meeting history