InvoicePlane és una aplicació de facturació gratuïta i de codi obert. El seu codi font es pot trobar en aquest dipòsit de Github . Aquesta guia us mostrarà com instal·lar InvoicePlane en una instància nova de FreeBSD 12 Vultr.
Requisits
- Nginx
- MySQL versió 5.5 o superior o equivalent a MariaDB
- PHP versió 7.0 o superior
- Les següents extensions PHP s'han d'instal·lar i activar:
php-gd
php-hash
php-json
php-mbstring
php-mcrypt
php-mysqli
php-openssl
php-recode
php-xmlrpc
php-zlib
Abans que comencis
Comproveu la versió de FreeBSD.
uname -ro # FreeBSD 12.0-RELEASE
Assegureu-vos que el vostre sistema FreeBSD estigui actualitzat.
freebsd-update fetch install pkg update && pkg upgrade -y
Instal·leu els paquets necessaris.
pkg install -y sudo vim unzip curl wget bash socat git
Creeu un compte d'usuari nou amb el vostre nom d'usuari preferit. Farem servir 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!
Executeu l' visudoordre i descomenteu la %wheel ALL=(ALL) ALLlínia, per permetre que els membres del wheelgrup executin qualsevol ordre.
visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL
Ara, canvieu al vostre nou usuari creat amb su.
su - johndoe
NOTA: Substituïu-lo johndoepel vostre nom d'usuari.
Configura la zona horària.
sudo tzsetup
Instal·leu PHP i les extensions PHP necessàries
Instal·leu PHP, així com les extensions PHP necessàries.
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
Comproveu la versió.
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
Enllaç suau php.ini-productiona php.ini.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Activeu i inicieu PHP-FPM.
sudo sysrc php_fpm_enable=yes sudo service php-fpm start
Instal·leu MariaDB
Instal·leu MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Comproveu la versió.
mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Inicieu i activeu MariaDB.
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Executeu l' mysql_secure_installationscript per millorar la seguretat de la vostra instal·lació de MariaDB.
sudo mysql_secure_installation
Inicieu sessió a MariaDB com a usuari root.
mysql -u root -p # Enter password:
Creeu una nova base de dades i un usuari MariaDB. Recordeu les credencials d'aquest nou usuari.
CREATE DATABASE dbname; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; exit;
Instal·leu Nginx
Instal·leu Nginx.
sudo pkg install -y nginx
Comproveu la versió.
nginx -v # nginx version: nginx/1.16.0
Activeu i inicieu Nginx.
sudo sysrc nginx_enable=yes sudo service nginx start
Executeu sudo vim /usr/local/etc/nginx/invoiceplane.confi configureu Nginx per a 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; } }
Desa el fitxer i surt.
Ara hem d'incloure invoiceplane.confal nginx.conffitxer principal .
Executeu sudo vim /usr/local/etc/nginx/nginx.confi afegiu la línia següent al http {}bloc.
include invoiceplane.conf;
Proveu la configuració.
sudo nginx -t
Torna a carregar Nginx.
sudo service nginx reload
Instal·leu InvoicePlane
Baixeu la darrera versió estable de InvoicePlane i extreu l'arxiu.
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
Navegueu a la /usr/local/www/invoiceplanecarpeta.
cd /usr/local/www/invoiceplane
Feu una còpia del ipconfig.php.examplefitxer i canvieu el nom de la còpia ipconfig.php.
sudo cp ipconfig.php.example ipconfig.php
Obriu el ipconfig.phpfitxer i afegiu-hi el vostre URL.
sudo vim ipconfig.php # Something like this IP_URL=http://example.com
NOTA: No oblideu substituir l' http://example.comURL pel vostre propi URL.
Canvia la propietat del /usr/local/www/invoiceplanedirectori a www.
sudo chown -R www:www /usr/local/www/invoiceplane
Executeu l'instal·lador de InvoicePlane des del vostre navegador web i seguiu les instruccions.
http://your-domain.com/index.php/setup
Un cop finalitzada la instal·lació, podeu iniciar sessió a InvoicePlane amb l'adreça de correu electrònic i la contrasenya que hàgiu escollit durant la instal·lació.
Si voleu assegurar la vostra instal·lació, podeu desactivar la configuració. Per fer-ho, substituïu la línia DISABLE_SETUP=falseper DISABLE_SETUP=trueal vostre ipconfig.phpfitxer.