Skip to content

feat: add docs for vmnet config in finch.yaml#216

Open
ayush-panta wants to merge 1 commit into
mainfrom
update-shared-networking-docs
Open

feat: add docs for vmnet config in finch.yaml#216
ayush-panta wants to merge 1 commit into
mainfrom
update-shared-networking-docs

Conversation

@ayush-panta

@ayush-panta ayush-panta commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

Description of changes:

Adds documentation for the new vmnet configuration option in the configuration reference. This option was introduced in runfinch/finch#1749 to make socket_vmnet opt-in rather than force-installed. Previously, every finch vm init required sudo to install socket_vmnet regardless of whether shared networking was needed.

With this change:

  • vmType: qemu users who need shared networking explicitly set vmnet: true (sudo required once)
  • vmType: vz users who set vmnet: true get vzNAT networking automatically with no privilege escalation
  • Default (vmnet unset/false): No sudo prompt, no socket_vmnet (the majority use case)

Terms of contribution:

By submitting this pull request, I confirm that my contribution is made under the terms of the licenses outlined in the LICENSE-SUMMARY file.

@ayush-panta ayush-panta requested a review from a team as a code owner June 1, 2026 18:53
Signed-off-by: ayush-panta <ayushkp@amazon.com>
@ayush-panta ayush-panta force-pushed the update-shared-networking-docs branch from dc4b05e to 90e24ac Compare June 26, 2026 05:38
@ayush-panta ayush-panta changed the title feat: add docs for socketVMNet config in finch.yaml feat: add docs for vmnet config in finch.yaml Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant