MeshControl Pro MeshControl Pro

1 Benvenuto

MeshControl Pro è un'applicazione Android nativa che trasforma il tuo smartphone o tablet in una postazione di amministrazione completa per server MeshCentral. Pensata per tecnici IT, sistemisti e amministratori di rete, ti permette di controllare i computer gestiti dal tuo server direttamente dal dispositivo mobile, ovunque tu sia.

Cosa puoi fare con l'app

• 🖥️
  Desktop Remoto (KVM)Controlli il mouse, la tastiera e vedi lo schermo dei PC gestiti in tempo reale.
• 💻
  TerminaleApri una console MeshCentral o una sessione SSH diretta verso i nodi.
• 📁
  File ExplorerSfoglia, carica, scarica e organizza i file sui computer remoti.
• 👥
  Gestione utentiSe hai privilegi di amministratore, crea e rimuovi utenti MeshCentral.
• 📋
  Log di sistemaConsulti ed esporti gli eventi del server per audit e diagnosi.

A chi è rivolto

MeshControl Pro è pensato per utenti con competenze tecniche di base: tecnici d'assistenza, help desk, amministratori di sistema, sviluppatori DevOps e consulenti IT che gestiscono parchi macchine distribuiti. Non è necessario essere esperti: il manuale ti accompagna passo passo.

Struttura del manuale

Il manuale è organizzato seguendo il flusso naturale d'uso dell'app: dall'installazione alla prima connessione, fino alle funzionalità avanzate. Se ti serve solo un riferimento rapido, vai direttamente al capitolo che ti interessa tramite l'indice.

1 Welcome

MeshControl Pro is a native Android application that transforms your smartphone or tablet into a full administration workstation for MeshCentral servers. Designed for IT technicians, sysadmins, and network administrators, it lets you control computers managed by your server directly from your mobile device, from anywhere.

What you can do with the app

• 🖥️
  Remote Desktop (KVM)Control the mouse and keyboard and see the screen of managed PCs in real time.
• 💻
  TerminalOpen a MeshCentral console or a direct SSH session to any node.
• 📁
  File ExplorerBrowse, upload, download, and organise files on remote computers.
• 👥
  User managementCreate and remove MeshCentral users if you have administrator privileges.
• 📋
  System logView and export server events for auditing and diagnostics.

Who it's for

MeshControl Pro is aimed at users with basic technical knowledge: field technicians, help desk staff, system administrators, DevOps developers, and IT consultants managing distributed fleets of machines. No expertise required — this manual guides you step by step.

How this manual is organised

The manual follows the natural usage flow of the app: from installation to first connection, through to advanced features. If you only need a quick reference, jump directly to the chapter you're interested in using the table of contents.

2 Requisiti e prerequisiti

2.1 Dispositivo Android

2.2 Server MeshCentral

Ti serve un server MeshCentral già installato e raggiungibile dalla rete del tuo dispositivo. Non è necessario configurare nulla di speciale lato server: l'app usa le stesse API del client web ufficiale.

