# Cannot upgrade sonarqube from 8.9 to 9.X "database must be upgraded manually"

**URL:** <https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497>\
**Category:** SonarQube Server / Community Build\
**Tags:** sonarqube\
**Created:** [February 4, 2025, 9:51am UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497 "2025-02-04T09:51:13Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![callums](https://avatars.discourse-cdn.com/v4/letter/c/a87d85/32.png) [@callums](https://community.sonarsource.com/u/callums)\
**Post date:** [February 4, 2025, 9:51am UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497/1 "2025-02-04T09:51:13Z")

</div>

Must-share information (formatted with [Markdown](https://commonmark.org/help/)):

- Current Sonarqube versionl: `8.9`
- How is SonarQube deployed: Docker (CloudRun GCP) + CloudSQL database (GCP)
- What are you trying to achieve: We want to upgrade from `8.9` to `9.9 LTS` and then switch to developer edition
- What have you tried so far to achieve this:  
\*\* Upgrading Postgres from version `13` to `15`  
\*\* Before doing this we got a constant error message of `The version of SonarQube you are trying to upgrade from is too old. Please upgrade to the 9.9 Long-Term Active version first."` despite us going from `8.9` to `9.9`.  
We pulled the image via `docker pull sonarqube:9.9-community`

I’ve tried appending /setup to the end of my url but the wheel just spins and eventually I get “Service Unavailable”

---

<div class="post-metadata">

**Author:** ![callums](https://avatars.discourse-cdn.com/v4/letter/c/a87d85/32.png) [@callums](https://community.sonarsource.com/u/callums)\
**Post date:** [February 4, 2025, 12:52pm UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497/2 "2025-02-04T12:52:02Z")

</div>

I have since dropped and recreated my sonarqube database, the error message has changed to `Database needs to be migrated. Please refer to https://docs.sonarsource.com/sonarqube-server/2025.1/server-upgrade-and-maintenance/upgrade/upgrade-the-server/roadmap`

Still, when trying to go to /setup I get a “SonarQube is under maintenance” message

---

<div class="post-metadata">

**Author:** ![ganncamp](https://dub1.discourse-cdn.com/sonarsource/user_avatar/community.sonarsource.com/ganncamp/32/1261_2.png) [@ganncamp](https://community.sonarsource.com/u/ganncamp)\
**Post date:** [February 5, 2025, 1:36pm UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497/3 "2025-02-05T13:36:09Z")

</div>

Hi,

Sorry, I know you just said this but I need to verify: When you browse to `[my SonarQube URL]/setup`, you get a maintenance message?

What do your [server logs](https://docs.sonarsource.com/sonarqube-server/latest/server-upgrade-and-maintenance/troubleshooting/checking-server-logs/) say?

&nbsp;  
Ann

---

<div class="post-metadata">

**Author:** ![callums](https://avatars.discourse-cdn.com/v4/letter/c/a87d85/32.png) [@callums](https://community.sonarsource.com/u/callums)\
**Post date:** [March 3, 2025, 10:48am UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497/4 "2025-03-03T10:48:37Z")

</div>

`Database needs to be migrated. Please refer to https://docs.sonarsource.com/sonarqube-server/10.8/server-upgrade-and-maintenance/upgrade/upgrade-the-server/roadmap`

 ![image](https://europe1.discourse-cdn.com/sonarsource/uploads/sonarcommunity/original/3X/3/f/3f07eaf8e2f4a7ed6066936b3e1eaaa9818b890a.png)

---

<div class="post-metadata">

**Author:** ![ganncamp](https://dub1.discourse-cdn.com/sonarsource/user_avatar/community.sonarsource.com/ganncamp/32/1261_2.png) [@ganncamp](https://community.sonarsource.com/u/ganncamp)\
**Post date:** [March 3, 2025, 1:29pm UTC](https://community.sonarsource.com/t/cannot-upgrade-sonarqube-from-8-9-to-9-x-database-must-be-upgraded-manually/134497/5 "2025-03-03T13:29:15Z")

</div>

Hi,

Log screenshots aren’t readable, and repeating the message without commentary isn’t helpful.

&nbsp;  
Ann