Startseite
NexoPOS

Installationsverwaltung

Wie Kunden einen Tarif auswählen, eine Installation bereitstellen, Teams verwalten und jeden Standort über die Installationskonsole betreiben.

Primäre Benutzeroberfläche:

  • Preisgestaltung – öffentliche Marketingpläne
  • Dashboard → Installationen — Liste
  • Installationsdetails – tabbasierte Verwaltung (/dashboard/installations/{id}?tab=…)
installation

Plan-Auswahl & Checkout

  1. Preise durchsuchen (veröffentlichte Bundles + Marketingfunktionen).
  2. Starten Sie den Checkout für ein Bundle (und optionale Add-ons / einen Gutschein, falls angeboten).
  3. Zahlen Sie über das aktive Plattform-Gateway (Stripe Checkout, Paddle, Mollie, …) oder starten Sie eine Testphase, wenn das Bundle über trial_days verfügt.
  4. Bei Erfolg wechselt die Installation von „ausstehende Zahlung“ → „Bereitstellung“ → „läuft“ (Horizon-Worker + Host-Agent).

Screenshot-Platzhalter: Preisseite Screenshot-Platzhalter: Checkout-Übersicht (Bundle + Add-ons) Screenshot-Platzhalter: Zahlungsseite des Anbieters Screenshot-Platzhalter: Abrechnungserfolg / Bereitstellungsfortschritt

Wenn der Browser zurückkehrt, bevor der Webhook eintrifft, kann die Erfolgsseite die Sitzung über die Provider-API bestätigen, sodass die Zahlung trotzdem abgeschlossen wird.

Eine neue Installation bereitstellen

What happens
Choose organization (personal or team) with free installation seat
Select bundle (modules + limits snapshotted onto the install)
Complete checkout / trial
Agent creates Linux path layout, DB, nginx, NexoPOS files
Status running → open primary domain

Fehler werden in den Registerkarten „Installation“ und „Übersicht“ sowie „Aktivität“ angezeigt; Plattformadministratoren sehen außerdem „Ops/Logs“.

„Org max_installations“ blockiert zusätzliche Deployments, wenn das Limit erreicht ist.

installation-creation

Installationsverwaltung

Öffnen Sie eine Installation, um Horizontale Tabs zu erhalten. Die Abrechnungsfunktion hängt von der Rolle des Mitglieds ab (kann.abrechnung).

Screenshot-Platzhalter: Installationsüberschrift mit Statusbadge und Tab-Leiste

Überblick

  • Installationsstatus, primäre Domain, Bundle-Zusammenfassung.
  • Aktive Bereitstellungsoperationen mit Fortschrittsanzeige (Bereitstellung, Aktualisierung, Neuinstallation).
  • Module, die durch das Bundle bereitgestellt werden: Installieren/Aktualisieren, wenn Versionen verfügbar sind.
  • Kern-/Modul-Updates mit einem Klick, wenn die Plattform verfügbare Updates meldet (wartet einen Update-Job ein; Fortschritt in diesem Tab verfolgen).
  • Neu installieren: frisches Löschen oder Wiederherstellung aus einem ausgewählten Backup (gleiche Installationsidentität).
reinstall-installation

Einstellungen (Passwort des Mandantenadministrators)

  • Lokalisierungs-/Zeitzonen-Einstellungen für die Installation wurden offengelegt.
  • Setzen Sie die NexoPOS-Admin-Anmeldedaten (E-Mail/Passwort) über den Plattform-Agenten zurück.

Wichtig: Das Zurücksetzen des Passworts/der Admin-Zugangsdaten funktioniert nur, wenn die Anwendung installiert ist und ausgeführt wird. Es gelingt nicht in ausstehenden/bereitgestellten/fehlgeschlagenen Zuständen. Das neue Passwort wird in der Regel einmal in der Benutzeroberfläche angezeigt (Flash) – es wird nicht als Ersatz für SMTP per E-Mail gesendet.

change-user-password

