{"id":18497857,"url":"https://github.com/containers/crun-vm","last_synced_at":"2025-04-09T00:30:47.864Z","repository":{"id":215152091,"uuid":"738242969","full_name":"containers/crun-vm","owner":"containers","description":"An OCI Runtime that enables Podman, Docker, and Kubernetes to run VM images.","archived":false,"fork":false,"pushed_at":"2024-04-13T22:12:20.000Z","size":1093,"stargazers_count":87,"open_issues_count":9,"forks_count":8,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-04-14T13:01:15.826Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/containers.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}},"created_at":"2024-01-02T19:14:42.000Z","updated_at":"2024-04-15T15:22:13.380Z","dependencies_parsed_at":"2024-01-25T18:47:29.466Z","dependency_job_id":"667fe3ad-6eab-4405-beaf-6854d51b80e6","html_url":"https://github.com/containers/crun-vm","commit_stats":null,"previous_names":["containers/crun-qemu","containers/crun-vm"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fcrun-vm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fcrun-vm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fcrun-vm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fcrun-vm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/containers","download_url":"https://codeload.github.com/containers/crun-vm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247949696,"owners_count":21023368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-11-06T13:36:18.985Z","updated_at":"2025-04-09T00:30:45.966Z","avatar_url":"https://github.com/containers.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# The crun-vm OCI Runtime\n\n**crun-vm** is an [OCI Runtime] that enables [Podman], [Docker], and\n[Kubernetes] to run QEMU-compatible Virtual Machine (VM) images. This means you\ncan:\n\n  - Run **VMs** as easily as you run **containers**.\n  - Manage containers and VMs **together** using the **same** standard tooling.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/example.gif\" width=\"680\" /\u003e\n\u003c/p\u003e\n\n---\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"450\" valign=\"top\"\u003e\n\n### Quick start\n\nInstall crun-vm:\n\n```console\n$ dnf install crun-vm\n```\n\nLaunch a VM from a disk image packaged in a container:\n\n```console\n$ podman run --runtime crun-vm -it \\\n    quay.io/containerdisks/fedora:40\n```\n\nLaunch a VM from a disk image under `my-image-dir/`:\n\n```console\n$ podman run --runtime crun-vm -it \\\n    --rootfs my-image-dir/\n```\n\nLaunch a VM from a [bootable container]:\n\n```console\n$ podman run --runtime crun-vm -it \\\n    quay.io/crun-vm/example-fedora-bootc:40\n```\n\nSet the password for a VM's default user:\n\n```console\n$ podman run --runtime crun-vm -it \\\n    quay.io/containerdisks/fedora:40 \\\n    --password pass  # for user \"fedora\"\n```\n\nExec (ssh) into a VM:\n\n```console\n$ podman exec -it --latest -- --as fedora\n```\n\n\u003cp\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd valign=\"top\"\u003e\n\n### Major features\n\n  - Control VM **CPU** and **memory** allocation.\n  - Pass **cloud-init** or **Ignition** configs to VMs.\n  - Mount **directories** into VMs.\n  - Pass **block devices** through to VMs.\n  - Expose additional **disk images** to VMs.\n  - **Forward ports** from the host to VMs.\n  - **`podman|docker|kubectl exec`** into VMs.\n\n---\n\n### Documentation\n\n  1. [Installing crun-vm](docs/1-installing.md)\n  2. [Running VMs with **Podman** or **Docker**](docs/2-podman-docker.md)\n  3. [Running VMs as **systemd** services](docs/3-systemd.md)\n  4. [Running VMs in **Kubernetes**](docs/4-kubernetes.md)\n  5. [**crun-vm(1)** man page](docs/5-crun-vm.1.ronn)\n\n---\n\n### License\n\nThis project is released under the GPL 2.0 (or later) license. See\n[LICENSE](LICENSE).\n\n\u003cp\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n[bootable container]: https://containers.github.io/bootable\n[Docker]: https://www.docker.com/\n[Kubernetes]: https://kubernetes.io/\n[KubeVirt]: https://kubevirt.io/\n[OCI Runtime]: https://github.com/opencontainers/runtime-spec/blob/v1.1.0/spec.md\n[Podman]: https://podman.io/\n[systemd]: https://systemd.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fcrun-vm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontainers%2Fcrun-vm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fcrun-vm/lists"}