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

Anubis works

That meme is not an understatement, Anubis has been deployed by the United Nations. For your amusement, here is how the inner monologue of me finding out about this went: AoiWhat. You can't be serious, can you?CadeyIt's real.…

via Xe Iaso's blog April 12, 2025

A Firefox addon for putting prices into perspective

I had a fun idea for a small project this weekend, and so I quickly put it together over the couple of days. The result is Price Perspective. Humor me: have you ever bought something, considered the price, and wondered how that price would look to someone el…

via Drew DeVault's blog April 4, 2025

I don't really like OIDC

I will look into this single sign-on protocol and figure out why it is so darn complicated.

via Ξ January 7, 2025

Announcing systemd v257

Last week we released systemd v257 into the wild. In the weeks leading up to this release (and the week after) I have posted a series of serieses of posts to Mastodon about key new features in this release, under the #systemd257 hash tag. In case you aren'…

via Pid Eins December 17, 2024

Generated by openring