Yq

yq is a containerized command-line YAML processor that reads, writes, and queries YAML documents, letting homelab users automate configuration edits in…

  • Databases
  • Other
  • Tools & Utilities
yq is a containerized command-line YAML processor that reads, writes, and queries YAML documents, letting homelab users automate configuration edits in scripts, CI pipelines, and container workflows.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
100last commit 23 days ago
Popular
2110 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed 18 days ago

GitHub stars
10
Open issues
0
Last commit
2026-10-29
Latest release
4.4.5-ls228
License
GPL-3.0
Activity
steady

Checked 17 days ago - source: GitHub (linuxserver/docker-yq)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Native-like command usage The LinuxServer yq image includes a convenience script that lets the container behave like a locally installed yq command on the Docker host. source

Fetched 40 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does yq support every jq operation?

No. yq does not yet support everything jq does, but it supports the most common operations.

Can yq syntax change depending on the installation method?

Yes. The syntax can differ depending on whether yq is installed from source or pip.

What file formats can yq process?

It processes YAML, JSON, XML, CSV, TOML, HCL, and properties files.

How do I prevent yq from returning a filtered subset during updates?

Wrap the left-hand expression in brackets. Without brackets, yq first filters by the selection and then updates only the filtered result.

Answers sourced from github.com, github.com, mikefarah.gitbook.io, www.reddit.com

Community

Collected 48 days ago - public community threads