{"id":41484590,"url":"https://github.com/joshkunz/qemu-docker","last_synced_at":"2026-01-23T17:48:53.614Z","repository":{"id":38837097,"uuid":"174948936","full_name":"joshkunz/qemu-docker","owner":"joshkunz","description":"A docker container for running x86_64 virtual machines using qemu","archived":false,"fork":false,"pushed_at":"2023-10-20T06:16:04.000Z","size":28,"stargazers_count":165,"open_issues_count":6,"forks_count":34,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-24T00:16:52.574Z","etag":null,"topics":["docker","qemu"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joshkunz.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-03-11T07:38:10.000Z","updated_at":"2024-03-19T02:18:39.000Z","dependencies_parsed_at":"2022-07-16T10:00:35.444Z","dependency_job_id":"7b7d1fe7-c9b6-4185-956f-cfe525ca1ebf","html_url":"https://github.com/joshkunz/qemu-docker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/joshkunz/qemu-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshkunz%2Fqemu-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshkunz%2Fqemu-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshkunz%2Fqemu-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshkunz%2Fqemu-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joshkunz","download_url":"https://codeload.github.com/joshkunz/qemu-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshkunz%2Fqemu-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28697278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"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":["docker","qemu"],"created_at":"2026-01-23T17:48:52.667Z","updated_at":"2026-01-23T17:48:53.603Z","avatar_url":"https://github.com/joshkunz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# qemu-docker\n\n[![Test](https://github.com/joshkunz/qemu-docker/actions/workflows/test.yaml/badge.svg)](https://github.com/joshkunz/qemu-docker/actions/workflows/test.yaml)\n\nThis repository contains a Docker container for running x86\\_64 virtual\nmachines using QEMU. It uses high-performance QEMU options\n(KVM, and TAP network driver).\n\nDocker Hub: [jkz0/qemu](https://hub.docker.com/r/jkz0/qemu)\n\n## Using the container\n\nVia `docker run`:\n\n```bash\n$ docker run --rm -it \\\n    --device=/dev/kvm:/dev/kvm --device=/dev/net/tun:/dev/net/tun \\\n    --cap-add NET_ADMIN -v $VM_IMAGE_FILE:/image \\\n    jkz0/qemu:latest\n```\n\nVia `docker-compose.yml`:\n\n```yaml\nversion: \"3\"\nservices:\n    vm:\n        image: jkz0/qemu:latest\n        cap_add:\n            - NET_ADMIN\n        devices:\n            - /dev/net/tun\n            - /dev/kvm\n        volumes:\n            - ${VM_IMAGE:?VM image must be supplied}:/image\n        restart: always\n```\n\n## Tips \n\n* VM networking is configured via DHCP, make sure to enable DHCP in your\n  VM image. VMs will use the IP address of the container.\n* You can quit the VM (when attached to the container) by entering the special\n  key sequence `C-a x`. Killing the docker container will also shut down the\n  VM.\n\n## Caveat Emptor\n\n* Only x86\\_64 supported new. PRs to support other architectures welcome,\n  though I imagine 99% of use-cases will be x86\\_64.\n* VMs will not be able to resolve container-names on user-defined bridges.\n  This is due to the way Docker's \"Embedded DNS\" server works. VMs can still\n  connect to other containers on the same bridge using IP addresses.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshkunz%2Fqemu-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoshkunz%2Fqemu-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshkunz%2Fqemu-docker/lists"}