- Screenshots
- Features
- Quick Start
- Technology Stack
- Support & Community
- Frequently Asked Questions
- Contributing
- License
- Star History
Light and dark modes side by side
| Group Chat | Themes & Customization |
|---|---|
 |
 |
| Multi-user chat with roles, reactions, and polls | 14 built-in themes, custom accents, and font settings |
- Reactions, Replies & Styling - Emoji reactions with quick toolbar, threaded replies, and rich text formatting (bold, italic, code blocks with syntax highlighting)
- Message Retraction & Moderation - Delete your own messages or moderate room messages with full audit trail
- Link Previews - Automatic Open Graph previews for shared URLs
- File Sharing - HTTP uploads with drag-and-drop, thumbnails, progress indicators, image lightbox, and text file preview
- Polls - Create polls in rooms with emoji voting, deadlines, single or multi-vote modes, and live result tallies
- Multi-user Chat - Complete MUC support with roles, affiliations, custom hats (role badges), @mentions, and bookmarks
- Quick Chat - Instantly create ad-hoc group conversations and invite contacts by name
- Per-User Ignore - Mute specific users per room, synced across devices
- Activity Log - Persistent feed of events: invitations, subscription requests, reactions, poll votes, joins and leaves
- Full-text Search - Instant offline search powered by an IndexedDB inverted index, supplemented by live server archive queries
- Find on Page - Cmd/Ctrl+F to search within the current conversation with highlight and scroll
- Smart Filters - Type filter pills,
in:prefix autocomplete, quoted exact-phrase matching, and keyboard-navigable results with context preview
- 14 Built-in Themes - Catppuccin, Nord, Dracula, Gruvbox, Tokyo Night, Rosé Pine, Solarized, and more — plus light/dark mode
- Custom Themes - Import/export themes as JSON, pick a custom accent color, or write CSS overrides in the built-in editor
- Synced Across Devices - Theme, accent, and font size preferences are stored server-side and follow you everywhere
- Internationalization - 31 languages including complete EU coverage
- Self-hostable - Connect to any XMPP server, no vendor lock-in, no third-party dependency
- FAST Authentication - Modern SASL2 with token-based reconnection for instant, password-less session resumption
- Contact Blocking - Full block/unblock support with a dedicated management screen
- In-Band Password Change - Change your account password without leaving the app
- Cross-platform - Available on the web, macOS (Intel & Apple Silicon), Windows, and Linux (deb, rpm, flatpak, AUR)
- Auto Updates - Built-in update checker with release notes and one-click install (desktop)
- Native Notifications - Desktop notifications with click-to-focus; web push notifications even when the tab is closed
- Auto-Away - Automatically sets your status to away on system idle and restores it on activity
- Offline Support - IndexedDB storage with automatic sync and stream management session resumption on reconnect
- Command Palette - Keyboard-accessible launcher for conversations, contacts, rooms, and actions
- Keyboard Shortcuts - Comprehensive shortcut system with a categorized help overlay and AZERTY support
- Built-in XMPP Console - Live stanza inspector and debug interface
- Server Administration - Manage users, rooms, and server commands right from the client (for admins)
- User Profiles - Rich user info popovers with vCard details, connected devices, timezone, and last seen status
- Headless SDK - Reusable
@fluux/sdkpackage for building custom XMPP clients or bots - 50+ XEPs Implemented - MAM, MUC, Stream Management, Message Carbons, HTTP File Upload, Reactions, FAST, and many more
- Open Source - AGPL-3.0 licensed
Get started with Fluux Messenger in a few simple steps:
Want to try it first? Head over to demo.fluux.io for an instant live demo, no installation needed.
-
Download the latest release for your platform from the releases page.
-
Install using the instructions for your platform below.
-
Connect to any XMPP server with your credentials and start chatting!
Windows (x64)
| Format | How to install |
|---|---|
.exe |
Run the setup wizard (recommended) |
.msi |
Run msiexec /i Fluux-Messenger_*_Windows_x64.msi or double-click to install |
macOS (Intel & Apple Silicon)
| Format | How to install |
|---|---|
.dmg |
Open the image and drag Fluux Messenger to Applications (recommended) |
.app.tar.gz |
Extract with tar xzf and move the .app to Applications |
Both x64 (Intel) and arm64 (Apple Silicon) builds are available.
Linux (x64 & arm64)
| Format | How to install |
|---|---|
.deb |
sudo dpkg -i Fluux-Messenger_*.deb (Debian, Ubuntu, Mint...) |
.rpm |
sudo rpm -i Fluux-Messenger_*.rpm (Fedora, RHEL, openSUSE...) |
.flatpak |
flatpak install Fluux-Messenger_*.flatpak |
.tar.gz |
Extract with tar xzf and run the binary directly |
Both x64 and arm64 builds are available for all formats.
Arch Linux users can install from the AUR: fluux-messenger
Web (self-hosted)
Download the fluux-messenger-*-web.zip asset from the releases page, extract it, and serve it with any web server of your choice (app must be served over HTTP). This also works as a PWA on mobile devices when served from your own domain.
Build from source
See the Developer Guide for instructions on building and running Fluux Messenger locally.
Need help? Check out our support options below.
- Frontend: React 18 + TypeScript
- Desktop: Tauri 2.x (Rust-based, lightweight)
- Styling: Tailwind CSS
- State Management: Zustand + XState
- Build System: Vite + Vitest
- XMPP: @xmpp/client + @fluux/sdk
- Storage: IndexedDB with idb
We have many ideas and exciting additions planned for Fluux Messenger! We welcome all questions, feedback, and bug reports.
- GitHub Issues - Use Issues to report bugs, request features, or track tasks. We use Issues as our lightweight roadmap for upcoming improvements and are always open to new ideas - don't hesitate to propose yours!
- GitHub Discussions - Use Discussions for questions, ideas, or general conversations that don't require formal tracking. Great for brainstorming, getting help without opening an Issue, or suggesting documentation improvements.
- XMPP Chatroom - Join fluux-messenger@conference.process-one.net for live chat with the community and maintainers.
Have suggestions for this FAQ? Feel free to ask questions or propose additions in our Q&A Discussions.
We aim to create an XMPP client that respects standards, but currently the project has been tested exclusively with ejabberd. We're eager to receive feedback on compatibility with other servers.
Yes. A pre-built static web bundle (-web.zip) is available on the releases page. Simply extract it and serve it with any web server.
Looking ahead, we also plan to make Fluux Messenger available on F-Droid, and possibly on the Google Play Store as well.
Yes, on the desktop app: it ships with a built-in WebSocket-to-TCP proxy. It first tries WebSocket (via XEP-0156 discovery), then falls back to TCP/TLS.
The web version requires WebSocket on your server, with CORS configured to allow the origin from which Fluux is served.
Not yet, but it's on our roadmap. We're currently prototyping OpenPGP support (see the openpgp branch if you're curious). OMEMO will probably come later: beyond the implementation work, it raises licensing questions we want to address properly. We're also watching MLS as an option for group chats.
We know it's important and we want to bring it. We can't commit to a timeline yet: there's real work to do on both the client and server side, especially for group calls which need a media-mixing SFU to be reliable.
Not yet. Read receipts are on our list and we plan to start with 1-to-1 chats. For group rooms we're still weighing the question: how useful they actually are at scale, how best to implement them and the privacy implications of broadcasting read state to every participant.
Not yet. Spaces (XEP-0503) have started to appear in the ecosystem (Movim has an experimental implementation) and we're watching how it evolves before committing to an approach.
Yes, translations are welcome. Locale files live under apps/fluux/src/i18n/locales/. See CONTRIBUTING.md for the general contribution workflow. Feel free to open an issue or discussion first if you have questions.
There's no formal roadmap document, but we track upcoming work through GitHub Milestones and Issues. Feel free to follow, comment or open a new issue for anything you'd like to see.
Yes. Two things can trigger warnings right now:
- Starting with 0.15, the Windows binary is temporarily not code-signed while we work through the signing infrastructure (see #290).
- The combination of Tauri and NSIS used to package the app is also a known source of antivirus false positives affecting many legitimate apps.
If you'd rather verify for yourself, you can always build the app from source.
Yes. By default, closing the main window minimizes Fluux to the system tray or menu bar so it can keep your XMPP session alive and deliver notifications. To fully exit, use the Quit entry from the tray menu.
For security, credentials are only kept in the session context. Nothing sensitive is persisted to local storage. If your XMPP server supports FAST authentication tokens (SASL2), reconnection across page reloads will work seamlessly, without ever storing your password. If it doesn't, your server likely doesn't yet support FAST.
Contributions are welcome! See CONTRIBUTING for detailed guidelines.
For getting started with development, you can check out our Developer Guide.
Fluux Messenger is licensed under the GNU Affero General Public License v3.0 or later. See LICENSE
Built with ❤️ by ProcessOne.