# Install sqlfluff with Homebrew, apt, Nix, pacman

SQL linter and auto-formatter for Humans. Version 4.2.2 via Homebrew; verified 2026-06-05.

## Install

```sh
sudo av install brew:sqlfluff
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install sqlfluff
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install sqlfluff
```

  Evidence: Debian stable package indexes: sqlfluff from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#sqlfluff
```

  Evidence: nixpkgs package indexes: pkgs/by-name/sq/sqlfluff/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S sqlfluff
```

  Evidence: Arch Linux sync databases: sqlfluff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:sqlfluff
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/sqlfluff>
- **Version:** 4.2.2
- **Source summary:** SQL linter and auto-formatter for Humans
- **Homepage:** <https://docs.sqlfluff.com/>
- **Repository:** <https://github.com/sqlfluff/sqlfluff>
- **Upstream docs:** <https://docs.sqlfluff.com/>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/af/a3/fa28d6db93930f349a7c99774ae7b4b9c85865a780f98ef1ddeb52abdf5a/sqlfluff-4.2.2.tar.gz>
- **Last updated:** 2026-06-05T19:11:50Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- sqlfluff (cli)
- sqlfluff (alias)

## Dependencies

- libyaml
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.2.2
- Package-manager updated: 2026-06-05
- Local data: ok
- Upstream repository: https://docs.sqlfluff.com/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

SQLFluff is a Python-based SQL linter and auto-formatter designed for dialect-flexible SQL, templated SQL, and analytics engineering workflows such as dbt and Jinja.

### Project history

The SQLFluff repository was created in 2018. Early GitHub releases in November 2018 describe the first functional release, usable linting, and alpha autocorrection; by late 2019 the project had alpha templating support.

The README describes the project as a dialect-flexible and configurable linter that can auto-fix many linting errors, supports many SQL dialects, and supports templating systems including Jinja and dbt.

### Adoption history

SQLFluff grew with analytics-engineering and ELT workflows where SQL style, templating, and CI linting matter. The input package metadata lists Homebrew, Debian, Ubuntu, Arch, and Nix packages, showing that it moved beyond pip into system package-manager culture.

### How it is used

Typical CLI usage is sqlfluff lint or sqlfluff fix against SQL files, with dialect and templater behavior configured through files such as .sqlfluff, setup.cfg, tox.ini, pep8.ini, or pyproject.toml.

### Why package nerds care

Package nerds care about SQLFluff because it made SQL linting feel like a normal developer-tooling dependency: install it from a package manager, pin it in CI, run it over generated or templated SQL, and keep database code review from becoming pure style debate.

### Timeline

- 2018: GitHub repository created.
- 2018: First functional release and usable linting releases published.
- 2019: First alpha release with templating support published.
- Current README: project documents many dialects, Jinja and dbt templating, CLI lint/fix usage, Docker image, and monthly releases.

### Related projects

- SQLFluff is closely associated with dbt and Jinja workflows, and its README also points to a VS Code extension and official Docker image.

### Sources

- <https://api.github.com/repos/sqlfluff/sqlfluff>
- <https://api.github.com/repos/sqlfluff/sqlfluff/releases>
- <https://docs.sqlfluff.com/en/stable/configuration/setting_configuration.html>
- <https://github.com/sqlfluff/sqlfluff#readme>
- input.source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for sqlfluff. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: setup.cfg, tox.ini, pep8.ini, .sqlfluff, pyproject.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** sqlfluff
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - sqlfluff - 3.3.1-1: normalized package name match | Debian stable package indexes: sqlfluff from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | SQL linter tool | https://www.sqlfluff.com/
- Debian apt - sqlfluff-doc - 3.3.1-1: normalized package name match | Debian stable package indexes: sqlfluff-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | SQL linter tool - documentation | https://www.sqlfluff.com/
- Nix - sqlfluff: normalized package name match | nixpkgs package indexes: pkgs/by-name/sq/sqlfluff/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - sqlfluff - 2.3.5-1: normalized package name match | Ubuntu 24.04 LTS package indexes: sqlfluff from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | SQL linter tool | https://www.sqlfluff.com/
- Ubuntu apt - sqlfluff-doc - 2.3.5-1: normalized package name match | Ubuntu 24.04 LTS package indexes: sqlfluff-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | SQL linter tool - documentation | https://www.sqlfluff.com/
- pacman - sqlfluff - 4.2.2-1: normalized package name match | Arch Linux sync databases: sqlfluff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A dialect-flexible and configurable SQL linter | https://github.com/sqlfluff/sqlfluff


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [sqruff](https://www.automicvault.com/pkg/brew/sqruff/) - Shares av.db curated category or tags: cli, developer-tools, formatter, linter, sql.
- [protolint](https://www.automicvault.com/pkg/brew/protolint/) - Shares av.db curated category or tags: cli, developer-tools, formatter, linter, linting.
- [sleek](https://www.automicvault.com/pkg/brew/sleek/) - Shares av.db curated category or tags: cli, developer-tools, formatter, sql.
- [sql-lint](https://www.automicvault.com/pkg/brew/sql-lint/) - Shares av.db curated category or tags: cli, developer-tools, linter, sql.
- [sqlfmt](https://www.automicvault.com/pkg/brew/sqlfmt/) - Shares av.db curated category or tags: cli, developer-tools, formatter, sql.
- [doc8](https://www.automicvault.com/pkg/brew/doc8/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [elvis](https://www.automicvault.com/pkg/brew/elvis/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [falco](https://www.automicvault.com/pkg/brew/falco/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [djlint](https://www.automicvault.com/pkg/brew/djlint/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, formatter, libyaml.
- [salt-lint](https://www.automicvault.com/pkg/brew/salt-lint/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, linter.
- [vint](https://www.automicvault.com/pkg/brew/vint/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, linter.

## Combined YAML source

View the package source record on GitHub. [combined/sqlfluff.yml](https://github.com/automic-vault/db/blob/main/combined/sqlfluff.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
