{"id":13840530,"url":"https://github.com/mhewedy/vermin","last_synced_at":"2025-05-12T17:26:05.935Z","repository":{"id":52247576,"uuid":"258886686","full_name":"mhewedy/vermin","owner":"mhewedy","description":"The smart virtual machines manager.  A modern CLI for Vagrant Boxes.","archived":false,"fork":false,"pushed_at":"2024-04-22T19:35:40.000Z","size":28725,"stargazers_count":144,"open_issues_count":7,"forks_count":12,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-10T06:38:23.053Z","etag":null,"topics":["golang","golang-tools","linux","vagrant","vermin","virtual-machine","virtualbox","virtualization","vms"],"latest_commit_sha":null,"homepage":"https://mhewedy.github.io/vermin","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mhewedy.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}},"created_at":"2020-04-25T22:25:59.000Z","updated_at":"2024-07-22T03:49:11.000Z","dependencies_parsed_at":"2024-06-20T05:50:40.866Z","dependency_job_id":"cd5ba4d2-d82c-4d10-81e3-8d2e99241f63","html_url":"https://github.com/mhewedy/vermin","commit_stats":{"total_commits":524,"total_committers":8,"mean_commits":65.5,"dds":0.08206106870229013,"last_synced_commit":"860228249d54027179be327b9b9ec396e8e5ef68"},"previous_names":[],"tags_count":130,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhewedy%2Fvermin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhewedy%2Fvermin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhewedy%2Fvermin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhewedy%2Fvermin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mhewedy","download_url":"https://codeload.github.com/mhewedy/vermin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253785961,"owners_count":21964061,"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":["golang","golang-tools","linux","vagrant","vermin","virtual-machine","virtualbox","virtualization","vms"],"created_at":"2024-08-04T17:00:50.037Z","updated_at":"2025-05-12T17:26:05.898Z","avatar_url":"https://github.com/mhewedy.png","language":"Go","funding_links":[],"categories":["Go","Go (531)"],"sub_categories":[],"readme":"\n[![Build Status](https://github.com/mhewedy/vermin/workflows/Go/badge.svg)](https://github.com/mhewedy/vermin/actions?query=workflow%3AGo)\n[![Go Report Card](https://goreportcard.com/badge/github.com/mhewedy/vermin)](https://goreportcard.com/report/github.com/mhewedy/vermin)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n\u003cimg src=\"https://raw.githubusercontent.com/mhewedy/vermin/master/etc/logo.png\"  alt=\"logo\" width=\"20%\"/\u003e\n\n## The smart virtual machines manager\nTable of Contents:\n\n- [What is Vermin](#what-is-vermin)\n- [Install Vermin](#install-vermin)\n- [Usage](#Usage)\n- [Contributors](#Contributors)\n- [TODO](#TODO)\n\n----\n\n# What is Vermin\nVermin is a smart, simple and powerful command line tool for Linux, Windows and macOS. It's designed for developers/testers and others working in IT who want a fresh VM environment with a single command. It uses VirtualBox to run the VM. Vermin will fetch images on your behalf.\n\nYou can look to Vermin as a modern CLI for Vagrant Boxes.\n\nVermin can be used when you need an easy way to obtain a Linux environment up and running in minutes.\n\n# Install Vermin\n\nVermin uses [VirtualBox v6.0 or later](https://www.virtualbox.org/wiki/Downloads) as the underlying hypervisor to create and run Virtual Machines. So you need to download and install it first.\n\nTo install/update on **macOS** and **Linux** run:\n\n```shell script\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/mhewedy/vermin/master/install.sh)\"\n```\n\nTo install/update on **Windows** (PowerShell) run:\n\n```\n# Should run as Administrator\niex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/mhewedy/vermin/master/install.ps1'))\n```\n\n# Usage:\n\n```text\nCreate, control and connect to VirtualBox VM instances\n\nUsage:\n  vermin [command]\n\nExamples:\n\nYou can use vermin by creating a VM from an image.\n\nTo list all images available:\n$ vermin images\n\nThen you can create a vm using:\n$ vermin create \u003cimage\u003e\n\n\nAvailable Commands:\n  commit      Commit a VM into a new Image\n  completion  Generates shell completion scripts\n  cp          Copy files/folders between a VM and the local filesystem or between two VMs\n  create      Create a new VM\n  exec        Run a command in a running VM\n  gui         open the GUI for the VM\n  help        Help about any command\n  hypervisor  print the name of the detected hypervisor\n  images      List remote and cached images\n  ip          Show IP address for a running VM\n  mount       Mount local filesystem inside the VM\n  port        Forward port(s) from a VM to host\n  ps          List VMs\n  restart     Restart one or more VMs\n  rm          Remove one or more VM\n  rmi         Remove one or more Image\n  ssh         ssh into a running VM\n  start       Start one or more stopped VMs\n  stop        Stop one or more running VMs\n  tag         Add or remove tag to a VM\n  update      Update configuration of a VM\n\nFlags:\n  -h, --help      help for vermin\n  -v, --version   version for vermin\n\nUse \"vermin [command] --help\" for more information about a command.\n```\n\nYou can start using Vermin after installation using:\n\n```shell script\n$ vermin create \u003cvagrant image name\u003e\n\n# example using ubuntu focal image\n$ vermin create hashicorp/focal64\n\n# also you can use rhel8 using:\n$ vermin create generic/rhel8\n```\nYou can use all [vagrant images](https://app.vagrantup.com/boxes/search).\n\n\u003csub\u003e_Vermin collects very simple usage data anonymously._\u003c/sub\u003e\n\n## Contributors\n\n\u003c!-- readme: collaborators,contributors -start --\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/mhewedy\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/1086049?v=4\" width=\"100;\" alt=\"mhewedy\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eMohammad Hewedy\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/akhiljns\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/22194681?v=4\" width=\"100;\" alt=\"akhiljns\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eAkhil\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/dawidd6\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/9713907?v=4\" width=\"100;\" alt=\"dawidd6\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eDawid Dziurla\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/gruz0\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/335095?v=4\" width=\"100;\" alt=\"gruz0\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eAlexander Kadyrov\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/aldarisbm\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/32185409?v=4\" width=\"100;\" alt=\"aldarisbm\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eJose Berrio\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\u003c!-- readme: collaborators,contributors -end --\u003e\n\n\nSpecial thanks to [Ahmed Samir](https://github.com/aseldesouky) for contributing the logo.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhewedy%2Fvermin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhewedy%2Fvermin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhewedy%2Fvermin/lists"}