Bereitstellung

So führen Sie NexoSaaS aus: Docker-Stack, Host-Reverse-Proxy, Basisdomäne und TLS.

Worauf Sie bereitstellen

Kundenseitige NexoPOS-Standorte sind keine separaten Compose-Dienste. Der Agent schreibt Dateien nach HOST_AGENT_HOME_BASE, und nginx bindet seine vhosts ein.

1. Docker-Installation

Voraussetzungen

• Docker Engine + Docker Compose v2
• Ports frei (Standard): 8080 (HTTP), 3307 (MySQL-Host), 6380 (Redis-Host)

Schritte

# From the repository root
cp deploy/.env.docker.example .env

# Optional: set a stable public URL early (production example)
# APP_URL=https://app.yourdomain.com
# APP_ENV=production
# APP_DEBUG=false

docker compose -f deploy/docker-compose.yml up -d --build

Einstiegspunkte erstellen typischerweise APP_KEY und führen Migrationen aus, wenn sie konfiguriert sind. Katalog-Seed + Standard-Admin einmalig bereitstellen:

docker compose -f deploy/docker-compose.yml exec app php artisan db:seed --force

Standardmäßig vorab befüllte Konten (nur für Entwicklung):

Öffnen Sie die Control-Plane: http://localhost:8080 (oder Ihre APP_URL).

Bereitschaft:

docker compose -f deploy/docker-compose.yml exec app php artisan platform:launch-check

Wichtige Umgebungsvariablen

Produkgeheimnisse (Stripe, SMTP, GitHub-PAT, S3, Domain-Richtlinie) sind „Admin → Einstellungen“ und nicht Laufzeitumgebungsvariablen.

Host-Agent-Modi

„Compose“ ist allein keine vollständige Geschichte über Multi-Tenant-Produktionsisolierung. Verwenden Sie „script“ auf einem VPS, wenn Sie eine Trennung der Mandanten auf Produktionsniveau benötigen.

2. Nginx vor dem Stack hosten

Empfohlene Produktionsform:

Internet
   │
   ▼
Host Nginx / Caddy  (TLS termination, :443)
   │  proxy_pass → 127.0.0.1:8080
   ▼
Compose nginx       (control plane + tenant includes)
   │
   ▼
Compose app (PHP-FPM) + tenant docroots on volume

Beispiel-Host Nginx (Control Plane)

Ersetzen Sie die Hostnamen und den Upstream-Port durch Ihre eigenen.

# /etc/nginx/sites-available/nexosaas-control.conf
server {
    listen 80;
    server_name app.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name app.yourdomain.com;

    # ssl_certificate     /etc/letsencrypt/live/app.yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/app.yourdomain.com/privkey.pem;

    client_max_body_size 64M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
    }
}

Set:

APP_URL=https://app.yourdomain.com

Laravel vertraut weitergeleiteten Headern, wenn es für Ihre Proxy-Konfiguration eingerichtet ist. Stellen Sie sicher, dass die App HTTPS korrekt erkennt, damit signierte URLs und Cookies sicher bleiben.

Screenshot-Platzhalter: Browser geöffnet für die Anmeldung in der Control-Plane unter Ihrer öffentlichen HTTPS-URL

Mieter-Hostnamen

• Docker / local agent: Tenant-Nginx-Konfigurationen werden unter {HOST_AGENT_HOME_BASE}/.platform/nginx-enabled/*.conf geschrieben und in das Compose-Nginx (deploy/docker/nginx/default.conf) eingebunden.
• Lokaler Browser: http://{install-subdomain}.localhost:8080 funktioniert oft ohne /etc/hosts.
• Produktion: DNS für *.base_domain (und benutzerdefinierte Domains) muss dieselbe Edge erreichen, die an den Platform-nginx weiterleiten kann (oder den vom Script-Agenten verwalteten VPS-nginx).

Wenn der Host-Reverse-Proxy nur app.yourdomain.com weiterleitet, müssen Tenant-Subdomains entweder:

• dieselbe Proxy-Konfiguration mit einem Platzhalter server_name / getrennte Serverblöcke oder
• Direkte Exposition der Plattform Nginx / agentverwalteter Vhosts.

Planen Sie DNS und TLS für Mandanten zusammen mit der Basisdomäne (nächster Abschnitt).

3. Basisdomäne

Installationen erhalten einen kostenlosen Plattform-Hostname:

{slug}.{base_domain}

Beispiel: Basisdomain saas.example.com → acme-store.saas.example.com.

Im Admin konfigurieren

1. Melden Sie sich als Plattformadministrator an (2FA außerhalb des lokalen Bereichs).
2. Öffnen Sie „Admin“ → „Einstellungen“ → „Domain“.
3. Set:

DNS

PLATFORM_BASE_DOMAIN in .env setzt nur den Admin-Wert bei leeren Einstellungen; zur Laufzeit wird Admin → Domain verwendet.

4. SSL / Let’s Encrypt

Steuerungsebene (Host-Reverse-Proxy)

Mit Certbot (Beispiel):

# After DNS for app.yourdomain.com points at the VPS
sudo certbot --nginx -d app.yourdomain.com
# or: certbot certonly --webroot ... then point ssl_certificate paths

Die Verwendung von Caddy ist oft einfacher (automatisches HTTPS); reverse_proxy zu 127.0.0.1:8080.

Mietbescheinigungen

Für die Bereitstellung und die Überprüfung der benutzerdefinierten Domain ist der Host-Agent für TLS für Tenant-Hostnamen zuständig (Let’s-Encrypt-ähnlicher Ablauf auf dem VPS-/Agent-Pfad).

Betreiber sollten:

1. Stellen Sie sicher, dass der VPS HTTP-01 (oder die vom Agenten gewählte Challenge) für Installationshostnamen abschließen kann.
2. Setzen Sie die maximalen Änderungen der verifizierten Domains pro Tag sinnvoll (Standard: 3), damit Kunden die LE-Rate-Limits nicht aufbrauchen.
3. Behalten Sie die öffentliche IPv4-Adresse genau bei, damit die DNS-Anweisungen, die Kunden sehen, korrekt sind.

Hinweis: Lokales Docker mit *.localhost benötigt für das tägliche UI-Testing kein öffentliches LE.

Zahlungs-Webhooks

Produktions-Gateways müssen HTTPS-Endpunkte erreichen, z. B.:

• https://app.yourdomain.com/webhooks/stripe
• https://app.yourdomain.com/webhooks/paddle
• https://app.yourdomain.com/webhooks/mollie

Richten Sie Signaturgeheimnisse unter „Admin → Einstellungen → Abrechnungseinstellungen“ ein.

5. Checkliste nach dem Deployment

Nützliche Befehle für den Betrieb (Ops)

# Shell into app
docker compose -f deploy/docker-compose.yml exec app bash

# Logs
docker compose -f deploy/docker-compose.yml logs -f app horizon nginx

# Rebuild frontend assets
docker compose -f deploy/docker-compose.yml run --rm -e DOCKER_FORCE_BUILD_ASSETS=true assets

# Wipe evaluation installs (keeps users/catalog/settings)
docker compose -f deploy/docker-compose.yml exec app \
  php artisan platform:reset-evaluation --force