{"id":7600,"date":"2026-07-23T08:44:34","date_gmt":"2026-07-23T06:44:34","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/?post_type=article&#038;p=7600"},"modified":"2026-08-10T13:12:03","modified_gmt":"2026-08-10T11:12:03","slug":"strapi-integrationsleitfaden","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/de\/article\/strapi-integrationsleitfaden\/","title":{"rendered":"Strapi-Integrationsleitfaden"},"content":{"rendered":"<p>Mit der Strapi-Integration von Kontainer k\u00f6nnen Ihre Redakteure Bilder, Videos und Dateien direkt aus Ihrem DAM ausw\u00e4hlen, ohne Dateien zu Strapi hochzuladen. Strapi speichert lediglich eine Referenz zur Datei; die eigentliche Datei bleibt im Kontainer und wird \u00fcber das CDN ausgeliefert.<\/p>\n<p>Weitere Informationen zu Anwendungsf\u00e4llen, Vorteilen usw. finden Sie auf der <a href=\"https:\/\/kontainer.com\/de\/integrations\/strapi-cms\" target=\"_blank\" rel=\"noopener\">Kontainer-Integrationsseite.<\/a><\/p>\n<h2>Voraussetzungen<\/h2>\n<ul>\n<li>Strapi v5.50 oder h\u00f6her (Strapi v4 wird nicht unterst\u00fctzt)<\/li>\n<li>Node.js 18+<\/li>\n<li>Ein Kontainer-Konto (https:\/\/ihrunternehmen.kontainer.com)<\/li>\n<li>Ein Entwickler mit Zugriff auf Ihre Strapi-Codebasis und das Deployment<\/li>\n<\/ul>\n<p>Halten Sie Ihre Strapi-Installation mit den neuesten Minor-Releases aktuell, um vor bekannten Sicherheitsl\u00fccken gesch\u00fctzt zu sein.<\/p>\n<h2>Was wird wo gespeichert<\/h2>\n<p>Ihre Dateien bleiben in Kontainer. Es wird nichts in die Strapi-Mediathek hochgeladen. Strapi speichert nur eine JSON-Referenz zur Datei, die folgendes enth\u00e4lt:<\/p>\n<ul>\n<li><code>fileId, fileName, folderId <\/code>\u2013 Kennungen zum Abrufen der Datei<\/li>\n<li><code>url<\/code> \u2013 die CDN-URL, einschlie\u00dflich der von Ihnen gew\u00e4hlten Download-Vorlage<\/li>\n<li><code>thumbnailUrl, type, extension, Abmessungen, Dateigr\u00f6\u00dfe<\/code><\/li>\n<li><code>alt, description <\/code> und alle benutzerdefinierten Kontainer-Felder<\/li>\n<\/ul>\n<p>Da der Alt-Text und alle benutzerdefinierten Feldwerte mit der Referenz \u00fcbertragen werden, m\u00fcssen Redakteure Metadaten nicht erneut in Strapi eingeben, und Ihr Frontend kann sie direkt aus der Strapi-API-Antwort auslesen.<\/p>\n<h2>Erste Schritte<\/h2>\n<h3>1. Plugin installieren<\/h3>\n<p>In Ihrem Strapi-Projekt:<\/p>\n<p><code> npm install @kontainer\/strapi-plugin<\/code><\/p>\n<p>Committen Sie package.json und package-lock.json, damit das Plugin mit Ihrem Deployment ausgeliefert wird. Strapi erkennt und aktiviert das Plugin automatisch \u2013 es sind keine \u00c4nderungen an Konfigurationsdateien erforderlich.<\/p>\n<h3>2. Kontainer-Feld zu einem Content-Type hinzuf\u00fcgen<\/h3>\n<p>W\u00e4hlen Sie im Content-Type Builder Custom fields \u2192 Kontainer media, oder f\u00fcgen Sie es direkt zum Schema hinzu:<\/p>\n<p><code>\"hero\": {<br \/>\n\"type\": \"customField\",<br \/>\n\"customField\": \"plugin::kontainer.media\"<br \/>\n}<\/code><\/p>\n<p>Der Content-Type Builder ist in der Produktionsumgebung nur lesbar, f\u00fchren Sie diese \u00c4nderung daher in Ihrer Entwicklungsumgebung durch und deployen Sie die Schema-\u00c4nderung.<\/p>\n<h3>3. Build<\/h3>\n<p>Die Admin-Oberfl\u00e4che des Plugins wird in das Admin-Bundle kompiliert. Dieser Schritt ist erforderlich \u2013 ohne ihn erscheint die Schaltfl\u00e4che \u201eChoose from Kontainer&#8220; nicht.<\/p>\n<p><code> npm ci --omit=dev<br \/>\nnpm run build<br \/>\nnpm run start<br \/>\n<\/code><\/p>\n<h3>4. Mit Kontainer verbinden<\/h3>\n<p>Gehen Sie zu Settings \u2192 Kontainer \u2192 Configuration und geben Sie Ihre Kontainer-URL ein, z. B. https:\/\/ihrunternehmen.kontainer.com. Das ist die gesamte Einrichtung \u2013 es werden keine API-Schl\u00fcssel oder Umgebungsvariablen ben\u00f6tigt.<\/p>\n<p>Die Einstellungen werden in der Strapi-Datenbank gespeichert, daher m\u00fcssen Sie sie einmal pro Umgebung (Staging und Produktion getrennt) festlegen.<\/p>\n<p>Wenn Sie Ihre Konfiguration als Code verwalten, k\u00f6nnen Sie die Kontainer-URL stattdessen in Ihrer Strapi-Plugin-Konfiguration festlegen, zum Beispiel \u00fcber eine Umgebungsvariable. Eine im Admin-Panel gespeicherte URL hat Vorrang.<\/p>\n<h3>5. Assets ausw\u00e4hlen<\/h3>\n<p>Klicken Sie im Editor auf Choose from Kontainer im entsprechenden Feld. Durchsuchen, filtern und st\u00f6bern Sie in Ihrer Kontainer-Bibliothek, wenden Sie optional eine Download-Vorlage an (Zuschnitt, Gr\u00f6\u00dfen\u00e4nderung, Format) und w\u00e4hlen Sie die Datei aus. Strapi speichert die Referenz; die CDN-URL spiegelt die von Ihnen gew\u00e4hlte Vorlage wider.<\/p>\n<h2>Eigene Domains und Vorschaubilder<\/h2>\n<p>Das Plugin erlaubt automatisch, dass Kontainer-Vorschaubilder von kontainer.com-Domains und von einer in Ihrer Plugin-Konfigurationsdatei gesetzten URL im Strapi-Editor geladen werden. Wenn Sie eine eigene Domain verwenden und diese nur im Admin-Panel eingetragen haben, f\u00fcgen Sie die Domain den Direktiven <code>img-src<\/code> und <code>media-src<\/code> in Ihrer Strapi-Middleware-Konfiguration (<code>config\/middlewares<\/code>) hinzu. Andernfalls werden die Vorschaubilder im Editor nicht geladen. Das Plugin gibt beim Start eine Warnung im Log aus, wenn dies zutrifft.<\/p>\n<h2>Optional: Nutzungsverfolgung von Dateien<\/h2>\n<p>Kontainer kann Ihnen anzeigen, wo jede Datei in Strapi verwendet wird. Klicken Sie unter Settings \u2192 Kontainer auf Generate, um einen Token zu erstellen, und registrieren Sie anschlie\u00dfend die angezeigte Endpoint-URL zusammen mit dem Token als Integration in Kontainer unter Settings \u2192 Integrations. Kontainer fragt Strapi daraufhin ab und meldet die Nutzung \u00fcber alle Content-Types hinweg, einschlie\u00dflich Entw\u00fcrfe, Sprachversionen, Komponenten und Dynamic Zones.<\/p>\n<p>Entwickler k\u00f6nnen au\u00dferdem \u00fcber den Usage-Endpoint des Plugins (<code>\/api\/kontainer\/usage\/:fileId<\/code>) pr\u00fcfen, wo eine einzelne Datei verwendet wird, authentifiziert mit einem Strapi-API-Token.<\/p>\n<h2>Die Referenz in Ihrem Frontend verwenden<\/h2>\n<p>Die Referenz wird unver\u00e4ndert von der Strapi Content-API zur\u00fcckgegeben:<\/p>\n<p><code>const page = await fetch(`${STRAPI_URL}\/api\/pages\/${documentId}`).then((r) =&gt; r.json());<br \/>\nconst { url, alt } = page.data.hero;<\/code><\/p>\n<p>Rufen Sie die Datei \u00fcber url ab \u2013 sie wird von Kontainers CDN ausgeliefert.<\/p>\n<h2>Support<\/h2>\n<p>Wenn Sie Hilfe bei der Einrichtung oder Konfiguration des Strapi-Plugins ben\u00f6tigen, hilft Ihnen unser Support-Team gerne weiter.<\/p>\n<p>Bitte kontaktieren Sie uns unter: <a href=\"mailto:support@kontainer.com\">support@kontainer.com<\/a><\/p>\n<p>Das Plugin ist Open Source (MIT-Lizenz). Den <a href=\"https:\/\/github.com\/Kontainer-Dam-and-Pim\/kontainer-strapi-plugin\" target=\"_blank\" rel=\"noopener\">Quellcode finden Sie auf GitHub<\/a> und das <a href=\"https:\/\/www.npmjs.com\/package\/@kontainer\/strapi-plugin\" target=\"_blank\" rel=\"noopener\">Paket auf npm<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Mit der Strapi-Integration von Kontainer k\u00f6nnen Sie Bilder, Videos und Dateien ganz einfach direkt aus Ihrem DAM in das Admin-Panel von Strapi einf\u00fcgen \u2013 ohne manuelles Herunter- und Hochladen.<\/p>\n","protected":false},"author":16,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","article-category":[109,112],"article-tag":[118,117],"class_list":["post-7600","article","type-article","status-publish","hentry","article-category-admin-einstellungen","article-category-integrationen-plugins","article-tag-add-on-funktion","article-tag-dam"],"translations":{"da":{"id":8009,"title":"Integrationsguide til Strapi","url":"https:\/\/helpdesk.kontainer.com\/da\/article\/integrationsguide-til-strapi\/"},"de":{"id":7600,"title":"Strapi-Integrationsleitfaden","url":"https:\/\/helpdesk.kontainer.com\/de\/article\/strapi-integrationsleitfaden\/"},"en":{"id":7597,"title":"Strapi Integration Guide","url":"https:\/\/helpdesk.kontainer.com\/article\/strapi-integration-guide\/"},"es":{"id":8435,"title":"Gu\u00eda de integraci\u00f3n con Strapi","url":"https:\/\/helpdesk.kontainer.com\/es\/article\/guia-de-integracion-con-strapi\/"},"fr":{"id":8313,"title":"Guide d\u2019int\u00e9gration de Strapi","url":"https:\/\/helpdesk.kontainer.com\/fr\/article\/guide-dintegration-strapi\/"},"nl":{"id":8136,"title":"Integratiegids voor Strapi","url":"https:\/\/helpdesk.kontainer.com\/nl\/article\/integratiegids-voor-strapi\/"},"sv":{"id":7859,"title":"Integrationsguide f\u00f6r Strapi","url":"https:\/\/helpdesk.kontainer.com\/sv\/article\/integrationsguide-for-strapi\/"}},"_links":{"self":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/comments?post=7600"}],"version-history":[{"count":1,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600\/revisions"}],"predecessor-version":[{"id":7601,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600\/revisions\/7601"}],"wp:attachment":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/media?parent=7600"}],"wp:term":[{"taxonomy":"article-category","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-category?post=7600"},{"taxonomy":"article-tag","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-tag?post=7600"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}