Files
podman/docs/source/markdown/podman-quadlet-install.1.md
Matt Heon f293c1a179 Initial implementation of podman quadlet commands
This adds `podman quadlet list`, `podman quadlet install`,
`podman quadlet rm` and `podman quadlet print`.

Signed-off-by: Matt Heon <mheon@redhat.com>
Co-authored-by: flouthoc <flouthoc.git@gmail.com>
Signed-off-by: flouthoc <flouthoc.git@gmail.com>
2025-07-18 13:57:11 -07:00

2.0 KiB

% podman-quadlet-install 1

NAME

podman-quadlet-install - Install a quadlet file or quadlet application

SYNOPSIS

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

DESCRIPTION

Install a Quadlet file or an application (which may include multiple Quadlet files) for the current user. You can specify Quadlet files as local files or web URLs.

This command allows you to:

* Install a single Quadlet file, optionally followed by additional non-Quadlet files.

* Specify a directory containing multiple Quadlet files and other non-Quadlet files for installation ( example a config file for a quadlet container ).

Note: If a quadlet is part of an application, removing that specific quadlet will remove the entire application. When a quadlet is installed from a directory, all files installed from that directory—including both quadlet and non-quadlet files—are considered part of a single application.

Note: In case user wants to install Quadlet application then first path should be the path to application directory.

OPTIONS

--reload-systemd

Reload systemd after installing Quadlets (default true). In order to disable it users need to manually set the value of this flag to false.

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 /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

SEE ALSO

podman(1), podman-quadlet(1)