0ct0pu5
/
tutorials


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136
							    <!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 &amp; 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 &gt; Extract All...</li>
	<li>Right click the downloaded InvoiceNinja .zip file &gt; Extract All...</li>
	<li>Cut the invoiceninja folder inside the XAMPP directory</li>
	<li>Navigate into the invoiceninja folder &gt; 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 &lt;Directory /&gt;<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 &quot;C:/Program Files/xampp/invoiceninja/public&quot;<br />
	&lt;Directory &quot;C:/Program Files/xampp/invoiceninja/public&quot;&gt;<br />
	DirectoryIndex index.php<br />
	Options +FollowSymLinks<br />
	AllowOverride All<br />
	Require all granted<br />
	&lt;/Directory&gt;</p>
	</li>
	<li>Save the changes and close out of the editor</li>
	<li>Click the Start button &gt; Search Control &gt; Click Control Panel</li>
	<li>Click on System &gt; 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 &gt; 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 &#39;invoice_ninja_rw&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;!nv0ic3Ninj@!&#39;;<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 &gt; 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 &gt; 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 &gt; Click Login with email</li>
	<li>On the Welcome dialog, enter a company name and select the Light or Dark theme &gt; 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>