X2GOTHINCLIENT_PREPTFTPBOOT(8)

📦 version 1.5.0.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 x2gothinclient_preptftpboot 💖

okay bestie, so this is a page from the X2Go Thin Client Environment manual, section 8 of the ol' man pages, and it's all about getting your PXE boot setup cute and ready. grab a snack, we're doing networking 💅

✨ NAME ✨

x2gothinclient_preptftpboot — Prepare PXE/Syslinux Boot Environment (delivered via tftpd) on X2Go PXE Server. it's giving "bootloader fairy godmother" fr fr 🧚

✨ SYNOPSIS ✨

x2gothinclient_preptftpboot

no args, no flags, no drama. she just runs. 👑

✨ DESCRIPTION ✨

so this lil helper script prepares X2Go's PXE/Syslinux boot environment. iconic. as your X2Go PXE server, you've got options: you can literally just use your X2Go server itself, OR you can use a dedicated machine or VM that merely serves as a PXE boot server. lowkey flexible, we love that for you 🦋

⚠️ bestie, listen. please run the x2gothinclient_create helper script FIRST before you run this one. order matters, no cap.

also, this script can only be called if the PXE boot dir (default: /srv/tftp) does not already contain any other PXE/Syslinux boot environment. so if there's already a boot environment squatting in there, she's not doing it. vibe check failed, sorry 😭

✨ MANUAL STEPS AFTER SCRIPT HAS RUN ✨

at the end of x2gothinclient_preptftpboot, there are still 2-3 manual steps you gotta do (the script itself will display them when you run it, so she's got your back). also heads up: the $TC_* variables mentioned in the text below have to be obtained from /etc/x2go/x2gothinclient_settings. like, that's where they live. go get 'em 🫶

  1. make sure your DHCP server's configuration points to:
next-server <IP-or-hostname-of-this-server>;
filename '/pxelinux.0';
  1. export the X2Go Thin Client chroot environment via NFSv3:
    • add this line to /etc/exports... (in one line, bestie, one line):
$TC_CHROOT \
<network>/<netmask>(ro,async,no_root_squash,no_subtree_check)
  • ...and then restart your NFS server with:
/etc/init.d/nfs-kernel-server restart
  1. customize PXE/Syslinux files in $TC_TFTP_BOOT/ (optional, so this one's just for the girlies who like to decorate ✨):
    • customize PXE boot menu — take a look at
$TC_TFTP_BOOT/default.cfg

and proceed from there on...

  • use your own boot loader background image: 640x480px, 16bit colour depth, file: $TC_TFTP_BOOT/x2go-tce.png — yes, those exact specs, she's picky about her aesthetics 🎀

✨ OPTIONS ✨

  • x2gothinclient_pretftpboot — has no known options. literally none. she's mysterious like that 💀

✨ FILES ✨

  • /etc/x2go/x2gothinclient_settings — Configuration file for x2gothinclient_* scripts. the sacred text 📜

✨ AUTHOR ✨

this manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). absolute main character energy 👑

and that's the whole page, bestie 💖 this one's Version 1.5.0.x, dated Nov 2019, living in the X2Go Thin Client Environment — so if you ever forget where you read it, you know exactly where to find her. slay, go boot some thin clients, and remember: x2gothinclient_create FIRST. periodt. 🌈✨

📦 where this page comes from