|
| 1 | +--- |
| 2 | +title: Download and install sqlpackage | Microsoft Docs |
| 3 | +description: 'Download and Install sqlpackage for Windows, macOS, or Linux' |
| 4 | +ms.custom: "tools|sos" |
| 5 | +ms.date: "06/04/2018" |
| 6 | +ms.prod: sql |
| 7 | +ms.reviewer: "alayu; sstein" |
| 8 | +ms.suite: "sql" |
| 9 | +ms.prod_service: sql-tools |
| 10 | +ms.component: sos |
| 11 | +ms.tgt_pltfrm: "" |
| 12 | +ms.topic: conceptual |
| 13 | +author: "stevestein" |
| 14 | +ms.author: "sstein" |
| 15 | +manager: craigg |
| 16 | +--- |
| 17 | +# Download and install sqlpackage |
| 18 | + |
| 19 | +[!INCLUDE[name-sos](../includes/name-sos.md)] runs on Windows, macOS, and Linux. |
| 20 | + |
| 21 | +Download and install the latest release, the *May Public Preview*: |
| 22 | + |
| 23 | +|Platform|Download|Release date| Version | |
| 24 | +|:---|:---|:---|:---| |
| 25 | +|Windows|[Installer](https://go.microsoft.com/fwlink/?linkid=873386)<br>[.zip](https://go.microsoft.com/fwlink/?linkid=873387)|May 7, 2018 |0.29.3| |
| 26 | +|macOS|[.zip](https://go.microsoft.com/fwlink/?linkid=873388)|May 7, 2018 |0.29.3| |
| 27 | +|Linux|[.deb](https://go.microsoft.com/fwlink/?linkid=873391)<br>[.rpm](https://go.microsoft.com/fwlink/?linkid=873390)<br>[.tar.gz](https://go.microsoft.com/fwlink/?linkid=873389)|May 7, 2018 |0.29.3| |
| 28 | + |
| 29 | +For details about the latest release, see the [release notes](release-notes.md). |
| 30 | + |
| 31 | +## Get SQL Operations Studio (preview) for Windows |
| 32 | + |
| 33 | +This release of [!INCLUDE[name-sos](../includes/name-sos-short.md)] includes a standard Windows installer experience, and a .zip: |
| 34 | + |
| 35 | +**Installer** |
| 36 | + |
| 37 | +1. Download and run the [[!INCLUDE[name-sos](../includes/name-sos-short.md)] installer for Windows](https://go.microsoft.com/fwlink/?linkid=873386). |
| 38 | +1. Start the [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] app. |
| 39 | + |
| 40 | + |
| 41 | +**.zip file** |
| 42 | + |
| 43 | +1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] .zip for Windows](https://go.microsoft.com/fwlink/?linkid=873387). |
| 44 | +2. Browse to the downloaded file and extract it. |
| 45 | +3. Run `\sqlops-windows\sqlops.exe` |
| 46 | + |
| 47 | + |
| 48 | +## Get SQL Operations Studio (preview) for macOS |
| 49 | + |
| 50 | +1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] for macOS](https://go.microsoft.com/fwlink/?linkid=873388). |
| 51 | +2. To expand the contents of the zip, double-click it. |
| 52 | +3. To make [!INCLUDE[name-sos](../includes/name-sos-short.md)] available in the *Launchpad*, drag *sqlops.app* to the *Applications* folder. |
| 53 | + |
| 54 | + |
| 55 | +## Get SQL Operations Studio (preview) for Linux |
| 56 | + |
| 57 | +1. Download [!INCLUDE[name-sos](../includes/name-sos-short.md)] for Linux by using one of the installers or the tar.gz archive: |
| 58 | + - [.deb](https://go.microsoft.com/fwlink/?linkid=873391) |
| 59 | + - [.rpm](https://go.microsoft.com/fwlink/?linkid=873390) |
| 60 | + - [.tar.gz](https://go.microsoft.com/fwlink/?linkid=873389) |
| 61 | +1. To extract the file and launch [!INCLUDE[name-sos](../includes/name-sos-short.md)], open a new Terminal window and type the following commands: |
| 62 | + |
| 63 | + **Debian Installation:** |
| 64 | + ```bash |
| 65 | + cd ~ |
| 66 | + sudo dpkg -i ./Downloads/sqlops-linux-<version string>.deb |
| 67 | + |
| 68 | + sqlops |
| 69 | + ``` |
| 70 | + |
| 71 | + **rpm Installation:** |
| 72 | + ```bash |
| 73 | + cd ~ |
| 74 | + yum install ./Downloads/sqlops-linux-<version string>.rpm |
| 75 | + |
| 76 | + sqlops |
| 77 | + ``` |
| 78 | + |
| 79 | + **tar.gz Installation:** |
| 80 | + ```bash |
| 81 | + cd ~ |
| 82 | + cp ~/Downloads/sqlops-linux-<version string>.tar.gz ~ |
| 83 | + tar -xvf ~/sqlops-linux-<version string>.tar.gz |
| 84 | + echo 'export PATH="$PATH:~/sqlops-linux-x64"' >> ~/.bashrc |
| 85 | + source ~/.bashrc |
| 86 | + sqlops |
| 87 | + ``` |
| 88 | + |
| 89 | + > [!NOTE] |
| 90 | + > On Debian, Redhat, and Ubuntu, you may have missing dependencies. Use the following commands to install these dependencies depending on your version of Linux: |
| 91 | + |
| 92 | + |
| 93 | + **Debian:** |
| 94 | + ```bash |
| 95 | + sudo apt-get install libuwind8 |
| 96 | + ``` |
| 97 | + |
| 98 | + **Redhat:** |
| 99 | + ```bash |
| 100 | + yum install libXScrnSaver |
| 101 | + ``` |
| 102 | + |
| 103 | + **Ubuntu:** |
| 104 | + ```bash |
| 105 | + sudo apt-get install libxss1 |
| 106 | + |
| 107 | + sudo apt-get install libgconf-2-4 |
| 108 | + |
| 109 | + sudo apt-get install libunwind8 |
| 110 | + ``` |
| 111 | + |
| 112 | + |
| 113 | +## Uninstall SQL Operations Studio (preview) |
| 114 | + |
| 115 | +If you installed [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] using the Windows installer, then uninstall the same way you remove any Windows application. |
| 116 | + |
| 117 | +If you installed [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] with a .zip or other archive, then simply delete the files. |
| 118 | + |
| 119 | +## Supported Operating Systems |
| 120 | + |
| 121 | +[!INCLUDE[name-sos](../includes/name-sos-short.md)] runs on Windows, macOS, and Linux, and is supported on the following platforms: |
| 122 | + |
| 123 | +### Windows |
| 124 | +- Windows 10 (64-bit) |
| 125 | +- Windows 8.1 (64-bit) |
| 126 | +- Windows 8 (64-bit) |
| 127 | +- Windows 7 (SP1) (64-bit) - Requires [KB2533623](https://www.microsoft.com/en-us/download/details.aspx?id=26767) |
| 128 | +- Windows Server 2016 |
| 129 | +- Windows Server 2012 R2 (64-bit) |
| 130 | +- Windows Server 2012 (64-bit) |
| 131 | +- Windows Server 2008 R2 (64-bit) |
| 132 | + |
| 133 | +### macOS |
| 134 | +- macOS 10.13 High Sierra |
| 135 | +- macOS 10.12 Sierra |
| 136 | + |
| 137 | +### Linux |
| 138 | +- Red Hat Enterprise Linux 7.4 |
| 139 | +- Red Hat Enterprise Linux 7.3 |
| 140 | +- SUSE Linux Enterprise Server v12 SP2 |
| 141 | +- Ubuntu 16.04 |
| 142 | + |
| 143 | +## Check for updates |
| 144 | +To check for latest updates, click the gear icon on the bottom left of the window and click **Check for Updates** |
| 145 | + |
| 146 | +## Next Steps |
| 147 | + |
| 148 | +See one of the following quickstarts to get started: |
| 149 | +- [Connect & Query SQL Server](quickstart-sql-server.md) |
| 150 | +- [Connect & Query Azure SQL Database](quickstart-sql-database.md) |
| 151 | +- [Connect & Query Azure Data Warehouse](quickstart-sql-dw.md) |
| 152 | + |
| 153 | +Contribute to [!INCLUDE[name-sos](../includes/name-sos-short.md)]: |
| 154 | +- [https://github.com/Microsoft/sqlopsstudio](https://github.com/Microsoft/sqlopsstudio) |
| 155 | + |
| 156 | +[Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839) and [usage data collection](usage-data-collection.md). |
0 commit comments