{"id":36632097,"url":"https://github.com/kernelci/tuxrun","last_synced_at":"2026-01-12T09:39:19.048Z","repository":{"id":329446901,"uuid":"1119523693","full_name":"kernelci/tuxrun","owner":"kernelci","description":"TuxRun, by Linaro, is a command line tool for testing Linux on the following virtual devices, using curated test suites.","archived":false,"fork":false,"pushed_at":"2025-12-19T16:06:33.000Z","size":1799,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-22T06:43:23.529Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kernelci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-12-19T12:06:23.000Z","updated_at":"2025-12-19T12:13:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kernelci/tuxrun","commit_stats":null,"previous_names":["kernelci/tuxrun"],"tags_count":158,"template":false,"template_full_name":null,"purl":"pkg:github/kernelci/tuxrun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernelci%2Ftuxrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernelci%2Ftuxrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernelci%2Ftuxrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernelci%2Ftuxrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kernelci","download_url":"https://codeload.github.com/kernelci/tuxrun/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernelci%2Ftuxrun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-01-12T09:39:18.440Z","updated_at":"2026-01-12T09:39:19.043Z","avatar_url":"https://github.com/kernelci.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/tuxrun_full.svg\" alt=\"TuxRun Logo\" width=\"40%\" /\u003e\n\u003c/div\u003e\n\n[![PyPI version](https://badge.fury.io/py/tuxrun.svg)](https://pypi.org/project/tuxrun/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![PyPI - License](https://img.shields.io/pypi/l/tuxrun)](https://github.com/kernelci/tuxrun/blob/master/LICENSE)\n\n[Documentation](https://tuxrun.org/) - [Repository](https://github.com/kernelci/tuxrun) - [Issues](https://github.com/kernelci/tuxrun/issues)\n\nTuxRun, by [Linaro](https://www.linaro.org/), is a command line tool for\ntesting Linux on the following virtual devices, using curated test suites.\n\n* AVH\n* FVP\n* QEMU\n\nTuxRun is a part of [TuxSuite](https://tuxsuite.com), a suite of tools and\nservices to help with Linux kernel development.\n\n# About TuxRun\n\nTesting the Linux kernel is as simple as using QEMU but it gets complicated\nwhen you want to support the following combinations:\n\n- Architectures (arm64, armv5, armv7, i386, mips32, mips32el, mips64, mips64el,\n  ppc32, ppc64, ppc64le, riscv64, s390, sh4, sparc64, x86_64)\n\n- Emulation systems (QEMU or FVP or AVH)\n- Tests (every test suite has dependencies on the rootfs)\n\nEach of those items requires specific configuration and root file systems. In\norder to allow for reproducible tests, TuxRun uses containers runtimes (Docker\nor Podman).\n\n# Installing TuxRun\n\nThere are several options for installing TuxRun:\n\n- [From PyPI](docs/install-pypi.md)\n- [Run uninstalled](docs/run-uninstalled.md)\n\n# Using TuxRun\n\nTo use TuxRun, compile your own linux kernel for arm64, for example using\n[TuxMake](https://tuxmake.org).\n\nThen call tuxrun:\n\n```shell\ntuxrun --device qemu-arm64 --kernel /path/to/Image\n```\n\nTuxRun will automatically start qemu-system with the right arguments and the\nright root filesystem.\n\n# TuxLAVA Library\n\nTuxRun uses [TuxLAVA](https://tuxlava.org) library to generate LAVA job definition files.\n\n# Known issues\n\nKnown issues when booting on different virtual platforms.\n\n- [From issues](docs/issues.md)\n\n# Examples\n\nBoot test a mipsel kernel at https://mykernel.org/vmlinux:\n\n```shell\ntuxrun --device qemu-mips32el \\\n       --kernel https://mykernel.org/vmlinux\n```\n\nRunning *ltp-smoke*:\n\n```shell\ntuxrun --device qemu-mips32el \\\n       --kernel https://mykernel.org/vmlinux \\\n       --test ltp-smoke\n```\n\nUsing a custom root file system\n\n```shell\ntuxrun --device qemu-mips32el \\\n       --kernel https://mykernel.org/vmlinux \\\n       --rootfs https://mykernel.org/rootfs.tar.xz\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernelci%2Ftuxrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernelci%2Ftuxrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernelci%2Ftuxrun/lists"}