|
| 1 | +--- |
| 2 | +title: "Install and use Visual Studio for Mac behind a firewall or proxy server" |
| 3 | +description: "This document provides a list of hosts that must be whitelisted in your firewall to allow Visual Studio for Mac (and its workloads, including Xamarin) to work in a corporate environment." |
| 4 | +ms.topic: troubleshooting |
| 5 | +ms.assetid: 79C0F1A3-0C13-4E55-A820-1138A4082B77 |
| 6 | +author: asb3993 |
| 7 | +ms.author: amburns |
| 8 | +ms.date: 10/23/2018 |
| 9 | +--- |
| 10 | + |
| 11 | +# Install and use Visual Studio for Mac behind a firewall or proxy server |
| 12 | + |
| 13 | +If you or your organization uses security measures such as a firewall or a proxy server, then there are domain URLs that you might want to "whitelist" and ports and protocols that you might want to open so that you have the best experience when you install and use Visual Studio for Mac and Azure Services. |
| 14 | + |
| 15 | +- [**Install Visual Studio for Mac**](#install-visual-studio-for-mac): These tables include the URLs to whitelist so that you have access to all features and workloads of Visual Studio for Mac. |
| 16 | + |
| 17 | +- [**Use Visual Studio for Mac**](#use-visual-studio-for-mac): These tables include URLs to whitelist so that you have access to all of the services and features that you want. |
| 18 | + |
| 19 | +## Install Visual Studio for Mac |
| 20 | + |
| 21 | +Because the Visual Studio for Mac Installer downloads from a various domains and download servers, here are the domains and URLs that you may want to add as trusted in your configurations. |
| 22 | + |
| 23 | +### Microsoft domains |
| 24 | + |
| 25 | +| Domain| Purpose | |
| 26 | +| ----------------------------------- |---------------------------| |
| 27 | +| *.live.com| Credential Management | |
| 28 | +| app.vssps.visualstudio.com| Installer Metadata| |
| 29 | +| vortex.data.microsoft.com | Crash and Error Reporting | |
| 30 | +| az667904.vo.msecnd.net| Crash and Error Reporting | |
| 31 | +| xamarin.com | Installer Metadata| |
| 32 | +| xampubdl.blob.core.windows.net| Installer Packages| |
| 33 | +| download.visualstudio.microsoft.com | Installer Packages| |
| 34 | +| xamarin.azureedge.net | Installer Packages| |
| 35 | +| developer.xamarin.com | Installer Packages| |
| 36 | +| dc.services.visualstudio.com| Crash Reporting | |
| 37 | + |
| 38 | +### Third party domains |
| 39 | + |
| 40 | +| Domain| Purpose | |
| 41 | +| --------------------------|-------------------------| |
| 42 | +| dl.google.com | Android SDK | |
| 43 | +| download.oracle.com | Java SDK| |
| 44 | +| api.apple-cloudkit.com| Apple Security Services | |
| 45 | + |
| 46 | +## Use Visual Studio for Mac |
| 47 | + |
| 48 | +To make sure that you have access to every feature that you need in Visual Studio for Mac while behind a proxy or firewall, we recommend whitelisting the following domains and ports. |
| 49 | + |
| 50 | +### General |
| 51 | + |
| 52 | +| Domain | Port(s)|Purpose| |
| 53 | +| ----------------------|------------------|------------------| |
| 54 | +| go.microsoft.com | 80/443|Microsoft URL Resolution | |
| 55 | +| vsstartpage.blob.core.windows.net| 80/443| Start Page Data| |
| 56 | +| software.xamarin.com | 80/443|Updater Service| |
| 57 | +| addins.monodevelop.com | 80/443| Extension Services | |
| 58 | +| visualstudio-devdiv-c2s.msedge.net | 80/443| Experimental Feature and Notifications | |
| 59 | +| targetednotifications.azurewebsites.net| 80/443| Used to filter a global list of notifications to a list that is applicable only to specific types of machines/usage scenarios| |
| 60 | + |
| 61 | +### Identity |
| 62 | + |
| 63 | +| Domain | Port(s)|Purpose| |
| 64 | +| ----------------------|------------------|------------------| |
| 65 | +| login.microsoftonline.com | 80/443| Identity Provider| |
| 66 | +| secure.aadcdn.microsoftonline-p.com | 80/443|Identity Provider| |
| 67 | +| dc.services.visualstudio.com| 80/443|Crash Reporting| |
| 68 | +| management.azure.com|80/443| Azure Services API | |
| 69 | + |
| 70 | +### NuGet |
| 71 | + |
| 72 | +| Domain | Port(s)|Purpose| |
| 73 | +| ----------------------|------------------|------------------| |
| 74 | +| api.nuget.org | 80/443|NuGet API| |
| 75 | +| secure.aadcdn.microsoftonline-p.com |80/443| Identity Provider| |
| 76 | + |
| 77 | +### Android projects |
| 78 | + |
| 79 | +| Domain| Purpose| |
| 80 | +| ------------------------------------|------------------------------------| |
| 81 | +| time.android.com| Time Server for Android Emulator | |
| 82 | +| connectivitycheck.gstatic.com | Connectivity for Android Emulator| |
| 83 | +| cloudconfig.googleapis.com| APIs for Android Emulator| |
| 84 | + |
| 85 | +## See also |
| 86 | + |
| 87 | +- [Install and use Visual Studio 2017 and Azure Services behind a firewall or proxy server](https://docs.microsoft.com/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server) |
| 88 | +- [Troubleshooting similar issues on Windows](https://docs.microsoft.com/visualstudio/install/troubleshooting-network-related-errors-in-visual-studio) |
0 commit comments