Failed upgrade due to legacy workflows

I downloaded youtrack-2020.5.3123.jar
restarted YT (as an upgrade from youtrack-2020.2.7479.jar)

Now YT won't start:
[YouTrack Error] Caused by: java.lang.IllegalStateException: Your YouTrack installation contains legacy workflows that are attached to at least one project. Here's a complete list: jetbrains-youtrack-slack
[YouTrack Error] To continue with the upgrade installation, you can either detach the workflows from all of the projects they are attached to, or convert them to JavaScript as described in this blog post:

But I can't detach workflows without starting YT; and I can't downgrade.

I'm stuck with a broken youtrack.

How do I detach workflows so I can start YT?

1 comment
Comment actions Permalink
Official comment


I'm Sergey from the Youtrack Team. 

I've just replied to your direct support request, but I will leave a comment here in case someone else faces similar issues.

Generally, this error means that you have workflows, custom scripts that allow you to manipulate how different issue-related things work in your Youtrack. These workflows use the legacy syntax. We discontinued support for the legacy workflows in version 2018.3 (more than 2 years ago). Starting from 2020.5 (the most recent Youtrack update), they stopped working completely. Over the course of this couple of years, we've sent multiple emails to the Youtrack administrators as well as submitted several blog posts about the upcoming change.

As the legacy workflow support was cut in 2020.5 completely, Youtrack doesn't start if you have such workflows in your installation.

So if you face such an issue, the best solution would be restoring a database backup to the version you had before the upgrade. Then you should remove or replace these legacy workflows in Settings → Workflows following the instructions in this blog post: After that, upgrading will work without any interruptions.

If you don't have any backups, please reach out to our support team and tell us your installation type (e.g., jar, msi, zip). We'll look for an alternative solution for your case. 

Please sign in to leave a comment.