====== Systemanforderungen ======

===== Client (PC oder Smartphone) =====
Die folgenden Erwartungen stellen wir an den Client, um untermStrich benutzen zu können:
  * Betriebssystem: Windows ((Bis 10)), macOS, Linux, Android, iOS (iPhone / iPad) - Beachten Sie bitte die [[#browser|unterstützen Browser]].
  * Netzwerk: Anbindung an den Server mittels LAN, WLAN, DSL, mobiles Internet (HSDPA), VPN

==== Option - Connector ====
Wählen Sie den passenden Connector für Ihre Systemumgebung und Einsatzzweck und installieren Sie diesen auf den Arbeitsplätzen, auf denen die Module benötigt werden.

<WRAP group>
<WRAP half column>
=== e-Connector ===

Der untermStrich e-Connector ist eine Zusatzkomponente für die untermStrich-Software. 

Folgende Funktionen benötigen den e-Connector:
    * einige Funktionen im Bereich **Dokumente**

Der e-Connector unterstützt die folgenden Betriebssysteme:
{{page>de:econnector:system_requirements#betriebssysteme&noheader}}
</WRAP>
<WRAP half column>
=== Connector 4VX ===
<wrap center round tip>
🦕 Alte Nutzungsvariante
</wrap>

{{page>de:need4vx}}
</WRAP>
</WRAP>
:!: Um Probleme mit Virenscannern zu umgehen, empfehlen wir das untermStrich Connector Verzeichnis vom Scan auszunehmen.

=== Windows/SMB-Freigabe ===

Die Dokumentfunktionen des Connector benötigen einen Zugriff per Windows/SMB-Freigabe ([[wpde>Server Message Block]]) für das Datenverzeichnis und eventuelle [[de:projects:projects:dialog:dirs|Projektverzeichnisse]].

Der Zugriff per Windows/SMB-Freigabe ist nicht notwendig, wenn Sie die [[de:o365:start|]] oder [[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.

==== Option - Microsoft 365 ====
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|]]

==== Browser ====
=== Desktop ===
{{page>de:installation:browser#desktop_browser&noheader}}
=== Mobil ===
{{page>de:installation:browser#mobile_browser&noheader}}

===== Server =====
Der Server sollte etwas besser ausgestattet sein und muss das folgende erfüllen:
  * //Betriebssystem//:
    * Windows
      * Windows 10, Server 2012 R2, Server 2016, Server 2019, Server 2022, 11 
      * <del>Windows 8, 8.1</del> <wrap round tip>Veraltet: (Ab 10.01.2023 keine regulären Sicherheitsaktualisierungen durch Microsoft. )</wrap>
      * <del>Windows Server 2012</del> <wrap round tip>Veraltet: (Ab 12.07.2022 keine regulären Sicherheitsaktualisierungen durch Microsoft. )</wrap>
      * Veraltet: Windows Server 2012 R2 - Ab 10.10.2023 keine regulären Sicherheitsaktualisierungen durch Microsoft.
      * Nutzen Sie nur 64-Bit-Version von Windows!
      * Wenn Sie einen Virenscanner einsetzen:
        * Stellen Sie sicher, das die untermStrich und MySQL Verzeichnisse bzw. der Apache und MySQL Dienst ausgenommen sind: [[de:faq:server_is_slow_virus_scanner|Ausnahmen für Virenscanner]]
        * Wenn Sie die Verzeichnisse nicht vor der Installation zu den Ausnahmen hinzufügen können, 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) Versionen
      * X4 PHP 8.1: Ubuntu Server Jammy Jellyfish 22.04
      * X4 PHP 7.4: Ubuntu Server Focal Fossa 20.04 <wrap round tip>Alt: (Ab April 2025 keine regulären Aktualisierungen durch Canonical. )</wrap>
      * <del>X4 PHP 7.2: Ubuntu Server Bionic Beaver 18.04</del> <wrap round tip>Veraltet: (Ab April 2023 keine regulären Aktualisierungen durch Canonical. )</wrap>
      * Verwenden Sie keine LAMP Pakete die nicht vom Distributor des Betriebssystems stammen (Wie xampp, PPA)
      * Bei anderen Distributionen und Versionen können wir Ihnen leider keine Unterstützung durch unseren Support garantieren.
    * macOS ((Ehemals Mac OS X))
      * X4 PHP 8.1: macOS 11 Big Sur, 12 Monterey, 13 Ventura Intel oder M1/M2
        * [[de:installation:installation_macos|]]
      * <del>X4 PHP 7.4 [[alt:installation:mac14_detail71|macOS 10.14, 10.15, 11, 12 Intel mit PHP 7.4]] [[alt:installation:mac111_detail71|macOS 11, 12 M1/M2 mit PHP 7.4]]</del> <wrap round tip>Veraltet: (Ab 28.11.2022 keine regulären Sicherheitsaktualisierungen durch Zend, Neuinstallation nicht mehr möglich. )</wrap>
      * Installieren Sie bitte nur nach Vorgabe. Verwenden Sie keine MAMP Pakete. Andere Programme wie Kerio müssen so konfiguriert werden, dass Port 80, 8080 bzw 443 ((Je nach Installation)) für den Apache, auf dem untermStrich läuft, zur Verfügung steht.
  * //Software//: 
    * [[de:x4|untermStrich X4]]:
      * PHP {{page>de:php_versions}}
      * MySQL 
        * MySQL 8.0
        * <del>MySQL 5.7</del> <wrap round tip>Veraltet: (Ab 25.10.2023 nur mehr Oracle Lifetime Sustaining Support [[https://www.mysql.com/support/eol-notice.html|MySQL Product Support EOL]].)</wrap>
          * <del>Ab MySQL 5.7.11</del> ((Version von **5.7.6 bis 5.7.10** haben einen [[https://bugs.mysql.com/bug.php?id=79333|Bug]] und werden daher nicht unterstützt. Bitte auf eine aktuellere MySQL Version aktualisieren.))
        * Ältere MySQL Versionen können mit untermStrich X4 nicht genutzt werden.
    * Apache 2.4
      * Installieren Sie nur untermStrich auf dem Server.
    * Java
      * [[de:installation:java_installation|Java 11]] bis [[de:installation:java_installation|Java 19]]
    * "PDF Erstellung über LibreOffice" benötigt LibreOffice ab 4.
  * //Prozessor//: 
    * Min. 2-Kern x64 Intel/AMD
    * Oder Apple M1 (ARM)
    * Kein ARM für Linux/Windows
    * Nicht vor der Core-i-Serie, Xeon Ivy Bridge bei Intel
  * //Speicher//: Min. 4 GB Ram (2 GB davon exklusiv für MySQL ((Beachten Sie: Der Microsoft Exchange Server 2010/ 2013 nutzt den gesamten verfügbaren Speicher(RAM). [[de:faq:exchange_ram|Details]])), 1GB davon exklusiv für Apache/PHP)
  * //SSD (Festplatte)//: 160 GB und mindestens 5% der Kapazität der Partition. Um eine optimale Performance zu erhalten, empfehlen wir dringend den Einsatz einer SSD für das System (Apache, MySQL).
  * //Grafikkarte//: egal, GUI ist nur für Windows und Mac notwendig
  * //Netzwerk//: 1 GBit
    * Vor allem, wenn Apache und MySQL auf unterschiedlichen System sind, achten Sie auf ein stabiles Netzwerk.
    * Der Server muss zum Einspielen von untermStrich Updates/Installationen Zugang zum Internet haben. ((Explizit auf: https://webservices.untermstrich.com/ Deaktivieren Sie eine eventuell SSL-Deep Packet Inspection für diesen Host. Nicht alle Proxy Server sind kompatibel. Diese müssen auch extra in der untermStrich config.php eingetragen werden.))
    * :!: Außerdem wird empfohlen, eine Hardware-Firewall einzusetzen und passend zu konfigurieren, um den Server nicht nach außen ungewollt zu exponieren und eine Sicherheitslücke zu öffnen.
  * //Server Virtualisierung//: 
    * Wir empfehlen den Einsatz von VMware oder Xen.
    * Nicht empfohlen und nicht unterstützt: Hyper-V ((Grund: [[de:faq:hyper_v]]))
  * Die meisten NAS Systeme erfüllen diese Anforderungen nicht bzw. bieten nur eine unzureichende Performance und werden daher von uns nicht unterstützt.


/**       * Mysql ab 5.1.53,  Auch möglich: MySQL 5.1.35 - 5.1.48 */
/**      * Nicht empfohlen ((Keine Updates der Herstellers)): Ab XP SP3 (Keine Home Version), Server ab 2003 R2 */


==== Notwendige Apache / PHP Module ====
**Die folgenden Informationen sind als Hilfe für Ihren Systembetreuer gedacht. Installation siehe Installationsbeispiele.**

  * Apache 2
    * ''mod_rewrite''
    * ''mod_expires''
    * ''mod_env''
    * Einstellungen:
      * ''AllowOverride All'' für das Verzeichnis
     * Optional:
      * GZIP Koprimierung für HTML, CSS und 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, da sonst einige Bild-Funktionen nicht funktionieren: [[https://www.php.net/manual/de/image.installation.php|GD image]]
    * Wenn [[de:setup:setup:sideboard:system:ldap|Adressen LDAP]] genutzt werden soll: ''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''
      * Die Werte ''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. Wichtig ist dies vor allem beim Update von X.1 auf X2. Diese Betriebsarten werden nicht getestet, weswegen wir auch keinen Support dazu anbieten können.

==== Notwendige MySQL Engines ====
  * MyISAM
  * INNODB
  * ARCHIVE
  * MEMORY

===== SaaS =====
Office 365 mit Sharepoint ist für die zentrale Dokumentenablage bei SaaS Voraussetzung.

===== E-Mail Server =====
{{page>de:tested_email}}

.

.