mirror of
https://github.com/containers/podman.git
synced 2025-11-29 01:28:22 +08:00
91 lines
3.3 KiB
Markdown
91 lines
3.3 KiB
Markdown
% 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 ).
|
|
|
|
* Install multiple Quadlets from a single file with the `.quadlets` extension, where each Quadlet is separated by a `---` delimiter. When using multiple quadlets in a single `.quadlets` file, each quadlet section must include a `# FileName=<name>` comment to specify the name for that quadlet.
|
|
|
|
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. Similarly, when multiple quadlets are installed from a single `.quadlets` file, they are all considered part of the same 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`.
|
|
|
|
#### **--replace**, **-r**
|
|
|
|
Replace the Quadlet installation even if the generated unit file already exists (default false).
|
|
In order to enable it, users need to manually set the value
|
|
of this flag to `true`. This flag is used primarily to update an existing unit.
|
|
|
|
## 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
|
|
```
|
|
|
|
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: Multi-quadlet functionality requires the `.quadlets` file extension. Files with other extensions will only be processed as single quadlets or asset files.
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-quadlet(1)](podman-quadlet.1.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**
|