You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
JCEF Fails to Initialize on KylinOS - "JCEF is not supported in this env or failed to initialize" #513
I'm encountering an issue where JCEF fails to initialize on KylinOS, a Linux-based operating system developed in China, commonly used in government and enterprise environments.
The error message consistently reported is: JCEF is not supported in this env or failed to initialize
This issue occurs across multiple IntelliJ IDEA plugins that rely on JCEF for embedded browser functionality. I've tested several popular plugins from the JetBrains Plugin Marketplace, and all of them fail with the same error, indicating this is likely a platform-level compatibility issue rather than a plugin-specific bug.
Affected Plugins Tested
The following plugins were tested (all failed with the same error):
EmbeddedBrowser
Embedded Web Browser
GBrowser
MyBrowser
BroBrowser
All plugins work correctly on standard Windows、MacOS distributions, but fail on KylinOS.
Environment Details
Operating System: KylinOS (various versions, including Kylin V10)
Architecture: x86_64 / ARM64 (tested on both)
IDE: IntelliJ IDEA (latest stable version)
JCEF Version: Bundled with IDE/plugins (typically based on java-cef 0.20+)
Java Version: OpenJDK 11 / 17 (as bundled with IDEA)
Expected Behavior
JCEF should initialize and render embedded web content successfully on KylinOS, just as it does on other Linux distributions.
Actual Behavior
JCEF fails during initialization with the generic error: JCEF is not supported in this env or failed to initialize
No additional debug logs are shown by default, but I'm willing to enable verbose logging if guidance is provided.
Additional Notes
KylinOS is based on Ubuntu/Debian but includes custom desktop environments and system libraries.
The issue may stem from missing dependencies, unsupported GPU drivers, or detection logic in JCEF that does not recognize KylinOS as a valid Linux environment.
It would be helpful if JCEF could:
Improve OS detection to include KylinOS.
Provide more detailed error logs during initialization failure.
Allow fallback or manual override for known-compatible Linux variants.
Request
Could you please:
Confirm whether KylinOS is officially supported?
Suggest any workaround or configuration to force JCEF initialization?
Consider adding KylinOS to the list of supported Linux environments?
I'm happy to assist with testing, logs, or system information to help resolve this.
KylinOS is not supported. Someone who uses that OS is welcome to debug issues. You might start by looking at how Chromium is built/modified to work on that OS. Or you can reach out to KylinSoft if you have a support agreement with them.
@magreenblatt I tested Ubuntu v24 but it still doesn't work. Is it possible that even Linux doesn't work? Ubuntu is already a commonly used operating system.
Activity
lxwhappy commentedon Sep 6, 2025
I'm encountering the same issue and urgently need a solution.
xzxiaoshan commentedon Oct 23, 2025
Is there anyone here? Is there a way to solve this problem?
magreenblatt commentedon Oct 23, 2025
xzxiaoshan commentedon Oct 23, 2025
@magreenblatt I tested Ubuntu v24 but it still doesn't work. Is it possible that even Linux doesn't work? Ubuntu is already a commonly used operating system.
magreenblatt commentedon Oct 23, 2025
I believe Ubuntu 24 uses Wayland by default. You might try running with
--ozone-platform=x11.