From 25460d97cffffe24f565a9d654c4aab1848598b4 Mon Sep 17 00:00:00 2001
From: Astro <astro@spaceboyz.net>
Date: Fri, 8 Sep 2023 14:31:09 +0200
Subject: [PATCH] doc/shares: describe writableStoreOverlay amnesia

Pertains to Github issue #134
---
 doc/src/shares.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/src/shares.md b/doc/src/shares.md
index 328801c9..49483514 100644
--- a/doc/src/shares.md
+++ b/doc/src/shares.md
@@ -48,3 +48,8 @@ don't work currently, so resort to using a volume for that:
   } ];
 }
 ```
+
+**Caveat:** The Nix database will forget all built packages after a
+reboot, containing only what is needed for the VM's NixOS
+system. Until this has been solved, it is recommended to just delete
+and recreate the overlay after MicroVM shutdown or before startup.