Invoice Ninja
Invoice Ninja
by Invoice Ninja

Version 1.0.0

OS Ubuntu 18.0.4



Invoice Ninja

The #1 open-source platform to create & email invoices, track payments and expenses, and time billable tasks & projects for clients.

A Free Suite of Apps to Run Your Business

Invoicing, payments, proposals, projects. Small business? Freelancer? Spend less time on paperwork and more time at your craft.

Less time working, more time living. Create. Send. Get Paid.

Software Included

Getting started after deploying Invoice Ninja

This image automatically downloads and installs a recent version of Invoice Ninja (v4.5.19) on the first boot. An auto-update script is also included to keep your Invoice Ninja installation up to date. The installed version is the latest version in the 4.x branch, and an upgrade to 5.x shall happen in the future.

After the server boots and installation has finished, you can visit your server’s URL in a web browser to complete the Invoice Ninja setup process. The Database Connection section is pre-filled with connection information for the database and user that was created for you. We recommend installing an HTTPS certificate (see below) and setting the application URL, as well as configuring an external mail server before continuing.

HTTPS Certificate

Once the server has been created, you can connect to the server via SSH. Run sudo certbot -d <domain name> to generate and install an HTTPS certificate using Let’s Encrypt.

The image includes a cron job to automatically renew any certificates installed using Certbot.


The image includes a Postfix server; however without additional configuration, your emails will likely be rejected by most email providers.

See the following guide for more information:

Note: Due to the difficulties of configuring and maintaining a mail server for high deliverability rates, we recommend using an external email service such as Mailgun.


Q: My emails are not being delivered.

A: Most likely you have not configured a mail service and have set up the built in Postfix server. We creating a Mailgun account and entering your credentials under Settings -> System Settings -> Email Settings.

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

A: No, this is not required. The server automatically creates a MySQL database and user on the first boot.

API Creation

In addition to creating a Droplet from the Invoice Ninja 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Invoice Ninja Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.

  curl -X POST -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer '$TOKEN'' -d \
      '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"invoiceninja-18-04"}' \

Support Details

Supported By:Invoice Ninja
Support URL: