--- title: "Strapi-Integrationsleitfaden" url: "https://helpdesk.kontainer.com/de/article/strapi-integrationsleitfaden/" type: "article" category: ["Admin-Einstellungen", "Integrationen & Plugins"] tags: ["DAM", "Add-on Funktion", "Strapi", "CMS integration"] language: "de" published: "2026-07-23T06:44:34+00:00" updated: "2026-08-10T11:12:03+00:00" summary: "Mit der Strapi-Integration von Kontainer können Sie Bilder, Videos und Dateien ganz einfach direkt aus Ihrem DAM in das Admin-Panel von Strapi einfügen – ohne manuelles Herunter- und Hochladen." --- # Strapi-Integrationsleitfaden Mit der Strapi-Integration von Kontainer können Ihre Redakteure Bilder, Videos und Dateien direkt aus Ihrem DAM auswählen, ohne Dateien zu Strapi hochzuladen. Strapi speichert lediglich eine Referenz zur Datei; die eigentliche Datei bleibt im Kontainer und wird über das CDN ausgeliefert. Weitere Informationen zu Anwendungsfällen, Vorteilen usw. finden Sie auf der [Kontainer-Integrationsseite.](https://kontainer.com/de/integrations/strapi-cms) ## Voraussetzungen - Strapi v5 (Strapi v4 wird nicht unterstützt) - Node.js 18+ - Ein Kontainer-Konto (https://ihrunternehmen.kontainer.com) - Ein Entwickler mit Zugriff auf Ihre Strapi-Codebasis und das Deployment ## Was wird wo gespeichert Ihre Dateien bleiben in Kontainer. Es wird nichts in die Strapi-Mediathek hochgeladen. Strapi speichert nur eine JSON-Referenz zur Datei, die folgendes enthält: - `fileId, fileName, folderId`– Kennungen zum Abrufen der Datei - `url` – die CDN-URL, einschließlich der von Ihnen gewählten Download-Vorlage - `thumbnailUrl, type, extension, Abmessungen, Dateigröße` - `alt, description` und alle benutzerdefinierten Kontainer-Felder Da der Alt-Text und alle benutzerdefinierten Feldwerte mit der Referenz übertragen werden, müssen Redakteure Metadaten nicht erneut in Strapi eingeben, und Ihr Frontend kann sie direkt aus der Strapi-API-Antwort auslesen. ## Erste Schritte ### 1. Plugin installieren In Ihrem Strapi-Projekt: `npm install @kontainer/strapi-plugin` Committen Sie package.json und package-lock.json, damit das Plugin mit Ihrem Deployment ausgeliefert wird. Strapi erkennt und aktiviert das Plugin automatisch – es sind keine Änderungen an Konfigurationsdateien erforderlich. ### 2. Kontainer-Feld zu einem Content-Type hinzufügen Wählen Sie im Content-Type Builder Custom fields → Kontainer media, oder fügen Sie es direkt zum Schema hinzu: `"hero": { "type": "customField", "customField": "plugin::kontainer.media" }` Der Content-Type Builder ist in der Produktionsumgebung nur lesbar, führen Sie diese Änderung daher in Ihrer Entwicklungsumgebung durch und deployen Sie die Schema-Änderung. ### 3. Build Die Admin-Oberfläche des Plugins wird in das Admin-Bundle kompiliert. Dieser Schritt ist erforderlich – ohne ihn erscheint die Schaltfläche „Choose from Kontainer" nicht. - Den Kontainer File Picker über ein Medienfeld in Ihrem Content-Type öffnen - Assets anhand von Metadaten, Tags oder Dateinamen suchen - Assets vor dem Einfügen in der Vorschau ansehen - Assets direkt in Ihre Content-Types und Komponenten einfügen `npm ci --omit=dev npm run build npm run start` ### 4. Mit Kontainer verbinden Gehen Sie zu Settings → Kontainer → Configuration und geben Sie Ihre Kontainer-URL ein, z. B. https://ihrunternehmen.kontainer.com. Das ist die gesamte Einrichtung – es werden keine API-Schlüssel oder Umgebungsvariablen benötigt. Die Einstellungen werden in der Strapi-Datenbank gespeichert, daher müssen Sie sie einmal pro Umgebung (Staging und Produktion getrennt) festlegen. ### 5. Assets auswählen Klicken Sie im Editor auf Choose from Kontainer im entsprechenden Feld. Durchsuchen, filtern und stöbern Sie in Ihrer Kontainer-Bibliothek, wenden Sie optional eine Download-Vorlage an (Zuschnitt, Größenänderung, Format) und wählen Sie die Datei aus. Strapi speichert die Referenz; die CDN-URL spiegelt die von Ihnen gewählte Vorlage wider. ## Optional: Nutzungsverfolgung von Dateien Kontainer kann Ihnen anzeigen, wo jede Datei in Strapi verwendet wird. Klicken Sie unter Settings → Kontainer auf Generate, um einen Token zu erstellen, und registrieren Sie anschließend die angezeigte Endpoint-URL zusammen mit dem Token als Integration in Kontainer unter Settings → Integrations. Kontainer fragt Strapi daraufhin ab und meldet die Nutzung über alle Content-Types hinweg, einschließlich Entwürfe, Sprachversionen, Komponenten und Dynamic Zones. ## Die Referenz in Ihrem Frontend verwenden Die Referenz wird unverändert von der Strapi Content-API zurückgegeben: `const page = await fetch(`${STRAPI_URL}/api/pages/${documentId}`).then((r) => r.json()); const { url, alt } = page.data.hero;` Rufen Sie die Datei über url ab – sie wird von Kontainers CDN ausgeliefert. ## Support Wenn Sie Hilfe bei der Einrichtung oder Konfiguration des Strapi-Plugins benötigen, hilft Ihnen unser Support-Team gerne weiter. Bitte kontaktieren Sie uns unter: [support@kontainer.com](mailto:support@kontainer.com) ## Other languages - [English](https://helpdesk.kontainer.com/article/strapi-integration-guide/index.md) ## Related articles - [Semantische Suche im DAM](https://helpdesk.kontainer.com/de/article/semantische-suche-im-dam/index.md): Einrichtung der semantischen Suche für DAM in Kontainer – dem DAM Search Agent – damit Nutzer Assets beschreiben können, statt Stichwörter zu erraten. Enthält die Wahl des KI-Anbieters, die Checkliste… - [Slack-Benachrichtigungen von Kontainer](https://helpdesk.kontainer.com/de/article/slack-benachrichtigungen-von-kontainer/index.md): Bringen Sie Kontainer-Benachrichtigungen direkt in Slack und bleiben Sie auf dem Laufenden, ohne mehrere Systeme überwachen zu müssen. - [Multi-Brand Guide](https://helpdesk.kontainer.com/de/article/multi-brand-guide/index.md): The Multi-Brand feature allows you to create and manage multiple branded experiences within a single Kontainer account. Each brand can have its own logo, colors, fonts, styling, and login experience,… - [WordPress Integrationsleitfaden](https://helpdesk.kontainer.com/de/article/wordpress-plugin-guide/index.md): Mit der WordPress-Integration von Kontainer können Sie Bilder, Videos und Dateien direkt aus Ihrem DAM in WordPress einfügen – ganz ohne manuelles Herunterladen und Hochladen.