Self-hosted service
fluxerapp/fluxer avatar
fluxerapp/fluxer

Fluxer: a self-hosted messaging and VoIP stack under AGPL-3.0

A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.

10,290 stars755 forksTypeScriptAGPL-3.0

At a glance

What is it?
Fluxer is a free and open source instant messaging and VoIP app aimed at friends, groups, and communities. This review covers what the repository actually contains, how the components fit together, and what you should verify before adopting it.
Who is it for?
Fluxer suits small groups and communities that want a self-hosted chat and VoIP stack under AGPL-3.0, with the ability to run the proxy and API yourself. It is not for teams that need a mature, battle-tested platform with extensive documentation, since the README is minimal and the project is early.
Can I use it commercially?
Yes, with strict conditions. AGPL-3.0 is a network copyleft licence: if people use a modified version over a network, for example as a hosted service, you must offer them its source code under the same licence.
Is it still maintained?
Yes. The repository last received commits 1 day ago.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 14, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What Fluxer is and who it targets

Fluxer is described in its README as a free and open source instant messaging and VoIP chat app built for friends, groups, and communities. That is the entire pitch. The repository is written in TypeScript, licensed under AGPL-3.0, and is not archived, with recent pushes and releases as of late August 2026. The target audience is clear: people who want to run their own chat service for a circle of people, not a large enterprise. The description does not mention scale, federation, or mobile clients, so you should treat it as a small-scale tool until proven otherwise.

The repository layout: three components, one repo

The release names give the clearest picture of the architecture. There is fluxer-api, which is the backend, and fluxer-app-proxy, which is a proxy component. There is also a self-hosted variant of the proxy, fluxer-app-proxy-self-hosted. The README itself is nearly empty, containing only branding and a link to the documentation site at docs.fluxer.app. That means the actual mechanics have to be inferred from the package names and the release schedule. The proxy likely sits between clients and the API, handling WebSocket or HTTP traffic, while the API handles message storage, user accounts, and call signaling. The existence of a self-hosted proxy suggests that the default proxy is hosted by the project, and self-hosting is an option for those who want full control.

Getting it running: what the material actually shows

The README contains no installation instructions. The only concrete path is the homepage link to the operator documentation, which is not included in the provided material. From the repository, you can see that there are separate packages for the API and the proxy, and the self-hosted proxy is a distinct release artifact. A typical self-hosting workflow would involve pulling the fluxer-api and fluxer-app-proxy-self-hosted packages, configuring them, and pointing your clients at the proxy. But none of that is documented in the README. You would have to visit the documentation site to get real commands and config keys. That is a genuine gap: the repository alone is not enough to deploy Fluxer.

AGPL-3.0: what it means for adopters

The license is AGPL-3.0, which is a strong copyleft license. If you modify the source and run it as a network service, you must make your modifications available to users. That is a real consideration for anyone who plans to fork Fluxer or add proprietary features. For a community chat app, this is often acceptable, but it is a boundary. The README does not include a contributor license agreement or any clarification on how the project handles contributions. If you are a company evaluating Fluxer, you should read the license text carefully. The LICENSE file is referenced in the README, but its contents are not in the provided material, so I cannot confirm any additional terms.

A real limitation: thin documentation and no evidence of maturity

The most obvious limitation is the lack of documentation in the repository. The README is a few lines long, with no architecture diagram, no quickstart, no config examples. The releases are versioned like 2026.829.14014, which suggests a date-based versioning scheme, but that says nothing about stability. There are no test results, no CI badges, and no usage statistics in the README. You cannot tell from the repository whether the VoIP features actually work, whether calls are peer-to-peer or relayed, or whether the proxy is required for all traffic. This is a case where the project might be perfectly functional, but the repository gives you no way to verify that without external exploration. For a production deployment, that is a serious risk.

Alternative approaches: Matrix and XMPP

The obvious alternative is Matrix, which is also open source and offers messaging and VoIP through WebRTC. Matrix uses a federated server model, with the Synapse server as the reference implementation. The key difference is that Matrix has a well-defined protocol spec, a large ecosystem of clients, and extensive documentation. Fluxer appears to be a single monolithic project with its own protocol, which may be simpler but also more isolated. Another alternative is XMPP, which has been around for decades and supports VoIP via Jingle. XMPP is decentralized and has many server implementations like Prosody and ejabberd. The difference in approach is that Matrix and XMPP are open standards with multiple implementations, whereas Fluxer is a single project with a central repository. If you value interoperability and long-term stability, those standards are safer bets.

Maintenance and upgrade cost

The release history shows active development, with three releases on the same day in August 2026. That suggests a project that is being maintained, but it also means the API may change frequently. The date-based versioning (2026.829.14014) implies that releases are tied to specific dates, which could mean rolling updates rather than semantic versioning. For an adopter, that means you should expect to track releases closely and test upgrades. The self-hosted proxy is a separate package, so you have to update it independently of the API. There is no mention of database migrations or upgrade scripts in the README, so you would have to rely on the documentation site or the source code to understand the upgrade path. The cost of maintenance is not trivial: you are running at least two services, and you need to monitor both.

Editorial conclusion

Fluxer suits small groups and communities that want a self-hosted chat and VoIP stack under AGPL-3.0, with the ability to run the proxy and API yourself. It is not for teams that need a mature, battle-tested platform with extensive documentation, since the README is minimal and the project is early. Before adopting it, verify the current state of the API and proxy packages, check the AGPL obligations for your use case, and confirm that the VoIP features actually work in your network environment, as the repository gives no evidence of testing or deployment specifics.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Community notes

Community notes