From e6da53c55e9cd52937242f8d879975cb3ddc70e3 Mon Sep 17 00:00:00 2001 From: Reinder Feenstra Date: Tue, 6 Aug 2024 09:28:57 +0200 Subject: [PATCH] manual: added start server/client instructions for Linux, see #158 --- .../css/traintasticmanual.css | 6 ++-- .../en-us/gettingstarted/start-client.md | 2 +- .../en-us/gettingstarted/start-server.md | 29 +++++++++++++++++-- 3 files changed, 31 insertions(+), 6 deletions(-) diff --git a/manual/traintasticmanual/css/traintasticmanual.css b/manual/traintasticmanual/css/traintasticmanual.css index bae21a8dc..789974bc0 100644 --- a/manual/traintasticmanual/css/traintasticmanual.css +++ b/manual/traintasticmanual/css/traintasticmanual.css @@ -320,7 +320,8 @@ ul.index-az-nav li a /** Lua **********************************************************************/ -pre[lang="lua"] +pre[lang="lua"], +pre[lang="bash"] { border: solid 1px darkgray; background-color: #f8f8f8; @@ -423,7 +424,8 @@ pre[lang="lua"] code span.function border-left-color: blue; } - pre[lang="lua"] + pre[lang="lua"], + pre[lang="bash"] { border-color: gray; background-color: #222; diff --git a/manual/traintasticmanual/en-us/gettingstarted/start-client.md b/manual/traintasticmanual/en-us/gettingstarted/start-client.md index 7a49dce91..fd5670fdc 100644 --- a/manual/traintasticmanual/en-us/gettingstarted/start-client.md +++ b/manual/traintasticmanual/en-us/gettingstarted/start-client.md @@ -4,7 +4,7 @@ When Traintastic server is running the Traintastic client can be started. **Windows:** The Traintastic client can be started using the desktop icon (if installed) or by selecting *Traintastic* -> *Traintastic client* from the Windows start menu. -**Linux:** TODO +**Linux:** To start Traintastic client, open your desktop environment's application launcher, search for "Traintastic Client," and select it from the list. ## Connect to the server diff --git a/manual/traintasticmanual/en-us/gettingstarted/start-server.md b/manual/traintasticmanual/en-us/gettingstarted/start-server.md index 82bc65199..bf60644b0 100644 --- a/manual/traintasticmanual/en-us/gettingstarted/start-server.md +++ b/manual/traintasticmanual/en-us/gettingstarted/start-server.md @@ -2,13 +2,36 @@ When running Traintastic, the server should be started first. -**Windows:** The Traintastic server can be started using the desktop icon (if installed) or by selecting *Traintastic* -> *Traintastic server* from the Windows start menu. +## Windows +The Traintastic server can be started using the desktop icon (if installed) or by selecting *Traintastic* -> *Traintastic server* from the Windows start menu. Traintastic server runs as background process, a Traintastic icon will appear in the system tray next to the clock. A Windows notification is displayed when it is running in the background. Traintastic server can be quit by clicking on the Traintastic icon and selecting *Quit* from the popup menu. ![](../../gfx/en-us/start/start-traintastic-server-windows.png "Traintastic server tray icon and notification") -**Linux:** TODO +## Linux +When installing Traintastic server using a Debian package it is installed as systemd service. -When Traintastic server is running proceed to [start Traintastic client](start-client.md). +To start the Traintastic server using systemd, open a terminal and run the command: +```bash +sudo systemctl start traintastic-server.service +``` + +To stop the service, use the command: +```bash +sudo systemctl stop traintastic-server.service +``` + +Ensure you have the necessary permissions (typically root) to manage systemd services. + +### Auto start on system boot +To enable Traintastic server to start automatically at boot, run the following command in a terminal: +```bash +sudo systemctl enable traintastic-server.service +``` + +To disable automatic start at boot, run the following command in a terminal: +```bash +sudo systemctl disable traintastic-server.service +```