النشر عبر Docker® Compose وخدمة Windows® (دون Docker®) وLinux® وNAS وProxmox® وكبار مزودي الاستضافة

# === Linux (Debian / Ubuntu / RHEL) & macOS - Interaktiver Installer & Updater (v1.0.0) ===
curl -fsSL https://nextxch.com/install.sh | sudo bash

# Späteres Update auf neue Release-Version mit einem Befehl:
curl -fsSL https://nextxch.com/install.sh | sudo bash -s -- --update

# === Windows Server (2019 / 2022 / 2025) - Lädt .msi, prüft SHA-256 & startet den Assistenten ===
irm https://nextxch.com/install.ps1 | iex

1. الخيار A: Compose مدمج بحاوية واحدة (SQLite WAL + Zstandard): مثالي لما يصل إلى آلاف صناديق البريد على VPS واحد أو خادم مخصص أو NAS، دون أي اعتماد على قاعدة بيانات خارجية ومع نحو 40 MB من ذاكرة RAM في وضع الخمول.
2. الخيار B: Enterprise Production Compose (PostgreSQL® 18 + S3 WORM + OpenTelemetry): توسع أفقي، وS3 Object Lock متوافق مع GoBD، وتتبعات ومقاييس وسجلات OpenTelemetry OTLP.

# === VARIANTE A: Kompakter Einzelcontainer-Stack (docker-compose.yml) ===
services:
  nextxch:
    image: nextxch/server:1.0.0
    container_name: nextxch
    hostname: mail.firma.de
    restart: unless-stopped
    ports:
      - "25:25"       # ESMTP-Eingang (MX)
      - "465:465"     # SMTPS-Einlieferung (Implicit TLS)
      - "587:587"     # SMTP-Einlieferung (STARTTLS)
      - "143:143"     # IMAP4rev2 (STARTTLS)
      - "993:993"     # IMAPS (Implicit TLS)
      - "4190:4190"   # ManageSieve (Filter & Abwesenheit)
      - "80:80"       # Let's Encrypt HTTP-01 & Autoconfig
      - "443:443"     # Admin-Cockpit, Webmail PWA, JMAP, CalDAV/CardDAV, Mobile Push (WBXML) & REST API
    environment:
      Urls: "http://*:80;https://*:443"
      Bootstrap__DefaultDomain: "firma.de"
      Bootstrap__AdminEmail: "admin@firma.de"
      Bootstrap__AdminPassword: "BitteSofortAendern!2026"
      Storage__Provider: "Sqlite"
      Storage__DataDirectory: "/var/lib/nextxch"
      Storage__BlobBackend: "FileSystem"
      Storage__Compression: "Zstd"
      Smtp__ServerHostName: "mail.firma.de"
      Imap__ServerHostName: "mail.firma.de"
      OpenTelemetry__Enabled: "true"
      OpenTelemetry__ServiceName: "nextxch"
    volumes:
      - ./nextxch-data:/var/lib/nextxch

# Starten (oder automatischer lokaler Image-Build via install.sh --mode docker):
# docker compose up -d && docker compose logs -f nextxch

# === VARIANTE B: Enterprise-Stack mit PostgreSQL 18, S3 Object Lock & OpenTelemetry ===
services:
  nextxch:
    image: nextxch/server:1.0.0
    restart: unless-stopped
    depends_on: [postgres, otel-collector]
    ports: ["25:25", "465:465", "587:587", "993:993", "4190:4190", "80:80", "443:443"]
    environment:
      Urls: "http://*:80;https://*:443"
      Storage__Provider: "Postgres"
      Storage__PostgresConnectionString: "Host=postgres;Database=nextxch;Username=nextxch;Password=${PG_PASSWORD}"
      Storage__BlobBackend: "Hybrid"
      Storage__Compression: "Zstd"
      Storage__S3Endpoint: "https://s3.eu-central-1.ionoscloud.com"
      Storage__S3Bucket: "firma-gobd-mail-archive"
      OpenTelemetry__Enabled: "true"
      OpenTelemetry__ServiceName: "nextxch-Prod"
      OpenTelemetry__OtlpEndpoint: "http://otel-collector:4317"
    volumes:
      - nextxch-nvme-cache:/var/lib/nextxch

  postgres:
    image: postgres:18-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: nextxch
      POSTGRES_USER: nextxch
      POSTGRES_PASSWORD: "${PG_PASSWORD}"
    volumes:
      - pg-data:/var/lib/postgresql

  otel-collector:
    image: otel/opentelemetry-collector-contrib:0.112.0
    restart: unless-stopped
    ports: ["127.0.0.1:4317:4317"]

