Anki Won’t Start After an Update: The Cause Was a Release That Was Never Published

棚に並ぶ箱のうち1か所だけが空で、ダウンロードの矢印がその空きスロットに弾かれているイラスト

This post contains a referral link.

I’m Suitman, and opening Anki every day is part of my routine.

I’ve been with Anki (a flashcard app for memorizing things like English words) for 8 years, and before I knew it, I had over 15,000 cards.

Then one day, when I opened Anki as usual, an update notice popped up.

Without thinking, I clicked OK.

And then…

For some reason, a Terminal window opened by itself, with a long list of errors in English.

Wait, what is this… ( ゚д゚)

In this post
・Why Terminal opens when you update Anki
・What causes the “No solution found” error (conclusion: it wasn’t my fault)
・How to go back when “Keep existing version” has disappeared
・Why your card data doesn’t disappear

Sponsored links

I clicked OK on the update notice, and Terminal opened

This is the screen that came up.

Terminal window showing the Anki launcher failing to install because anki-release 26.9 could not be found

There was a menu at the top, and errors with red “×” marks at the bottom.

And at the end: “Install failed.”

All I did was try to update, and it failed right away…

Why does Anki open Terminal in the first place?

That was the first mystery.

I thought Anki was a normal app, so I didn’t understand why Terminal (the black window on a Mac where you type commands) would show up.

I asked Claude (an AI), “Why did it start up in Terminal this time?” Apparently, starting with version 25.07, Anki changed the way it’s distributed.

The Anki you download now is a “launcher” (an entry-point app that installs and starts the main program), and the launcher fetches the main Anki program from the internet.

Someone had asked the same question on the Anki forums, and this was the answer:

“The launcher has no GUI so output is displayed inside the Terminal.”

In other words, the launcher has no screen of its own (no buttons or windows), so it borrows Terminal to display things.

Usually there’s no update, so it starts the main program in an instant behind the scenes, and you never see Terminal.

It only shows up when it finds an update, to ask you which version you want.

By the way, the “uv” in /Applications/Anki.app/Contents/MacOS/uv in the error message is apparently a tool that installs bundles of Python (a programming language) components.

I’ve used Anki for 8 years and had no idea something like that was inside it. lol

I read the error message calmly

When I read the part with the red ×, it said this:

No solution found when resolving dependencies for split (python_full_version >= '3.10'):
Because there is no version of anki-release==26.9 and your project depends on anki-release==26.9, we can conclude that your project's requirements are unsatisfiable.

Roughly: “26.9 is required, but 26.9 doesn’t exist. So it can’t be installed.”

……

So it tried to install the latest version and was told the latest version doesn’t exist??

What does that even mean…

How to read Anki’s version numbers

By the way, Anki’s version numbers seem to be “year.month,” so 25.09.4 is the September 2025 release and 26.9 is the September 2026 release.

The menu said “Keep existing version (25.09.4),” so before I knew it, I’d been using a version from a year ago. lol

I closed Terminal, reopened Anki, and “3” was gone

Claude told me, “If you choose 3 (Keep existing version), you can keep using it as before,” so I closed all the Terminal windows and opened Anki again.

And then…

The Anki launcher menu with the Keep existing version option missing

It wasn’t there.

“3) Keep existing version” was gone.

((((;゚Д゚)))))))

All that was left were “1) Latest Anki” and “2) Choose a version.”

It seems the failed update had also wiped out the 25.09.4 setup I’d been using.

Even the option to go back had disappeared. Honestly, I panicked.

If you press “1” (Enter) in this state, it goes off to fetch the nonexistent 26.9 again and fails the same way. No matter how many times you try, it won’t fix itself, so not pressing it was the right call.

Checking the distribution server directly revealed the cause

So does 26.9 really not exist?

I asked Claude to check the distribution server where Anki’s components are stored.

The distribution server is called “PyPI” (the official place where Python components from all over the world are collected).

This is the code we used. Paste it into Terminal and run it, and it shows whether each version exists as “True” or “False.”

for pkg in anki-release anki aqt; do
  curl -s "https://pypi.org/pypi/$pkg/json" | python3 -c "
import json,sys
r=json.load(sys.stdin)['releases']
print('$pkg', '25.9.4:', '25.9.4' in r, ' 26.5:', '26.5' in r, ' 26.9:', '26.9' in r)
"
done

Here are the results.

ComponentRole25.9.426.526.9
ankiThe core of Anki✅✅✅
aqtThe user interface✅✅✅
anki-releaseThe bundle that ties the two together✅✅❌

