|
|
@@ -0,0 +1,120 @@
|
|
|
+ <!DOCTYPE html>
|
|
|
+ <html lang="en" xmlns="http://www.w3.org/1999/xhtml">
|
|
|
+ <head>
|
|
|
+ <title>Install Invoice Plane - Invoice and Payment Manager - On Linux</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,Accounting,Accounting Software,Homelab,How To Install Invoice Plane On Linux,Income Tracking,Invoice,Invoice Plane,Invoicing Software,MariaDB,MySQL,PHP,PHP Based Application,Payment Manager,LAMP,Linux,Debian,Ubuntu,How To,Tutorial,i12bretro">
|
|
|
+ <meta name="author" content="i12bretro">
|
|
|
+ <meta name="description" content="Install Invoice Plane - Invoice and Payment Manager - On Linux">
|
|
|
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
+ <meta name="revised" content="10/01/2023 02:35:32 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 Invoice Plane - Invoice and Payment Manager - On Linux</h1>
|
|
|
+ </div>
|
|
|
+ <div></div>
|
|
|
+ <div id="content">
|
|
|
+ <h2>What is Invoice Plane?</h2>
|
|
|
+
|
|
|
+<blockquote><em>[Invoice Plane is a] self-hosted open source application for managing your invoices, clients and payments.-<a href="https://www.invoiceplane.com/" target="_blank">https://www.invoiceplane.com/</a></em></blockquote>
|
|
|
+
|
|
|
+<h2>Installation</h2>
|
|
|
+
|
|
|
+<ol>
|
|
|
+ <li>Log into the Linux device</li>
|
|
|
+ <li>Run the following commands in a terminal window:
|
|
|
+ <div class="codeBlock"># update software repositories<br />
|
|
|
+ sudo apt update<br />
|
|
|
+ # install available software updates<br />
|
|
|
+ sudo apt upgrade -y<br />
|
|
|
+ # install prerequisites<br />
|
|
|
+ sudo apt install curl wget zip -y<br />
|
|
|
+ # install Apache HTTPD and MySQL<br />
|
|
|
+ sudo apt install apache2 mariadb-server mariadb-client -y<br />
|
|
|
+ # install PHP components<br />
|
|
|
+ sudo apt install php7.4 php7.4-curl php7.4-common php7.4-json php7.4-mysqli php7.4-gd php7.4-mbstring php7.4-xmlrpc -y<br />
|
|
|
+ # configure the MySQL database<br />
|
|
|
+ sudo su<br />
|
|
|
+ mysql_secure_installation</div>
|
|
|
+ </li>
|
|
|
+ <li>Press Enter to login as root</li>
|
|
|
+ <li>Type N and press Enter to not switch to unix socket authentication</li>
|
|
|
+ <li>Type Y and press Enter to set a root password, type the password twice to confirm</li>
|
|
|
+ <li>Type Y and press Enter to remove anonymous users</li>
|
|
|
+ <li>Type Y and press Enter to disallow root login remotely</li>
|
|
|
+ <li>Type Y and press Enter to remove the test database</li>
|
|
|
+ <li>Type Y and press Enter to reload privilege tables</li>
|
|
|
+ <li>Run the following command to login into MySQL:
|
|
|
+ <div class="codeBlock">mysql -u root -p</div>
|
|
|
+ </li>
|
|
|
+ <li>Authenticate with the root password set earlier</li>
|
|
|
+ <li>Run the following commands to create the Invoice Plane database and database user
|
|
|
+ <div class="codeBlock">CREATE DATABASE invoice_plane;<br />
|
|
|
+ GRANT ALL ON invoice_plane.* to 'invoice_plane_rw'@'localhost' IDENTIFIED BY 'Inv0!c3Pl@n3!';<br />
|
|
|
+ FLUSH PRIVILEGES;<br />
|
|
|
+ EXIT;<br />
|
|
|
+ exit</div>
|
|
|
+ </li>
|
|
|
+ <li>Continue with the following commands:
|
|
|
+ <div class="codeBlock"># fetch the latest download URL<br />
|
|
|
+ regex='"browser_download_url": "(https:\/\/github.com\/InvoicePlane\/InvoicePlane\/releases\/download\/[^/]*\/[^/]*\.zip)"' && response=$(curl -H "Accept: application/vnd.github.v3+json" https://api.github.com/repos/InvoicePlane/InvoicePlane/releases/latest) && [[ $response =~ $regex ]] && downloadURL="${BASH_REMATCH[1]}"<br />
|
|
|
+ # download the latest release<br />
|
|
|
+ wget -O invoiceplane.zip $downloadURL<br />
|
|
|
+ # create target directory<br />
|
|
|
+ sudo mkdir /var/www/html/invoiceplane<br />
|
|
|
+ # extract the downloaded zip to /var/www/html/invoiceplane<br />
|
|
|
+ sudo unzip ./invoiceplane.zip -d /var/www/html/invoiceplane<br />
|
|
|
+ # copy sample config file<br />
|
|
|
+ sudo cp /var/www/html/invoiceplane/ipconfig.php.example /var/www/html/invoiceplane/ipconfig.php<br />
|
|
|
+ # edit config.php<br />
|
|
|
+ sudo nano /var/www/html/invoiceplane/ipconfig.php</div>
|
|
|
+ </li>
|
|
|
+ <li>Scroll down to the const IP_URL variable and set the value to the IP address or DNS name of the host
|
|
|
+ <p>IP_URL=http://localhost/invoiceplane</p>
|
|
|
+ </li>
|
|
|
+ <li>Press CTRL+O, Enter, CTRL+X to write the changes</li>
|
|
|
+ <li>Continue with the following commands:
|
|
|
+ <div class="codeBlock"># set the owner of the invoiceplane directory<br />
|
|
|
+ sudo chown -R www-data:www-data /var/www/html/invoiceplane</div>
|
|
|
+ </li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Invoice Plane Web Installer</h2>
|
|
|
+
|
|
|
+<ol>
|
|
|
+ <li>Open a web browser and navigate to http://DNSorIP/invoiceplane</li>
|
|
|
+ <li>The Invoice Plane Installation web installer should be load</li>
|
|
|
+ <li>Click the Setup button</li>
|
|
|
+ <li>Select a Language > Click Continue</li>
|
|
|
+ <li>Click Continue on the Prerequisites page</li>
|
|
|
+ <li>Complete the Database Details form as follows
|
|
|
+ <p>Hostname: localhost<br />
|
|
|
+ Port: 3306<br />
|
|
|
+ Username: invoice_plane_rw<br />
|
|
|
+ Password: Inv0!c3Pl@n3!<br />
|
|
|
+ Database: invoice_plane</p>
|
|
|
+ </li>
|
|
|
+ <li>Click the Try Again button then click Continue</li>
|
|
|
+ <li>Complete the Create User Account form > Click Continue</li>
|
|
|
+ <li>Back in the terminal, run the following command to disable the setup wizard
|
|
|
+ <div class="codeBlock"># set the DISABLE_SETUP flag to true<br />
|
|
|
+ sudo sed -i 's/DISABLE_SETUP=false/DISABLE_SETUP=true/g' /var/www/html/invoiceplane/ipconfig.php</div>
|
|
|
+ </li>
|
|
|
+ <li>Click the Login button</li>
|
|
|
+ <li>Login with the Email and Password setup during the installation</li>
|
|
|
+ <li>Welcome to Invoice Plane</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<p>Source: <a href="https://wiki.invoiceplane.com/en/1.0/getting-started/installation" target="_blank">https://wiki.invoiceplane.com/en/1.0/getting-started/installation</a></p> </div>
|
|
|
+ </div>
|
|
|
+ </body>
|
|
|
+ </html>
|
|
|
+
|
i12bretro