podman-quadlet-install(1)

💅 podman-quadlet-install(1) — General Commands Manual

okay so bestie, welcome to the podman-quadlet-install page from the General Commands Manual 🎀 this one's literally all about dropping quadlets into place, and honestly? it ate.

---

✨ NAME ✨

podman-quadlet-install — install a quadlet file or a quadlet application 🫶

---

🌸 SYNOPSIS 🌸

podman quadlet install [options] quadlet-path-or-url [files-path-or-url]...

---

🦋 DESCRIPTION 🦋

So basically: this installs a Quadlet file, or a whole application (which can have multiple Quadlet files in it), for the current user. And the way you feed it stuff? local files or web URLs, your choice, no cap. 🔥

Here's everything this command lets you do, bestie:

• Install a single Quadlet file, and optionally tack on extra non-Quadlet files after it.
• Point it at a directory that has multiple Quadlet files plus other non-Quadlet files, and install the whole thing (like, say, a config file for a quadlet container 👀).
• Install multiple Quadlets out of a single file with the .quadlets extension, where each Quadlet is separated by a --- delimiter. Heads up though: when you're doing multiple quadlets in one .quadlets file, each quadlet section has to include a # FileName=<name> comment so it knows what to name that quadlet. periodt.

💀 Note: an application is a collection of files — quadlet and non-quadlet — that need to live together. Which means: if you remove a quadlet that's part of an application, you remove the entire application. gone, bestie. And when a quadlet gets installed from a directory, all the files installed from that directory (both quadlet and non-quadlet files) count as part of a single application.

🙈 Note: when multiple quadlets come out of one .quadlets file, they're all considered part of the same application only when you provide an application name with the --application option. iykyk.

---

⭐ OPTIONS ⭐

💜 --application=string

You can give an application name, and all the files get installed under a directory with that application name. This one's required when you're specifying a directory path, so don't forget it 🎀 Also: an application name can't have a quadlet extension as a suffix — like, foo.container isn't a valid application name, sorry babe.

💖 --reload-systemd

Reloads systemd after the operation completes (default true). To turn it off you have to manually set the value of this flag to false — it doesn't just flip itself, okay?

🎀 --replace, -r

Replaces the Quadlet installation even if the generated unit file already exists (default false). To turn it on, you have to manually set the value of this flag to true. This flag is used primarily to update an existing unit. slay 🔥

---

🌈 EXAMPLES 🌈

Install quadlet from a file. 💅

$ podman quadlet install test-service-quadlet.container
/home/user/.config/containers/systemd/test-service-quadlet.container

Install quadlet from a dir. 🍓

$ podman quadlet install --application=foo /home/user/work/quadlet-app/
/home/user/.config/containers/systemd/myquadlet1.container
/home/user/.config/containers/systemd/myquadlet2.container
/install/path/myquadlet1.container
/install/path/myquadlet2.container

Install quadlet from a url 🌐

$ podman quadlet install https://github.com/containers/podman/blob/main/test/e2e/quadlet/basic.container
/home/user/.config/containers/systemd/basic.container

Install multiple quadlets from a single .quadlets file 🧚

$ cat webapp.quadlets
# FileName=web-server
[Container]
Image=nginx:latest
ContainerName=web-server
PublishPort=8080:80
---
# FileName=app-storage
[Volume]
Label=app=webapp
---
# FileName=app-network
[Network]
Subnet=10.0.0.0/24

$ podman quadlet install webapp.quadlets
/home/user/.config/containers/systemd/web-server.container
/home/user/.config/containers/systemd/app-storage.volume
/home/user/.config/containers/systemd/app-network.network

⚠️ Note: the multi-quadlet functionality requires the .quadlets file extension. Files with other extensions only get processed as single quadlets or asset files. no exceptions, bestie 😭

---

👑 SEE ALSO 👑

podman(1), podman-quadlet(1), podman-systemd.unit(5)

---

and that's the whole page, bestie 💖 this was podman-quadlet-install(1) from the General Commands Manual — go forth and install your quadlets, you've got this 🫶✨