Install Visual Studio 2019 for Mac

To start developing native, cross-platform .NET apps on macOS, install Visual Studio 2019 for Mac following the steps below.


  • A Mac with macOS High Sierra 10.12 or above.

To build Xamarin apps for iOS or macOS, you'll also need:

  • Xcode 10.0 or above. The latest stable version is usually recommended.
  • An Apple ID. If you don't have an Apple ID already you can create a new one at It's necessary to have an Apple ID for installing and signing into Xcode.

Installation instructions

  1. Download the installer from the Visual Studio for Mac download page.

  2. Once the download is complete, click the VisualStudioforMacInstaller.dmg to mount the installer, then run it by double-clicking the arrow logo:

    Click the large arrow to begin installation

  3. You may be presented with a warning about the application being downloaded from the Internet. Click Open.

  4. Wait while the installer checks your system:

    The installer checks your system for installed components

  5. An alert will appear asking you to acknowledge the privacy and license terms. Follow the links to read them, then press Continue if you agree:

    Follow the links to the privacy and terms, then continue if you agree

  6. The list of available workloads is displayed. Select the components you wish to use:

    Choose which optional workload features you would like to install

    If you do not wish to install all platforms, use the guide below to help you decide which platforms to install:

    • Apps using Xamarin:
      • Xamarin.Forms – Select Android and iOS platforms.
      • iOS only – Select iOS platform (Note that you will need to install Xcode).
      • Android only – Select Android platform (Note that you should also select the relevant dependencies).
      • Mac only – Select macOS platform (Note that you will need to install Xcode).
      • Fully cross-platform Xamarin apps – Select Android, iOS, and macOS platforms.
    • .NET Core applications – Select .NET Core platform.
    • ASP.NET Core Web Applications – Select .NET Core platform.
    • Cross-platform Unity Game Development – No additional platforms need to be installed beyond Visual Studio for Mac. Refer to the Unity setup guide for more information on installing the Unity extension.
  7. After you have made your selections, press the Install button.

  8. The installer will display progress as it downloads and installs Visual Studio for Mac and the selected workloads. You might be prompted to enter your password to grant the privileges necessary for installation.

If you have network trouble while installing in a corporate environment, review the installing behind a firewall or proxy instructions.

Learn more about the changes in the release notes.


If you chose not to install a platform or tool during the original installation (by unselecting it in step #6), you must run the installer again if you wish to add the components later.

Install Visual Studio for Mac behind a firewall or proxy server

To install Visual Studio for Mac behind a firewall, certain endpoints must be made accessible in order to allow downloads of the required tools and updates for your software.

Configure your network to allow access to the following locations:

Next steps

Installing Visual Studio for Mac allows you to start writing code for your apps. The following guides are provided to guide you through the next steps of writing and deploying your projects.


  1. Hello, iOS
  2. Device Provisioning(To run your application on device).


  1. Using the Xamarin Android SDK Manager
  2. Android SDK Emulator
  3. Set Up Device for Development

.NET Core apps, ASP.NET Core web apps, Unity game development

For other Workloads, refer to the Workloads page.

See also