{"id":23399737,"url":"https://github.com/dynamist/vagrant-blank-box","last_synced_at":"2026-01-21T14:34:54.936Z","repository":{"id":100184287,"uuid":"458922000","full_name":"dynamist/vagrant-blank-box","owner":"dynamist","description":"An empty Vagrant box to test PXE booting over the network, or booting from local ISO files","archived":false,"fork":false,"pushed_at":"2022-02-13T21:05:12.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-08T19:53:19.994Z","etag":null,"topics":["vagrant-box","vagrant-boxes"],"latest_commit_sha":null,"homepage":"https://app.vagrantup.com/holmboe/boxes/blank","language":"Makefile","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/dynamist.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":"2022-02-13T20:22:56.000Z","updated_at":"2022-02-13T20:37:43.000Z","dependencies_parsed_at":"2023-05-12T18:00:17.615Z","dependency_job_id":null,"html_url":"https://github.com/dynamist/vagrant-blank-box","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dynamist/vagrant-blank-box","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dynamist%2Fvagrant-blank-box","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dynamist%2Fvagrant-blank-box/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dynamist%2Fvagrant-blank-box/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dynamist%2Fvagrant-blank-box/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dynamist","download_url":"https://codeload.github.com/dynamist/vagrant-blank-box/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dynamist%2Fvagrant-blank-box/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28634836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["vagrant-box","vagrant-boxes"],"created_at":"2024-12-22T10:16:20.023Z","updated_at":"2026-01-21T14:34:54.918Z","avatar_url":"https://github.com/dynamist.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vagrant blank box\n\nAn empty box to test PXE booting over the network, or booting from local ISO files. And possibly attach USB devices, or allocate some storage on local attached disks.\n\nOur goal is to have a virtual box with 2 vCPU, 1 GB RAM, 2x CD/DVD ROM drives, 4x network adapters, 4x storage devices, and an enabled USB controller. The boot order should be:\n\n- Removable devices\n- CD-ROM drive\n- Hard drive\n- Network\n\nThe hardware should be compatible with Linux 3.x, which is good as far back as CentOS 7 and Ubuntu 16.04.\n\n\n## Import this box locally\n\n```\nvagrant box add blank-box.json --provider vmware_desktop\nvagrant box add blank-box.json --provider virtualbox\n```\n\n\n## Oracle Virtualbox\n\nAfter creating the VM with Virtualbox use Vagrants built-in awesome support for Virtualbox to package it up:\n\n```\nvagrant package --base blank --output blank-virtualbox.box\n```\n\nThe image file is a gzip compressed tarball. For the sake of version control we have extracted the contents into `blank-virtualbox`. Vagrant packages the Virtualbox up like so:\n\n```\nVagrantfile\nbox-disk001.vmdk\nbox-disk002.vmdk\nbox-disk003.vmdk\nbox-disk004.vmdk\nbox.ovf\n```\n\nAfter this we added a `metadata.json` file because the documentation says it should be there, and also removed the `base_mac` hardcoded generated value in `Vagrantfile`.\n\n\u003c!--\nGuide for Virtualbox 5.2.42\n\nChoose to create a new VM\n\nName and operating system\nName: blank\nType: Linux\nVersion: Other Linux (64-bit)\n\nMemory size: 1024 MB\n\nChoose \"Create a virtual hard disk now\"\n\nFile location: blank-disk1\nFile size: 10 GB\nChoose VDI\nChoose Dynamically allocated\n\nRight click\nChoose Settings\n\nSystem -\u003e Motherboard\nBoot order:\n1. Check: Floppy\n2. Check: Optical\n3. Check: Hard Disk\n4. Check: Network\nChipset: PIIX3\nPointing Device: USB Tablet\nExtended Features:\n- Check Enable I/O APIC\n- Uncheck EFI\n- Check Hardware Clock in UTC Time\n\nSystem -\u003e Processor\n- Check Enable PAE/NX\n- Processor(s): 2\n\nSystem -\u003e Acceleration\nParavirtualization Interface: Default\nHardware Virtualization:\n- Check: Enable VT-x/AMD-V\n- Check: Enable Nested Paging\n\nStorage -\u003e Make it so:\n\n- Controller: IDE\n  - \"Empty\" optical disc\n    Optical Drive: IDE Primary Master\n    Check: Live CD/DVD\n  - \"Empty\" optical disc\n    Optical Drive: IDE Primary Slave\n    Check: Live CD/DVD\n- Controller: SATA\n  - Name: blank-disk1.vdi\n    Dynamically Allocated\n    Uncheck: Solid-state Drive\n    Uncheck: Hot-pluggable\n--\u003e\n\n## VMware Workstation Pro\n\nThe lowest common version that supports these features is Workstation 14.x (compatible with ESX1 6.7 and Fusion 10.x)\n\n- NVMe devices\n- UEFI Secure Boot\n- Trusted Platform Module (TPM)\n- I/O MMU virtualization\n\n\u003c!--\nIOMMU is a component in a memory controller that translates device virtual addresses into physical addresses.\n\nThe IOMMU’s DMA re-mapping functionality is necessary in order for VMDirectPath I/O to work. DMA transactions sent by the passthrough PCI function carry guest OS physical addresses which must be translated into host physical addresses by the IOMMU.\n\nHardware-assisted I/O MMU virtualization called Intel Virtualization Technology for Directed I/O (VT-d) in Intel processors and AMD I/O Virtualization (AMD-Vi or IOMMU) in AMD processors, is an I/O memory management feature that remaps I/O DMA transfers and device interrupts. This feature (strictly speaking, is a function of the chipset, rather than the CPU) can allow virtual machines to have direct access to hardware I/O devices, such as network cards, storage controllers (HBAs), and GPUs.\n--\u003e\n\nThe contents of the Vagrant box is documented in https://www.vagrantup.com/docs/providers/vmware/boxes#contents\n\n\u003e The files that are strictly required for a VMware machine to function are: nvram, vmsd, vmx, vmxf, and vmdk files.\n\u003e\n\u003e There is also the `metadata.json` file used by Vagrant itself.\n\nOnce we have created a suitable virtual machine in VMware Workstation we have:\n\n```\nblank-disk1.vmdk\nblank-disk2.vmdk\nblank-disk3.vmdk\nblank-disk4.vmdk\nblank.vmsd\nblank.vmx\nblank.vmxf\nblank.vmx.lck\n```\n\nNotably missing is the nvram file but it seems that we do without it. We will also skip the lck directory.\n\n\u003c!--\nGuide for Workstation 16.x\n\nChoose to create a new VM.\n\nGuest Operating System Installation\n- Choose: I will install the operating system later\n\nSelect Guest Operating System\n- Select: Linux\n- Version: Other Linux 3.x kernel 64-bit\n\nName the Virtual Machine\nName: blank\n\nProcessor Configuration\nNumber of processors: 1\nNumber of cores per processor: 2\n\nMemory for the Virtual Machine\nMemory: 1024 MB\n\nNetwork Type\nNetwork Connection: NAT\n\nSelect I/O Controller Types\nSCSI Controller: LSI Logic (non SAS)\n\nSelect a Disk Type\nVirtual Disk Type: SCSI\n\nSelect a Disk\nDisk: Create a new virtual disk\n\nSpecify Disk Capacity\nDisk Size: 10 GB\nAllocate all disk space now: No\nChoose: Store virtual disk as a single file\n\nSpecify Disk File\nFile name: blank-disk1.vmdk\n\nClick on Customize Hardware\nRemove the \"CD/DVD\" and \"Network adapter\"\n\nClick Add\nChoose \"CD/DVD Drive\"\nUncheck \"Connect at power on\"\nRepeat to have 2x CD/DVD drives\n\nClick Add\nChoose \"Network Adapter\"\nCheck \"Connect at power on\"\nSelect NAT\nRepeat to have 4x network adapters\n\nFinish the wizard\n\nEdit virtual machine settings\n\nClick Add\nChoose \"Hard Disk\"\nSelect SCSI\nSelect a Disk\nDisk: Create a new virtual disk\nSpecify Disk Capacity\nDisk Size: 10 GB\nAllocate all disk space now: No\nChoose: Store virtual disk as a single file\nSpecify Disk File\nFile name: blank-diskN.vmdk (where N is 2, then 3, then 4)\nRepeat to have 4x hard disks\n\nClick Save\n\nEdit virtual machine settings\n\nClick Options\nClick Advanced\nCheck \"Enable Template Mode\"\nFirmware type\nSelect UEFI\n\nClick Save\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdynamist%2Fvagrant-blank-box","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdynamist%2Fvagrant-blank-box","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdynamist%2Fvagrant-blank-box/lists"}