Differences

This shows you the differences between two versions of the page.

--- omv8:docker_in_omv [2025/12/22 18:05] – [Syncthing] chente
+++ omv8:docker_in_omv [2026/01/11 07:30] (current) – [1. Choose a container] chente
@@ Line 196: / Line 196: @@
 <html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#69A5FF;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">&#160; Beginners Info
 </span></strong></td></tr><tr><td style="background-color:#E6FEFF;padding:10px;width:380px;">
-Installing OMV on a USB flash drive may seem unusual to newcomers, but you may be surprised to learn that many professional-grade servers boot directly from USB devices.<br>
+Installing OMV on a USB flash drive (or SD card) may seem unusual to newcomers, but you may be surprised to learn that many professional-grade servers boot directly from USB devices.<br>
 This approach provides several advantages and no drawbacks:<br>
 <ul>
@@ Line 373: / Line 373: @@
     *...<html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#69A5FF;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">&#160; Note
 </span></strong></td></tr><tr><td style="background-color:#E6FEFF;padding:10px;width:380px;">
-In the system diagram of this document, the <i>backup_compose</i> folder is located on the NVMe drive rather than on the dedicated backup drive.<br><br>
+In the system diagram of this document, the <i>backup_compose</i> folder is located on the NVMe drive rather than on the dedicated backup drive.<br>
-The plugin’s scheduled backup function is designed to produce a consistent and up-to-date copy of your persistent data by temporarily stopping the containers during the backup and starting them again afterward. Since each backup overwrites the previous one, this folder is ideal for use together with a separate backup application, which can then create versioned and/or compressed backups <b>without needing to stop the containers</b>.<br><br>
+<ul>
-If you prefer, you can place this folder directly on your backup drive instead — both approaches are valid.
+<li>The plugin’s scheduled backup function is designed to produce a consistent and up-to-date copy of your persistent data by temporarily stopping the containers during the backup and starting them again afterward. Since each backup overwrites the previous one, this folder is ideal for use together with a separate backup application, which can then create versioned and/or compressed backups <b>without needing to stop the containers</b>.</li>
+<li>If you prefer, you can place this folder directly on your backup drive instead — both approaches are valid.</li>
+</ul>
 </tr></table></body></html>
@@ Line 398: / Line 400: @@
 Warning
 </span></strong></td></tr><tr><td style="background-color:#FFE4A6;padding:10px;width:380px;">
-<b>The filesystem hosting the docker folder should preferably be EXT4</b>.<br>
+<b>The filesystem hosting the docker folder should preferably be EXT4</b>.<br><br>
-If you need to place it on <b>ZFS</b> or <b>BTRFS</b> file system, consult the official Docker documentation for the required configuration.<br>
+<ul>
-<b>Never use an NTFS</b> file system for Docker data — it does not work and will lead to failures. (or generally for anything on linux other than a staging mount for copying data).<br>
+<li>If you need to place it on <b>ZFS</b> or <b>BTRFS</b> file system, consult the official Docker documentation for the required configuration.</li>
-Do not place the Docker folder in a <b>mergerfs</b> pool, as Docker will spread its internal files across multiple drives, eventually causing corruption or operational problems.<br>
+<li><b>Never use an NTFS</b> file system for Docker data — it does not work and will lead to failures. (or generally for anything on linux other than a staging mount for copying data).</li>
-If the only storage available is inside a mergerfs pool, you may:
+<li>Do not place the Docker folder in a <b>mergerfs</b> pool, as Docker will spread its internal files across multiple drives, eventually causing corruption or operational problems. If the only storage available is inside a mergerfs pool, you may:<br>
-- Create the Docker folder directly on a specific drive that belongs to the pool instead of inside the pool, and configure the plugin using the absolute path of that drive.
+- Create the Docker folder directly on a specific drive that belongs to the pool instead of inside the pool, and configure the plugin using the absolute path of that drive.<br>
-- Avoid using mergerfs rebalance on that pool, as it may move Docker’s files to another drive and break Docker.
+- Avoid using mergerfs rebalance on that pool, as it may move Docker’s files to another drive and break Docker.<br>
+- Alternatively, configure the pool by merging folders instead of file systems and place the Docker folder outside of those paths. See the mergerfs documentation on this wiki.</li>
+</ul>
 </tr></table></body></html>
     *...<html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#2C6700;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">&#160; Advanced configuration.
 </span></strong></td></tr><tr><td style="background-color:#e7fae1;padding:10px;width:380px;">
