.NET Framework

What works

Installation works

What does not

Installation fails due to bug 26757 on non WinXP prefixes.

Workarounds

Run this before the installation:

wine reg add "HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Component Based Servicing\\Version" /v 6.1.7601.17592 /t REG_SZ /d "foo" /f

What was not tested

Programs that require dotNet 4.5.2

Hardware tested

Graphics:

• GPU: Nvidia
• Driver: proprietary

Additional Comments

Install winetricks (more details here) to make easier to configure the Wine prefix:

$ sudo wget 'https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks' -O /usr/local/bin/winetricks
$ sudo chmod +x /usr/local/bin/winetricks

Last update: 2020-08-24

Create a new Wine prefix (for most applications, it's better to set its own prefix):

$ env WINEPREFIX=$HOME/winedotnet wineboot --init

If Wine prompts for installing Mono, click Cancel.

Install .NET Framework (and optionally install corefonts):

$ env WINEPREFIX=$HOME/winedotnet winetricks --force dotnet40 corefonts

Use dotnet40 to install .NET Framework 4.0. To install another version of 4.x series, change it to one of the following list:

dotnet45   to install .NET Framework 4.5
dotnet451  to install .NET Framework 4.5.1
dotnet452  to install .NET Framework 4.5.2
dotnet46   to install .NET Framework 4.6
dotnet461  to install .NET Framework 4.6.1
dotnet462  to install .NET Framework 4.6.2
dotnet47   to install .NET Framework 4.7
dotnet471  to install .NET Framework 4.7.1
dotnet472  to install .NET Framework 4.7.2
dotnet48   to install .NET Framework 4.8

... And so on. For example, to install .NET Framework 4.5.2:

$ env WINEPREFIX=$HOME/winedotnet winetricks --force dotnet452 corefonts

If this doesn't work or you need to install a version not supported by winetricks, try a manual installation (explained below).

Start with a new Wine prefix:

$ env WINEPREFIX=$HOME/winedotnet wineboot --init

Try to install .NET 4.0 through winetricks:

$ env WINEPREFIX=$HOME/winedotnet winetricks --force dotnet40 corefonts

If it success and you need to install a higher 4.x version, go to Manual Installation (Step 2). If it doesn't work (very unlikely) keep reading.

Uninstall wine-mono from your Wine prefix:

$ env WINEPREFIX=$HOME/winedotnet wine uninstaller --remove '{E45D8920-A758-4088-B6C6-31DBB276992E}'

Change reported version to Windows XP, then download and install .NET 4.0:

$ env WINEPREFIX=$HOME/winedotnet winetricks winxp
$ wget 'http://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe'
$ env WINEPREFIX=$HOME/winedotnet wine ~/dotNetFx40_Full_x86_x64.exe

Open winecfg dialog:

$ env WINEPREFIX=$HOME/winedotnet winecfg

Go to "Libraries" tab, add a new library substitution called "mscoree" and set it to "Native (Windows)". Close the dialog by clicking OK.

Change reported version to Windows 7:

$ env WINEPREFIX=$HOME/winedotnet winetricks win7

Download and run the installer for the desired version of .NET (install only the highest version you need):

• .NET Framework 4.5:

  $ wget 'http://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/dotnetfx45_full_x86_x64.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/dotnetfx45_full_x86_x64.exe /q

• .NET Framework 4.5.1:

  $ wget 'https://download.microsoft.com/download/1/6/7/167F0D79-9317-48AE-AEDB-17120579F8E2/NDP451-KB2858728-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP451-KB2858728-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.5.2:

  $ wget 'http://download.microsoft.com/download/E/2/1/E21644B5-2DF2-47C2-91BD-63C560427900/NDP452-KB2901907-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP452-KB2901907-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.6:

  $ wget 'https://download.microsoft.com/download/C/3/A/C3A5200B-D33C-47E9-9D70-2F7C65DAAD94/NDP46-KB3045557-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP46-KB3045557-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.6.1:

  $ wget 'https://download.microsoft.com/download/E/4/1/E4173890-A24A-4936-9FC9-AF930FE3FA40/NDP461-KB3102436-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP461-KB3102436-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.6.2:

  $ wget 'https://download.microsoft.com/download/F/9/4/F942F07D-F26F-4F30-B4E3-EBD54FABA377/NDP462-KB3151800-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP462-KB3151800-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.7:

  $ wget 'https://download.microsoft.com/download/D/D/3/DD35CC25-6E9C-484B-A746-C5BE0C923290/NDP47-KB3186497-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP47-KB3186497-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.7.1:

  $ wget 'https://download.microsoft.com/download/9/E/6/9E63300C-0941-4B45-A0EC-0008F96DD480/NDP471-KB4033342-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP471-KB4033342-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.7.2:

  $ wget 'https://download.microsoft.com/download/6/E/4/6E48E8AB-DC00-419E-9704-06DD46E5F81D/NDP472-KB4054530-x86-x64-AllOS-ENU.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/NDP472-KB4054530-x86-x64-AllOS-ENU.exe /q

• .NET Framework 4.8:

  $ wget 'https://download.visualstudio.microsoft.com/download/pr/7afca223-55d2-470a-8edc-6a1739ae3252/abd170b4b0ec15ad0222a809b761a036/ndp48-x86-x64-allos-enu.exe'
  $ env WINEPREFIX=$HOME/winedotnet wine ~/ndp48-x86-x64-allos-enu.exe /q

Last update: 2023-06-16

To verify .NET Framework installation(s) you can use the .NET Framework Setup Verification Tool from Aaron Stebner (Microsoft) which checks for proper installation of .NET assemblies and registry entries:

$ wget 'https://web.archive.org/web/20200729095123/https://msdnshared.blob.core.windows.net/media/2018/05/netfx_setupverifier_new.zip'
$ unzip netfx_setupverifier_new.zip
$ env WINEPREFIX=$HOME/winedotnet wine ~/netfx_setupverifier.exe

Select the .NET Framework version you want to verify and evaluate the log file manually if verification failed.

When you start a Microsoft .NET Framework application, a shim program determines which version of the common language runtime (CLR) to load, loads it, and starts the application. If the shim encounters an error (for example, if it can't find a compatible version of the .NET Framework on the computer), it displays an error message with instructions.

Most likely you have a .NET 2.0 or .NET 3.x application here. You need to install .NET Framework 3.5 (includes .NET 2.0 and 3.0) to run these.

Please follow HOWTO.

URL_ParseUrl FIXME messages on console when running/installin�g .NET apps are harmless and can be safely ignored. Example console output:

If a .NET application exits with the following message in console:

Some of Wine's truetype fonts are still not in shape of being a complete replacement for Windows ones, causing errors.

You must use 'winetricks corefonts' recipe to work around this problem!

If a .NET application exits with the following message in console:

You are missing the samba/winbind component which is essential for certain Wine functionality.

Please install winbind with your distribution package manager!