From f365c657b663ce8f5053306af90337e8aea54922 Mon Sep 17 00:00:00 2001
From: sihui <10405486+sihui62@users.noreply.github.com>
Date: Tue, 17 Mar 2026 14:54:03 +0100
Subject: [PATCH] Modify openHAB service setup instructions for manual Linux
 installations (#2644)

Updated the instructions for setting up openHAB as a systemd service on manual Linux installations to include the newly introduced linux.parameters file for overwriting environmental variables:

https://github.com/openhab/openhab-linuxpkg/pull/233

Signed-off-by: sihui <10405486+sihui62@users.noreply.github.com>
---
 installation/linux.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/installation/linux.md b/installation/linux.md
index 954a08a22..1917d0910 100644
--- a/installation/linux.md
+++ b/installation/linux.md
@@ -557,6 +557,7 @@ A cleaner approach is to create a Linux service.
 The following instructions are intended for a Linux init system based on **systemd** (e.g. Debian 8 / Ubuntu 15.x and newer).
 This will allow you to register openHAB as a service, so that it runs at startup and automatically restarts if openHAB crashes.
 The service will be running with the privileges of the user "openhab" and expects the openHAB files under `/opt/openhab`.
+Additionally, if you need to modify environment variables, create the file `/opt/openhab/conf/linux.parameters` with your changes or additions.
 
 Create the file `/usr/lib/systemd/system/openhab.service` with the following content:
 
@@ -573,7 +574,7 @@ User=openhab
 Group=openhab
 
 WorkingDirectory=/opt/openhab
-#EnvironmentFile=-/etc/default/openhab
+EnvironmentFile=-/opt/openhab/conf/linux.parameters
 
 ExecStart=/opt/openhab/runtime/bin/karaf daemon
 ExecStop=/opt/openhab/runtime/bin/karaf stop