{"id":13588180,"url":"https://github.com/piffall/PXESetupWizard","last_synced_at":"2025-04-08T02:35:04.514Z","repository":{"id":14770643,"uuid":"17492189","full_name":"piffall/PXESetupWizard","owner":"piffall","description":"PXE Setup Wizard. Netboot Debian, Ubuntu, System Rescue CD, FreeDOS and more.","archived":false,"fork":false,"pushed_at":"2023-09-27T07:43:23.000Z","size":142,"stargazers_count":130,"open_issues_count":3,"forks_count":28,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-30T19:23:12.655Z","etag":null,"topics":["archlinux","bash","bash-script","debian","docker-image","fedora","gparted","kali","opensuse","pxe","pxe-boot","pxe-server","pxelinux","tftp","ubuntu"],"latest_commit_sha":null,"homepage":"http://piffall.github.io/PXESetupWizard/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piffall.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":"2014-03-06T20:48:38.000Z","updated_at":"2024-09-28T21:03:59.000Z","dependencies_parsed_at":"2024-06-02T00:41:20.153Z","dependency_job_id":null,"html_url":"https://github.com/piffall/PXESetupWizard","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piffall%2FPXESetupWizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piffall%2FPXESetupWizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piffall%2FPXESetupWizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piffall%2FPXESetupWizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piffall","download_url":"https://codeload.github.com/piffall/PXESetupWizard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223300736,"owners_count":17122679,"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":["archlinux","bash","bash-script","debian","docker-image","fedora","gparted","kali","opensuse","pxe","pxe-boot","pxe-server","pxelinux","tftp","ubuntu"],"created_at":"2024-08-01T15:06:33.210Z","updated_at":"2024-11-06T07:31:02.222Z","avatar_url":"https://github.com/piffall.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# PXE SW\n\n[![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg?maxAge=2592000?style=flat-square)](https://gitter.im/piffall/pxe-sw)\n\n*NetBoot installers and Live OSs over TFTP*. This project is a wizard,\ncollection of install scripts, patches, ... to setup a PXE server with\nmost popular GNU/Linux distros.\n\n## Dockerized\n\n- Clone this repository.\n```bash\ngit clone https://github.com/piffall/pxe-sw\n```\n\n- Build image and setup, this could take several time\n```bash\nmake all\n```\n\nAfter this point, the container is ready. You only need to start/stop when you\nneed.\n\n```bash\ndocker start pxe-sw\ndocker stop pxe-sw\n```\n\n### Systemd (to start up on boot)\n\n#### Enable as service\n```bash\nmake install # Systemd only\n```\n\n## Hosted\n\n### Requirements\n\n- Debian based OS (Debian,Ubuntu,Mint,...)\n- Some packages: wget, sudo, unzip, tar, ...\n\n### Install\n\n- Install dependencies\n```\nsudo apt-get -y install git tftpd-hpa unzip wget curl p7zip-full xzip xz-utils cpio\n```\n\n- Clone this repository, I recomend you clone into your home path.\n```\ngit clone https://github.com/piffall/pxe-sw /path/to/pxe-sw\n```\n\n- Setup (required step)\n\nThis will ask for IP address to listen to, and if you want to setup all OS.\nIf you are only interested in one of them, answer \"n\" to this question.\n```\n./setup.sh\n```\n\n- Specific OS setup\n\nIf you only want to setup one OS, for example, Debian, find corresponding\nsetup script and run it, after that, you shuold run fix-vesamenu.sh.\n```\n./scripts/exec/debian-stable-amd64.sh\n./fix_vesamenu.sh\n```\n\n- Create a symlink\n\nIf you /srv/tftp already exists, this will cause an error, please backup and\nremove /srv/tftp before symlink.\n```\nsudo ln -s /path/to/pxe/ /srv/tftp\n```\n\n### Configure and install TFTP server\n\n- Install tftpd-hpa\n```bash\nsudo apt-get install tftpd-hpa\n```\n\n- Edit the configuration file \"/etc/default/tftpd-hpa\"\n```bash\n# /etc/default/tftpd-hpa\n\nTFTP_USERNAME=\"tftp\"\nTFTP_DIRECTORY=\"/srv/tftp\"\nTFTP_ADDRESS=\"0.0.0.0:69\"\nTFTP_OPTIONS=\"--verbose\"\n#TFTP_OPTIONS=\"--secure\"\n```\n\n*Note that \"--secure\" option line is commented*\n\n# Configure DHCP Server\n\n## Configure with OpenWRT dhcp server\n\n- Edit the DHCP configuration file \"/etc/config/dhcp\" to add a dhcp\\_boot option\n```\nconfig dnsmasq\n  option domainneeded '1'\n  option boguspriv '1'\n  option localise_queries '1'\n  ...\n  option dhcp_boot '/srv/tftp/pxelinux.0,pxe-hostname,192.168.1.254' # Change host and IP address.\n```\n- Restart your device\n\n## Configure with DHCP3 Server\n\n- Add an option to the network configuration\n```\nsubnet 192.168.1.0 netmask 255.255.255.0 {\n\trange 192.168.1.200 192.168.1.253;\n\toption domain-name \"lan\";\n\tdefault-lease-time 1800;\n\tmax-lease-time 7200;\n\tnext-server \"192.168.1.254\";                     # The TFTP IP address\n\toption bootfile-name \"/srv/tftp/pxelinux.0\";     # The PXE file\n}\n```\n\n## OS and Tools\n\n### Popular GNU/Linux Distributions\n- [Debian](http://www.debian.org)\n- [Ubuntu](http://www.ubuntu.com)\n- [CentOS](https://www.centos.org)\n- [OpenSuse](https://www.opensuse.org)\n- [Fedora](https://getfedora.org/)\n- [Archlinux](https://www.archlinux.org/)\n\n### More GNU/Linux Distributions\n- [GParted](https://gparted.org/)\n- [Kali Linux](https://www.kali.org/)\n- [CoreOS](https://coreos.com)\n- [OpenWRT](https://openwrt.org/)\n- [ProxmoxVE](https://proxmox.com/) (It neets to be downloaded manually) [See](https://github.com/morph027/pve-iso-2-pxe)\n\n### Recovery\n- [System Rescue CD](http://www.sysresccd.org)\n- [Rescatux](http://www.supergrubdisk.org/rescatux/)\n- [Super Grub Disk](http://www.supergrubdisk.org/super-grub2-disk/)\n\n### Diagnostic and detection\n- [HDT](http://hdt-project.org) (Hardware Detection Tool)\n- [MHDD](http://hddguru.com/software/2005.10.02-MHDD/) (Low-level HDD Diagnostic Tool)\n- [Memtest86+](http://www.memtest.org/)\n\n### Other OS\n- [FreeDOS](http://www.freedos.org/)\n- [VMWare ESXi](https://my.vmware.com/web/vmware/evalcenter?p=free-esxi6) (It needs to be downloaded manually)\n\n### Boot Loaders\n- [Charmeleon](http://chameleon.osx86.hu/) (EFI)\n- [GAG](http://gag.sourceforge.net/) Graphical Boot Manager\n\n### Other Tools\n- [ntpasswd](http://pogostick.net/~pnh/ntpasswd/)\n- [DBAN](http://www.dban.org/) (HDD Eraser)\n\n## License\nAll files are under GNU General Public License v3\n\n### Donations (BTC)\n*Please consider support the project donating to the Bitcoin address below:*\n\n17q6RT31yEJAptrUzXhwEq5iPwEguEFFBG\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiffall%2FPXESetupWizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiffall%2FPXESetupWizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiffall%2FPXESetupWizard/lists"}