InvoicePlane te installeren op Ubuntu

InvoicePlane is een gratis, open source en zelf gehoste applicatie voor het beheren van je facturen, klanten en betalingen. Het is speciaal ontworpen voor ondernemers om hun facturen en klantbetalingen te maken en te beheren. Momenteel gebruiken veel bedrijven over de hele wereld deze applicatie om hun complete facturatiecirkel te beheren.

In deze tutorial leggen we de installatie uit van InvoicePlane op Ubuntu 18.04 LTS (Bionic Beaver).

Vereisten

  • Een server waarop Ubuntu 18.04 draait.
  • Een niet-root gebruiker met sudo privileges.

LAMP-server installeren

InvoicePlane draait op een webserver, geschreven in PHP en gebruikt MariaDB om hun gegevens op te slaan. Installeer eerst Apache en MariaDB server met het volgende commando:

sudo apt-get install apache2 mariadb-server -y

Vervolgens moet je ondrej PHP repository toevoegen aan je systeem. Je kunt het toevoegen door het volgende commando uit te voeren:

sudo apt-get install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php

Zodra de repository is toegevoegd, update je de repository en installeer je PHP met alle vereiste bibliotheken met het volgende commando:

sudo apt-get install php7.2 libapache2-mod-php7.2 php7.2-common php7.2-mbstring php7.2-xmlrpc php7.2-soap php7.2-gd php7.2-xml php7.2-intl php7.2-mysql wget unzip php7.2-cli php7.2-mcrypt php7.2-zip php7.2-curl -y

Zodra alle pakketten zijn geïnstalleerd, open je het bestand php.ini en breng je enkele wijzigingen aan:

sudo nano /etc/php/7.2/apache2/php.ini

Breng de volgende wijzigingen aan:

memory_limit = 256M
upload_max_filesize = 128M
max_execution_time = 360
date.timezone = Asia/Kolkata

Sla het bestand op en clsoe het. Start vervolgens de Apache en MariaDB service en schakel ze in om bij het opstarten te starten met het volgende commando:

sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl start mariadb
sudo systemctl enable mariadb

MariaDB configureren

Voordat je MariaDB configureert, beveilig je de installatie van MariaDB met het volgende commando:

sudo mysql_secure_installation

Dit script stelt het root wachtwoord in, verwijdert anonieme gebruikers, verbiedt root inloggen op afstand en verwijdert de testdatabase zoals hieronder getoond:

Set root password? [Y/n] n
Remove anonymous users? [Y/n] y
Disallow root login remotely? [Y/n] y
Remove test database and access to it? [Y/n] y
Reload privilege tables now? [Y/n] y

Zodra MariaDB beveiligd is, log je in op de MariaDB-shell:

mysql -u root -p

Voer je root wachtwoord in en maak dan een database en gebruiker aan voor InvoicePlane:

MariaDB [(none)]> CREATE DATABASE invplane_db;
MariaDB [(none)]> CREATE USER 'invplane'@'localhost' IDENTIFIED BY 'password';

Ken vervolgens privileges toe aan de InvoicePlane database met het volgende commando:

MariaDB [(none)]> GRANT ALL PRIVILEGES ON invplane_db.* TO 'invplane'@'localhost';

Voer vervolgens het commando FLUSH PRIVILEGES uit zodat de privilegetabel door MariaDB opnieuw wordt geladen:

MariaDB [(none)]> FLUSH PRIVILEGES;

Sluit ten slotte de MariaDB-shell af:

MariaDB [(none)]> EXIT

Download en installeer InvoicePlane

Download eerst de nieuwste versie van InvoicePlane met het volgende commando:

wget -c -O v1.5.9.zip https://invoiceplane.com/download/v1.5.9

Zodra het downloaden voltooid is, pak je het gedownloade bestand uit met het volgende commando:

mkdir invoiceplane
unzip v1.5.9.zip -d invoiceplane

Verander vervolgens de directory naar invoiceplane en kopieer de benodigde bestanden naar de Apache root directory met het volgende commando:

cd invoiceplane
sudo mv ip /var/www/html/invoiceplane
cd /var/www/html/invoiceplane
sudo cp ipconfig.php.example ipconfig.php
sudo cp htaccess .htaccess

Stel vervolgens de juiste rechten in op de invoiceplane directory:

sudo chown -R www-data:www-data /var/www/html/invoiceplane/
sudo chmod -R 755 /var/www/html/invoiceplane/

Maak vervolgens een Apache virtual host bestand aan voor InvoicePlane:

sudo nano /etc/apache2/sites-available/invoiceplane.conf

Voeg de volgende regels toe:

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/invoiceplane
     ServerName example.com
     ServerAlias www.example.com

     <Directory /var/www/html/invoiceplane/>
          Options +FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Sla het bestand op, als je klaar bent.

Schakel vervolgens apache virtual host file en rewrite module in met het volgende commando:

sudo a2ensite invoiceplane.conf
sudo a2enmod rewrite

Start tenslotte Apache service opnieuw op om alle wijzigingen toe te passen:

sudo systemctl restart apache2

Toegang tot InvoicePlane

InvoicePlane is nu geïnstalleerd en geconfigureerd, het is tijd om hun webinstallatiewizard te openen.

Open je webbrowser en typ de URL http://example.com. Je wordt doorverwezen naar de volgende pagina:

InvoicePlane installatieprogramma

Klik nu op de knop Setup. Je zou de volgende pagina moeten zien:

Kies taal

Kies vervolgens de taal en klik op de knop Doorgaan. Je zou de volgende pagina moeten zien:

Voorwaarden controleren

Klik vervolgens op de knop Doorgaan. Je zou de volgende pagina moeten zien:

Database details

Geef hier je databasegegevens op en klik op de knop Probeer opnieuw. Je zou de volgende pagina moeten zien:

Databasegegevens correct ingesteld

Klik nu op de knop Doorgaan. Je zou de volgende pagina moeten zien:

Database tabellen geïnstalleerd

Klik nu op de knop Doorgaan. Je zou de volgende pagina moeten zien:

Maak een account aan

Vul nu alle vereiste gegevens in en klik dan op de knop Doorgaan. Als de installatie voltooid is, zou je de volgende pagina moeten zien:

InvoicePlane installatie voltooid

Klik nu op de knop Aanmelden. Je zou de volgende pagina moeten zien:

Inloggen bij InvoicePlane

Voer hier je admin gebruikersnaam en wachtwoord in, en klik dan op de Login knop. Je wordt doorgestuurd naar het InvoicePlane dashboard zoals hieronder afgebeeld:

FactuurPlane dashboard

Links