CodeQL documentation

System requirements

System requirements for running the latest version of CodeQL.

Supported platforms

Operating system Supported versions Supported CPU architectures

Ubuntu 18.04

Ubuntu 20.04

Ubuntu 21.04

Ubuntu 22.04


Windows 10 / Windows Server 2019

Windows 11 / Windows Server 2022


macOS 10.15 Catalina

macOS 11 Big Sur

macOS 12 Monterey


x86-64, arm64 (Apple Silicon)

x86-64, arm64 (Apple Silicon) [1]

[1]Support for Apple Silicon is currently in beta.


CodeQL analysis for Kotlin is currently in beta. During the beta, analysis of Kotlin code, and the accompanying documentation, will not be as comprehensive as for other languages.

Additional software requirements

To generate a CodeQL database for a compiled language, you must ensure that the system can successfully build and compile your code, independently of CodeQL.

In addition, CodeQL extraction has the following requirements.

For extraction of compiled languages (C/C++, C#, Go, Java) and Ruby on Linux:

  • glibc version 2.17 or greater must be installed.
  • musl-c-based Linux distributions, such as Alpine Linux, are not supported.

For TypeScript extraction on all platforms:

  • Node.js must be installed and available on the PATH as node.

For Python extraction:

  • On Linux and macOS, Python 3 must be installed and available on the PATH as python3 or python.
  • For Python 2 extraction on Linux and macOS, we also recommend having Python 2 installed and available on the PATH as python2.
  • On Windows, the Python launcher must be installed and available on the PATH as py.exe.
  • © GitHub, Inc.
  • Terms
  • Privacy