Topics

Installation

System requirements, self-hosting, setup.

13 articles

Start here Installation – introduction An overview of the on-premises installation of teamspace/projectfacts: how the system is structured, what you need and where to find the individual guides for Linux, Windows and Docker.

Understand

1 articles

How teamspace is built Concept The mental model behind the on-premises installation: Tomcat, Java, database, reverse proxy and the central configuration files – and how requests flow through the system.

Set up & manage

9 articles

Performing an update Configuration Update an existing teamspace/projectfacts installation: backup, download the update package from teamspace-classic, stop the Tomcat, run the deploy script, check the version – plus subscribing to update notifications.
Setting up Nginx as a reverse proxy Configuration Configure the Nginx web server as a reverse proxy in front of teamspace/projectfacts – with SSL, WebSocket forwarding and ACME challenge. Linux only.
Setting up the PDF processing service Configuration Set up the JOD server (jod-server.jar) for teamspace/projectfacts – a helper service that converts Word documents into PDFs and merges documents into a single PDF. Under Linux and Windows.
Additional server configurations Configuration Supplementary configurations for the on-premises installation: importing an SSL certificate into the Java truststore, OAuth 2.0 for Microsoft 365 mail accounts, and installing Tomcat 9 manually under Debian 12.
Connecting LDAP login Configuration Connect teamspace/projectfacts to an LDAP/Active Directory server: determine the DNs, adjust the web.xml, understand the LDAP parameters and assign users.
Installing teamspace on Linux Configuration Complete step-by-step installation of teamspace/projectfacts under Debian/Ubuntu: packages, paths, web.xml, MariaDB/MySQL, Tomcat, Jasper font, permissions and update.
Installing teamspace on Windows Configuration Complete installation of teamspace/projectfacts under Windows Server: packages, paths, web.xml, MySQL, Tomcat Manager, Jasper font and updating via the Tomcat service.
Installing teamspace with Docker Configuration Run teamspace/projectfacts under Linux with Docker: prepare the system, set up MariaDB with tmpfs, the Dockerfile and docker-compose.yml, web.xml/context.xml, secure it with iptables and start the container.
Setting up Apache as a reverse proxy Configuration Configure the Apache web server as a reverse proxy in front of teamspace/projectfacts – with an SSL certificate, projectfacts.conf, security and performance settings under Linux and Windows.

Reference

2 articles

System requirements Reference Hardware and software requirements for the on-premises installation of teamspace/projectfacts – processor, RAM, database, Java, Tomcat, ports and the required installation files.
Version-specific update notes Reference A reference of the version-specific adjustments when updating teamspace/projectfacts – from 2023.1 (Java 17) and 2023.4 (connection pool) through to 2025.3 (Tomcat 10, Genua interface).