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)Vedi lo schermo dei PC gestiti e controlli mouse e tastiera in tempo reale, anche chiedendo prima il consenso all'utente.
• 💻
  TerminaleApri la Shell dell'agent, la Console MeshCentral o una sessione SSH, tramite il server o diretta.
• 🔄
  Sessioni persistentiKVM e terminali restano aperti quando torni indietro e si riprendono con un tocco dalla pagina Sessioni.
• 📁
  File ExplorerSfogli, carichi, scarichi e organizzi i file sui computer remoti, anche durante una sessione KVM o terminale.
• ⚡
  Operazioni sul dispositivoWake-on-LAN, riavvio, spegnimento, sospensione e notifiche sul desktop del PC.
• 🔗
  Accesso ospiteCondividi un PC con un link a tempo, oppure apri gratis i link di invito ricevuti, senza account né licenza.
• 💬
  ChatContatto diretto in tempo reale con l'utente del PC durante l'assistenza.
• 🔔
  Notifiche pushEventi dei nodi, alert di sicurezza e messaggi chat anche con l'app chiusa, con profili, criticità, ore silenziose e snooze.
• 👥
  Utenti, gruppi e logSe hai i privilegi necessari, gestisci utenti e gruppi di dispositivi e consulti gli eventi del server.

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 segue 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 turns your smartphone or tablet into a full administration workstation for MeshCentral servers. Designed for IT technicians, sysadmins and network administrators, it lets you control the computers managed by your server directly from your mobile device, wherever you are.

What you can do with the app

• 🖥️
  Remote Desktop (KVM)See the screen of managed PCs and control mouse and keyboard in real time, optionally asking the user for consent first.
• 💻
  TerminalOpen the agent Shell, the MeshCentral Console or an SSH session, through the server or direct.
• 🔄
  Persistent sessionsKVM and terminals stay open when you go back and resume with one tap from the Sessions page.
• 📁
  File ExplorerBrowse, upload, download and organise files on remote computers, even during a KVM or terminal session.
• ⚡
  Device actionsWake-on-LAN, restart, shutdown, sleep and desktop notifications on the PC.
• 🔗
  Guest accessShare a PC with a time-limited link, or open invite links you receive for free, with no account or licence.
• 💬
  ChatDirect real-time contact with the PC's user during support.
• 🔔
  Push notificationsNode events, security alerts and chat messages even when the app is closed, with profiles, criticality, quiet hours and snooze.
• 👥
  Users, groups and logWith the right privileges, manage users and device groups and view server events.

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 need from 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: consigliata 1.1.0 o successiva.
• 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 la 2FA attiva, serve un'app TOTP (Google Authenticator, Authy, ecc.).

2.3 Abbonamento

