{"id":20828502,"url":"https://github.com/linuxserver/docker-yq","last_synced_at":"2026-05-07T00:02:36.433Z","repository":{"id":47126125,"uuid":"302209273","full_name":"linuxserver/docker-yq","owner":"linuxserver","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-29T22:10:11.000Z","size":237,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-04-30T00:14:16.760Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linuxserver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"linuxserver","open_collective":"linuxserver"}},"created_at":"2020-10-08T02:12:10.000Z","updated_at":"2026-04-29T22:05:22.000Z","dependencies_parsed_at":"2026-04-16T00:00:50.860Z","dependency_job_id":null,"html_url":"https://github.com/linuxserver/docker-yq","commit_stats":{"total_commits":201,"total_committers":6,"mean_commits":33.5,"dds":0.08457711442786064,"last_synced_commit":"de32b65ff55bb826043753892fd62f812b0eb26d"},"previous_names":[],"tags_count":206,"template":false,"template_full_name":null,"purl":"pkg:github/linuxserver/docker-yq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2Fdocker-yq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2Fdocker-yq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2Fdocker-yq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2Fdocker-yq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linuxserver","download_url":"https://codeload.github.com/linuxserver/docker-yq/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2Fdocker-yq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32716960,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T19:35:05.142Z","status":"ssl_error","status_checked_at":"2026-05-06T19:35:03.996Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-11-17T23:15:02.110Z","updated_at":"2026-05-07T00:02:36.388Z","avatar_url":"https://github.com/linuxserver.png","language":"Shell","funding_links":["https://github.com/sponsors/linuxserver","https://opencollective.com/linuxserver"],"categories":[],"sub_categories":[],"readme":"\u003c!-- DO NOT EDIT THIS FILE MANUALLY --\u003e\n\u003c!-- Please read https://github.com/linuxserver/docker-yq/blob/master/.github/CONTRIBUTING.md --\u003e\n[![linuxserver.io](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png)](https://linuxserver.io)\n\n[![Blog](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=Blog)](https://blog.linuxserver.io \"all the things you can do with our containers including How-To guides, opinions and much more!\")\n[![Discord](https://img.shields.io/discord/354974912613449730.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=Discord\u0026logo=discord)](https://discord.gg/YWrKVTn \"realtime support / chat with the community and the team.\")\n[![Discourse](https://img.shields.io/discourse/https/discourse.linuxserver.io/topics.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026logo=discourse)](https://discourse.linuxserver.io \"post on our community forum.\")\n[![Fleet](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=Fleet)](https://fleet.linuxserver.io \"an online web interface which displays all of our maintained images.\")\n[![GitHub](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=GitHub\u0026logo=github)](https://github.com/linuxserver \"view the source for all of our repositories.\")\n[![Open Collective](https://img.shields.io/opencollective/all/linuxserver.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=Supporters\u0026logo=open%20collective)](https://opencollective.com/linuxserver \"please consider helping us by either donating or contributing to our budget\")\n\nThe [LinuxServer.io](https://linuxserver.io) team brings you another container release featuring:\n\n* regular and timely application updates\n* easy user mappings (PGID, PUID)\n* custom base image with s6 overlay\n* weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth\n* regular security updates\n\nFind us at:\n\n* [Blog](https://blog.linuxserver.io) - all the things you can do with our containers including How-To guides, opinions and much more!\n* [Discord](https://discord.gg/YWrKVTn) - realtime support / chat with the community and the team.\n* [Discourse](https://discourse.linuxserver.io) - post on our community forum.\n* [Fleet](https://fleet.linuxserver.io) - an online web interface which displays all of our maintained images.\n* [GitHub](https://github.com/linuxserver) - view the source for all of our repositories.\n* [Open Collective](https://opencollective.com/linuxserver) - please consider helping us by either donating or contributing to our budget\n\n# [linuxserver/yq](https://github.com/linuxserver/docker-yq)\n\n[![Scarf.io pulls](https://scarf.sh/installs-badge/linuxserver-ci/linuxserver%2Fyq?color=94398d\u0026label-color=555555\u0026logo-color=ffffff\u0026style=for-the-badge\u0026package-type=docker)](https://scarf.sh)\n[![GitHub Stars](https://img.shields.io/github/stars/linuxserver/docker-yq.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026logo=github)](https://github.com/linuxserver/docker-yq)\n[![GitHub Release](https://img.shields.io/github/release/linuxserver/docker-yq.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026logo=github)](https://github.com/linuxserver/docker-yq/releases)\n[![GitHub Package Repository](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=GitHub%20Package\u0026logo=github)](https://github.com/linuxserver/docker-yq/packages)\n[![GitLab Container Registry](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=GitLab%20Registry\u0026logo=gitlab)](https://gitlab.com/linuxserver.io/docker-yq/container_registry)\n[![Quay.io](https://img.shields.io/static/v1.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=linuxserver.io\u0026message=Quay.io)](https://quay.io/repository/linuxserver.io/yq)\n[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/yq.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=pulls\u0026logo=docker)](https://hub.docker.com/r/linuxserver/yq)\n[![Docker Stars](https://img.shields.io/docker/stars/linuxserver/yq.svg?color=94398d\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=stars\u0026logo=docker)](https://hub.docker.com/r/linuxserver/yq)\n[![Jenkins Build](https://img.shields.io/jenkins/build?labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026jobUrl=https%3A%2F%2Fci.linuxserver.io%2Fjob%2FDocker-Pipeline-Builders%2Fjob%2Fdocker-yq%2Fjob%2Fmaster%2F\u0026logo=jenkins)](https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-yq/job/master/)\n\n[yq](https://github.com/kislyuk/yq): Command-line YAML/XML processor - jq wrapper for YAML and XML documents. This image includes `yq`, `jq`, and `xq`.\n\n## Supported Architectures\n\nOur images support multiple architectures such as `x86-64` and `arm64`. We utilise the docker manifest for multi-platform awareness. More information is available from docker [here](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list) and our announcement [here](https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/).\n\nSimply pulling `linuxserver/yq` should retrieve the correct image for your arch, but you can also pull specific arch images via tags.\n\nThe architectures supported by this image are:\n\n| Architecture | Available | Tag |\n| :----: | :----: | ---- |\n| x86-64 | ✅ | amd64-\\\u003cversion tag\\\u003e |\n| arm64 | ✅ | arm64v8-\\\u003cversion tag\\\u003e |\n\n## Usage\n\n### Docker cli\n\n```text\ndocker run --rm \\\n  -v \"$PWD:$PWD\" \\\n  -w=\"$PWD\" \\\n  --entrypoint yq \\\n  linuxserver/yq \\\n  .foo.bar input.yml\n```\n\nYou can replace the last line with any yq command and argument, which will be passed to yq inside the image.\n\n```text\ndocker run --rm \\\n  -v \"$PWD:$PWD\" \\\n  -w=\"$PWD\" \\\n  --entrypoint jq \\\n  linuxserver/yq \\\n  .foo.bar input.json\n```\n\nYou can replace the last line with any jq command and argument, which will be passed to jq inside the image.\n\n```text\ndocker run --rm \\\n  -v \"$PWD:$PWD\" \\\n  -w=\"$PWD\" \\\n  --entrypoint xq \\\n  linuxserver/yq \\\n  .foo.bar input.xml\n```\n\nYou can replace the last line with any xq command and argument, which will be passed to xq inside the image.\n\n### Recommended method\n\nWe provide a very convenient script that allows the yq container to run as if it was installed natively:\n\n```bash\nsudo curl -L --fail https://raw.githubusercontent.com/linuxserver/docker-yq/master/run-yq.sh -o /usr/local/bin/yq\nsudo chmod +x /usr/local/bin/yq\n```\n\nRunning these two commands on your docker host once will let you issue commands such as `yq .foo.bar input.yml` and the yq container will do its job behind the scenes.\n\n```bash\nsudo curl -L --fail https://raw.githubusercontent.com/linuxserver/docker-yq/master/run-jq.sh -o /usr/local/bin/jq\nsudo chmod +x /usr/local/bin/jq\n```\n\nRunning these two commands on your docker host once will let you issue commands such as `jq .foo.bar input.json` and the jq container will do its job behind the scenes.\n\n```bash\nsudo curl -L --fail https://raw.githubusercontent.com/linuxserver/docker-yq/master/run-xq.sh -o /usr/local/bin/xq\nsudo chmod +x /usr/local/bin/xq\n```\n\nRunning these two commands on your docker host once will let you issue commands such as `xq .foo.bar input.xml` and the xq container will do its job behind the scenes.\n\n## Docker Mods\n\n[![Docker Mods](https://img.shields.io/badge/dynamic/yaml?style=for-the-badge\u0026color=E68523\u0026label=mods\u0026query=%24.mods%5B%27yq%27%5D.mod_count\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml)](https://mods.linuxserver.io/?mod=yq \"view available mods for this container.\")\n\nWe publish various [Docker Mods](https://github.com/linuxserver/docker-mods) to enable additional functionality within the containers. The list of Mods available for this image (if any) can be accessed via the dynamic badge above.\n\n## Support Info\n\n* image version number\n  * `docker inspect -f '{{ index .Config.Labels \"build_version\" }}' linuxserver/yq`\n\n## Updating Info\n\n### Via Docker Cli\n\n* Update the image: `docker pull linuxserver/yq`\n* You can also remove the old dangling images: `docker image prune`\n\n## Building locally\n\nIf you want to make local modifications to these images for development purposes or just to customize the logic:\n\n```text\ngit clone https://github.com/linuxserver/docker-yq.git\ncd docker-yq\ndocker build \\\n  --no-cache \\\n  --pull \\\n  -t linuxserver/yq:latest .\n```\n\nThe ARM variants can be built on x86_64 hardware and vice versa using `lscr.io/linuxserver/qemu-static`\n\n```bash\ndocker run --rm --privileged lscr.io/linuxserver/qemu-static --reset\n```\n\nOnce registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.\n\n## Versions\n\n* **09.07.25:** - Rebase to Alpine 3.22.\n* **29.05.24:** - Rebase to Alpine 3.20.\n* **08.01.24:** - Rebase to Alpine 3.19.\n* **19.09.22:** - Rebase to Alpine 3.18, deprecate armhf.\n* **19.09.22:** - Rebase to 3.17.\n* **19.09.22:** - Rebase to 3.15.\n* **18.05.21:** - Rebase to 3.13. add linuxserver wheel repo.\n* **09.10.20:** - Fix run scripts evaluating `$` in cases where they should not (ex: inside single quotes). Please rerun the [Recommended method](https://github.com/linuxserver/docker-yq#recommended-method) install/setup commands.\n* **07.10.20:** - Initial Release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver%2Fdocker-yq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinuxserver%2Fdocker-yq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver%2Fdocker-yq/lists"}