> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/server/de/getting-started/installation/database-setup/database-instance/postgresql.md).

# PostgreSQL

Installieren Sie PostgreSQL unter Windows, erstellen Sie eine dedizierte Eigentümerrolle und erstellen Sie mit der Devolutions Server Console eine Devolutions Server-Instanz auf PostgreSQL.

Devolutions Server unterstützt ***PostgreSQL*** 14 oder höher als Datenbankmodul, neben SQL Server. Der PostgreSQL-Server kann selbst gehostet sein oder ein verwalteter Dienst sein, der das Attribut `SUPERUSER` gewährt. Diese Seite beschreibt eine Installation unter Windows mit IIS über die Devolutions Server Console. Unter Linux siehe [Devolutions Server für Linux installieren](https://docs.devolutions.net/server/de/knowledge-base/how-to-articles/install-devolutions-server-for-linux.md). Mit Docker siehe [Docker-Bereitstellung von Devolutions Server](https://docs.devolutions.net/server/de/knowledge-base/how-to-articles/devolutions-server-docker-deployment.md).

Die folgenden Einschränkungen gelten für PostgreSQL:

* Das Konto, das das Datenbankschema erstellt, muss das Attribut `SUPERUSER` besitzen.
* Für alle Verbindungen wird eine einzige Eigentümerrolle verwendet. Die Konten mit minimalen Berechtigungen für den Planungsdienst und die Webanwendung sind nur für SQL Server verfügbar.
* Die integrierte Windows-Authentifizierung und die Microsoft Entra-Authentifizierung werden nicht unterstützt. Die Verbindung verwendet einen Benutzernamen und ein Passwort.
* Die automatische SQL Server Express-Installation der Devolutions Server Console gilt nicht. Der PostgreSQL-Server muss zuvor installiert werden.

Weitere Anforderungen finden Sie unter [Systemanforderungen](https://docs.devolutions.net/server/de/overview-of-devolutions-server/system-requirements.md).

## PostgreSQL installieren

1. Gehen Sie zu [postgresql.org](https://www.postgresql.org/) und klicken Sie auf ***Herunterladen*** und dann auf ***Windows***.
2. Wählen Sie PostgreSQL 14 oder höher. Stellen Sie unter ***Plattformunterstützung*** sicher, dass die Version Ihre Windows-Version unterstützt.
3. Klicken Sie auf ***Installationsprogramm herunterladen***. Laden Sie auf der EDB-Downloadseite das ***Windows x86-64***-Installationsprogramm der zu installierenden PostgreSQL-Version herunter.
4. Führen Sie das heruntergeladene Installationsprogramm aus und klicken Sie auf der Willkommensseite auf ***Weiter***.
5. Wählen Sie unter ***Installationsverzeichnis*** den Pfad aus und klicken Sie auf ***Weiter***.
6. Lassen Sie unter ***Komponenten auswählen*** alle Komponenten ausgewählt: ***PostgreSQL Server***, ***pgAdmin 4***, ***Stack Builder*** und ***Command Line Tools***. Klicken Sie auf ***Weiter***. Die ***Command Line Tools*** enthalten `pg_dump` und `pg_restore`, die vom Sicherungsauftrag von Devolutions Server verwendet werden.
7. Wählen Sie unter ***Datenverzeichnis*** den Pfad aus und klicken Sie auf ***Weiter***.
8. Geben Sie unter ***Passwort*** ein Passwort für den Datenbank-Superuser (`postgres`) ein und bestätigen Sie es. Klicken Sie auf ***Weiter***.
9. Behalten Sie unter ***Port*** den Standardport bei und klicken Sie auf ***Weiter***.
10. Lassen Sie unter ***Erweiterte Optionen*** die ***Locale*** auf ***DEFAULT*** und klicken Sie auf ***Weiter***.
11. Prüfen Sie die ***Zusammenfassung vor der Installation*** und klicken Sie auf ***Weiter***. Klicken Sie dann unter ***Bereit zur Installation*** erneut auf ***Weiter***.
12. Öffnen Sie nach Abschluss der Installation ***pgAdmin 4***.
13. Wählen Sie den PostgreSQL-Server aus, geben Sie das Passwort des Benutzers `postgres` ein und klicken Sie auf ***OK***. Der Server stellt die Verbindung her und seine Datenbanken erscheinen in der Struktur.

## Dedizierte Eigentümerrolle erstellen

Erstellen Sie eine dedizierte Rolle für Devolutions Server. Die Devolutions Server Console verwendet diese Rolle, um die Datenbank zu erstellen, um ihr Schema zu erstellen und für alle Verbindungen.

{% hint style="warning" %}
Die Rolle muss das Attribut `SUPERUSER` besitzen, um das Datenbankschema zu erstellen. Die Schemaerstellung ändert PostgreSQL-Typumwandlungen, was nur ein Superuser tun kann.
{% endhint %}

1. Klicken Sie in ***pgAdmin 4*** mit der rechten Maustaste auf den PostgreSQL-Server und klicken Sie auf ***Abfragewerkzeug***.
2. Führen Sie die folgende Abfrage aus:

   ```sql
   CREATE ROLE dvls_owner WITH LOGIN SUPERUSER PASSWORD '<password>';
   ```

Nachdem die Instanz erstellt wurde, erfordern die Schemaupgrades und der normale Betrieb von Devolutions Server das Attribut `SUPERUSER` nicht. Um die Privilegien der Rolle einzuschränken, entfernen Sie das Attribut. Die Rolle bleibt Eigentümer der Datenbank:

```sql
ALTER ROLE dvls_owner NOSUPERUSER;
```

## Devolutions Server-Instanz erstellen

{% hint style="info" %}
Stellen Sie vor dem Erstellen der Instanz sicher, dass:

* Die Devolutions Server Console ist auf dem Server installiert.
* Der PostgreSQL-Server wird ausgeführt, und seine Verbindungsinformationen sind bekannt: ***Hostname/Adresse***, ***Port***, die Eigentümerrolle und ihr Passwort. In ***pgAdmin 4*** stehen Host und Port auf der Registerkarte ***Verbindung*** der Servereigenschaften.
  {% endhint %}

1. Klicken Sie in der Devolutions Server Console auf ***Neu*** – ***IIS-Webserver*** – ***Erweiterte Installation***. Die Basisinstallation bietet ***PostgreSQL*** ebenfalls in der Liste ***Datenbankmodul***.
2. Setzen Sie auf der Seite ***Datenbankinformationen festlegen*** das ***Datenbankmodul*** auf ***PostgreSQL***. Die Liste enthält ***Microsoft SQL Server***, ***PostgreSQL*** und ***SQLite***. Mit ***PostgreSQL*** wird ein Feld ***Port*** mit dem Standardwert `5432` angezeigt, und die Liste ***Authentifizierungstyp*** ist ausgeblendet.
3. Geben Sie unter ***Host*** den Namen des PostgreSQL-Servers ein, oder `localhost`, wenn PostgreSQL auf demselben Computer installiert ist.
4. Geben Sie unter ***Port*** den während der PostgreSQL-Installation festgelegten Port ein.
5. Geben Sie unter ***Datenbank*** den Namen der Devolutions Server-Datenbank ein.
6. Geben Sie unter ***Benutzername*** und ***Passwort*** die Eigentümerrolle und ihr Passwort ein.
7. Klicken Sie auf ***Erweiterte Einstellungen***.
8. Legen Sie den ***SSL-Modus*** der Verbindung fest: ***Disable***, ***Allow***, ***Prefer*** (Standard), ***Require***, ***Verify CA*** oder ***Verify full***.
9. Klicken Sie auf ***OK***.
10. Klicken Sie auf ***Erweiterte Anmeldeinformationen***, um die Konten für ***Verwaltungstools***, ***Scheduler-Dienst*** und ***Webanwendung*** zu prüfen. Sie werden mit den auf der Seite eingegebenen Anmeldeinformationen gefüllt. Unter PostgreSQL verwenden alle drei die Eigentümerrolle: ***Minimale Berechtigungen anwenden*** ist nicht verfügbar.
11. Klicken Sie auf ***Verbindung testen***. Das Ergebnis bestätigt die ***Verbindung mit PostgreSQL***.
12. Klicken Sie auf ***Weiter***.
13. Geben Sie unter ***Allgemeine Informationen*** einen ***Servernamen*** ein und klicken Sie auf ***Weiter***.
14. Wählen Sie unter ***Installationsdatei auswählen*** die ***Installationsquelle*** und klicken Sie auf ***Weiter***.
15. Legen Sie unter ***IIS-Einstellungen*** die ***Website***, den ***Zugriffs-URI***, den ***Installationsordner*** und den ***Anwendungspool*** fest und klicken Sie dann auf ***Weiter***. Weitere Informationen zu diesen Einstellungen finden Sie in der [erweiterten Installation](https://docs.devolutions.net/server/de/getting-started/installation/devolutions-server-instance-creation.md#advanced-installation).
16. Geben Sie unter ***Administratorbenutzer erstellen*** den ***Benutzernamen***, das ***Passwort***, die ***Passwortbestätigung*** und die ***E-Mail*** des Administratorkontos ein und klicken Sie dann auf ***Weiter***.
17. Wählen Sie unter ***Scheduler-Dienst*** das ***Dienstkonto*** aus und klicken Sie auf ***Weiter***.
18. Legen Sie unter ***Recovery Kit*** die Optionen des Recovery Kit fest und klicken Sie auf ***Weiter***.
19. Prüfen Sie die ***Zusammenfassung*** und klicken Sie auf ***Installieren***.
20. Klicken Sie nach erfolgreicher Installation auf ***OK***.

Die Weboberfläche von Devolutions Server wird im Standardbrowser geöffnet. Melden Sie sich mit dem im Assistenten erstellten Administratorkonto an.

## PostgreSQL-Datenbank sichern

Der integrierte Sicherungsauftrag des [Backup-Managers](https://docs.devolutions.net/server/de/web-interface/administration/backup/backup-manager.md) sichert eine PostgreSQL-Datenbank mit `pg_dump` und prüft die Sicherung mit `pg_restore`. Diese Tools müssen auf dem Devolutions Server-Host verfügbar sein:

* Devolutions Server findet sie im `PATH`. Unter Windows findet er sie auch in `%ProgramFiles%\PostgreSQL\<version>\bin`, wo sie das PostgreSQL-Installationsprogramm ablegt.
* Um andere Binärdateien zu verwenden, setzen Sie die Umgebungsvariablen `DVLS_PG_DUMP_PATH` und `DVLS_PG_RESTORE_PATH` auf ihre vollständigen Pfade.
* Die Hauptversion von `pg_dump` muss gleich der Hauptversion des PostgreSQL-Servers oder neuer sein. Andernfalls schlägt die Sicherung fehl.

Der Sicherungsauftrag enthält die Verschlüsselungsschlüssel nicht. Sichern Sie sie separat.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/server/de/getting-started/installation/database-setup/database-instance/postgresql.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