MeshControl Pro è un prodotto commerciale distribuito da Nuraghia s.r.l.. Per usare l'app con il tuo server ti serve un abbonamento, che include 15 giorni di prova gratuita all'installazione. Vedi il capitolo 4 per i piani disponibili. La modalità ospite (capitolo 12) è gratuita e non richiede abbonamento.

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 later recommended.
• TLS certificate: valid (Let's Encrypt, commercial or corporate CA). Self-signed certificates are supported — see chapter 5.
• Access port: typically 443 (HTTPS); make sure 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 s.r.l.. To use the app with your server you need a subscription, which includes a 15-day free trial at installation. See chapter 4 for the available plans. Guest mode (chapter 12) is free and needs no subscription.

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 s.r.l..
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 15 giorni (vedi capitolo 4). Da qui puoi anche incollare un link di invito per la modalità ospite.
• Schermata di login: inserisci l'URL del tuo server MeshCentral, username e password per accedere (vedi capitolo 5).
• Elenco nodi: una volta autenticato vedi i dispositivi gestiti dal tuo server, divisi per gruppo (vedi capitolo 6).

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 s.r.l..
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.
• Licence screen: the app checks whether you have an active subscription or a trial period. On first installation, the 15-day free trial starts automatically (see chapter 4). From here you can also paste an invite link for guest mode.
• Login screen: enter your MeshCentral server URL, username and password (see chapter 5).
• Node list: once authenticated you see the devices managed by your server, grouped (see chapter 6).

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 an "Invalid licence" 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 collegarsi al tuo server. All'installazione ricevi automaticamente 15 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 Licence & Subscription

MeshControl Pro requires a subscription to connect to your server. Upon installation you automatically receive a 15-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 Licence States

4.3 How to Subscribe

1. On the licence 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 licence 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 l'indirizzo del tuo server MeshCentral e le credenziali con cui accedi abitualmente via web.

5.1 Campi principali

5.2 Accesso con impronta

Attiva Ricorda per impronta sotto i campi di login: dal login successivo ti basta toccare Accedi con impronta e appoggiare il dito, senza digitare la password.

5.3 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à 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.4 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.
• Ignora errori SSL (self-signed): attiva questa opzione solo se il tuo server usa un certificato autofirmato. La connessione resta cifrata.

5.5 Server salvati e pagina Server

I server a cui ti sei già collegato compaiono sotto il form di login: tocca una voce per precompilare l'URL. La pagina Server, nella barra inferiore (prima si trovava nelle Impostazioni), ha due schede:

• Panoramica: dati della connessione (indirizzo, utente, permessi, stato) e informazioni sul server: nome, dominio, porte HTTPS e di redirect, Intel AMT MPS, indirizzo agent, ora del server, scadenza del certificato con i giorni rimanenti, hash del certificato TLS e del certificato agent (copiabili) e funzioni attive.
• Console: invia comandi al server MeshCentral. Le scorciatoie help, info, versions e agentstats sono a portata di tocco; help elenca tutti i comandi disponibili.

5.6 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.7 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 on the web.

5.1 Main Fields

5.2 Fingerprint Sign-in

Turn on Remember with fingerprint below the login fields: from the next login you just tap Sign in with fingerprint and touch the sensor, without typing the password.

5.3 Two-Factor Authentication (2FA)

If your MeshCentral server has 2FA enabled for your account, after tapping Log in the app will also ask for 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.4 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 sign in directly.
• Ignore SSL errors (self-signed): enable this only if your server uses a self-signed certificate. The connection remains encrypted.

5.5 Saved Servers and Server Page

Servers you have already connected to appear below the login form: tap an entry to auto-fill the URL. The Server page, in the bottom bar (it used to be in Settings), has two tabs:

• Overview: connection details (address, user, permissions, status) and server information: name, domain, HTTPS and redirect ports, Intel AMT MPS, agent address, server time, certificate expiry with days remaining, TLS and agent certificate hashes (copyable) and enabled features.
• Console: send commands to the MeshCentral server. The help, info, versions and agentstats shortcuts are one tap away; help lists all available commands.

5.6 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 with the URL and key already filled in.

5.7 Common Login Issues

6 Nodi, gruppi e dettaglio dispositivo

Dopo il login atterri sull'elenco dei Nodi: tutti i dispositivi gestiti dal tuo server MeshCentral, divisi per gruppo e aggiornati in tempo reale.

6.1 L'elenco dei nodi

• Titolo: mostra il numero totale di nodi, ad esempio Nodi (137).
• Campana: apre le notifiche; il badge indica quante sono da leggere.
• Barra di ricerca: digita una parte del nome per filtrare l'elenco.
• Filtri: per Stato (Tutti, Online, Offline) e per Gruppo.
• Gruppi: i nodi sono raccolti per gruppo; tocca un gruppo per aprirlo o chiuderlo.
• Barra inferiore: porta alle altre sezioni dell'app, tra cui Utenti, Log, Server, Sessioni (con il badge delle sessioni aperte) e Impostazioni. Se le voci non entrano nello schermo, la barra scorre con il dito.

6.2 Gruppi dispositivi

La schermata Gruppi dispositivi mostra ogni gruppo con il numero di dispositivi online sul totale. In alto trovi i pulsanti per espandere o chiudere tutti i gruppi, aggiornare e creare un nuovo gruppo (+). Aprendo un gruppo vedi:

6.3 Dettaglio del dispositivo

Tocca un dispositivo per aprirne il Dettaglio nodo. Qui trovi:

• Intestazione: nome, stato (online/offline), gruppo, sistema operativo e descrizione del PC.
• Azioni: i pulsanti per aprire KVM, Console e File e, a seconda del dispositivo, Shell e SSH. Su Linux senza interfaccia grafica la Shell è la prima azione.
• Sessioni: le sessioni aperte su quel dispositivo, da riprendere con un tocco.
• Impostazioni nodo: User Consent (il consenso richiesto all'utente per le connessioni), Tags e la priorità delle Notifiche per quel nodo (Critico, Medio, Normale). Si modificano con la matita.
• Informazioni e Volumi: gruppo, sistema operativo, indirizzo IP e i dischi con lo spazio occupato e disponibile.
• Menu ⋮: Riavvia, Spegni, Sospendi, Invia notifica al PC, Condividi accesso e Accessi condivisi; per i dispositivi offline, Wake-on-LAN. Tutte descritte nel capitolo 11.

6.4 Disconnessione

Per disconnetterti usa la voce di logout. L'app ti chiederà conferma: toccando Disconnetti la sessione con il server viene chiusa, insieme a tutte le sessioni KVM e terminale aperte, e torni alla schermata di login. I server salvati non vengono cancellati.

6 Nodes, Groups & Device Detail

After login you land on the Nodes list: all the devices managed by your MeshCentral server, grouped and updated in real time.

6.1 The Node List

• Title: shows the total number of nodes, for example Nodes (137).
• Bell: opens notifications; the badge shows how many are unread.
• Search bar: type part of a name to filter the list.
• Filters: by Status (All, Online, Offline) and by Group.
• Groups: nodes are gathered by group; tap a group to expand or collapse it.
• Bottom bar: takes you to the other sections of the app, including Users, Log, Server, Sessions (with the open-sessions badge) and Settings. If the entries don't fit on screen, the bar scrolls with your finger.

6.2 Device Groups

The Device groups screen shows each group with the number of devices online out of the total. At the top you'll find buttons to expand or collapse all groups, refresh and create a new group (+). Opening a group you see:

6.3 Device Detail

Tap a device to open its Node detail page. Here you'll find:

• Header: name, status (online/offline), group, operating system and PC description.
• Actions: buttons to open KVM, Console and Files and, depending on the device, Shell and SSH. On headless Linux the Shell is the first action.
• Sessions: the sessions open on that device, resumed with one tap.
• Node settings: User Consent (the consent required from the user for connections), Tags and the Notifications priority for that node (Critical, Medium, Normal). Edit them with the pencil.
• Information and Volumes: group, operating system, IP address and the disks with used and free space.
• ⋮ menu: Restart, Shut down, Sleep, Send notification to PC, Share access and Shared access; for offline devices, Wake-on-LAN. All described in chapter 11.

6.4 Logging Out

To disconnect, use the logout entry. The app asks for confirmation — tapping Disconnect closes the session with the server, together with all open KVM and terminal sessions, and returns you to the login screen. Saved servers 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. Apri il dettaglio del dispositivo a cui vuoi collegarti (capitolo 6.3).
2. Tocca KVM.
3. Scegli Connetti per collegarti subito, oppure Chiedi la connessione per mostrare all'utente del PC una richiesta di consenso: la sessione parte solo se l'utente accetta.
4. Lo schermo del PC remoto appare adattato al tuo display, di solito in 2–5 secondi.

7.2 La barra del desktop remoto

7.3 Gesture per controllare il PC remoto

La tastiera virtuale si apre con l'icona della tastiera e si sovrappone al desktop remoto invece di ridurlo, così continui a vedere tutto lo schermo. Per nasconderla tocca di nuovo l'icona o premi Indietro.

7.4 Il menu ⋮: comandi e tasti speciali

7.5 Schermo intero

In modalità schermo intero il desktop remoto occupa tutto il display e restano visibili solo due pulsanti grandi: uno per la tastiera e uno per uscire. Anche il tasto Indietro di Android esce dallo schermo intero.

7.6 Caricare file durante la sessione

La voce Carica sul dispositivo del menu ⋮ ti permette di inviare file senza chiudere la sessione: scegli i file sul telefono, si apre il File Explorer del PC remoto per selezionare la cartella di destinazione e, al termine, torni alla sessione esattamente com'era. La funzione è disponibile solo se l'agent del PC supporta i file.

7.7 Tornare indietro e chiudere la sessione

Le sessioni KVM sono persistenti: se torni indietro con la freccia o con il tasto Indietro, la sessione resta aperta. Mentre è in sottofondo lo stream video va in pausa (nessun consumo di dati) e, quando rientri, lo schermo si aggiorna completamente. Ritrovi la sessione nel dettaglio del dispositivo o nella pagina Sessioni (capitolo 10).

Per chiudere davvero la sessione tocca l'icona Disconnetti nella barra. Il logout e la licenza non valida chiudono automaticamente tutte le sessioni.

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 mouse and keyboard directly from your Android device.

7.1 Starting a KVM Session

1. Open the detail page of the device you want to connect to (chapter 6.3).
2. Tap KVM.
3. Choose Connect to connect right away, or Ask for connection to show the PC's user a consent request: the session starts only if the user accepts.
4. The remote PC's screen appears scaled to your display, usually within 2–5 seconds.

7.2 The Remote Desktop Bar

7.3 Gestures for Remote Control

The virtual keyboard opens with the keyboard icon and overlays the remote desktop instead of shrinking it, so you keep seeing the whole screen. To hide it tap the icon again or press Back.

7.4 The ⋮ Menu: Commands and Special Keys

7.5 Full Screen

In full-screen mode the remote desktop fills the display and only two large buttons remain visible: one for the keyboard and one to exit. Android's Back button also exits full screen.

7.6 Uploading Files During the Session

The Upload to device item in the ⋮ menu lets you send files without closing the session: choose the files on your phone, the remote PC's File Explorer opens so you can pick the destination folder and, when done, you are back in the session exactly as you left it. Available only if the PC's agent supports files.

7.7 Going Back and Ending the Session

KVM sessions are persistent: if you go back with the arrow or the Back button, the session stays open. While it is in the background the video stream is paused (no data used) and, when you return, the screen is fully refreshed. You'll find the session on the device detail page or on the Sessions page (chapter 10).

To actually end the session, tap the Disconnect icon in the bar. Logging out or an invalid licence automatically closes all sessions.

8 Terminale: Shell, Console e SSH

MeshControl Pro integra diversi tipi di terminale, tutti con sfondo nero stile xterm e font a larghezza fissa. Si aprono dal dettaglio del dispositivo (capitolo 6.3).

8.1 Quale terminale scegliere

8.2 Shell e Console MeshCentral

1. Nel dettaglio del dispositivo tocca Shell o Console.
2. Dopo qualche secondo compare il prompt.
3. Digita i comandi nel campo in basso e tocca il pulsante di invio (freccia).

8.3 SSH tramite server

L'SSH tramite server usa il relay del server MeshCentral: la connessione passa dal server come le altre sessioni, quindi funziona anche se la porta SSH del dispositivo non è raggiungibile da Internet. Se per quel dispositivo sono configurate le credenziali, l'accesso è automatico.

8.4 SSH diretto

1. Nel dettaglio del dispositivo scegli SSH diretto.
2. Inserisci Host, Utente, Password e, se necessario, una Porta diversa dalla 22.
3. Tocca Connetti per aprire la sessione.

8.5 Tasti speciali nella barra del terminale

8.6 Sessioni persistenti e riconnessione

• Se torni indietro, il terminale resta aperto: rientrando ritrovi connessione e testo esattamente com'erano.
• Se la connessione cade, riaprendo la sessione l'app si riconnette mantenendo il testo precedente. La riga della console non ancora inviata non si perde.
• Per chiudere davvero il terminale usa la voce Chiudi sessione nel menu ⋮.
• La funzione Carica sul dispositivo è disponibile anche dal terminale, come nel KVM (capitolo 7.6).

8.7 Pulire il terminale

Il pulsante Pulisci terminale svuota l'output visualizzato senza chiudere la sessione — utile quando l'output è diventato troppo lungo. Equivale al comando clear (Linux) o cls (Windows).

8 Terminal: Shell, Console & SSH

MeshControl Pro includes several types of terminal, all with a black xterm-style background and fixed-width font. They open from the device detail page (chapter 6.3).

8.1 Which Terminal to Use

8.2 Shell and MeshCentral Console

1. On the device detail page tap Shell or Console.
2. The prompt appears after a few seconds.
3. Type commands in the field at the bottom and tap the send button (arrow).

8.3 SSH Through the Server

SSH through the server uses the MeshCentral server relay: the connection goes through the server like other sessions, so it works even if the device's SSH port is not reachable from the Internet. If credentials are configured for that device, login is automatic.

8.4 Direct SSH

1. On the device detail page choose Direct SSH.
2. Enter the Host, User, Password and, if needed, a Port other than 22.
3. Tap Connect to open the session.

8.5 Special Keys in the Terminal Bar

8.6 Persistent Sessions and Reconnection

• If you go back, the terminal stays open: when you return you find the connection and text exactly as they were.
• If the connection drops, reopening the session reconnects and keeps the previous text. A console line not yet sent is not lost.
• To actually close the terminal, use Close session in the ⋮ menu.
• Upload to device is also available from the terminal, as in KVM (chapter 7.6).

8.7 Clearing the Terminal

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

9 File Explorer remoto

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

9.1 Aprire il File Explorer

1. Apri il dettaglio del dispositivo (capitolo 6.3).
2. Tocca File.
3. Dopo qualche secondo appare la lista dei file della cartella 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 il file con l'applicazione appropriata.

9.4 Caricare un file

1. Naviga nella cartella remota di destinazione.
2. Tocca l'icona di caricamento (freccia verso l'alto) in alto a destra.
3. Si apre il selettore file di Android: scegli il file dalla galleria, dai download o da qualsiasi app di archiviazione.
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 e tocca Crea.

9.6 Eliminare file o cartelle

1. Tocca l'icona del cestino accanto al file o alla cartella.
2. Conferma nella finestra di sicurezza.

9 File Explorer

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

9.1 Opening the File Explorer

1. Open the device detail page (chapter 6.3).
2. Tap Files.
3. After a few seconds the root folder 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 opens the file with the appropriate Android app.

9.4 Uploading a File

1. Navigate to the target remote folder.
2. Tap the upload icon (up arrow) 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 and tap Create.

9.6 Deleting Files or Folders

1. Tap the trash icon next to the file or folder.
2. Confirm in the safety dialog.

10 La pagina Sessioni

La pagina Sessioni, nella barra inferiore, raccoglie in un solo posto tutto ciò che hai aperto o condiviso. Il badge accanto alla voce indica quante sessioni sono aperte.

10.1 Cosa contiene

10.2 Strumenti della pagina

• Barra di ricerca: filtra per nome del dispositivo o dell'ospite.
• Sezioni collassabili: chiudi le sezioni che non ti servono.
• Chiudi tutte: scegli se chiudere tutte le sessioni aperte oppure revocare tutti gli accessi condivisi.
• Apri un link di invito: incolla un link MeshCentral per entrare in modalità ospite (capitolo 12).

10 The Sessions Page

The Sessions page, in the bottom bar, gathers everything you have opened or shared in one place. The badge next to the entry shows how many sessions are open.

10.1 What It Contains

10.2 Page Tools

• Search bar: filter by device or guest name.
• Collapsible sections: collapse the sections you don't need.
• Close all: choose whether to close all open sessions or revoke all shared access.
• Open an invite link: paste a MeshCentral link to enter guest mode (chapter 12).

11 Operazioni sul dispositivo e condivisione

Le operazioni sul dispositivo si trovano nel menu ⋮ del dettaglio del dispositivo. Quelle disponibili dipendono dallo stato del PC (online o offline) e dai tuoi permessi.

11.1 Accensione con Wake-on-LAN

Il Wake-on-LAN accende un PC spento inviandogli un pacchetto speciale (Magic Packet). L'operazione è disponibile per i dispositivi offline e l'app mostra l'esito restituito dal server.

Perché funzioni:

• il Wake-on-LAN deve essere abilitato nel BIOS/UEFI del PC e sulla scheda di rete;
• deve esserci almeno un altro dispositivo online sulla stessa rete locale: è lui che inoltra il Magic Packet.

1. Apri il dettaglio del dispositivo spento e tocca ⋮.
2. Scegli Wake-on-LAN e conferma.
3. Attendi qualche decina di secondi: se il PC si accende, il suo pallino diventa verde.

11.2 Riavvio, spegnimento e sospensione

Per i dispositivi online il menu ⋮ offre Riavvia, Spegni e Sospendi. Ogni operazione chiede una conferma prima di essere eseguita.

11.3 Notifica sul desktop

Con Invia notifica al PC mandi un messaggio che compare sul desktop del PC remoto: utile per avvisare l'utente di un intervento o di un riavvio imminente.

11.4 Chat con l'utente

La chat ti permette di scrivere in tempo reale con l'utente del PC durante l'assistenza, senza bisogno di telefono o email. Si apre con l'icona della chat nella barra del desktop remoto; i messaggi in arrivo possono arrivarti anche come notifica. Non è disponibile in modalità ospite.

11.5 Condividere l'accesso con un link ospite

Puoi dare accesso temporaneo a un PC a una persona che non ha un account sul tuo server, ad esempio un collega o un tecnico esterno.

1. Nel menu ⋮ del dispositivo scegli Condividi accesso.
2. Indica il nome dell'ospite e scegli il tipo di accesso: desktop, desktop in sola visualizzazione, terminale, file o una combinazione.
3. Imposta la scadenza e scegli se chiedere il consenso dell'utente del PC.
4. Copia il link o condividilo direttamente con un'altra app.

Chi riceve il link può aprirlo gratuitamente con MeshControl Pro in modalità ospite (capitolo 12) o con il browser.

11.6 Elenco e revoca degli accessi condivisi

La voce Accessi condivisi del menu ⋮ mostra gli accessi condivisi di quel PC, ognuno con il comando per revocarlo. L'elenco completo di tutti i dispositivi è nella pagina Sessioni (capitolo 10).

11.7 Invitare un nuovo PC (link invito agent)

Dalla schermata dei gruppi, il pulsante Invita Agent crea un link che permette di installare l'agent MeshCentral su un nuovo PC e aggiungerlo direttamente a quel gruppo. Invia il link all'utente del PC: aprendolo potrà scaricare e installare l'agent.

11 Device Actions & Sharing

Device actions are in the ⋮ menu of the device detail page. Which ones are available depends on the PC's state (online or offline) and on your permissions.

11.1 Power-On with Wake-on-LAN

Wake-on-LAN turns on a switched-off PC by sending it a special packet (Magic Packet). It is available for offline devices and the app shows the result returned by the server.

For it to work:

• Wake-on-LAN must be enabled in the PC's BIOS/UEFI and on its network card;
• at least one other device must be online on the same local network: it forwards the Magic Packet.

1. Open the detail page of the switched-off device and tap ⋮.
2. Choose Wake-on-LAN and confirm.
3. Wait a few tens of seconds: if the PC turns on, its dot turns green.

11.2 Restart, Shutdown and Sleep

For online devices the ⋮ menu offers Restart, Shut down and Sleep. Each action asks for confirmation before it runs.

11.3 Desktop Notification

Send notification to PC sends a message that appears on the remote PC's desktop: useful to warn the user about an intervention or an upcoming restart.

11.4 Chat with the User

Chat lets you write in real time with the PC's user during support, without phone or email. It opens from the chat icon in the remote desktop bar; incoming messages can also reach you as notifications. It is not available in guest mode.

11.5 Sharing Access with a Guest Link

You can give temporary access to a PC to someone who has no account on your server, such as a colleague or an external technician.

1. In the device's ⋮ menu choose Share access.
2. Enter the guest's name and choose the access type: desktop, view-only desktop, terminal, files or a combination.
3. Set the expiry and choose whether to ask for the PC user's consent.
4. Copy the link or share it directly with another app.

Whoever receives the link can open it for free with MeshControl Pro in guest mode (chapter 12) or with a browser.

11.6 Listing and Revoking Shared Access

The Shared access item in the ⋮ menu lists that PC's shared access, each with a revoke command. The full list for all devices is on the Sessions page (chapter 10).

11.7 Inviting a New PC (agent invite link)

From the groups screen, the Invite Agent button creates a link to install the MeshCentral agent on a new PC and add it straight to that group. Send the link to the PC's user: opening it, they can download and install the agent.

12 Modalità ospite

La modalità ospite ti permette di aprire i link di invito MeshCentral (del tipo …/sharing?c=…) senza account e senza licenza. È gratuita: chi riceve un link di condivisione può usare MeshControl Pro anche senza abbonamento.

12.1 Come aprire un link di invito

• Condividi il link con MeshControl Pro da qualsiasi app (email, messaggi, browser);
• oppure incollalo dalla schermata Licenza, dal Login o dalla pagina Sessioni (pulsante Apri un link di invito).

Nella schermata Modalità ospite incolla il link nel campo Link di invito (l'icona a destra incolla dagli appunti) e tocca Apri il desktop remoto. L'accesso resta valido fino alla scadenza stabilita da chi ha condiviso il dispositivo, che può revocarlo in qualsiasi momento.

Prima del collegamento l'app mostra il server di destinazione: controlla che sia quello che ti aspetti, poi conferma.

12.2 Cosa puoi fare

Accedi al desktop remoto del PC condiviso, anche in sola visualizzazione, secondo i permessi scelti da chi ha creato il link. La chat non è disponibile in modalità ospite.

12.3 Sicurezza della modalità ospite

• I link vengono aperti solo in https: un link http viene convertito in https e, se il server non supporta HTTPS, l'app mostra un messaggio chiaro.
• Nessun redirect e nessuna apertura automatica da altre app: serve sempre la tua conferma.
• Con un certificato non valido l'app mostra un avviso con l'impronta SHA-256 e chiede una conferma esplicita.
• I certificati accettati in modalità ospite sono separati da quelli del login e non valgono mai per i server salvati. Un certificato diverso da quello di un server salvato blocca l'accesso.
• Il cookie ospite resta solo in memoria e viene cancellato all'uscita. La schermata del link è protetta da screenshot.
• Nessun dato passa dalla sessione dell'utente eventualmente loggato.

12 Guest Mode

Guest mode lets you open MeshCentral invite links (like …/sharing?c=…) without an account and without a licence. It is free: anyone who receives a sharing link can use MeshControl Pro even without a subscription.

12.1 How to Open an Invite Link

• Share the link with MeshControl Pro from any app (email, messages, browser);
• or paste it from the Licence screen, the Login screen or the Sessions page (Open an invite link button).

On the Guest mode screen paste the link into the Invite link field (the icon on the right pastes from the clipboard) and tap Open remote desktop. Access stays valid until the expiry set by whoever shared the device, who can revoke it at any time.

Before connecting, the app shows the destination server: check that it's the one you expect, then confirm.

12.2 What You Can Do

You access the shared PC's remote desktop, view-only too, according to the permissions chosen by whoever created the link. Chat is not available in guest mode.

12.3 Guest Mode Security

• Links are opened over https only: an http link is converted to https and, if the server doesn't support HTTPS, the app shows a clear message.
• No redirects and no automatic opening from other apps: your confirmation is always required.
• With an invalid certificate the app shows a warning with the SHA-256 fingerprint and asks for explicit confirmation.
• Certificates accepted in guest mode are kept separate from login certificates and never apply to saved servers. A certificate that differs from a saved server's blocks access.
• The guest cookie is kept in memory only and deleted on exit. The link screen is protected from screenshots.
• No data passes from the session of any logged-in user.

13 Gestione utenti e gruppi (solo admin)

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

13.1 Accedere alla gestione utenti

Dalla barra inferiore tocca Utenti. Si apre Gestione utenti, con il numero di utenti, la ricerca e i pulsanti Utenti / Gruppi in basso per passare ai gruppi utenti. Per ogni utente vedi nome, email e ultimo accesso; le icone indicano la 2FA attiva e l'account bloccato, l'etichetta Admin gli amministratori.

Tocca un utente per aprirne il dettaglio: ID, nome, email, ruolo, 2FA, data di creazione e ultimo accesso, i gruppi utenti e i gruppi di dispositivi a cui appartiene e i dispositivi a cui ha accesso. La matita in alto permette di modificarlo.

13.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, attiva l'interruttore Amministratore.
4. Tocca Aggiungi: l'utente viene creato e appare subito nella lista.

13.3 Eliminare un utente

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

13.4 Gruppi utenti

Con il pulsante Gruppi passi ai Gruppi utenti: ogni gruppo mostra il nome, il tipo e il numero di membri. Tocca un gruppo per vederne i membri; l'icona in alto a destra crea un nuovo gruppo.

13.5 Gestire i gruppi di dispositivi

• Creare un gruppo: nella schermata Gruppi dispositivi tocca + in alto a destra.
• Rinominare o eliminare: apri il gruppo e usa Modifica o Elimina.
• Aggiungere PC: usa Invita Agent (capitolo 11.7).

13 User & Group Management (admins only)

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

13.1 Accessing User Management

From the bottom bar tap Users. User management opens, with the number of users, search and the Users / Groups buttons at the bottom to switch to user groups. For each user you see name, email and last login; icons show 2FA enabled and a locked account, the Admin label marks administrators.

Tap a user to open their detail page: ID, name, email, role, 2FA, creation date and last login, the user groups and device groups they belong to and the devices they can access. The pencil at the top lets you edit them.

13.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. To make this user an administrator, enable the Administrator toggle.
4. Tap Add — the user is created and appears in the list immediately.

13.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.

13.4 User Groups

The Groups button switches to User groups: each group shows its name, type and number of members. Tap a group to see its members; the icon in the top right creates a new group.

13.5 Managing Device Groups

• Create a group: on the Device groups screen tap + in the top right.
• Rename or delete: open the group and use Edit or Delete.
• Add PCs: use Invite Agent (chapter 11.7).

14 Log di sistema

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

14.1 Consultare i log

Dalla barra inferiore tocca Log. Si apre Log di sistema con il numero di eventi. Gli eventi sono in ordine cronologico inverso (più recenti in cima), ognuno con un'etichetta di tipo (LOGIN, LOGOUT, NODE, KVM…), descrizione, utente o dispositivo coinvolto, indirizzo IP e data/ora.

• Le schede in alto filtrano per tipo: Tutti, Login, Logout, Nodi e altre.
• La barra di ricerca cerca nel testo dei log.

14.2 Pulire la vista locale

L'icona del cestino in alto a destra svuota la visualizzazione corrente solo sul tuo dispositivo. Gli eventi restano salvati sul server MeshCentral e possono essere ricaricati con l'icona Aggiorna.

14 System Log

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

14.1 Viewing the Log

From the bottom bar tap Log. System log opens with the number of events. Events are in reverse chronological order (most recent at the top), each with a type label (LOGIN, LOGOUT, NODE, KVM…), description, user or device involved, IP address and date/time.

• The tabs at the top filter by type: All, Login, Logout, Nodes and more.
• The search bar searches the log text.

14.2 Clearing the Local View

The trash icon in the top right clears the current display on your device only. Events remain saved on the MeshCentral server and can be reloaded with the Refresh icon.

15 Impostazioni e notifiche

La schermata Impostazioni, nella barra inferiore, raggruppa le preferenze dell'app. La gestione dei server si trova ora nella pagina Server (capitolo 5.5).

15.1 Tema

In Aspetto dell'app scegli Sistema (segue il tema del telefono), Chiaro o Scuro.

15.2 Lingua

MeshControl Pro è disponibile in italiano e inglese. Al primo avvio usa la lingua di sistema del telefono: italiano se Android è in italiano, inglese negli altri casi. Per cambiarla, scegli la lingua dal menu a tendina Lingua dell'app: l'app si aggiorna subito, senza riavvio.

15.3 Notifiche

L'interruttore Notifiche eventi attiva le notifiche push per eventi dei nodi, alert di sicurezza e messaggi chat, anche con l'app chiusa. Per riceverle concedi anche il permesso Notifiche di Android (dalla versione 13 in poi). Puoi poi regolarle per gruppo (capitolo 6.2) o per singolo nodo (capitolo 6.3).

Personalizzazione notifiche raccoglie le opzioni avanzate:

15.4 Schermo sempre acceso

Mantiene lo schermo del telefono acceso mentre l'app è in primo piano: utile durante gli interventi lunghi in KVM o nel terminale.

15.5 Blocco app

• Blocco app: chiede impronta o PIN del telefono quando torni nell'app dopo 5 minuti in background.
• Blocca screenshot nelle schermate sensibili: impedisce screenshot, registrazione dello schermo e anteprima nelle app recenti in shell, KVM, login e configurazione della 2FA.

15.6 Licenza e informazioni

La sezione Licenza mostra lo stato della licenza e l'ID dispositivo, che puoi copiare e indicare quando chiedi assistenza. In Informazioni trovi la versione dell'app e gli altri dati tecnici utili al supporto.

15 Settings & Notifications

The Settings screen, in the bottom bar, groups the app's preferences. Server management is now on the Server page (chapter 5.5).

15.1 Theme

Under App appearance choose System (follows the phone's theme), Light or Dark.

15.2 Language

MeshControl Pro is available in Italian and English. On first launch it uses the phone's system language: Italian if Android is in Italian, English otherwise. To change it, pick the language from the App language drop-down: the app updates immediately, no restart needed.

15.3 Notifications

The Event notifications switch enables push notifications for node events, security alerts and chat messages, even with the app closed. To receive them, also grant Android's Notifications permission (from version 13 onwards). You can then tune them per group (chapter 6.2) or per node (chapter 6.3).

Notification customisation gathers the advanced options:

15.4 Screen Always On

Keeps the phone screen on while the app is in the foreground: useful during long KVM or terminal interventions.

15.5 App Lock

• App lock: asks for the phone's fingerprint or PIN when you return to the app after 5 minutes in the background.
• Block screenshots on sensitive screens: prevents screenshots, screen recording and recent-apps previews in shell, KVM, login and 2FA setup.

15.6 Licence and Information

The Licence section shows the licence status and the device ID, which you can copy and include when asking for support. Information shows the app version and other technical details useful for support.

16 Domande frequenti e risoluzione problemi

16.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.

16.2 Desktop Remoto e sessioni

La sessione KVM non parte o resta bloccata.
Verifica che il dispositivo sia online (pallino verde). Se lo è ma il KVM non parte, chiudi la sessione con Disconnetti e riaprila. Se il problema persiste, controlla dal client web che il desktop remoto sia abilitato nelle policy del gruppo.

L'immagine è scattosa o in ritardo.
Il KVM richiede almeno 2 Mbit/s stabili: su reti lente la fluidità sarà limitata. Prova una rete più veloce o avvicinati al Wi-Fi; per i comandi rapidi usa la Shell, che richiede pochissima banda.

Sono tornato indietro: la sessione è chiusa?
No. KVM e terminali restano aperti e li riprendi dalla pagina Sessioni o dal dettaglio del dispositivo. Per chiuderli usa Disconnetti (icona nella barra del KVM) o Chiudi sessione (terminale).

Non riesco a inviare certi caratteri speciali.
Alcuni caratteri (come le lettere accentate) potrebbero non essere interpretati correttamente se il layout di tastiera del PC remoto è diverso. Copia il testo sul telefono e usa Incolla testo dal menu ⋮ del desktop remoto.

Non ricevo le notifiche.
Controlla che in Impostazioni sia attivo Notifiche eventi e che Android consenta le notifiche all'app. Verifica poi il profilo attivo (con Off o Solo critici molte notifiche non arrivano) e che il nodo o il suo gruppo non siano silenziati. Se le notifiche arrivano in ritardo, escludi l'app dall'ottimizzazione della batteria.

16.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 valuta di dividerli in più parti o di usare il client web su una connessione cablata.

Non trovo il file che ho appena scaricato.
Dopo il download l'app prova ad aprirlo automaticamente. Se l'anteprima si chiude, cerca il file con l'app File del telefono nei download recenti o nella cartella temporanea dell'app.

16.4 Licenza, abbonamento e modalità ospite

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 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 cambio il metodo di pagamento?
I metodi di pagamento si gestiscono solo dal Google Play Store: Play Store → icona profilo → Pagamenti e abbonamenti → Metodi di pagamento.

Ho ricevuto un link di invito: mi serve l'abbonamento?
No. I link di invito MeshCentral si aprono gratis in modalità ospite, senza account né licenza (capitolo 12).

16.5 Altre domande

Posso usare più server MeshCentral con la stessa app?
Sì. Tutti i server a cui ti colleghi vengono salvati e li gestisci dalla pagina Server: passare da uno all'altro richiede un tocco.

I miei dati sono al sicuro?
Le credenziali e i token di sessione sono salvati sul telefono con crittografia AES-256-GCM. La connessione al server avviene sempre su un canale TLS cifrato. Nuraghia s.r.l. non vede né conserva le tue credenziali MeshCentral e non ha accesso ai tuoi dispositivi: al nostro server arriva solo la verifica della licenza.

Funziona anche su tablet?
Sì. L'app si adatta agli schermi più grandi: su tablet l'esperienza con il KVM e il File Explorer è ancora migliore.

16 FAQ & Troubleshooting

16.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.

16.2 Remote Desktop and Sessions

The KVM session doesn't start or gets stuck.
Check that the device is online (green dot). If it is but KVM won't start, end the session with Disconnect and open it again. If the problem persists, check in the web client that remote desktop is enabled in the group's policy.

The image is choppy or lagging.
KVM needs at least 2 Mbit/s stable: on slow networks fluidity will be limited. Try a faster network or move closer to the Wi-Fi; for quick commands use the Shell, which needs very little bandwidth.

I went back: is the session closed?
No. KVM and terminals stay open and you resume them from the Sessions page or the device detail page. To close them use Disconnect (icon in the KVM bar) or Close session (terminal).

I can't type certain special characters.
Some characters (such as accented letters) may not be interpreted correctly if the remote PC's keyboard layout differs. Copy the text on your phone and use Paste text from the remote desktop's ⋮ menu.

I don't receive notifications.
Check that Event notifications is on in Settings and that Android allows notifications for the app. Then check the active profile (with Off or Critical only many notifications won't arrive) and that the node or its group isn't silenced. If notifications arrive late, exclude the app from battery optimisation.

16.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, look for the file with your phone's Files app in recent downloads or in the app's temporary folder.

16.4 Licence, Subscription and Guest Mode

The app says "Invalid licence" 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 check that the MeshControl Pro subscription is 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 only from the Google Play Store: Play Store → profile icon → Payments & subscriptions → Payment methods.

I received an invite link: do I need a subscription?
No. MeshCentral invite links open for free in guest mode, with no account or licence (chapter 12).

16.5 Other Questions

Can I use multiple MeshCentral servers with the same app?
Yes. Every server you connect to is saved and you manage them from the Server page: switching takes one tap.

Is my data safe?
Credentials and session tokens are stored on the phone with AES-256-GCM encryption. The connection to the server always uses an encrypted TLS channel. Nuraghia s.r.l. does not see or store your MeshCentral credentials and has no access to your devices: our server only receives the licence check.

Does it work on tablets too?
Yes. The app adapts to larger screens: on a tablet the KVM and File Explorer experience is even better.

17 Glossario

• MeshCentralServer open source per la gestione remota di computer, sviluppato da Ylian Saint-Hilaire. È l'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 di comandi.
• Nodo / DispositivoUn computer o dispositivo registrato sul server MeshCentral (con il MeshAgent installato).
• Mesh / GruppoUn raggruppamento logico di dispositivi sul server MeshCentral, utile per organizzarli 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.
• Shell / ConsoleInterfacce a riga di comando. La Shell è il terminale del sistema operativo del PC; la Console MeshCentral è la console dei comandi dell'agent.
• SSHSecure Shell. Protocollo standard per aprire una console sicura su un server remoto. Usa la porta 22 di default.
• Sessione persistenteUna sessione KVM o terminale che resta aperta quando torni indietro nell'app e si riprende dalla pagina Sessioni.
• Link ospiteLink a tempo creato su un dispositivo per dare accesso a chi non ha un account sul server. Si apre in modalità ospite, senza licenza.
• Wake-on-LAN / Magic PacketFunzione di rete che accende un PC spento inviandogli un pacchetto speciale (Magic Packet).
• Security CenterComponente di Windows che riporta lo stato di antivirus, firewall e aggiornamenti (indicatori AV, FW, Up).
• 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).
• WebSocketProtocollo di comunicazione persistente tra client e server, su cui si basa la comunicazione dell'app con MeshCentral.
• Tunnel / RelayCanale cifrato tra l'app e un dispositivo che passa dal server MeshCentral. Usato per KVM, terminali, SSH tramite server e trasferimento file.
• CriticitàLivello di importanza (Critico, Medio, Normale) assegnato a un nodo, a un gruppo o a un tag, che decide quali notifiche ricevi.
• Profilo notificheInsieme di regole che stabilisce quali livelli di criticità notificare e quando (ore silenziose, snooze).
• TagEtichetta libera assegnata a un nodo per raggrupparlo e filtrarlo, anche nella gestione delle notifiche.
• Intel AMTIntel Active Management Technology. Tecnologia hardware di gestione remota presente in alcuni processori Intel business, supportata da MeshCentral.

17 Glossary

• MeshCentralOpen-source server for remote computer management, developed by Ylian Saint-Hilaire. It is the infrastructure that MeshControl Pro lets you manage from mobile.
• MeshAgentSmall software installed on managed PCs. Keeps a persistent connection with the MeshCentral server, enabling remote control, file transfer and command execution.
• Node / DeviceA computer or device registered on the MeshCentral server (with MeshAgent installed).
• Mesh / GroupA logical grouping of devices on the MeshCentral server, useful to organise them by client, department or function.
• KVMKeyboard, Video, Mouse. Technology that lets you see a remote PC's screen and control it with keyboard and mouse.
• Shell / ConsoleCommand-line interfaces. The Shell is the PC's operating-system terminal; the MeshCentral Console is the agent's command console.
• SSHSecure Shell. Standard protocol for opening a secure console on a remote server. Uses port 22 by default.
• Persistent sessionA KVM or terminal session that stays open when you go back in the app and resumes from the Sessions page.
• Guest linkTime-limited link created on a device to give access to someone without an account on the server. Opens in guest mode, with no licence.
• Wake-on-LAN / Magic PacketNetwork feature that turns on a switched-off PC by sending it a special packet (Magic Packet).
• Security CenterWindows component that reports antivirus, firewall and update status (AV, FW, Up indicators).
• 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.
• WebSocketPersistent communication protocol between client and server, on which the app's communication with MeshCentral is based.
• Tunnel / RelayEncrypted channel between the app and a device, routed through the MeshCentral server. Used for KVM, terminals, SSH through the server and file transfers.
• CriticalityImportance level (Critical, Medium, Normal) assigned to a node, group or tag, which decides which notifications you receive.
• Notification profileSet of rules defining which criticality levels to notify and when (quiet hours, snooze).
• TagFree label assigned to a node to group and filter it, including in notification management.
• Intel AMTIntel Active Management Technology. Hardware remote management technology in some Intel business processors, supported by MeshCentral.

18 Supporto e contatti

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

18.1 Canali di supporto

18.2 Come richiedere assistenza efficace

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

• ✓ Numero d'ordine della ricevuta del Play Store
• ✓ Versione dell'app (Impostazioni → Informazioni) e ID dispositivo (Impostazioni → Licenza)
• ✓ 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

18.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.

18 Support & Contacts

MeshControl Pro is developed and maintained by Nuraghia s.r.l.. For any support request, suggestion or issue report, you can reach us through the channels below.

18.1 Support Channels

18.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 → Information) and device ID (Settings → Licence)
• ✓ 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

18.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.