Go to the main content

WebView2/NET Runtime

WebView2/NET Runtime​

General information​

Starting in Octo Browser version 1.9.0, we use Microsoft Edge WebView2. The browser requires the Microsoft Edge WebView2 Runtime environment to work correctly.

The Microsoft Edge WebView2 control element allows you to embed web technologies (HTML, CSS, and JavaScript) into your own applications. The WebView2 control element uses Microsoft Edge as the rendering subsystem to display web content in third-party applications.

.NET Framework​

Octo Browser requires the .NET Framework 4.8 to work correctly.

A software platform released by Microsoft in 2002. The key element of the platform is the Common Language Runtime (CLR), which is suitable for different programming languages. The .NET Framework is currently being developed as .NET.

IMPORTANT! If you use unofficial Windows builds with missing components, you may encounter difficulties installing or reinstalling WebView2 and .NET Runtime components. These packages are installed and function correctly on official Windows 10/11 OS builds with enabled updates. We cannot guarantee correct functionality of Octo Browser on unofficial Windows OS builds.

Octo Browser won't start. Instead, a white rectangular window appears during the startup​

White Window

Solution:

  1. Install the WebView2 runtime environment from the official Microsoft website (the installer for the latest standalone version)

WebView Isolated Version

  1. Reboot your device
  2. Launch Octo Browser

If Microsoft Edge WebView2 Runtime is already installed on your system​

WebView Is Already Installed

  1. In the Windows search box (press the Winkey) type "Add & Remove Programs"
  2. Open it
  3. Type "WebView" in the search bar

WebView Delete

  1. Remove the current version of Microsoft Edge WebView2 Runtime
  2. Install the WebView2 runtime environment from the official Microsoft website (the installer for the latest standalone version)
  3. Reboot your device
  4. Launch Octo Browser

If you are unable to uninstall the current version of Microsoft Edge WebView2 Runtime​

  1. Install Microsoft Edge browser from the official Microsoft website
  2. Install the WebView2 runtime environment from the official Microsoft website (the installer for the latest standalone version)
  3. Reboot your device
  4. Launch Octo Browser

If these solutions have not fixed the problem with the browser launch, please contact our technical support.

The browser doesn't start, and after launching it you see the "Octo Browser stopped working" system notification​

  1. Type "Event Viewer" in the Windows search box
  2. Go to "Custom Views" -> "Administrative Events" in the menu on the left

Eventviewer Administrative Events

  1. Check if there are events with ".NET Runtime" as the source in the list on the right

Eventviewer Sources

  1. Double-click to open this event; its description should include "Octo Browser".
  2. In the Windows search box (press the Winkey) type "Add & Remove Programs"
  3. Type Octo Browser and remove the browser from the device
  4. Download the latest Octo Browser version
  5. Install Octo Browser and (during the installation process) both the .NET Runtime and WebView Runtime components
  6. Reboot your device
  7. Launch Octo Browser

The browser does not start, and there are neither system notifications nor preloading windows​

  1. Install the .NET Framework package from the official Microsoft website
  2. Reboot your device

If you are unable to (re)install the .NET Framework, and it is already installed on your system​

  1. Download the .NET Framework Repair Tool from the official Microsoft website
  2. Follow the steps to repair the .NET Framework that the installer suggests
  3. Install the .NET Framework package from the official Microsoft website
  4. Reboot your device