{"id":13607789,"url":"https://github.com/pin/debian-vm-install","last_synced_at":"2025-04-12T14:31:13.997Z","repository":{"id":30197861,"uuid":"33748716","full_name":"pin/debian-vm-install","owner":"pin","description":"Debian unattended VM installation with virt-install and pressed.cfg","archived":false,"fork":false,"pushed_at":"2024-10-22T03:12:02.000Z","size":24,"stargazers_count":46,"open_issues_count":0,"forks_count":19,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-07T13:37:33.508Z","etag":null,"topics":["debian","debian-installer","debian-jessie","debian-stretch","guest","kvm","preseed","unattended-installation","virt-install"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/pin.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-04-10T20:16:04.000Z","updated_at":"2024-10-22T03:12:06.000Z","dependencies_parsed_at":"2022-08-28T13:40:54.959Z","dependency_job_id":"1129fab2-1b0c-4fbf-b451-04cc268a2aa2","html_url":"https://github.com/pin/debian-vm-install","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pin%2Fdebian-vm-install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pin%2Fdebian-vm-install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pin%2Fdebian-vm-install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pin%2Fdebian-vm-install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pin","download_url":"https://codeload.github.com/pin/debian-vm-install/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248581108,"owners_count":21128104,"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":["debian","debian-installer","debian-jessie","debian-stretch","guest","kvm","preseed","unattended-installation","virt-install"],"created_at":"2024-08-01T19:01:21.620Z","updated_at":"2025-04-12T14:31:13.749Z","avatar_url":"https://github.com/pin.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Debian Bookworm unattended VM guest installer\n\nSimple script that uses **virt-install** and configures Debian installer\nfor unattended installation and custom configuration using **preseed**\nconfig in order to create freshly installed Debian KVM guest.\n\n```\nUsage: ./install.sh \u003cGUEST_NAME\u003e [MAC_ADDRESS]\n\n  GUEST_NAME    used as guest hostname, name of the VM and image file name\n  MAC_ADDRESS   allows to use specific MAC on the network, this is helpful\n                when DHCP server expects your guest to have predefined MAC\n```\n\nGuest OS is minimal no-GUI Debian installation configured with serial console\nfor ability to `virsh console \u003cGUEST_NAME\u003e`, and OpenSSH server with your SSH\nkey or/and password pre-configured.\n\nIt is easy to change the script to add any extra packages and\nconfiguration files during unattended installation. The main point of\nsharing this script is to provide an example of unattended Debian VM\ncreation or a base for your own script.\n\nPrerequisites\n-------------\n```\napt-get install wget virtinst libvirt-daemon-system qemu-system-x86 qemu-utils\n```\n\nThings to check before the first use\n------------------------------------\n * Set your login name and full name in `preseed.cfg`, update your GitHub name\n   in `install.sh` in order to install your SSH key for authentication by guest.\n   If you want to use different SSH key, not the one from GitHub, just put\n   `authorized_keys` to `preseed` directory and remove `wget` command that\n   fetches key from GitHub.\n   Update your login name in `postinst.sh`, where SSH key is installed.\n * It's worth considering to enable password authentication in `preseed.cfg`\n   at least during first run so you could `virsh console \u003cGUEST_NAME\u003e` in case\n   network connection in guest does not come up with DHCP or IP of the guest\n   is unclear.\n * Check RAM size and disk size for the guest in arguments to `virst-install` in\n   `install.sh` and modify them as needed.\n * Add `apt-get install -y \u003cyour_favorite\u003e` or whatever you want to `postinst.sh`\n   and any configuration files you want to add to the guest into `postinst`\n   directory.\n\nNetwork configuration\n---------------------\nScript works with bridged network, guests use DHCP and show up in local network.\nIn case you want something else, replace `br0` in arguments to virt-install\nin `install.sh`.\n\nBefore setting bridged network up:\n```\napt-get install brigde-utils\n```\n\nExample of network configuration in `/etc/network/interfaces`:\n```\nauto lo\niface lo inet loopback\n\nauto br0\niface br0 inet dhcp\n        bridge_hw eth0\n        bridge_ports eth0\n        bridge_stp off\n        bridge_fd 1\n        bridge_maxage 12\n```\n\nMore Info\n---------\n* https://www.debian.org/releases/stable/example-preseed.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpin%2Fdebian-vm-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpin%2Fdebian-vm-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpin%2Fdebian-vm-install/lists"}