Documentazione

Primi passi con Termal OS.

Da zero a un desktop remoto via SSH in un paio di minuti.

Primi passi

Termal OS è un'applicazione desktop. Sui tuoi server non c'è nulla da installare: ci parla con una normale connessione SSH.

  1. Scarica Termal OS per la tua piattaforma ed esegui l'installer.
  2. Al primo avvio crei un account locale e accetti le condizioni; così viene preparata la tua cassaforte cifrata locale.
  3. Aggiungi il primo server (qui sotto) e sei operativo.
Le tue credenziali sono salvate cifrate sul tuo computer (AES-256-GCM). Nessun account cloud e nessun dato che esca dalla tua macchina.

Aggiungere un server

Clicca su Aggiungi un server e compila i dati di connessione:

  • Host e porta: per esempio server.esempio.it sulla 22.
  • Utente: il tuo utente SSH.
  • Autenticazione: password oppure chiave privata (PEM), con passphrase facoltativa.

Prima di salvare puoi verificare con Prova la connessione. Una volta collegato, Termal sonda il server e adatta l'interfaccia: distribuzione, server web, tipo di hosting (Infomaniak / Plesk / cPanel / standard), ambienti di esecuzione, database e Docker.

# A Termal serve soltanto un accesso SSH, come questo: ssh [email protected]

La dashboard

Ogni server si apre su una vista Sistema dal vivo, trasmessa in tempo reale via WebSocket:

  • CPU (complessiva e per core), carico medio, memoria e swap.
  • Dischi per punto di montaggio, traffico di rete, tempo di attività e processi più pesanti.
  • Cronologia con rilevamento delle anomalie (punteggio z) che segnala i picchi insoliti.

Le altre schede si adattano a quello che il server espone: Siti (siti ospitati, versione di PHP, git pull, statistiche di visita), Software, Servizi, Container (Docker, se c'è), Log (tail -F dal vivo), Terminale e Desktop.

Desktop remoto

La scheda Desktop apre un ambiente grafico completo sopra il filesystem remoto: gestore di finestre, barra delle applicazioni, menu di avvio e icone sul desktop. Tra le applicazioni integrate:

  • Esploratore: gestore di file SFTP — caricamento, download di cartelle come archivio, compressione ed estrazione, permessi, copia con una vera finestra di avanzamento.
  • Termal Code: un editor in stile VS Code (Monaco), con albero dei file e schede.
  • Terminale: una shell PTY vera.
  • Termal Browser: un browser con schede, segnalibri e strumenti per sviluppatori agganciati.
  • Monitor e gestore dei processi: risorse dal vivo e controllo delle attività.
  • Termal App Studio: crea le tue applicazioni Termal in HTML/JS, dal desktop stesso. Vedi la documentazione per sviluppatori.

Qualche dettaglio pensato per chi qui ci passa molte ore:

  • Palette dei comandi: premi ⌘/CtrlK per cercare e lanciare qualsiasi applicazione o azione del desktop.
  • Scorciatoie da tastiera: premi ? per l'elenco completo (cerca, rinomina, copia / taglia / incolla, sposta nel cestino…).
  • Staccare un desktop: porta il desktop di un server in una finestra a parte (il titolo mostra il nome del server) per tenere d'occhio due server in parallelo.
  • Trasferire tra server: trascina un file o una cartella da un desktop staccato a un altro e viene copiato tra i due server (l'originale resta dov'è).
  • Barra delle applicazioni: puoi metterla in alto o in basso, e nasconderla automaticamente se preferisci.

Avvisi e notifiche

Definisci le soglie per CPU, memoria e disco (allerta e criticità), scegli un intervallo di controllo e decidi dove vanno le notifiche:

  • Telegram, Slack, Discord, e-mail (SMTP) e webhook HTTP generici.
  • Gli avvisi in corso compaiono in un banner, con il registro degli eventi recenti.
  • Escalation quando un problema resta in stato critico, e soglie proprie per ogni server: ciascuno può usare i valori predefiniti o avere i suoi.
Un server viene segnato come offline solo dopo diversi controlli falliti di fila: un'interruzione di rete isolata non ti sveglierà.

Edizioni e licenza

Termal OS è gratis per un server, con desktop e monitoraggio completi. Per sbloccare più server, il copilota IA, l'API e le funzioni di team, collega il tuo account termalos.com da Impostazioni → Licenza; la licenza viene verificata online e messa in cache per l'uso offline (14 giorni di margine).

Il confronto completo è nella pagina dei prezzi.

Sicurezza

  • I segreti (password SSH, chiavi private) sono cifrati con AES-256-GCM tramite una chiave principale diversa per ogni installazione.
  • Una password dell'applicazione, facoltativa, protegge la dashboard dietro una schermata di blocco.
  • I percorsi dei log e i nomi di dominio vengono verificati prima di eseguire qualsiasi comando remoto.
Fai girare Termal in locale, sul tuo computer. Se un giorno ospiterai la versione web, mettila dietro un reverse proxy con autenticazione, e non perdere mai la tua chiave principale.

Vuoi scrivere le tue piccole applicazioni? Guarda l'SDK e gli esempi su GitHub → oppure la presentazione per sviluppatori.