---
title: "KeyHelp: Konto-Vorlagen als Hosting-Tarife anlegen und Kunden per Vorlage einrichten"
date: 2026-10-01T11:51:42+02:00
modified: 2026-10-14T01:34:10+02:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-konto-vorlagen-hosting-tarife-kunden-einrichten
keywords:
  - KeyHelp
  - Webhosting
  - Linux
  - Server-Administration
  - Hosting-Tarife
reading_time: 8
---

# KeyHelp: Konto-Vorlagen als Hosting-Tarife anlegen und Kunden per Vorlage einrichten

Wer mehrere Kunden auf einem KeyHelp-Server betreut, stellt schnell fest: Jeder neue Kunde braucht die gleichen zwanzig Einstellungen für Speicher, Postfächer, Datenbanken, Berechtigungen und PHP. Konto-Vorlagen fassen diese Werte unter einem Namen zusammen, etwa „Starter“ oder „Business“, und funktionieren damit wie Hosting-Tarife. Diese Anleitung zeigt, wie Sie Vorlagen anlegen, Kunden damit einrichten und bestehende Kunden auf einen anderen Tarif umstellen. Dazu gehört auch eine Falle, die im Test sofort auffiel: Eine ausgewählte Vorlage wirkt nur, wenn Sie sie ausdrücklich übernehmen. Alle Schritte wurden auf KeyHelp 26.1.1 unter Debian 12 nachvollzogen und auf dem Server geprüft. Wie Sie KeyHelp installieren, beschreibt die Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** Konto-Vorlagen legen Sie über „Benutzerverwaltung“ › „Kunde hinzufügen“ › Link „hier“ beim Feld „Konto-Vorlage“ an (Seite „Konto-Vorlagen“). Eine Vorlage enthält Ressourcen, Berechtigungen, PHP- und PHP-FPM-Werte. Beim Anlegen eines Kunden wählen Sie die Vorlage aus und klicken auf „Vorlage übernehmen“, erst dann füllt KeyHelp das Formular. Ohne diesen Klick erhält der Kunde die strengen Grundwerte (1 MiB Speicher, alle Zähler 0). Änderungen an einer Vorlage wirken nicht auf bestehende Kunden, das bestätigt auch die API-Dokumentation.

## Voraussetzungen

- [ ] KeyHelp auf einem eigenen Server (getestet: KeyHelp 26.1.1 Build 3698, Debian 12.15), eingerichtet nach [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).
- [ ] Administratorzugang zum Panel.
- [ ] Eine Vorstellung Ihrer Tarife. Im Beispiel: „Starter“ mit 2 GiB und „Business“ mit 20 GiB.
- [ ] Optional SSH als root, um die Wirkung auf dem Server zu prüfen.

