{"id":34171945,"url":"https://github.com/anastop/virgo","last_synced_at":"2026-03-09T23:33:58.100Z","repository":{"id":57712050,"uuid":"152050168","full_name":"anastop/virgo","owner":"anastop","description":"Easily provision, instantiate and manage VMs","archived":false,"fork":false,"pushed_at":"2019-07-23T14:21:21.000Z","size":711,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-18T08:30:36.616Z","etag":null,"topics":["cloud","cloud-init","libvirt","provisioning","vhost-user","vm-creation"],"latest_commit_sha":null,"homepage":"","language":"Go","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/anastop.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}},"created_at":"2018-10-08T09:07:13.000Z","updated_at":"2024-11-08T00:04:17.000Z","dependencies_parsed_at":"2022-09-26T21:31:04.485Z","dependency_job_id":null,"html_url":"https://github.com/anastop/virgo","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/anastop/virgo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anastop%2Fvirgo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anastop%2Fvirgo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anastop%2Fvirgo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anastop%2Fvirgo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anastop","download_url":"https://codeload.github.com/anastop/virgo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anastop%2Fvirgo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30316771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T20:05:46.299Z","status":"ssl_error","status_checked_at":"2026-03-09T19:57:04.425Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["cloud","cloud-init","libvirt","provisioning","vhost-user","vm-creation"],"created_at":"2025-12-15T11:33:55.156Z","updated_at":"2026-03-09T23:33:58.092Z","avatar_url":"https://github.com/anastop.png","language":"Go","readme":"# virgo\n\nvirgo allows you to quickly provision and spin VMs locally, leveraging cloud-init and\nLibvirt.\n\n![virgo](./virgo.png)\n\n## Features\n\n- Runs on Linux baremetal machines and leverages Libvirt\n- Allows easy VM provisioning based on user-provided provisioning scripts and simple configuration options (uses [cloud-init](https://cloudinit.readthedocs.io/en/latest/) under the hood)\n- Allows easy VM creation with flexible configuration options\n- Supports [vhost-user network interfaces](https://libvirt.org/formatdomain.html#elementVhostuser), to allow a VM to connect e.g. with a  DPDK-based vswitch\n\nProvisioning options:\n- cloud image used for provisioning (currently tested with Ubuntu 16.04 \u0026 18.04)\n- user credentials\n- custom provisioning script to be used during VM creation\n- custom init.d script to be installed permanently\n\nVM configuration options: \n- number and topology of vCPUs\n- guest memory\n- hugepage backing options\n- network interfaces: support for `bridge`-type and `vhostuser`-type interfaces\n\n## Installation\n\nYou can build virgo from source:\n```console\n$ go get github.com/anastop/virgo\n$ go install\n```\n\nOr download the latest binary from the \"Releases\" page.\n\n### Dependencies\n\nvirgo makes use of the following utilities: \n- wget\n- genisoimage\n\n## Usage \n\n```console \n$ virgo init\n```\n\nEdit the created `virgo.json` according to your needs.\n\nOptionally, create additional `provision.sh` and `initd.sh` files to be used as provisioning \nand initd scripts, respectively.\n\nProvision a new VM called \"foo\":\n\n```console\n$ sudo virgo provision foo --config virgo.json [--provision-script provision.sh] [--initd-script initd.sh]\n```\n\n\"foo\" will shutdown after provisioning. \n\nEdit `virgo.json` to change VM's parameters (e.g. #vCPUs), and launch \"foo\":\n\n```console\n$ sudo virgo launch foo --config virgo.json\n```\n\nTo find out more, run `virgo -h`. \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanastop%2Fvirgo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanastop%2Fvirgo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanastop%2Fvirgo/lists"}