Comment installer InvoicePlane sur FreeBSD 12

• Exigences
• Avant que tu commences
• Installer PHP et les extensions PHP requises
• Installer MariaDB
• Installer Nginx
• Installer InvoicePlane

InvoicePlane est une application de facturation gratuite et open source. Son code source se trouve sur ce référentiel Github . Ce guide vous montrera comment installer InvoicePlane sur une nouvelle instance de FreeBSD 12 Vultr.

Exigences

• Nginx
• MySQL version 5.5 ou supérieure ou équivalent MariaDB
• PHP version 7.0 ou supérieure
• Les extensions PHP suivantes doivent être installées et activées:
  • php-gd
  • php-hash
  • php-json
  • php-mbstring
  • php-mcrypt
  • php-mysqli
  • php-openssl
  • php-recode
  • php-xmlrpc
  • php-zlib

Avant que tu commences

Vérifiez la version de FreeBSD.

uname -ro
# FreeBSD 12.0-RELEASE

Assurez-vous que votre système FreeBSD est à jour.

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

Installez les packages nécessaires.

pkg install -y sudo vim unzip curl wget bash socat git

Créez un nouveau compte utilisateur avec votre nom d'utilisateur préféré. Nous utiliserons 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!

Exécutez la visudocommande et décommentez la %wheel ALL=(ALL) ALLligne pour permettre aux membres du wheelgroupe d'exécuter n'importe quelle commande.

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

Maintenant, passez à votre nouvel utilisateur avec su.

su - johndoe

REMARQUE: remplacez johndoepar votre nom d'utilisateur.

Configurez le fuseau horaire.

sudo tzsetup

Installer PHP et les extensions PHP requises

Installez PHP, ainsi que les extensions PHP nécessaires.

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

Vérifiez la version.

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

Lien logiciel php.ini-productionvers php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Activez et démarrez PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Installer MariaDB

Installez MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Vérifiez la version.

mysql --version
# mysql  Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1

Démarrez et activez MariaDB.

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

Exécutez le mysql_secure_installationscript pour améliorer la sécurité de votre installation MariaDB.

sudo mysql_secure_installation

Connectez-vous à MariaDB en tant qu'utilisateur root.

mysql -u root -p
# Enter password:

Créez une nouvelle base de données et un nouvel utilisateur MariaDB. N'oubliez pas les informations d'identification de ce nouvel utilisateur.

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

Installer Nginx

Installez Nginx.

sudo pkg install -y nginx

Vérifiez la version.

nginx -v
# nginx version: nginx/1.16.0

Activez et démarrez Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Exécutez sudo vim /usr/local/etc/nginx/invoiceplane.confet configurez Nginx pour 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;
  }
}

Enregistrez le fichier et quittez.

Maintenant, nous devons inclure invoiceplane.confdans le nginx.conffichier principal .

Exécutez sudo vim /usr/local/etc/nginx/nginx.confet ajoutez la ligne suivante au http {}bloc.

include invoiceplane.conf;

Testez la configuration.

sudo nginx -t

Recharger Nginx.

sudo service nginx reload

Installer InvoicePlane

Téléchargez la dernière version stable d'InvoicePlane et extrayez l'archive.

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

Accédez au /usr/local/www/invoiceplanedossier.

cd /usr/local/www/invoiceplane

Faites une copie du ipconfig.php.examplefichier et renommez la copie ipconfig.php.

sudo cp ipconfig.php.example ipconfig.php

Ouvrez le ipconfig.phpfichier et ajoutez-y votre URL.

sudo vim ipconfig.php
# Something like this
IP_URL=http://example.com

REMARQUE: n'oubliez pas de remplacer l' http://example.comURL par votre propre URL.

Changez la propriété du /usr/local/www/invoiceplanerépertoire en www.

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

Exécutez le programme d'installation InvoicePlane à partir de votre navigateur Web et suivez les instructions.

http://your-domain.com/index.php/setup

Une fois l'installation terminée, vous pouvez vous connecter à InvoicePlane en utilisant l'adresse e-mail et le mot de passe que vous avez choisis lors de l'installation.

Si vous souhaitez sécuriser votre installation, vous pouvez désactiver la configuration. Pour ce faire, remplacez la ligne DISABLE_SETUP=falsepar DISABLE_SETUP=truedans votre ipconfig.phpfichier.