From c26326bfb112784acf18879de20bc75d484b9c2f Mon Sep 17 00:00:00 2001 From: Pekka Paalanen Date: Fri, 4 Mar 2022 11:41:42 +0200 Subject: [PATCH] doc: expand on libseat via ssh Give a little more details about how running Weston via ssh or serial terminal is best done, now that launcher-direct and weston-launch are gone. Hopefully the removal of launcher-direct also makes less people run Weston as root, when seatd is the privileged process. Running 'weston' as root might still work through libseat's builtin backend without seatd. Signed-off-by: Pekka Paalanen --- doc/sphinx/toc/running-weston.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/sphinx/toc/running-weston.rst b/doc/sphinx/toc/running-weston.rst index 715bff42..81897fc2 100644 --- a/doc/sphinx/toc/running-weston.rst +++ b/doc/sphinx/toc/running-weston.rst @@ -93,12 +93,18 @@ backend to be used by ``libseat`` can optionally be selected with ``seatd`` is not already running, it can be started with ``sudo -- seatd -g video``. -Another way of launching Weston is via ssh or a serial terminal. The simplest -option here is to use the ``libseat`` launcher with ``seatd``. The process for +Launching Weston via ssh or a serial terminal is best with the ``libseat`` +launcher and ``seatd``. Logind will refuse to give access to local seats from +remote connections directly. The process for setting that up is identical to the one described above, where one just need to ensure that ``seatd`` is running with the appropriate arguments, after which one -can just run ``weston``. Another option, is to rely on logind and start weston -as systemd user service: :ref:`weston-user-service`. +can just run ``weston``. ``seatd`` will lend out the current VT, and if you want +to run on a different VT you need to ``chvt`` first. Make sure nothing will try +to take over the seat or VT via logind at the same time in case logind is +running. + +If you want to rely on logind, you can start weston as a systemd user service: +:ref:`weston-user-service`. Running Weston on a different seat on a stand-alone back-end ------------------------------------------------------------