1termy-systemd-setup(1) General Commands Manual termy-systemd-setup(1)
2
3
4
6 termy-systemd-setup - Enable user systemd services for termy-server(1)
7
8
10 termy-systemd-setup [options]
11
12
14 Note: This command is deprecated. Please use termy-setup(1) instead.
15
16 termy-systemd-setup is an interactive shell script that essentially
17 runs the following commands:
18
19 systemctl --user enable termy-server.socket
20 systemctl --user start termy-server.socket
21 loginctl enable-linger
22 kill `head -1 /tmp/termy-server$UID/pid`
23
24 This ensures that the user's persistent instance of termy-server(1)
25 will keep running even when the user is logged out. This is only appli‐
26 cable on Linux systems that run systemd user session managers with
27 login sessions controlled by systemd-logind(8). On such systems, this
28 script (or the above commands) should be run for each user that will be
29 using termy-server(1).
30
31 Important: These commands, particularly loginctl, must be run from
32 within a fully formed systemd login session. Shells launched via
33 sudo(8) or su(1) do not always meet this requirement, nor do terminals
34 run under an existing persistent user server (transient session
35 servers, however, are OK). When in doubt, use ssh or machinectl login
36 to log in as the user and run the script from there.
37
38
40 --server-pid pid
41 The pid of the user's existing persistent user server, which
42 will be killed. If not provided, the script will read the pid
43 from /tmp/termy-server$UID/pid if present. Otherwise, no pro‐
44 cesses will be killed.
45
46
47 --enable-linger
48 Just run loginctl enable-linger. The script will check for the
49 XDG_SESSION_ID variable as an indicator of whether a fully
50 formed systemd login session exists.
51
52
53 --help Print basic help
54
55
56 --version
57 Print version information
58
59
60 --man Attempt to show this man page
61
62
64 termy-server(1), systemctl(1), loginctl(1), systemd-logind(8), sys‐
65 temd(1)
66 TermySequence - https://termysequence.io
67
68
69
70TermySequence™ March 2018 termy-systemd-setup(1)