> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qlty.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# System Requirements

Qlty CLI supports the following systems:

| Operating System | X86 | Arm64 |
| ---------------- | --- | ----- |
| macOS Sonoma 14+ | ✅   | ✅     |
| Linux 6.1+       | ✅   | ✅     |
| Windows 11+      | ✅   |       |

## Linux support

Our official support targets the following Linux distributions:

* Ubuntu 22.04 LTS+
* Debian Bookworm 12+
* Fedora 41+

The Qlty CLI works on other Linux distributions, however we do not provide support for them.

### GLIBC and MUSL

Qlty CLI builds against both the GNU C Library (glibc) and the MUSL C library.

When using GLIBC, we require a minimum version of glibc 2.38, which is available on most modern Linux distributions. Some older distributions, notably Amazon Linux 2023 (AL2023) do not meet this requirement. If you are using AL2023, you have the option to run the Qlty CLI in a Docker container.

## Optional Dependencies

### Ruby plugins

Qlty installs a binary installation of the Ruby interpreter but may still need a few system dependencies to compile
Ruby plugins via RubyGems. As a result, you may need to manually install a few extra dependencies before linting
Ruby code with the Qlty CLI.

On macOS, Qlty requires [Homebrew](https://brew.sh) to install Ruby and run Ruby-based plugins. You must also install
the following dependencies:

```bash Install Ruby on macOS with Homebrew lines theme={"system"}
brew install gmp openssl libyaml
```

On Linux, you should install a compiler toolchain such as `build-essential` on Ubuntu or similar. Currently we only
support running Ruby plugins on glibc based distributions.

> **Note:** Ubuntu 20.04 and earlier are no longer supported for Ruby binary installs, as upstream Ruby packages for these versions have been removed.
> To ensure compatibility, please upgrade to a [supported Ubuntu version](https://github.com/ruby/ruby-builder/releases/tag/toolcache).

On Windows, we rely on the system Ruby installation. You can install Ruby using your preferred package manager
or using [RubyInstaller](https://rubyinstaller.org/) directly.

### PHP plugins

To run plugins implemented in PHP, we require that PHP be installed on the system into a standard directory.

On macOS systems, `php` can be installed with Homebrew:

```bash Install PHP on macOS with Homebrew lines theme={"system"}
brew install php
```

## See Also

* [Debugging](/cli/debugging)