Merge branch 'main' of https://github.com/jokob-sk/NetAlertX

2026-03-30 23:03:03 -07:00 · 2026-01-13 04:26:35 +00:00
parent bc2cfb9384 0ceb589935
commit 0eb2368712
25 changed files with 50 additions and 47 deletions
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -5,7 +5,7 @@ body:
 - type: checkboxes
  attributes:
    label: Is there an existing issue for this?
-    description: Please search to see if an open or closed issue already exists for the feature you are requesting. 
+    description: Please search to see if an open or closed issue already exists for the feature you are requesting.
    options:
    - label: I have searched the existing open and closed issues
      required: true
@@ -32,21 +32,21 @@ body:
    label: Anything else?
    description: |
      Links? References? Mockups? Anything that will give us more context about the feature you are encountering!
-      
+
      Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
  validations:
    required: true
 - type: checkboxes
  attributes:
    label: Am I willing to test this? 🧪
-    description: I rely on the community to test unreleased features. If you are requesting a feature, please be willing to test it within 48h of test request. Otherwise, the feature might be pulled from the code base. 
+    description: I rely on the community to test unreleased features. If you are requesting a feature, please be willing to test it within 48h of test request. Otherwise, the feature might be pulled from the code base.
    options:
    - label: I will do my best to test this feature on the `netlertx-dev` image when requested within 48h and report bugs to help deliver a great user experience for everyone and not to break existing installations.
      required: true
 - type: checkboxes
  attributes:
-    label: Can I help implement this? 👩‍💻👨‍💻 
-    description: The maintainer will provide guidance and help. The implementer will read the PR guidelines https://jokob-sk.github.io/NetAlertX/DEV_ENV_SETUP/
+    label: Can I help implement this? 👩‍💻👨‍💻
+    description: The maintainer will provide guidance and help. The implementer will read the PR guidelines https://docs.netalertx.com/DEV_ENV_SETUP/
    options:
    - label: "Yes"
    - label: "No"
--- a/.github/ISSUE_TEMPLATE/i-have-an-issue.yml
+++ b/.github/ISSUE_TEMPLATE/i-have-an-issue.yml
@@ -21,7 +21,7 @@ body:
    label: Is there an existing issue for this?
    description: Please search to see if an open or closed issue already exists for the bug you encountered.
    options:
-    - label: I have searched the existing open and closed issues and I checked the docs https://jokob-sk.github.io/NetAlertX/
+    - label: I have searched the existing open and closed issues and I checked the docs https://docs.netalertx.com/
      required: true
 - type: checkboxes
  attributes:
--- a/.github/ISSUE_TEMPLATE/setup-help.yml
+++ b/.github/ISSUE_TEMPLATE/setup-help.yml
@@ -21,7 +21,7 @@ body:
    label: Did I research?
    description: Please confirm you checked the usual places before opening a setup support request.
    options:
-    - label: I have searched the docs https://jokob-sk.github.io/NetAlertX/
+    - label: I have searched the docs https://docs.netalertx.com/
      required: true
    - label: I have searched the existing open and closed issues
      required: true
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -52,7 +52,7 @@ Backend loop phases (see `server/__main__.py` and `server/plugin.py`): `once`, `

 ## Conventions & helpers to reuse
 - Settings: add/modify via `ccd()` in `server/initialise.py` or per‑plugin manifest. Never hardcode ports or secrets; use `get_setting_value()`.
- Logging: use `mylog(level, [message])`; levels: none/minimal/verbose/debug/trace. `none` is used for most important messages that should always appear, such as exceptions.
+- Logging: use `mylog(level, [message])`; levels: none/minimal/verbose/debug/trace. `none` is used for most important messages that should always appear, such as exceptions. Do NOT use `error` as level.
 - Time/MAC/strings: `server/utils/datetime_utils.py` (`timeNowDB`), `front/plugins/plugin_helper.py` (`normalize_mac`), `server/helper.py` (sanitizers). Validate MACs before DB writes.
 - DB helpers: prefer `server/db/db_helper.py` functions (e.g., `get_table_json`, device condition helpers) over raw SQL in new paths.

@@ -71,13 +71,15 @@ Backend loop phases (see `server/__main__.py` and `server/plugin.py`): `once`, `
 - When adding a plugin, start from `front/plugins/__template`, implement with `plugin_helper`, define manifest settings, and wire phase via `<PREF>_RUN`. Verify logs in `/tmp/log/plugins/` and data in `api/*.json`.
 - When introducing new config, define it once (core `ccd()` or plugin manifest) and read it via helpers everywhere.
 - When exposing new server functionality, add endpoints in `server/api_server/*` and keep authorization consistent; update UI by reading/writing JSON cache rather than bypassing the pipeline.
