Skip to main content

​
What is Fluxer?

Fluxer is a free and open-source instant messaging and VoIP platform designed for friends, groups, and communities. Built with modern technologies and self-hosting in mind, Fluxer gives you complete control over your communications infrastructure.

Real-Time Messaging

Send messages with typing indicators, reactions, threaded replies, and rich embeds

Voice & Video

High-quality calls powered by LiveKit with screen sharing support

Communities & Channels

Organize conversations with text and voice channels, categories, and permissions

Self-Hostable

Deploy your own instance with full control and no vendor lock-in

​
Who is Fluxer For?

Fluxer is designed for multiple audiences:
Build bots and integrations using the comprehensive REST API and WebSocket Gateway. Fluxer provides:
  • Bot accounts with OAuth2 applications
  • WebSocket Gateway for real-time events
  • REST API for all platform operations
  • Webhooks for receiving events via HTTP
  • OAuth2 provider for “Sign in with Fluxer”
Perfect for creating chatbots, moderation tools, analytics dashboards, and custom integrations.

​
Key Features

​
Real-Time Communication

Fluxer’s WebSocket Gateway provides sub-second message delivery with:
  • Typing indicators and presence updates
  • Message reactions and threaded conversations
  • Read receipts and delivery confirmation
  • Live voice and video channels

​
Rich Media Support

  • Link previews with automatic metadata extraction
  • Image and video attachments with proxy and CDN support
  • GIF search powered by KLIPY integration
  • File uploads with virus scanning (ClamAV)

​
Developer Platform

Build on Fluxer with comprehensive APIs: 
// Example: Send a message via REST API
const response = await fetch('https://api.fluxer.app/api/v1/channels/123/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bot YOUR_BOT_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Hello from my bot!'
  })
});
All API requests require authentication. See Authentication to learn about bot tokens, OAuth2, and user tokens.

​
Privacy & Security

  • Multi-factor authentication (TOTP, SMS, WebAuthn)
  • Rate limiting to prevent abuse
  • CAPTCHA protection on registration and login
  • Audit logs for administrative actions
  • IP authorization for suspicious login attempts

​
Architecture Overview

Fluxer is built as a microservices platform:
1

API Server

Node.js + Hono web framework handling REST API requests
2

Gateway

Erlang/OTP WebSocket server for real-time message routing and presence
3

Database

SQLite for single-server deployments or Cassandra for distributed scaling
4

Media Proxy

Secure image/video proxy with caching and transformation
5

LiveKit

WebRTC SFU for voice and video calls

​
Tech Stack Highlights

  • Backend: TypeScript, Node.js, Hono, Erlang/OTP
  • Frontend: React, Electron (desktop), Rust/WASM for performance-critical code
  • Storage: SQLite (default) or Cassandra (distributed)
  • Search: Meilisearch for full-text search
  • Cache: Valkey (Redis-compatible)
  • Voice/Video: LiveKit WebRTC SFU

​
Getting Started Paths

Choose your journey:

Build a Bot

Create your first bot in 5 minutes and make API calls

Self-Host Fluxer

Deploy your own instance with Docker Compose

Explore the API

Browse all REST API endpoints and resources

Connect to Gateway

Receive real-time events via WebSocket

​
Open Source & Licensing

Fluxer is licensed under the GNU Affero General Public License v3 (AGPLv3):
  • Free to use, modify, and distribute
  • Network use requires sharing modifications
  • Self-hosting unlocks all features at no cost
  • Commercial licensing available for closed-source deployments
View the full source code on GitHub and contribute to the project.

​
Community & Support

​
What’s Next?

Ready to start building on Fluxer?
  1. Quickstart Guide - Create a bot and make your first API call
  2. Authentication - Learn about bot tokens, OAuth2, and user sessions
  3. API Reference - Explore all available endpoints
  4. Self-Hosting - Deploy your own instance

Build docs developers (and LLMs) love

Get started for freeTalk to us