0817.html 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. <!DOCTYPE html>
  2. <html lang="en" xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <title>Install Invoice Plane - Invoice and Payment Manager - On Linux</title>
  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  6. <meta charset="UTF-8">
  7. <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">
  8. <meta name="author" content="i12bretro">
  9. <meta name="description" content="Install Invoice Plane - Invoice and Payment Manager - On Linux">
  10. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  11. <meta name="revised" content="10/01/2023 02:35:32 PM" />
  12. <link rel="icon" type="image/x-icon" href="includes/favicon.ico">
  13. <script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js"></script>
  14. <script type="text/javascript" src="includes/js/steps.js"></script>
  15. <link href="css/steps.css" rel="stylesheet" type="text/css" />
  16. </head>
  17. <body>
  18. <div id="gridContainer">
  19. <div class="topMargin"></div>
  20. <div id="listName" class="topMargin">
  21. <h1>Install Invoice Plane - Invoice and Payment Manager - On Linux</h1>
  22. </div>
  23. <div></div>
  24. <div id="content">
  25. <h2>What is Invoice Plane?</h2>
  26. <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>
  27. <h2>Installation</h2>
  28. <ol>
  29. <li>Log into the Linux device</li>
  30. <li>Run the following commands in a terminal window:
  31. <div class="codeBlock"># update software repositories<br />
  32. sudo apt update<br />
  33. # install available software updates<br />
  34. sudo apt upgrade -y<br />
  35. # install prerequisites<br />
  36. sudo apt install curl wget zip -y<br />
  37. # install Apache HTTPD and MySQL<br />
  38. sudo apt install apache2 mariadb-server mariadb-client -y<br />
  39. # install PHP components<br />
  40. 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 />
  41. # configure the MySQL database<br />
  42. sudo su<br />
  43. mysql_secure_installation</div>
  44. </li>
  45. <li>Press Enter to login as root</li>
  46. <li>Type N and press Enter to not switch to unix socket authentication</li>
  47. <li>Type Y and press Enter to set a root password, type the password twice to confirm</li>
  48. <li>Type Y and press Enter to remove anonymous users</li>
  49. <li>Type Y and press Enter to disallow root login remotely</li>
  50. <li>Type Y and press Enter to remove the test database</li>
  51. <li>Type Y and press Enter to reload privilege tables</li>
  52. <li>Run the following command to login into MySQL:
  53. <div class="codeBlock">mysql -u root -p</div>
  54. </li>
  55. <li>Authenticate with the root password set earlier</li>
  56. <li>Run the following commands to create the Invoice Plane database and database user
  57. <div class="codeBlock">CREATE DATABASE invoice_plane;<br />
  58. GRANT ALL ON invoice_plane.* to &#39;invoice_plane_rw&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;Inv0!c3Pl@n3!&#39;;<br />
  59. FLUSH PRIVILEGES;<br />
  60. EXIT;<br />
  61. exit</div>
  62. </li>
  63. <li>Continue with the following commands:
  64. <div class="codeBlock"># fetch the latest download URL<br />
  65. regex=&#39;&quot;browser_download_url&quot;: &quot;(https:\/\/github.com\/InvoicePlane\/InvoicePlane\/releases\/download\/[^/]*\/[^/]*\.zip)&quot;&#39; &amp;&amp; response=$(curl -H &quot;Accept: application/vnd.github.v3+json&quot; https://api.github.com/repos/InvoicePlane/InvoicePlane/releases/latest) &amp;&amp; [[ $response =~ $regex ]] &amp;&amp; downloadURL=&quot;${BASH_REMATCH[1]}&quot;<br />
  66. # download the latest release<br />
  67. wget -O invoiceplane.zip $downloadURL<br />
  68. # create target directory<br />
  69. sudo mkdir /var/www/html/invoiceplane<br />
  70. # extract the downloaded zip to /var/www/html/invoiceplane<br />
  71. sudo unzip ./invoiceplane.zip -d /var/www/html/invoiceplane<br />
  72. # copy sample config file<br />
  73. sudo cp /var/www/html/invoiceplane/ipconfig.php.example /var/www/html/invoiceplane/ipconfig.php<br />
  74. # edit config.php<br />
  75. sudo nano /var/www/html/invoiceplane/ipconfig.php</div>
  76. </li>
  77. <li>Scroll down to the const IP_URL variable and set the value to the IP address or DNS name of the host
  78. <p>IP_URL=http://localhost/invoiceplane</p>
  79. </li>
  80. <li>Press CTRL+O, Enter, CTRL+X to write the changes</li>
  81. <li>Continue with the following commands:
  82. <div class="codeBlock"># set the owner of the invoiceplane directory<br />
  83. sudo chown -R www-data:www-data /var/www/html/invoiceplane</div>
  84. </li>
  85. </ol>
  86. <h2>Invoice Plane Web Installer</h2>
  87. <ol>
  88. <li>Open a web browser and navigate to http://DNSorIP/invoiceplane</li>
  89. <li>The Invoice Plane Installation web installer should be load</li>
  90. <li>Click the Setup button</li>
  91. <li>Select a Language &gt; Click Continue</li>
  92. <li>Click Continue on the Prerequisites page</li>
  93. <li>Complete the Database Details form as follows
  94. <p>Hostname: localhost<br />
  95. Port: 3306<br />
  96. Username: invoice_plane_rw<br />
  97. Password: Inv0!c3Pl@n3!<br />
  98. Database: invoice_plane</p>
  99. </li>
  100. <li>Click the Try Again button then click Continue</li>
  101. <li>Complete the Create User Account form &gt; Click Continue</li>
  102. <li>Back in the terminal, run the following command to disable the setup wizard
  103. <div class="codeBlock"># set the DISABLE_SETUP flag to true<br />
  104. sudo sed -i &#39;s/DISABLE_SETUP=false/DISABLE_SETUP=true/g&#39; /var/www/html/invoiceplane/ipconfig.php</div>
  105. </li>
  106. <li>Click the Login button</li>
  107. <li>Login with the Email and Password setup during the installation</li>
  108. <li>Welcome to Invoice Plane</li>
  109. </ol>
  110. <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>
  111. </div>
  112. </body>
  113. </html>