Articles on: Getting Started

Fix eclean startup errors and when eclean won't open

If eclean will not open, read the message it shows. Most startup errors come from an old Windows build, a missing WebView2 runtime, a blocked update check or the background service not answering.


What do the startup messages mean?


Message

Cause

What to do

"eclean needs Windows 10 or later."

Your Windows build is older than Windows 10.

Use a PC with Windows 10 or 11.

WebView2 is missing or outdated

eclean needs Microsoft Edge WebView2 version 125.0.2535.41 or later.

Install or repair the Evergreen WebView2 Runtime from Microsoft, or run the eclean installer again.

"eclean is already running but didn't respond. Wait a moment, then start eclean again."

An earlier copy is still starting or closing.

Wait a minute and start eclean again. If it repeats, restart your PC.

"eclean has to check for required updates before it starts, but couldn't finish."

eclean could not reach the update server.

Check your internet connection and try again. Check status.eclean.gg.

"eclean needs a required update but couldn't install it."

The required update failed.

Download the latest installer from eclean.gg/download and run it.

The background service didn't respond

eclean's background service is not running.

Restart your PC. If it keeps happening, reinstall eclean from eclean.gg.


What if eclean runs but seems closed?


Closing the window with the X button keeps eclean running in the system tray by default. Open the tray icon and select Open eclean. To quit fully, use Quit eclean in the tray menu.


How do I reinstall eclean?


  1. Download the installer from eclean.gg/download.
  2. Run it and approve the User Account Control prompt.
  3. Sign in again if the app asks.


What should I send to support?


Include the exact message, your Windows version and the eclean version if you can see it. Open Settings, select About, then Log files to find the log folder support may ask for.



Updated on: 29/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!