Abrechnung (inkl. Verlängerung & Kündigung)

Es gibt keinen separaten Tab „Verlängerung“. Der Abonnementlebenszyklus befindet sich unter „Abrechnung“:

  • Aktueller Abonnementstatus, Laufzeit, Ende der Testphase.
  • Rechnungsliste.
  • Zahlung erneuern / fortsetzen, wenn sie überfällig ist oder eine Maßnahme erforderlich ist.
  • Verlängerung stornieren (Zugriff bis zum Ende des Abrechnungszeitraums gemäß den Produktregeln).
  • Rückerstattungsanfrage Verlauf / senden (siehe 
renewal-1

Domäne

  • Zeigt die kostenlose Plattform-Subdomain ({slug}.{base_domain}).
  • Benutzerdefinierte Domain wenn:
    • Der Domainmodus ist kostenlos, oder
    • Der Domain-Modus ist „Addon“ und die Installation verfügt über eine aktive Berechtigung für „Benutzerdefinierte Domains“, oder
    • Der Kunde kann in diesem Tab das veröffentlichte Add-on für die benutzerdefinierte Domain erwerben.

Ablauf: Hostname eingeben → DNS-Einträge erstellen (A/AAAA auf die öffentliche Plattform-IP sowie Challenge-Host zur Verifizierung wie angegeben) → Verifizieren (nginx + SSL). Tägliche Limits für verifizierte Änderungen können gelten.

custom-domain

Sicherungskopie

Sichtbar/nutzbar, wenn die Installation das Add-on „Backups“ hat (oder Kauf-CTA, wenn ein veröffentlichtes Add-on „Backups“ vorhanden ist).

  • Vollständiges manuelles oder nur datenbankbasiertes Backup.
  • Verlauf auflisten: wiederherstellen, herunterladen, löschen (gemäß Richtlinie).
  • Plattform-automatische Backups werden gemäß dem Admin-Zeitplan ausgeführt, wenn sie aktiviert sind; Kunden legen keinen Cron fest.
  • Beibehaltung: die letzten N erfolgreichen Backups (Admin → Backups → die letzten beibehalten).

Erfordert funktionierende Admin-S3-Konfiguration.

backup-1

Protokolle

Ruft Mieteranwendungsprotokolldateien zur Fehlerbehebung (Berechtigungen, App-Fehler) ohne SSH ab.

applciation-log

Aktivität

Prüfprotokoll im Stil eines Audits der von Mitgliedern der Organisation (und Systemaktionen, sofern protokolliert) auf dieser Installation durchgeführten Vorgänge: Bereitstellungen, Domänenänderungen, Backups, Zurücksetzungen von Anmeldeinformationen, Abrechnungsaktionen usw.

activity-account

Gängige Customer Journeys

Zahlung fehlgeschlagen

E-Mail-Benachrichtigung (falls SMTP) → Verlängerungsbanner / Register „Abrechnung“ → Zahlungsmethode aktualisieren → fortsetzen. Nach Ablauf der Kulanzfrist kann die Installation ausgesetzt werden (Offline-Seite gemäß den Admin-Einstellungen für die Aussetzung).

Stornierung vs. Erstattung

  • Verlängerung stornieren: bis zum Ende des Zeitraums weiter nutzen.
  • Erstattungsanfrage: Die Genehmigung durch den Administrator beendet die Installation schnell und plant eine schnellere endgültige Löschung.

Bedienungstipps

  • Horizon muss ausgeführt werden, sonst bleiben Installationen „in Bereitstellung“.
  • HOST_AGENT_LOCAL_REAL_CLONE=false verwendet einen schnellen Stub in Docker; setze true (oder verwende script auf dem VPS) für echte NexoPOS-Trees.
  • Domänen-/Backup-Tabs leer? Prüfen Sie die Katalog-Funktionsschlüssel und die Admin-Domänen-/S3-Einstellungen.
  • Passwortzurücksetzung fehlgeschlagen? Bestätigen Sie, dass der Status „läuft“.