volumes:
  nextxch-nvme-cache:
  pg-data:

1. الموصى به: معالج Windows® .msi الرسمي (v1.0.0): يطلب تفاعليًا عند التثبيت الجديد النطاق واسم مضيف MX وبيانات دخول المسؤول، والاختيار بين SQLite WAL وMicrosoft® SQL Server® (2019-2025 / Express / Azure® SQL) وPostgreSQL® 18، وLet's Encrypt ACME، وجدار حماية Windows®، ورمز الترخيص الاختياري. ويؤدي تشغيل ملف .msi أحدث إلى ترقية خدمة Windows® في مكانها بنقرة واحدة مع الحفاظ على appsettings.Production.json وبيانات البريد.
2. CLI صامت دون تدخل لـ Ansible وGPO & Microsoft® Intune: مرّروا أي خاصية إعداد دون واجهة عبر msiexec.exe /qn.

# Variante A: Einzeiler in PowerShell (prüft SHA-256, lädt .msi & startet den Assistenten)
irm https://nextxch.com/install.ps1 | iex

# Variante B: Unbeaufsichtigte Installation / Dienst-Aktualisierung per msiexec.exe
curl.exe -fLO https://nextxch.com/downloads/Nextxch-Setup-win-x64.msi
msiexec.exe /i Nextxch-Setup-win-x64.msi /qn `
  DEFAULT_DOMAIN="firma.de" `
  MAIL_HOSTNAME="mail.firma.de" `
  ADMIN_EMAIL="admin@firma.de" `
  ADMIN_PASSWORD="BitteSofortAendern!2026" `
  STORAGE_PROVIDER="Sqlite" `
  DATA_DIR="C:\ProgramData\nextxch"

1. مستخدم مخصص بدون صلاحيات root: يعمل دون root مع CAP_NET_BIND_SERVICE للمنفذين 25/443.
2. تفعيل وحدة systemd أصلية من نوع Type=notify: تتكامل أصليًا مع journald وجاهزية systemd.

# Schnellweg für Debian 12 / Ubuntu 24.04 LTS:
curl -fLO https://nextxch.com/downloads/nextxch_1.0.0_amd64.deb
sudo dpkg -i nextxch_1.0.0_amd64.deb

# Alternativ für RHEL / Rocky / AlmaLinux via .tar.gz + systemd:
sudo useradd -r -s /usr/sbin/nologin -d /var/lib/nextxch nextxch
sudo mkdir -p /opt/nextxch /var/lib/nextxch
curl -fsSL https://nextxch.com/downloads/nextxch-linux-x64.tar.gz | sudo tar -xz -C /opt/nextxch
sudo chown -R nextxch:nextxch /var/lib/nextxch
sudo cp /opt/nextxch/nextxch.service /etc/systemd/system/
sudo systemctl enable --now nextxch

1. دعم أصلي لـ Apple® Silicon ARM64: مثالي لخوادم Mac mini® / Mac Studio® المكتبية وبيئات التجهيز المحلية على MacBook Pro®.
2. التشغيل الدائم عبر launchd: يبدأ تلقائيًا عند الإقلاع مع استهلاك نحو 40 MB من ذاكرة RAM.

sudo mkdir -p /usr/local/nextxch /usr/local/var/nextxch/logs
curl -fsSL https://nextxch.com/downloads/nextxch-osx-arm64.tar.gz | sudo tar -xz -C /usr/local/nextxch
sudo xattr -dr com.apple.quarantine /usr/local/nextxch
sudo bash /usr/local/nextxch/install-macos.sh

# Alternativ per OrbStack / Docker Desktop auf macOS:
docker run -d --name nextxch -p 2525:25 -p 2993:993 -p 8080:80 \
  -v ~/nextxch-data:/app/data \
  nextxch/server:1.0.0

