---
title: "Config Module"
source: "https://ayoune.com/en/docs/api-reference/config-module"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "API-Referenz"
language: "en"
retrieved: "2026-09-11T17:19:17.748Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# Config Module

Das Config-Modul ist die Schaltzentrale der Plattform: 165+ CRUD-Endpoints für Credentials, Feature-Flags, Notification-Channels, Computing-Entities, Module-States. Routing: `config-api.ayoune.app`.

## Warum so viele Endpoints?

Config ist das Catch-All für **Cross-Cutting-Settings**. Statt jede Funktion in eigenes Modul zu zerlegen, leben hier zentrale Sub-Domänen:

| Sub-Domäne | Endpoints |
|---|---|
| Credentials & Secrets | `credentials`, `apikeys`, `oauthtokens` |
| Feature-Flags | `flags`, `flagrules`, `flaghistory` |
| Notifications | `notificationchannels`, `notificationtemplates`, `notificationroutes` |
| Computing-Entities | `computingentities`, `programs`, `installations` |
| State-Registry | `ayounestates`, `modulestate-cache` |
| Translation | `translations`, `locales` |
| Marketplace | `marketplaceapps`, `bundles`, `installations` |
| Branding | `themes`, `assets` |

## Credentials-Vault

Sensible Daten (API-Keys, OAuth-Tokens, SMTP-Passwörter) liegen verschlüsselt (AES-256-CTR) in `credentials`. Pro Customer separat.

```bash
ay credentials list
ay credentials get <id>
ay credentials create "Stripe Prod" --type stripe \
  --set credentials.secretKey=sk_live_xxx
ay credentials test <id>            # Provider-Roundtrip
ay credentials decrypt <id>         # Klartext (audit-protokolliert!)
ay credentials refresh <id>         # OAuth-Refresh
ay credentials revoke <id>
```

Felder:

| Feld | Hinweis |
|---|---|
| `name` | Display |
| `type` | Provider-Slug (`stripe`, `paypal`, `twilio`, ...) |
| `credentials` | Verschlüsselter Sub-Doc |
| `_status` | `active` / `expired` / `revoked` |
| `lastTestedAt` | Date |
| `lastTestStatus` | `ok` / `fail` |

Rights: `config.credentials.{view|create|edit|delete|decrypt|test}`. `decrypt` und `delete` sollten nur Admins haben.

## Feature-Flags

Bereits ausführlich beschrieben unter [Admin-Handbook → Feature Flags](wiki:admin-handbook/feature-flags). Endpoints:

```bash
GET   /flags
GET   /flags/:slug
POST  /flags
PATCH /flags/:slug
POST  /flags/:slug/actions/toggle
```

## Notifications

11 Channels, n Templates, m Routes. Endpoints:

```bash
GET  /notificationchannels
GET  /notificationtemplates
GET  /notificationroutes
POST /notificationroutes/:id/actions/test
```

Mehr unter [Admin-Handbook → Notifications](wiki:admin-handbook/notifications).

## Computing-Entities

Virtuelle Maschinen, Container, Cron-Boxen pro Customer. Wird vom `desktop-client` und `programs`-Service genutzt.

| Feld | Hinweis |
|---|---|
| `name` | Display |
| `type` | `vm-aws` / `vm-hetzner` / `container` / `cron` |
| `awsState` | `running` / `stopped` / `terminated` |
| `ipAddress` | string |
| `tags` | Routing/Cost-Center |

## State-Registry

`ayounestates` ist die zentrale Registry für UI-States — von `registerModuleStates(moduleName, states[])` aus dem Core gefüllt. Jeder State enthält:

- `_module` (Modul-Name)
- `_appName` (Scope, default `AYOUNE_RELEASE_NAME`)
- `name` (z.B. `crm.consumers`)
- `stateType` (`module-overview`, `table`, `right`, ...)
- `cols`, `filters`, `actions`, `links`

Mehr unter [Self-Hosting Setup](wiki:self-hosting/getting-started) — Pods schreiben das beim Boot.

## Translation

`translations` enthält alle UI-Strings + Block-Texte:

| Feld | Hinweis |
|---|---|
| `key` | dot.notation |
| `locale` | `de`, `en`, ... |
| `value` | string |
| `module` | Scope |

CLI-Helfer:

```bash
ay exec translations:export --locale de --out ./de.json
ay exec translations:import --file ./de.json
```

## Verbindungen

- [Admin-Handbook → Feature Flags](wiki:admin-handbook/feature-flags)
- [Admin-Handbook → Notifications](wiki:admin-handbook/notifications)
- [Self-Hosting → Environment Variables](wiki:self-hosting/environment-variables)

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-09-11 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com