Wait, this…

The 26.9 core (anki) and user interface (aqt) were both there, but only the “anki-release” that bundles them wasn’t.

In other words, it looks like Anki simply hadn’t published the 26.9 bundle.

The launcher decided “the latest is 26.9” and went to fetch it, but there was nothing there to fetch.

It wasn’t my mistake after all…

Once you know the cause, you can see what to do.

I reinstalled the same 25.09.4 with “2”

What to do is simple:

  • Type “2” and press Enter (Choose a version)
  • When it asks for a version, type “25.09.4” and press Enter

That’s it.

Terminal window reinstalling Anki by choosing version 25.09.4 with Choose a version

“Resolved 48 packages in 559ms” → “Anki will start shortly.”

It took a moment.

“6) Cache downloads: on” (a setting that keeps previously downloaded components on your computer) was turned on in the menu, so it seems it could reuse those components to reinstall.

And Anki started up without a problem.

It’s fixed!!! ♪( ´▽`)

Why I didn’t install the newer 26.05

The distribution server did have a newer 26.05 release, so I could have installed that instead.

But my Anki is connected to n8n (a no-code automation tool) through AnkiConnect (an add-on that lets outside tools control Anki).

With a big version jump, the add-on might not support it yet, and my automation could stop working.

So after talking it over with Claude, I decided to go back to the same version as before and wait and see this time.

I’ve also built a setup that runs automatically when I flag a card in Anki, so it would be a problem if that stopped. (More on that here.)

Some versions appeared in the menu but couldn’t be installed

Looking closely at the reinstall screen, it listed recent versions: “Latest releases: 26.09, 26.08.1, 25.09.5, 26.05, 25.07.5.”

Just to be sure, I had Claude check the distribution server, and it turned out the bundle wasn’t there for 26.08.1 either, not just 26.09.

I’d actually understood this backwards. I thought, “So if it’s not on the distribution server, it won’t show up in Terminal either?”

According to Claude, it’s the opposite.

Think of a restaurant: the dish is on the menu (the launcher’s list), but the ingredients for it never arrived at the storeroom (the distribution server).

So when you order it (install it), you get “Sorry, we don’t have that,” and it fails.

I see: just because it’s on the menu doesn’t mean you can order it. (;´Д`A

What about my cards? I checked that everything was really back

Of course, what I cared about most was my cards.

According to the official Anki manual, your decks, cards and review history are stored in a different place from the program itself (on a Mac, a folder called “Anki2”), so they stay there even if you reinstall the app.

The launcher only reinstalls the program, and your study data lives somewhere else, so there was no need to panic.

Still, I wanted to see it with my own eyes.

Just in case, Claude read the contents through AnkiConnect to check (read only, without changing anything).

curl -s localhost:8765 -X POST -d '{"action":"version","version":6}'
curl -s localhost:8765 -X POST -d '{"action":"deckNames","version":6}'
curl -s localhost:8765 -X POST -d '{"action":"findCards","version":6,"params":{"query":"deck:*"}}'

The results:

  • AnkiConnect: responding normally
  • Decks: 13
  • Cards: 15,247

Everything was there…

Eight years’ worth, safe and sound.

For fellow learners who hit the same error

For anyone who landed here after searching for this same screen, here are the steps:

  • You can close the error screen with Enter
  • Reopen Anki, and if “3) Keep existing version” is there, choose “3”
  • If “3” is gone, choose “2” and type in the version you were using before
  • Don’t press “1” (Latest Anki) until it’s fixed
  • Your card data is stored somewhere else, so don’t panic

By the way, the version you were using before is written in the parentheses of “3) Keep existing version (…)” on the first error screen.

If you take a screenshot of that first screen, it will help you know which version to go back to later.

This time, too, I had shown Claude a screenshot of the first screen, so I knew right away that the version to go back to was “25.09.4.”

Summary

All I did was click OK on an update notice, and Terminal opened with an error. Then, when I reopened Anki, even the option to go back had disappeared.

Honestly, I panicked. lol

But after reading the error message calmly and checking the distribution server directly, I found out that it was a problem on Anki’s publishing side, not my fault.

Once you know the cause, all you have to do is specify the version to go back to.

Even when an update notice appears, take a breath before clicking OK. That was the biggest lesson for me this time. lol

Especially if you automate things with add-ons like AnkiConnect, it seems wise to be careful with big version upgrades.

By the way, even though your data is stored elsewhere, backups are still important, aren’t they?

