INTRODUCTION

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

Setup Invoice Ninja on HostGator (Shared)

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.

!!!MAJOR NOTICE!!!

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.

REQUIREMENTS

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.

METHOD #1 – PROC_OPEN AVAILABLE

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.

METHOD #2 – PROC_OPEN NOT AVAILABLE

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.

Comments

comments