.nh
.TH LTSP-INITRD 8 "2023-08-19" "LTSP 23.02-1+deb12u1" "LTSP Manual"
.SH NAME
.PP
\fBltsp initrd\fP - create the ltsp.img initrd add-on

.SH SYNOPSIS
.PP
\fBltsp\fP [\fIltsp-options\fP] \fBinitrd\fP

.SH DESCRIPTION
.PP
Create a secondary initrd in /srv/tftp/ltsp/ltsp.img, that contains the LTSP
client code from /usr/share/ltsp/{client,common} and everything under
/etc/ltsp, including the ltsp.conf settings file. Additionally it contains
the server users and groups lists (passwd/group) and public SSH keys.
LTSP clients receive this initrd in addition to their usual one.

.PP
This means that whenever you add new users or edit \fBltsp.conf(5)\fP,
you need to run \fB\fCltsp initrd\fR to update \fBltsp.img\fP, and reboot the clients.

.PP
It also means that you can very easily put template xorg.conf or sshfs
or other files in /etc/ltsp, and have them on the clients in seconds,
without having to run \fB\fCltsp image\fR\&.

.SH OPTIONS
.PP
See the \fBltsp(8)\fP man page for \fIltsp-options\fP\&.

.SH EXAMPLES
.PP
Most live CDs do not contain sshfs, so by default you can only use NFS
home with them. But sshfs is a small binary without many dependencies,
so you may usually provide it to the clients if you include it to ltsp.img:

.PP
.RS

.nf
mkdir -p /etc/ltsp/bin
cp /usr/bin/sshfs /etc/ltsp/bin/sshfs-$(uname -m)
ltsp initrd
.fi
.RE

.PP
You can even provide multiple sshfs versions for different architectures.
LTSP contains code to automatically use those sshfs binaries if it can't
find the /usr/bin/sshfs one.

.SH COPYRIGHT
.PP
Copyright 2019-2022 the LTSP team, see AUTHORS.

.SH SEE ALSO
.PP
\fBltsp\fP(8), \fBltsp.conf\fP(5), \fBltsp-dnsmasq\fP(8), \fBltsp-image\fP(8),
\fBltsp-info\fP(8), \fBltsp-ipxe\fP(8), \fBltsp-kernel\fP(8),
\fBltsp-nfs\fP(8), \fBltsp-remoteapps\fP(8)

.PP
Online documentation is available on https://ltsp.org