Skip to content

Installation

Gaurav Sharma edited this page Sep 8, 2025 · 16 revisions

Installation Guide

Note: This project is currently in Public Preview, meaning it is still under active development. We are working on core functionalities and gathering more feedback before GA. Please use with caution and avoid production environments.

Windows: mssql-python can be installed with pip

pip install mssql-python

MacOS: mssql-python can be installed with pip

# For Mac, OpenSSL is a pre-requisite - skip if already present
brew install openssl
pip install mssql-python

Linux: mssql-python can be installed with pip

# For Alpine
apk add libtool krb5-libs krb5-dev

# For Debian/Ubuntu  
apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2

# For RHEL
dnf install -y libtool-ltdl krb5-libs

# For SUSE
zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2

# For SUSE/openSUSE
zypper install -y libltdl7

pip install mssql-python

Supported Platforms

Windows, MacOS and Linux (manylinux - Debian, Ubuntu, RHEL, SUSE (x64 only) & musllinux - Alpine)

Note: SUSE Linux ARM64 is not supported by Microsoft ODBC Driver. Use x64 architecture for SUSE deployments. Minimum supported version required for Python is version 3.10.

Using Virtual Environment

1. Create a virtual environment

Open a terminal (cmd / PowerShell on Windows, Terminal on Mac/Linux), switch to your working directory and run: (replace python3 with python in case of error):

python3 -m venv myvenv
2. Activate the virtual environment:
OS Command
Windows myvenv\Scripts\activate
Mac/Linux source myvenv/bin/activate

This should show a prefix (myvenv) in the command prompt.

3. Install mssql-python using pip install
pip install mssql-python
Clone this wiki locally