Mirrors/invoiceninja
1
0
Fork 0
mirror of https://github.com/invoiceninja/invoiceninja.git synced 2024-09-20 08:21:34 +02:00
Code Issues Releases Activity

Merge pull request #2925 from joshuadwire/develop

Browse Source 
Add Digital Ocean image docs (develop)
This commit is contained in:
Hillel Coren 2019-08-10 20:52:44 +03:00 committed by GitHub
commit c69f9e652c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 38 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
docs/digital_ocean.rst Normal file
View File

@ -0,0 +1,37 @@
Digital Ocean
===================
Invoice Ninja has created a Digital Ocean Marketplace image with Invoice Ninja pre-installed.
To use this image, when creating a Droplet, choose **Marketplace** under the **Choose an image section**, and select the **Invoice Ninja on Ubuntu 18.04** image.
This image includes Nginx, PHP 7.3, MySQL, Certbot, and Postfix, and it will automatically download 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.

1
docs/index.rst
View File

@ -48,6 +48,7 @@ Want to find out everything there is to know about how to use your Invoice Ninja
install
configure
update
digital_ocean
mobile_apps
api
developer_guide