From 7df3ff5ece60713b732f4c4b8d01a94e7a7e7d0b Mon Sep 17 00:00:00 2001 From: "CanbiZ (MickLesk)" <47820557+MickLesk@users.noreply.github.com> Date: Fri, 20 Mar 2026 15:00:39 +0100 Subject: [PATCH] testing netboot as lxc --- ct/netboot-xyz.sh | 61 +++++++++++++++++++++++++++++++++ install/netboot-xyz-install.sh | 62 ++++++++++++++++++++++++++++++++++ json/netboot-xyz.json | 52 ++++++++++++++++++++++++++++ 3 files changed, 175 insertions(+) create mode 100644 ct/netboot-xyz.sh create mode 100644 install/netboot-xyz-install.sh create mode 100644 json/netboot-xyz.json diff --git a/ct/netboot-xyz.sh b/ct/netboot-xyz.sh new file mode 100644 index 000000000..4e0a7743b --- /dev/null +++ b/ct/netboot-xyz.sh @@ -0,0 +1,61 @@ +#!/usr/bin/env bash +source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func) +# Copyright (c) 2021-2026 community-scripts ORG +# Author: Michel Roegl-Brunner (michelroegl-brunner) +# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE +# Source: https://netboot.xyz + +APP="netboot.xyz" +var_tags="${var_tags:-network;pxe;boot}" +var_cpu="${var_cpu:-1}" +var_ram="${var_ram:-512}" +var_disk="${var_disk:-4}" +var_os="${var_os:-debian}" +var_version="${var_version:-13}" +var_unprivileged="${var_unprivileged:-1}" + +header_info "$APP" +variables +color +catch_errors + +function update_script() { + header_info + check_container_storage + check_container_resources + + if [[ ! -f ~/.netboot-xyz ]]; then + msg_error "No ${APP} Installation Found!" + exit + fi + + if check_for_gh_release "netboot-xyz" "netbootxyz/netboot.xyz"; then + msg_info "Backing up Configuration" + cp /var/www/html/boot.cfg /opt/netboot-xyz-boot.cfg.bak + msg_ok "Backed up Configuration" + + CLEAN_INSTALL=1 fetch_and_deploy_gh_release "netboot-xyz" "netbootxyz/netboot.xyz" "prebuild" "latest" "/var/www/html" "menus.tar.gz" + + USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-efi" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz.efi" + USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-snp" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz-snp.efi" + USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-kpxe" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz.kpxe" + USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-undionly" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz-undionly.kpxe" + + msg_info "Restoring Configuration" + cp /opt/netboot-xyz-boot.cfg.bak /var/www/html/boot.cfg + rm -f /opt/netboot-xyz-boot.cfg.bak + msg_ok "Restored Configuration" + + msg_ok "Updated successfully!" + fi + exit +} + +start +build_container +description + +msg_ok "Completed Successfully!\n" +echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}" +echo -e "${INFO}${YW} Access it using the following URL:${CL}" +echo -e "${TAB}${GATEWAY}${BGN}http://${IP}${CL}" diff --git a/install/netboot-xyz-install.sh b/install/netboot-xyz-install.sh new file mode 100644 index 000000000..f9758f05b --- /dev/null +++ b/install/netboot-xyz-install.sh @@ -0,0 +1,62 @@ +#!/usr/bin/env bash + +# Copyright (c) 2021-2026 community-scripts ORG +# Author: Michel Roegl-Brunner (michelroegl-brunner) +# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE +# Source: https://netboot.xyz + +source /dev/stdin <<<"$FUNCTIONS_FILE_PATH" +color +verb_ip6 +catch_errors +setting_up_container +network_check +update_os + +msg_info "Installing Dependencies" +$STD apt install -y \ + nginx \ + tftpd-hpa +msg_ok "Installed Dependencies" + +fetch_and_deploy_gh_release "netboot-xyz" "netbootxyz/netboot.xyz" "prebuild" "latest" "/var/www/html" "menus.tar.gz" + +USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-efi" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz.efi" +USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-snp" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz-snp.efi" +USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-kpxe" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz.kpxe" +USE_ORIGINAL_FILENAME=true fetch_and_deploy_gh_release "netboot-xyz-undionly" "netbootxyz/netboot.xyz" "singlefile" "latest" "/var/www/html" "netboot.xyz-undionly.kpxe" + +msg_info "Configuring Webserver" +rm -f /etc/nginx/sites-enabled/default +cat <<'EOF' >/etc/nginx/sites-available/netboot-xyz +server { + listen 80 default_server; + listen [::]:80 default_server; + + root /var/www/html; + server_name _; + + location / { + autoindex on; + add_header Access-Control-Allow-Origin "*"; + add_header Access-Control-Allow-Headers "Content-Type"; + } +} +EOF +ln -sf /etc/nginx/sites-available/netboot-xyz /etc/nginx/sites-enabled/netboot-xyz +$STD systemctl reload nginx +msg_ok "Configured Webserver" + +msg_info "Configuring TFTP Server" +cat </etc/default/tftpd-hpa +TFTP_USERNAME="tftp" +TFTP_DIRECTORY="/var/www/html" +TFTP_ADDRESS="0.0.0.0:69" +TFTP_OPTIONS="--secure" +EOF +systemctl enable -q --now tftpd-hpa +msg_ok "Configured TFTP Server" + +motd_ssh +customize +cleanup_lxc diff --git a/json/netboot-xyz.json b/json/netboot-xyz.json new file mode 100644 index 000000000..6da2a893a --- /dev/null +++ b/json/netboot-xyz.json @@ -0,0 +1,52 @@ +{ + "name": "netboot.xyz", + "slug": "netboot-xyz", + "categories": [ + 4 + ], + "date_created": "2026-03-20", + "type": "ct", + "updateable": true, + "privileged": false, + "interface_port": 80, + "documentation": "https://netboot.xyz/docs/", + "website": "https://netboot.xyz/", + "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/netboot-xyz.webp", + "config_path": "/var/www/html/boot.cfg", + "description": "netboot.xyz is a network boot utility that lets you boot into any type of operating system or utility disk directly from a BIOS/UEFI, without needing a physical boot media. It uses iPXE to present a user-friendly menu of operating systems and tools.", + "install_methods": [ + { + "type": "default", + "script": "ct/netboot-xyz.sh", + "resources": { + "cpu": 1, + "ram": 512, + "hdd": 4, + "os": "Debian", + "version": "13" + } + } + ], + "default_credentials": { + "username": null, + "password": null + }, + "notes": [ + { + "text": "Configure your DHCP server: set `next-server` to the container IP, and `boot-filename` to `netboot.xyz.efi` (UEFI) or `netboot.xyz.kpxe` (BIOS/legacy).", + "type": "info" + }, + { + "text": "For UEFI HTTP boot (no DHCP changes required), load the bootloader directly from your firmware: `http://IP/netboot.xyz.efi`.", + "type": "info" + }, + { + "text": "Customize menus by editing `/var/www/html/boot.cfg`. Changes are picked up immediately — no service restart needed.", + "type": "info" + }, + { + "text": "TFTP is available on port 69/UDP and HTTP on port 80, both serving from `/var/www/html`.", + "type": "info" + } + ] +}