https://wiki.obsidianscheduler.com/doc/index.php?action=history&feed=atom&title=Linux_ServiceLinux Service - Revision history2026-10-29T22:49:31ZRevision history for this page on the wikiMediaWiki 1.43.10https://wiki.obsidianscheduler.com/doc/index.php?title=Linux_Service&diff=4178&oldid=prevCraig: Wiki update2026-10-29T18:16:03Z<p>Wiki update</p>
<p><b>New page</b></p><div>'''As of Obsidian 7.1.0''', on Linux an Embedded Tomcat pack and/or Standalone Runtime can install systemd '''templates''' -- see [[Installation_Guide#Linux_desktop_and_systemd_integration|Linux desktop and systemd integration]] for the installer option and the manual '''linux/install-embedded-linux-integration.sh''' script. Installing those files does not enable or start anything.<br />
<br />
= Embedded Tomcat =<br />
<br />
systemctl --user enable --now obsidian-embedded@scheduler.service<br />
<br />
For Standalone Admin embed installs:<br />
<br />
systemctl --user enable --now obsidian-embedded@adminOnly.service<br />
<br />
The unit runs '''webObsidian.sh run''' with the instance name as the profile ('''scheduler''' or '''adminOnly''') in the foreground ('''Type=simple''', '''TimeoutStopSec=180'''). ''./webObsidian.sh stop'' also stops a service-started instance. Do '''not''' run ''./webObsidian.sh start scheduler'' by hand while the service is running.<br />
<br />
Default HTTP '''8080''' and stop port '''9597'''. Edit '''webObsidian.sh''' before enabling the service.<br />
<br />
This embed unit is a '''user''' service. See [[#Running_without_an_active_login_session|Running without an active login session]] below.<br />
<br />
= Standalone Runtime =<br />
<br />
The standalone template is '''obsidian-standalone@'''. Instances:<br />
<br />
* '''@prod''' (or any name other than '''1''' / '''2''') runs '''standaloneObsidian.sh'''<br />
* '''@1''' runs '''1standaloneObsidian.sh''' when that script is present<br />
* '''@2''' runs '''2standaloneObsidian.sh''' when that script is present<br />
<br />
User-level:<br />
<br />
systemctl --user enable --now obsidian-standalone@prod.service<br />
<br />
After a root / sudo install:<br />
<br />
sudo systemctl enable --now obsidian-standalone@prod.service<br />
<br />
The system template runs '''/etc/obsidian/standalone-instance.sh''' and looks up the install directory for that instance in '''/etc/obsidian/standalone-instances''' so more than one install can share the same template. A user-level unit instead runs '''linux/standalone-instance.sh''' from that install directory.<br />
<br />
Either path stays in the foreground ('''Type=simple''', '''TimeoutStopSec=180''' unless the headless '''embed.linux.standalone.timeoutStopSec''' override is set) and calls '''standaloneObsidian.sh run''' (no background '''&'''). Stock standalone listen port is '''10451''' unless you change the launcher script. Stop with '''systemctl stop''' on the instance (see [[#Stop_and_logs|Stop and logs]]).<br />
<br />
= Stop and logs =<br />
<br />
Prefer '''systemctl stop''' on the instance. That runs the wrapper ('''linux/standalone-instance.sh stop''' or, for a system unit, '''/etc/obsidian/standalone-instance.sh stop'''), which writes ''linux/log4j2-%i.xml'' with literal log paths and sets '''log4j.configurationFile''' before the launcher '''stop'''. '''As of Obsidian 7.1.0''', when '''log.path''' is outside the install directory the default standalone file is ''$INSTALL_PATH/logs/obsidian-standalone.log''. Additional instances use ''obsidian-standalone-%i.log'' under that same '''logs/''' directory.<br />
<br />
Do '''not''' call '''./standaloneObsidian.sh start''' (or the numbered '''1'''/'''2''' scripts) while the service is running. Do '''not''' stop with a launcher that never sets '''log4j.configurationFile''' -- Log4j then follows the classpath '''log4j2.xml''' and can open the Tomcat web log (permission denied as the scheduler user). Journal lines '''Null object returned for RollingFile''' or missing appender '''fileLogger''' mean the instance XML was not applied; leave the unit up if it is '''active''' and copy a current '''standalone-instance.sh''' plus '''log4j2-standalone.xml.template''' into '''linux/''' (and '''/etc/obsidian/''' for a system unit), then '''systemctl restart''' that instance.<br />
<br />
= Replacing a previous systemd unit =<br />
<br />
If you already run standalone under your own unit (especially '''Restart=always'''), '''stop''' and '''disable''' that unit before enabling '''obsidian-standalone@'''. Otherwise the old unit respawns the JVM on the same port.<br />
<br />
'''systemctl mask''' only works when systemd can replace the unit path with a symlink to ''/dev/null''. If a real unit file already lives at that path, mask fails with '''File exists'''. '''disable''' the unit, move or remove the file, then '''daemon-reload'''.<br />
<br />
= Running without an active login session =<br />
<br />
'''systemctl --user''' units (a GUI install, or a non-root enable) stop at logout and do not start at boot until lingering is on:<br />
<br />
loginctl enable-linger <nowiki><username></nowiki><br />
<br />
A standalone template installed as root (typical headless sudo) is a '''system''' unit. It does not need linger. Use '''sudo systemctl''' (no '''--user''').<br />
<br />
= Removing the integration =<br />
<br />
systemctl --user disable --now obsidian-embedded@scheduler.service<br />
systemctl --user disable --now obsidian-standalone@prod.service<br />
rm ~/.config/systemd/user/obsidian-embedded@.service<br />
rm ~/.config/systemd/user/obsidian-standalone@.service<br />
rm ~/.local/share/applications/obsidian-embedded.desktop<br />
systemctl --user daemon-reload<br />
<br />
For a system standalone template (root / sudo install):<br />
<br />
sudo systemctl disable --now obsidian-standalone@prod.service<br />
sudo rm /etc/systemd/system/obsidian-standalone@.service<br />
sudo systemctl daemon-reload<br />
<br />
The same details ship as '''linux/README-linux-integration.md''' in your install directory.</div>Craig