LTSP-NFS(8)

📦
version 23.02 · 6 versions
, in debian trixie, ubuntu questing

💖 LTSP-NFS 💖

okay bestie so this is the LTSP-NFS(8) page from the LTSP Manual and it's literally just about making NFS exports behave for LTSP. no cap, it's a tiny one. let's go 🦋

✨ NAME ✨

ltsp nfs — configure NFS exports for LTSP 💅

🌸 SYNOPSIS 🌸

ltsp [ltsp-options] nfs [-h nfs-home] [t nfs-tftp]

yes the t really is missing its dash up there, that's the original, i don't make the rules 🙈

🎀 DESCRIPTION 🎀

so what this does is it installs /etc/exports.d/ltsp-nfs.conf so your machine will export /srv/ltsp (that's $BASE_DIR btw 👑), /srv/tftp/ltsp (which is $TFTP_DIR), and optionally /home ($HOME_DIR). that's it. that's the whole job. slay ✨

💅 OPTIONS 💅

first up: for the ltsp-options themselves you gotta go read ltsp(8), they're not repeated here fr fr.

  • -h, --nfs-home=0|1 — exports /home over NFS3. defaults to 0. > ⚠️ heads up bestie: NFS3 is insecure for home, which is exactly why SSHFS is the default instead. if you wanna point at a different directory, set $HOME_DIR in /etc/ltsp/ltsp.conf. 💀
  • -t, --nfs-tftp=0|1 — exports /srv/tftp/ltsp over NFS3. defaults to 1. wanna use a different directory? set $TFTP_DIR in /etc/ltsp/ltsp.conf. 🌈

🧚 EXAMPLES 🧚

exporting /home over NFS (the insecure way, i said what i said)

drop these params into ltsp.conf:

[server]
NFS_HOME=1

[clients]
FSTAB_HOME="server:/home /home nfs defaults,nolock 0 0"

then run these on the server:

ltsp initrd  # This is needed whenever ltsp.conf is modified
ltsp nfs

exporting only some homes over NFS 🍓

so like, some users get NFS, the rest keep SSHFS. use these lines in ltsp.conf instead:

[server]
NFS_HOME=1
HOME_DIR=/home/nfs

[clients]
FSTAB_HOME="server:/home/nfs /home nfs defaults,nolock 0 0"

then run these on the server to move some home directories under /home/nfs and create the appropriate symlinks in case the users ever need to SSH to the server:

💜 note that the NFS server doesn't follow symlinks outside of an export. important. remember it.
mkdir /home/nfs
for u in guest01 guest02; do
    mv "/home/$u" /home/nfs/
    ln -s "nfs/$u" "/home/$u"
done

ltsp initrd
ltsp nfs

Copyright 2019-2022 the LTSP team, see AUTHORS.

🔥 SEE ALSO 🔥

ltsp(8), ltsp.conf(5), ltsp-dnsmasq(8), ltsp-image(8), ltsp-info(8), ltsp-initrd(8), ltsp-ipxe(8), ltsp-kernel(8), ltsp-remoteapps(8)

online documentation is available on https://ltsp.org — go read it, it's giving helpful 🫶

and that's the whole page bestie!! 💖✨ this was LTSP 23.02-3, dated 2024-09-07, and it ate, no crumbs. mwah 💅🎀

📦 where this page comes from