Merge pull request #756 from arabcoders/dev

Feat: Ability to disable or change the level of webhook logs

Author: arabcoders

FAQ.md

@@ -724,3 +724,31 @@ from the trusted sources will be granted access without further authentication.
 > Setting both `WS_TRUST_PROXY` and `WS_TRUST_LOCAL` to true will disable all internal authentication mechanisms.
 > Ensure that your external auth layer is secure and properly configured to prevent unauthorized access. Your entire
 > WatchState instance will be open to anyone who access it via local network.
+
+--- 
+
+# Failing due to duplicate UUID
+
+If you clone your media backend instance, your UUID might be duplicated as well. Unfortunately we cannot add a check
+against that as it would break `3-way sync`. Duplicate UUID may lead to unforeseen issues such as automatic sub users
+creation failing to load. To fix the issue it's recommended to change the backend UUID to do so,
+
+* For jellyfin: `config/data/device.txt`
+* For Emby: `data/device.txt`
+* For Plex: `Library/Application Support/Plex Media Server/Preferences.xml` key: `ProcessedMachineIdentifier`.
+
+Those values need to be unique per instance.
+
+--- 
+
+# Failing due to duplicate UUID
+
+If you clone your media backend instance, your UUID might be duplicated as well. Unfortunately we cannot add a check
+against that as it would break `3-way sync`. Duplicate UUID may lead to unforeseen issues such as automatic sub users
+creation failing to load. To fix the issue it's recommended to change the backend UUID to do so,
+
+* For jellyfin: `config/data/device.txt`
+* For Emby: `data/device.txt`
+* For Plex: `Library/Application Support/Plex Media Server/Preferences.xml` key: `ProcessedMachineIdentifier`.
+
+Those values need to be unique per instance.

README.md

@@ -82,7 +82,7 @@ $ docker compose up -d
 ### Via docker command.
 
 ```bash
-$ docker run -d --rm --user "${UID:-1000}:${GID:-1000}" --name watchstate --restart unless-stopped -p 8080:8080 -v ./data:/config:rw ghcr.io/arabcoders/watchstate:latest
+$ docker run -d --user "${UID:-1000}:${GID:-${UID:-1000}}" --name watchstate --restart unless-stopped -p 8080:8080 -v ./data:/config:rw ghcr.io/arabcoders/watchstate:latest
 ```
 
 > [!IMPORTANT]

composer.json

@@ -52,7 +52,8 @@
         "dragonmantank/cron-expression": "^3.4.0",
         "halaxa/json-machine": "^1.2.0",
         "ramsey/uuid": "^4.7.6",
-        "perftools/php-profiler": "^1.1.2"
+        "perftools/php-profiler": "^1.1.2",
+        "firebase/php-jwt": "^6.11"
     },
     "suggest": {
         "ext-sockets": "For UDP communications."

composer.lock

@@ -144,7 +144,11 @@
     ];
 
     $config['webhook'] = [
-        'logfile' => ag($config, 'tmpDir') . '/logs/webhook.' . $logDateFormat . '.log',
+        'log' => [
+            'enabled' => (bool)env('WS_WEBHOOK_LOG_ENABLED', true),
+            'level' => env('WS_WEBHOOK_LOG_LEVEL', Level::Info),
+            'file' => ag($config, 'tmpDir') . '/logs/webhook.' . $logDateFormat . '.log',
+        ],
         'dumpRequest' => (bool)env('WS_WEBHOOK_DUMP_REQUEST', false),
         'tokenLength' => (int)env('WS_WEBHOOK_TOKEN_LENGTH', 16),
         'file_format' => (string)env('WS_WEBHOOK_LOG_FILE_FORMAT', 'webhook.{backend}.{event}.{id}.json'),