From 0f2de55f2ddf74883a2c75f0a1079acec488c570 Mon Sep 17 00:00:00 2001
From: tschettervictor <85497460+tschettervictor@users.noreply.github.com>
Date: Sat, 1 Nov 2025 14:35:59 -0400
Subject: [PATCH] document workaround for Netgraph of Proxmox VM

---
 docs/chapters/networking.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/chapters/networking.rst b/docs/chapters/networking.rst
index 1f9d9a42..ff2b02da 100644
--- a/docs/chapters/networking.rst
+++ b/docs/chapters/networking.rst
@@ -160,6 +160,20 @@ VNET Jail Interface Names
   with the ``X`` starting at ``1`` and incrementing by 1 for each new epair.
   So, ``mylongjailname`` will be ``e0a_bastille2`` and ``e0b_bastille2``.
 
+Netgraph and Proxmox VE
+^^^^^^^^^^^^^^^^^^^^^^^
+
+* When running a FreeBSD VM on Proxmox VE, you might encounter crashes when using
+  Netraph. This bug is being tracked at
+  https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=238326
+
+  One workaround is to add the following line to the ``jail.conf`` file of the affected
+  jail(s).
+
+.. code-block:: shell
+
+  exec.prestop += "jng shutdown JAILNAME";
+
 Network Scenarios
 -----------------