1. محرك عنقود 100% PostgreSQL® 18 (دون Redis/Kafka): توزّع النسخ المتماثلة الدفع الفوري IMAP IDLE وJMAP SSE في أقل من 2 ms عبر PostgreSQL® LISTEN/NOTIFY، وتتشارك التحديات المؤقتة وحدود المعدل عبر جداول UNLOGGED، وتنتخب قادة ACME/Retention عبر pg_try_advisory_lock.
2. بروتوكول HAProxy PROXY v1/v2 والجلسات عديمة الحالة: يحافظ على عناوين IP الحقيقية للعملاء خلف موازنات الحمل L4 من أجل فحوصات SPF/DMARC/CIDR دقيقة؛ وتتيح الرموز الموقّعة التوسع عبر HPA دون جلسات لاصقة.
3. ترخيص Ed25519 آمن للعناقيد: رمز ترخيص واحد يغطي عددًا غير محدود من الحاويات (Pods) ويتزامن عبر جميع العقد تلقائيًا عند تفعيله في /admin/.

# Offizielles Helm v3 Chart installieren (gepinnter Release-Tag 1.0.0, skaliert per HPA auf 3 bis 12 Pods)
helm upgrade --install nextxch ./deploy/helm/nextxch -n nextxch --create-namespace \
  --set image.repository=nextxch/server \
  --set image.tag=1.0.0 \
  --set replicaCount=3 \
  --set cluster.enabled=true \
  --set cluster.enableProxyProtocol=true \
  --set storage.provider=Postgres \
  --set storage.blobBackend=S3 \
  --set service.externalTrafficPolicy=Local

# Oder direkt per Kustomize-Manifesten (/health/live & /health/ready + PDB + Anti-Affinity):
kubectl apply -k ./deploy/kubernetes/

# Alternativ: Rootless Podman (RHEL 9 / Fedora / AlmaLinux ohne Docker-Daemon)
podman run -d --name nextxch --restart=always \
  -p 25:25 -p 465:465 -p 587:587 -p 993:993 -p 4190:4190 -p 8443:443 \
  -v /var/lib/nextxch:/app/data:Z \
  nextxch/server:1.0.0

1. إنشاء حاوية LXC: أنشئوا حاوية LXC غير مميزة بنظام Debian® 12 ‏(2 vCPU، و1024 MB RAM) مع نقطة تحميل ZFS/NVMe على /var/lib/nextxch.
2. مباشرة عبر .deb / systemd: داخل LXC، شغّلوا خدمة .deb/systemd الأصلية دون أي عبء لحاويات متداخلة، مع لقطات فورية عبر Proxmox® Backup Server.
3. جدار حماية Proxmox®: اسمحوا بمنافذ TCP الواردة 25 و465 و587 و993 و4190 و80 و443 في Datacenter/CT Firewall.

# Auf dem Proxmox-Host (erstellt schlanken Debian-LXC CT 210 & installiert nativ):
pct create 210 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \
  --hostname mail --cores 2 --memory 1024 --net0 name=eth0,bridge=vmbr0,ip=dhcp \
  --storage local-zfs --rootfs local-zfs:32 --unprivileged 1 --start 1
pct exec 210 -- bash -c "curl -fsSL https://nextxch.com/install.sh | bash -s -- --mode native -y"

1. نظام 64 بت وNVMe بدلًا من بطاقة SD: استخدموا Raspberry Pi® OS Lite بإصدار 64 بت، وضعوا /var/lib/nextxch على M.2 NVMe HAT أو USB 3 SSD بدلًا من microSD.
2. نصيحة للاتصال المنزلي (Smarthost): على عناوين IP الديناميكية السكنية، اضبطوا Smtp__OutboundSmartHost على مضيف الترحيل لدى مزود الإنترنت أو الاستضافة لضمان تسليم صادر موثوق.

# Nativ per ARM64-.deb-Paket oder Container (v1.0.0) auf Raspberry Pi 4 / 5:
curl -fLO https://nextxch.com/downloads/nextxch_1.0.0_arm64.deb
sudo dpkg -i nextxch_1.0.0_arm64.deb

