Download and install Azure Data Studio

9/22/2020

5 minutes to read

+5



In this article

Azure Data Studio runs on Windows, macOS, and Linux.

Download and install the latest release:

Note If you're updating from SQL Operations Studio and want to keep your settings, keyboard shortcuts, or code snippets, see Move user settings.

For details about the latest release, see the release notes.

Get Azure Data Studio for Windows

This release of Azure Data Studio includes a standard Windows Installer experience, and a .zip file.

The user installer is recommended because it does not require administrator privileges, which simplify both installs and upgrades. The user installer does not require Administrator privileges as the location is under your user Local AppData (LOCALAPPDATA) folder. The user installer also provides a smoother background update experience. For more information, see User setup for Windows.

User Installer (recommended)

Download and run the Azure Data Studio user installer for Windows. Start the Azure Data Studio app.

System Installer

Download and run the Azure Data Studio system installer for Windows. Start the Azure Data Studio app.

.zip file

Download Azure Data Studio .zip for Windows. Browse to the downloaded file and extract it. Run \azuredatastudio-windows\azuredatastudio.exe

Get Azure Data Studio for macOS

Download Azure Data Studio for macOS. To expand the contents of the zip, double-click it. To make Azure Data Studio available in the Launchpad, drag Azure Data Studio.app to the Applications folder.

Get Azure Data Studio for Linux

Download Azure Data Studio for Linux by using one of the installers or the tar.gz archive: .deb

.rpm

.tar.gz To extract the file and launch Azure Data Studio, open a new Terminal window and type the following commands: Debian Installation: cd ~ sudo dpkg -i ./Downloads/azuredatastudio-linux-<version string>.deb azuredatastudio rpm Installation: cd ~ yum install ./Downloads/azuredatastudio-linux-<version string>.rpm azuredatastudio tar.gz Installation: cd ~ cp ~/Downloads/azuredatastudio-linux-<version string>.tar.gz ~ tar -xvf ~/azuredatastudio-linux-<version string>.tar.gz echo 'export PATH="$PATH:~/azuredatastudio-linux-x64"' >> ~/.bashrc source ~/.bashrc azuredatastudio Note On Debian, Redhat, and Ubuntu, you may have missing dependencies. Use the following commands to install these dependencies depending on your version of Linux: Debian: sudo apt-get install libunwind8 Redhat: yum install libXScrnSaver Ubuntu: sudo apt-get install libxss1 sudo apt-get install libgconf-2-4 sudo apt-get install libunwind8

Download Insiders build of Azure Data Studio

In general, users should download the stable release of Azure Data Studio above. However, if you want to try out our beta features and give us feedback, you can download an Insiders build of Azure Data Studio.

Uninstall Azure Data Studio

If you installed Azure Data Studio using the Windows Installer, then uninstall the same way you remove any Windows application.

If you installed Azure Data Studio with a .zip or other archive, then simply delete the files.

Supported Operating Systems

Azure Data Studio runs on Windows, macOS, and Linux, and is supported on the following platforms:

Windows

Windows 10 (64-bit)

Windows 8.1 (64-bit)

Windows 8 (64-bit)

Windows 7 (SP1)

Windows Server 2019

Windows Server 2016

Windows Server 2012 R2 (64-bit)

Windows Server 2012 (64-bit)

Windows Server 2008 R2 (64-bit)

macOS

macOS 10.15 Catalina

macOS 10.14 Mojave

macOS 10.13 High Sierra

macOS 10.12 Sierra

Linux

Red Hat Enterprise Linux 7.4

Red Hat Enterprise Linux 7.3

SUSE Linux Enterprise Server v12 SP2

Ubuntu 16.04

Recommended System Requirements

Recommended/Minimum CPU Cores Memory/RAM Recommended 4 8 GB Minimum 2 4 GB

To check for latest updates, click the gear icon on the bottom left of the window and click Check for Updates.

In an offline environment updates can be applied by installing the latest version directly over a previously installed version. Uninstalling prior versions of Azure Data Studio is not necessary as the installer updates a currently installed application, if present.

Supported SQL offerings

This version of Azure Data Studio works with all supported versions of SQL Server 2014 - SQL Server 2019 (15.x) and provides support for working with the latest cloud features in Azure SQL Database and Azure SQL Data Warehouse. Azure Data Studio also provides preview support for Azure SQL Managed Instance.

Upgrade from SQL Operations Studio

If you are still using SQL Operations Studio, you need to upgrade to Azure Data Studio. SQL Operations Studio was the preview name and preview version of Azure Data Studio. In September 2018, we changed the name to Azure Data Studio and released the General Availability (GA) version. Because SQL Operations Studio is no longer being updated or supported, we ask all SQL Operations Studio users to download the latest version of Azure Data Studio to get the latest features, security updates, and fixes.

When upgrading from the old preview to the latest Azure Data Studio, you will lose your current settings and extensions. To move your settings, follow the instructions in the following Move user settings section:

Move user settings

If you want to move your custom settings, keyboard shortcuts, or code snippets, follow the steps below. This is important to do if you are upgrading from SQL Operations Studio version to Azure Data Studio.

If you already have Azure Data Studio, or you've never installed or customized SQL Operations Studio, then you can ignore this section.

Open Settings by clicking the gear on the bottom left and clicking Settings. Right-click the User Settings tab on top and click Reveal in Explorer Copy all files in this folder and save in an easy to find location on your local drive, like your Documents folder. In your new version of Azure Data Studio, follow steps 1-2, then for step 3 paste the contents you saved into the folder. You can also manually copy over the settings, keybindings, or snippets in their respective locations. If overriding an existing installation, delete the old install directory before installation to avoid errors connecting to your Azure account for the resource explorer.

Next Steps

See one of the following quickstarts to get started:

Contribute to SQL documentation

Did you know that you could edit the content yourself? If you do so, not only will our documentation improve, but you'll also be credited as a contributor to the page.

Microsoft Privacy Statement and usage data collection.