System Properties

The following system properties can be used to configure and customize Equo Chromium’s behavior:

Property Description

-Dchromium.debug_port=PORT

Enable remote debugging with Chrome DevTools (chrome://inspect). See the Devtools Debugging page.

-Dchromium.debug=true

Print debugging logs to stdout. See the Logging page.

-Dchromium.inherit_bg_color=true

Inherit the background color from the parent component (supported from version 124.0.9). See: SWT / Swing

-Dchromium.turbolinks=true

Receive LocationListener events for turbolink-like navigation.

-Dchromium.turbolinks="HEADER1=VALUE1;HEADER2=VALUE2"

Same as above, but sends specific request headers. See Turbolinks.

-Dchromium.custom_protocol=true

Allow handling of all custom protocols by the OS.

-Dchromium.custom_protocol=confirm

Same as above, but with user confirmation for each protocol.

-Dchromium.custom_protocol="PROTO1;PROTO2;"

Allow handling only for listed non-http/s protocols. See Custom Protocol.

-Dchromium.executable.name=PROCESS_NAME

Set the Equo process name in non-RCP Java apps (must be set before any Browser creation). Supported from version 124.0.8. See Executable Name.

-Dchromium.proxy_pac_script="PAC_SCRIPT_URL"

Set proxy using a PAC (Proxy Auto-Config) script URL. See Proxy PAC Script.

-Dchromium.downloadLocationListener=true

Call LocationListener before starting a download. See Location Listener.

-Dchromium.find_dialog=true

Enable the default find dialog with Ctrl+F. See Find Dialog.

-Dchromium.setTextAsUrl=file:

Improve performance of setText() with large HTML content by loading as a file. See Set Text As URL.

-Dchromium.force_windowless_swt=true

Force windowless browsers to integrate using the SWT toolkit. See Windowless.

-Dchromium.enable_crash_reporter=false

Disable Chromium crash reporting. See Crash Reporting.

-Dchromium.home=PATH

Specify the directory for the .equo folder (defaults to user.home). See Chromium Home.

-Dswt.chromium.ssl=/path/to/cert.pem

Use a custom PEM certificate when server validation fails. See Custom PEM Certificate.

-Dchromium.home=cef;switches;and;chromium;flags

Flags or switches inherent to Chromium or CEF can be passed via this property, as a semicolon-separated list.