1. إنشاء مجلد في File Station: أنشئوا /volume1/docker/nextxch في File Station على وحدة تخزين Btrfs/SSD لديكم.
2. تجنب تعارض المنافذ: تأكدوا من إيقاف Synology® MailPlus لتكون المنافذ 25 و465 و587 و993 متاحة.
3. فتح Container Manager: افتحوا Container Manager -> Project -> Create، واختاروا /volume1/docker/nextxch، ثم الصقوا:

services:
  nextxch:
    image: nextxch/server:1.0.0
    container_name: nextxch
    restart: unless-stopped
    ports:
      - "25:25"
      - "465:465"
      - "587:587"
      - "993:993"
      - "4190:4190"
      - "8443:443"
    volumes:
      - /volume1/docker/nextxch:/app/data
    environment:
      Storage__Provider: "Sqlite"
      Storage__Compression: "Zstd"

1. تثبيت Docker®-CE & Portainer CE: ثبّتوا Docker®-CE وPortainer CE من ADM App Central.
2. مجلد دائم: أنشئوا /volume1/Docker/nextxch في ADM File Explorer.
3. نشر الحزمة (Stack): انشروا Stack في Portainer مع ربط /volume1/Docker/nextxch:/app/data، واسمحوا بمنافذ البريد في ADM Defender.

mkdir -p /volume1/Docker/nextxch
docker run -d --name nextxch --restart unless-stopped \
  -p 25:25 -p 465:465 -p 587:587 -p 993:993 -p 8443:443 \
  -v /volume1/Docker/nextxch:/app/data \
  nextxch/server:1.0.0

1. استخدام مجمّع تخزين NVMe: على طرازات UGREEN NASync DXP، ضعوا /volume1/docker/nextxch على مجمّع M.2 NVMe لديكم للحصول على بحث فوري.
2. تطبيق UGOS Pro Docker®: افتحوا UGOS Pro Docker® -> Project -> Create، والصقوا ملف Compose، ثم انقروا Deploy.

# UGOS Pro -> Docker -> Projekt -> Compose-Konfiguration:
services:
  nextxch:
    image: nextxch/server:1.0.0
    restart: always
    ports: ["25:25", "465:465", "587:587", "993:993", "4190:4190", "8443:443"]
    volumes:
      - ./data:/app/data

1. تثبيت Docker® Manager: ثبّتوا Docker® Manager من TOS App Center وأنشئوا /Volume1/docker/nextxch.
2. نشر المشروع: في Docker® Manager -> Projects -> Add، الصقوا حزمة YAML ثم ابدأوا التشغيل.

volumes:
  - /Volume1/docker/nextxch:/app/data
# Admin-Cockpit nach Start: https://TERRAMASTER-IP:8443/admin/

1. وضع Appdata على Cache-NVMe: اربطوا /mnt/cache/appdata/nextxch حتى تتمكن أقراص مصفوفة التكافؤ من التوقف عن الدوران بينما تعمل الفهارس بسرعة NVMe.
2. عنوان IP خاص على الشبكة المحلية عبر نوع الشبكة Custom: br0 (موصى به): عيّنوا Network Type: Custom br0 مع عنوان IP مخصص على الشبكة المحلية حتى لا تتعارض المنافذ 80/443/25 أبدًا مع Unraid WebGUI.

# Unraid Terminal oder Docker Compose Manager Plugin:
docker run -d --name nextxch --net=br0 --ip=192.168.178.25 --restart=unless-stopped \
  -v /mnt/cache/appdata/nextxch:/app/data \
  -e ASPNETCORE_URLS="http://*:80;https://*:443" \
  -e Bootstrap__DefaultDomain="firma.de" \
  nextxch/server:1.0.0

1. ضبط Reverse DNS ‏(PTR) في SCP: في netcup SCP -> Network، اضبطوا Reverse DNS ‏(PTR) لكل من عنوان IPv4 وعنوان IPv6 الأساسي إلى mail.yourdomain.de.
2. إدارة DNS في CCP: في netcup CCP -> Domains -> DNS، أضيفوا سجلات A وAAAA وMX (prio 10) وSPF وDKIM TXT.
3. التثبيت: انشروا صورة ISO لـ Debian® 12 أو Windows Server® في SCP وثبّتوا أصليًا أو عبر Docker®.