+- Always try following the DRY principle, do not re-implement functionality, but re-use existing methods where possible, or refactor to use a common method that is called multiple times
+- If new functionality needs to be added, look at impenting it into existing handlers (e.g. `DeviceInstance` in `server/models/device_instance.py`) or create a new one if it makes sense. Do not access the DB from otehr application layers.
+- Code files shoudln't be longer than 500 lines of code

 ## Useful references
 - Docs: `docs/PLUGINS_DEV.md`, `docs/SETTINGS_SYSTEM.md`, `docs/API_*.md`, `docs/DEBUG_*.md`
 - Logs: All logs are under `/tmp/log/`. Plugin logs are very shortly under `/tmp/log/plugins/` until picked up by the server.
  - plugin logs: `/tmp/log/plugins/*.log`
  - backend logs: `/tmp/log/stdout.log` and `/tmp/log/stderr.log`
-  - frontend commands logs: `/tmp/log/app_front.log`
  - php errors: `/tmp/log/app.php_errors.log`
  - nginx logs: `/tmp/log/nginx-access.log` and `/tmp/log/nginx-error.log`

--- a/README.md
+++ b/README.md
@@ -34,7 +34,7 @@ Get visibility of what's going on on your WIFI/LAN network and enable presence d
 ## 🚀 Quick Start

 > [!WARNING]
-> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://jokob-sk.github.io/NetAlertX/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.
+> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://docs.netalertx.com/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.

 Start NetAlertX in seconds with Docker:

@@ -60,14 +60,14 @@ docker compose up --force-recreate --build
 # To customize: edit docker-compose.yaml and run that last command again
 ```

-Need help configuring it? Check the [usage guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/README.md) or [full documentation](https://jokob-sk.github.io/NetAlertX/).
+Need help configuring it? Check the [usage guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/README.md) or [full documentation](https://docs.netalertx.com/).

 For Home Assistant users: [Click here to add NetAlertX](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons)

 For other install methods, check the [installation docs](#-documentation)


-| [📑 Docker guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_INSTALLATION.md) | [🚀 Releases](https://github.com/jokob-sk/NetAlertX/releases) | [📚 Docs](https://jokob-sk.github.io/NetAlertX/) | [🔌 Plugins](https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md) | [🤖 Ask AI](https://gurubase.io/g/netalertx)
+| [📑 Docker guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_INSTALLATION.md) | [🚀 Releases](https://github.com/jokob-sk/NetAlertX/releases) | [📚 Docs](https://docs.netalertx.com/) | [🔌 Plugins](https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md) | [🤖 Ask AI](https://gurubase.io/g/netalertx)
 |----------------------| ----------------------|  ----------------------| ----------------------| ----------------------|

 ![showcase][showcase]
@@ -117,7 +117,7 @@ Supported browsers: Chrome, Firefox
 - [[Development] API docs](https://github.com/jokob-sk/NetAlertX/blob/main/docs/API.md)
 - [[Development] Custom Plugins](https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS_DEV.md)

-...or explore all the [documentation here](https://jokob-sk.github.io/NetAlertX/).
+...or explore all the [documentation here](https://docs.netalertx.com/).

 ## 🔐 Security & Privacy

@@ -156,7 +156,7 @@ A: In the `/data/config` and `/data/db` folders. Back up these folders regularly
 - Notification throttling may be needed for large networks to prevent spam.
 - On some systems, elevated permissions (like `CAP_NET_RAW`) may be needed for low-level scanning.

-Check the [GitHub Issues](https://github.com/jokob-sk/NetAlertX/issues) for the latest bug reports and solutions and consult [the official documentation](https://jokob-sk.github.io/NetAlertX/).
+Check the [GitHub Issues](https://github.com/jokob-sk/NetAlertX/issues) for the latest bug reports and solutions and consult [the official documentation](https://docs.netalertx.com/).

 ## 📃 Everything else
 <!--- --------------------------------------------------------------------- --->
--- a/docs/API_LOGS.md
+++ b/docs/API_LOGS.md
@@ -18,7 +18,6 @@ Only specific, pre-approved log files can be purged for security and stability r

 ```
 app.log
-app_front.log
 IP_changes.log
 stdout.log
 stderr.log
