Skip to content

Commit 63593eb

Browse files
committed
chore: add disclaimer for macOS vms
Signed-off-by: Frank Kong <frkong@redhat.com>
1 parent 9c914d5 commit 63593eb

2 files changed

Lines changed: 12 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,12 @@ Container-based development provides consistency and isolation.
5151
podman machine start
5252
```
5353

54+
**macOS Note:** When using `podman machine`, the default `applehv` VM may cause issues with native module building during `yarn install`. If you encounter build failures, try using the `libkrun` VM instead:
55+
56+
```bash
57+
podman machine init --vmtype libkrun
58+
```
59+
5460
#### Building the Development Image
5561

5662
```bash

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,12 @@ The container requires specific capabilities and device access for building dyna
126126

127127
The `--device /dev/fuse` flag passes the FUSE device from the Linux environment (native on Linux, or from Podman Machine's VM on macOS/Windows) to the container, enabling buildah operations.
128128

129+
**macOS Note:** When using `podman machine`, the default `applehv` VM may cause issues with native module building during `yarn install`. If you encounter build failures, try using the `libkrun` VM instead:
130+
131+
```bash
132+
podman machine init --vmtype libkrun
133+
```
134+
129135
### Basic Container Usage
130136

131137
```bash

0 commit comments

Comments
 (0)