diff --git a/docs/common-issues-debugging.md b/docs/common-issues-debugging.md index 869baff5f..b3aeea0ad 100644 --- a/docs/common-issues-debugging.md +++ b/docs/common-issues-debugging.md @@ -66,3 +66,12 @@ You should try disabling `sandbox` mode in your app as mentioned in the [accessi Alternatively, if you are loading extensions into Electron, you should do that at the end of the "ready" event handler. Otherwise, chromedriver will attach to the first extension's background page. See this [discussion](https://github.com/webdriverio-community/wdio-electron-service/discussions/667) for more details. + +### All versions of Electron fail to open on Ubuntu 24.04+ + +See [this issue](https://github.com/electron/electron/issues/41066) for more details. The solution is to set the `appArgs` capability to include `--no-sandbox`. + +Since it is useful for this and other issues, the service automatically adds `--no-sandbox` to the `appArgs` whenever a custom `appArgs` is not provided. If you need to override this, you can do so by setting the `appArgs` capability to an empty array. + +Another workaround is to run `sysctl -w kernel.apparmor_restrict_unprivileged_userns=0` before running your tests. +This command requires root privileges; if necessary, run it as the root user or use the `sudo` command.