• Versione MeshCentral: 1.1.0 o superiore consigliata.
• Certificato TLS: valido (Let's Encrypt, commerciale o CA aziendale). Anche i certificati self-signed sono supportati, vedi capitolo 5.
• Porta di accesso: tipicamente 443 (HTTPS); verifica che sia raggiungibile.
• Account utente: username e password validi. Se hai 2FA attivo, serve un'app TOTP (Google Authenticator, Authy, ecc.).

2.3 Abbonamento

MeshControl Pro è un prodotto commerciale distribuito da Nuraghia Srl. Per sbloccare tutte le funzionalità ti serve un abbonamento Premium, che include 7 giorni di prova gratuita all'installazione. Vedi capitolo 4 per i dettagli sui piani disponibili.

2.4 Permessi richiesti dall'app

2 Requirements & Prerequisites

2.1 Android Device

2.2 MeshCentral Server

You need an already installed MeshCentral server reachable from your device's network. No special server-side configuration is required — the app uses the same APIs as the official web client.

• MeshCentral version: 1.1.0 or higher recommended.
• TLS certificate: valid (Let's Encrypt, commercial, or corporate CA). Self-signed certificates are supported — see chapter 5.
• Access port: typically 443 (HTTPS); verify it is reachable.
• User account: valid username and password. If 2FA is enabled, you'll need a TOTP app (Google Authenticator, Authy, etc.).

2.3 Subscription

MeshControl Pro is a commercial product distributed by Nuraghia Srl. To unlock all features you need a Premium subscription, which includes a 7-day free trial at installation. See chapter 4 for details on available plans.

2.4 App Permissions

3 Installazione e primo avvio

3.1 Installazione dal Google Play Store

1. Apri il Google Play Store sul tuo dispositivo Android.
2. Nella barra di ricerca digita MeshControl Pro.
3. Seleziona l'app pubblicata da Nuraghia Srl.
4. Tocca Installa e attendi il completamento del download.
5. Al termine, tocca Apri per lanciare l'app per la prima volta.

3.2 Primo avvio

Al primo avvio dell'app vedrai, in sequenza, le seguenti schermate:

• Richieste di permesso: Android ti chiederà uno per uno i permessi necessari. Concedi quelli indicati al capitolo 2.4 per usare tutte le funzioni dell'app.
• Schermata licenza: l'app verifica se hai un abbonamento attivo o un periodo di prova. Alla prima installazione parte automaticamente la prova gratuita di 7 giorni (vedi capitolo 4).
• Schermata di login: inserisci l'URL del tuo server MeshCentral, username e password per accedere (vedi capitolo 5).
• Dashboard: una volta autenticato vedrai la lista dei nodi gestiti dal tuo server.

3.3 Cosa fare se l'app non parte

• Verifica di avere una connessione Internet attiva (Wi-Fi o dati mobili).
• Prova a chiudere completamente l'app dalle app recenti e riaprirla.
• Se vedi la schermata "Licenza non valida" senza aver mai aperto l'app prima, controlla che il tuo dispositivo abbia data e ora corrette.
• In caso di crash ripetuto, disinstalla e reinstalla l'app dal Play Store: il tuo abbonamento resta attivo ed è collegato al tuo account Google.

3 Installation & First Launch

3.1 Installation from Google Play Store

1. Open the Google Play Store on your Android device.
2. In the search bar, type MeshControl Pro.
3. Select the app published by Nuraghia Srl.
4. Tap Install and wait for the download to complete.
5. When done, tap Open to launch the app for the first time.

3.2 First Launch

On first launch you will see the following screens in sequence:

• Permission requests: Android will ask for the necessary permissions one by one. Grant those listed in chapter 2.4 to use all app features.
• License screen: the app checks whether you have an active subscription or a trial period. On first installation, the 7-day free trial starts automatically (see chapter 4).
• Login screen: enter your MeshCentral server URL, username, and password (see chapter 5).
• Dashboard: once authenticated, you will see the list of nodes managed by your server.

3.3 What to do if the app doesn't start

• Check that you have an active Internet connection (Wi-Fi or mobile data).
• Try force-closing the app from recent apps and reopening it.
• If you see a "Invalid license" screen without ever having opened the app before, check that your device has the correct date and time.
• In case of repeated crashes, uninstall and reinstall the app from the Play Store — your subscription remains active and is linked to your Google account.

4 Licenza e abbonamento

MeshControl Pro richiede un abbonamento per funzionare. All'installazione ricevi automaticamente 7 giorni di prova gratuita con tutte le funzionalità sbloccate e senza vincoli. Al termine della prova puoi scegliere se sottoscrivere un piano mensile o annuale.

4.1 Piani disponibili

4.2 Stati possibili della licenza

4.3 Come sottoscrivere un abbonamento

1. Nella schermata licenza, tocca Abbonati.
2. Si apre una schermata con i piani Mensile e Annuale: tocca quello che preferisci.
3. Si apre la finestra di pagamento di Google Play: conferma con impronta, PIN o password.
4. Al termine torni automaticamente all'app con la licenza attivata.

4.4 Gestire o cancellare l'abbonamento

Tutti gli abbonamenti si gestiscono direttamente dal Google Play Store:

1. Apri il Play Store, tocca l'icona del tuo profilo in alto a destra.
2. Vai in Pagamenti e abbonamenti → Abbonamenti.
3. Seleziona MeshControl Pro.
4. Da qui puoi cambiare piano, aggiornare il metodo di pagamento o annullare il rinnovo.

4 License & Subscription

MeshControl Pro requires a subscription to work. Upon installation, you automatically receive a 7-day free trial with all features unlocked and no restrictions. After the trial you can choose a monthly or annual plan.

4.1 Available Plans

4.2 Possible License States

4.3 How to Subscribe

1. On the license screen, tap Subscribe.
2. A screen showing the Monthly and Annual plans appears — tap your preferred option.
3. The Google Play payment sheet opens — confirm with fingerprint, PIN, or password.
4. You are automatically returned to the app with the license activated.

4.4 Managing or Cancelling Your Subscription

All subscriptions are managed directly from the Google Play Store:

1. Open the Play Store, tap your profile icon in the top right.
2. Go to Payments & subscriptions → Subscriptions.
3. Select MeshControl Pro.
4. From here you can change plan, update the payment method, or cancel renewal.

5 Accesso al server MeshCentral

La schermata di login è il punto di ingresso all'app. Qui inserisci le coordinate del tuo server MeshCentral e le credenziali con cui accedi abitualmente via web.

5.1 Campi principali

5.2 Autenticazione a due fattori (2FA)

Se il tuo server MeshCentral ha la 2FA abilitata per il tuo utente, dopo aver premuto Accedi l'app ti chiederà di inserire anche il codice TOTP a 6 cifre generato dalla tua app di autenticazione.

1. Apri l'app di autenticazione sul tuo telefono.
2. Cerca la voce relativa al tuo server MeshCentral.
3. Inserisci il codice di 6 cifre nel campo Codice 2FA (TOTP).
4. Tocca Accedi per completare l'autenticazione.

5.3 Opzioni avanzate

Toccando Opzioni avanzate si apre una sezione con impostazioni per casi particolari.

• Chiave di accesso diretto (?key=): Se hai ricevuto un link del tipo https://mesh.azienda.it?key=abc123..., puoi incollare la parte dopo ?key= in questo campo per accedere direttamente al nodo associato.
• Ignora errori SSL (self-signed): Attiva questa opzione solo se il tuo server usa un certificato autofirmato. L'app accetterà comunque la connessione, che resta cifrata.

5.4 Server salvati

Sotto il form di login trovi la lista dei server a cui ti sei già collegato. Tocca una voce per precompilare l'URL. Per rimuovere un server, tieni premuto sulla voce e conferma l'eliminazione.

5.5 Link diretto "meshcentral://"

MeshControl Pro supporta i deep link nel formato meshcentral://host?key=.... Se ricevi un link di questo tipo, toccandolo si apre direttamente l'app con URL e chiave già compilati.

5.6 Problemi comuni al login

5 Server Login

The login screen is the entry point to the app. Here you enter your MeshCentral server address and the credentials you normally use to access it via the web.

5.1 Main Fields

5.2 Two-Factor Authentication (2FA)

If your MeshCentral server has 2FA enabled for your account, after tapping Log in the app will ask you to enter the 6-digit TOTP code generated by your authenticator app.

1. Open your authenticator app on your phone.
2. Find the entry for your MeshCentral server.
3. Enter the 6-digit code in the 2FA Code (TOTP) field.
4. Tap Log in to complete authentication.

5.3 Advanced Options

Tapping Advanced options opens a section with settings for special cases.

• Direct access key (?key=): If you received a link like https://mesh.company.com?key=abc123..., paste the part after ?key= here to access the associated node directly.
• Ignore SSL errors (self-signed): Enable this only if your server uses a self-signed certificate. The app will still accept the connection, which remains encrypted.

5.4 Saved Servers

Below the login form you'll find the list of servers you've previously connected to. Tap an entry to auto-fill the URL. To remove a server, long-press the entry and confirm deletion.

5.5 Deep Link "meshcentral://"

MeshControl Pro supports deep links in the format meshcentral://host?key=.... If you receive a link of this type, tapping it opens the app directly with the URL and key already filled in.

5.6 Common Login Issues

6 La Dashboard dei nodi

Dopo il login atterri sulla Dashboard: il cuore dell'app. Qui trovi la lista completa di tutti i nodi gestiti dal tuo server MeshCentral, aggiornata in tempo reale.

6.1 Anatomia della schermata

• Barra superiore: contiene il titolo "Nodi", un pulsante di aggiornamento manuale e l'icona per il logout.
• Barra di ricerca: digita una parte del nome, dell'IP o del sistema operativo per filtrare la lista in tempo reale.
• Lista nodi: scroll verticale con una card per ogni nodo. I nodi online sono in cima, gli offline in fondo.
• Barra inferiore: pulsanti rapidi per Utenti, Log e Impostazioni.

6.2 Cosa mostra ogni card nodo

6.3 Il menu azioni per nodo

Tocca l'icona ⋮ accanto a un nodo per aprire il menu delle azioni disponibili. Le azioni che vedi dipendono dal sistema operativo del nodo e dallo stato (online/offline).

6.4 Disconnessione

Per disconnetterti tocca l'icona di logout in alto a destra. L'app ti chiederà conferma: toccando Disconnetti la sessione viene chiusa e torni alla schermata di login. Le credenziali salvate non vengono cancellate.

6 Node Dashboard

After login you land on the Dashboard — the heart of the app. Here you find the complete list of all nodes (computers and devices) managed by your MeshCentral server, updated in real time.

6.1 Screen Layout

• Top bar: contains the "Nodes" title, a manual refresh button, and the logout icon.
• Search bar: type part of a name, IP address, or operating system to filter the list in real time.
• Node list: a vertically scrollable list with a card for each node. Online nodes appear at the top, offline nodes at the bottom.
• Bottom bar: quick buttons for Users, Log, and Settings.

6.2 What Each Node Card Shows

6.3 Node Action Menu

Tap the ⋮ icon next to a node to open its available actions. The actions shown depend on the node's operating system and its online/offline state.

6.4 Logging Out

To disconnect from the MeshCentral server, tap the logout icon in the top right. The app will ask for confirmation — tapping Disconnect closes the session and returns you to the login screen. Saved credentials are not deleted.

7 Desktop Remoto (KVM)

Il Desktop Remoto — chiamato anche KVM — è la funzione di punta dell'app: ti permette di vedere lo schermo di un PC gestito e di controllarlo con mouse e tastiera direttamente dal tuo dispositivo Android.

7.1 Avvio di una sessione KVM

1. Dalla Dashboard, tocca l'icona ⋮ sul nodo a cui vuoi collegarti.
2. Seleziona Desktop Remoto (KVM).
3. Attendi che compaia la schermata del nodo (solitamente 2–5 secondi).
4. Lo schermo del PC remoto apparirà adattato alla tua schermata.

7.2 Gesture per controllare il PC remoto

7.3 Tastiera virtuale

Per inviare testo al PC remoto tocca l'icona della tastiera nella barra degli strumenti KVM. Ciò che digiti viene trasmesso carattere per carattere al nodo remoto. Per nascondere la tastiera, tocca di nuovo l'icona o premi Indietro di Android.

7.4 Tasti speciali e combinazioni

7.5 Appunti (Clipboard) sincronizzata

Puoi copiare del testo sul tuo telefono e incollarlo sul PC remoto, o viceversa. Tocca l'icona Clipboard nella toolbar: il testo attualmente negli appunti di Android viene inviato al PC remoto come contenuto della sua clipboard.

7.6 Qualità dello streaming

7.7 Chiudere la sessione KVM

Per uscire dal KVM e tornare alla Dashboard, tocca la freccia indietro in alto a sinistra o premi il tasto Indietro di Android. La sessione viene chiusa e il nodo resta raggiungibile per future connessioni.

7 Remote Desktop (KVM)

Remote Desktop — also called KVM — is the app's flagship feature: it lets you see the screen of a managed PC and control it with a mouse and keyboard directly from your Android device.

7.1 Starting a KVM Session

1. From the Dashboard, tap the ⋮ icon on the node you want to connect to.
2. Select Remote Desktop (KVM).
3. Wait for the node's screen to appear (usually 2–5 seconds).
4. The remote PC's screen will appear scaled to fit your display.

7.2 Gestures for Remote Control

7.3 Virtual Keyboard

To send text to the remote PC, tap the keyboard icon in the KVM toolbar. Whatever you type is transmitted character by character to the remote node. To hide the keyboard, tap the icon again or press Android's Back button.

7.4 Special Keys and Shortcuts

7.5 Clipboard Sync

You can copy text on your phone and paste it on the remote PC, or vice versa. Tap the Clipboard icon in the toolbar: the text currently in Android's clipboard is sent to the remote PC's clipboard.

7.6 Streaming Quality

7.7 Ending the KVM Session

To exit KVM and return to the Dashboard, tap the back arrow in the top left or press Android's Back button. The session is closed and the node remains available for future connections.

8 Terminale: Console MeshCentral e SSH

MeshControl Pro integra due tipi di terminale con sfondo nero stile xterm e font a larghezza fissa: la Console MeshCentral e l'SSH diretto.

8.1 Console MeshCentral vs SSH: quale scegliere?

8.2 Usare la Console MeshCentral

1. Nella Dashboard, tocca ⋮ sul nodo desiderato.
2. Seleziona Console MeshCentral.
3. Attendi il messaggio "Connessione console MeshCentral...": dopo qualche secondo vedi il prompt.
4. Digita i comandi nel campo in basso e tocca il pulsante di invio (freccia).

8.3 Usare SSH diretto

1. Nella Dashboard, tocca ⋮ sul nodo desiderato.
2. Seleziona SSH Diretto.
3. Nel dialog di configurazione inserisci Host, Utente, Password e, se necessario, una Porta diversa dalla 22.
4. Tocca Connetti per aprire la sessione.

8.4 Tasti speciali nella barra del terminale

8.5 Pulire il terminale

Il pulsante Pulisci terminale in alto a destra svuota la cronologia visualizzata senza chiudere la sessione — utile quando l'output è diventato troppo lungo. Equivale al comando clear (Linux) o cls (PowerShell).

8 Terminal: Console & SSH

MeshControl Pro includes two types of terminal with a black xterm-style background and fixed-width font: the MeshCentral Console and Direct SSH.

8.1 MeshCentral Console vs SSH: which to use?

8.2 Using the MeshCentral Console

1. In the Dashboard, tap ⋮ on the desired node.
2. Select MeshCentral Console.
3. Wait for the "Connecting to MeshCentral console..." message — the prompt appears after a few seconds.
4. Type commands in the field at the bottom and tap the send button (arrow).

8.3 Using Direct SSH

1. In the Dashboard, tap ⋮ on the desired node.
2. Select Direct SSH.
3. In the configuration dialog, enter the Host, User, Password and, if needed, a Port other than 22.
4. Tap Connect to open the session.

8.4 Special Keys in the Terminal Bar

8.5 Clearing the Terminal

The Clear terminal button at the top right clears the displayed output without closing the session — useful when the output becomes too long. It is equivalent to the clear command (Linux) or cls (PowerShell).

9 File Explorer remoto

Il File Explorer ti permette di sfogliare l'intero filesystem del PC remoto, scaricare file, caricarne di nuovi e organizzare cartelle, tutto dal tuo dispositivo Android.

9.1 Aprire il File Explorer

1. Dalla Dashboard, tocca ⋮ sul nodo desiderato.
2. Seleziona File Explorer.
3. Dopo qualche secondo appare la lista dei file della directory radice (C:\ su Windows, / su Linux/macOS).

9.2 Navigare tra le cartelle

• Tocca una cartella per entrarvi.
• Tocca "... (cartella superiore)" in alto per tornare indietro. Compare solo se non sei già nella radice.
• Il percorso corrente è mostrato sopra la lista.

9.3 Scaricare un file

1. Tocca il file che vuoi scaricare.
2. Nel menu seleziona Download.
3. Una barra di progresso mostra l'avanzamento del trasferimento.
4. Al termine l'app apre automaticamente il file con l'applicazione appropriata.

9.4 Caricare un file

1. Naviga nella cartella remota di destinazione.
2. Tocca il pulsante Upload in alto a destra.
3. Si apre il selettore file di Android: scegli il file dalla galleria, dai download o da qualsiasi app di storage.
4. Una barra di progresso mostra l'avanzamento del caricamento.

9.5 Creare una nuova cartella

1. Naviga nella posizione desiderata.
2. Tocca l'icona Nuova cartella in alto a destra.
3. Inserisci il nome nel dialog e tocca Crea.

9.6 Eliminare file o cartelle

1. Tocca il file o la cartella che vuoi eliminare.
2. Nel menu seleziona Elimina.
3. Conferma nel dialog di sicurezza.

9 File Explorer

The File Explorer lets you browse the entire filesystem of a remote PC, download files, upload new ones, and organise folders — all from your Android device.

9.1 Opening the File Explorer

1. From the Dashboard, tap ⋮ on the desired node.
2. Select File Explorer.
3. After a few seconds, the root directory of the node appears (C:\ on Windows, / on Linux/macOS).

9.2 Navigating Folders

• Tap a folder to enter it.
• Tap "... (parent folder)" at the top to go back. Only shown when you're not already at the root.
• The current path is shown above the list.

9.3 Downloading a File

1. Tap the file you want to download.
2. In the menu, select Download.
3. A progress bar shows the transfer status.
4. When done, the app automatically opens the file with the appropriate Android app.

9.4 Uploading a File

1. Navigate to the target remote folder.
2. Tap the Upload button in the top right.
3. The Android file picker opens — choose a file from your gallery, downloads, or any storage app.
4. A progress bar shows the upload status.

9.5 Creating a New Folder

1. Navigate to the desired location.
2. Tap the New folder icon in the top right.
3. Enter the name in the dialog and tap Create.

9.6 Deleting Files or Folders

1. Tap the file or folder you want to delete.
2. In the menu, select Delete.
3. Confirm in the safety dialog.

10 Gestione Utenti (solo admin)

Se il tuo account MeshCentral ha privilegi di amministratore di sito, puoi gestire gli utenti del server direttamente dall'app. Se non sei admin la lista risulterà vuota o in sola lettura.

10.1 Accedere alla gestione utenti

Dalla Dashboard, tocca il pulsante Utenti nella barra inferiore. Si apre la lista di tutti gli utenti MeshCentral, ordinata per nome. Per ciascun utente vedi: nome, email, stato di admin, 2FA attiva, data di creazione e ultimo login.

10.2 Aggiungere un utente

1. Tocca l'icona + (Aggiungi persona) in alto a destra.
2. Compila i campi: Email, Nome completo, Password iniziale.
3. Se vuoi renderlo amministratore di sito, attiva l'interruttore Amministratore.
4. Tocca Aggiungi: l'utente viene creato e appare subito nella lista.

10.3 Eliminare un utente

1. Individua l'utente da eliminare nella lista.
2. Tocca l'icona del cestino accanto al suo nome.
3. Conferma nel dialog di sicurezza.

10 User Management (admins only)

If your MeshCentral account has site administrator privileges, you can manage server users directly from the app. If you are not an admin, the list will be empty or read-only.

10.1 Accessing User Management

From the Dashboard, tap the Users button in the bottom bar. The list of all MeshCentral users opens, sorted by name. For each user you can see: name, email, admin status, 2FA active/inactive, creation date, and last login.

10.2 Adding a User

1. Tap the + (Add person) icon in the top right.
2. Fill in the fields: Email, Full name, Initial password.
3. If you want to make this user a site administrator, enable the Administrator toggle.
4. Tap Add — the user is created and appears in the list immediately.

10.3 Deleting a User

1. Find the user to delete in the list.
2. Tap the trash icon next to their name.
3. Confirm in the safety dialog.

11 Log di sistema

La schermata Log mostra la cronologia degli eventi del server MeshCentral: login degli utenti, accessi ai nodi, modifiche di configurazione, sessioni KVM, invii di Magic Packet, errori di autenticazione. È uno strumento prezioso per l'auditing e la diagnosi di problemi.

11.1 Consultare i log

Dalla Dashboard, tocca Log nella barra inferiore. Gli eventi sono mostrati in ordine cronologico inverso (più recenti in cima) con data/ora, tipo di evento, utente coinvolto e descrizione.

11.2 Pulire la vista locale

Il pulsante Pulisci log svuota la visualizzazione corrente solo sul tuo dispositivo. Gli eventi restano comunque salvati sul server MeshCentral e possono essere ricaricati con il pulsante Aggiorna.

11.3 Esportare i log

1. Tocca il pulsante Esporta in alto a destra.
2. L'app genera un file di testo con tutti gli eventi caricati.
3. Puoi condividerlo via email, salvarlo su Drive o inviarlo tramite le app di condivisione di Android.

11 System Log

The Log screen shows the event history of the MeshCentral server: user logins, node access, configuration changes, KVM sessions, Magic Packet sends, and authentication errors. It is a valuable tool for auditing and diagnosing issues.

11.1 Viewing the Log

From the Dashboard, tap Log in the bottom bar. Events are shown in reverse chronological order (most recent at the top) with date/time, event type, user involved, and description.

11.2 Clearing the Local View

The Clear log button clears the current display on your device only. Events remain saved on the MeshCentral server and can be reloaded with the Refresh button.

11.3 Exporting the Log

1. Tap the Export button in the top right.
2. The app generates a text file with all currently loaded events.
3. You can share it via email, save it to Drive, or send it via Android's sharing apps.

12 Impostazioni

La schermata Impostazioni raggruppa tutte le preferenze dell'app. La apri toccando l'icona a forma di ingranaggio nella barra inferiore della Dashboard.

12.1 Servizio Heartbeat

Il servizio heartbeat è un processo in background che mantiene la connessione WebSocket attiva con il server MeshCentral anche quando l'app non è in primo piano. Serve per:

• Mantenere la lista dei nodi sempre aggiornata senza dover riaprire l'app.
• Evitare il re-login continuo se la sessione scade.
• Predisporre il dispositivo per le notifiche push (in arrivo in un aggiornamento futuro).

12.2 Notifiche push (in arrivo)

Le notifiche push saranno disponibili in un futuro aggiornamento. Ti permetteranno di ricevere avvisi direttamente sul telefono quando un nodo cambia stato, anche con l'app chiusa. La sezione dedicata nelle Impostazioni è già predisposta e si attiverà automaticamente al momento del rilascio.

12.3 Qualità streaming del Desktop Remoto

Uno slider tra 10% e 100% regola la qualità dei frame video durante una sessione KVM. Il valore predefinito è 75%, ottimo su smartphone moderni con Wi-Fi medio.

12.4 Informazioni sull'applicazione

In fondo alla schermata trovi la versione dell'app, il nome del pacchetto, la versione minima e target di Android, e le informazioni sulla licenza del software. Questi dati sono utili da riportare in caso di richiesta di supporto tecnico.

12 Settings

The Settings screen groups all app preferences. Open it by tapping the gear icon in the Dashboard's bottom bar.

12.1 Heartbeat Service

The heartbeat service is a background process that keeps the WebSocket connection to the MeshCentral server alive even when the app is not in the foreground. It is used to:

• Keep the node list up to date without needing to reopen the app.
• Avoid repeated re-logins when the session expires.
• Prepare the device to receive push notifications (coming in a future update).

12.2 Push Notifications (coming soon)

Push notifications will be available in a future update. They will let you receive alerts directly on your phone when a node changes state, even with the app closed. The dedicated section in Settings is already in place and will activate automatically upon release.

12.3 Remote Desktop Streaming Quality

A slider between 10% and 100% adjusts the video frame quality during a KVM session. The default value is 75%, excellent on modern smartphones with average Wi-Fi.

12.4 App Information

At the bottom of the screen you'll find the app version, package name, minimum and target Android version, and software license information. These details are useful to include when contacting technical support.

13 Lingua dell'applicazione

MeshControl Pro è disponibile in italiano ed inglese. Al primo avvio l'app usa automaticamente la lingua di sistema del telefono: italiano se Android è in italiano, inglese in tutti gli altri casi. Puoi comunque cambiarla in qualsiasi momento.

13.1 Cambiare lingua

1. Vai nelle Impostazioni dell'app.
2. Cerca la sezione Lingua.
3. Tocca il pulsante della lingua desiderata (IT o EN) nel selettore segmentato.
4. L'app si aggiorna immediatamente: non serve riavviarla.

13 App Language

MeshControl Pro is available in Italian and English. On first launch the app automatically uses the phone's system language: Italian if Android is in Italian, English in all other cases. You can change it at any time.

13.1 Changing the Language

1. Go to the app's Settings.
2. Find the Language section.
3. Tap the desired language button (IT or EN) in the segmented selector.
4. The app updates immediately — no restart required.

14 Domande frequenti e risoluzione problemi

14.1 Connessione e login

Non riesco a connettermi al server.
Apri il browser del telefono e prova a raggiungere lo stesso URL. Se anche il browser non si connette, il problema è di rete o il server è spento. Se il browser funziona ma l'app no, verifica di aver scritto l'URL esattamente con https://.

Errore certificato SSL.
Succede con i server che usano certificati autofirmati. Tocca Opzioni avanzate e attiva Ignora errori SSL. Usa questa opzione solo verso server di tua proprietà su reti fidate.

Il codice 2FA non viene accettato.
I codici TOTP cambiano ogni 30 secondi. Se inserisci un codice già scaduto, attendi il cambio nell'app di autenticazione e inserisci quello nuovo. Controlla anche che data e ora del telefono siano corrette.

14.2 Desktop Remoto (KVM)

La sessione KVM non parte o resta bloccata.
Verifica che il nodo sia online (pallino verde). Se lo è ma il KVM non parte, chiudi e riapri la sessione — a volte il server impiega qualche secondo a liberare una sessione precedente. Se persiste, controlla dal client web che il nodo abbia il modulo KVM abilitato nelle policy del mesh.

L'immagine è scattosa o in ritardo.
Abbassa la qualità streaming nelle Impostazioni (capitolo 13.3). Il KVM richiede almeno 2 Mbit/s stabili — su 3G/Edge la fluidità sarà limitata.

Non riesco a inviare certi caratteri speciali dalla tastiera.
Alcune combinazioni (lettere accentate) potrebbero non essere interpretate correttamente se il layout di tastiera del PC remoto è diverso. Usa la funzione Clipboard: copia il testo sul telefono e invialo via clipboard al PC remoto, poi incollalo lì.

14.3 File Explorer

Il caricamento di un file si blocca a metà.
Può dipendere dalla stabilità della connessione. Riprova da una rete più stabile. Per file molto grandi considera di dividerli in più parti o usare il client web su connessione wired.

Non trovo il file che ho appena scaricato.
Dopo il download l'app tenta di aprirlo automaticamente. Se l'anteprima si chiude, controlla l'app File del telefono nella cartella dei download recenti o nella cartella temporanea dell'app.

14.4 Licenza e abbonamento

L'app dice "Licenza non valida" pur avendo pagato.
Prova questi tre passaggi: 1) chiudi completamente l'app e riaprila; 2) verifica di avere una connessione Internet attiva; 3) controlla che l'ora del telefono sia corretta. Se il problema persiste, apri il Play Store → Abbonamenti e verifica che l'abbonamento a MeshControl Pro risulti attivo. Se è attivo ma l'app non lo rileva, contatta il supporto.

Come faccio a cambiare il metodo di pagamento?
I metodi di pagamento si gestiscono solo dal Google Play Store: vai su Play Store → icona profilo → Pagamenti e abbonamenti → Metodi di pagamento.

14.5 Altre domande

Posso usare più server MeshCentral con la stessa app?
Sì. Puoi collegarti a un server diverso ad ogni login: tutti vengono salvati nella lista dei server recenti, e passare da uno all'altro è solo questione di scegliere l'URL desiderato.

I miei dati sono al sicuro?
Le credenziali e i token di sessione sono salvati sul telefono con crittografia AES-256-GCM tramite EncryptedSharedPreferences. La connessione al server avviene sempre su canale TLS cifrato. Nuraghia Srl non vede né conserva le tue credenziali MeshCentral, né ha accesso ai tuoi nodi.

Funziona anche su tablet?
Sì. L'app si adatta automaticamente a schermi più grandi: su tablet l'esperienza con il KVM e il File Explorer è significativamente migliore grazie allo schermo più ampio.

14 FAQ & Troubleshooting

14.1 Connection and Login

I can't connect to the server.
Open your phone's browser and try to reach the same URL. If the browser can't connect either, the problem is network-related or the server is down. If the browser works but the app doesn't, make sure you've typed the URL exactly with https://.

SSL certificate error.
This happens with servers that use self-signed certificates. Tap Advanced options and enable Ignore SSL errors. Only use this option on servers you own over trusted networks.

The 2FA code is not accepted.
TOTP codes change every 30 seconds. If you enter a code that has just expired, wait for the refresh in your authenticator app and enter the new one. Also check that your phone's date and time are correct.

14.2 Remote Desktop (KVM)

The KVM session doesn't start or stays stuck.
Check that the node is online (green dot). If it is but KVM won't start, close and reopen the session — sometimes the server takes a few seconds to release a previous session. If it persists, check via the web client that the node has the KVM module enabled in the mesh policy.

The image is choppy or lagging.
Lower the streaming quality in Settings (chapter 13.3). KVM requires at least 2 Mbit/s stable — on 3G/Edge fluidity will be limited.

I can't type certain special characters.
Some character combinations (accented letters) may not be interpreted correctly if the remote PC's keyboard layout differs from your phone's. Use the Clipboard feature: copy the text on your phone and send it via clipboard to the remote PC, then paste it there.

14.3 File Explorer

A file upload gets stuck halfway.
This can be caused by an unstable connection. Try again from a more stable network. For very large files, consider splitting them into parts or using the web client over a wired connection.

I can't find the file I just downloaded.
After download, the app tries to open it automatically. If the preview closes, check your phone's Files app in the recent downloads folder or the app's temporary folder.

14.4 License and Subscription

The app says "Invalid license" even though I paid.
Try these three steps: 1) force-close the app and reopen it; 2) check that you have an active Internet connection; 3) verify your phone's time is correct. If the problem persists, open Play Store → Subscriptions and verify that the MeshControl Pro subscription shows as active. If it's active but the app doesn't recognise it, contact support.

