> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stampfactory.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# On-Premises Installation

> Stampfactory auf einem eigenen Server installieren -- Hardware, Software und Anforderungen

Stampfactory kann auf einem eigenen Server installiert werden (On-Premises). Diese Option eignet sich für Unternehmen, die ihre Daten im eigenen Rechenzentrum halten möchten.

## Hardware-Anforderungen

| Mitarbeitende | CPU     | RAM   | Speicher   | Datenbank |
| ------------- | ------- | ----- | ---------- | --------- |
| Bis 100       | 2 Kerne | 4 GB  | 50 GB SSD  | ca. 5 GB  |
| Bis 500       | 4 Kerne | 8 GB  | 100 GB SSD | ca. 10 GB |
| Bis 1.000     | 4 Kerne | 16 GB | 200 GB SSD | ca. 20 GB |

## Software-Anforderungen

| Komponente     | Version                       |
| -------------- | ----------------------------- |
| Betriebssystem | AlmaLinux 9 (oder kompatibel) |
| Docker         | 20.10+                        |
| Docker Compose | v2+                           |

<Info>
  Alle weiteren Abhängigkeiten (PostgreSQL, Redis, PHP, Nginx) werden als Docker-Container bereitgestellt. Eine manuelle Installation dieser Komponenten ist nicht erforderlich.
</Info>

## Architektur

Die On-Premises-Installation besteht aus folgenden Containern:

| Container      | Beschreibung                        |
| -------------- | ----------------------------------- |
| **App**        | Laravel-Anwendung mit FrankenPHP    |
| **PostgreSQL** | Datenbank (separate DB pro Mandant) |
| **Redis**      | Cache, Sessions und Queue           |
| **Horizon**    | Queue-Worker für Hintergrundjobs    |

## Netzwerk-Anforderungen

* **HTTPS**: Ein gültiges SSL-Zertifikat ist erforderlich
* **Port 443**: Muss von außen erreichbar sein
* **DNS**: Wildcard-DNS-Eintrag für Mandanten-Subdomains (z.B. `*.stampfactory.ihrefirma.de`)

## Installation

Die Installation erfolgt über ein bereitgestelltes Setup-Script. Kontaktieren Sie unser Team unter [support@stampfactory.eu](mailto:support@stampfactory.eu) für die Installationsanleitung und Zugangsdaten.

## Updates

Updates werden als neue Docker-Images bereitgestellt und können über `docker compose pull && docker compose up -d` eingespielt werden. Datenbankmigrationen werden automatisch ausgeführt.

## Backup

Wir empfehlen tägliche Backups von:

* **PostgreSQL-Datenbanken** (alle Mandanten-Datenbanken)
* **Uploads** (Avatare und Anhänge)
* **Konfiguration** (`.env`-Datei und Docker-Compose-Konfiguration)