Skip to content

Commit f2e520a

Browse files
committed
docs: note v3 is retired and 4.5.0 is the last version supporting v3
v3 (SDK v3) is end of life. Adds a callout on the self-hosting overview and in the docker and kubernetes version-locking sections: 4.5.0 is the last version we officially support for running v3, so stay on 4.5.0 or migrate to v4, since 4.5.1 and later reject v3 triggers and deploys. The migration guide now describes v3 as retired rather than upcoming, and a stale "v3 project" reference in the CLI overview is fixed.
1 parent 5ba8557 commit f2e520a

6 files changed

Lines changed: 26 additions & 9 deletions

File tree

.server-changes/remove-v3-engine.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@ area: webapp
33
type: breaking
44
---
55

6-
Removed support for the end-of-life v3 engine. Instances or projects still on v3 must stay on the 4.5.x release line or upgrade to v4; v3 triggers, batch triggers, reschedules, and deploys now return a clear upgrade message instead of running.
6+
Removed support for the end-of-life v3 engine. 4.5.0 is the last version we officially support for running v3, so instances or projects still on v3 must stay on 4.5.0 or upgrade to v4; v3 triggers, batch triggers, reschedules, and deploys now return a clear upgrade message instead of running.

docs/cli-introduction.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ import VersionOption from '/snippets/cli-options-version.mdx';
1818
| [login](/cli-login-commands) | Login with Trigger.dev so you can perform authenticated actions. |
1919
| [init](/cli-init-commands) | Initialize your existing project for development with Trigger.dev. |
2020
| [dev](/cli-dev-commands) | Run your Trigger.dev tasks locally. |
21-
| [deploy](/cli-deploy-commands) | Deploy your Trigger.dev v3 project to the cloud. |
21+
| [deploy](/cli-deploy-commands) | Deploy your Trigger.dev project to the cloud. |
2222
| [whoami](/cli-whoami-commands) | Display the current logged in user and project details. |
2323
| [logout](/cli-logout-commands) | Logout of Trigger.dev. |
2424
| [list-profiles](/cli-list-profiles-commands) | List all of your CLI profiles. |

docs/migrating-from-v3.mdx

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,14 @@ import NodeVersions from "/snippets/node-versions.mdx";
77
import MigrateV4UsingAi from "/snippets/migrate-v4-using-ai.mdx";
88

99
<Warning>
10-
**Action required: Trigger.dev v3 deprecation**
10+
**Trigger.dev v3 has been retired**
1111

12-
We're retiring Trigger.dev v3. **New v3 deploys will stop working from 1 April 2026.** Trigger.dev v4 is stable, fully supported, and recommended for all users.
12+
Trigger.dev v3 is end of life. v4 is stable, fully supported, and recommended for all users.
1313

14-
**Key dates:**
14+
- On Trigger.dev Cloud, v3 has been shut down: v3 triggers and deploys no longer run.
15+
- If you self-host, 4.5.0 is the last version we officially support for running v3. Stay on 4.5.0 or upgrade to v4; 4.5.1 and later reject v3 triggers, batch triggers, and deploys with an upgrade message.
1516

16-
- **1 April 2026** — New v3 deploys will no longer work. Existing v3 runs will continue to execute.
17-
- **1 July 2026** — v3 will be fully shut down. All v3 runs will stop executing.
18-
19-
**What you need to do:** Migrate to v4 before April to avoid disruption to your task executions. The migration takes about 2 minutes — follow the steps on this page below. If you have questions or need help, [contact us](https://trigger.dev/contact) or reach out in our [Discord](https://trigger.dev/discord).
17+
**What you need to do:** Migrate to v4. The migration takes about 2 minutes, follow the steps on this page below. If you have questions or need help, [contact us](https://trigger.dev/contact) or reach out in our [Discord](https://trigger.dev/discord).
2018

2119
</Warning>
2220

docs/self-hosting/docker.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -344,6 +344,12 @@ TRIGGER_IMAGE_TAG=v4.5.0
344344
345345
We patch the latest released version line only, so keep an eye on new releases to receive security fixes. See [Security & vulnerability reporting](/self-hosting/security).
346346
347+
<Note>
348+
Trigger.dev 4.5.0 is the last version we officially support for running v3 (SDK v3) tasks. If
349+
you still have v3 tasks, pin `TRIGGER_IMAGE_TAG` to exactly `v4.5.0` or [migrate to
350+
v4](/migrating-from-v3). 4.5.1 and later reject v3 triggers and deploys with an upgrade message.
351+
</Note>
352+
347353
## Task events
348354
349355
By default, task events (timeline, logs, spans) are stored in PostgreSQL. For production deployments we recommend storing them in ClickHouse instead, it scales to much higher volumes and avoids unbounded growth of the `TaskEvent` table.

docs/self-hosting/kubernetes.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -528,6 +528,12 @@ webapp:
528528

529529
## Version locking
530530

531+
<Note>
532+
Trigger.dev 4.5.0 is the last version we officially support for running v3 (SDK v3) tasks. If
533+
you still have v3 tasks, pin to exactly 4.5.0 or [migrate to v4](/migrating-from-v3). 4.5.1 and
534+
later reject v3 triggers and deploys with an upgrade message.
535+
</Note>
536+
531537
You can lock versions in two ways:
532538

533539
**Helm chart version (recommended):**

docs/self-hosting/overview.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,13 @@ You are responsible for provisioning resources, handling updates, and managing a
1010

1111
We provide version-tagged releases for self-hosted deployments. It's highly advised to use these tags exclusively and keep them locked with your CLI version.
1212

13+
<Warning>
14+
**v3 is end of life.** Trigger.dev 4.5.0 is the last version we officially support for running
15+
v3 (SDK v3) tasks. If you still have v3 tasks, stay on 4.5.0 or [migrate to
16+
v4](/migrating-from-v3). 4.5.1 and later reject v3 triggers, batch triggers, and deploys with an
17+
upgrade message; v4 workloads are unaffected.
18+
</Warning>
19+
1320
## Should you self-host?
1421

1522
Trigger.dev Cloud is fully managed, scalable, and comes with dedicated support. For most users, it offers the best experience. However, if you have specific requirements around data residency, compliance, or infrastructure control, self-hosting may be the right choice for you.

0 commit comments

Comments
 (0)