Create an offline installation package of Visual Studio for local installation

We designed Visual Studio to work well in various computer configurations. The information on this page discusses how to create an offline installation package of files for installation on the local machine.

Important

If you are an enterprise IT administrator who wants to perform a deployment of Visual Studio throughout a network of client workstations, or if you need to create an installation package of files to transfer to or install onto another machine, refer to our Visual Studio Administrators Guide, the create a network-based installation of Visual Studio page, and the deploy a layout onto a client machine documentation.

Use the "Download all, then install" feature

Sometimes online access is problematic. For example, you might have an unreliable internet connection or your internet connection might have low bandwidth. For situations like these, we've made additional methods available for acquiring Visual Studio. You can use the Download all, then install feature from the Visual Studio Installer to download an installation package on the local machine before you install it locally, or you can use the command line to create a local installation package to install locally later.

To download a local installation package, select the Download all, then install option in the dropdown at the bottom of the Workloads tab of the Visual Studio Installer. The purpose of this feature is to frontload the downloading of the Visual Studio packages onto the same computer that you plan on eventually installing Visual Studio on. By downloading the packages locally first, you can then safely disconnect from the internet before you install Visual Studio.

The "Download all, then install" option

Note

The Download all, then install functionality downloads a Visual Studio installation package that is customized to the local machine. Do not try to transfer this downloaded installation package to another computer, as it's not designed to work that way. Instead, if you want to download an installation package, host it on a network share or an intranet website, and transfer it to or install it on another machine, then you'll need to create a network layout as described in the create a network-based installation of Visual Studio documentation.

You can also configure future updates of Visual Studio to respect the Download all, then install behavior. For more information, refer to the installation and download behavior documentation.

Use the command line to create a local layout

Step 1 - Download the Visual Studio bootstrapper

Download the correct bootstrapper for the version and edition of Visual Studio you want and copy it into the directory that you want to serve as the source location of your local layout. The bootstrapper is the executable that you use to create, update, or modify your local layout. You must have an internet connection to complete this step.

Step 2 - Create a local layout

Open a command prompt with administrator privileges, navigate to the directory where you downloaded the bootstrapper, and use the bootstrapper's parameters to create your local layout. Note that you must have an internet connection to complete this step. Common local layout creation examples are illustrated below. Additional examples can be found on the create a network layout of Visual Studio page and on the command-line parameter examples page. You can install a language other than English by changing en-US to a locale from the list of language locales, and you can use the list of components and workloads to further customize your local layout.

  • To create a complete local layout with all features and all languages (this will take a long time—we have lots of features!), run:

      vs_enterprise.exe --layout c:\localVSlayout
    

Note

Make sure that your full installation path is less than 80 characters and that your machine has ample storage. A complete local layout of Visual Studio requires a minimum of 41 GB of disk space. For more information, see System requirements.

Note

Make sure that your full installation path is less than 80 characters and that your machine has ample storage. A complete local layout of Visual Studio requires a minimum of 45 GB of disk space. For more information, see System requirements.

  • For .NET web and .NET desktop development for only one language, run:

      vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --lang en-US
    
  • For C++ desktop development including all recommended and optional components, for only one language run:

      vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --includeOptional --lang en-US 
    
  • You can also use an exported vsconfig file to customize the layout content, verify a layout or fix a layout.

Step 3 - Install Visual Studio from the local layout

When you install Visual Studio from a local layout, the Visual Studio installer uses the local versions of the files. But, if you select components during installation that aren't in the layout, then the Visual Studio installer will attempt to download them from the internet. To make sure that you install only the files that you've previously downloaded, use the same command-line options that you used to create the local layout. To make sure your installer doesn't try to access the internet when it's installing the product, use the --noweb switch.

For example, if you created a local installation layout with the following command:

vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --add Component.GitHub.VisualStudio --includeOptional --lang en-US

Then use this command to run the installation and prevent the client machine from accessing the internet:

c:\localVSlayout\vs_enterprise.exe --noWeb --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --add Component.GitHub.VisualStudio --includeOptional
vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional --lang en-US

Then use this command to run the installation and prevent the client machine from accessing the internet:

c:\localVSlayout\vs_enterprise.exe --noWeb --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional

Important

If you're using Visual Studio Community, you might be prompted to sign in within 30 days of installation, but it won't impact your ability to use the product.

Note

If you get an error that a signature is invalid, you must install updated certificates. Open the Certificates folder in your local layout. Double-click each of the certificate files, and then click through the Certificate Manager wizard. If you're asked for a password, leave it blank.

Support or troubleshooting

Sometimes, things can go wrong. If your Visual Studio installation fails, see Troubleshoot Visual Studio installation and upgrade issues for step-by-step guidance.

Here are a few more support options:

  • We offer an installation chat (English only) support option for installation-related issues.
  • Report product issues to us via the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE. If you're an IT Administrator and don't have Visual Studio installed, you can submit IT Admin feedback here.
  • Suggest a feature, track product issues, and find answers in the Visual Studio Developer Community.