Install Visual Studio 2017

Welcome to a new way to install Visual Studio! In our newest version, we've made it easier for you to select and install just the features you need. We've also reduced the minimum footprint of Visual Studio so that it installs more quickly and with less system impact than ever before.

Want to know more about what else is new in this version? See our release notes.

Ready to install? We'll walk you through it, step-by-step.

Step 1 - Make sure your computer is ready for Visual Studio

Before you begin installing Visual Studio:

  1. Check the system requirements. These requirements help you know whether your computer supports Visual Studio 2017.
  2. Apply the latest Windows updates. These updates ensure that your computer has both the latest security updates and the required system components for Visual Studio.
  3. Reboot. The reboot ensures that any pending installs or updates don't hinder the Visual Studio install.
  4. Free up space. Remove unneeded files and applications from your %SystemDrive% by, for example, running the Disk Cleanup app.

For questions about running previous versions of Visual Studio side by side with Visual Studio 2017, see the Visual Studio compatibility details.

Step 2 - Download Visual Studio

Next, download the Visual Studio bootstrapper file. To do so, click the following button, select the edition of Visual Studio 2017 that you want, click Save, and then click Open folder.

movie camera icon for video Watch a video on how to download the Visual Studio bootstrapper file and select the edition of Visual Studio that's right for you.

Step 3 - Install the Visual Studio installer

Then, run the bootstrapper file to install the Visual Studio Installer. This new lightweight installer includes everything you need to both install and customize Visual Studio 2017.

  1. From your Downloads folder, double-click the bootstrapper that matches or is similar to one of the following files:

    • vs_enterprise.exe for Visual Studio Enterprise
    • vs_professional.exe for Visual Studio Professional
    • vs_community.exe for Visual Studio Community

    If you receive a User Account Control notice, click Yes.

  2. We'll ask you to acknowledge the Microsoft License Terms and the Microsoft Privacy Statement. Click Continue.

    License Terms and Privacy Statement

Step 4 - Select workloads

After the installer is installed, you can use it to customize your installation by selecting the feature sets—or workloads—that you want. Here's how.

  1. Find the workload you want in the Installing Visual Studio screen.

    Visual Studio 2017 setup dialog

    For example, choose the .NET desktop development workload. It comes with the default core editor, which includes basic code editing support for over 20 languages, the ability to open and edit code from any folder without requiring a project, and integrated source code control.

  2. After you select the workload(s) you want, click Install.

    Next, status screens appear that show the progress of your Visual Studio installation.

  3. After the new workloads and components are installed, click Launch.

Tip

At any time after installation, you can install workloads or components that you didn't install initially. If you have Visual Studio open, go to Tools, Get Tools and Features... which opens the Visual Studio Installer. Or, open Visual Studio Installer from the Start menu. From there, you can select the workloads or components that you wish to install, then click Modify.

movie camera icon for video Watch a video on how to install the Visual Studio Installer and then install a workload.

Step 5 - Select individual components (Optional)

If you don't want to use the Workloads feature to customize your Visual Studio installation, you can do so by installing individual components instead. To select individual components, click the Individual components option from the Visual Studio Installer, select what you want, and then follow the prompts.

Visual Studio 2017 - Install individual components

movie camera icon for video Watch a video on how to install an individual component by using the Visual Studio Installer.

Step 6 - Install language packs (Optional)

By default, the installer program tries to match the language of the operating system when it runs for the first time. To install Visual Studio 2017 in a language of your choosing, click the Language packs option from the Visual Studio Installer, and follow the prompts.

Visual Studio 2017 - Install language packs

movie camera icon for video Watch a video on how to install a language pack by using the Visual Studio Installer.

Change the installer language from the command line

Another way that you can change the default language is by running the installer from the command line. For example, you can force the installer to run in English by using the following command: vs_installer.exe --locale en-US. The installer will remember this setting when it is run the next time. The installer supports the following language tokens: zh-cn, zh-tw, cs-cz, en-us, es-es, fr-fr, de-de, it-it, ja-jp, ko-kr, pl-pl, pt-br, ru-ru, and tr-tr.

Step 7 - Start developing

  1. After Visual Studio installation is complete, click the Launch button to get started developing with Visual Studio.

  2. Click File, and then click New Project.

  3. Select a project type.

    For example, to build a C++ app, click Installed, expand Visual C++, and then select the C++ project type that you want to build.

    To build a C# app, click Installed, expand Visual C#, and then select the C# project type that you want to build.

Get support

Sometimes, things can go wrong. If your Visual Studio installation fails, see the Troubleshooting Visual Studio 2017 installation and upgrade issues page. If none of the troubleshooting steps help, you can contact us by live chat for installation assistance (English only). For details, see the Visual Studio support page.

Here are a few more support options:

See also