Skip to main content

ɳChat Bundle

ɳChat Bundle — ɳSelf documentation.

The ɳChat Bundle enables the full feature set of the ɳChat open-source messaging app. Without it, the app runs with core messaging only. With it, you get video calls, call recording, moderation tools, bots, enhanced real-time presence, and advanced auth.

Price: $0.99/mo ($9.99/yr) or included with ɳSelf+ at $3.99/mo ($39.99/yr).

Plugins Included

Plugin What It enables
chat Channel types (public, private, DM), typing indicators, read receipts, reactions, threads
livekit Video and audio calls via LiveKit WebRTC
recording Call recording and playback
moderation Content filtering, user reports, admin actions, auto-filter
bots Bot framework for automated responses and slash-command integrations
realtime Enhanced WebSocket support for presence and live updates
auth Advanced auth features: SSO, SAML, LDAP

Activation

# 1. Set your license key (one-time per server)
nself license set nself_pro_xxxxxxxxxxxxxxxxxxxxxxxx

# 2. Install all nChat bundle plugins
nself plugin install chat livekit recording moderation bots realtime auth

# 3. Rebuild and start the stack
nself build && nself start

After nself start, the plugins are live. Restart the ɳChat Next.js frontend to pick up the new env vars (especially NEXT_PUBLIC_LIVEKIT_URL).

What Changes After Activation

Without bundle (free)

  • Core messaging: channels, DMs, threads, reactions, file sharing, search
  • RBAC: owner, admin, moderator, member, guest roles
  • Web platform (Next.js), mobile shells (Capacitor), desktop shells (Electron/Tauri)

With ɳChat Bundle

  • Video and audio calls in channels and DMs (LiveKit)
  • Call recording and playback archive
  • Advanced content moderation with auto-filter rules
  • Bot framework with slash commands and webhook integrations
  • SSO, SAML, and LDAP login (auth plugin)
  • Enhanced presence indicators and typing status at scale (realtime plugin)

Environment Variables Set by the Bundle

The bundle plugins expose these env vars (set automatically by nself build):

Env Var Plugin Purpose
LIVEKIT_URL livekit LiveKit server WebSocket URL
LIVEKIT_API_KEY livekit API key for token generation
LIVEKIT_API_SECRET livekit API secret for token generation
NEXT_PUBLIC_LIVEKIT_URL livekit Client-side feature detection flag
CHAT_MODERATION_ENABLED moderation Enables auto-filter and report queue
BOTS_WEBHOOK_SECRET bots Shared secret for bot webhook verification
AUTH_SSO_ENABLED auth Enables SSO/SAML/LDAP login options

Deactivation

If your license expires or is revoked, the plugins go dormant on the next nself build. The ɳChat app detects missing env vars at runtime and hides the affected UI (video call buttons disappear, bot commands are removed from the command palette). Core messaging continues uninterrupted.