System Requirements
Qlty CLI supports the following systems:
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 to install Ruby and run Ruby-based plugins. You must also install the following dependencies:
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.
On Windows, we rely on the system Ruby installation. You can install Ruby using your preferred package manager or using RubyInstaller 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: