Upgrade v4 → v5


What is the process for upgrading from v4 to v5 please?


To upgrade from v4 you need to install v5 as a separate app and then use the migration tool in the latest version of v4 on Settings > Account Management.


I can setuo v5 easily enough then but would like to use the domain that v4 sits on, is that possible?

@david can you please advise?

Yes, should be fine, after you have migrated, change your v5 APP_URL, and then re-upload your company logo.

So if I understand correctly… In broad strokes, here’s what I nbeed to do?

  1. Install v5 on domain 2
  2. Change the v5 domain URL to domain 1
  3. Move everything to domain 1

Couldn’t I just backup the database from v4, install v5 and then overwrite the database?

Is there a documented procedure for this? Where one can use the original domain where v4 sits?

As @hillel said, Free Source Available Invoicing, Expenses & Time-Tracking | Invoice Ninja contains the procedure.

Install your v5 instance on a temporary domain/subdomain, then once it is fully migrated and working, delete your old instance and change the APP_URL environment variable (and anything else you have for your routing). (Same as what @david said…)