1. فتح المنفذ 25 للعملاء الجدد: تحظر حسابات Hetzner Cloud الجديدة المنفذين الصادرين 25/465 في البداية؛ اطلبوا رفع الحظر عن المنفذ عبر Cloud Console -> Limits بعد فاتورتكم الأولى.
2. ضبط PTR لـ IPv4 & IPv6: في Hetzner Cloud Console -> Networking -> Edit Reverse DNS على كل من Primary IPv4 وIPv6::1 إلى mail.yourdomain.de.
3. نصيحة لأفضل قيمة مقابل السعر: يعمل أصليًا على مثيلات Hetzner CAX ARM64 عالية الكفاءة ويتكامل مباشرة مع Hetzner S3 Object Storage.

1. فتح جدار حماية IONOS الخارجي: افتحوا IONOS Cloud Panel -> Network -> Firewall Policies واسمحوا بمنافذ TCP الواردة 25 و80 و443 و465 و587 و993 و4190.
2. ضبط Reverse DNS: اضبطوا Reverse DNS ضمن Network -> Public IPs على mail.yourdomain.de بمجرد أن يُحَل سجل A.
3. أرشيف GoBD مع IONOS S3: اقرنوه بـ IONOS S3 Object Storage في فرانكفورت/برلين مع S3 Object Lock أصلي (COMPLIANCE).

1. الخيار A (النطاق لدى ALL-INKL، وnextxch على VPS خاص): في ALL-INKL KAS -> Tools -> DNS Tools، وجّهوا سجلَّي A/AAAA لـ mail وسجل MX إلى عنوان IP لـ nextxch لديكم، وأضيفوا سجلات TXT لـ SPF/DKIM/DMARC.
2. الخيار B (nextxch في المكتب / NAS مع ALL-INKL كمرحّل للإرسال): هل تشغّلون nextxch على NAS مكتبي أو Proxmox® خلف عنوان IP ديناميكي؟ اضبطوا w01abc.kasserver.com:587 بوصفه Smtp__OutboundSmartHost وأضيفوا include:_spf.kasserver.com إلى SPF.

1. سجل PTR في قسم VPS: في Hostinger hPanel -> VPS -> IP Addresses، اضبطوا سجل PTR على mail.yourdomain.de.
2. انتبهوا للمنفذ 25 / الترحيل: تحققوا من أن المنفذ الصادر 25 مفتوح في خطة KVM لديكم، أو اضبطوا Smarthost مصادقًا عليه عبر المنفذ 587 في nextxch.
3. إدارة DNS في hPanel: استبدلوا إدخالات MX الافتراضية في محرر منطقة DNS في hPanel بالقيمة mail.yourdomain.de وسجلات TXT الخاصة بـ SPF/DKIM/DMARC لديكم.

1. مثالي لـ Windows Server® دون Docker®: على خوادم STRATO Windows® V-Server، ثبّتوا مباشرة كخدمة Windows® أصلية باستخدام أمر PowerShell® أعلاه.
2. Reverse DNS في STRATO Server-Login: في STRATO Server Login -> IP Addresses، اضبطوا Reverse DNS لعنوانَي IPv4 وIPv6 على mail.yourdomain.de.
3. إدارة النطاقات في STRATO: في STRATO Domain Management -> DNS Settings، حوّلوا MX إلى خادم بريد مخصص (mail.yourdomain.de) وأضيفوا سجلات TXT.

1. ترتيب مهم لسجل PTR في OVHcloud: تتحقق OVHcloud من DNS الأمامي قبل قبول تغيير PTR: أنشئوا أولًا سجلَي A وAAAA لـ mail.yourdomain.de، ثم اضبطوا Reverse DNS ضمن Network -> Public IPs.
2. جدار حماية الشبكة & S3 Object Lock: اسمحوا بمنافذ البريد في OVHcloud Edge Network Firewall، واربطوا اختياريًا OVHcloud S3 Object Storage (ليمبورغ/ستراسبورغ) لأرشفة GoBD WORM غير قابلة للتعديل.