-You can <b>manually edit /etc/docker/daemon.json to customize</b> Docker’s behaviour.<br>
+You can <b>manually edit /etc/docker/daemon.json to customize</b> Docker’s behaviour.<br><br>
-This is required, for example, to configure an NVIDIA GPU driver or to set a custom storage driver for certain filesystems.<br>
+<ul>
-If you need to customize this file, simply <b>leave the Docker storage field empty</b> in the plugin settings — the plugin will not modify the file.<br>
+<li>This is required, for example, to configure an NVIDIA GPU driver or to set a custom storage driver for certain filesystems.</li>
+<li>If you need to customize this file, simply <b>leave the Docker storage field empty</b> in the plugin settings — the plugin will not modify the file.</li>
 </tr></table></body></html>
@@ Line 523: / Line 528: @@
 <html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#69A5FF;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">&#160; Note
 </span></strong></td></tr><tr><td style="background-color:#E6FEFF;padding:10px;width:380px;">
-Verify on the official page that this compose file has not changed before installing it
+Verify on the official page that this compose file has not changed before installing it.<br>
+If you notice any recent changes, you can report them in the forum for updates.
 </tr></table></body></html>
 \\
@@ Line 567: / Line 573: @@
 <ul>
 <li>${{ uid:"USERNAME" }} → resolves to the UID of that user</li>
-<li>${{ gid:"USERNAME" }} → resolves to the GID of that user</li>
+<li>${{ gid:"GROUPNAME" }} → resolves to the GID of that group</li>
 <li>${{ tz }} → resolves to the system time zone</li>
 <li>${{ sf:"SHARENAME" }} → resolves to the full path of a shared folder</li>
@@ Line 840: / Line 846: @@
       - PGID=${{ gid:"users" }}
       - TZ=${{ tz }}
-      - SETTINGS_ENCRYPTION_KEY="MyKeyOMV8"
+      - SETTINGS_ENCRYPTION_KEY=MyKeyOMV8 #Set a secure key
       #- CLI_ARGS= #optional
       #- DUPLICATI__WEBSERVICE_PASSWORD= #optional
@@ Line 1046: / Line 1052: @@
     environment:
       - APACHE_PORT=11000
-      - NEXTCLOUD_DATADIR=${{ sf:data }}/nextcloud_data
+      - NEXTCLOUD_DATADIR=${{ sf:"data" }}/nextcloud_data
 volumes:
   nextcloud_aio_mastercontainer:
@@ Line 1168: / Line 1174: @@
 <nowiki>${{ uid:"USERNAME" }}</nowiki>
-<nowiki>${{ gid:"USERNAME" }}</nowiki>
+<nowiki>${{ gid:"GROUPNAME" }}</nowiki>
-//(where USERNAME is the name of the existing user)//
+//(where USERNAME is the name of the existing user and GROUPNAME is the group of this user)//
 The plugin will automatically replace these expressions with the UID and GID values belonging to the user with that USERNAME.
   * For example, if the user //peter// has the values ''UID=1003'' and ''GID=100'', the expressions:
 <code>- PUID=${{ uid:"peter" }}
-- PGID=${{ gid:"peter" }}</code>
+- PGID=${{ gid:"users" }}</code>
   * will be automatically replaced by:
 <code>- PUID=1003