Was die einzelnen Kontingentfelder bedeuten und wie KeyHelp sie technisch durchsetzt, erklärt unsere Anleitung [KeyHelp: Kunden anlegen und Kontingente festlegen](https://s-edv.com/anleitungen/keyhelp-kunden-anlegen-kontingente-speicher-traffic-domains). Hier geht es um das Bündeln dieser Werte.

## Schritt 1: Die Seite „Konto-Vorlagen“ öffnen

Die Vorlagen haben in KeyHelp 26.1 keinen eigenen Hauptmenüpunkt. Sie erreichen sie über „Benutzerverwaltung“ › „Kundenkonten“ › „Kunde hinzufügen“. Unter dem Feld „Konto-Vorlage“ steht der Hinweis „Sie können Ihre Kontovorlagen hier verwalten“, der Link „hier“ führt zur Seite „Konto-Vorlagen“. Ab Werk existiert dort genau eine Vorlage namens „Unlimited“, die alle Ressourcen unbegrenzt freigibt.

Die Seite erklärt das Prinzip selbst: „Wenn Sie ein neues Konto hinzufügen, wählen Sie einfach den Namen der gewünschten Vorlage aus und alle Werte werden entsprechend zugewiesen.“ Wie Schritt 4 zeigt, stimmt das nur mit einem zusätzlichen Klick.

> **Prüfen:** Die Seite „Konto-Vorlagen“ zeigt eine Tabelle mit den Spalten „Name“, „Speicherplatz“, „Ressourcen“, „Berechtigungen“, „PHP / PHP-FPM“ und „Aktionen“ sowie die Schaltfläche „Konto-Vorlage hinzufügen“.

## Schritt 2: Tarif „Starter“ als Vorlage anlegen

Klicken Sie auf „Konto-Vorlage hinzufügen“. Das Formular hat die Reiter „Allgemein / Ressourcen“, „Berechtigungen“, „PHP“ und „PHP-FPM“. Es entspricht weitgehend dem Kundenformular, nur ohne Benutzername, Passwort und Kontaktdaten.

- **„Name“**: frei wählbar, nur im Panel sichtbar. Im Beispiel „Starter“.
- **Ressourcen**: 2 GiB Speicherplatz, 50 GiB Traffic, 2 Domains, 5 Subdomains, 3 E-Mail-Konten, 10 E-Mail-Adressen, 5 Weiterleitungen, 1 Datenbank, 1 FTP-Benutzer, 2 geplante Aufgaben. Entfernen Sie dazu jeweils das Häkchen „Unbegrenzt“.

![KeyHelp-Formular Konto-Vorlage hinzufügen mit Name Starter, 2 GiB Speicherplatz, 50 GiB Traffic und weiteren Ressourcen](https://s-edv.com/uploads/2026/10/011ca4dc83867c7adaae13e0e5650aaa8742fb655488fc1f1dcfd5cbbb870ca2-1024.png)
*Vorlage „Starter“ im Reiter „Allgemein / Ressourcen“*

Im Reiter „Berechtigungen“ legen Sie fest, was Kunden dieses Tarifs dürfen. Für „Starter“ wurden „FTP“, „PHP“, „Backup-Verwaltung“, „Datei-Manager“, „Domain-Sicherheit“ (Kunde darf SSL/TLS-Einstellungen wie Let's Encrypt selbst setzen), „E-Mail Catch-All“, „Control Panel-Zugriff“ und „Kontaktdaten aktualisieren“ aktiviert, SSH und DNS-Editor bleiben aus. Im Reiter „PHP“ wurde `memory_limit` auf `256M` gesetzt. Speichern Sie mit „Speichern“.

> **Prüfen:** KeyHelp meldet „Die Konto-Vorlage wurde erfolgreich hinzugefügt.“ und die Vorlage erscheint in der Liste.

## Schritt 3: Weitere Tarife ergänzen und vergleichen

Legen Sie auf die gleiche Weise weitere Tarife an. Im Beispiel „Business“: 20 GiB Speicher, Traffic unbegrenzt, 10 Domains, 25 Postfächer, 100 Adressen, 10 Datenbanken, zusätzlich SSH, DNS-Editor, „E-Mail-Einstellungen der Domain“ und „Zertifikatsverwaltung“, `memory_limit` `512M`.

Die Übersicht stellt alle Tarife nebeneinander dar. Aktive Berechtigungen sind grün markiert, inaktive grau. So prüfen Sie auf einen Blick, ob sich die Tarife sinnvoll unterscheiden.

![KeyHelp-Übersicht Konto-Vorlagen mit den Tarifen Business und Starter, Ressourcen, Berechtigungen und PHP-Werten](https://s-edv.com/uploads/2026/10/56107ccc2458816e10311046a58e271043465049d200a36b04d47dcc3a7fddff-1024.png)
*Tarifvergleich auf der Seite „Konto-Vorlagen“*

Achten Sie auch auf die PHP-FPM-Werte. Im Test übernahmen beide Vorlagen den Standard `pm = ondemand` mit `pm.max_children = 3`. Für einen größeren Tarif mit Shop sollten Sie diesen Wert im Reiter „PHP-FPM“ bewusst erhöhen, sonst hilft der größere Speicher wenig.

> **Prüfen:** Auf dem Server liegen die Vorlagen in der KeyHelp-Datenbank, Tabelle `account_templates`:
>
> ```bash
> $ mysql keyhelp -e "select id,name,disk_space,domains,email_accounts from account_templates"
> ```

Unbegrenzte Werte stehen dort als `-1`.

> **Prüfen:** Die Abfrage muss Ihre Vorlagennamen und Kontingente zeigen; -1 bedeutet unbegrenzt.

## Schritt 4: Neuen Kunden per Vorlage einrichten

Öffnen Sie „Benutzerverwaltung“ › „Kundenkonten“ › „Kunde hinzufügen“. Tragen Sie Benutzername, E-Mail-Adresse und Passwort ein (über „Generieren“ erzeugt KeyHelp ein starkes Passwort). Wählen Sie unter „Konto-Vorlage“ den Tarif und klicken Sie dann auf **„Vorlage übernehmen“**.

![KeyHelp-Formular Kunde hinzufügen, Reiter Allgemein mit Benutzername kunde2 und ausgewählter Konto-Vorlage Starter samt Schaltfläche Vorlage übernehmen](https://s-edv.com/uploads/2026/10/eb04a4f7dbde8b2fc45e20b5c3f64e89255bf3268d5a49afc208ef6409491ed9-1024.png)
*Auswahl der Vorlage im Reiter „Allgemein“*

Der Klick lädt die Werte der Vorlage in die Reiter „Ressourcen“, „Berechtigungen“, „PHP“ und „PHP-FPM“. Prüfen Sie sie kurz und passen Sie bei Bedarf einzelne Werte an, zum Beispiel einen Sonderwunsch beim Speicher. Danach „Speichern“.

> **Prüfen:** Nach etwa einer Minute hat der KeyHelp-Cronjob die Einstellungen auf das System übertragen. Für den Testkunden `kunde2` mit Vorlage „Starter“:
>
> ```bash
> $ mysql keyhelp -e "select username,diskspace_max,traffic_max,domains_max,emailaccounts_max from users where username='kunde2'"
> ```
>
> ```bash
> # kunde2  2147483648  53687091200  2  3
> ```
>
> ```bash
> $ grep memory_limit /etc/php/8.2/fpm/pool.keyhelp.d/kunde2.conf
> ```
>
> ```bash
> # php_admin_value[memory_limit] = 256M
> ```

Der Speicher steht als 2 GiB in Bytes in der Datenbank, der PHP-Wert der Vorlage im eigenen PHP-FPM-Pool des Kunden.

> **Prüfen:** Vergleichen Sie die gespeicherten Kontingente und PHP-Werte mit der Vorlage.

## Schritt 5: Bestehenden Kunden auf einen anderen Tarif umstellen

Ein Upgrade funktioniert genauso: „Benutzerverwaltung“ › „Kundenkonten“ › Stiftsymbol beim Kunden. Auch im Bearbeiten-Formular gibt es das Feld „Konto-Vorlage“ mit „Vorlage übernehmen“. Im Test wurde `kunde3` so auf „Business“ umgestellt.

> **Prüfen:** KeyHelp meldet „Der Benutzer kunde3 wurde aktualisiert. Die Änderungen werden in wenigen Augenblicken wirksam.“ Auf dem Server zeigte sich danach die neue Quota (20 GiB), `memory_limit = 512M` im FPM-Pool und, weil „Business“ SSH erlaubt, eine echte Login-Shell:
>
> ```bash
> getent passwd kunde3
> # kunde3:x:5003:5003::/home/users/kunde3/:/bin/bash
> quota -u kunde3 | tail -1
> # /dev/sda2  216  20971520 20971520  14  2621440 2621440
> ```

Kunden ohne SSH-Berechtigung, im Test etwa `kunde2` mit „Starter“, stehen dagegen in der Gruppe `keyhelp_nossh` und haben die Shell `/bin/false`. Ein Tarifwechsel kann also Sicherheitsrechte ändern. Prüfen Sie die Berechtigungen vor dem Speichern.

> **Prüfen:** Vergleichen Sie Kontingente und SSH-Berechtigung mit dem gewählten Tarif.

## Schritt 6: Vorlagen ändern und alte Tarife entfernen

Tarife ändern sich mit der Zeit. Über das Stiftsymbol in der Liste „Konto-Vorlagen“ bearbeiten Sie eine Vorlage, über den Papierkorb entfernen Sie sie. Vor dem Löschen zeigt KeyHelp eine Bestätigungsseite mit Name und Speicherplatz der Vorlage. Erst wenn Sie die Checkbox „Bestätigung“ setzen und „Löschen“ klicken, verschwindet sie, gefolgt von der Meldung „Die folgenden Elemente wurden gelöscht.“

Weil Kunden nicht mit der Vorlage verknüpft sind, ist das Löschen gefahrlos. Im Test wurde die Vorlage „Starter“ gelöscht, während `kunde2` damit eingerichtet war. Der Kunde behielt seine 2 GiB Speicher und 2 Domains, die Quota auf dem Server blieb unverändert. Für eine saubere Tarifpflege empfiehlt sich deshalb ein einfacher Ablauf: neue Vorlage mit Versionshinweis im Namen anlegen, etwa „Starter 2027“, Bestandskunden bei Bedarf einzeln umstellen und die alte Vorlage erst danach löschen. So bleibt nachvollziehbar, welcher Kunde welchen Stand hat.

> **Prüfen:** Nach dem Löschen fehlt die Vorlage in der Liste und im Auswahlfeld „Konto-Vorlage“. Die betroffenen Kunden zeigen in „Benutzerverwaltung“ › „Kundenkonten“ weiterhin ihre bisherigen Werte:
>
> ```bash
> quota -u kunde2 | tail -1
> # /dev/sda2  216  2097152 2097152  14  262144  262144
> ```

> **Prüfen:** Die Vorlage muss fehlen, die Kontingente der Kunden müssen unverändert bleiben.

## Typische Fehler

### Vorlage ausgewählt, aber nicht übernommen

Im Test wurde `kunde3` mit ausgewählter Vorlage „Business“ gespeichert, ohne auf „Vorlage übernehmen“ zu klicken. KeyHelp meldete Erfolg, der Kunde hatte aber nur 1 MiB Speicher, unbegrenzten Traffic und 0 Domains, also die Grundwerte des Formulars. Die Auswahl im Feld allein bewirkt nichts.

![KeyHelp-Kundenübersicht mit kunde2 bei 2 GiB nach Vorlage Starter und kunde3 mit nur 1 MiB, weil die Vorlage nicht übernommen wurde](https://s-edv.com/uploads/2026/10/9b1a7022c7c5dc80d5bf0c19d8e4141d8143a51761f7b4d9cf0d389bfbb4144e-1024.png)
*kunde3 wurde ohne „Vorlage übernehmen“ gespeichert und hat nur 1 MiB*

### Vorlage geändert, Kunden bleiben alt

Die Vorlage „Starter“ wurde nachträglich auf 3 GiB erhöht. KeyHelp meldete „Die Konto-Vorlage wurde erfolgreich aktualisiert.“, der bestehende Kunde blieb aber bei 2 GiB. Eine Verknüpfung zwischen Kunde und Vorlage speichert KeyHelp nicht. Die mitgelieferte API-Dokumentation sagt dazu: „Client accounts are not automatically updated when a hosting plan is updated.“ Bei einer Tarifänderung müssen Sie jeden Kunden einzeln neu übernehmen.

### „- Standard-Vorlage -“ ist kein Tarif

Die Auswahl „- Standard-Vorlage -“ setzt die Grundwerte des Formulars ein: 1 MiB Speicher, alle Zähler auf 0, Traffic unbegrenzt, `memory_limit` 128M. Sie eignet sich zum Zurücksetzen, nicht als Tarif.

## Häufige Fragen

### Kann ich Vorlagen per REST-API nutzen?

Ja. In der API heißen Vorlagen „hosting plans“. Beim Anlegen eines Kunden übergeben Sie die ID im Feld `id_hosting_plan`. Laut API-Dokumentation wird ohne Angabe der Standard-Plan verwendet. Mehr dazu in der Anleitung zur [KeyHelp-REST-API](https://s-edv.com/anleitungen/keyhelp-rest-api-kunden-domains-postfaecher-automatisieren).

### Sieht der Kunde, welchen Tarif er hat?

Nein, der Vorlagenname wird nicht beim Kunden gespeichert. Der Kunde sieht im Dashboard nur seine Kontingente in der Karte „Ressourcen“. Den Tarif sollten Sie deshalb in Ihrer Kundenverwaltung oder im Feld „Notizen“ des Kunden festhalten.

### Was passiert mit der Vorlage „Unlimited“?

Sie ist ab Werk vorhanden und gibt alles frei, auch DNS-Editor, Datenbank-Fernzugriff und „Hauptdomains löschen“. Für normale Kunden ist sie zu großzügig. Sie können sie löschen oder umbenennen.

### Werden Kunden in Gruppen nach Tarif sortiert?

Dafür gibt es „Kundengruppen“. In der kostenlosen Edition ist dieser Reiter als „Pro-Feature“ markiert.

## Fazit

Konto-Vorlagen sparen bei jedem neuen Kunden viele Klicks und sorgen für einheitliche Tarife. Sie sind aber reine Ausfüllhilfen: KeyHelp kopiert die Werte einmalig ins Formular und merkt sich danach keine Verbindung. Das hat zwei Folgen. Sie müssen „Vorlage übernehmen“ jedes Mal bewusst klicken, und Tarifänderungen müssen Sie bei bestehenden Kunden nachziehen. Wer das weiß, bekommt mit zwei oder drei gepflegten Vorlagen eine saubere Tarifstruktur, auch ohne Pro-Edition.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp: Kunden anlegen und Kontingente festlegen](https://s-edv.com/anleitungen/keyhelp-kunden-anlegen-kontingente-speicher-traffic-domains)
- [KeyHelp-REST-API: Kunden, Domains und Postfächer automatisieren](https://s-edv.com/anleitungen/keyhelp-rest-api-kunden-domains-postfaecher-automatisieren)
- [KeyHelp Knowledge Base: Konto-Vorlage hinzufügen / bearbeiten](https://kb.keyhelp.de/article/konto-vorlage-hinzuf%C3%BCgen-bearbeiten-131.html)
- [Keyweb: KeyHelp Hosting-Panel](https://www.keyweb.de/de/keyhelp/keyhelp/)
