Installation und Betrieb

Systemvoraussetzungen

• Linux-VM oder physischer Server
• Debian oder Ubuntu (LTS empfohlen)
• Mindestens 2 GB Arbeitsspeicher (empfohlen 4 GB)
• Mindestens 1 CPU-Kern (empfohlen 2)

Das Installationsskript installiert automatisch die benötigte Java Runtime (OpenJDK 17), richtet den Apache Tomcat Webserver ein und deployt die OnPremPDF-Webanwendung. Nach der Installation ist kein Internetzugang erforderlich.

Installation

Für die Installation stehen zwei Varianten zur Verfügung. Für produktive Umgebungen und sicherheitsbewusste Nutzer wird die Installation über Git empfohlen.

sudo apt update
sudo apt install -y git
git clone https://github.com/onprem-pdf/onprempdf.git
cd onprempdf
sudo bash install.sh

sudo apt update
sudo apt install -y curl
curl -fL https://raw.githubusercontent.com/onprem-pdf/onprempdf/main/install.txt | sudo bash

Was macht der Installer?

Das Installationsskript richtet eine minimale und vollständig eigenständige On-Prem-Umgebung ein. Alle Schritte sind deterministisch und können vor der Ausführung eingesehen und geprüft werden.

• Installiert OpenJDK 17 (headless)
• Installiert Apache Tomcat 9.x (aktuelle stabile Version)
• Legt einen dedizierten Systembenutzer tomcat an
• Deployt die OnPremPDF WAR-Datei
• Konfiguriert eine lokale Administrator-Authentifizierung

Nach der Installation läuft das System vollständig offline. Es werden keine Telemetriedaten erhoben, kein Tracking durchgeführt und keine externen Netzwerkverbindungen aufgebaut.

Das Installationsskript kann vor der Ausführung vollständig eingesehen und auditiert werden.

Ausgabe nach der Installation

Nach erfolgreicher Installation wird im Terminal eine Zusammenfassung der eingerichteten Komponenten angezeigt:

==========================================================
Installation completed!

----------------------------------------------------------
Security notice:
Tomcat is listening on port 8080 for internal access.
Ensure this port is not exposed to public networks.
Restrict access via firewall or network configuration.
----------------------------------------------------------

PDFGuard API:
http://SERVER-IP:8080/pdfguard/api/v1/render

Administration interface:
http://SERVER-IP:8080/pdfguard/

Admin login:
Username: pdfguard
Password: <generated during installation>

The password is generated randomly during installation.

Credentials are stored locally in:
/opt/tomcat/conf/tomcat-users.xml
(permissions: 600, readable only by the tomcat user)

Please store this password securely.
==========================================================

Die Administrationsoberfläche ist automatisch mit einem zufällig generierten Passwort abgesichert. Es existieren keine Standard-Zugangsdaten.

Lokaler API-Endpunkt

Nach Abschluss der Installation ist die API lokal erreichbar unter:

http://server-ip:8080/pdfguard/api/v1/render

Der Endpunkt ist ausschließlich innerhalb des lokalen Netzwerks erreichbar und nicht öffentlich exponiert.

Administrationsoberfläche

Nach der Installation steht eine lokale Administrationsoberfläche zur Verfügung. Diese dient der Überwachung des Systems sowie der Verwaltung der Lizenz.

Zugriff:

http://SERVER-IP:8080/pdfguard/

• Status des PDF-Dienstes
• Aktiver Lizenztyp
• Versionsinformationen
• Lokaler API-Endpunkt

Die Oberfläche ist ausschließlich lokal erreichbar und durch HTTP Basic Authentication geschützt.

Lizenzaktivierung

Nach dem Erwerb einer Lizenz erhalten Sie einen Lizenzschlüssel, der einmalig über die Administrationsoberfläche eingegeben wird.

Die Software schaltet anschließend automatisch vom Lite-Modus auf die lizenzierte Variante um. Ein Neustart ist nicht erforderlich.

Betrieb & Offline-Fähigkeit

• Vollständiger Offline-Betrieb möglich
• Keine Telemetrie oder Nutzungsanalyse
• Keine externen API-Aufrufe
• Geeignet für abgeschottete Netzwerke

Windows Server Installation

Native Unterstützung für Windows Server 2019 / 2022 befindet sich derzeit in Vorbereitung.

Für frühzeitigen Zugang oder Enterprise-Anfragen:
info@onprempdf.com