You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17-2Lines changed: 17 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -113,15 +113,17 @@ Finch has a simple and extensible configuration.
113
113
114
114
A configuration file at `${HOME}/.finch/finch.yaml` will be generated on first run. Currently, this config file has options for system resource limits for the underlying virtual machine. These default limits are generated dynamically based on the resources available on the host system, but can be changed by manually editing the config file.
115
115
116
-
For a full list of configuration options, check [the struct here](https://github.com/runfinch/finch/blob/main/pkg/config/config.go#L34).
116
+
For a full list of configuration options, check the finch struct for [macOS](pkg/config/config_darwin.go#L32).
117
117
118
118
An example `finch.yaml` looks like this:
119
119
120
120
```yaml
121
121
# cpus: the amount of vCPU to dedicate to the virtual machine. (required)
122
122
cpus: 4
123
+
123
124
# memory: the amount of memory to dedicate to the virtual machine. (required)
124
125
memory: 4GiB
126
+
125
127
# snapshotters: the snapshotters a user wants to use (the first snapshotter will be set as the default snapshotter)
# additional_directories: the work directories that are not supported by default. In macOS, only home directory is supported by default.
148
152
# For example, if you want to mount a directory into a container, and that directory is not under your home directory,
149
153
# then you'll need to specify this field to add that directory or any ascendant of it as a work directory. (optional)
150
154
additional_directories:
151
155
# the path of each additional directory.
152
156
- path: /Volumes
157
+
153
158
# vmType: sets which Hypervisor to use to launch the VM. (optional)
154
159
# Only takes effect when a new VM is launched (only on vm init).
155
160
# One of: "qemu", "vz".
@@ -159,6 +164,7 @@ additional_directories:
159
164
# NOTE: prior to version 1.2.0, "qemu" was the default, and it will still be the default for
160
165
# macOS versions that do not support Virtualization.framework (pre-13.0.0).
161
166
vmType: "vz"
167
+
162
168
# rosetta: sets whether to enable Rosetta as the binfmt_misc handler for x86_64
163
169
# binaries inside the VM, as an alternative to qemu user mode emulation. (optional)
164
170
# Only takes effect when a new VM is launched (only on vm init).
@@ -169,13 +175,17 @@ vmType: "vz"
169
175
# some performance regressions, as noted in this issue:
170
176
# https://github.com/lima-vm/lima/issues/1269
171
177
rosetta: false
178
+
179
+
# dockercompat: a configuration parameter to activate finch functionality to accept Docker-like commands and arguments.
180
+
# For running DevContainers on Finch, this functionality will convert Docker-like arguments into compatible nerdctl commands and arguments.
181
+
dockercompat: true
172
182
```
173
183
174
184
#### Windows
175
185
176
186
A configuration file at `$env:LOCALAPPDATA\.finch\finch.yaml` will be generated on first run. Currently, this config file does not have options for system resource [limits due to limitations in WSL](https://github.com/microsoft/WSL/issues/8570).
177
187
178
-
For a full list of configuration options, check [the struct here](pkg/config/config.go#L30).
188
+
For a full list of configuration options, check the finch struct for [windows](pkg/config/config_windows.go#L18).
179
189
180
190
An example `finch.yaml` looks like this:
181
191
@@ -190,6 +200,7 @@ An example `finch.yaml` looks like this:
190
200
# and remove the snapshotter configuration in the containerd config file found at /etc/containerd/config.toml
191
201
snapshotters:
192
202
- soci
203
+
193
204
# creds_helpers: a list of credential helpers that will be installed and configured automatically.
0 commit comments