Skip to content

Commit 23bbc9a

Browse files
committed
builder: document how to generate the image for podman
Signed-off-by: Yann Dirson <[email protected]>
1 parent 589a20c commit 23bbc9a

File tree

1 file changed

+19
-7
lines changed

1 file changed

+19
-7
lines changed

developer/building/qubes-builder-v2.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -77,21 +77,27 @@ if you don't know which executor to use, use docker.
7777
```
7878
Next, **restart the qube**.
7979
80-
5. Finally, you need to generate a docker image:
80+
5. Finally, you need to generate a container image, for either `docker` or `podman`.
8181
82-
```shell
83-
$ tools/generate-container-image.sh docker
84-
```
85-
86-
In an app qube, as `/var/lib/docker` is not persistent by default, you also
82+
If you are using `docker` and an app qube, as `/var/lib/docker` is not persistent by default, you also
8783
need to use [bind-dirs](/doc/bind-dirs/) to avoid repeating this step after reboot, adding
8884
the following to the `/rw/config/qubes-bind-dirs.d/docker.conf` file in
89-
this qube:
85+
this qube, and restarting your Qube before proceeding to the image generation:
9086
9187
```
9288
binds+=( '/var/lib/docker' )
9389
```
9490
91+
Note this is not useful with `podman`, which uses `~/.local/share/containers/`.
92+
93+
Depending on your choice of a container runtime, run one of:
94+
```shell
95+
$ tools/generate-container-image.sh docker
96+
```
97+
```shell
98+
$ tools/generate-container-image.sh podman
99+
```
100+
95101
# Configuration
96102
97103
To use Qubes OS Builder v2, you need to have a `builder.yml` configuration file.
@@ -127,6 +133,12 @@ executor:
127133
image: "qubes-builder-fedora:latest"
128134
```
129135
136+
If you want use the `podman` executor, you have to enable socket
137+
activation, with:
138+
139+
```
140+
systemctl --user enable --now podman.socket
141+
```
130142
131143
# Using Builder v2
132144

0 commit comments

Comments
 (0)