termy-setup

Name

termy-setup - Perform setup actions for termy-server(1)

Synopsis

termy-setup [options]

Description

For each user that will be running termy-server(1), use the termy-setup shell script to perform recommended setup actions before running the server for the first time. Use one or more command line options to specify which setup tasks to perform.

Options

--systemd
Enable and start the systemd(1). systemd user service for termy-server(1). See Systemd Setup below.
--bash
Enable iTerm2-compatible shell integration for bash(1) login shells run under termy-server(1). Commands will be appended to the user's .profile if it exists, otherwise to .bash_profile.
--zsh
Enable iTerm2-compatible shell integration for zsh(1) shells run under termy-server(1). Commands will be appended to the user's .zshrc.
--help
Print basic help
--version
Print version information
--man
Attempt to show this man page

Systemd Setup

The systemd setup action essentially runs the following commands:

systemctl --user enable termy-server.socket
systemctl --user start termy-server.socket
loginctl enable-linger
kill `head -1 /tmp/termy-server$UID/pid`

This ensures that the user's persistent instance of termy-server(1) will keep running even when the user is logged out. This is only applicable on Linux systems that run systemd user session managers with login sessions controlled by systemd-logind(8). On such systems, this script (or the above commands) should be run for each user that will be using termy-server(1).

Important

These commands, particularly loginctl, must be run from within a fully formed systemd login session. Shells launched via sudo(8) or su(1) do not always meet this requirement, nor do terminals run under an existing persistent user server (transient session servers, however, are OK). When in doubt, use ssh or machinectl login to log in as the user and run the script from there.

See Also

termy-server(1), systemctl(1), loginctl(1), systemd-logind(8), systemd(1)