Create an offline installation of Visual Studio 2017

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 and 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 2017 to a network of client workstations that are firewalled from the internet, see our Create a network installation of Visual Studio 2017 and Install certificates required for Visual Studio offline installation pages.

Use the "Download all, then install" feature

New in 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

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.)

Here's how.

Step 1 - Download the Visual Studio bootstrapper

You must have an internet connection to complete this step.

Start by downloading the Visual Studio bootstrapper for your chosen edition of Visual Studio. Your setup file—or bootstrapper—will match or be similar to one of the following.

Edition File
Visual Studio Community vs_community.exe
Visual Studio Professional vs_professional.exe
Visual Studio Enterprise vs_enterprise.exe

Step 2 - Create a local install cache

You must have an internet connection to complete this step.

Important

If you install Visual Studio Community 2017, you must activate it within 30 days of installation. This requires an internet connection.

Open a command prompt and use one of the commands from the following examples. The examples that are listed here assume that you're using the Community edition of Visual Studio; adjust the command as appropriate for your edition.

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

    vs_community.exe --layout c:\vs2017layout --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_community.exe --layout c:\vs2017layout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.Office --includeOptional --lang en-US

  • For C++ desktop development, run:

    vs_community.exe --layout c:\vs2017layout --add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --lang en-US

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

    vs_community.exe --layout c:\vs2017layout --lang en-US

If you want to install a language other than English, change en-US to a locale from the List of language locales. Then, use the list of the components and workloads available to further customize your installation cache.

Important

A complete Visual Studio 2017 layout requires at least 35 GB of disk space and can take some time to download. See Use command-line parameters to install Visual Studio 2017 for information on how to create a layout with only the components you want to install.

Step 3 - Install Visual Studio from the local cache

Tip

When you run from a local install cache, setup uses the local versions of each of these files. But if you select components during installation that aren't in the cache, setup attempts 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 layout cache with the following command:

vs_community.exe --layout c:\vs2017layout --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:\vs2017layout\vs_community.exe --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --add Component.GitHub.VisualStudio --includeOptional

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.

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 Troubleshooting Visual Studio 2017 installation and upgrade issues for step-by-step guidance.

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

Here are a few more support options:

See also