How do I change my payment method?
Payment methods are managed exclusively from the Google Play Store: go to Play Store → profile icon → Payments & subscriptions → Payment methods.

14.5 Other Questions

Can I use multiple MeshCentral servers with the same app?
Yes. You can connect to a different server at each login — all of them are saved in the recent servers list, and switching is just a matter of selecting the desired URL.

Is my data safe?
Credentials and session tokens are stored on the phone with AES-256-GCM encryption via EncryptedSharedPreferences. The connection to the server always uses an encrypted TLS channel. Nuraghia Srl does not see or store your MeshCentral credentials, nor does it have access to your nodes.

Does it work on tablets too?
Yes. The app automatically adapts to larger screens — on a tablet the KVM and File Explorer experience is significantly better thanks to the larger display.

15 Glossario

• MeshCentralServer open source per la gestione remota di computer. Sviluppato da Ylian Saint-Hilaire. È il cuore dell'infrastruttura che MeshControl Pro permette di controllare da mobile.
• MeshAgentPiccolo software che si installa sui PC gestiti. Mantiene una connessione persistente con il server MeshCentral permettendo controllo remoto, trasferimento file ed esecuzione comandi.
• NodoUn computer o dispositivo registrato sul server MeshCentral (con il MeshAgent installato).
• Mesh / GruppoUn raggruppamento logico di nodi sul server MeshCentral. Utile per organizzare i computer per cliente, reparto o funzione.
• KVMKeyboard, Video, Mouse. Tecnologia che permette di vedere lo schermo di un PC remoto e controllarlo con tastiera e mouse.
• ConsoleInterfaccia a riga di comando di un sistema operativo. Su Windows è tipicamente PowerShell, su Linux una shell come bash.
• SSHSecure Shell. Protocollo standard per aprire una console sicura su un server remoto. Usa la porta 22 di default.
• TOTPTime-based One-Time Password. Codice di 6 cifre che cambia ogni 30 secondi, generato da app come Google Authenticator. Serve come secondo fattore di autenticazione.
• 2FATwo-Factor Authentication. Autenticazione a due fattori: oltre alla password serve un secondo elemento (tipicamente un TOTP) per accedere.
• MJPEGMotion JPEG. Tecnica usata nel KVM per trasmettere lo schermo remoto: una sequenza di immagini JPEG compresse.
• WebSocketProtocollo di comunicazione persistente tra client e server, su cui si basa tutta la comunicazione dell'app con MeshCentral.
• TunnelCanale cifrato tra l'app e un nodo, passando dal server MeshCentral. Usato per KVM, terminali e trasferimento file.
• Foreground ServiceServizio Android che può restare attivo in background mostrando una notifica persistente. Usato dall'app per mantenere la connessione al server.
• Intel AMTIntel Active Management Technology. Tecnologia hardware di gestione remota presente in alcuni processori Intel business. MeshCentral la supporta nativamente.

