Mobile Applications

The Invoice Ninja iPhone and Android applications allows a user to connect to their self-hosted Invoice Ninja web application.


If you’re unable to access the Android app store you can download the APK here:

Connecting your to your self-hosted invoice ninja installation requires a couple of easy steps.

Web App configuration

First, you’ll need to add an additional field to your .env file which is located in the root directory of your self-hosted Invoice Ninja installation.

The additional field to add is API_SECRET, set this to your own defined alphanumeric string.


Save your .env file and now open Invoice Ninja on your iPhone.

Mobile App configuration

Once you have completed the in-app purchase to unlock the mobile app to connect to your own server, you’ll be presented with two fields.

The first is the Base URL of your self-hosted installation, ie

The second field is the API_SECRET, enter in the API_SECRET you used in your .env file.


Click SAVE.

You should now be able to login with your username and password!


Q: I get a HTTP 500 error.

A: Most likely you have not entered your API_SECRET in your .env file

Q: I get a HTTP 403 error when i attempt to login with the iPhone or Android device.

A: Most likely your API_SECRET on the iPhone/Android device does not match that on your self-hosted installation.

Q: Do I need to create a token on the server?

A: No, this is not required. The server will automagically create a token if one does not exist on first login.