--- a/docs/API_SESSIONS.md
+++ b/docs/API_SESSIONS.md
@@ -118,11 +118,14 @@ curl -X DELETE "http://<server_ip>:<GRAPHQL_PORT>/sessions/delete" \
  ```
 #### `curl` Example

+**get sessions for mac**
+
 ```bash
 curl -X GET "http://<server_ip>:<GRAPHQL_PORT>/sessions/list?mac=AA:BB:CC:DD:EE:FF&start_date=2025-08-01&end_date=2025-08-21" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Accept: application/json"
 ```
+
 ---

 ### Calendar View of Sessions
--- a/docs/DOCKER_COMPOSE.md
+++ b/docs/DOCKER_COMPOSE.md
@@ -1,7 +1,7 @@
 # NetAlertX and Docker Compose

 > [!WARNING]
-> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://jokob-sk.github.io/NetAlertX/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.
+> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://docs.netalertx.com/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.

 Great care is taken to ensure NetAlertX meets the needs of everyone while being flexible enough for anyone. This document outlines how you can configure your docker-compose. There are many settings, so we recommend using the Baseline Docker Compose as-is, or modifying it for your system.Good care is taken to ensure NetAlertX meets the needs of everyone while being flexible enough for anyone. This document outlines how you can configure your docker-compose. There are many settings, so we recommend using the Baseline Docker Compose as-is, or modifying it for your system.

@@ -173,10 +173,6 @@ Now, any files created by NetAlertX in `/data/config` will appear in your `/loca

 This same method works for mounting other things, like custom plugins or enterprise NGINX files, as shown in the commented-out examples in the baseline file.

-## Example Configuration Summaries
-
-Here are the essential modifications for common alternative setups.
-
 ### Example 2: External `.env` File for Paths

 This method is useful for keeping your paths and other settings separate from your main compose file, making it more portable.
--- a/docs/DOCKER_INSTALLATION.md
+++ b/docs/DOCKER_INSTALLATION.md
@@ -6,7 +6,7 @@

 # NetAlertX - Network scanner & notification framework

