Introduction
Installation
Guides
- Engine
- Profile
- Browser
- BrowserView
- Navigation
- Content
- Context menu
- DOM
- JavaScript
- Pop-ups
- Dialogs
- Downloads
- Network
- Cache
- Cookies
- Proxy
- Authentication
- Permissions
- Plugins
- Printing
- Passwords
- User data profiles
- Credit cards
- Media
- Zoom
- Spell checker
- Deployment
- Chromium
Troubleshooting
- Logging
- Common exceptions
- Application does not terminate
- Video does not play
- Cannot sign in to Google account
- User data is not stored
- Color scheme
- Startup failure
- Slow startup on Windows
- Unresponsive .NET Application
- Unexpected Chromium process termination
- Unexpected behavior
- Windows 7/8/8.1 end of support
Migration
System requirements
This page describes the software and hardware configurations required to run a program based on DotNetBrowser.
Software requirements
.NET
- .NET Framework 4.5 — 4.8.1 (Windows only)
- .NET Core 2.2 (core functionality only)
- .NET Core 3.0, 3.1
- .NET 5 - 8
Avalonia UI
- 11.0.4 and higher
Windows
DotNetBrowser supports x86, x64, and ARM64:
- Windows 11
- Windows 10
- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
Windows 7/8/8.1 and the corresponding Windows Server versions are no longer supported.
Linux
DotNetBrowser supports the following Linux distributions (x64 and ARM64):
- Ubuntu 18.04+
- Debian 10+
- Fedora Linux 33+
- openSUSE 15.2+
- RedHat Enterprise Linux 7
Chromium does not work in the headless environment. In order to use DotNetBrowser in headless environments including Linux-based Docker containers and WSL, you need to start X server.
macOS
DotNetBrowser supports macOS 10.15 Catalina and higher (x64 and ARM64).
Hardware requirements
HiDPI monitors
DotNetBrowser recognizes the device scale factor that is used in the environments with HiDPI displays and renders HTML content with the respect to that scale factor.
The WPF and WinForms BrowserView controls are compatible with different DPI awareness modes. DotNetBrowser gets the DPI awareness settings from the application configuration where it is used and configures Chromium processes to use the same DPI awareness mode.
DotNetBrowser supports high DPI only if your .NET desktop application supports it.
These MSDN articles describe how to create DPI-aware .NET desktop applications:
- High DPI desktop application development on Windows
- Creating a DPI-Aware Application
- Developing a Per-Monitor DPI-Aware WPF Application
- High DPI support in Windows Forms
Android/iOS
DotNetBrowser does not support mobile devices with iOS and Android.
Other Environments
You can try running DotNetBrowser on other platforms or versions not listed here, but we do not guarantee that all DotNetBrowser functionality will work properly there.
DotNetBrowser cannot be used in the environments that prevent the User32/GDI32 APIs from being called, such as Azure App Services or Azure Functions. With these limitations, it is not possible to launch the Chromium engine.