I recently wrote a post where I did a full checkup of my own 8 years of backups (here).

I hope your Anki life stays peaceful today too ♪( ´θ`)ノ

Update (September 20, 2026): the same error came back, and this time I fixed it by installing directly from the official website

A while after writing this post, I opened Anki and got another update notice.

Thinking, “This time it must be published on the distribution server,” I clicked OK…

And Terminal opened again with a similar “No solution found” error.

((((;゚Д゚)))))))

It happened again.

Last time, I went back to the previous version with “2” and waited to see what would happen. But the second time around, I started to feel, “Can I really keep leaving this to the launcher forever?”

When I asked Claude, it told me, “Instead of waiting for the distribution server to be ready, you can also download the installer directly from the official website and reinstall,” so I decided to try that this time.

The other day I’d been playing it safe because of my Anki automation, but I figured if something goes wrong after updating, I can deal with it then ♪( ´θ`)ノ

Downloading the latest version from the official Anki website

First, open the download page on the official Anki website.

The download page on the official Anki website showing “Current version is 26.09.2”

It says “Current version is 26.09.2.”

So it does exist.

Through the launcher, the bundle hadn’t been published, but the installer on the official website was already available for this version.

Download it from “Download for macOS” and open the .dmg file.

The Anki dmg installer showing the Anki icon being dragged into the Applications folder

It’s the usual screen where you drag the Anki icon into the Applications folder.

Updating by installing over the old version

When I dragged it, this confirmation appeared:

macOS dialog asking whether to replace the existing Anki with the newer version

“An older item named “Anki” already exists in this location. Do you want to replace it with the newer one you’re copying?”

I clicked “Replace” without hesitation.

Progress bar while copying Anki to the Applications folder

The copying went on…

The About Anki screen confirming the update to Version 26.09.2

When I started Anki and checked “About Anki,” it said “Version 26.09.2.”

Yes, it’s really 26.09.2…!

What I learned this time: if you skip the launcher’s update feature and install directly over the old version with the installer from the official website, you don’t have to be at the mercy of what’s been published on the distribution server.

By the way, my card data was safe this time too. As I wrote before, your study data is stored separately from the program itself, so it doesn’t disappear even if you reinstall the app.

If you’re stuck with an update through the launcher, try downloading the installer directly from the official website and installing it over the old version.

Update (November 15, 2026): when I clicked Yes on the 26.09.4 notice, it updated normally this time

When I opened Anki, another update notice appeared.

“Anki 26.09.4 has been released. Would you like to download it now?”

There were three buttons: “Ignore this update,” “No” and “Yes.”

I remembered that the last time I pressed something on this screen, Terminal opened with an error.

Before pressing anything, I had Claude check the distribution server again.

The core (anki) and user interface (aqt) for 26.9.4 were there, but there still wasn’t a single 26.9 bundle (anki-release).

The same situation as in September.

But when I pressed Yes…

It updated without any problems.

When I checked the version, it was really 26.09.4 ♪( ´▽`)

It seems updates can sometimes go through even when the bundle isn’t on the distribution server.

I still don’t know why it worked this time.

Even if you get stuck again, your cards are stored somewhere else, so there’s no need to panic.

You can go back using the steps in this post (“3” to keep your current version / “2” to choose a previous version / installing over it with the installer from the official website).

References:

Related: 3 Anki settings to change before you start

🃏 I’ve also put all my Anki posts together on one page, sorted by what you need: getting started, settings, keeping it up, automation, audio and troubleshooting.

NO IMAGE

Referral link: if you sign up through it, I may receive free lesson minutes.

🃏 Use the English from your daily Anki in conversation too

Even words I’ve learned from 15,000 cards don’t come out easily unless I use them in conversation. I try to use the phrases I learned in Anki in my Cambly lessons. Through my referral link, you get 10 extra minutes when you buy a trial. I’ve been taking lessons on Cambly since July 2021.

Try Cambly with my referral link →

The referral program isn’t available in every region.

☕ Enjoyed this post?

I'm a Japanese blogger who spent 8 years relearning English from scratch.
If this post helped you, a coffee would mean a lot — thank you for reading!

Leave a Reply

Your email address will not be published. Required fields are marked *

ABOUT US
Suitman
An office worker in Japan who has worked in three fields: education, manufacturing and sales. I started learning English at 35 and, after 8 years of keeping at it, passed Eiken Grade Pre-1. VERSANT score: 59. I write about work tips, Excel, AI, English and cameras, all based on my own experience.