Zum Hauptinhalt springen

Agon installieren

Diese Anleitung führt dich durch das Herunterladen und Installieren der Agon-Desktop-Anwendung auf deinem Computer. Nach der Installation schließt du den Einrichtungsassistenten ab, um dein Studio zu konfigurieren.

Systemanforderungen​

Die Agon-Desktop-App gibt es nur für macOS und Windows — es gibt keine Linux-Version.

Minimum
macOSmacOS 12 Monterey oder neuer
WindowsWindows 10 (64-Bit) oder neuer
RAM4 GB
Speicherplatz500 MB für die App; zusätzlicher Platz für deine Datenbank und Backups
InternetverbindungErforderlich für die Ersteinrichtung und damit Kunden sich aus der Ferne verbinden können

Schritt 1: Agon herunterladen​

Gehe zu agon-studio.dev und lade das Installationsprogramm für dein Betriebssystem herunter:

  • macOS: Lade die .dmg-Datei herunter
  • Windows: Lade das .exe-Installationsprogramm herunter

Schritt 2: Die Anwendung installieren​

Unter macOS:

  1. Öffne die heruntergeladene .dmg-Datei.
  2. Ziehe das Agon-Symbol in deinen Ordner Programme.
  3. Öffne Agon aus dem Ordner „Programme“. Wenn macOS meldet, dass die App nicht geöffnet werden kann, weil sie von einem nicht verifizierten Entwickler stammt, gehe zu Systemeinstellungen → Datenschutz & Sicherheit und klicke auf Trotzdem öffnen.

Unter Windows:

  1. Führe das heruntergeladene .exe-Installationsprogramm aus.
  2. Folge den Anweisungen auf dem Bildschirm.
  3. Agon wird deinem Startmenü und deinem Desktop hinzugefügt.

Schritt 3: Erster Start​

Wenn du Agon zum ersten Mal öffnest, startet der Einrichtungsassistent automatisch.

Der Assistent führt dich durch drei Schritte:

  1. Gib den Namen deines Studios, deine Zeitzone und deine Manager-Kontodaten ein
  2. Verbinde optional Stripe für Online-Zahlungen
  3. Fertig — sieh dir den QR-Code deines Studios an und speichere deinen einmaligen Wiederherstellungscode

Eine vollständige Anleitung zu jedem Schritt findest du unter Einrichtungsassistent.

Was im Hintergrund passiert​

Wenn Agon startet, geschieht automatisch Folgendes:

  • Es startet einen lokalen Server auf Port 8000 auf deinem Computer
  • Es stellt einen sicheren Cloudflare Tunnel her, damit Kunden sich von überall verbinden können
  • Es öffnet und verwaltet deine lokale Datenbank (deine Daten bleiben auf deiner Maschine)

Du musst nichts davon manuell konfigurieren.

Agon aktualisieren​

Agon sucht automatisch im Hintergrund nach Updates. Was dann passiert, hängt von deinem Betriebssystem ab:

  • Windows: Wenn ein Update verfügbar ist, erscheint ein Banner in der App. Klicke auf Update installieren, um es herunterzuladen und anzuwenden — die App startet neu und setzt dort fort, wo du aufgehört hast.
  • macOS: Wenn ein Update verfügbar ist, erscheint ein Banner mit einer Schaltfläche Herunterladen, die die Download-Seite in deinem Browser öffnet. Lade die neue Version herunter und installiere sie genauso wie beim ersten Mal.

Was tun, wenn etwas schiefgeht?​

Das Installationsprogramm schlägt fehl oder die App lässt sich nicht öffnen Stelle sicher, dass dein Betriebssystem die Mindestanforderungen erfüllt. Prüfe unter macOS die Systemeinstellungen → Datenschutz & Sicherheit auf eine Meldung über eine blockierte App. Versuche unter Windows, das Installationsprogramm als Administrator auszuführen.

Port 8000 ist bereits belegt Agon verwendet Port 8000 für seinen lokalen Server. Wenn eine andere Anwendung auf deinem Computer diesen Port nutzt, zeigt Agon beim Start einen Fehler an. Schließe die andere Anwendung und versuche es erneut.

Der Einrichtungsassistent erscheint beim ersten Start nicht Wenn Agon zuvor auf derselben Maschine installiert war, erscheint der Assistent möglicherweise nicht, weil die Einrichtung bereits abgeschlossen wurde. Installiere Agon neu, um von vorne zu beginnen.

Verwandte Seiten​