Flarum 2.0.0-rc.3 Released - Built by the Community, Almost Ready for Everyone

IanM · 2026-06-09T18:57:19+00:00

Flarum 2.0.0-rc.3 Released 🎉 — and 2.0 is almost here This is the one we've been working toward for years. Flarum 2.0 is no longer on the horizon — it's right in front of us. Today we're shipping 2.0.0-rc.3, and with each release candidate the picture gets clearer: real forums, running real communities, on 2.0 today, with more upgrading every single day. rc.3 is a fast, focused follow-up to rc.2 — 10 merged PRs just a week later — but the bigger story is the momentum behind it. The release-candidate series is doing exactly what it's meant to do: people are running 2.0 in production, telling us what they find, and we're turning fixes around in days. The bug reports are getting rarer and the edges are getting smoother. That's what the road to a stable 2.0 looks like, and we're nearly at the end of it. 🚀 Production-ready for early adopters — and people are already there. The upgrade from rc.2 is a plain composer update. Back up your database, test on staging if you can, keep a rollback plan — the usual. 👀 This forum runs it. discuss.flarum.org is on rc.3. So is the nightly demo, rebuilt daily from the latest 2.x code. You're looking at 2.0 right now. 💬 Already upgraded? Tell us. Drop a note inSupport — every "running it in prod, all good" report builds confidence for the next forum about to take the leap. 🧭 Where we are — the last mile We're in the final stretch. The release-candidate promise still holds, and every point of it is now battle-tested in production: The API is frozen — for real, proven by real extensions. An extension built against rc.1 or rc.2 works unchanged on rc.3 and will work on 2.0.0 final. Extension authors: now is the time to ship your 2.0-compatible releases. The upgrade path is clean. rc.2 → rc.3 → 2.0.0 is composer update the whole way. The forums upgrading daily are proof. Regressions go to the top of the pile — and there are fewer of them every cycle. rc.3 is a maintenance and hardening release: a couple of small new diagnostics, otherwise real-world rough edges sanded down. The fast turnaround is the whole point — when you report something, we'd rather ship the fix in a week than sit on it. Every report you send moves 2.0 final closer. Keep them coming. Where to report: Bugs in core — flarum/frameworkissues General feedback, questions, extension behaviour —Support Security issues — security@flarum.org (please don't post publicly) 🛠️ What changed in rc.3 🗄️ Database & queue robustness The headline of this cycle is making Flarum fail loudly and early instead of mysteriously: Database driver/server mismatches are now detected and surfaced. Since 2.x, Flarum treats MariaDB and MySQL as distinct drivers with their own connection classes and query grammars — they are not interchangeable. A misconfigured driver against the wrong server was behind a whole class of "some queries just fail" reports; Flarum now spots the mismatch and tells you, rather than letting it manifest as random query errors. The full Queue Pause/Resume surface is stubbed on QueueFactory. Flarum hands its QueueFactory to Illuminate's worker in the role normally filled by the full QueueManager, but the Factory contract only guarantees connection(). The missing methods the worker and queue commands reach for are now stubbed, so queue tooling doesn't blow up on a method that was never there. The queue worker no longer crashes on a null connection name. illuminate/queue 13.15 tightened the type on its WorkerIdle event to require a string connection name; Flarum never set one, so the worker threw a TypeError on every idle tick. Flarum now names its queue connection, which keeps the worker happy across Illuminate releases — the same "a dependency bump shouldn't be able to crash the worker" hardening as the stub above. 🚦 Error handling Forum error handling now does content negotiation — errors are rendered in the format the client actually asked for, instead of assuming one. 📱 Frontend & mobile polish The user count and list refresh after creating a user in admin, so the new account shows up without a manual reload. The post divider is no longer lopsided on mobile. Emoji reserve a square box (img.emoji), eliminating the layout shift (CLS) that nudged text around as emoji loaded. Mentions in a post now align with the rest of the text instead of sitting slightly off the baseline. 🧩 Extension compatibility Tags and Sticky no longer fail to initialize alongside Realtime. With both enabled you could hit flarum-tags failed to initialize / TypeError: mt(...) is not a constructor. The cause was load order: Realtime registers a JS extender that Tags and Sticky consume, but they weren't guaranteed to load after it. Declaring Realtime as an optional dependency fixes the ordering — caught from a community bug report, exactly the kind the RC series is for. ⚡ Performance N+1 group_user queries are gone when serializing users — group membership is now loaded in bulk instead of per-user, a meaningful win on any list of accounts. 💙 This is a community release Here's the part we're proudest of: most of rc.3 was written by the community, not the core team. Five of the ten PRs this cycle came from contributors outside the core — people who hit something, fixed it, and sent it back upstream. That's not a footnote; that's the whole point of Flarum, and it's exactly the energy that carries a project across the finish line to a major release. If you've ever thought about contributing, this is the moment. 2.0 is being built in the open, in real time, by people like you. Every PR, every bug report, every "I upgraded and here's what happened" makes the final release better. Contributors this cycle: @datitisev — content negotiation for forum error handling #4677, mention alignment #4692 @davetodave178 — refresh user count and list after user creation #4687 @Karl — lopsided post divider on mobile #4691 @IanM — database mismatch detection, queue surface stub, queue worker connection-name fix, emoji CLS, the N+1 fix, and the Realtime load-order fix 🚀 Be part of it The best thing you can do for 2.0 right now is run it. Every forum that upgrades is one more real-world proving ground, and one more vote of confidence for the next person on the fence. See it live — nightly.flarum.site, rebuilt daily, and right here on discuss.flarum.org Upgrade your install — composer update -W, then php flarum migrate, php flarum cache:clear, and php flarum assets:publish (back up first, and test on staging if you can) Then come back and tell us — what worked, what didn't, what you'd want in 2.0 final We're close. Let's bring 2.0 home together. 💪 📋 Changelog Added (core) detect and surface a database driver/server mismatch (e.g. MariaDB vs MySQL) by @IanM #4682 (core) content negotiation for forum error handling by @datitisev #4677 Fixed (core) refresh the user count and list after user creation by @davetodave178 #4687 (core) lopsided post divider on mobile by @Karl #4691 (core) stub the full Queue Pause/Resume surface on QueueFactory by @IanM #4683 (core) queue worker TypeError on a null connection name with illuminate/queue 13.15+ by @IanM #4700 (mentions) align mentions in post with the rest of the text by @datitisev #4692 (emoji) reserve a square box for img.emoji to avoid layout shift (CLS) by @IanM #4685 (tags, sticky) declare flarum/realtime as an optional dependency so the realtime extender loads before its consumers, fixing TypeError: mt(...) is not a constructor by @IanM #4699 Performance (core) fix N+1 group_user queries when serializing users by @IanM #4696

DaleZ

IanM Microsoft Edge team is trying to add Web Haptics API. It's currently a draft, but worth to take a look. (a future plan, after all...)
w3c/csswg-drafts13728
MicrosoftEdge/MSEdgeExplainersblob/main/Haptics/explainer.md

TOWUK

I'm sorry that it might be off topic, but is that how it should be when clicking on the split discussion text?

IanM

TOWUK no, not at all. This is a bug in fof/split - will get that resolved as soon as I can.

Thanks for reporting 🙂

Karl

IanM the posts were sporadically spread between relevant posts. I had to split one by one because they were not within splitting reach of one another.

IanM

Karl for that sort of operation, fof/move-posts is generally better. Not that this isn't a problem, it still need fixing.

I'll add move-posts to discuss during the next deployment...

Karl

IanM unless it's behind a permission block, because I don't have that option lol.

IanM

Karl it's not installed here at the moment 😉

Karl

IanM ever work in sales? 😛

IanM

Karl I couldn't sell an ice cream to a man in the desert! lol

Karl

IanM well sir, you just sold me on fof/move-posts lol. 😃
I'm trying to find something I don't like with the new release, and I'm still empty handed. You've done a great job getting it here!

Edit: maybe the notification banners are a little iffy? Think I saw an issue already published about it though. So onto being happy 😛

IanM

Karl the realtime banner notifications? I keep thinking they're showing me old notifications, but again, so little sleep I could be imaging it.

I don't recall seeing an issue tho, can you please point me at it?

Karl

IanM I think it sometimes shows an old notification. I wonder if the behavior is due to the fact the site was not in the foreground originally when the first notification was issued? And then subsequent notifications are causing that stale one to trigger in display? Will have to do some more digging.
And honestly, I may have imagined an issue up then. I've been running on no sleep this entire week. Will follow up with a clearer mind soon.

IanM

Karl now installed and permissions granted to @Moderators

CyberGene

IanM I've also noticed realtime toast sometimes showing me old notifications and acting a bit odd.

So, since I have Claude Code Max account for a month, and since I noticed the newest Fable 5 model is a real beast finding issues where Opus struggles, I asked it to see if it can find what the issue is and it found something, also opened a PR:

flarum/framework4714

Whether it's real, I don't know, it could reproduce it on my local Docker. Take it for what it is 🙂

IanM

CyberGene looks like we were both working on this at the same time, I have a similar fix in flarum/framework4713

My fix has also uncovered another issue, which I'm currently working on, so I'll stick with my one if you don't mind. But thanks for taking a look!

CyberGene

IanM My fix has also uncovered another issue, which I'm currently working on, so I'll stick with my one if you don't mind. But thanks for taking a look!

Sure, go ahead, mine was just Claude automatically opening an issue and suggesting a PR, I wasn't even sure if it was right, I've learned not to trust AI blindly nowadays 🙂

IanM

CyberGene I've learned not to trust AI blindly nowadays

These are very wise words, and music to my ears! 🎶

tearofs

The installation links don't work on https://docs.flarum.org/2.x/install

Also, is there an easier way to upgrade from 1.8.x? I failed a few time.

How soon could we expect 2.0 appear on 1panel?

Thanks

GreXXL

tearofs The installation links don't work on https://docs.flarum.org/2.x/install

Those will only be available for the final build of 2.0.

tearofs Also, is there an easier way to upgrade from 1.8.x? I failed a few time.

Best you open a separate discussion inSupport and let us know where you got problems.

tearofs How soon could we expect 2.0 appear on 1panel?

Are you using Softaculous? If so we don't have control over when they release something on their platform.

« Previous Page