Come installare InvoicePlane con Nginx su FreeBSD 12

InvoicePlane è un’applicazione di fatturazione gratuita e open-source. Questo tutorial ti mostrerà come installare InvoicePlane su un sistema FreeBSD 12.

Requisiti

WebServer (Apache, NGINX). Questo tutorial utilizzerà Nginx.
MySQL versione 5.5 o superiore o la versione equivalente di MariaDB.
PHP versione 7.0, 7.1 o 7.2 con le seguenti estensioni PHP installate e attivate:
- php-gd
- php-hash
- php-json
- php-mbstring
- php-mcrypt
- php-mysqli
- php-openssl
- php-recode
- php-xmlrpc
- php-zlib

Prerequisiti

Un server che esegue FreeBSD 12.
Un utente non root con privilegi sudo.

Passi iniziali

Controlla la tua versione di FreeBSD:

uname -ro  
# FreeBSD 12.1-RELEASE

Imposta il fuso orario:

tzsetup

Aggiorna i pacchetti del tuo sistema operativo (software). Questo è un primo passo importante perché garantisce che tu abbia gli ultimi aggiornamenti e le correzioni di sicurezza per i pacchetti software predefiniti del tuo sistema operativo:

freebsd-update fetch install  
pkg update && pkg upgrade -y

Installa alcuni pacchetti essenziali che sono necessari per l’amministrazione di base del sistema operativo FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash

Passo 1 - Installa PHP e le estensioni PHP richieste

L’applicazione web InvoicePlane richiede PHP versione 7.0 o superiore.

Installa PHP, così come le estensioni PHP necessarie:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-mysqli php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Controlla la versione di PHP:

php --version  
  
# PHP 7.2.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies

Abilita e avvia il servizio PHP-FPM:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Passo 2 - Installa MySQL

Installa il server di database MySQL:

sudo pkg install -y mysql57-server

Controlla la versione di MySQL:

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using  EditLine wrapper

Abilita e avvia il servizio MySQL:

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

Esegui lo script mysql_secure_installation per migliorare la sicurezza di MySQL e impostare la password per l’utente root di MySQL:

sudo mysql_secure_installation

Rispondi a ciascuna delle domande:

Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
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

Collegati alla shell di MySQL come utente root:

sudo mysql -u root -p  
# Enter password

Crea un database MySQL vuoto e un utente per Matomo e ricorda le credenziali:

CREATE DATABASE dbname;  
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
FLUSH PRIVILEGES;

Esci da MySQL:

exit

Sostituisci dbname, username e password con i tuoi nomi.

Passo 3 - Installa acme.sh client e ottieni il certificato Let’s Encrypt (opzionale)

Proteggere il tuo sito web con HTTPS non è necessario, ma è una buona pratica per proteggere il traffico del tuo sito. Per ottenere un certificato TLS da Let’s Encrypt utilizzeremo il client Acme.sh. Acme.sh è un software shell UNIX puro per ottenere certificati TLS da Let’s Encrypt senza dipendenze.

Scarica e installa Acme.sh:

sudo pkg install -y acme.sh

Controlla la versione di Acme.sh:

acme.sh --version  
# v2.8.2

Ottieni certificati RSA e ECC/ECDSA per il tuo dominio/nome host:

# RSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Dopo aver eseguito i comandi sopra, i tuoi certificati e chiavi saranno in:

Per RSA: directory /etc/letsencrypt/example.com.
Per ECC/ECDSA: directory /etc/letsencrypt/example.com_ecc.

Passo 3 - Installa NGINX

Installa il server web NGINX:

sudo pkg install -y nginx

Controlla la versione di NGINX:

nginx -v  
# nginx version: nginx/1.14.2

Avvia e abilita il servizio NGINX:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Configura Nginx per InvoicePlane eseguendo:

sudo vim /usr/local/etc/nginx/invoiceplane.conf

E popola il file con la seguente configurazione:

server {
    listen 80;
    listen [::]:80;

    server_name example.com;

    root /usr/local/www/invoiceplane;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~* \.php$ {  
      fastcgi_pass 127.0.0.1:9000;  
      include fastcgi_params;  
      fastcgi_index index.php5;  
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    }
}

Testa la configurazione di NGINX:

sudo nginx -t

Ricarica NGINX:

sudo service nginx restart

Passo 4 - Installa InvoicePlane

Scarica l’ultima versione stabile di InvoicePlane ed estrai l’archivio:

sudo mkdir -p /usr/local/www  
cd /usr/local/www  
sudo curl -O -J -L https://invoiceplane.com/download/v1.5.9  
sudo unzip v1.5.9.zip  
sudo rm v1.5.9.zip  
sudo mv ip invoiceplane

Naviga nella directory /var/www/invoiceplane:

cd /usr/local/www/invoiceplane

Fai una copia del file ipconfig.php.example e rinomina la copia in ipconfig.php:

sudo cp ipconfig.php.example ipconfig.php

Apri il file ipconfig.php e aggiungi il tuo URL:

sudo vim ipconfig.php  
# Qualcosa del genere  
IP_URL=http://example.com

Cambia la proprietà della directory /usr/local/www/invoiceplane in www:

sudo chown -R www:www /usr/local/www/invoiceplane

Esegui sudo vim /etc/php.ini e imposta date.timezone:

date.timezone = Regione/Città

Riavvia il servizio PHP-FPM:

sudo service php-fpm restart

Esegui l’installatore di InvoicePlane dal tuo browser web e segui le istruzioni:

http://example.com/index.php/setup

Una volta completata l’installazione, puoi accedere a InvoicePlane utilizzando l’indirizzo email e la password che hai scelto durante l’installazione.

Se desideri proteggere la tua installazione, puoi disabilitare la configurazione. Per farlo, sostituisci la riga DISABLE_SETUP=false con DISABLE_SETUP=true nel tuo file ipconfig.php.

Passo 5 - Completa la configurazione di InvoicePlane

InvoicePlane è ora installato e configurato, è tempo di accedere al suo wizard di installazione web.

Apri il tuo browser web e digita l’URL http://example.com. Sarai reindirizzato alla seguente pagina:

Installatore web di InvoicePlane

Ora, fai clic sul pulsante Setup. Dovresti vedere la seguente pagina:

Scegli la lingua

Successivamente, scegli la lingua e fai clic sul pulsante Continue. Dovresti vedere la seguente pagina:

Controlla i requisiti di sistema

Successivamente, fai clic sul pulsante Continue. Dovresti vedere la seguente pagina:

Dettagli del database

Qui, fornisci i dettagli del tuo database e fai clic sul pulsante Try Again. Dovresti vedere la seguente pagina:

Connessione al database riuscita

Ora, fai clic sul pulsante Continue. Dovresti vedere la seguente pagina:

Crea account utente

Ora, fai clic sul pulsante Continue. Dovresti vedere la seguente pagina:

Installazione di InvoicePlane completata

Ora, fornisci tutti i dettagli richiesti, quindi fai clic sul pulsante Continue. Una volta completata l’installazione, dovresti vedere la seguente pagina:

Accedi a InvoicePlane

Ora, fai clic sul pulsante Login per accedere all’amministrazione di InvoicePlane.