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
| Minimo | |
|---|---|
| macOS | macOS 12 Monterey o successivo |
| Windows | Windows 10 (64-bit) o successivo |
| Linux | Ubuntu 20.04 o equivalente (64-bit) |
| 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 alla pagina delle release di Agon su GitHub e scarica il programma di installazione per il tuo sistema operativo:
- macOS: scarica il file
.dmg - Windows: scarica il programma di installazione
.exe - Linux: scarica il file
.AppImageo.deb
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.
Su Linux:
- Se hai scaricato l'
.AppImage, rendilo eseguibile: tasto destro → Proprietà → Permessi → Consenti l'esecuzione come programma. Poi fai doppio click per avviarlo. - Se hai scaricato il
.deb, installalo con:sudo dpkg -i agon_*.deb
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 cinque passaggi:
- Inserisci le informazioni del tuo studio
- Crea il tuo account manager
- Configura la connettività internet (completamente automatica)
- Collega facoltativamente Stripe per i pagamenti online
- Scegli una posizione di backup
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 all'avvio. Quando un aggiornamento è disponibile, vedrai una notifica nell'app. Clicca Installa aggiornamento per scaricarlo e applicarlo. L'app si riavvia e riprende da dove avevi lasciato.
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.