Skip to content

Commit 2dd7fd2

Browse files
Stensel8Stensel8
committed
docs: Update Brave browser section with performance insights and crash workarounds
1 parent 3950686 commit 2dd7fd2

2 files changed

Lines changed: 24 additions & 32 deletions

File tree

‎content/docs/getting-started.md‎

Lines changed: 12 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ The steps below are roughly in the order I set things up after a fresh Fedora 43
1313

1414
### Brave browser — RPM with Wayland workarounds
1515

16-
I use Brave as my main browser. I started with the Flatpak version but switched to the native RPM for better system integration. There's a catch though: Brave 1.82+ has three crash bugs on GNOME Wayland that need workarounds before it's actually stable. I don't fully understand why these crashes happen — they seem to involve GPU drivers and Wayland protocols that are apparently not playing well together — but the fixes below work for me.
16+
I use Brave as my main browser. I started with the Flatpak version but switched to the native RPM — according to people on Reddit, the RPM version feels more native and offers better performance and efficiency. There's a catch though: Brave 1.82+ has two crash bugs on GNOME Wayland that need workarounds before it's actually stable. I don't fully understand why these crashes happen — they seem to involve GPU drivers and Wayland protocols that are apparently not playing well together — but the fixes below work for me.
1717

18-
- **RPM (native):** Better performance and system integration. This is what I use.
18+
- **RPM (native):** More native feel, better performance and efficiency. This is what I use.
1919
- **Flatpak:** Might work better in some situations, but it feels a bit more isolated and slightly slower.
2020

2121
**RPM Installation**
2222

2323
{{< callout type="warning" >}}
24-
On Fedora with GNOME + Wayland, Brave 1.82+ has three known crash bugs that require workarounds. The first two are applied via the desktop entry; the third requires a setting in `brave://flags`.
24+
On Fedora with GNOME + Wayland, Brave 1.82+ has two known crash bugs that require workarounds. The first is applied via the desktop entry; the second requires a setting in `brave://flags`.
2525
{{< /callout >}}
2626

2727
```bash
@@ -32,25 +32,25 @@ sudo dnf install brave-browser
3232

3333
![Brave install instructions](/images/brave-install.avif)
3434

35-
**Workarounds 1 & 2: patch the desktop entry**
35+
**Workaround 1: patch the desktop entry**
3636

3737
Copy the system desktop entry to your user directory so it doesn't get overwritten by updates:
3838
```bash
3939
sudo cp /usr/share/applications/brave-browser.desktop ~/.local/share/applications/
4040
```
4141

42-
Patch all three `Exec=` lines with both flags:
42+
Patch all three `Exec=` lines with the flag:
4343
```bash
4444
sed -i \
45-
's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11 %U|' \
45+
's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 %U|' \
4646
~/.local/share/applications/brave-browser.desktop
4747

4848
sed -i \
49-
's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
49+
's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1|' \
5050
~/.local/share/applications/brave-browser.desktop
5151

5252
sed -i \
53-
's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
53+
's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1|' \
5454
~/.local/share/applications/brave-browser.desktop
5555
```
5656

@@ -59,20 +59,16 @@ Verify it worked — you should see exactly three `Exec=` lines:
5959
grep "^Exec" ~/.local/share/applications/brave-browser.desktop
6060
```
6161

62-
**What these flags actually do (as far as I understand it):**
62+
**What this flag actually does (as far as I understand it):**
6363

6464
`--disable-features=WaylandWpColorManagerV1` — Brave 1.82+ introduced some Wayland color management extension that apparently conflicts with the AMD amdgpu driver on Fedora + GNOME Wayland. Without this flag, Brave triggers GPU ring timeouts that crash the entire GNOME Shell session. I have no idea why a browser color management feature would take down the whole desktop, but here we are.
6565

66-
`--ozone-platform=x11` — This forces Brave to run via XWayland instead of native Wayland. It fixes a hard crash that happens when you try to open a Bitwarden attachment download. Apparently Brave tries to do something with a Wayland protocol in a way that's not valid, and it immediately crashes. Running via XWayland sidesteps the whole thing. You lose some native Wayland features like fractional scaling, but the browser actually stays open, which feels like a reasonable trade.
66+
**A note on `--ozone-platform=x11`:** I tried this flag as a workaround for a crash when opening or downloading Bitwarden attachments — Brave does something with a Wayland protocol in a way that's not valid and immediately crashes. Running via XWayland sidesteps that. It turned out to cause a worse problem though: gnome-shell crashing with `SIGABRT` (`g_assertion_message_expr` in `meta_window_unmanage`), triggered during Picture-in-Picture video while Brave was running via XWayland — the same underlying mutter crash documented in [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). That takes down the entire desktop session and requires a hard reboot. The flag is gone. Brave now runs on native Wayland. The Bitwarden attachment crash still exists, but a Brave crash is preferable to losing the whole session.
6767

