{"id":15127679,"url":"https://github.com/marcos-venicius/machine-runner","last_synced_at":"2025-10-18T21:27:11.646Z","repository":{"id":244034715,"uuid":"814113457","full_name":"marcos-venicius/machine-runner","owner":"marcos-venicius","description":"Run a lot of machines easily","archived":false,"fork":false,"pushed_at":"2024-06-18T12:02:04.000Z","size":1598,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T15:47:37.862Z","etag":null,"topics":["cyber-security","cyber-security-tool","docker","docker-container","docker-machines","os","pentest","pentesting-tools","shell","software-tool","tools"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/marcos-venicius.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":"2024-06-12T11:14:49.000Z","updated_at":"2024-07-13T20:57:54.000Z","dependencies_parsed_at":"2024-06-18T14:10:24.237Z","dependency_job_id":"925cd07f-ea86-49e9-8b92-358033bf0855","html_url":"https://github.com/marcos-venicius/machine-runner","commit_stats":null,"previous_names":["marcos-venicius/machine-runner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marcos-venicius/machine-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcos-venicius%2Fmachine-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcos-venicius%2Fmachine-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcos-venicius%2Fmachine-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcos-venicius%2Fmachine-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcos-venicius","download_url":"https://codeload.github.com/marcos-venicius/machine-runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcos-venicius%2Fmachine-runner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259654129,"owners_count":22890964,"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":["cyber-security","cyber-security-tool","docker","docker-container","docker-machines","os","pentest","pentesting-tools","shell","software-tool","tools"],"created_at":"2024-09-26T02:05:17.825Z","updated_at":"2025-10-18T21:27:11.580Z","avatar_url":"https://github.com/marcos-venicius.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Machine Runner\n\n\nhttps://github.com/marcos-venicius/machine-runner/assets/94018427/ac3c94c2-a3f2-42d1-a521-48cdd21c6721\n\n\nAs a Software Engineer and a Cyber Security professional, sometimes I really need to up many machines at same time in my computer.\n\nOne pretending to be a victim, another one pretending to be the attacker, another one pretending to be something else...\n\nIt's very hard to create this bunch of machines by hand using docker or even virtual machines.\n\n## The solution\n\nI created a simple bash script that recognizes a folder as a `machine directory`.\n\nA `machine directory` is any directory that contains a valid `machine.config` file.\n\nIt could be your git repository, a random folder, your project folder, doesn't metter!\n\nIf you have this `machine.config` file, this directory will be considered as a `machine directory`.\n\nSo, **to have a bunch of machines you can just create a bunch of config files and that's it**, to switch over the machines you can just go\ninside the specific machine directory you want and run `os_connect`, and **a shell will be opened to you with persistent state**.\n\nTo see more information about the machine, just run `os_info`.\n\nAnd you will have an output like this:\n\n```\n\nOS INFO\n\nID:                     d442817e2db23ed43084cd812c3ae1cddd02d7185c70ffe83d0ddf0cac281cc6\nIMAGE:                  alpile:latest\nSTORAGE LOCATION:       /tmp/d442817e2db23ed43084cd812c3ae1cddd02d7185c70ffe83d0ddf0cac281cc6/data\n\n```\n\nNow, if you want to connect to the machine, just run: `os_connect` and a shell will be opened to you.\n\n**Don't be afraid to exit your machine, your data will be persisted in the _Storage Location_**, you need to remember that\nthis code runs over docker containers.\n\n\nBut, and if I want to remove the machine? Just run `os_remove`.\n\n## Creating the machine config file\n\nYou don't believe how easy is it.\n\n```config\nname=alpine-os\nimage=alpine:latest\nstorage=/data\n```\n\nYeah, just this three lines!\n\nThe key `name` is an arbitrary name to your machine, I recommend you the pattern `\u003cos-system\u003e-os`.\nThe key `image` is the system image name from docker hub.\nThe key `storage` is the volume path of the machine to make it persistent.\n\nThe configurations above is the necessary configurations to run an `alpine` system.\n\n## Installing\n\nJust run `./install.sh`\n\nThis will copy the `.machinesrc` to your home directory and add the following line to your `.bashrc`:\n\n```bash\nsource $HOME/.machinesrc\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcos-venicius%2Fmachine-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcos-venicius%2Fmachine-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcos-venicius%2Fmachine-runner/lists"}