15 Glossary

• MeshCentralOpen-source server for remote computer management. Developed by Ylian Saint-Hilaire. It is the core infrastructure that MeshControl Pro allows you to manage from mobile.
• MeshAgentSmall software installed on managed PCs. Maintains a persistent connection with the MeshCentral server, enabling remote control, file transfer, and command execution.
• NodeA computer or device registered on the MeshCentral server (with MeshAgent installed).
• Mesh / GroupA logical grouping of nodes on the MeshCentral server. Useful for organising computers by client, department, or function.
• KVMKeyboard, Video, Mouse. Technology that allows viewing a remote PC's screen and controlling it with keyboard and mouse.
• ConsoleCommand-line interface of an operating system. On Windows this is typically PowerShell; on Linux a shell such as bash.
• SSHSecure Shell. Standard protocol for opening a secure console on a remote server. Uses port 22 by default.
• TOTPTime-based One-Time Password. A 6-digit code that changes every 30 seconds, generated by apps such as Google Authenticator. Used as a second authentication factor.
• 2FATwo-Factor Authentication. In addition to a password, a second element (typically a TOTP) is required to log in.
• MJPEGMotion JPEG. Technique used in KVM to transmit the remote screen: a sequence of compressed JPEG images.
• WebSocketPersistent communication protocol between client and server, on which all app-to-MeshCentral communication is based.
• TunnelEncrypted channel between the app and a node, routed through the MeshCentral server. Used for KVM, terminals, and file transfers.
• Foreground ServiceAndroid service that can remain active in the background while showing a persistent notification. Used by the app to maintain the server connection.
• Intel AMTIntel Active Management Technology. Hardware remote management technology present in some Intel business processors. Natively supported by MeshCentral.

