InvoicePlane è un'applicazione di fatturazione gratuita e open source. Il suo codice sorgente può essere trovato su questo repository Github . Questa guida ti mostrerà come installare InvoicePlane su una nuova istanza di FreeBSD 12 Vultr.
Requisiti
- nginx
- MySQL versione 5.5 o successiva o equivalente MariaDB
- PHP versione 7.0 o successiva
- Le seguenti estensioni PHP devono essere installate e attivate:
php-gd
php-hash
php-json
php-mbstring
php-mcrypt
php-mysqli
php-openssl
php-recode
php-xmlrpc
php-zlib
Prima di iniziare
Controlla la versione di FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE
Assicurati che il tuo sistema FreeBSD sia aggiornato.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installa i pacchetti necessari.
pkg install -y sudo vim unzip curl wget bash socat git
Crea un nuovo account utente con il tuo nome utente preferito. Useremo johndoe
.
adduser
# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!
Esegui il visudo
comando e decommenta la %wheel ALL=(ALL) ALL
riga per consentire ai membri del wheel
gruppo di eseguire qualsiasi comando.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Ora passa al nuovo utente creato con su
.
su - johndoe
NOTA: sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo tzsetup
Installa PHP e le estensioni PHP richieste
Installa PHP e le estensioni PHP necessarie.
sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-pecl-imagick php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-phar php72-soap php72-xmlrpc php72-opcache php72-mysqli php72-bcmath php72-gmp
Controlla la versione
php --version
# PHP 7.2.19 (cli) (built: Jun 20 2019 01:25:01) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
Soft-link php.ini-production
a php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Abilita e avvia PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Installa MariaDB
Installa MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Controlla la versione
mysql --version
# mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Avviare e abilitare MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Esegui lo mysql_secure_installation
script per migliorare la sicurezza dell'installazione di MariaDB.
sudo mysql_secure_installation
Accedi a MariaDB come utente root.
mysql -u root -p
# Enter password:
Creare un nuovo database e utente MariaDB. Ricorda le credenziali per questo nuovo utente.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;
Installa Nginx
Installa Nginx.
sudo pkg install -y nginx
Controlla la versione
nginx -v
# nginx version: nginx/1.16.0
Abilita e avvia Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Esegui sudo vim /usr/local/etc/nginx/invoiceplane.conf
e configura Nginx per InvoicePlane.
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_index index.php;
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass 127.0.0.1:9000;
}
}
Salva il file ed esci.
Ora dobbiamo includere invoiceplane.conf
nel nginx.conf
file principale .
Esegui sudo vim /usr/local/etc/nginx/nginx.conf
e aggiungi la seguente riga al http {}
blocco.
include invoiceplane.conf;
Prova la configurazione.
sudo nginx -t
Ricarica Nginx.
sudo service nginx reload
Installa InvoicePlane
Scarica l'ultima versione stabile di InvoicePlane ed estrai l'archivio.
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
Passa alla /usr/local/www/invoiceplane
cartella.
cd /usr/local/www/invoiceplane
Crea una copia del ipconfig.php.example
file e rinomina la copia ipconfig.php
.
sudo cp ipconfig.php.example ipconfig.php
Apri il ipconfig.php
file e aggiungi il tuo URL.
sudo vim ipconfig.php
# Something like this
IP_URL=http://example.com
NOTA: non dimenticare di sostituire l' http://example.com
URL con il tuo URL.
Cambia la proprietà della /usr/local/www/invoiceplane
directory in www
.
sudo chown -R www:www /usr/local/www/invoiceplane
Esegui il programma di installazione InvoicePlane dal tuo browser web e segui le istruzioni.
http://your-domain.com/index.php/setup
Al termine dell'installazione, è possibile accedere a InvoicePlane utilizzando l'indirizzo e-mail e la password scelti durante l'installazione.
Se si desidera proteggere l'installazione, è possibile disabilitare l'installazione. Per fare ciò, sostituisci la riga DISABLE_SETUP=false
con DISABLE_SETUP=true
nel tuo ipconfig.php
file.