Inquiry About Upgrading Self-Hosted KoBoToolbox Server

[naylinsoe]

Hi,

I am currently using a self-hosted KoBoToolbox server, version 2.024.36h, since April 2025. I would now like to upgrade my server to the latest version, 2.026.03c.

Could you please advise me on the step-by-step process for upgrading? Is running the command below sufficient?

$ kobo-install> python3 run.py --update

Or are there any preparations or additional steps I should complete before running the update?

Best regards,

Nay Lin Soe

[Kal_Lam]

@naylinsoe, this post discussed previously should help you with your issue:

Upgrading to separate databases for KPI and KoBoCAT

Background KoBoToolbox previously used a shared Postgres database for its two Django applications, KPI and KoBoCAT. Since this has some disadvantages—including the requirement that Django be updated in lockstep across both apps—we’ve decided to give KPI and KoBoCAT their own, separate Postgres databases. KoBoCAT has responsibility for storing all form submissions and, as a result, generally has a larger amount of data than KPI. For this reason, our approach is to copy the KPI tables from the or…