Invoice Ninja
Invoice Ninja
by Invoice Ninja

VERSION 1.0.0

OS Ubuntu 18.0.4

Description

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

PackageVersionLicense
Invoice NinjaAuto-updatingAttribution Assurance License
PHP7.2PHP License v3.0.1
Nginx
MySQL
Postfix
CertbotApache License

Getting started after deploying Invoice Ninja

This image automatically downloads and installs the latest version of Invoice Ninja on the first boot. An auto-update script is also included to keep your Invoice Ninja installation up to date.

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.

Mail

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: https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-postfix-on-ubuntu-18-04

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.

FAQ:

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"}' \
      "https://api.digitalocean.com/v2/droplets"
      

Support Details

Supported By:Invoice Ninja
Support URL:https://www.invoiceninja.com/forums/forum/support/
Support Email:contact@invoiceninja.com

Learn More

Product Docs

Technical overviews, how-tos, release notes, and support material

Tutorials

DevOps and development guidelines

API Docs

Run your resources programmatically

Ask a question

Connect, share and learn