I keep running into issues with white or black screens showing up after installing the mist browser or the ethereum wallet.

blank screen

How to troubleshoot a blank screen in the wallet or browser?

  • 3
    This is a chromium/electron/video driver combo-bug. The embedded chromium instance blacklists your video driver, causing it to not have anything to render the page with. If you set the --ignore-gpu-blacklist option it should disable the blacklist and fix the issue. Mar 30, 2016 at 9:09
  • I have the same problem in OSX 10.11.4 (El Capitan) ![enter image description here](i.stack.imgur.com/kqu5G.png)
    – ekkis
    May 21, 2016 at 0:30

4 Answers 4


Missing dependencies?

First of all try installing meteorjs and electron. These dependencies should be included in the binaries but some operating systems behave weird.

Is your GPU blacklisted?

Try to run mist or ethereum-wallet with the --ignore-gpu-blacklist flag. This might cause the client to crash. But if it does not crash, you probably run a working wallet by now.

gpu blacklist

Issues with links to blank pages?

Use this script to fix all wallet addresses to lower case.

// Open the wallet console: Menu -> Develop -> Toggle console ...
// Run the following script

_.each(Wallets.find().fetch(), function(item){
        Wallets.update(item._id, {$set: {address: item.address.toLowerCase()}}); 
_.each(CustomContracts.find().fetch(), function(item){
        CustomContracts.update(item._id, {$set: {address: item.address.toLowerCase()}}); 
_.each(Tokens.find().fetch(), function(item){
        Tokens.update(item._id, {$set: {address: item.address.toLowerCase()}}); 

This changes all your wallet addresses internally back to lowercase (it was introduced that by accident).


If you are still having issues try to install the previous version of the wallet. Once you do this install it on your machine then go ahead and download the new version again.

That solved the white screen issue for me thanks to a buddy of mine. Hope it helps!


Another way is to debug to with chrome dev-tools

troubleshoot a white screen in Mist browser


I found the white screen to appear very consistently when I switched between testnet and mainnet, but only if the dev-tools console was on. If I switched from mainnet to testnet while the console was open--white screen. If I switched from testnet-mainnet while console was open--white screen. Any other time I switched --no white screen.

In fact, the only time I've ever seen the white screen is when I switched chains with the console open.

Not the answer you're looking for? Browse other questions tagged or ask your own question.