Watchdog Installer

An interactive installer for the Watchdog Monitoring System. This tool handles the entire setup process, from checking system dependencies to generating final configuration files and downloading the application code.

Features

• Interactive and user-friendly command-line interface.
• Automatically checks for system dependencies (git, python3) and offers to install them.
• Dynamically discovers and compiles translations for a multilingual experience.
• Guides the user through the entire setup of watchdog-core and its modules.
• Generates all necessary configuration files (.env, .json) based on user input.
• Creates a Python virtual environment (.venv) to isolate application dependencies.
• Creates convenient launcher scripts (start.sh, start.bat) for the final application.

How to Use

You can run the installer using one of the following methods.

Method 1: Quick Install (curl)

This method downloads and executes the bootstrap script in a single command. Use this only if you trust the source of the script.

curl -sSL https://git.pandafun.cz/pandafun/watchdog-installer/raw/branch/main/install.sh | bash

Method 2: Manual Download (Recommended & Safer)

This method allows you to inspect the installer's code before running it.

1. Clone the installer repository:

   git clone https://git.pandafun.cz/pandafun/watchdog-installer.git
   

2. Navigate into the directory:

   cd watchdog-installer
   

3. Run the Python installer:

   python3 installer.py
   

The Installation Process

The installer is fully interactive and will guide you through the following steps:

1. Language Selection: You will be asked to choose your preferred language for the installation process.
2. Prerequisite Check: The script will verify that all necessary system tools are available.
3. Configuration: You will be prompted for key configuration details, such as:
   • The desired installation path for the Watchdog application.
   • Which modules (e.g., Telegram Notifier) you want to enable.
   • Sensitive information (like API tokens), which will be securely stored in the .env file.
   • An initial list of targets to monitor.
4. Execution: The installer will then perform all necessary actions: create directories, clone the watchdog-core repository, create a virtual environment, generate config files, and run the initial module synchronization.
5. Completion: Once finished, the installer will provide instructions on how to start the Watchdog application using the newly created launcher scripts. The installer directory can then be safely removed.

Prerequisites

• A Debian-based (e.g., Ubuntu) or Red Hat-based (e.g., Fedora, CentOS) Linux system.
• sudo privileges are required if the bootstrap script needs to install missing system dependencies.

License

This project is licensed under the MIT License.

---

Watchdog Installer (Česká verze)

Interaktivní instalátor pro Watchdog Monitoring System. Tento nástroj provede uživatele celým procesem nastavení, od kontroly systémových závislostí až po generování finálních konfiguračních souborů a stažení kódu aplikace.

Klíčové Vlastnosti

• Interaktivní a uživatelsky přívětivé rozhraní v příkazové řádce.
• Automaticky kontroluje systémové závislosti (git, python3) a nabízí jejich instalaci.
• Dynamicky detekuje a kompiluje překlady pro vícejazyčný zážitek.
• Provede uživatele kompletním nastavením watchdog-core a jeho modulů.
• Generuje všechny potřebné konfigurační soubory (.env, .json) na základě vstupu od uživatele.
• Vytváří virtuální prostředí Pythonu (.venv) pro izolaci závislostí aplikace.
• Vytváří pohodlné spouštěcí skripty (start.sh, start.bat) pro finální aplikaci.

Jak Použít

Instalátor můžete spustit jednou z následujících metod.

Metoda 1: Rychlá Instalace (curl)

Tato metoda stáhne a spustí spouštěcí skript v jediném příkazu. Používejte ji pouze v případě, že důvěřujete zdroji skriptu.

curl -sSL https://git.pandafun.cz/pandafun/watchdog-installer/raw/branch/main/install.sh | bash

Metoda 2: Manuální Stažení (Doporučeno a Bezpečnější)

Tato metoda vám umožní prohlédnout si kód instalátoru před jeho spuštěním.

1. Naklonujte repozitář instalátoru:

   git clone https://git.pandafun.cz/pandafun/watchdog-installer/raw/branch/main/install.sh
   

2. Přejděte do adresáře:

   cd watchdog-installer
   

3. Spusťte Python instalátor:

   python3 installer.py
   

Proces Instalace

Instalátor je plně interaktivní a provede vás následujícími kroky:

1. Výběr Jazyka: Budete požádáni o výběr preferovaného jazyka pro proces instalace.
2. Kontrola Předpokladů: Skript ověří, že jsou dostupné všechny potřebné systémové nástroje.
3. Konfigurace: Budete dotázáni na klíčové konfigurační detaily, jako jsou:
   • Cílová cesta pro instalaci aplikace Watchdog.
   • Které moduly (např. Telegram Notifier) si přejete aktivovat.
   • Citlivé údaje (jako API tokeny), které budou bezpečně uloženy do souboru .env.
   • Počáteční seznam cílů k monitorování.
4. Provedení: Instalátor následně provede všechny potřebné akce: vytvoří adresáře, naklonuje repozitář watchdog-core, vytvoří virtuální prostředí, vygeneruje konfigurační soubory a spustí úvodní synchronizaci modulů.
5. Dokončení: Po skončení instalátor poskytne instrukce, jak spustit aplikaci Watchdog pomocí nově vytvořených spouštěcích skriptů. Adresář s instalátorem pak může být bezpečně smazán.

Předpoklady

• Linuxový systém založený na Debianu (např. Ubuntu) nebo Red Hatu (např. Fedora, CentOS).
• Jsou vyžadována sudo oprávnění v případě, že spouštěcí skript potřebuje doinstalovat chybějící systémové závislosti.

Licence

Tento projekt je licencován pod licencí MIT.