IDQ Monitor User - Guida completa

Come funziona, come si prova e come avere il tuo server, passo passo.

1. Cos'è IDQ Monitor User

IDQ Monitor User mostra in tempo reale lo stato dei tuoi computer: processore (con ogni core), carico, memoria, swap, dischi e partizioni, rete, temperature, servizi attivi, aggiornamenti e manutenzione. Se qualcosa non va, ti avvisa sul telefono.

Funziona con tre pezzi:

L'app (Android, Windows, Linux e pagina web) che mostra i dati.
Un server: un computer sempre acceso che raccoglie i dati e li rende disponibili all'app, anche fuori casa.
Un agente su ogni computer da controllare: un piccolo programma che manda i dati al server.

  Tuoi computer ──(agente)──►  IL TUO SERVER  ◄──  App (telefono, tablet, PC, web)

2. La prova gratuita di 24 ore

Alla prima apertura l'app ti propone una prova gratuita di 24 ore sul server IDQ, senza registrazione:

vedi subito un PC dimostrativo con dati di esempio;
se vuoi, puoi collegare anche i tuoi PC (menu → Aggiungi dispositivo) e vederli per tutta la prova;
la prova dura 24 ore dal primo avvio e si può fare una sola volta per dispositivo (reinstallare l'app non la fa ripartire);
passate le 24 ore l'app si ferma e chiede il tuo server: qui sotto trovi come averlo. Lo spazio di prova viene poi cancellato.

Durante la prova il riavvio da remoto dei PC non è disponibile. Il PC dimostrativo non è un computer vero: serve solo a vedere come funziona l'app.

3. Come avere il tuo server (passo passo)

Dopo la prova, o se preferisci non usare il server IDQ, ti serve un tuo server. È gratuito e semplice: bastano un computer sempre acceso e circa 20 minuti.

Passo 1 - Cosa serve

Un computer sempre acceso con Linux (Ubuntu, Debian, Raspberry Pi OS…): per esempio un Raspberry Pi 4, un mini PC o un vecchio portatile. Consuma pochissimo.
Una connessione a internet. Non serve aprire porte sul router.
Python 3 (già presente nella maggior parte dei Linux) oppure Docker.

Il server legge il computer su cui gira (processore, memoria, dischi…). Windows può essere controllato con l'agente, ma il server va su Linux.

Raspberry Pi. Come server consigliamo Pi 4 o Pi 5 (almeno 2 GB di memoria; un Pi 3 basta per pochi computer). Come computer da controllare, l'agente funziona su tutti i modelli con Raspberry Pi OS. L'installer .deb e l'app con finestra richiedono un sistema a 64 bit (Pi 5, 4, 400, 3, 3+, Zero 2 W): verifica con uname -m (deve rispondere aarch64); su Pi Zero, Pi 1 e Pi 2 con sistema a 32 bit usa il comando di Aggiungi dispositivo. L'app con finestra serve il desktop grafico (non la versione Lite).

Passo 2 - Scarica il pacchetto del server

Dal sito di IDQ Monitor User scarica idq-monitor-server.zip (sezione Download → Server). Sul computer del server:

unzip idq-monitor-server.zip
cd idq-monitor-server

Passo 3 - Avvia il server

Metodo A - senza Docker (il più semplice):

python3 idq_monitor_server.py

Per farlo partire da solo a ogni accensione, crea un servizio:

sudo tee /etc/systemd/system/idq-monitor-server.service <<EOF
[Unit]
Description=IDQ Monitor server
After=network-online.target

[Service]
WorkingDirectory=$PWD
ExecStart=/usr/bin/python3 $PWD/idq_monitor_server.py
User=$USER
Restart=always

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now idq-monitor-server

Metodo B - con Docker:

docker compose up -d

Alla prima accensione il server crea la chiave di accesso (il token) nella cartella dati. Per leggerla:

cat dati/monitor.token

Passo 4 - Raggiungi il server da internet (gratis)

Le app usano un indirizzo sicuro (https://…). Scegli una di queste strade gratuite:

Tailscale Funnel (la più semplice, nessun dominio necessario): crea un account gratuito su tailscale.com, installa Tailscale sul server, attiva Funnel nelle impostazioni del tuo account e lancia:
```
sudo tailscale funnel --bg 8002
```
Ottieni un indirizzo stabile del tipo https://nome-pc.tuarete.ts.net.
Cloudflare Tunnel (se hai un tuo dominio su Cloudflare): nel pannello Zero Trust → Networks → Tunnels crea un tunnel, installa il connettore sul server con il comando che ti mostra, poi aggiungi un Public hostname (per esempio monitor.tuodominio.it) che punta a http://localhost:8002.

Passo 5 - Il tuo link

Il link da usare nelle app è l'indirizzo del passo 4 seguito da /monitor?k= e dal token:

https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN

Il link contiene la chiave di accesso: non condividerlo. Chi lo ha può vedere i tuoi dati.

Passo 6 - Collega l'app

Nell'app apri il menu (tre trattini) → Cambia link e incolla il link. Se l'app è nella schermata di prova terminata, scegli Ho già il mio server.

Passo 7 - Aggiungi i tuoi computer

Nell'app: menu → Aggiungi dispositivo…, scrivi un nome e copia il comando. Sul computer da controllare incollalo:

Linux, Raspberry: nel Terminale (comando curl … | bash).
Windows: in PowerShell (comando irm … | iex).

Permessi di amministratore: l'installazione li chiede al momento (su Windows compare la finestra di conferma; su Linux e Raspberry viene chiesta la password di sudo). Servono per il riavvio da remoto e per leggere i consumi: viene creata solo una regola limitata, e se rifiuti il monitor funziona lo stesso.

Dopo pochi secondi il computer compare in alto nell'app. Il comando installa l'agente e lo fa partire a ogni accensione. In alternativa usa gli installer del sito (Windows, Ubuntu, Raspberry).

Passo 8 - Personalizza

Dal menu scegli quali sezioni vedere, quali servizi controllare e quali allarmi ricevere (con le soglie). Facoltativo: attiva il riavvio da remoto con un PIN.

4. Come si usa

Schede in alto: una per ogni computer. Il nome è verde se è acceso e rosso se è spento o non raggiungibile; sotto compare "attivo" o "spento".
Una sola pagina: attività, processore con ogni core, memoria, dischi, rete, temperature, servizi. Le voci si adattano allo schermo o alla finestra.
Menu: sezioni da visualizzare, allarmi e avvisi, servizi da visualizzare, aggiungi dispositivo, PIN del riavvio, guida, informazioni, cambia link.
Widget (Android): tieni premuto sulla schermata Home e scegli IDQ Monitor.

Avvisi

Sull'app Android il controllo in background (circa ogni 30 secondi) ti manda una notifica quando c'è un allarme: processore, carico, memoria, swap, disco o temperatura oltre la soglia che hai scelto, servizio arrestato in modo anomalo, computer spento all'improvviso o server non raggiungibile. Uno spegnimento normale di un computer non genera avvisi. Su Android, nel menu, consenti senza limiti di batteria per non far fermare il controllo.

Sulle app per computer gli allarmi si vedono solo dentro l'app, senza popup.

Servizi: attivo, fermo, arrestato

L'agente distingue un servizio fermo (spento in modo normale: nessun avviso) da uno arrestato in modo anomalo (errore, crash, memoria esaurita: avviso).

Aggiornamenti e riavvii

Se ci sono aggiornamenti che richiedono un riavvio, l'app te lo segnala e, se hai attivato il riavvio da remoto, compare Riavvia ora… (serve il PIN). Gli aggiornamenti automatici dei computer Linux possono essere programmati di notte (02:00-02:45) con riavvio alle 02:30.

Il PIN del riavvio

Al primo avvio l'app chiede se vuoi poter riavviare i computer dall'app. Se accetti scegli un PIN di 4-8 cifre; dal menu puoi modificarlo, ripristinarlo o disattivarlo (a tuo rischio e pericolo: senza PIN nessuno può riavviare i computer da remoto). Dopo 5 PIN sbagliati c'è un blocco di 5 minuti. Il PIN lo controlla il tuo server: non è nell'app.

Manutenzione dichiarata

Per avvisare l'app che stai facendo dei lavori su un computer Linux, scrivi una frase nel file ~/.config/idq-monitor-manutenzione: comparirà nella scheda Attività. Cancella il file a fine lavori.

GPU e consumi in watt

La scheda GPU compare solo se il computer ha una scheda video dedicata (non quella integrata nel processore): mostra utilizzo, memoria video, temperatura e watt (NVIDIA con nvidia-smi; AMD su Linux).

La sezione Consumo (watt) mostra i watt totali e, separati, quelli di processore e GPU. Senza altro, il totale è una stima (processore + GPU). Il processore si legge dal contatore di energia del sistema (su Linux serve il permesso di amministratore dato in installazione).

Per il consumo reale dell'intero PC collega il computer a una presa intelligente Shelly (Gen1 o Gen2) e aggiungi nel file ~/.config/idq-monitor-agente.json (su Windows: %APPDATA%\idq-monitor-agente.json):

"presa": { "tipo": "shelly", "ip": "192.168.1.50", "canale": 0 }

Poi riavvia l'agente. Da quel momento il totale è quello misurato dalla presa.

Se il computer è un server professionale (con controller IPMI/BMC e ipmitool), un portatile o ha sensori di potenza nella scheda madre, l'agente li usa in automatico per il totale reale, senza presa. Altrimenti mostra solo ciò che il computer sa misurare.

5. Gli agenti nel dettaglio

Il file di configurazione dell'agente è ~/.config/idq-monitor-agente.json (Windows: %APPDATA%\idq-monitor-agente.json). Puoi indicare i servizi da mostrare per impostazione predefinita:

{
  "link": "https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN",
  "nome": "raspberry",
  "docker_tutti": true,
  "servizi": {
    "Web":    { "porta": 80,   "systemd": "nginx" },
    "Cloud":  { "porta": 8080, "docker": "nextcloud" },
    "Backup": 5000
  }
}

porta: porta locale che deve rispondere; systemd: nome del servizio (Linux); docker: nome del contenitore; docker_tutti: mostra tutti i contenitori.
Un servizio appena avviato ha 5 minuti di tolleranza prima di essere considerato anomalo.

Per togliere un computer: ferma l'agente (Linux: systemctl --user disable --now idq-monitor-agente; Windows: Unregister-ScheduledTask -TaskName IDQMonitorAgente -Confirm:$false).

6. Se qualcosa non funziona

Problema	Cosa fare
L'app dice "Connessione al server…"	Controlla la rete del telefono, che il server sia acceso e che il link sia giusto (menu → Cambia link).
Il computer non compare	Controlla che l'agente sia attivo e rilancia il comando di Aggiungi dispositivo. Su Linux: `journalctl --user -u idq-monitor-agente -n 20`.
Errore 403	Il link o il token non è corretto: copialo di nuovo dal server (`cat dati/monitor.token`).
Le notifiche non arrivano	Su Android consenti le notifiche e l'uso senza limiti di batteria; sui Samsung togli l'app dalle "applicazioni in stop".
PIN dimenticato	Sul server cancella `dati/monitor.pin` e riavvia il server: l'app ti chiederà di sceglierne uno nuovo.
Prova terminata	Segui il passo "Come avere il tuo server" e scegli Ho già il mio server.

7. Privacy e contatti

L'app non ha account, non ha pubblicità e non usa strumenti di analisi. Con il tuo server, i dati dei tuoi computer restano tra i tuoi computer, il tuo server e le tue app. Nella prova di 24 ore i dati vanno sul server IDQ e vengono cancellati alla scadenza. Tutti i dettagli sono nell'informativa sulla privacy.

Sviluppatore: IDQ Developer · info@idq-developer.com

IDQ Monitor User - Complete guide

How it works, how to try it and how to get your own server, step by step.

1. What IDQ Monitor User is

IDQ Monitor User shows the status of your computers in real time: processor (every single core), load, memory, swap, disks and partitions, network, temperatures, running services, updates and maintenance. If something is wrong, it alerts you on your phone.

It works with three parts:

The app (Android, Windows, Linux and a web page) that shows the data.
A server: an always-on computer that collects the data and makes it available to the app, even when you're away from home.
An agent on every computer you want to monitor: a small program that sends the data to the server.

  Your computers ──(agent)──►  YOUR SERVER  ◄──  App (phone, tablet, PC, web)

2. The free 24-hour trial

The first time you open the app it offers a free 24-hour trial on the IDQ server, with no sign-up:

you immediately see a demo PC with sample data;
if you like, you can also connect your own PCs (menu → Add device) and watch them for the whole trial;
the trial lasts 24 hours from the first launch and can be done only once per device (reinstalling the app does not restart it);
after 24 hours the app stops and asks for your own server: below you'll find how to get one. The trial space is then deleted.

During the trial, remote restart of PCs is not available. The demo PC is not a real computer: it only shows how the app works.

3. How to get your own server (step by step)

After the trial, or if you prefer not to use the IDQ server, you need your own server. It's free and simple: all you need is an always-on computer and about 20 minutes.

Step 1 - What you need

An always-on computer running Linux (Ubuntu, Debian, Raspberry Pi OS…): for example a Raspberry Pi 4, a mini PC or an old laptop. It uses very little power.
An internet connection. You don't need to open any router ports.
Python 3 (already present on most Linux systems) or Docker.

The server reads the computer it runs on (processor, memory, disks…). Windows can be monitored with the agent, but the server itself should run on Linux.

Raspberry Pi. As a server we recommend a Pi 4 or Pi 5 (at least 2 GB of memory; a Pi 3 is enough for a few computers). As a computer to monitor, the agent works on all models running Raspberry Pi OS. The .deb installer and the windowed app need a 64-bit system (Pi 5, 4, 400, 3, 3+, Zero 2 W): check with uname -m (it must answer aarch64); on Pi Zero, Pi 1 and Pi 2 with a 32-bit system use the Add device command. The windowed app needs the graphical desktop (not the Lite version).

Step 2 - Download the server package

From the IDQ Monitor User website download idq-monitor-server.zip (section Download → Server). On the server computer:

unzip idq-monitor-server.zip
cd idq-monitor-server

Step 3 - Start the server

Method A - without Docker (the simplest):

python3 idq_monitor_server.py

To make it start by itself at every boot, create a service:

sudo tee /etc/systemd/system/idq-monitor-server.service <<EOF
[Unit]
Description=IDQ Monitor server
After=network-online.target

[Service]
WorkingDirectory=$PWD
ExecStart=/usr/bin/python3 $PWD/idq_monitor_server.py
User=$USER
Restart=always

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now idq-monitor-server

Method B - with Docker:

docker compose up -d

On first start the server creates the access key (the token) in the dati folder. To read it:

cat dati/monitor.token

Step 4 - Reach the server from the internet (free)

The apps use a secure address (https://…). Choose one of these free options:

Tailscale Funnel (the simplest, no domain needed): create a free account at tailscale.com, install Tailscale on the server, enable Funnel in your account settings and run:
```
sudo tailscale funnel --bg 8002
```
You get a stable address like https://pc-name.yournet.ts.net.
Cloudflare Tunnel (if you own a domain on Cloudflare): in Zero Trust → Networks → Tunnels create a tunnel, install the connector on the server with the command shown, then add a Public hostname (for example monitor.yourdomain.com) pointing to http://localhost:8002.

Step 5 - Your link

The link to use in the apps is the address from step 4 followed by /monitor?k= and the token:

https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN

The link contains the access key: don't share it. Anyone who has it can see your data.

Step 6 - Connect the app

In the app open the menu (three lines) → Change link and paste the link. If the app is on the trial-ended screen, choose I already have my server.

Step 7 - Add your computers

In the app: menu → Add device…, type a name and copy the command. On the computer you want to monitor paste it:

Linux, Raspberry: in the Terminal (the curl … | bash command).
Windows: in PowerShell (the irm … | iex command).

Administrator permission: the installation asks for it at that moment (on Windows the confirmation window appears; on Linux and Raspberry the sudo password is requested). It is needed for remote restart and to read power consumption: only a narrow rule is created, and if you refuse the monitor still works.

After a few seconds the computer appears at the top of the app. The command installs the agent and starts it at every boot. Alternatively use the installers on the website (Windows, Ubuntu, Raspberry).

Step 8 - Customise

From the menu choose which sections to see, which services to monitor and which alarms to receive (with thresholds). Optional: turn on remote restart with a PIN.

4. How to use it

Tabs at the top: one per computer. The name is green if it's on and red if it's off or unreachable; below it says "active" or "off".
A single page: activity, processor with every core, memory, disks, network, temperatures, services. Items adapt to the screen or window.
Menu: sections to display, alarms and alerts, services to display, add device, restart PIN, guide, about, change link.
Widget (Android): long-press the home screen and choose IDQ Monitor.

Alerts

On the Android app the background check (about every 30 seconds) sends a notification when there is an alarm: processor, load, memory, swap, disk or temperature above the threshold you chose, a service stopped abnormally, a computer suddenly off, or the server unreachable. A normal shutdown of a computer does not trigger alerts. On Android, in the menu, allow without battery limits so the check is not stopped.

On the computer apps, alarms are shown only inside the app, with no popups.

Services: active, stopped, failed

The agent tells a stopped service (turned off normally: no alert) from one that failed abnormally (error, crash, out of memory: alert).

Updates and restarts

If there are updates that require a restart, the app tells you and, if you turned on remote restart, Restart now… appears (the PIN is required). Automatic updates on Linux computers can be scheduled at night (02:00-02:45) with a restart at 02:30.

The restart PIN

On first launch the app asks whether you want to be able to restart your computers from the app. If you accept, choose a PIN of 4-8 digits; from the menu you can change, reset or turn it off (at your own risk: without a PIN nobody can restart computers remotely). After 5 wrong PINs there is a 5-minute lock. The PIN is checked by your server: it is not in the app.

Declared maintenance

To tell the app you are working on a Linux computer, write a sentence in the file ~/.config/idq-monitor-manutenzione: it will appear in the Activity card. Delete the file when you're done.

GPU and power consumption in watts

The GPU card appears only if the computer has a dedicated graphics card (not the one built into the processor): it shows usage, video memory, temperature and watts (NVIDIA with nvidia-smi; AMD on Linux).

The Power (watts) section shows the total watts and, separately, those of the processor and the GPU. By default the total is an estimate (processor + GPU). The processor is read from the system energy counter (on Linux this needs the administrator permission given at installation).

For the real consumption of the whole PC, plug the computer into a Shelly smart plug (Gen1 or Gen2) and add to the file ~/.config/idq-monitor-agente.json (on Windows: %APPDATA%\idq-monitor-agente.json):

"presa": { "tipo": "shelly", "ip": "192.168.1.50", "canale": 0 }

Then restart the agent. From then on the total is the one measured by the plug.

If the computer is a professional server (with an IPMI/BMC controller and ipmitool), a laptop, or has power sensors on the motherboard, the agent uses them automatically for the real total, no plug needed. Otherwise it shows only what the computer can measure.

5. The agents in detail

The agent's configuration file is ~/.config/idq-monitor-agente.json (Windows: %APPDATA%\idq-monitor-agente.json). You can list the services to show by default:

{
  "link": "https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN",
  "nome": "raspberry",
  "docker_tutti": true,
  "servizi": {
    "Web":    { "porta": 80,   "systemd": "nginx" },
    "Cloud":  { "porta": 8080, "docker": "nextcloud" },
    "Backup": 5000
  }
}

porta: local port that must respond; systemd: service name (Linux); docker: container name; docker_tutti: show all containers.
A service that has just started gets 5 minutes of grace before being considered abnormal.

To remove a computer: stop the agent (Linux: systemctl --user disable --now idq-monitor-agente; Windows: Unregister-ScheduledTask -TaskName IDQMonitorAgente -Confirm:$false).

6. If something doesn't work

Problem	What to do
The app says "Connecting to the server…"	Check the phone's network, that the server is on and that the link is correct (menu → Change link).
The computer doesn't appear	Check that the agent is running and run the Add device command again. On Linux: `journalctl --user -u idq-monitor-agente -n 20`.
Error 403	The link or token is wrong: copy it again from the server (`cat dati/monitor.token`).
Notifications don't arrive	On Android allow notifications and use without battery limits; on Samsung remove the app from "sleeping apps".
Forgotten PIN	On the server delete `dati/monitor.pin` and restart the server: the app will ask you to choose a new one.
Trial ended	Follow the "How to get your own server" steps and choose I already have my server.

7. Privacy and contacts

The app has no accounts, no ads and uses no analytics tools. With your own server, your computers' data stays between your computers, your server and your apps. During the 24-hour trial the data goes to the IDQ server and is deleted at expiry. Full details are in the privacy policy.

Developer: IDQ Developer · info@idq-developer.com

IDQ Monitor User - Guide complet

Comment ça marche, comment l'essayer et comment avoir votre propre serveur, pas à pas.

1. Qu'est-ce qu'IDQ Monitor User

IDQ Monitor User affiche en temps réel l'état de vos ordinateurs : processeur (chaque cœur), charge, mémoire, swap, disques et partitions, réseau, températures, services actifs, mises à jour et maintenance. En cas de problème, il vous alerte sur votre téléphone.

Il repose sur trois éléments :

L'application (Android, Windows, Linux et page web) qui affiche les données.
Un serveur : un ordinateur toujours allumé qui collecte les données et les met à disposition de l'application, même hors de chez vous.
Un agent sur chaque ordinateur à surveiller : un petit programme qui envoie les données au serveur.

  Vos ordinateurs ──(agent)──►  VOTRE SERVEUR  ◄──  Application (téléphone, tablette, PC, web)

2. L'essai gratuit de 24 heures

À la première ouverture, l'application vous propose un essai gratuit de 24 heures sur le serveur IDQ, sans inscription :

vous voyez tout de suite un PC de démonstration avec des données d'exemple ;
si vous le souhaitez, vous pouvez aussi connecter vos propres PC (menu → Ajouter un appareil) et les voir pendant tout l'essai ;
l'essai dure 24 heures à partir du premier lancement et ne peut se faire qu'une seule fois par appareil (réinstaller l'application ne le relance pas) ;
passé ce délai, l'application s'arrête et demande votre serveur : vous trouverez ci-dessous comment l'avoir. L'espace d'essai est ensuite supprimé.

Pendant l'essai, le redémarrage à distance des PC n'est pas disponible. Le PC de démonstration n'est pas un vrai ordinateur : il sert seulement à voir comment fonctionne l'application.

3. Comment avoir votre propre serveur (pas à pas)

Après l'essai, ou si vous préférez ne pas utiliser le serveur IDQ, il vous faut votre propre serveur. C'est gratuit et simple : il suffit d'un ordinateur toujours allumé et d'environ 20 minutes.

Étape 1 - Ce qu'il faut

Un ordinateur toujours allumé sous Linux (Ubuntu, Debian, Raspberry Pi OS…) : par exemple un Raspberry Pi 4, un mini PC ou un vieil ordinateur portable. Il consomme très peu.
Une connexion internet. Inutile d'ouvrir des ports sur la box.
Python 3 (déjà présent sur la plupart des Linux) ou Docker.

Le serveur lit l'ordinateur sur lequel il tourne (processeur, mémoire, disques…). Windows peut être surveillé avec l'agent, mais le serveur doit tourner sous Linux.

Raspberry Pi. Comme serveur, nous recommandons un Pi 4 ou Pi 5 (au moins 2 Go de mémoire ; un Pi 3 suffit pour quelques ordinateurs). Comme ordinateur à surveiller, l'agent fonctionne sur tous les modèles avec Raspberry Pi OS. L'installateur .deb et l'application à fenêtre nécessitent un système 64 bits (Pi 5, 4, 400, 3, 3+, Zero 2 W) : vérifiez avec uname -m (il doit répondre aarch64) ; sur Pi Zero, Pi 1 et Pi 2 avec un système 32 bits, utilisez la commande Ajouter un appareil. L'application à fenêtre nécessite le bureau graphique (pas la version Lite).

Étape 2 - Télécharger le paquet du serveur

Sur le site d'IDQ Monitor User, téléchargez idq-monitor-server.zip (section Téléchargements → Serveur). Sur l'ordinateur du serveur :

unzip idq-monitor-server.zip
cd idq-monitor-server

Étape 3 - Démarrer le serveur

Méthode A - sans Docker (la plus simple) :

python3 idq_monitor_server.py

Pour qu'il démarre tout seul à chaque allumage, créez un service :

sudo tee /etc/systemd/system/idq-monitor-server.service <<EOF
[Unit]
Description=IDQ Monitor server
After=network-online.target

[Service]
WorkingDirectory=$PWD
ExecStart=/usr/bin/python3 $PWD/idq_monitor_server.py
User=$USER
Restart=always

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now idq-monitor-server

Méthode B - avec Docker :

docker compose up -d

Au premier démarrage, le serveur crée la clé d'accès (le jeton) dans le dossier dati. Pour la lire :

cat dati/monitor.token

Étape 4 - Joindre le serveur depuis internet (gratuit)

Les applications utilisent une adresse sécurisée (https://…). Choisissez une de ces solutions gratuites :

Tailscale Funnel (la plus simple, sans nom de domaine) : créez un compte gratuit sur tailscale.com, installez Tailscale sur le serveur, activez Funnel dans les paramètres de votre compte et lancez :
```
sudo tailscale funnel --bg 8002
```
Vous obtenez une adresse stable du type https://nom-pc.votrereseau.ts.net.
Cloudflare Tunnel (si vous avez un domaine chez Cloudflare) : dans Zero Trust → Networks → Tunnels, créez un tunnel, installez le connecteur sur le serveur avec la commande indiquée, puis ajoutez un Public hostname (par exemple monitor.votredomaine.fr) qui pointe vers http://localhost:8002.

Étape 5 - Votre lien

Le lien à utiliser dans les applications est l'adresse de l'étape 4 suivie de /monitor?k= et du jeton :

https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN

Le lien contient la clé d'accès : ne le partagez pas. Quiconque l'a peut voir vos données.

Étape 6 - Connecter l'application

Dans l'application, ouvrez le menu (trois traits) → Changer le lien et collez le lien. Si l'application affiche l'écran « essai terminé », choisissez J'ai déjà mon serveur.

Étape 7 - Ajouter vos ordinateurs

Dans l'application : menu → Ajouter un appareil…, saisissez un nom et copiez la commande. Sur l'ordinateur à surveiller, collez-la :

Linux, Raspberry : dans le Terminal (commande curl … | bash).
Windows : dans PowerShell (commande irm … | iex).

Droits d'administrateur : l'installation les demande à ce moment-là (sous Windows, la fenêtre de confirmation s'affiche ; sous Linux et Raspberry, le mot de passe sudo est demandé). Ils servent au redémarrage à distance et à la lecture de la consommation : seule une règle limitée est créée, et si vous refusez, le moniteur fonctionne quand même.

Après quelques secondes, l'ordinateur apparaît en haut de l'application. La commande installe l'agent et le lance à chaque démarrage. Vous pouvez aussi utiliser les installateurs du site (Windows, Ubuntu, Raspberry).

Étape 8 - Personnaliser

Dans le menu, choisissez les sections à voir, les services à surveiller et les alarmes à recevoir (avec les seuils). Facultatif : activez le redémarrage à distance avec un code PIN.

4. Comment l'utiliser

Onglets en haut : un par ordinateur. Le nom est vert s'il est allumé et rouge s'il est éteint ou injoignable ; en dessous s'affiche « actif » ou « éteint ».
Une seule page : activité, processeur avec chaque cœur, mémoire, disques, réseau, températures, services. Les éléments s'adaptent à l'écran ou à la fenêtre.
Menu : sections à afficher, alarmes et alertes, services à afficher, ajouter un appareil, code PIN du redémarrage, guide, à propos, changer le lien.
Widget (Android) : appui long sur l'écran d'accueil, puis IDQ Monitor.

Alertes

Sur l'application Android, la surveillance en arrière-plan (environ toutes les 30 secondes) envoie une notification en cas d'alarme : processeur, charge, mémoire, swap, disque ou température au-dessus du seuil choisi, service arrêté de façon anormale, ordinateur éteint brutalement ou serveur injoignable. Un arrêt normal d'un ordinateur ne génère pas d'alerte. Sur Android, dans le menu, autorisez sans limites de batterie pour que la surveillance ne soit pas arrêtée.

Sur les applications pour ordinateur, les alarmes ne s'affichent que dans l'application, sans fenêtre contextuelle.

Services : actif, arrêté, en échec

L'agent distingue un service arrêté (éteint normalement : pas d'alerte) d'un service en échec de façon anormale (erreur, plantage, mémoire épuisée : alerte).

Mises à jour et redémarrages

S'il y a des mises à jour nécessitant un redémarrage, l'application vous le signale et, si vous avez activé le redémarrage à distance, Redémarrer maintenant… apparaît (le code PIN est demandé). Les mises à jour automatiques des ordinateurs Linux peuvent être programmées la nuit (02h00-02h45) avec redémarrage à 02h30.

Le code PIN du redémarrage

Au premier lancement, l'application demande si vous voulez pouvoir redémarrer vos ordinateurs depuis l'application. Si vous acceptez, choisissez un code PIN de 4 à 8 chiffres ; depuis le menu, vous pouvez le modifier, le réinitialiser ou le désactiver (à vos risques et périls : sans PIN, personne ne peut redémarrer les ordinateurs à distance). Après 5 codes PIN erronés, un blocage de 5 minutes s'applique. Le code PIN est vérifié par votre serveur : il n'est pas dans l'application.

Maintenance déclarée

Pour signaler à l'application que vous travaillez sur un ordinateur Linux, écrivez une phrase dans le fichier ~/.config/idq-monitor-manutenzione : elle apparaîtra dans la fiche Activité. Supprimez le fichier à la fin des travaux.

GPU et consommation en watts

La carte GPU n'apparaît que si l'ordinateur possède une carte graphique dédiée (pas celle intégrée au processeur) : elle affiche l'utilisation, la mémoire vidéo, la température et les watts (NVIDIA avec nvidia-smi ; AMD sous Linux).

La section Consommation (watts) affiche les watts totaux et, séparément, ceux du processeur et du GPU. Par défaut, le total est une estimation (processeur + GPU). Le processeur est lu depuis le compteur d'énergie du système (sous Linux, cela demande le droit d'administrateur accordé à l'installation).

Pour la consommation réelle du PC entier, branchez l'ordinateur sur une prise connectée Shelly (Gen1 ou Gen2) et ajoutez dans le fichier ~/.config/idq-monitor-agente.json (sous Windows : %APPDATA%\idq-monitor-agente.json) :

"presa": { "tipo": "shelly", "ip": "192.168.1.50", "canale": 0 }

Puis redémarrez l'agent. Dès lors, le total est celui mesuré par la prise.

Si l'ordinateur est un serveur professionnel (avec contrôleur IPMI/BMC et ipmitool), un portable, ou possède des capteurs de puissance sur la carte mère, l'agent les utilise automatiquement pour le total réel, sans prise. Sinon il n'affiche que ce que l'ordinateur sait mesurer.

5. Les agents en détail

Le fichier de configuration de l'agent est ~/.config/idq-monitor-agente.json (Windows : %APPDATA%\idq-monitor-agente.json). Vous pouvez indiquer les services à afficher par défaut :

{
  "link": "https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN",
  "nome": "raspberry",
  "docker_tutti": true,
  "servizi": {
    "Web":    { "porta": 80,   "systemd": "nginx" },
    "Cloud":  { "porta": 8080, "docker": "nextcloud" },
    "Backup": 5000
  }
}

porta : port local qui doit répondre ; systemd : nom du service (Linux) ; docker : nom du conteneur ; docker_tutti : afficher tous les conteneurs.
Un service qui vient de démarrer bénéficie de 5 minutes de tolérance avant d'être considéré comme anormal.

Pour retirer un ordinateur : arrêtez l'agent (Linux : systemctl --user disable --now idq-monitor-agente ; Windows : Unregister-ScheduledTask -TaskName IDQMonitorAgente -Confirm:$false).

6. Si quelque chose ne fonctionne pas

Problème	Que faire
L'application affiche « Connexion au serveur… »	Vérifiez le réseau du téléphone, que le serveur est allumé et que le lien est correct (menu → Changer le lien).
L'ordinateur n'apparaît pas	Vérifiez que l'agent est actif et relancez la commande Ajouter un appareil. Sous Linux : `journalctl --user -u idq-monitor-agente -n 20`.
Erreur 403	Le lien ou le jeton est incorrect : copiez-le de nouveau depuis le serveur (`cat dati/monitor.token`).
Les notifications n'arrivent pas	Sur Android, autorisez les notifications et l'usage sans limites de batterie ; sur Samsung, retirez l'application des « applications en veille ».
Code PIN oublié	Sur le serveur, supprimez `dati/monitor.pin` et redémarrez le serveur : l'application vous demandera d'en choisir un nouveau.
Essai terminé	Suivez les étapes « Comment avoir votre propre serveur » et choisissez J'ai déjà mon serveur.

7. Confidentialité et contacts

L'application n'a ni compte, ni publicité et n'utilise aucun outil d'analyse. Avec votre propre serveur, les données de vos ordinateurs restent entre vos ordinateurs, votre serveur et vos applications. Pendant l'essai de 24 heures, les données vont sur le serveur IDQ et sont supprimées à l'expiration. Tous les détails figurent dans la politique de confidentialité.

Développeur : IDQ Developer · info@idq-developer.com

IDQ Monitor User - Komplette Anleitung

So funktioniert es, wie du es testest und wie du deinen eigenen Server bekommst – Schritt für Schritt.

1. Was IDQ Monitor User ist

IDQ Monitor User zeigt dir in Echtzeit den Zustand deiner Computer: Prozessor (jeder einzelne Kern), Last, Arbeitsspeicher, Swap, Datenträger und Partitionen, Netzwerk, Temperaturen, laufende Dienste, Updates und Wartung. Wenn etwas nicht stimmt, warnt es dich auf dem Handy.

Es besteht aus drei Teilen:

Die App (Android, Windows, Linux und eine Webseite), die die Daten anzeigt.
Ein Server: ein ständig laufender Computer, der die Daten sammelt und der App zur Verfügung stellt – auch unterwegs.
Ein Agent auf jedem zu überwachenden Computer: ein kleines Programm, das die Daten an den Server sendet.

  Deine Computer ──(Agent)──►  DEIN SERVER  ◄──  App (Handy, Tablet, PC, Web)

2. Der kostenlose 24-Stunden-Test

Beim ersten Öffnen bietet dir die App einen kostenlosen 24-Stunden-Test auf dem IDQ-Server an, ohne Registrierung:

du siehst sofort einen Demo-PC mit Beispieldaten;
wenn du möchtest, kannst du auch deine eigenen PCs verbinden (Menü → Gerät hinzufügen) und sie während des gesamten Tests sehen;
der Test dauert 24 Stunden ab dem ersten Start und ist nur einmal pro Gerät möglich (eine Neuinstallation startet ihn nicht neu);
nach 24 Stunden stoppt die App und verlangt deinen eigenen Server: unten steht, wie du ihn bekommst. Der Testbereich wird danach gelöscht.

Während des Tests ist der Fernneustart von PCs nicht verfügbar. Der Demo-PC ist kein echter Computer: Er zeigt nur, wie die App funktioniert.

3. So bekommst du deinen eigenen Server (Schritt für Schritt)

Nach dem Test, oder wenn du den IDQ-Server nicht nutzen möchtest, brauchst du deinen eigenen Server. Das ist kostenlos und einfach: Du brauchst nur einen ständig laufenden Computer und etwa 20 Minuten.

Schritt 1 - Was du brauchst

Einen ständig laufenden Computer mit Linux (Ubuntu, Debian, Raspberry Pi OS …): zum Beispiel einen Raspberry Pi 4, einen Mini-PC oder einen alten Laptop. Er verbraucht sehr wenig Strom.
Eine Internetverbindung. Du musst keine Ports am Router öffnen.
Python 3 (auf den meisten Linux-Systemen vorhanden) oder Docker.

Der Server liest den Computer aus, auf dem er läuft (Prozessor, Speicher, Datenträger …). Windows kann mit dem Agenten überwacht werden, der Server selbst sollte aber auf Linux laufen.

Raspberry Pi. Als Server empfehlen wir einen Pi 4 oder Pi 5 (mindestens 2 GB Speicher; ein Pi 3 reicht für wenige Computer). Als zu überwachender Computer läuft der Agent auf allen Modellen mit Raspberry Pi OS. Der .deb-Installer und die Fenster-App benötigen ein 64-Bit-System (Pi 5, 4, 400, 3, 3+, Zero 2 W): Prüfe mit uname -m (die Antwort muss aarch64 lauten); bei Pi Zero, Pi 1 und Pi 2 mit 32-Bit-System nutze den Befehl von Gerät hinzufügen. Die Fenster-App braucht den grafischen Desktop (nicht die Lite-Version).

Schritt 2 - Server-Paket herunterladen

Lade von der Website von IDQ Monitor User idq-monitor-server.zip herunter (Bereich Download → Server). Auf dem Server-Computer:

unzip idq-monitor-server.zip
cd idq-monitor-server

Schritt 3 - Server starten

Methode A - ohne Docker (am einfachsten):

python3 idq_monitor_server.py

Damit er bei jedem Einschalten von selbst startet, lege einen Dienst an:

sudo tee /etc/systemd/system/idq-monitor-server.service <<EOF
[Unit]
Description=IDQ Monitor server
After=network-online.target

[Service]
WorkingDirectory=$PWD
ExecStart=/usr/bin/python3 $PWD/idq_monitor_server.py
User=$USER
Restart=always

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now idq-monitor-server

Methode B - mit Docker:

docker compose up -d

Beim ersten Start erstellt der Server den Zugangsschlüssel (das Token) im Ordner dati. So liest du ihn aus:

cat dati/monitor.token

Schritt 4 - Server aus dem Internet erreichbar machen (kostenlos)

Die Apps verwenden eine sichere Adresse (https://…). Wähle eine dieser kostenlosen Möglichkeiten:

Tailscale Funnel (am einfachsten, keine Domain nötig): Erstelle ein kostenloses Konto auf tailscale.com, installiere Tailscale auf dem Server, aktiviere Funnel in den Kontoeinstellungen und starte:
```
sudo tailscale funnel --bg 8002
```
Du erhältst eine stabile Adresse wie https://pc-name.deinnetz.ts.net.
Cloudflare Tunnel (wenn du eine eigene Domain bei Cloudflare hast): Erstelle unter Zero Trust → Networks → Tunnels einen Tunnel, installiere den Connector mit dem angezeigten Befehl auf dem Server und füge dann einen Public hostname hinzu (z. B. monitor.deinedomain.de), der auf http://localhost:8002 zeigt.

Schritt 5 - Dein Link

Der Link für die Apps ist die Adresse aus Schritt 4, gefolgt von /monitor?k= und dem Token:

https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN

Der Link enthält den Zugangsschlüssel: gib ihn nicht weiter. Wer ihn hat, kann deine Daten sehen.

Schritt 6 - App verbinden

Öffne in der App das Menü (drei Striche) → Link ändern und füge den Link ein. Wenn die App den Bildschirm „Test beendet“ zeigt, wähle Ich habe schon meinen Server.

Schritt 7 - Deine Computer hinzufügen

In der App: Menü → Gerät hinzufügen…, einen Namen eingeben und den Befehl kopieren. Füge ihn auf dem zu überwachenden Computer ein:

Linux, Raspberry: im Terminal (der Befehl curl … | bash).
Windows: in PowerShell (der Befehl irm … | iex).

Administratorrechte: Die Installation fragt sie in diesem Moment ab (unter Windows erscheint das Bestätigungsfenster; unter Linux und Raspberry wird das sudo-Passwort verlangt). Sie werden für den Neustart aus der Ferne und zum Auslesen des Stromverbrauchs gebraucht: Es wird nur eine eng begrenzte Regel angelegt, und bei Ablehnung funktioniert der Monitor trotzdem.

Nach wenigen Sekunden erscheint der Computer oben in der App. Der Befehl installiert den Agenten und startet ihn bei jedem Einschalten. Alternativ nutze die Installer auf der Website (Windows, Ubuntu, Raspberry).

Schritt 8 - Anpassen

Wähle im Menü, welche Bereiche du sehen möchtest, welche Dienste überwacht werden und welche Alarme du erhältst (mit Schwellenwerten). Optional: Aktiviere den Fernneustart mit einer PIN.

4. So wird es benutzt

Reiter oben: einer pro Computer. Der Name ist grün, wenn er an ist, und rot, wenn er aus oder nicht erreichbar ist; darunter steht „aktiv“ oder „aus“.
Eine einzige Seite: Aktivität, Prozessor mit jedem Kern, Speicher, Datenträger, Netzwerk, Temperaturen, Dienste. Die Elemente passen sich Bildschirm oder Fenster an.
Menü: anzuzeigende Bereiche, Alarme und Warnungen, anzuzeigende Dienste, Gerät hinzufügen, Neustart-PIN, Anleitung, Info, Link ändern.
Widget (Android): Startbildschirm lange drücken und IDQ Monitor wählen.

Warnungen

In der Android-App sendet die Hintergrundprüfung (etwa alle 30 Sekunden) eine Benachrichtigung bei einem Alarm: Prozessor, Last, Speicher, Swap, Datenträger oder Temperatur über deinem Schwellenwert, abnormal beendeter Dienst, plötzlich ausgeschalteter Computer oder nicht erreichbarer Server. Ein normales Herunterfahren eines Computers löst keine Warnung aus. Erlaube unter Android im Menü ohne Akkubeschränkung, damit die Prüfung nicht gestoppt wird.

In den Computer-Apps werden Alarme nur in der App angezeigt, ohne Popups.

Dienste: aktiv, gestoppt, abgestürzt

Der Agent unterscheidet einen gestoppten Dienst (normal ausgeschaltet: keine Warnung) von einem abgestürzten (Fehler, Absturz, Speicher erschöpft: Warnung).

Updates und Neustarts

Wenn Updates einen Neustart erfordern, meldet dir die App das, und wenn du den Fernneustart aktiviert hast, erscheint Jetzt neu starten… (die PIN ist nötig). Automatische Updates auf Linux-Computern können nachts geplant werden (02:00–02:45) mit Neustart um 02:30.

Die Neustart-PIN

Beim ersten Start fragt die App, ob du deine Computer über die App neu starten können möchtest. Wenn du zustimmst, wähle eine PIN mit 4–8 Ziffern; im Menü kannst du sie ändern, zurücksetzen oder deaktivieren (auf eigenes Risiko: ohne PIN kann niemand Computer aus der Ferne neu starten). Nach 5 falschen PINs gilt eine Sperre von 5 Minuten. Die PIN prüft dein Server: Sie steckt nicht in der App.

Angekündigte Wartung

Um der App mitzuteilen, dass du an einem Linux-Computer arbeitest, schreibe einen Satz in die Datei ~/.config/idq-monitor-manutenzione: Er erscheint in der Karte Aktivität. Lösche die Datei nach den Arbeiten.

GPU und Stromverbrauch in Watt

Die GPU-Karte erscheint nur, wenn der Computer eine dedizierte Grafikkarte hat (nicht die im Prozessor integrierte): Sie zeigt Auslastung, Grafikspeicher, Temperatur und Watt (NVIDIA mit nvidia-smi; AMD unter Linux).

Der Bereich Verbrauch (Watt) zeigt die Gesamtwatt und getrennt die von Prozessor und GPU. Standardmäßig ist die Gesamtsumme eine Schätzung (Prozessor + GPU). Der Prozessor wird vom Energiezähler des Systems gelesen (unter Linux braucht das die bei der Installation erteilte Administratorerlaubnis).

Für den echten Verbrauch des gesamten PCs steck den Computer an eine smarte Shelly-Steckdose (Gen1 oder Gen2) und füge in die Datei ~/.config/idq-monitor-agente.json (unter Windows: %APPDATA%\idq-monitor-agente.json) ein:

"presa": { "tipo": "shelly", "ip": "192.168.1.50", "canale": 0 }

Starte dann den Agenten neu. Ab dann ist die Gesamtsumme der von der Steckdose gemessene Wert.

Ist der Computer ein professioneller Server (mit IPMI/BMC-Controller und ipmitool), ein Laptop oder hat Leistungssensoren auf dem Mainboard, nutzt der Agent sie automatisch für die echte Gesamtsumme, ohne Steckdose. Sonst zeigt er nur, was der Computer messen kann.

5. Die Agenten im Detail

Die Konfigurationsdatei des Agenten ist ~/.config/idq-monitor-agente.json (Windows: %APPDATA%\idq-monitor-agente.json). Du kannst die standardmäßig angezeigten Dienste angeben:

{
  "link": "https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN",
  "nome": "raspberry",
  "docker_tutti": true,
  "servizi": {
    "Web":    { "porta": 80,   "systemd": "nginx" },
    "Cloud":  { "porta": 8080, "docker": "nextcloud" },
    "Backup": 5000
  }
}

porta: lokaler Port, der antworten muss; systemd: Dienstname (Linux); docker: Containername; docker_tutti: alle Container anzeigen.
Ein gerade gestarteter Dienst hat 5 Minuten Toleranz, bevor er als abnormal gilt.

Um einen Computer zu entfernen: Agent stoppen (Linux: systemctl --user disable --now idq-monitor-agente; Windows: Unregister-ScheduledTask -TaskName IDQMonitorAgente -Confirm:$false).

6. Wenn etwas nicht funktioniert

Problem	Was tun
Die App zeigt „Verbindung zum Server…“	Prüfe das Netzwerk des Handys, ob der Server läuft und ob der Link stimmt (Menü → Link ändern).
Der Computer erscheint nicht	Prüfe, ob der Agent läuft, und führe den Befehl von Gerät hinzufügen erneut aus. Unter Linux: `journalctl --user -u idq-monitor-agente -n 20`.
Fehler 403	Link oder Token ist falsch: Kopiere ihn erneut vom Server (`cat dati/monitor.token`).
Benachrichtigungen kommen nicht an	Erlaube unter Android Benachrichtigungen und die Nutzung ohne Akkubeschränkung; entferne die App bei Samsung aus den „schlafenden Apps“.
PIN vergessen	Lösche auf dem Server `dati/monitor.pin` und starte den Server neu: Die App fordert dich auf, eine neue zu wählen.
Test beendet	Folge den Schritten „So bekommst du deinen eigenen Server“ und wähle Ich habe schon meinen Server.

7. Datenschutz und Kontakt

Die App hat keine Konten, keine Werbung und nutzt keine Analyse-Tools. Mit deinem eigenen Server bleiben die Daten deiner Computer zwischen deinen Computern, deinem Server und deinen Apps. Während des 24-Stunden-Tests gehen die Daten an den IDQ-Server und werden nach Ablauf gelöscht. Alle Einzelheiten stehen in der Datenschutzerklärung.

Entwickler: IDQ Developer · info@idq-developer.com

IDQ Monitor User - Guía completa

Cómo funciona, cómo probarlo y cómo tener tu propio servidor, paso a paso.

1. Qué es IDQ Monitor User

IDQ Monitor User muestra en tiempo real el estado de tus ordenadores: procesador (cada núcleo), carga, memoria, swap, discos y particiones, red, temperaturas, servicios activos, actualizaciones y mantenimiento. Si algo va mal, te avisa en el móvil.

Funciona con tres piezas:

La app (Android, Windows, Linux y una página web) que muestra los datos.
Un servidor: un ordenador siempre encendido que recoge los datos y los pone a disposición de la app, incluso fuera de casa.
Un agente en cada ordenador que quieras controlar: un pequeño programa que envía los datos al servidor.

  Tus ordenadores ──(agente)──►  TU SERVIDOR  ◄──  App (móvil, tableta, PC, web)

2. La prueba gratuita de 24 horas

La primera vez que abres la app te ofrece una prueba gratuita de 24 horas en el servidor IDQ, sin registro:

ves enseguida un PC de demostración con datos de ejemplo;
si quieres, también puedes conectar tus propios PC (menú → Añadir dispositivo) y verlos durante toda la prueba;
la prueba dura 24 horas desde el primer inicio y solo se puede hacer una vez por dispositivo (reinstalar la app no la reinicia);
pasadas las 24 horas la app se detiene y pide tu propio servidor: abajo encontrarás cómo conseguirlo. El espacio de prueba se borra después.

Durante la prueba no está disponible el reinicio remoto de los PC. El PC de demostración no es un ordenador real: solo sirve para ver cómo funciona la app.

3. Cómo tener tu propio servidor (paso a paso)

Después de la prueba, o si prefieres no usar el servidor IDQ, necesitas tu propio servidor. Es gratis y sencillo: basta un ordenador siempre encendido y unos 20 minutos.

Paso 1 - Qué necesitas

Un ordenador siempre encendido con Linux (Ubuntu, Debian, Raspberry Pi OS…): por ejemplo una Raspberry Pi 4, un mini PC o un portátil viejo. Consume muy poco.
Una conexión a internet. No hace falta abrir puertos en el router.
Python 3 (ya presente en la mayoría de los Linux) o Docker.

El servidor lee el ordenador en el que funciona (procesador, memoria, discos…). Windows se puede controlar con el agente, pero el servidor debe ir en Linux.

Raspberry Pi. Como servidor recomendamos una Pi 4 o Pi 5 (al menos 2 GB de memoria; una Pi 3 basta para pocos ordenadores). Como ordenador a controlar, el agente funciona en todos los modelos con Raspberry Pi OS. El instalador .deb y la app con ventana requieren un sistema de 64 bits (Pi 5, 4, 400, 3, 3+, Zero 2 W): comprueba con uname -m (debe responder aarch64); en Pi Zero, Pi 1 y Pi 2 con sistema de 32 bits usa el comando de Añadir dispositivo. La app con ventana necesita el escritorio gráfico (no la versión Lite).

Paso 2 - Descarga el paquete del servidor

Desde el sitio web de IDQ Monitor User descarga idq-monitor-server.zip (sección Descargas → Servidor). En el ordenador del servidor:

unzip idq-monitor-server.zip
cd idq-monitor-server

Paso 3 - Inicia el servidor

Método A - sin Docker (el más sencillo):

python3 idq_monitor_server.py

Para que arranque solo en cada encendido, crea un servicio:

sudo tee /etc/systemd/system/idq-monitor-server.service <<EOF
[Unit]
Description=IDQ Monitor server
After=network-online.target

[Service]
WorkingDirectory=$PWD
ExecStart=/usr/bin/python3 $PWD/idq_monitor_server.py
User=$USER
Restart=always

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now idq-monitor-server

Método B - con Docker:

docker compose up -d

En el primer arranque el servidor crea la clave de acceso (el token) en la carpeta dati. Para leerla:

cat dati/monitor.token

Paso 4 - Llega al servidor desde internet (gratis)

Las apps usan una dirección segura (https://…). Elige una de estas opciones gratuitas:

Tailscale Funnel (la más sencilla, sin dominio): crea una cuenta gratuita en tailscale.com, instala Tailscale en el servidor, activa Funnel en los ajustes de tu cuenta y ejecuta:
```
sudo tailscale funnel --bg 8002
```
Obtienes una dirección estable del tipo https://nombre-pc.turred.ts.net.
Cloudflare Tunnel (si tienes un dominio en Cloudflare): en Zero Trust → Networks → Tunnels crea un túnel, instala el conector en el servidor con el comando que se muestra y añade un Public hostname (por ejemplo monitor.tudominio.es) que apunte a http://localhost:8002.

Paso 5 - Tu enlace

El enlace que debes usar en las apps es la dirección del paso 4 seguida de /monitor?k= y del token:

https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN

El enlace contiene la clave de acceso: no lo compartas. Quien lo tenga puede ver tus datos.

Paso 6 - Conecta la app

En la app abre el menú (tres rayas) → Cambiar enlace y pega el enlace. Si la app está en la pantalla de «prueba terminada», elige Ya tengo mi servidor.

Paso 7 - Añade tus ordenadores

En la app: menú → Añadir dispositivo…, escribe un nombre y copia el comando. En el ordenador que quieres controlar, pégalo:

Linux, Raspberry: en el Terminal (el comando curl … | bash).
Windows: en PowerShell (el comando irm … | iex).

Permisos de administrador: la instalación los pide en ese momento (en Windows aparece la ventana de confirmación; en Linux y Raspberry se pide la contraseña de sudo). Hacen falta para el reinicio remoto y para leer el consumo: solo se crea una regla limitada, y si lo rechazas el monitor funciona igualmente.

En pocos segundos el ordenador aparece arriba en la app. El comando instala el agente y lo inicia en cada encendido. También puedes usar los instaladores del sitio web (Windows, Ubuntu, Raspberry).

Paso 8 - Personaliza

Desde el menú elige qué secciones ver, qué servicios controlar y qué alarmas recibir (con sus umbrales). Opcional: activa el reinicio remoto con un PIN.

4. Cómo se usa

Pestañas arriba: una por ordenador. El nombre es verde si está encendido y rojo si está apagado o inaccesible; debajo pone «activo» o «apagado».
Una sola página: actividad, procesador con cada núcleo, memoria, discos, red, temperaturas, servicios. Los elementos se adaptan a la pantalla o a la ventana.
Menú: secciones a mostrar, alarmas y avisos, servicios a mostrar, añadir dispositivo, PIN del reinicio, guía, información, cambiar enlace.
Widget (Android): mantén pulsada la pantalla de inicio y elige IDQ Monitor.

Avisos

En la app de Android el control en segundo plano (cada 30 segundos aproximadamente) envía una notificación cuando hay una alarma: procesador, carga, memoria, swap, disco o temperatura por encima del umbral que elegiste, servicio detenido de forma anómala, ordenador apagado de golpe o servidor inaccesible. Un apagado normal de un ordenador no genera avisos. En Android, en el menú, permite sin límites de batería para que el control no se detenga.

En las apps de ordenador las alarmas solo se ven dentro de la app, sin ventanas emergentes.

Servicios: activo, parado, fallido

El agente distingue un servicio parado (apagado con normalidad: sin aviso) de uno fallido de forma anómala (error, bloqueo, memoria agotada: aviso).

Actualizaciones y reinicios

Si hay actualizaciones que requieren reiniciar, la app te lo indica y, si has activado el reinicio remoto, aparece Reiniciar ahora… (hace falta el PIN). Las actualizaciones automáticas de los ordenadores Linux pueden programarse de noche (02:00-02:45) con reinicio a las 02:30.

El PIN del reinicio

En el primer inicio la app pregunta si quieres poder reiniciar tus ordenadores desde la app. Si aceptas, elige un PIN de 4 a 8 cifras; desde el menú puedes cambiarlo, restablecerlo o desactivarlo (bajo tu propio riesgo: sin PIN nadie puede reiniciar ordenadores a distancia). Tras 5 PIN erróneos hay un bloqueo de 5 minutos. El PIN lo comprueba tu servidor: no está en la app.

Mantenimiento declarado

Para avisar a la app de que estás trabajando en un ordenador Linux, escribe una frase en el archivo ~/.config/idq-monitor-manutenzione: aparecerá en la tarjeta Actividad. Borra el archivo al terminar.

GPU y consumo en vatios

La tarjeta GPU solo aparece si el ordenador tiene una tarjeta gráfica dedicada (no la integrada en el procesador): muestra uso, memoria de vídeo, temperatura y vatios (NVIDIA con nvidia-smi; AMD en Linux).

La sección Consumo (vatios) muestra los vatios totales y, por separado, los del procesador y de la GPU. Por defecto el total es una estimación (procesador + GPU). El procesador se lee del contador de energía del sistema (en Linux hace falta el permiso de administrador dado en la instalación).

Para el consumo real de todo el PC, conecta el ordenador a un enchufe inteligente Shelly (Gen1 o Gen2) y añade en el archivo ~/.config/idq-monitor-agente.json (en Windows: %APPDATA%\idq-monitor-agente.json):

"presa": { "tipo": "shelly", "ip": "192.168.1.50", "canale": 0 }

Después reinicia el agente. Desde entonces el total es el medido por el enchufe.

Si el ordenador es un servidor profesional (con controlador IPMI/BMC e ipmitool), un portátil o tiene sensores de potencia en la placa base, el agente los usa automáticamente para el total real, sin enchufe. Si no, solo muestra lo que el ordenador sabe medir.

5. Los agentes en detalle

El archivo de configuración del agente es ~/.config/idq-monitor-agente.json (Windows: %APPDATA%\idq-monitor-agente.json). Puedes indicar los servicios que se muestran por defecto:

{
  "link": "https://YOUR-ADDRESS/monitor?k=YOUR-TOKEN",
  "nome": "raspberry",
  "docker_tutti": true,
  "servizi": {
    "Web":    { "porta": 80,   "systemd": "nginx" },
    "Cloud":  { "porta": 8080, "docker": "nextcloud" },
    "Backup": 5000
  }
}

porta: puerto local que debe responder; systemd: nombre del servicio (Linux); docker: nombre del contenedor; docker_tutti: mostrar todos los contenedores.
Un servicio recién iniciado tiene 5 minutos de margen antes de considerarse anómalo.

Para quitar un ordenador: detén el agente (Linux: systemctl --user disable --now idq-monitor-agente; Windows: Unregister-ScheduledTask -TaskName IDQMonitorAgente -Confirm:$false).

6. Si algo no funciona

Problema	Qué hacer
La app dice «Conectando con el servidor…»	Comprueba la red del móvil, que el servidor esté encendido y que el enlace sea correcto (menú → Cambiar enlace).
El ordenador no aparece	Comprueba que el agente esté activo y vuelve a ejecutar el comando de Añadir dispositivo. En Linux: `journalctl --user -u idq-monitor-agente -n 20`.
Error 403	El enlace o el token no es correcto: cópialo de nuevo desde el servidor (`cat dati/monitor.token`).
No llegan las notificaciones	En Android permite las notificaciones y el uso sin límites de batería; en Samsung quita la app de las «aplicaciones en suspensión».
PIN olvidado	En el servidor borra `dati/monitor.pin` y reinicia el servidor: la app te pedirá elegir uno nuevo.
Prueba terminada	Sigue los pasos de «Cómo tener tu propio servidor» y elige Ya tengo mi servidor.

7. Privacidad y contacto

La app no tiene cuentas, ni publicidad y no usa herramientas de análisis. Con tu propio servidor, los datos de tus ordenadores quedan entre tus ordenadores, tu servidor y tus apps. Durante la prueba de 24 horas los datos van al servidor IDQ y se borran al caducar. Todos los detalles están en la política de privacidad.

Desarrollador: IDQ Developer · info@idq-developer.com

ContattiContactContactKontaktContacto

ParliamoneLet's talkDiscutons-enSprechen wirHablemos

Due domande veloci prima di scrivere: così il messaggio arriva già con tutto il contesto che serve per risponderti bene. Two quick questions before you write: that way the message arrives with all the context needed to answer you well. Deux questions rapides avant d'écrire : ainsi le message arrive avec tout le contexte nécessaire pour bien vous répondre. Zwei kurze Fragen, bevor Sie schreiben: So kommt die Nachricht gleich mit allem nötigen Kontext an. Dos preguntas rápidas antes de escribir: así el mensaje llega ya con todo el contexto necesario.