Installare Agon
Questa guida ti accompagna nel download e nell'installazione dell'applicazione desktop Agon sul tuo computer. Una volta installata, completerai la procedura guidata di configurazione per impostare il tuo studio.
Requisiti di sistema
L'app desktop di Agon è disponibile solo per macOS e Windows — non esiste una versione Linux.
| Minimo | |
|---|---|
| macOS | macOS 12 Monterey o successivo |
| Windows | Windows 10 (64-bit) o successivo |
| RAM | 4 GB |
| Spazio su disco | 500 MB per l'app; spazio aggiuntivo per il database e i backup |
| Connessione Internet | Richiesta per la configurazione iniziale e per consentire ai clienti di collegarsi da remoto |
Passo 1: scarica Agon
Vai su agon-studio.dev e scarica il programma di installazione per il tuo sistema operativo:
- macOS: scarica il file
.dmg - Windows: scarica il programma di installazione
.exe
Passo 2: installa l'applicazione
Su macOS:
- Apri il file
.dmgscaricato. - Trascina l'icona di Agon nella cartella Applicazioni.
- Apri Agon da Applicazioni. Se macOS segnala che l'app non può essere aperta perché proviene da uno sviluppatore non identificato, vai su Impostazioni di Sistema → Privacy e Sicurezza e clicca Apri comunque.
Su Windows:
- Esegui il programma di installazione
.exescaricato. - Segui le istruzioni a schermo.
- Agon verrà aggiunto al menu Start e al desktop.
Passo 3: primo avvio
Quando apri Agon per la prima volta, la procedura guidata di configurazione si avvia automaticamente.
La procedura guidata ti accompagna in tre passaggi:
- Inserisci il nome del tuo studio, il fuso orario e i dati del tuo account manager
- Collega facoltativamente Stripe per i pagamenti online
- Fine — vedi il codice QR del tuo studio e salva il tuo codice di recupero monouso
Consulta Procedura guidata di configurazione per una guida completa a ogni passaggio.
Cosa succede in background
All'avvio, Agon automaticamente:
- Avvia un server locale sulla porta 8000 del tuo computer
- Stabilisce un Cloudflare Tunnel sicuro in modo che i clienti possano collegarsi da qualsiasi luogo
- Apre e gestisce il tuo database locale (i tuoi dati restano sulla tua macchina)
Non è necessario configurare nulla di tutto ciò manualmente.
Aggiornare Agon
Agon controlla automaticamente la presenza di aggiornamenti in background. Cosa succede dipende dal tuo sistema operativo:
- Windows: quando è disponibile un aggiornamento, appare un banner nell'app. Clicca Installa aggiornamento per scaricarlo e applicarlo — l'app si riavvia e riprende da dove avevi lasciato.
- macOS: quando è disponibile un aggiornamento, appare un banner con un pulsante Scarica che apre la pagina di download nel browser. Scarica la nuova versione e installala nello stesso modo in cui hai installato Agon la prima volta.
Cosa fare se qualcosa va storto?
Il programma di installazione fallisce o l'app non si apre Assicurati che il tuo sistema operativo soddisfi i requisiti minimi. Su macOS, controlla Impostazioni di Sistema → Privacy e Sicurezza per un messaggio di app bloccata. Su Windows, prova a eseguire il programma di installazione come Amministratore.
La porta 8000 è già in uso Agon usa la porta 8000 per il suo server locale. Se un'altra applicazione sul tuo computer sta usando questa porta, Agon mostrerà un errore all'avvio. Chiudi l'altra applicazione e riprova.
La procedura guidata non appare al primo avvio Se Agon era già stato installato sulla stessa macchina, la procedura guidata potrebbe non apparire perché la configurazione era già stata completata. Reinstalla Agon da zero per ricominciare.