-| [📑 Docker guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_INSTALLATION.md) | [🚀 Releases](https://github.com/jokob-sk/NetAlertX/releases) | [📚 Docs](https://jokob-sk.github.io/NetAlertX/) | [🔌 Plugins](https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md) | [🤖 Ask AI](https://gurubase.io/g/netalertx)
+| [📑 Docker guide](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_INSTALLATION.md) | [🚀 Releases](https://github.com/jokob-sk/NetAlertX/releases) | [📚 Docs](https://docs.netalertx.com/) | [🔌 Plugins](https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md) | [🤖 Ask AI](https://gurubase.io/g/netalertx)
 |----------------------| ----------------------|  ----------------------| ----------------------| ----------------------|

 <a href="https://raw.githubusercontent.com/jokob-sk/NetAlertX/main/docs/img/GENERAL/github_social_image.jpg" target="_blank">
@@ -48,7 +48,7 @@ See alternative [docked-compose examples](https://github.com/jokob-sk/NetAlertX/

 | Variable | Description | Example/Default Value |
 | :------------- |:------------------------| -----:|
-| `PUID`      |Runtime UID override, Set to `0` to run as root. |  `20211` |
+| `PUID`      |Runtime UID override, set to `0` to run as root. |  `20211` |
 | `PGID`      |Runtime GID override  |  `20211` |
 | `PORT`      |Port of the web interface  |  `20211` |
 | `LISTEN_ADDR`      |Set the specific IP Address for the listener address for the nginx webserver (web interface). This could be useful when using multiple subnets to hide the web interface from all untrusted networks. |  `0.0.0.0` |
--- a/docs/DOCKER_MAINTENANCE.md
+++ b/docs/DOCKER_MAINTENANCE.md
@@ -1,7 +1,7 @@
 # The NetAlertX Container Operator's Guide

 > [!WARNING]
-> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://jokob-sk.github.io/NetAlertX/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.
+> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https://docs.netalertx.com/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.

 This guide assumes you are starting with the official `docker-compose.yml` file provided with the project. We strongly recommend you start with or migrate to this file as your baseline and modify it to suit your specific needs (e.g., changing file paths). While there are many ways to configure NetAlertX, the default file is designed to meet the mandatory security baseline with layer-2 networking capabilities while operating securely and without startup warnings.

--- a/docs/FILE_PERMISSIONS.md
+++ b/docs/FILE_PERMISSIONS.md
@@ -38,6 +38,8 @@ NetAlertX requires certain paths to be writable at runtime. These paths should b

 > All these paths will have **UID 20211 / GID 20211** inside the container. Files on the host will appear owned by `20211:20211`.

+## Eunning as `root`
+
 You can change the default PUID and GUID with env variables:

 ```yaml
--- a/docs/MIGRATION.md
+++ b/docs/MIGRATION.md
@@ -297,5 +297,5 @@ sudo chmod -R a+rwx /local_data_dir
 ```

 8. Start the container and verify everything works as expeexpected.
-9. Check the [Permissions -> Writable-paths](https://jokob-sk.github.io/NetAlertX/FILE_PERMISSIONS/#writable-paths) what directories to mount if you'd like to access the API or log files.
-   
+9. Check the [Permissions -> Writable-paths](https://docs.netalertx.com/FILE_PERMISSIONS/#writable-paths) what directories to mount if you'd like to access the API or log files.
+
--- a/front/php/templates/footer.php
+++ b/front/php/templates/footer.php
@@ -12,7 +12,7 @@
 #---------------------------------------------------------------------------------#
 -->

-<?php 
+<?php
  //------------------------------------------------------------------------------
  // check if authenticated
  require_once  $_SERVER['DOCUMENT_ROOT'] . '/php/templates/security.php';
@@ -24,17 +24,17 @@

    <!-- NetAlertX footer with url -->
    <a href="https://github.com/jokob-sk/NetAlertX" target="_blank">Net<b>Alert</b><sup>x</sup></a>
-     
-    
+
+
    <!-- To the right -->
    <div class="pull-right no-hidden-xs">
-      | <a href="https://gurubase.io/g/netalertx" class="pointer" target="_blank" title="Ask AI"><i class="fa fa-comment-dots fa-flip-horizontal"></i></a> 
-      | <a href="https://jokob-sk.github.io/NetAlertX/" class="pointer" target="_blank" title="Documentation"><i class="fa fa-book"></i></a>
-      | <a href="https://github.com/jokob-sk/NetAlertX/issues" class="pointer" target="_blank"><i class="fa fa-bug" title="Report a bug"></i></a> 
-      | <a href="https://discord.com/invite/NczTUTWyRr" class="pointer" target="_blank"><i class="fa-brands fa-discord" title="Join Discord"></i></a> 
-      | <?= lang('Maintenance_built_on');?>:  <?php include 'php/templates/build.php'; ?> 
-      |  Version:  <?php include 'php/templates/version.php'; ?> 
-      |     
+      | <a href="https://gurubase.io/g/netalertx" class="pointer" target="_blank" title="Ask AI"><i class="fa fa-comment-dots fa-flip-horizontal"></i></a>
+      | <a href="https://docs.netalertx.com/" class="pointer" target="_blank" title="Documentation"><i class="fa fa-book"></i></a>
+      | <a href="https://github.com/jokob-sk/NetAlertX/issues" class="pointer" target="_blank"><i class="fa fa-bug" title="Report a bug"></i></a>
+      | <a href="https://discord.com/invite/NczTUTWyRr" class="pointer" target="_blank"><i class="fa-brands fa-discord" title="Join Discord"></i></a>
+      | <?= lang('Maintenance_built_on');?>:  <?php include 'php/templates/build.php'; ?>
+      |  Version:  <?php include 'php/templates/version.php'; ?>
+      |
    </div>
  </footer>

--- a/front/php/templates/language/ca_ca.json
+++ b/front/php/templates/language/ca_ca.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Estàs segur que vols reiniciar el servidor backend? Això pot causar incongruència a l'aplicació. Abans fes còpia de seguretat de la vostra configuració. <br/> <br/> Nota: Això pot durar uns quants minuts.",
    "Maintenance_InitCheck": "Init Check",
    "Maintenance_InitCheck_Checking": "Comprovant…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Assegureu-vos de seguir la guia <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\"> de configuració ràpida</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Assegureu-vos de seguir la guia <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\"> de configuració ràpida</a>.",
    "Maintenance_InitCheck_Success": "Aplicació inicialitzada amb èxit!",
    "Maintenance_ReCheck": "Tornar a comprovar",
    "Maintenance_Running_Version": "Versió instal·lada",
--- a/front/php/templates/language/en_us.json
+++ b/front/php/templates/language/en_us.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Are you sure you want to restart the backend server? This may casue app inconsistency. Backup your setup first. <br/> <br/> Note: This may take a few minutes.",
    "Maintenance_InitCheck": "Init check",
    "Maintenance_InitCheck_Checking": "Checking…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Make sure you followed the <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">quick setup guide</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Make sure you followed the <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">quick setup guide</a>.",
    "Maintenance_InitCheck_Success": "Application initialized succesfully!",
    "Maintenance_ReCheck": "Retry check",
    "Maintenance_Running_Version": "Installed version",
--- a/front/php/templates/language/es_es.json
+++ b/front/php/templates/language/es_es.json
@@ -391,7 +391,7 @@
    "Maint_Restart_Server_noti_text": "¿Estás seguro de que desea reiniciar el servidor backend? Esto puede causar inconsistencia en la aplicación. Primero haga una copia de seguridad de su configuración.<br/> <br/> Nota: Esto puede tardar unos minutos.",
    "Maintenance_InitCheck": "Validación inicial",
    "Maintenance_InitCheck_Checking": "Validando . . .",
-    "Maintenance_InitCheck_QuickSetupGuide": "Asegúrece de seguir la <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">guía de configuración rápida</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Asegúrece de seguir la <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">guía de configuración rápida</a>.",
    "Maintenance_InitCheck_Success": "¡Aplicación inicializada con éxito!",
    "Maintenance_ReCheck": "Reintentar validación",
    "Maintenance_Running_Version": "Versión instalada",
--- a/front/php/templates/language/fr_fr.json
+++ b/front/php/templates/language/fr_fr.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Êtes-vous sûr de vouloir relancer le serveur back-end ? Cela peut causer des incohérences avec l'application. Sauvegarder vos paramètres en premier lieu. <br/> <br/> Remarque : cela peut prendre quelques minutes.",
    "Maintenance_InitCheck": "Vérification initiale",
    "Maintenance_InitCheck_Checking": "Vérification…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Assurez-vous de suivre le <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">guide de démarrage rapide</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Assurez-vous de suivre le <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">guide de démarrage rapide</a>.",
    "Maintenance_InitCheck_Success": "Application initialisée avec succès !",
    "Maintenance_ReCheck": "Relancer la vérification",
    "Maintenance_Running_Version": "Version installée",
--- a/front/php/templates/language/it_it.json
+++ b/front/php/templates/language/it_it.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Sei sicuro di voler riavviare il server backend? Questo potrebbe causare incoerenze dell'app. Prima esegui il backup della tua configurazione. <br/> <br/> Nota: l'operazione potrebbe richiedere alcuni minuti.",
    "Maintenance_InitCheck": "Controllo iniziale",
    "Maintenance_InitCheck_Checking": "Controllo in corso…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Assicurati di aver seguito la <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">guida di configurazione rapida</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Assicurati di aver seguito la <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">guida di configurazione rapida</a>.",
    "Maintenance_InitCheck_Success": "Applicazione inizializzata con successo!",
    "Maintenance_ReCheck": "Riprova controllo",
    "Maintenance_Running_Version": "Versione installata",
--- a/front/php/templates/language/ja_jp.json
+++ b/front/php/templates/language/ja_jp.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "バックエンドサーバーを再起動してもよろしいですか？アプリの不整合が発生する可能性があります。まず設定のバックアップを行ってください。<br/> <br/> 注：この操作には数分かかる場合があります。",
    "Maintenance_InitCheck": "初期化チェック",
    "Maintenance_InitCheck_Checking": "確認中…",
-    "Maintenance_InitCheck_QuickSetupGuide": "<a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">クイックセットアップガイド</a>に従ったことを確認してください。",
+    "Maintenance_InitCheck_QuickSetupGuide": "<a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">クイックセットアップガイド</a>に従ったことを確認してください。",
    "Maintenance_InitCheck_Success": "アプリケーションの初期化に成功！",
    "Maintenance_ReCheck": "再試行チェック",
    "Maintenance_Running_Version": "インストールバージョン",
--- a/front/php/templates/language/pl_pl.json
+++ b/front/php/templates/language/pl_pl.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Czy na pewno chcesz zrestartować serwer zaplecza (backend)? Może to spowodować niespójność działania aplikacji. Najpierw wykonaj kopię zapasową swojej konfiguracji. <br/><br/> Uwaga: To może potrwać kilka minut.",
    "Maintenance_InitCheck": "Wstępna kontrola",
    "Maintenance_InitCheck_Checking": "Sprawdzanie…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Upewnij się, że postępowałeś zgodnie z <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">krótką instrukcją konfiguracji</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Upewnij się, że postępowałeś zgodnie z <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">krótką instrukcją konfiguracji</a>.",
    "Maintenance_InitCheck_Success": "Aplikacja została pomyślnie zainicjowana!",
    "Maintenance_ReCheck": "Ponów sprawdzenie",
    "Maintenance_Running_Version": "Zainstalowana wersja",
--- a/front/php/templates/language/pt_pt.json
+++ b/front/php/templates/language/pt_pt.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Tem certeza de que deseja reiniciar o servidor backend? Isto pode causar inconsistência na app. Faça primeiro um backup da sua configuração. <br/> <br/> Nota: Isto pode levar alguns minutos.",
    "Maintenance_InitCheck": "Verificação inicial",
    "Maintenance_InitCheck_Checking": "A verificar…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Certifique-se de que seguiu o <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">guia de configuração rápida</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Certifique-se de que seguiu o <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">guia de configuração rápida</a>.",
    "Maintenance_InitCheck_Success": "Aplicação inicializada com sucesso!",
    "Maintenance_ReCheck": "Verificar novamente",
    "Maintenance_Running_Version": "Versão instalada",
--- a/front/php/templates/language/ru_ru.json
+++ b/front/php/templates/language/ru_ru.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Вы уверены, что хотите перезапустить внутренний сервер? Это может привести к несогласованности работы приложения. Сначала создайте резервную копию настроек. <br/> <br/> Примечание: Это может занять несколько минут.",
    "Maintenance_InitCheck": "Инициализация проверки",
    "Maintenance_InitCheck_Checking": "Проверяется…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Убедитесь, что вы следовали быстрому руководству по настройке <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\"></a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Убедитесь, что вы следовали быстрому руководству по настройке <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\"></a>.",
    "Maintenance_InitCheck_Success": "Приложение инициализировано успешно!",
    "Maintenance_ReCheck": "Повторить проверку",
    "Maintenance_Running_Version": "Установленная версия",
--- a/front/php/templates/language/uk_ua.json
+++ b/front/php/templates/language/uk_ua.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "Ви впевнені, що бажаєте перезапустити внутрішній сервер? Це може спричинити неузгодженість програми. Спершу створіть резервну копію налаштувань. <br/> <br/> Примітка. Це може зайняти кілька хвилин.",
    "Maintenance_InitCheck": "Перевірка ініціалізації",
    "Maintenance_InitCheck_Checking": "Перевірка…",
-    "Maintenance_InitCheck_QuickSetupGuide": "Переконайтеся, що ви дотримувалися інструкцій у <a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">короткому посібнику з налаштування</a>.",
+    "Maintenance_InitCheck_QuickSetupGuide": "Переконайтеся, що ви дотримувалися інструкцій у <a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">короткому посібнику з налаштування</a>.",
    "Maintenance_InitCheck_Success": "Застосунок успішно ініціалізовано!",
    "Maintenance_ReCheck": "Повторна спроба перевірки",
    "Maintenance_Running_Version": "Встановлена версія",
--- a/front/php/templates/language/zh_cn.json
+++ b/front/php/templates/language/zh_cn.json
@@ -375,7 +375,7 @@
    "Maint_Restart_Server_noti_text": "您确定要重新启动后端服务器吗？这可能会导致应用程序不一致。请先备份您的设置。<br/> <br/> 注意：这可能需要几分钟。",
    "Maintenance_InitCheck": "初步检查",
    "Maintenance_InitCheck_Checking": "查看中…",
-    "Maintenance_InitCheck_QuickSetupGuide": "确保您遵循<a href=\"https://jokob-sk.github.io/NetAlertX/INITIAL_SETUP/\" target=\"_blank\">快速设置指南</a>。",
+    "Maintenance_InitCheck_QuickSetupGuide": "确保您遵循<a href=\"https://docs.netalertx.com/INITIAL_SETUP/\" target=\"_blank\">快速设置指南</a>。",
    "Maintenance_InitCheck_Success": "应用程序启动成功！",
    "Maintenance_ReCheck": "重试检查",
    "Maintenance_Running_Version": "安装版本",
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,8 +1,9 @@
 site_name: NetAlertX Docs
-site_url: https://jokob-sk.github.io/NetAlertX/
+site_url: https://docs.netalertx.com/
 repo_url: https://github.com/jokob-sk/NetAlertX/
 edit_uri: blob/main/docs/
 docs_dir: docs
+use_directory_urls: true
 site_description: >-
  The main documentation resource for NetAlertX - a network scanner and presence detector
 # static_dir: docs/img