<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[[GUIDE] Directus v12 migration]]></title><description><![CDATA[<p dir="auto">With <a class="plugin-mentions-category plugin-mentions-a" href="/category/101/directus" aria-label="Profile: directus">@<bdi>directus</bdi></a> version 12 some things have changed, see <a href="https://github.com/directus/directus/releases/tag/v12.0.0" target="_blank" rel="noopener noreferrer nofollow ugc">v12.0.0 Changelog and Potential Breaking Changes</a>.</p>
<p dir="auto">For Cloudron users the biggest issue will be the following:</p>
<blockquote>
<p dir="auto">This change affects instances previously using features that now require a license, including:</p>
<ul>
<li>SSO — SSO login will no longer work. Users who authenticate through SSO will be unable to log in and must be converted to email and password users to regain access.</li>
</ul>
</blockquote>
<p dir="auto">We advise applying for an "Open Innovation Grant" licence here: <a href="https://directus.com/oig" target="_blank" rel="noopener noreferrer nofollow ugc">https://directus.com/oig</a> if you are eligible for it.<br />
With such a licence you can fully migrate to Directus v12 without losing any features and functions.</p>
<h2>Option 1: Setting the licence in the <code>/app/data/env.sh</code> file</h2>
<p dir="auto">Open the <a href="https://docs.cloudron.io/apps#file-manager" target="_blank" rel="noopener noreferrer nofollow ugc">Web File Manager</a> of your <a class="plugin-mentions-category plugin-mentions-a" href="/category/101/directus" aria-label="Profile: directus">@<bdi>directus</bdi></a> app and add the following line:</p>
<pre><code class="language-bash">export LICENSE_KEY="YOUR_LICENSE_KEY"
</code></pre>
<p dir="auto"><a href="https://docs.cloudron.io/apps#restart-app" target="_blank" rel="noopener noreferrer nofollow ugc">Restart</a> your <a class="plugin-mentions-category plugin-mentions-a" href="/category/101/directus" aria-label="Profile: directus">@<bdi>directus</bdi></a> app.</p>
<h2>Option 2: Admin facing modal for migration</h2>
<p dir="auto">After updating <a class="plugin-mentions-category plugin-mentions-a" href="/category/101/directus" aria-label="Profile: directus">@<bdi>directus</bdi></a> to version v12 you get greeted with the following view:<br />
<img src="/assets/uploads/files/1781519306771-42507b50-d978-457a-a10a-e68fd25961f8-image.jpeg" alt="42507b50-d978-457a-a10a-e68fd25961f8-image.jpeg" class=" img-fluid img-markdown" /><br />
Press the <code>Continue</code> button.</p>
<p dir="auto">This view gives the option to either manage your licence or disable SSO.<br />
Press the <code>Manage License</code> button:<br />
<img src="/assets/uploads/files/1781519468394-07ede64b-64cf-4284-bcd5-d05198002713-image-resized.jpeg" alt="07ede64b-64cf-4284-bcd5-d05198002713-image.jpeg" class=" img-fluid img-markdown" /></p>
<p dir="auto">Following that, press the <code>Add License</code> button:<br />
<img src="/assets/uploads/files/1781519732143-4285519e-9c1e-4777-a47a-b5c8a4bb3db2-image-resized.jpeg" alt="4285519e-9c1e-4777-a47a-b5c8a4bb3db2-image.jpeg" class=" img-fluid img-markdown" /></p>
<p dir="auto">Enter your licence key (1) and press save (2):<br />
<img src="/assets/uploads/files/1781519817508-7c9fff72-1229-4b54-9e45-b9b242729d17-image.jpeg" alt="7c9fff72-1229-4b54-9e45-b9b242729d17-image.jpeg" class=" img-fluid img-markdown" /></p>
]]></description><link>https://forum.cloudron.io/topic/15615/guide-directus-v12-migration</link><generator>RSS for Node</generator><lastBuildDate>Mon, 15 Jun 2026 20:44:16 GMT</lastBuildDate><atom:link href="https://forum.cloudron.io/topic/15615.rss" rel="self" type="application/rss+xml"/><pubDate>Mon, 15 Jun 2026 10:37:35 GMT</pubDate><ttl>60</ttl></channel></rss>