Window is solid black or solid white; looks like a blank page
This has been reported with several issues:
- #1471 - Blank Page on Ubuntu
- #3180 - Brave does not run properly in Linux Mint 18 XFCE in Virtual Box
- #3663 - Blank pages after using brave for some minutes
- #3787 - When opening new tabs web pages are not shown.
- #4113 - All Pages White, Maybe Crash?
- #4928 - Consistent blank pages (possible driver issue)
- #6022 - Blank page when 2 tabs or more
- #6861 - Blinking black and white screen
The root cause appears to be that Chromium is having a problem with hardware acceleration. Disabling hardware acceleration in our preferences screen (if you’re able to get that far) doesn’t always work. We do have a documented issue to make this easier to try… but in the meantime, here are some steps you can take.
Command line flags and their impact
--ignore-gpu-blacklist: Per Chromium:
"Ignores GPU blacklist.". If your GPU is blacklisted you likely will have display problems. This removes it from that list and should still keep hardware acceleration (important for media like WebGL)
--disable-gpu: Per Chromium:
"Disables GPU hardware acceleration. If software renderer is not in place, then the GPU process won't launch.". This is a more extreme option
- Right click the Brave shortcut and pick properties
- In the
Targetarea, paste in the command line flag at the end (see above). For example, the screenshot below shows the more extreme option,
- Click Apply and close the window
- Launch the shortcut you just changed
- Open a terminal (CTRL + ALT + T on many distributions)
- Locate the Brave desktop file using
- Open the file in an editor as root. Example:
sudo nano /usr/share/applications/brave.desktop.
- Change the
Exec=brave %Uline to either
Exec=brave --ignore-gpu-blacklist -- %Uor
Exec=brave --disable-gpu -- %U.
- Save the file and exit the editor. In nano, this is done with CTRL + O then CTRL + X.
- (Re)start Brave.