xrdp-sesrun(8)

✨ xrdp-sesrun ✨

okay bestie, welcome to the xrdp-sesrun manual page — section 8, system administration tools, iykyk 💅

---

🌸 NAME 🌸

xrdp-sesrun — the xrdp-sesman(8) session launcher 🎀

---

🌈 SYNTAX 🌈

xrdp-sesrun --help

xrdp-sesrun [ options ] [ username ]

---

🦋 DESCRIPTION 🦋

so basically, xrdp-sesrun spins up a session using xrdp-sesman(8). it's a testing tool, fr fr — it just does what xrdp does when a user logs in, makes a new session, and authenticates. that's the whole vibe: it starts a new session. 💖

the default values for all the options get baked in at compile-time. so like, run the utility with the '--help' option to see what the defaults actually are for your installation, because they might not be what you expect. 👑

if you don't pass a username, it just uses the current username, and no password needs to be provided. BUT — and this is the important part — in that case it is important that any necessary authentication tokens for a GUI session (e.g. a Kerberos ticket) have already been acquired. no token, no session, no cap. 😭

if you do pass a username, then a password must also be provided. and in that instance, the utility will prompt you for a password if neither -p nor -F is used. 🫶

---

💅 OPTIONS 💅

• -g <width>x<height> — set the session geometry. heads up tho: most configurations will resize the session on connection, so this option may not do what you expect. it's giving "I tried my best" 🙈
• -b <bits-per-pixel> — set the session bits-per-pixel (aka colour depth). some session types (i.e. Xorg) will straight up ignore this setting. they said "not today" 💀
• -t <session-type> — session type! one of Xorg or Xvnc. alternatively, for testing only, you can use the numeric session code. slay 🔥
• -D <directory> — the directory to run the new session in. defaults to $HOME for the specified user. 🏠
• -S <shell> — specify an alternate shell to run, instead of the default window manager. main character energy ✨
• -p <password> — password for user. 🚨 USE FOR TESTING ONLY 🚨 — the password will be visible in the output of the ps command. everybody can see it bestie, please don't do this in prod 😭
• -F <file-descriptor> — specify a file descriptor (normally 0) to read the password in from. this is the secure way to pass the password in to the utility. do this one instead 🫶🔐
• -c <sesman-ini> — specify a different sesman.ini file. this file is used to find out how to connect to xrdp-sesman. 🎀

---

🌟 ENVIRONMENT 🌟

• SESRUN_LOG_LEVEL — override the default logging level. one of "error", "warn", "info", "debug", "trace" or a number 1-5. pick your fighter 💜

---

🍓 EXAMPLES 🍓

• xrdp-sesrun create a default session for the current user. easy peasy 🌸
• xrdp-sesrun -F 0 user1 <passwd.txt create a default session for user user1 with a password from a file 📁✨
• xrdp-sesrun -t Xvnc -S /usr/bin/xterm user1 create an extremely minimal Xvnc session for user user1. this could be useful for debugging why the standard session is not starting properly 👀. note you would need to install the xterm utility first. the gnome-terminal utility probably won't work here. sorry bestie 💀

---

🎀 FILES 🎀

• /usr/bin/xrdp-sesman
• /usr/bin/xrdp-sesrun
• /etc/xrdp/sesman.ini

---

👑 AUTHORS 👑

• Jay Sorg <jsorg71@users.sourceforge.net>
• Simone Fedele <ilsimo@users.sourceforge.net>

---

💖 SEE ALSO 💖

xrdp-sesman(8), sesman.ini(5), xrdp(8), xrdp.ini(5)

for more info on xrdp see http://www.xrdp.org/ 🌈

---

and that's the whole page bestie 🫶 this was the xrdp-sesrun(8) manual, brought to you by the xrdp team, version 0.10.6.1 💅 go start a session, you've got this ✨🎀