====== Systemanforderungen ======
===== Client =====
Damit untermStrich genutzt werden kann, erwarten wir clientseitig:
* **Betriebssystem:** Windows , macOS, Linux,
* **Netzwerk:** Anbindung an den Server über LAN, WLAN, DSL, oder VPN.
----
===== Connector (optional) =====
Der **Connector** ist eine kleine Zusatzkomponente, die lokal auf dem Arbeitsplatz
installiert wird. Er stellt die Verbindung zwischen untermStrich (Browser) und den
Office-Programmen bzw. dem Dateisystem her – also überall dort, wo der Browser
allein nicht zugreifen kann.
**Benötigt wird er vor allem für die Dokumentfunktionen:** das Öffnen, Bearbeiten
und Speichern von Word-/Excel-Dokumenten direkt aus untermStrich sowie den Zugriff
auf das Datenverzeichnis und die Projektverzeichnisse per Windows/SMB-Freigabe.
Wer **Microsoft 365** oder die **HTML-Vorlagen** nutzt, kommt ohne Connector aus.
:!: Wählen Sie den passenden Connector für Ihre Systemumgebung und installieren
Sie ihn auf den Arbeitsplätzen, auf denen die Dokumentfunktionen benötigt werden.
==== e-Connector ====
Zusatzkomponente für die untermStrich-Software.
**Betriebssysteme**
* Windows
* Getestet auf Windows 10, 11 //64Bit Intel/AMD x86//
* macOS ((Ehemals Mac OS X))
* Getestet auf macOS 10.13 - 10.15, 11, 12 //Intel//
* Getestet auf macOS 11, 12 - //M1// (Apple ARM Version)
* Linux mit [[https://appimage.org/|AppImage]] Unterstützung
* Getestet auf Ubuntu 18.04 //64Bit Intel/AMD x86// und neuer
* Linux ARM64 mit [[https://appimage.org/|AppImage]] Unterstützung
* Beta - Nicht getestet
==== Connector 4VX ====
🦕 Alte Nutzungsvariante
Die folgenden Module benötigen den Connector 4VX:
* [[de:tapi:start|TAPI]]
Der Connector 4VX benötigt das .NET Framework ab 4.
* Unterstützt werden Microsoft Office 2013 - 2019
* Online-Varianten werden nicht unterstützt.
* Unterstützt werden Windows Versionen ab 10
:righty: Support für Office 2010 beendet Support Ende durch Microsoft in 2020: [[https://support.microsoft.com/de-de/office/ende-des-supports-f%C3%BCr-office-2010-3a3e45de-51ac-4944-b2ba-c2e415432789|
Ende des Supports für Office 2010]] und daher auch durch untermStrich.
:!: Um Probleme mit Virenscannern zu vermeiden, empfehlen wir, das untermStrich
Connector-Verzeichnis vom Scan auszunehmen. :!:
==== Windows/SMB-Freigabe ====
Die Dokumentfunktionen des Connectors benötigen Zugriff per Windows/SMB-Freigabe
([[wpde>Server Message Block]]) auf das Datenverzeichnis und eventuelle
[[de:projects:projects:dialog:dirs|Projektverzeichnisse]].
Der Zugriff ist **nicht** notwendig, wenn Sie
* [[de:o365:start|Microsoft 365]] oder
* die [[de:setup:setup:sideboard:info:options:form_types_html|direkt in untermStrich aufrufbaren HTML-Vorlagen]] nutzen oder
* auf [[de:user:start#connector_dateiverwaltung|Datei Herunterladen & Hochladen]] umstellen.
----
===== Microsoft 365 (optional) =====
Sie können Dokumente auch direkt mit **Microsoft 365** verwalten – dann benötigen
Sie weder eine Windows/SMB-Freigabe noch einen Connector.
Siehe: [[de:o365:start|Microsoft 365]]
----
===== Browser =====
{{page>de:installation:browser#desktop_browser&noheader}}
----
===== Server =====
Der Server sollte etwas besser ausgestattet sein und Folgendes erfüllen:
==== Betriebssystem ====
=== Windows ===
* Windows 10,11 Windows Server 2019, Server 2022, Server 2025
* Windows Server 2016 **Support endet:** ab 12.01.2027 keine regulären Sicherheitsaktualisierungen durch [[https://learn.microsoft.com/de-de/lifecycle/products/windows-server-2016|Microsoft]].
* Windows 10 Pro **Support abgelaufen:** seit 14.10.2025 keine regulären Sicherheitsaktualisierungen durch [[https://learn.microsoft.com/de-de/lifecycle/products/windows-10-home-and-pro|Microsoft]].
* Nutzen Sie nur die **64-Bit-Version** von Windows.
* Bei Einsatz eines Virenscanners:
* untermStrich- und MySQL-Verzeichnisse bzw. Apache- und MySQL-Dienst ausnehmen: [[de:faq:server_is_slow_virus_scanner|Ausnahmen für Virenscanner]]
* Lassen sich die Verzeichnisse vor der Installation nicht zu den Ausnahmen hinzufügen, deaktivieren Sie den Virenscanner vor der Installation.
* :!: Aktive **GData**- und **ESET**-Virenscanner führen zu zerstörten MySQL-Tabellen.
=== Linux ===
Ubuntu Linux Long Term Support (LTS):
* X5 PHP 8.3: Ubuntu Server Noble Numbat 24.04
* X5 PHP 8.1: Ubuntu Server Jammy Jellyfish 22.04
* Verwenden Sie keine LAMP-Pakete, die nicht vom Distributor des Betriebssystems stammen (z. B. xampp, PPA).
* Bei anderen Distributionen/Versionen können wir keinen Support garantieren.
=== macOS ===
* X5 PHP 8.1: bis macOs16 Tahoe (Intel oder M1/M2) – [[de:installation:installation_macos|Installation macOS]]
* Installieren Sie nur nach Vorgabe. Verwenden Sie keine MAMP-Pakete. Andere Programme (z. B. Kerio) so konfigurieren, dass Port 80, 8080 bzw. 443 ((Je nach Installation)) für den Apache verfügbar bleibt.
==== Software ====
untermStrich ONE:
^ Komponente ^ Version ^
| **PHP** | {{page>de:php_versions}} |
| **MySQL** | 8.0 ((Ältere MySQL-Versionen können mit untermStrich X5 nicht genutzt werden.)) |
| **Apache** | 2.4 (nur untermStrich auf dem Server installieren) |
| **Java** | [[de:installation:java_installation|Java 11]] bis [[de:installation:java_installation|Java 19]] |
| **LibreOffice** | ab 4 (nur für „PDF-Erstellung über LibreOffice“) |
==== Hardware ====
^ Komponente ^ Anforderung ^
| **Prozessor** | Min. 2-Kern x64 Intel/AMD oder Apple M1 (ARM). Kein ARM für Linux/Windows. Nicht vor Core-i-Serie bzw. Xeon Ivy Bridge (Intel). |
| **Speicher** | Mindestens 8 GB RAM (4 GB exklusiv für MySQL ((Beachten Sie: Microsoft Exchange Server 2010/2013 nutzt den gesamten verfügbaren RAM. [[de:faq:exchange_ram|Details]])), 2 GB exklusiv für Apache/PHP). |
| **SSD** | 160 GB und mindestens 5 % der Partitionskapazität. Eine SSD für System (Apache, MySQL) wird dringend empfohlen. |
| **Grafikkarte** | Egal – GUI nur für Windows und Mac notwendig. |
| **Netzwerk** | 1 GBit (siehe Hinweise unten). |
=== Hinweise Netzwerk ===
* Liegen Apache und MySQL auf unterschiedlichen Systemen, achten Sie auf ein stabiles Netzwerk.
* Der Server benötigt zum Einspielen von Updates/Installationen Internetzugang ((Explizit auf https://webservices.untermstrich.com/ – SSL-Deep-Packet-Inspection für diesen Host deaktivieren. Nicht alle Proxy-Server sind kompatibel; diese müssen zusätzlich in der untermStrich config.php eingetragen werden.)).
* :!: Empfohlen: Einsatz und passende Konfiguration einer **Hardware-Firewall**, um den Server nicht ungewollt nach außen zu exponieren.
=== Virtualisierung ===
* Empfohlen: **VMware** oder **Xen**.
* Nicht empfohlen / nicht unterstützt: **Hyper-V** ((Grund: [[de:faq:hyper_v]])).
Die meisten **NAS-Systeme** erfüllen diese Anforderungen nicht bzw. bieten nur
unzureichende Performance und werden daher **nicht unterstützt**.
----
===== Notwendige Apache- / PHP-Module =====
**Diese Informationen sind als Hilfe für Ihren Systembetreuer gedacht.
Installation siehe Installationsbeispiele.**
==== Apache 2 ====
* ''mod_rewrite'', ''mod_expires'', ''mod_env''
* Einstellung: ''AllowOverride All'' für das Verzeichnis
* Optional (GZIP-Komprimierung für HTML, CSS, JavaScript): ''mod_filter'', ''mod_deflate''
==== PHP ====
* [[http://www.ioncube.com/loaders.php|ionCube Loader]]
* ''openssl'', ''mysqli''
* ''mbstring'' – Ubuntu: ''php-mbstring''
* ''xsl'' – Ubuntu: ''php-xml''
* ''zip'' – Ubuntu: ''php-zip''
* Dringend empfohlen (sonst funktionieren einige Bild-Funktionen nicht): [[https://www.php.net/manual/de/image.installation.php|GD image]]
* Für [[de:setup:setup:sideboard:system:ldap|Adressen LDAP]]: ''ldap'' – Ubuntu: ''php-ldap''
=== Einstellungen ===
* ''register_globals = Off''
* ''safe_mode = Off''
* ''magic_quotes_gpc = Off''
* ''magic_quotes_runtime = Off''
* ''max_execution_time >= 30''
* ''memory_limit >= 128M''
* ''file_uploads = On''
* ''upload_max_filesize >= 20M''
* ''post_max_size >= 30M''
* ''max_input_time >= 60''
:help: ''upload_max_filesize'' und ''post_max_size'' bestimmen die maximale Größe
der mit untermStrich verwaltbaren Dateien. [[de:faq:upload_big_files|Weitere Details]]
Im **CGI/FastCGI**-Betrieb müssen die Timeouts entsprechend hoch gesetzt werden –
vor allem beim Update von X.1 auf X2. Diese Betriebsarten werden nicht getestet,
daher bieten wir dazu keinen Support an.
----
===== Notwendige MySQL-Engines =====
* MyISAM
* INNODB
* ARCHIVE
* MEMORY
----
===== SaaS =====
**Office 365 mit SharePoint** ist für die zentrale Dokumentenablage bei SaaS
Voraussetzung.\\
Siehe: [[de:o365:start|Microsoft 365]]
===== E-Mail-Server =====
Die folgenden E-Mail Server wurden für den IMAP/SMTP Zugriff von untermStrich 9) getestet:
1&1 Serverdienste - 1&1 MailXchange, GMX.at/de/ch, WEB.de
Google Serverdienste - Gmail
Das Verzeichnis „[Gmail]“ kann nicht durchsucht werden. Das Ausgangsverzeichnis „[Gmail]/Gesendet“ wird jedoch automatisch erkannt.
Microsoft - Exchange 2010, 2013, 2016, 2019
:righty: [[de:tested_email?do=#microsoft_-_exchange_2010_2013_2016_2019|Hinweise zu Exchange]]
:!: Bei anderen E-Mail Servern und Versionen können wir Ihnen leider keine Unterstützung durch unseren Support garantieren.