Create an offline installation of Visual Studio 2017 RC

Create a layout

If you want to install Visual Studio 2017 RC on another machine that doesn't have internet access, you can do so by first creating an offline installation layout that contains all the Visual Studio files and components you need.

You can then install Visual Studio to the target machine by using the offline installation layout that you created.

Warning

Currently, the Android SDK does not support an offline installation experience. If you install Android SDK Setup items on a computer that is not connected to the internet, the installation might fail. For more information about this, go to the Troubleshoot an offline installation section in this topic.

To create an offline installation layout of Visual Studio

  1. Download the Visual Studio setup executable file to a drive on your local machine. For example, download the vs_enterprise.exe file.
  2. Run vs_enterprise.exe with the following arguments (switches) from a command prompt:

    a. Add --layout <path>, where <path> is the location where you want the layout to download to. Note that relative paths (e.g. ..\vs2017) are not supported at present. By default, all languages are downloaded. (See Example A.)

    b. Restrict the download to a subset of the available languages by providing the --lang <language> argument, where <language> is one or more of the language-locales. (See Example B and Example C.)

    c. Restrict the download to a subset of Workloads and Components by providing the --add <package ID> argument. This will download only the workloads and components (and their dependencies) that you specify. (See Example D and Example E.)

    For a full list of workload and component IDs sorted by Visual Studio product, see our Visual Studio 2017 Workload and Component IDs page.

Examples

Example A: Download all workloads and components for all languages

vs_enterprise.exe --layout C:\vs2017

Example B: Download all workloads and components for one language

vs_enterprise.exe --layout C:\vs2017 --lang en-US

Example C: Download all workloads and components for multiple languages

vs_enterprise.exe --layout C:\vs2017 --lang en-US de-DE ja-JP

Example D: Download one workload for all languages

vs_enterprise.exe --layout C:\vs2017 --add Microsoft.VisualStudio.Workload.Azure

Example E: Download two workloads and one optional component for three languages

vs_enterprise.exe --layout C:\vs2017 --add Microsoft.VisualStudio.Workload.Azure Microsoft.VisualStudio.Workload.ManagedDesktop Component.GitHub.VisualStudio --lang en-US de-DE ja-JP

Warning

The --layout parameter will fail if the setup .exe file name includes numerals. To work around this issue, you must remove the numerals from the filename—for example, rename vs_community__198521760.1486960229.exe to vs_community.exe.

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

Install from a layout

To install Visual Studio from an offline installation layout

  1. On the target machine, navigate to the Certificates folder, which is in the Layout folder.
  2. Right-click and install each certificate in the Certificates folder.

    (If you are prompted for a password after you install a certificate, click Continue.)

  3. Run vs_enterprise.exe from the Layout folder.

Note: If you are installing from a partial layout and select workloads, components or languages that are not available in the layout, setup will attempt to download them. If you do not have internet access, those items will fail to install.

Caution

The offline installation layout currently creates some files with restricted permissions (ACLs) that prevent access by all users. Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.

Update an installation layout

As updates become available for Visual Studio 2017 RC, you can run the --layout command again, pointing to the same layout folder, to ensure that the folder contains the latest components. Only those components that have been updated since the last time --layout was run will be downloaded.

Troubleshoot an installation layout

When you install offline from your offline install cache, you might see warning messages about not being able to install some components and packages. The following table includes possible solutions for these scenarios.

Component or Package Solution
Android SDK Setup (API Level) You must have an internet connection to install Android SDK (API Level) packages. If you are on a restricted network, you must allow access to the following URLs when you install Visual Studio:

- http://dl.google.com:443
- http://dl-ssl.google.com:443
- https://dl-ssl.google.com/android/repository/*

For more information about how to resolve possible issues with proxy settings, see the Visual Studio install failures (Android SDK Setup) behind a Proxy blog post.
Important

While Visual Studio 2017 RC in general is supported for use in a production environment, those workloads and components that are marked "Preview" in the installation UI are not supported for use in a production environment.

See also