{"id":19336238,"url":"https://github.com/os-1337/netboot","last_synced_at":"2026-03-19T09:21:36.560Z","repository":{"id":218965965,"uuid":"747682322","full_name":"OS-1337/netboot","owner":"OS-1337","description":"Network / Internet Boot Configurations needed to boot OS/1337 via Network and/or Internet using iPXE","archived":false,"fork":false,"pushed_at":"2024-01-25T08:48:30.000Z","size":1254,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-01-06T10:10:45.989Z","etag":null,"topics":["boot","config","configuration","configuration-files","ethernet","internet","internet-boot","ipv4","ipv6","ipxe","ipxe-configuration","lan","network-boot","os-1337","os1337","pxe","pxe-boot","pxeboot","tcpip"],"latest_commit_sha":null,"homepage":"http://boot.os1337.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OS-1337.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-01-24T12:39:43.000Z","updated_at":"2024-08-15T04:21:42.000Z","dependencies_parsed_at":"2024-01-24T19:23:39.640Z","dependency_job_id":null,"html_url":"https://github.com/OS-1337/netboot","commit_stats":null,"previous_names":["os-1337/netboot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2Fnetboot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2Fnetboot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2Fnetboot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2Fnetboot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OS-1337","download_url":"https://codeload.github.com/OS-1337/netboot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240441872,"owners_count":19801791,"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":["boot","config","configuration","configuration-files","ethernet","internet","internet-boot","ipv4","ipv6","ipxe","ipxe-configuration","lan","network-boot","os-1337","os1337","pxe","pxe-boot","pxeboot","tcpip"],"created_at":"2024-11-10T03:10:19.813Z","updated_at":"2026-01-30T03:12:27.712Z","avatar_url":"https://github.com/OS-1337.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OS/1337 netboot\n\nNetwork / Internet Boot Configurations needed to boot OS/1337 via Network and/or Internet\n\n---\n\n\n\n##\tWhy?\n\n###\tTo make [OS/1337](https://github.com/OS-1337/OS1337) a versatile and easy to use recovery \u0026 rescue Linux.\n\nBeing able to boot it easily from naked machines is kinda important and useful.\n\n######\tThis is intended to mimic most \"Rescue Linux\" OSes used by big hosters and classic recovery distros like [\"Tom's Root Boot\"](https://en.wikipedia.org/wiki/Tomsrtbt) as well as the [Raspberry Pi Online Installer](https://www.youtube.com/watch?v=qlBIfpBwqKY) that has been added to the Firmware of the Raspberry Pi 4 Series (including Pi4B, CM4 and Pi400), allowing for easy setup similar to [Apple's Recovery System](https://support.apple.com/en-us/guide/mac-help/mchl82829c17/mac) aka. *\"BridgeOS\"* ...\n\nAt the end, one can have a fully-automatically netbooting system that starts (ideally the latest current version of) [OS/1337](https://os1337.com) and is then ready for use.\n\n\n### Direct Online-Booting of OS/1337 as an easy easy way to use the latest version.\n\nWhich allows for [diskless](https://en.wikipedia.org/wiki/Diskless_node) setups and using OS/1337 as easy to setup and maintain [Thin Client](https://en.wikipedia.org/wiki/Thin_client) / \"[SSH](https://en.wikipedia.org/wiki/Secure_Shell) [Terminal](https://en.wikipedia.org/wiki/Computer_terminal)\" System in critical applications.\n- Combining the [Advantages of Diskless Clients](https://en.wikipedia.org/wiki/Diskless_node#Advantages_of_diskless_nodes_over_thin_clients)  [and Thin Clients](https://en.wikipedia.org/wiki/Diskless_node#Advantages_of_thin_clients_over_diskless_nodes) thanks to the fact that OS/1337 is [loaded once into RAM and run entirely from it](https://en.wikipedia.org/wiki/List_of_Linux_distributions_that_run_from_RAM).\n\n\n\n\n\n\n##\tHow?\n\n### Using [iPXE](https://ipxe.org/) as boot firmware\nWhich can be [chainloaded](https://ipxe.org/howto/chainloading) as bootloader, a OS/1337 image is being loaded via TFTP or HTTP and subsequently booted.\n\n\n\n---\n\n##\tNavigating the Project Files:\n\n```\nOS/1337 Netboot Repository\n├── build \t\t\t\t\t# build directory\n│   ├── build.conf.d\t\t\t\t# Build Configurations...\n│   │   └── ipxe.config\t\t\t\t# ...for iPXE\n│   ├── downloads\t\t\t\t# Cached Version of the Source Downloads\n│   ├── scripts\t\t\t\t\t# Build Scripts\n│   │   └── sources.lists.d\t\t\t# Download URLs\n│   │       └── ipxe.url\t\t\t# Download URL of the latest release Version Source\n│   └── working\t\t\t\t\t# Working Directory\n├── configs\t\t\t\t\t# Configurations for various Systems \u0026 Parts\n│   ├── dhcp\t\t\t\t\t# Configs for ISC DHCPd\n│   │   └── dhcpd.conf\t\t\t\t# Configuration Parameters so the DHCP can point at the boot server\n│   ├── efi\t\t\t\t\t# (U)EFI boot files\n│   ├── grub\t\t\t\t\t# Grub Configuration Files\n│   │   └── chainload.ipxe.grub.conf\t\t# GRUB config to chainload iPXE\n│   ├── ipfire\t\t\t\t\t# ipFire Configuration files\n│   │   └── updxlrator\t\t\t\t# \"UpdateAccelerator\", a built in Squid Proxy Cache.\n│   ├── ipxe\t\t\t\t\t# iPXE Configuration Files\n│   │   ├── script.ipxe\t\t\t\t# the main boot script\n│   │   ├── script.ipxe.sig\t\t\t# Signature of said Boot Script for verification\n│   │   └── unused.params.ipxe\t\t\t# Just a file with some unused params as of now.\n│   └── tftp\t\t\t\t\t# tftp files\n├── pub\t\t\t\t\t\t# Public Servers' Contents\n│   └── boot.os1337.com\t\t\t\t# The Public OS/1337 Bootserver\n│       ├── http\t\t\t\t# http_public directory of the OS/1337 bootserver\n│       │   ├── boot.php\t\t\t# the iPXE boot.php script\n│       │   ├── index.html\t\t\t# basic HTML file if someone curious stubles upon the server\n│       │   ├── os1337.img\t\t\t# generic image [i486 CORE Edition]\n│       │   ├── robots.txt\t\t\t# tells crawlers to feck off and not waste bandwith!\n│       │   └── trusted-boot@os1337.com.pubkey\t# pubkey for the signed files \n│       └── rsync\t\t\t\t# rsync jobs\n│           └── sync.os1337.releases.sh \t# rsync script to sync the public webservers root directory.\n├── docu\t\t\t\t\t# documentation\n│   ├── further-reading.md\t\t\t# further reading materials\n│   └── self-hosting.md\t\t\t\t# how and why to self-host the bootserver.\n├── LICENSE.md\t\t\t\t\t# License\n├── README.md\t\t\t\t\t# README\n├── TODO.md\t\t\t\t\t# Project TODO list.\n└── .gitignore\t\t\t\t\t# Avoids duplicate code to be held in the repository.\n```\n\nThus should provide you with a good overview.\n\n\n---\n\n\n\n##\tFAQs\n\n### What license is this project under?\n\nThis Project falls under [0BSD License](https://en.wikipedia.org/wiki/BSD_licenses#0-clause_license_(%22BSD_Zero_Clause_License%22)).\n- See [LICENSE.md for details](LICENSE.md).\n\n####\tIMPORTANT NOTE:\n######\tThis only covers the Work as of this project and not underlying / dependent code like [iPXE](https://ipxe.org) which falls under [GPLv2+](https://ipxe.org/licensing) !\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos-1337%2Fnetboot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fos-1337%2Fnetboot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos-1337%2Fnetboot/lists"}