From 53b83ea01002ce49a8da4fa9ea7359e7907ec4dc Mon Sep 17 00:00:00 2001
From: Alper Alkan <alper.alkan2000@gmail.com>
Date: Sun, 12 Jan 2025 15:28:39 +0100
Subject: [PATCH] add docs on running multivolumes

---
 docs/server-docs/structure.md | 45 +++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/server-docs/structure.md b/docs/server-docs/structure.md
index 8cd5be04a..0a4841573 100644
--- a/docs/server-docs/structure.md
+++ b/docs/server-docs/structure.md
@@ -71,3 +71,48 @@ Here are some other valid examples of game names that follow the naming conventi
 - `Stray (2022).7z`
 - `Captain of Industry (v0.4.12b) (EA) (2022).gz`
 - `Minecraft (2011).exe`
+
+## Mounting Multiple Game Volumes
+
+Modern games can be quite large, often requiring storage across multiple disks on the server side. GameVault, however, uses a single `/files` folder to access its games. How can you map multiple drives to your GameVault server while ensuring seamless operation?
+
+### Using Docker
+
+If you’re running GameVault in Docker, mounting additional volumes is straightforward. You can add extra volumes to the GameVault server configuration by pointing each mounted drive on the host side to a subfolder under `/files` on the container side. Here's an example:
+
+```yaml
+services:
+  gamevault-backend:
+    [...]
+    volumes:
+      - /mnt/disk1/games:/files
+      - /mnt/disk2/games:/files/disk2
+    [...]
+```
+
+In this setup:
+
+- `/mnt/disk1/games` is mounted as the main `/files` directory.
+- `/mnt/disk2/games` is mounted as a subfolder `/files/disk2`, allowing GameVault to access games stored on a second disk.
+
+### Running Natively
+
+For systems running GameVault natively without Docker, you can achieve similar results using symbolic links. These links enable the GameVault file watcher to locate games stored across different drives, all accessible within the designated `/files` folder.
+
+To create a symbolic link:
+
+1. Navigate to your configured `/files` directory:
+
+   ```bash
+   cd /files
+   ```
+
+2. Create a symbolic link for each additional drive:
+
+   ```bash
+   ln -s /mnt/disk2/games disk2
+   ```
+
+   This command creates a link named `disk2` within `/files` that points to `/mnt/disk2/games`.
+
+With this setup, GameVault will scan and recognize games stored across multiple drives, maintaining a unified structure under the `/files` folder.