Create an offline installation of Visual Studio

We designed Visual Studio 2017 to work well in a variety of network and computer configurations. While we recommend that you try the Visual Studio web installer—which is a small file that allows you to stay current with all the latest fixes and features—we understand that you might not be able to.

We designed Visual Studio 2019 to work well in a variety of network and computer configurations. While we recommend that you try the Visual Studio web installer—which is a small file that allows you to stay current with all the latest fixes and features—we understand that you might not be able to.

For example, you might have an unreliable internet connection or one that has low bandwidth. If so, you have a few options: You can use the new "Download all, then install" feature to download the files before you install, or you can use the command line to create a local cache of the files.

Note

If you are an enterprise administrator who wants to perform a deployment of Visual Studio to a network of client workstations that are firewalled from the internet, see our Create a network installation of Visual Studio and Install certificates required for Visual Studio offline installation pages.

Use the "Download all, then install" feature

New in version 15.8: After you download the web installer, select the new Download all, then install option from the Visual Studio Installer. Then, continue with your installation.

The "Download all, then install" option

After you download the web installer, select the new Download all, then install option from the Visual Studio Installer. Then, continue with your installation.

The "Download all, then install" option

We designed the "Download all, then install" feature so that you can download Visual Studio as a single installation for the same computer on which you downloaded it. That way, you can safely disconnect from the web before you install Visual Studio.

Important

Do not use the "Download all, then install" feature to create an offline cache that you intend to transfer to another computer. It's not designed to work that way.

If you want to create an offline cache on the local computer that you can then use to install Visual Studio, see the Use the command line to create a local cache section below. Alternatively, the Create a network installation of Visual Studio page provides information about how to create a cache on the network.

Use the command line to create a local cache

After you download a small bootstrapper, use the command line to create a local cache. Then, use the local cache to install Visual Studio. (This process replaces the ISO files that were available for previous versions).

After you download a small bootstrapper file, use the command line to create a local cache. Then, use the local cache to install Visual Studio.

Step 1 - Download the Visual Studio bootstrapper

You must have an internet connection to complete this step.

To get the latest bootstrapper for Visual Studio 2017 version 15.9, go to the Visual Studio previous versions page and download one of the following bootstrapper files:

Edition Filename
Visual Studio Professional 2017 version 15.9 vs_professional.exe
Visual Studio Enterprise 2017 version 15.9 vs_enterprise.exe
Visual Studio Build Tools 2017 version 15.9 vs_buildtools.exe

Start by downloading the Visual Studio 2019 bootstrapper from either the Visual Studio downloads page or the Visual Studio 2019 Releases page for your chosen version and edition of Visual Studio. Your setup file—or bootstrapper—will match or be similar to one of the following:

Edition File
Visual Studio 2019 Community vs_community.exe
Visual Studio 2019 Professional vs_professional.exe
Visual Studio 2019 Enterprise vs_enterprise.exe
Visual Studio 2019 Build Tools vs_buildtools.exe

Tip

If you previously downloaded a bootstrapper file and want to verify what version it is, here's how. In Windows, open File Explorer, right-click the bootstrapper file, choose Properties, choose the Details tab, and then view the Product version number. To match that number to a release of Visual Studio, refer to the Visual Studio build numbers and release dates page.

Tip

If you previously downloaded a bootstrapper file and want to verify its version, here's how. In Windows, open File Explorer, right-click the bootstrapper file, choose Properties, choose the Details tab, and then view the Product version number. To match that number to a release of Visual Studio, refer to the Visual Studio 2019 Releases page.

Step 2 - Create a local install cache

You must have an internet connection to complete this step.

Open a command prompt and use the bootstrapper's parameters as defined in the Use command-line parameters to install Visual Studio page to create your local installation cache. Common examples using the Enterprise bootstrapper are illustrated below and in 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 cache.

Tip

To prevent an error, make sure that your full installation path is less than 80 characters.

  • For .NET web and .NET desktop development, run:

      vs_enterprise.exe --layout c:\vslayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --add Component.GitHub.VisualStudio --includeOptional --lang en-US
    
  • For .NET desktop and Office development, run:

      vs_enterprise.exe --layout c:\vslayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.Office --includeOptional --lang en-US
    
  • For C++ desktop development, run:

      vs_enterprise.exe --layout c:\vslayout --add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --lang en-US
    
  • To create a complete local layout, English only, with all features (this will take a long time—we have lots of features!), run:

      vs_enterprise.exe --layout c:\vslayout --lang en-US
    

Note

A complete Visual Studio layout requires a minimum of 35 GB of disk space. For more information, see System requirements.

Note

A complete Visual Studio layout requires a minimum of 35 GB of disk space. For more information, see System requirements.

Step 3 - Install Visual Studio from the local cache

When you install Visual Studio from a local install cache, the Visual Studio installer uses the local cached versions of the files. But, if you select components during installation that aren't in the cache, 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 layout cache.

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

vs_enterprise.exe --layout c:\vslayout --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:

c:\vslayout\vs_enterprise.exe --noweb --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --add Component.GitHub.VisualStudio --includeOptional

Important

If you're using Visual Studio Community, you must activate it by logging into the product within 30 days of installation. Activation requires an internet connection.

Note

If you get an error that a signature is invalid, you must install updated certificates. Open the Certificates folder in your offline cache. 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.

Tip

For offline installations, if you get an error message that says "A product matching the following parameters cannot be found", make sure that you are using the --noweb switch with version 16.3.5 or later.

List of language locales

Language-locale Language
cs-CZ Czech
de-DE German
en-US English
es-ES Spanish
fr-FR French
it-IT Italian
ja-JP Japanese
ko-KR Korean
pl-PL Polish
pt-BR Portuguese - Brazil
ru-RU Russian
tr-TR Turkish
zh-CN Chinese - Simplified
zh-TW Chinese - Traditional

Get support

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

We also offer an installation chat (English only) support option for installation-related issues.

Here are a few more support options:

See also