feat: optionally disable creation of readme.txt on the shared folder

readme.md

@@ -161,6 +161,13 @@ kubectl apply -f kubernetes.yml
 
   The example folder `/home/user/example` will be available as ` \\host.lan\Data`. You can optionally map this path to a drive letter in Windows, for easier access.
 
+  At boot, the file `readme.txt` will be created on the folder unless you disable it:
+
+  ```yaml
+  environment:
+    README: "N"
+  ```
+
 * ### How do I install a custom image?
 
   In order to download an unsupported ISO image that is not selectable from the list above, specify the URL of that ISO in the `VERSION` environment variable, for example:

src/define.sh

@@ -11,6 +11,7 @@ set -Eeuo pipefail
 : "${LANGUAGE:=""}"
 : "${USERNAME:=""}"
 : "${PASSWORD:=""}"
+: "${README:=""}"
 
 MIRRORS=5
 PLATFORM="x64"

src/samba.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 set -Eeuo pipefail
 
+: "${README:="Y"}"
 : "${SAMBA:="Y"}"
 
 [[ "$SAMBA" != [Yy1]* ]] && return 0
@@ -50,25 +51,27 @@ mkdir -p "$share"
         echo "    force group = root"
 } > "/etc/samba/smb.conf"
 
-{      echo "--------------------------------------------------------"
-        echo " $APP for Docker v$(</run/version)..."
-        echo " For support visit $SUPPORT"
-        echo "--------------------------------------------------------"
-        echo ""
-        echo "Using this folder you can share files with the host machine."
-        echo ""
-        echo "To change its location, include the following bind mount in your compose file:"
-        echo ""
-        echo "  volumes:"
-        echo "    - \"/home/user/example:/shared\""
-        echo ""
-        echo "Or in your run command:"
-        echo ""
-        echo "  -v \"/home/user/example:/shared\""
-        echo ""
-        echo "Replace the example path /home/user/example with the desired shared folder."
-        echo ""
-} | unix2dos > "$share/readme.txt"
+if [[ "$README" == [Yy1]* ]] ;then
+  { echo "--------------------------------------------------------"
+    echo " $APP for Docker v$(</run/version)..."
+    echo " For support visit $SUPPORT"
+    echo "--------------------------------------------------------"
+    echo ""
+    echo "Using this folder you can share files with the host machine."
+    echo ""
+    echo "To change its location, include the following bind mount in your compose file:"
+    echo ""
+    echo "  volumes:"
+    echo "    - \"/home/user/example:/shared\""
+    echo ""
+    echo "Or in your run command:"
+    echo ""
+    echo "  -v \"/home/user/example:/shared\""
+    echo ""
+    echo "Replace the example path /home/user/example with the desired shared folder."
+    echo ""
+  } | unix2dos > "$share/readme.txt"
+fi
 
 ! smbd && smbd --debug-stdout