17 Supporto e contatti

MeshControl Pro è sviluppato e mantenuto da Nuraghia Srl. Per qualsiasi richiesta di assistenza, suggerimento o segnalazione di problemi, puoi scriverci usando i canali indicati di seguito.

16.1 Canali di supporto

16.2 Come richiedere assistenza efficace

Per aiutarci a risolvere rapidamente il tuo problema, quando ci contatti includi:

• ✓ Numero ordine della ricevuta del Play Store
• ✓ Versione dell'app (Impostazioni → Informazioni)
• ✓ Modello del telefono e versione di Android
• ✓ Versione del server MeshCentral che stai usando
• ✓ Descrizione del problema con i passi per riprodurlo
• ✓ Eventuali screenshot o messaggi di errore visualizzati

16.3 Segnalazioni di sicurezza

Se pensi di aver scoperto una vulnerabilità di sicurezza, ti preghiamo di segnalarla in forma privata e confidenziale scrivendo a info@rhelpy.com. Ci impegniamo a rispondere il prima possibile.

16 Support & Contacts

MeshControl Pro is developed and maintained by Nuraghia Srl. For any support requests, suggestions, or issue reports, you can reach us through the channels listed below.

16.1 Support Channels

16.2 How to Request Effective Support

To help us resolve your issue quickly, when contacting us please include:

• ✓ Order number from the Play Store receipt
• ✓ App version (Settings → About)
• ✓ Phone model and Android version
• ✓ Version of the MeshCentral server you are using
• ✓ Description of the problem with steps to reproduce it
• ✓ Any screenshots or error messages shown

16.3 Security Reports

If you believe you have found a security vulnerability, please report it privately and confidentially by writing to info@rhelpy.com. We are committed to responding as quickly as possible.