|
|
@@ -0,0 +1,136 @@
|
|
|
+ <!DOCTYPE html>
|
|
|
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml">
|
|
|
+ <head>
|
|
|
+ <title>Install InvoiceNinja - Invoice and Payment Manager - On Windows</title>
|
|
|
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
|
+ <meta charset="UTF-8">
|
|
|
+ <meta name="keywords" content="Browser Based,Home Lab,Home Lab Ideas,Install Guide,Self-Hosted,Web Based,Web Based Tools,Expense Tracker,Homelab,Invoice,Invoice Ninja,InvoiceNinja,Invoicing Software,Payment Manager,Microsoft Windows,Windows,MariaDB,MySQL,PHP Based Applications,XAMPP,PHP,How To,Tutorial,i12bretro">
|
|
|
+ <meta name="author" content="i12bretro">
|
|
|
+ <meta name="description" content="Install InvoiceNinja - Invoice and Payment Manager - On Windows">
|
|
|
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
+ <meta name="revised" content="02/15/2023 01:31:55 PM" />
|
|
|
+ <link rel="icon" type="image/x-icon" href="includes/favicon.ico">
|
|
|
+ <script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js"></script>
|
|
|
+ <script type="text/javascript" src="includes/js/steps.js"></script>
|
|
|
+ <link href="css/steps.css" rel="stylesheet" type="text/css" />
|
|
|
+ </head>
|
|
|
+ <body>
|
|
|
+ <div id="gridContainer">
|
|
|
+ <div class="topMargin"></div>
|
|
|
+ <div id="listName" class="topMargin">
|
|
|
+ <h1>Install InvoiceNinja - Invoice and Payment Manager - On Windows</h1>
|
|
|
+ </div>
|
|
|
+ <div></div>
|
|
|
+ <div id="content">
|
|
|
+ <h2>What is InvoiceNinja?</h2>
|
|
|
+
|
|
|
+<blockquote><em>[InvoiceNinja is a] powerful suite of features to invoice clients, facilitate payment, track-time & tasks, expenses, and more. -<a href="https://www.invoiceninja.com/invoicing-features/" target="_blank">https://www.invoiceninja.com/invoicing-features/</a></em></blockquote>
|
|
|
+
|
|
|
+<h2>Installation</h2>
|
|
|
+
|
|
|
+<ol>
|
|
|
+ <li>Download XAMPP <a href="https://sourceforge.net/projects/xampp/files/XAMPP%20Windows/" target="_blank">Download</a></li>
|
|
|
+ <li>Download InvoiceNinja <a href="https://github.com/invoiceninja/invoiceninja/releases/latest" target="_blank">Download</a></li>
|
|
|
+ <li><label for="cb_li_917989_0">Download Microsoft Visual C++ </label><label for="cb_li_917989_0"><a href="https://aka.ms/vs/16/release/vc_redist.x64.exe" target="_blank">Download</a></label></li>
|
|
|
+ <li>Install Microsoft Visual C++</li>
|
|
|
+ <li>Right click the downloaded XAMPP file > Extract All...</li>
|
|
|
+ <li>Right click the downloaded InvoiceNinja .zip file > Extract All...</li>
|
|
|
+ <li>Cut the invoiceninja folder inside the XAMPP directory</li>
|
|
|
+ <li>Navigate into the invoiceninja folder > Create a copy of .env.example</li>
|
|
|
+ <li>Rename the copy .env</li>
|
|
|
+ <li>Navigate into the invoiceninja/public folder</li>
|
|
|
+ <li>Edit the .htaccess file in a text editor</li>
|
|
|
+ <li>Scroll to the bottom of the file and find the following lines and add the /invoiceninja/ folder to the RewriteRule
|
|
|
+ <p>RewriteRule ^ %1 [L,R=301]<br />
|
|
|
+ RewriteRule ^ index.php [L]</p>
|
|
|
+ </li>
|
|
|
+ <li>Replace the line with the following
|
|
|
+ <p>RewriteRule ^ /invoiceninja/%1 [L,R=301]<br />
|
|
|
+ RewriteRule ^ /invoiceninja/index.php [L]</p>
|
|
|
+ </li>
|
|
|
+ <li>Save the changes and close the editor</li>
|
|
|
+ <li>Navigate back to the Downloads directory and copy the extracted XAMPP directory to a safe location to run from, C:\Program Files for example</li>
|
|
|
+ <li>Run XAMPP/setup_xampp.bat to update the configuration files with the new server location</li>
|
|
|
+ <li>Navigate into XAMPP/PHP and edit php.ini in a text editor</li>
|
|
|
+ <li>Find the list of extensions and make sure the following are enabled by removing the ; at the start of the line
|
|
|
+ <p>extension=curl<br />
|
|
|
+ extension=fileinfo<br />
|
|
|
+ extension=gd<br />
|
|
|
+ extension=gmp<br />
|
|
|
+ extension=mbstring<br />
|
|
|
+ extension=mysqli<br />
|
|
|
+ extension=openssl<br />
|
|
|
+ extension=pdo_mysql</p>
|
|
|
+ </li>
|
|
|
+ <li>Save the changes to php.ini</li>
|
|
|
+ <li>Navigate into XAMPP/Apache/conf and edit httpd.conf in a text editor</li>
|
|
|
+ <li>Uncomment the following Apache modules by removing the # in front of them
|
|
|
+ <p>LoadModule deflate_module modules/mod_deflate.so<br />
|
|
|
+ LoadModule filter_module modules/mod_filter.so</p>
|
|
|
+ </li>
|
|
|
+ <li>Search the file for <Directory /><directory></directory></li>
|
|
|
+ <li>Overwrite the existing values with the following
|
|
|
+ <p>Options Indexes FollowSymLinks<br />
|
|
|
+ AllowOverride All</p>
|
|
|
+ </li>
|
|
|
+ <li>Paste the following at the bottom of the httpd.conf file
|
|
|
+ <p>Alias /invoiceninja "C:/Program Files/xampp/invoiceninja/public"<br />
|
|
|
+ <Directory "C:/Program Files/xampp/invoiceninja/public"><br />
|
|
|
+ DirectoryIndex index.php<br />
|
|
|
+ Options +FollowSymLinks<br />
|
|
|
+ AllowOverride All<br />
|
|
|
+ Require all granted<br />
|
|
|
+ </Directory></p>
|
|
|
+ </li>
|
|
|
+ <li>Save the changes and close out of the editor</li>
|
|
|
+ <li>Click the Start button > Search Control > Click Control Panel</li>
|
|
|
+ <li>Click on System > Advanced system settings</li>
|
|
|
+ <li>Click the Environment Variables...</li>
|
|
|
+ <li>Edit the System Path variable</li>
|
|
|
+ <li>Click the New button</li>
|
|
|
+ <li>Add the PHP installation directory (ie C:\Program Files\xampp\PHP\)</li>
|
|
|
+ <li>Click the New button</li>
|
|
|
+ <li>Add the MySQL installation directory (ie C:\Program Files\xampp\mysql\bin\)</li>
|
|
|
+ <li>Click OK to all open dialog windows</li>
|
|
|
+ <li>Back in File Explorer, runun XAMPP/xampp-control.exe</li>
|
|
|
+ <li>Click the Start buttons next to Apache and MySQL</li>
|
|
|
+ <li>Navigate to XAMPP/mysql/bin</li>
|
|
|
+ <li>Hold the SHIFT key and right click in the white space > Open PowerShell window here...</li>
|
|
|
+ <li>Run the following commands in the PowerShell window to setup the database
|
|
|
+ <div class="codeBlock PS">.\mysql -u root<br />
|
|
|
+ CREATE DATABASE invoiceninja;<br />
|
|
|
+ GRANT ALL ON invoiceninja.* to 'invoice_ninja_rw'@'localhost' IDENTIFIED BY '!nv0ic3Ninj@!';<br />
|
|
|
+ FLUSH PRIVILEGES;<br />
|
|
|
+ EXIT;<br />
|
|
|
+ exit</div>
|
|
|
+ </li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>InvoiceNinja Web Installer</h2>
|
|
|
+
|
|
|
+<ol>
|
|
|
+ <li>Open a web browser and navigate to http://DNSorIP/invoiceninja/setup</li>
|
|
|
+ <li>The InvoiceNinja web setup should be load</li>
|
|
|
+ <li>Enter the URL to use for the site (ie http://DNSorIP/invoiceninja)</li>
|
|
|
+ <li>Uncheck the Require HTTPS option > Click Test PDF</li>
|
|
|
+ <li>Complete the Database Connection form as follows
|
|
|
+ <p>Host: localhost<br />
|
|
|
+ Port: 3306<br />
|
|
|
+ Database: invoiceninja<br />
|
|
|
+ Username: invoice_ninja_rw<br />
|
|
|
+ Password: Click the Test connection button</p>
|
|
|
+ </li>
|
|
|
+ <li>If you have an Email server, configure it under Email Settings, otherwise leave the driver as Log and click the Send test email button</li>
|
|
|
+ <li>Completed the User Details form by entering a First Name, Last Name, Email and Password</li>
|
|
|
+ <li>Check both I Agree checkboxes > Click Submit</li>
|
|
|
+ <li>If the page redirects to http://localhost, navigate to http://localhost/invoiceninja/index.php</li>
|
|
|
+ <li>Login with the Email and Password setup earlier > Click Login with email</li>
|
|
|
+ <li>On the Welcome dialog, enter a company name and select the Light or Dark theme > Click Save</li>
|
|
|
+ <li>Welcome to InvoiceNinja</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<p>Source: <a href="https://invoiceninja.github.io/docs/self-host-installation/" target="_blank">https://invoiceninja.github.io/docs/self-host-installation/</a></p> </div>
|
|
|
+ </div>
|
|
|
+ </body>
|
|
|
+ </html>
|
|
|
+
|
i12bretro