- Download Mojave On Unsupported Mac
- How To Install Unsupported Apps On Mac
- Install Iphone Apps On Mac
- Install Mac App On Linux
- Can't Install App On Mac
In this article, you'll learn how to install .NET on macOS. .NET is made up of the runtime and the SDK. The runtime is used to run a .NET app and may or may not be included with the app. The SDK is used to create .NET apps and libraries. The .NET runtime is always installed with the SDK.
The latest version of .NET is 5.0.
Supported releases
The following table is a list of currently supported .NET releases and the versions of macOS they're supported on. These versions remain supported either the version of .NET reaches end-of-support.
To install Office, try signing in directly to the Microsoft 365 Software page instead. Select the language and bit-version you want (PC users can choose between 32-bit and 64-bit), and then click Install. See Steps 2 and 3 on the PC or Mac tabs above to help you with the rest of the install process. Apple’s latest Mac update, macOS Catalina, was released earlier this week, and with it came a flurry of complications both minor and major. For one, this update is the first for Apple to drop 32. Update 2019-05-02: For those of you who want to install macOS 10.14 on an unsupported Mac, check this post. I have a MacBook Mid 2007 (more technically named MacBook2,1) that officially can not be upgraded beyond Mac OS X 10.7 (Lion). It is however possible to install Mac OS X 10.9 (Mavericks) on it with quite good success and not too much effort. The Reason Not To Install macOS High Sierra on an Unsupported Mac. As you may have already experienced with other types of officially unsupported machines, the probability of having issues is much higher. The same applies in this case, too, since the macOS High Sierra Patcher will render your iMac 8.1 Broadcom Wi-Fi chip useless for certain models.
- A ✔️ indicates that the version of .NET Core is still supported.
- A ❌ indicates that the version of .NET Core isn't supported.
Operating System | .NET Core 2.1 | .NET Core 3.1 | .NET 5.0 |
---|---|---|---|
macOS 10.15 'Catalina' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.14 'Mojave' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.13 'High Sierra' | ✔️ 2.1 (Release notes) | ✔️ 3.1 (Release notes) | ✔️ 5.0 (Release notes) |
macOS 10.12 'Sierra' | ✔️ 2.1 (Release notes) | ❌ 3.1 (Release notes) | ❌ 5.0 (Release notes) |
Unsupported releases
The following versions of .NET are ❌ no longer supported. The downloads for these still remain published:
- 3.0 (Release notes)
- 2.2 (Release notes)
- 2.0 (Release notes)
Runtime information
The runtime is used to run apps created with .NET. When an app author publishes an app, they can include the runtime with their app. If they don't include the runtime, it's up to the user to install the runtime.
There are three different runtimes you can install on macOS:
ASP.NET Core runtime
Runs ASP.NET Core apps. Includes the .NET runtime.
Runs ASP.NET Core apps. Includes the .NET runtime.
.NET runtime
This runtime is the simplest runtime and doesn't include any other runtime. It's highly recommended that you install ASP.NET Core runtime for the best compatibility with .NET apps.
This runtime is the simplest runtime and doesn't include any other runtime. It's highly recommended that you install ASP.NET Core runtime for the best compatibility with .NET apps.
SDK information
Download Mojave On Unsupported Mac
The SDK is used to build and publish .NET apps and libraries. Installing the SDK includes both runtimes: ASP.NET Core and .NET.
![Ios Ios](/uploads/1/3/4/0/134071071/222106896.jpg)
Dependencies
.NET is supported on the following macOS releases:
.NET Core Version | macOS | Architectures | More information |
---|---|---|---|
5.0 | High Sierra (10.13+) | x64 | More information |
3.1 | High Sierra (10.13+) | x64 | More information |
3.0 | High Sierra (10.13+) | x64 | More information |
2.2 | Sierra (10.12+) | x64 | More information |
2.1 | Sierra (10.12+) | x64 | More information |
Beginning with macOS Catalina (version 10.15), all software built after June 1, 2019 that is distributed with Developer ID, must be notarized. This requirement applies to the .NET runtime, .NET SDK, and software created with .NET.
![Mac Mac](/uploads/1/3/4/0/134071071/710167605.jpg)
The runtime and SDK installers for .NET 5.0 and .NET Core 3.1, 3.0, and 2.1, have been notarized since February 18, 2020. Prior released versions aren't notarized. If you run a non-notarized app, you'll see an error similar to the following image:
For more information about how enforced-notarization affects .NET (and your .NET apps), see Working with macOS Catalina Notarization.
libgdiplus
How To Install Unsupported Apps On Mac
.NET applications that use the System.Drawing.Common assembly require libgdiplus to be installed.
An easy way to obtain libgdiplus is by using the Homebrew ('brew') package manager for macOS. After installing brew, install libgdiplus by executing the following commands at a Terminal (command) prompt:
Install with an installer
macOS has standalone installers that can be used to install the .NET 5.0 SDK: Free photo recovery for mac.
Download and manually install
As an alternative to the macOS installers for .NET, you can download and manually install the SDK and runtime. Manual install is usually performed as part of continuous integration testing. For a developer or user, it's generally better to use an installer.
If you install .NET SDK, you don't need to install the corresponding runtime. First, download a binary release for either the SDK or the runtime from one of the following sites:
- ✔️ .NET 5.0 downloads
- ✔️ .NET Core 3.1 downloads
- ✔️ .NET Core 2.1 downloads
Next, extract the downloaded file and use the
export
command to set variables used by .NET and then ensure .NET is in PATH.To extract the runtime and make the .NET CLI commands available at the terminal, first download a .NET binary release. Then, open a terminal and run the following commands from the directory where the file was saved. The archive file name may be different depending on what you downloaded.
Use the following command to extract the runtime:
Use the following command to extract the SDK:
Tip
The preceding
export
commands only make the .NET CLI commands available for the terminal session in which it was run.You can edit your shell profile to permanently add the commands. There are a number of different shells available for Linux and each has a different profile. For example:
- Bash Shell: ~/.bash_profile, ~/.bashrc
- Korn Shell: ~/.kshrc or .profile
- Z Shell: ~/.zshrc or .zprofile
Edit the appropriate source file for your shell and add
:$HOME/dotnet
to the end of the existing PATH
statement. If no PATH
statement is included, add a new line with export PATH=$PATH:$HOME/dotnet
.Also, add
export DOTNET_ROOT=$HOME/dotnet
to the end of the file.Install Iphone Apps On Mac
Your phone app mac. This approach lets you install different versions into separate locations and choose explicitly which one to use by which application.
Install with Visual Studio for Mac
Visual Studio for Mac installs the .NET SDK when the .NET workload is selected. To get started with .NET development on macOS, see Install Visual Studio 2019 for Mac.
.NET SDK version | Visual Studio version |
---|---|
5.0 | Visual Studio 2019 for Mac version 8.8 or higher. |
3.1 | Visual Studio 2019 for Mac version 8.4 or higher. |
2.1 | Visual Studio 2019 for Mac version 8.0 or higher. |
Install alongside Visual Studio Code
Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code is available for Windows, macOS, and Linux.
While Visual Studio Code doesn't come with an automated .NET installer like Visual Studio does, adding .NET support is simple.
Install Mac App On Linux
- Download and install Visual Studio Code.
- Download and install the .NET SDK.
- Install the C# extension from the Visual Studio Code marketplace.
Install with bash automation
The dotnet-install scripts are used for automation and non-admin installs of the runtime. You can download the script from the dotnet-install script reference page.
The script defaults to installing the latest long term support (LTS) version, which is .NET 3.1. You can choose a specific release by specifying the
current
Best host file app for macs mac. switch. Include the runtime
switch to install a runtime. Otherwise, the script installs the SDK.Note
The previous command installs the ASP.NET Core runtime for maximum compatability. The ASP.NET Core runtime also includes the standard .NET runtime.
Docker
Containers provide a lightweight way to isolate your application from the rest of the host system. Containers on the same machine share just the kernel and use resources given to your application.
.NET can run in a Docker container. Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.
Microsoft provides images that are tailored for specific scenarios. For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.
For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.
Next steps
Can't Install App On Mac
- How to check if .NET Core is already installed.
- Working with macOS Catalina notarization.
- Tutorial: Get started on macOS.
- Tutorial: Create a new app with Visual Studio Code.
- Tutorial: Containerize a .NET Core app.
Questionsor comments? Feel free to contact me at [email protected] Pleasetake a look at the FAQ located at the bottom of this page as well.
I also have a YouTube video going over the whole process.
Requirements:
- Early-2008 or newer Mac Pro, iMac, or MacBook Pro(MacPro 3,1 and 4,1, iMac 8,1 and 9,1, MacBook Pro 4,1, 5,1 5,2, 5,3,5,4, and 5,5)
- Late-2008 or newer MacBook Air or Aluminum Unibody MacBook (MacBookAir 2,1, MacBook 5,1)
- Early-2009 or newer Mac Mini or white MacBook (Macmini 3,1, MacBook 5,2)
- Early-2008 or newer Xserve (Xserve 2,1, Xserve 3,1)
Machines that ARE NOT supported:
- 2006-2007 Mac Pros, iMacs, MacBookPros, and Mac Minis (MacPro 1,1 and 2,1, iMac 4,1, 5,1, 5,2, 6,1 and7,1, MacBook Pro 1,1, 2,1, and 3,1, Macmini 1,1 and 2,1)
-- The 2007 iMac 7,1 is compatible if the CPU is upgraded to a Penryn-based Core 2 Duo, such as a T9300.
- 2006-2008 MacBooks (MacBook 1,1, 2,1 3,1 and 4,1)
- 2008 MacBook Air (MacBookAir 1,1)
-- Note: Make sure SIP is disabled on the system you intend to installHigh Sierra on. If it's not or you're unsure, just boot into your Recoverypartition of your currently installed copy of OS X, open Terminal, andrun 'csrutil disable'.
Things you'll need:
- A copy of the macOS High Sierra InstallerApp. This can be obtained from the Mac App Store using a machinethatsupports High Sierra, or by using the built-in downloading feature of the tool. In the Menu Bar, simply select 'Tools > Download macOS High Sierra..'
- A USB drive that's at least 8 GB in size
- A copy of the tool - Download here (Current version: 2.7.0, SHA1: 73f180d30200ef5f6d900440fe57b9c7d22bd6bf)
-- View changelog and download older versions here
Known issues:
- Trackpad (MacBook5,2 affected only). The trackpad in the MacBook5,2isn't fully supported in High Sierra. While it works and is fully usable,High Sierra detects it as just a standard mouse, preventing you fromchanging some trackpad-oriented settings.
How to use:
1. Insert your desired USB drive, open Disk Utility, and format it as OS X Extended (Journaled).
2. Open the 'macOS High Sierra Patcher' tool, and browse for your copy of the macOS High Sierra Installer App.
*Ensure that the tool successfully verifies the app.
3. Next, select your USB drive in the Target Volume list, and click 'Start Operation.'
4. When the operation completes, boot your target unsupported Mac offthe USB drive you just created by holding down the Option key while turning on the machine, and selecting the drive.
Note: Only perform steps 5 and 6 if you intend to do a clean install.Otherwise, you can simply skip these steps and install to your volumecontaing a previous version of OS X, and it'll do an in-place upgrade.
5. When the installer boots, open Disk Utility from the Utilities menu, or by double-clicking it in the Utilities window on the bottom left corner of the screen.
6. Select the disk or partition you want to install on, and erase it,ensuring to use either Mac OS Extended (Journaled), or APFS as the filesystem type.If formatting an entire drive, ensure GUID is selected.
-- Please note that if you use APFS, you will not have a bootable Recovery partition.
-- It is recommended that you only use APFS if the target drive is an SSD.
-- If you decide to use APFS, a custom booting method will be installed by the post-install tool, as the firmware of these unsupported machines does not natively support booting from APFS volumes. It is not quite as clean as native booting, but will not cause any issues while running High Sierra. A demo of the modified booting process can be viewed here.
7. Install macOS normally onto the desired volume.
8. When the install completes, reboot back onto the installer drive.This time, open the 'macOS Post Install' application.
9. In the application, select the Mac model you are using. The optimalpatches will be selected for you based on the model you select. You canalso select other patches of your choosing.
-- The 'i' button next to each patch will show more details about the respective patch.
10. Select the volume you have just installed macOS High Sierra on, andclick 'Patch.' When it finishes patching, click 'Reboot'. It may sitthere for a few moments rebuilding caches before rebooting.
-- If for somereason the system fails to work correctly after rebooting, boot backinto your installer drive, run the post install patch again, and select'Force Cache Rebuild' before rebooting. This isn't necessary under mostcircumstances.
11. When it reboots, it should now boot into a fully working copy ofmacOS High Sierra.
Additional Info:
- If selected in the macOS Post Install tool, your High Sierra install will have a program named 'Patch Updater' located in your /Applications/Utilities folder. This program will alert you when new updates to patches are available for your machine, and will prompt you to install them. If you do not have Patch Updater installed, but would like it, you can download and run the script found here to do so.
Updates
System updates, such as 10.13.1, should install normally if 'Software Update Patch' was selected in the macOS Post Install tool, or installed using the Patch Updater program. If for some reason updates aren't showing up, or you did not apply the patch, you can install it manually using the script found here.
-- If the machine does not start up properly after applying a system update, you will need to boot off your patched installer volume, and re-run the post-install patch on your High Sierra volume. Ensure you select 'Force Cache Rebuild' before rebooting.
FAQ:
Q: The tool created the USB drive successfully, but when booting, the progress bar hangs a bit more than half way.
A: Check your copy of the Install macOS High Sierra App. If you're using thelatest version of the tool, you must be using the latest version of theInstall macOS High Sierra App. Version 1.1 ofthe patch tool and older support older versions of the installer app.
Q: The patch tool gives me errors, such as 'Error copying files..'.
A: Check to make sure your USB drive is writeable. Try re-formatting it, or just try a different USB drive.
Q: The patch tool gives me a 'Mounting Failed' error
A: Check to make sure your Install macOS High Sierra App is the correct one.It should be around 5GB in size. If you used the 'Skip App Verification' option, you have most likely selected an invalid app thatdoesn't contain the necessary files.
Q: I cannot open my copy of Install macOS High Sierra with the patch tool.
A: If you downloaded the copy linked above, it is distributed inside aDMG file. You must open this file (mount it) to access the InstallmacOS High Sierra App you need to select.
Q: I don't see my hard drive partition in the installer screen or in the post-install tool.
A: Make sure FileVault is disabled, or use the instructions found here to unlock it manually using Terminal.
Q: I get a 'NO' symbol when starting up after successfully installing High Sierra.
A: Make sure you have run the post-install patch on the correct volume, as detailed above in steps 8-10.
Q: I get a 'NO' symbol when starting up from the patched USB drive
A: Check the supported/not supported list at the top of this page. Ensure your machine is in the supported list.
Q: My iSight camera doesn't work after installing High Sierra
A: Make sure you properly remove (using the program's uninstaller, not by simply dragging the application to the Trash) all virtual machine software installed on your machine, such as VirtualBox, VMWare, etc.
Q: I get 'NSURL' errors when trying to update my machine or use the App Store
A: This is usually the result of having an invalid CatalogURL set. To revert to stock, simply run 'sudo softwareupdate --clear-catalog' in Terminal, and then run the software update patch script located above.
Q: Safari, App Store, and/or Mail stopped working after installing a system update
A: Download and run the Onyx application, select 'Maintenence' at the top, then click the Run button.
Q: I get a 'No packages were eligible for install' error when attepting to install High Sierra
A: This is due to your system's date and time being set incorrectly. To fix it, you can either boot into your current OS X install and set the date, or you can use Terminal after booting from your patched USB installer drive to set the date. Instructions to set the date using Terminal can be found here.
I also have a YouTube video going over the whole process.
Requirements:
- Early-2008 or newer Mac Pro, iMac, or MacBook Pro(MacPro 3,1 and 4,1, iMac 8,1 and 9,1, MacBook Pro 4,1, 5,1 5,2, 5,3,5,4, and 5,5)
- Late-2008 or newer MacBook Air or Aluminum Unibody MacBook (MacBookAir 2,1, MacBook 5,1)
- Early-2009 or newer Mac Mini or white MacBook (Macmini 3,1, MacBook 5,2)
- Early-2008 or newer Xserve (Xserve 2,1, Xserve 3,1)
Machines that ARE NOT supported:
- 2006-2007 Mac Pros, iMacs, MacBookPros, and Mac Minis (MacPro 1,1 and 2,1, iMac 4,1, 5,1, 5,2, 6,1 and7,1, MacBook Pro 1,1, 2,1, and 3,1, Macmini 1,1 and 2,1)
-- The 2007 iMac 7,1 is compatible if the CPU is upgraded to a Penryn-based Core 2 Duo, such as a T9300.
- 2006-2008 MacBooks (MacBook 1,1, 2,1 3,1 and 4,1)
- 2008 MacBook Air (MacBookAir 1,1)
-- Note: Make sure SIP is disabled on the system you intend to installHigh Sierra on. If it's not or you're unsure, just boot into your Recoverypartition of your currently installed copy of OS X, open Terminal, andrun 'csrutil disable'.
Things you'll need:
- A copy of the macOS High Sierra InstallerApp. This can be obtained from the Mac App Store using a machinethatsupports High Sierra, or by using the built-in downloading feature of the tool. In the Menu Bar, simply select 'Tools > Download macOS High Sierra..'
- A USB drive that's at least 8 GB in size
- A copy of the tool - Download here (Current version: 2.7.0, SHA1: 73f180d30200ef5f6d900440fe57b9c7d22bd6bf)
-- View changelog and download older versions here
Known issues:
- Trackpad (MacBook5,2 affected only). The trackpad in the MacBook5,2isn't fully supported in High Sierra. While it works and is fully usable,High Sierra detects it as just a standard mouse, preventing you fromchanging some trackpad-oriented settings.
How to use:
1. Insert your desired USB drive, open Disk Utility, and format it as OS X Extended (Journaled).
2. Open the 'macOS High Sierra Patcher' tool, and browse for your copy of the macOS High Sierra Installer App.
*Ensure that the tool successfully verifies the app.
3. Next, select your USB drive in the Target Volume list, and click 'Start Operation.'
4. When the operation completes, boot your target unsupported Mac offthe USB drive you just created by holding down the Option key while turning on the machine, and selecting the drive.
Note: Only perform steps 5 and 6 if you intend to do a clean install.Otherwise, you can simply skip these steps and install to your volumecontaing a previous version of OS X, and it'll do an in-place upgrade.
5. When the installer boots, open Disk Utility from the Utilities menu, or by double-clicking it in the Utilities window on the bottom left corner of the screen.
6. Select the disk or partition you want to install on, and erase it,ensuring to use either Mac OS Extended (Journaled), or APFS as the filesystem type.If formatting an entire drive, ensure GUID is selected.
-- Please note that if you use APFS, you will not have a bootable Recovery partition.
-- It is recommended that you only use APFS if the target drive is an SSD.
-- If you decide to use APFS, a custom booting method will be installed by the post-install tool, as the firmware of these unsupported machines does not natively support booting from APFS volumes. It is not quite as clean as native booting, but will not cause any issues while running High Sierra. A demo of the modified booting process can be viewed here.
7. Install macOS normally onto the desired volume.
8. When the install completes, reboot back onto the installer drive.This time, open the 'macOS Post Install' application.
9. In the application, select the Mac model you are using. The optimalpatches will be selected for you based on the model you select. You canalso select other patches of your choosing.
-- The 'i' button next to each patch will show more details about the respective patch.
10. Select the volume you have just installed macOS High Sierra on, andclick 'Patch.' When it finishes patching, click 'Reboot'. It may sitthere for a few moments rebuilding caches before rebooting.
-- If for somereason the system fails to work correctly after rebooting, boot backinto your installer drive, run the post install patch again, and select'Force Cache Rebuild' before rebooting. This isn't necessary under mostcircumstances.
11. When it reboots, it should now boot into a fully working copy ofmacOS High Sierra.
Additional Info:
- If selected in the macOS Post Install tool, your High Sierra install will have a program named 'Patch Updater' located in your /Applications/Utilities folder. This program will alert you when new updates to patches are available for your machine, and will prompt you to install them. If you do not have Patch Updater installed, but would like it, you can download and run the script found here to do so.
Updates
System updates, such as 10.13.1, should install normally if 'Software Update Patch' was selected in the macOS Post Install tool, or installed using the Patch Updater program. If for some reason updates aren't showing up, or you did not apply the patch, you can install it manually using the script found here.
-- If the machine does not start up properly after applying a system update, you will need to boot off your patched installer volume, and re-run the post-install patch on your High Sierra volume. Ensure you select 'Force Cache Rebuild' before rebooting.
FAQ:
Q: The tool created the USB drive successfully, but when booting, the progress bar hangs a bit more than half way.
A: Check your copy of the Install macOS High Sierra App. If you're using thelatest version of the tool, you must be using the latest version of theInstall macOS High Sierra App. Version 1.1 ofthe patch tool and older support older versions of the installer app.
Q: The patch tool gives me errors, such as 'Error copying files..'.
A: Check to make sure your USB drive is writeable. Try re-formatting it, or just try a different USB drive.
Q: The patch tool gives me a 'Mounting Failed' error
A: Check to make sure your Install macOS High Sierra App is the correct one.It should be around 5GB in size. If you used the 'Skip App Verification' option, you have most likely selected an invalid app thatdoesn't contain the necessary files.
Q: I cannot open my copy of Install macOS High Sierra with the patch tool.
A: If you downloaded the copy linked above, it is distributed inside aDMG file. You must open this file (mount it) to access the InstallmacOS High Sierra App you need to select.
Q: I don't see my hard drive partition in the installer screen or in the post-install tool.
A: Make sure FileVault is disabled, or use the instructions found here to unlock it manually using Terminal.
Q: I get a 'NO' symbol when starting up after successfully installing High Sierra.
A: Make sure you have run the post-install patch on the correct volume, as detailed above in steps 8-10.
Q: I get a 'NO' symbol when starting up from the patched USB drive
A: Check the supported/not supported list at the top of this page. Ensure your machine is in the supported list.
Q: My iSight camera doesn't work after installing High Sierra
A: Make sure you properly remove (using the program's uninstaller, not by simply dragging the application to the Trash) all virtual machine software installed on your machine, such as VirtualBox, VMWare, etc.
Q: I get 'NSURL' errors when trying to update my machine or use the App Store
A: This is usually the result of having an invalid CatalogURL set. To revert to stock, simply run 'sudo softwareupdate --clear-catalog' in Terminal, and then run the software update patch script located above.
Q: Safari, App Store, and/or Mail stopped working after installing a system update
A: Download and run the Onyx application, select 'Maintenence' at the top, then click the Run button.
Q: I get a 'No packages were eligible for install' error when attepting to install High Sierra
A: This is due to your system's date and time being set incorrectly. To fix it, you can either boot into your current OS X install and set the date, or you can use Terminal after booting from your patched USB installer drive to set the date. Instructions to set the date using Terminal can be found here.