Path-Based Activation of systemd Units

SergeantBiggs

systemdsystem administrationlinuxarchlinuxsystemd

314 Words

2022-09-25 13:51 +0000


I recently learned about a really nice feature of systemd:

Path-based activation of units.

This feature allows systemd to monitor files or paths, and start a unit when the path exists, or something in it is changed. It has different options:

  • PathExists: triggers if path exists.
  • PathExistsGlob: triggers if a file that matches a glob exists.
  • PathModified: triggers if path is changed (every write).
  • PathChanged: triggers if path is changed (not every write, only when file is closed).
  • DirectoryNotEmpty: triggers if directory contains at least one file.

This is done (in typical systemd fashion), by creating a .path file that corresponds to a specific service file.

I’ve been using it for some of my units that have their data storage on an external mount point, that due to encryption, is only mounted manually after booting the machine.

One service that uses this is my Jellyfin instance. So, to make sure Jellyfin only starts after the volume is mounted (eg. the path exists), we can do the following thing:

First, we create a .path file:

systemctl edit --full --force jellyfin.path

In that path file, we include the following lines:

[Path]
PathExists=/media/zfsnas/cryptset/smb/shared

[Install]
WantedBy=multi-user.target

This is pretty much the simplest form of creating a .path unit. See the manpage for more options.

The important part is the WantedBy= in the install section. This (like with all units) allows us to enable the units, and will then start them when it enters multi-user mode.

We can then enable the .path file, and disable the regular .service file:

systemctl disable jellyfin.service
systemctl enable jellyfin.path

After that, jellyfin.service will wait for the specified path to exist before starting. I really like this feature, and I can already think of a few things that this would be handy for (monitoring files and directories, automating backups to external drives, etc).

I’ll keep you posted if I do anything interesting with it!

Articles from blogs I read

Final Fantasy 14 on macOS with a 36 key keyboard

Saving Eorzea with as few keys as possible

via Xe Iaso's blog August 24, 2025

Embedding Wren in Hare

I’ve been on the lookout for a scripting language which can be neatly embedded into Hare programs. Perhaps the obvious candidate is Lua – but I’m not particularly enthusiastic about it. When I was evaluating the landscape of tools which are “like Lua, but no…

via Drew DeVault's blog August 20, 2025

What is HDR, really?

HDR is about having more details in shadows and highlights. A higher dynamic range is one piece of the puzzle, but not all of it.

via Ξ July 18, 2025

ASG! 2025 CfP Closes Tomorrow!

The All Systems Go! 2025 Call for Participation Closes Tomorrow! The Call for Participation (CFP) for All Systems Go! 2025 will close tomorrow, on 13th of June! We’d like to invite you to submit your proposals for consideration to the CFP submission site quick…

via Pid Eins June 12, 2025

Generated by openring