Loading...

InvoiceNinja Install CentOS with Apache

This application is quite useful for tracking payments. This quick tip is going to only go over the app installation for self-hosted versions (not setting up a server from scratch).

What you need to have:

  1. A CentOS server and Apache with PHP updated to version 7 or greater. (By default you usually get PHP 5.6. You may need to manually update this to 7. There are tutorials online for this)
  2. Knowledge or Google-Fu on Virtual Hosts with Apache
  3. Basic knowledge on moving files/ editing files within a Linux system.

What you need to do:

  1. Download the files. You can do this through commands like wget on the box or download it from www.invoiceninja.com on a Windows box and upload it to your web server.
  2. Extract the files either on your linux box or before uploading them through a utility like Filezilla
  3. Move (mv) the files to your web directory (IE: /var/www/html)
  4. I tend to put the application under a folder called ninja and modify permissions/ owner appropriately. Modify/ create a Virtual host for 80 and 443 pointed to the directory /var/www/html/ninja/public.
  5. cd /var/www/html/ninja
  6. composer install
  7. composer update
  8. Now when you navigate to your URL (IE: website.com or web.site.com), you’ll get the setup prompts.

Remember & Note

  • The .env is your settings file. It’s required to connect to any existing database if you are doing an update. If you update, please move this file to the new folder you upload.
  • Composer is a utility that will download necessary dependencies that Ninja will need to run. I tend to run these two commands every time I update the software to get the latest and greatest versions of all the dependencies.

 

Updating InvoiceNinja on Windows Bitnami Install (Also works with Linux)

This guide will show you how to update your Bitnami NinjaInvoice Stack on Windows to the latest. Note: This did work with no issues going from 2.5.2.2 to 2.9.1 which is the current version as of today. For Linux, review steps 6-12.

  1. Navigate to C:\Bitnami\invoiceninja-2.5.2.2-0\apps\invoiceninja\htdocs
  2. Download the latest copy of InvoiceNinja from https://www.invoiceninja.com/self-host/
  3. Extract the contents of the freshly downloaded zip file
  4. I suggest renaming the HTDOCS folder before doing this… it creates an extra step or two but it might be worth it.
  5. Create a new htdocs folder
  6. Paste all of the contents of the downloaded zip file into the folder (or www\ninja folder for Linux).
  7. Go to your OLD install and copy the .env in the root directory to your new folder. This is the file that contains settings such as database connection settings.
  8. Go to your url with /update at the end. IE: www.mywebsite.com/ninja/update
  9. Wait a while for the upgrade.
  10. It should say successful. In a new tab, attempt to browse to the page! Should be updated and good to go.

Note: Bitnami no longer supports InvoiceNinja. You may have a hard time finding a copy. It’s relatively easy to install on Centos with Apache in my experience. The documentation for install is pretty great too.

error: