Updating Invoice Ninja v4 on Shared Hosting



This post is related to a prior one done about installing InvoiceNinja on shared hosting. You can view that at the link below.

Thanks for this go to @david and @hillel on the InvoiceNinja forums. Keep up the good work guys!

I’ve not found another dedicated invoice system that works better. I highly recommend the paid version for persons who can afford it. It would remove the hassle of having to do all the work on the back-end and also remove all of the system requirements.

This assumes you already have a v4 installation present.


You cannot directly update from v4 to v5. If you attempt this – stuff may not work. Will probably cover this later on (if I get it working). As of this writing there is no way to install v5 without PROC_OPEN available.


Before doing an update – above all else – it would be best to have a PHP option called PROC_OPEN available. Without this a lot of things may fail. So let’s list them.

  • PHP 7.3.
    • For v4 (4.5.39 as of this post) do not pass PHP 7.3 – it may cause problems.
  • proc_open (PHP).
  • FTP client (like FileZilla).

This I would class as medium difficulty. So here we go. There are two main methods.


If your hosting provider allows proc_open then simply:

  1. Download the latest v4 (4.5.39 as of this post).
  2. Extract the files.
  3. Backup your ENV file.
  4. Upload the contents of the ZIP to your web folder/directory.
    • Overwrite all files.

That’s it. Navigate to your invoice URL after and use it. The second method however is a bit more tedious.


This takes a bit more time. A listing of what to do would be:

  • Backup your database.
  • Export your settings (just in case).
  • Remove 2FA (if enabled). You can put it back when done.
  • Rename the current folder (ninja) to something else (ninja.old).
  • Download and extract the current v4.
  • Create your usual working folder (ninja).
  • Upload your extracted updated v4 to the folder (ninja).
  • Go through the setup process – but point the database settings to the existing DB.
    • You may use all of your original credentials/passwords.
  • Log in with your credentials.
  • Verify everything is working.
  • Setup 2FA once more if you had it before.
    • Or set it up just because.

I’ll be editing this post later on and adding photos of the steps – but for getting the information out there – that’s it. Hopefully this will help you with updating your InvoiceNinja.



Leave a Reply