68-
{{< callout type="info" >}}
69-
Always launch Brave from the GNOME dock or app launcher — not from the terminal. When you launch it from a terminal inside a Wayland session, the terminal's environment overrides the `--ozone-platform=x11` flag and Brave falls back to native Wayland, bringing all the crashes back.
70-
{{< /callout >}}
71-
72-
**Third workaround: disable hardware video decode in `brave://flags`**
68+
**Second workaround: disable hardware video decode in `brave://flags`**
7369

7470
{{< callout type="warning" >}}
75-
Hardware video decode still causes crashes even with the two flags above. As long as the AMD VCN decoder is active, GNOME Shell crashes with SIGABRT (`g_assertion_message_expr`) — reproducible during Picture-in-Picture video and intensive video activity. See [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **not yet stable** on the AMD Radeon 890M with GNOME Wayland.
71+
Hardware video decode still causes crashes even with the flag above. As long as the AMD VCN decoder is active, GNOME Shell crashes with SIGABRT (`g_assertion_message_expr`) — reproducible during Picture-in-Picture video and intensive video activity. See [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **not yet stable** on the AMD Radeon 890M with GNOME Wayland.
7672
{{< /callout >}}
7773

7874
Go to `brave://flags` and disable:

‎content/docs/getting-started.nl.md‎

Lines changed: 12 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ De stappen hieronder zijn in grote lijnen de volgorde waarop ik dingen heb opgez
1313

1414
### Brave browser — RPM met Wayland-workarounds
1515

16-
Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar de native RPM voor betere systeemintegratie. Er is alleen een addertje: Brave 1.82+ heeft drie crashbugs op GNOME Wayland die je moet oplossen voordat het écht stabiel is. Ik snap niet helemaal waarom die crashes plaatsvinden — het gaat om GPU-drivers en Wayland-protocollen die blijkbaar niet goed samenwerken — maar de onderstaande fixes werken voor mij.
16+
Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar de native RPM — mensen op Reddit zeggen dat de RPM-versie nativer aanvoelt en betere prestaties en efficiëntie biedt. Er is alleen een addertje: Brave 1.82+ heeft twee crashbugs op GNOME Wayland die je moet oplossen voordat het écht stabiel is. Ik snap niet helemaal waarom die crashes plaatsvinden — het gaat om GPU-drivers en Wayland-protocollen die blijkbaar niet goed samenwerken — maar de onderstaande fixes werken voor mij.
1717

18-
- **RPM (native):** Betere prestaties en systeemintegratie. Dit gebruik ik.
18+
- **RPM (native):** Nativer gevoel, betere prestaties en efficiëntie. Dit gebruik ik.
1919
- **Flatpak:** Kan in sommige situaties beter werken, maar voelt wat meer geïsoleerd en iets trager.
2020

2121
**RPM Installatie**
2222

2323
{{< callout type="warning" >}}
24-
Op Fedora met GNOME + Wayland heeft Brave 1.82+ drie bekende crashbugs waarvoor workarounds nodig zijn. De eerste twee worden via de desktop entry toegepast; de derde vereist een instelling in `brave://flags`.
24+
Op Fedora met GNOME + Wayland heeft Brave 1.82+ twee bekende crashbugs waarvoor workarounds nodig zijn. De eerste wordt via de desktop entry toegepast; de tweede vereist een instelling in `brave://flags`.
2525
{{< /callout >}}
2626

2727
```bash
@@ -32,25 +32,25 @@ sudo dnf install brave-browser
3232

3333
![Brave installatie-instructies](/images/brave-install.avif)
3434

35-
**Workarounds 1 & 2: de desktop entry patchen**
35+
**Workaround 1: de desktop entry patchen**
3636

3737
Kopieer de systeem-desktop entry naar je gebruikersmap zodat hij niet wordt overschreven bij updates:
3838
```bash
3939
sudo cp /usr/share/applications/brave-browser.desktop ~/.local/share/applications/
4040
```
4141

42-
Patch alle drie de `Exec=` regels met beide flags:
42+
Patch alle drie de `Exec=` regels met de flag:
4343
```bash
4444
sed -i \
45-
's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11 %U|' \
45+
's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 %U|' \
4646
~/.local/share/applications/brave-browser.desktop
4747

4848
sed -i \
49-
's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
49+
's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1|' \
5050
~/.local/share/applications/brave-browser.desktop
5151

5252
sed -i \
53-
's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
53+
's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1|' \
5454
~/.local/share/applications/brave-browser.desktop
5555
```
5656

@@ -59,20 +59,16 @@ Controleer of het gelukt is — je zou exact drie `Exec=` regels moeten zien:
5959
grep "^Exec" ~/.local/share/applications/brave-browser.desktop
6060
```
6161

62-
**Wat deze flags doen (voor zover ik het begrijp):**
62+
**Wat deze flag doet (voor zover ik het begrijp):**
6363

6464
`--disable-features=WaylandWpColorManagerV1` — Brave 1.82+ introduceerde een Wayland color management extensie die blijkbaar conflicteert met de AMD amdgpu-driver op Fedora + GNOME Wayland. Zonder deze flag veroorzaakt Brave GPU ring timeouts die de volledige GNOME Shell-sessie laten crashen. Ik heb geen idee waarom een browser-kleurbeheerfunctie het hele bureaublad kan neerhalen, maar hier zijn we dan.
6565

66-
`--ozone-platform=x11` — Dit forceert Brave om via XWayland te draaien in plaats van native Wayland. Het verhelpt een harde crash die optreedt als je een Bitwarden-bijlage probeert te downloaden. Blijkbaar doet Brave dan iets met een Wayland-protocol op een manier die niet geldig is, en dan crasht hij direct. Via XWayland omzeil je dat probleem. Je verliest een paar native Wayland-voordelen zoals fractional scaling, maar de browser blijft open — dat voelt als een redelijke afweging.
66+
**Een noot over `--ozone-platform=x11`:** Ik heb deze flag geprobeerd als workaround voor een crash bij het openen of downloaden van Bitwarden-bijlagen — Brave doet dan iets met een Wayland-protocol op een manier die niet geldig is en crasht direct. Via XWayland omzeil je dat. Maar het bleek een erger probleem te veroorzaken: gnome-shell crashte met `SIGABRT` (`g_assertion_message_expr` in `meta_window_unmanage`), getriggerd tijdens Picture-in-Picture video terwijl Brave via XWayland draaide — dezelfde onderliggende mutter-crash als gedocumenteerd in [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Die crash slaat de hele bureaublad-sessie neer en vereist een harde herstart. De flag is weg. Brave draait nu op native Wayland. De Bitwarden-bijlage-crash bestaat nog steeds, maar een Brave-crash is te verkiezen boven het verliezen van de hele sessie.
6767

68-
{{< callout type="info" >}}
69-
Start Brave altijd vanuit het GNOME-dock of de app launcher — niet vanuit de terminal. Als je hem vanuit een terminal in een Wayland-sessie start, overschrijven de omgevingsvariabelen van de terminal de `--ozone-platform=x11` flag en valt Brave terug op native Wayland, met alle crashes van dien.
70-
{{< /callout >}}
71-
72-
**Derde workaround: hardware video decode uitschakelen in `brave://flags`**
68+
**Tweede workaround: hardware video decode uitschakelen in `brave://flags`**
7369

7470
{{< callout type="warning" >}}
75-
Hardware video decode veroorzaakt nog steeds crashes, ook met de twee flags hierboven. Zolang de AMD VCN decoder actief is, crasht GNOME Shell met een SIGABRT (`g_assertion_message_expr`) — reproduceerbaar bij Picture-in-Picture video en bij intensief videobeheer. Zie [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **nog niet stabiel** op de AMD Radeon 890M met GNOME Wayland.
71+
Hardware video decode veroorzaakt nog steeds crashes, ook met de flag hierboven. Zolang de AMD VCN decoder actief is, crasht GNOME Shell met een SIGABRT (`g_assertion_message_expr`) — reproduceerbaar bij Picture-in-Picture video en bij intensief videobeheer. Zie [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **nog niet stabiel** op de AMD Radeon 890M met GNOME Wayland.
7672
{{< /callout >}}
7773

7874
Ga naar `brave://flags` en schakel uit:

0 commit comments

Comments
 (0)