Instalar Agon
Esta guía te lleva paso a paso por la descarga e instalación de la aplicación de escritorio Agon en tu ordenador. Una vez instalada, completarás el asistente de configuración para configurar tu estudio.
Requisitos del sistema
La app de escritorio de Agon solo está disponible para macOS y Windows — no existe una versión para Linux.
| Mínimo | |
|---|---|
| macOS | macOS 12 Monterey o posterior |
| Windows | Windows 10 (64 bits) o posterior |
| RAM | 4 GB |
| Espacio en disco | 500 MB para la aplicación; espacio adicional para tu base de datos y copias de seguridad |
| Conexión a internet | Necesaria para la configuración inicial y para que los clientes se conecten de forma remota |
Paso 1: Descargar Agon
Ve a agon-studio.dev y descarga el instalador para tu sistema operativo:
- macOS: descarga el archivo
.dmg - Windows: descarga el instalador
.exe
Paso 2: Instalar la aplicación
En macOS:
- Abre el archivo
.dmgdescargado. - Arrastra el icono de Agon a tu carpeta Aplicaciones.
- Abre Agon desde Aplicaciones. Si macOS indica que la aplicación no se puede abrir porque procede de un desarrollador no identificado, ve a Ajustes del Sistema → Privacidad y seguridad y haz clic en Abrir de todos modos.
En Windows:
- Ejecuta el instalador
.exedescargado. - Sigue las instrucciones en pantalla.
- Agon se añadirá a tu menú Inicio y al escritorio.
Paso 3: Primer inicio
Cuando abres Agon por primera vez, el asistente de configuración se inicia automáticamente.
El asistente te guía por tres pasos:
- Introduce el nombre de tu estudio, tu zona horaria y los datos de tu cuenta de manager
- Conecta Stripe para pagos online (opcional)
- Finalizar — ve el código QR de tu estudio y guarda tu código de recuperación de un solo uso
Consulta el Asistente de incorporación para una guía completa de cada paso.
Qué ocurre en segundo plano
Cuando Agon se inicia, automáticamente:
- Arranca un servidor local en el puerto 8000 de tu ordenador
- Establece un Cloudflare Tunnel seguro para que los clientes puedan conectarse desde cualquier lugar
- Abre y gestiona tu base de datos local (tus datos permanecen en tu máquina)
No necesitas configurar nada de esto manualmente.
Actualizar Agon
Agon comprueba automáticamente si hay actualizaciones en segundo plano. Lo que ocurre a continuación depende de tu sistema operativo:
- Windows: cuando hay una actualización disponible, aparece un banner en la aplicación. Haz clic en Instalar actualización para descargarla y aplicarla — la aplicación se reinicia y retoma donde lo dejaste.
- macOS: cuando hay una actualización disponible, aparece un banner con un botón Descargar que abre la página de descargas en tu navegador. Descarga la nueva versión e instálala igual que la primera vez.
¿Qué hacer si algo va mal?
El instalador falla o la aplicación no abre Asegúrate de que tu sistema operativo cumple los requisitos mínimos. En macOS, comprueba en Ajustes del Sistema → Privacidad y seguridad si aparece un mensaje de aplicación bloqueada. En Windows, prueba a ejecutar el instalador como Administrador.
El puerto 8000 ya está en uso Agon usa el puerto 8000 para su servidor local. Si otra aplicación de tu ordenador está usando este puerto, Agon mostrará un error al arrancar. Cierra la otra aplicación e inténtalo de nuevo.
El asistente de configuración no aparece en el primer inicio Si Agon ya se había instalado antes en la misma máquina, es posible que el asistente no aparezca porque la configuración ya se completó. Reinstala Agon desde cero para empezar de nuevo.