introduction
Invoice Ninja est une application Web gratuite et open source qui peut être utilisée pour la facturation, les paiements, le suivi du temps et bien plus encore. C'est la meilleure solution pour la facturation et la facturation des clients. Vous pouvez facilement créer et envoyer des factures en ligne en quelques secondes. Invoice Ninja vous permet de créer des factures personnalisées et d'afficher les factures en direct sous forme de fichier PDF.
Dans ce tutoriel, je vais vous expliquer comment installer Invoice Ninja sur le serveur Ubuntu 16.04.
Conditions préalables
- Une instance de serveur Ubuntu 16.04 avec 2 Go de RAM installée.
- Un utilisateur sudo avec des privilèges root.
- Vous devrez connaître l'IP principale de votre instance de serveur. Dans ce tutoriel, je vais utiliser
192.168.0.227
.
Étape 1: mettre à jour le système
Avant d'installer des packages sur une instance de serveur Ubuntu, il est recommandé de mettre à jour le système. Connectez-vous à votre serveur via SSH en tant qu'utilisateur sudo et exécutez la commande suivante:
sudo apt-get update -y
sudo apt-get upgrade -y
sudo shutdown -r now
Étape 2: installer la pile LEMP
Avant de commencer, vous devrez configurer une pile LEMP (Nginx, MariaDB et PHP) sur votre serveur.
Tout d'abord, installez Nginx et MariaDB avec la commande suivante:
sudo apt-get install nginx mariadb-server -y
Une fois l'installation terminée, démarrez les services Nginx et MariaDB et activez-les au démarrage:
sudo systemctl start nginx
sudo systemctl enable nginx
sudo systemctl start mysql
sudo systemctl enable mysql
Ensuite, vous aurez besoin de PHP 7 et PHP-FPM pour l'installation de Invoice Ninja.
Vous pouvez installer PHP-FPM et les autres extensions PHP requises avec la commande suivante:
sudo apt-get install php7.0-fpm php7.0-gd php7.0-xml php7.0-mysql php7.0-zip php7.0-curl php7.0-gmp php7.0-mbstring php7.0-mcrypt
Une fois l'installation terminée, vous devrez modifier le php.ini
fichier de configuration:
sudo nano /etc/php/7.0/fpm/php.ini
Modifiez la ligne suivante:
cgi.fix_pathinfo=0
Enregistrez et fermez le fichier.
Par défaut, l'installation de MariaDB n'est pas sécurisée. Vous devrez le sécuriser. Vous pouvez le faire en exécutant mysql_secure_installation script
.
sudo mysql_secure_installation
Répondez à toutes les questions comme indiqué ci-dessous:
Set root password? [Y/n] Y
New password:
Re-enter new 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
Lorsque tout est terminé, connectez-vous à l'aide du shell MySQL avec la commande suivante:
mysql -u root -p
Entrez votre mot de passe root et appuyez sur "enter", vous verrez le shell MySQL (MariaDB).
Créez une nouvelle base de données et un nouvel utilisateur pour Invoice Ninja.
MariaDB [(none)]> CREATE DATABASE ninja_db;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON ninja_db.* TO 'ninja'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> \q
Configurez le pool PHP-FPM pour l'utilisateur Nginx:
sudo nano /etc/php/7.0/fpm/pool.d/www-data.conf
Ajoutez les lignes suivantes:
[www-data]
user = www-data
group = www-data
listen = /var/run/php-fpm-www-data.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0666
pm = ondemand
pm.max_children = 5
pm.process_idle_timeout = 10s
pm.max_requests = 200
chdir = /
Enregistrez et fermez le fichier lorsque vous avez terminé, puis redémarrez PHP-FPM pour appliquer ces modifications.
systemctl restart php7.0-fpm
Vous pouvez télécharger la dernière version stable d'Invoice Ninja à partir du référentiel GitHub avec la commande suivante:
cd /var/www/html/
sudo git clone https://github.com/hillelcoren/invoice-ninja.git ninja
Vous devrez également installer Composer, un gestionnaire de dépendances pour PHP. Vous pouvez l'installer avec la commande suivante:
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer
Ensuite, installez toutes les dépendances Invoice Ninja à l'aide de la composer
commande comme indiqué ci-dessous:
cd /var/www/html/ninja
sudo composer install --no-dev -o
Une fois l'installation terminée, renommez le .env
fichier et apportez quelques modifications.
sudo mv .env.example .env
sudo nano .env
Modifiez les lignes comme indiqué ci-dessous:
DB_DATABASE=ninja_db
DB_USERNAME=ninja
DB_PASSWORD=password
Enregistrez le fichier lorsque vous avez terminé, puis exécutez la commande suivante pour préparer la base de données:
sudo php artisan migrate
Vous serez invité à exécuter la commande, tapez "oui" et appuyez sur "Entrée".
Ensuite, amorcez la base de données avec des enregistrements comme indiqué ci-dessous:
sudo php artisan db:seed
Tapez "oui" et appuyez sur "Entrée".
Ensuite, changez de propriétaire du /var/www/html/ninja
répertoire:
sudo chown -R www-data:www-data /var/www/html/ninja/
Ensuite, vous devrez créer un certificat SSL et créer une nouvelle configuration d'hôte virtuel pour Invoice Ninja.
Créez d'abord un répertoire pour SSL:
sudo mkdir -p /etc/nginx/cert/
Ensuite, générez un certificat SSL avec la commande suivante:
sudo openssl req -new -x509 -days 365 -nodes -out /etc/nginx/cert/ninja.crt -keyout /etc/nginx/cert/ninja.key
Accordez les autorisations appropriées au fichier de certificat.
sudo chmod 600 /etc/nginx/cert/*
Créez un nouveau fichier de configuration d'hôte virtuel à l'intérieur du /etc/nginx/
répertoire.
sudo nano /etc/nginx/conf.d/ninja.conf
Ajoutez les lignes suivantes:
server {
listen 80;
server_name 192.168.0.227;
add_header Strict-Transport-Security max-age=2592000;
rewrite ^ https://$server_name$request_uri? permanent;
}
server {
listen 443 default;
server_name 192.168.0.227;
ssl on;
ssl_certificate /etc/nginx/cert/ninja.crt;
ssl_certificate_key /etc/nginx/cert/ninja.key;
ssl_session_timeout 5m;
ssl_ciphers 'AES128+EECDH:AES128+EDH:!aNULL';
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
root /var/www/html/ninja/public;
index index.html index.htm index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
# Access and Error Log for Invoice Ninja
access_log /var/log/nginx/ininja.access.log;
error_log /var/log/nginx/ininja.error.log;
sendfile off;
# Handle PHP Applications
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php-fpm-www-data.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_intercept_errors off;
fastcgi_buffer_size 16k;
fastcgi_buffers 4 16k;
}
location ~ /\.ht {
deny all;
}
}
Enregistrez et fermez le fichier. Activez ensuite l'hôte virtuel avec la commande suivante.
sudo ln -s /etc/nginx/sites-available/ninja /etc/nginx/sites-enabled/
Enfin, redémarrez le serveur Web Nginx.
sudo systemctl restart nginx
Étape 7: Accéder à Invoice Ninja
Avant d'accéder à l'interface Web Invoice Ninja, vous devrez autoriser les services HTTP et HTTPS via le pare-feu UFW. Exécutez les commandes suivantes pour ouvrir ces ports:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
Enfin, ouvrez votre navigateur Web et accédez à l'URL https://192.168.0.227
. Vous pouvez ensuite effectuer les étapes requises pour terminer l'installation.
Toutes nos félicitations! Nous avons installé avec succès Invoice Ninja avec Nginx et MariaDB sur le serveur Ubuntu 16.04.