Installation – Einführung

teamspace (und das technisch identische projectfacts) lässt sich selbst hosten – auf einem eigenen Server unter Linux, Windows oder als Docker-Container. Dieses Thema richtet sich an Administratoren, die eine On-Premises-Installation aufsetzen, betreiben und aktualisieren.

Cloud-Nutzung? Wer teamspace als Cloud-Variante bezieht, muss nichts installieren – der Betrieb läuft auf den Servern der 5 POINT AG. Die Artikel hier betreffen ausschließlich den eigenen Betrieb (On-Premises).

Was technisch installiert wird

teamspace ist eine Java-Webanwendung, die in einem Apache Tomcat läuft und ihre Daten in einer MySQL-/MariaDB-Datenbank ablegt. Ein vorgeschalteter Reverse Proxy (Apache oder Nginx) übernimmt die TLS-Verschlüsselung und reicht die Anfragen an den Tomcat weiter. Wie diese Bausteine zusammenspielen, erklärt der Artikel So ist teamspace technisch aufgebaut.

Die wichtigsten Komponenten in Kürze:

Apache Tomcat 10 – der Anwendungsserver, in dem die teamspace-.war ausgeliefert wird.
OpenJDK 17 (Temurin) – die Java-Laufzeit.
MySQL 8 / MariaDB 10.5 – die Datenbank.
Apache 2.4 oder Nginx 1.24 – der Reverse Proxy (TLS, Ports 80/443).
userfiles-Verzeichnis – die Dateiablage des Dateimoduls (kann auf eine eigene Platte ausgelagert werden).

Was du zum Start brauchst

Einen Server, der die Systemvoraussetzungen erfüllt (Debian/Ubuntu oder Windows Server, ausreichend RAM und Platte, ein SMTP-Relay für den Mailversand).
Ein SSL-Zertifikat für die Verbindung zwischen Client und Server (oder ein kostenloses über Let’s Encrypt/Certbot).
Einen teamspace-classic-Account. Über teamspace-classic.de erhältst du die Installationsdateien (projectfacts.war, Deploy-Skripte, Datenbankvorlage, Jasper-Font, Userfiles-Vorlage) und später die Updates. Den Account legen wir auf Anfrage für dich an.

Wegweiser durch das Thema

Verstehen & vorbereiten

So ist teamspace technisch aufgebaut – Komponenten, Konfigurationsdateien und Datenfluss.
Systemvoraussetzungen – Hard- und Software, Ports, benötigte Dateien.

Installieren (je nach Plattform einen Weg wählen)

Reverse Proxy einrichten (genau einen)

Apache als Reverse Proxy einrichten
Nginx als Reverse Proxy einrichten (nur Linux)

Zusatzdienste & Sonderfälle

LDAP-Anmeldung anbinden
PDF-Verarbeitungsdienst einrichten
Weitere Server-Konfigurationen (SSL-Truststore, OAuth 2.0 für Microsoft 365, Tomcat 9 manuell unter Debian 12)

Aktuell halten

Hinweise

In den Anleitungen wird durchgängig der Name projectfacts verwendet. Hast du teamspace, ersetze den Namen entsprechend – die Schritte sind identisch.
Erstelle vor jedem Update ein Backup. Ein Downgrade auf eine ältere Version ist nicht zulässig und kann das System unbrauchbar machen.
Aktuelle Hinweise zu Updates findest du jederzeit auf der „Pinnwand” in teamspace-classic.