Comment installer Monica sur Ubuntu 18.04 LTS

• Exigences
• Installer PHP
• Installer MySQL et configurer une base de données
• Installer et configurer Nginx
• Installez Node.js et NPM
• Installer Composer
• Installer et configurer Monica

Monica est un système de gestion des relations personnelles open source. Considérez-le comme un CRM (un outil populaire utilisé par les équipes commerciales dans le monde de l'entreprise) pour vos amis ou votre famille. Son code source est publiquement hébergé sur GitHub . Dans ce guide, nous allons passer en revue le processus d'installation d'une application Monica.

Exigences

• Serveur Ubuntu 18.04 LTS (Bionic Beaver)
• Git
• NPM (Node Package Manager)
• PHP 7.1+ ou plus récent
• MySQL
• Nginx
• Compositeur

Remarque à propos de Git : Git sera probablement déjà installé sur le serveur Ubuntu. Dans le cas contraire, vous pouvez facilement l'installer en exécutant:sudo apt install -y git

Vérifiez la version d'Ubuntu.

lsb_release -ds
# Ubuntu 18.04 LTS

Créez un nouveau non-rootcompte utilisateur avec sudoaccès et passez-y.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

REMARQUE : remplacez johndoepar votre nom d'utilisateur .

Configurez le fuseau horaire.

sudo dpkg-reconfigure tzdata

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

sudo apt update && sudo apt upgrade -y

Installez build-essentialet libpng-dev.

sudo apt install -y build-essential libpng-dev

Installer PHP

Installez PHP 7.2 et les extensions PHP requises.

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-xml php7.2-mysql php7.2-curl php7.2-zip php7.2-intl

Vérifiez la version.

php --version

# PHP 7.2.5-0ubuntu0.18.04.1 (cli) (built: May  9 2018 17:21:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.5-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Installer MySQL et configurer une base de données

Installez MySQL.

sudo apt install -y mysql-server

Vérifiez la version.

mysql --version
# mysql  Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using  EditLine wrapper

Exécutez le mysql_secure installationscript pour améliorer la sécurité MySQL et définissez le mot de passe de l' rootutilisateur MySQL .

sudo mysql_secure_installation

Connectez-vous au shell MySQL en tant qu'utilisateur root.

sudo mysql -u root -p
# Enter password

Créez une base de données et un utilisateur MySQL vides pour Monica et n'oubliez pas les informations d'identification.

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

Installer et configurer Nginx

Installez Nginx.

sudo apt install -y nginx

Vérifiez la version.

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

Exécutez sudo vim /etc/nginx/sites-available/monica.confet configurez Nginx pour Monica.

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

    server_name example.com;
    root /var/www/monica/public;

    index index.php;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    }
}

Enregistrez le fichier et quittez.

Activez la nouvelle monica.confconfiguration en liant le fichier au sites-enabledrépertoire.

sudo ln -s /etc/nginx/sites-available/monica.conf /etc/nginx/sites-enabled/

Testez la configuration.

sudo nginx -t

Recharger Nginx.

sudo systemctl reload nginx.service

Installez Node.js et NPM

Installez Node.js.

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

Vérifiez les versions Node.js et npm.

node -v && npm -v
# v10.2.1
# 5.6.0

Installer Composer

Installez Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Vérifiez la version.

composer --version
# Composer version 1.6.5 2018-05-04 11:44:59

Installer et configurer Monica

Créez un dossier racine de document vide dans lequel Monica doit être installé.

sudo mkdir -p /var/www/monica

Accédez au dossier racine du document.

cd /var/www/monica

Changez la propriété du /var/www/monicadossier en utilisateur johndoe.

sudo chown -R johndoe:johndoe /var/www/monica

Clonez-y le référentiel Monica.

git clone https://github.com/monicahq/monica.git .
git checkout tags/v2.1.1

REMARQUE : recherchez la dernière version officielle sur la page des versions sur GitHub et mettez à jour le numéro de version ci-dessus vers la dernière version.

Exécutez ce qui suit pour créer votre propre version des variables d'environnement nécessaires au projet.

cp .env.example .env

Mettez à jour le .envfichier selon vos besoins spécifiques. N'oubliez pas de définir DB_USERNAMEet DB_PASSWORDavec les paramètres utilisés précédemment.

Installez tous les packages.

composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs

Installez toutes les dépendances et outils frontaux nécessaires à la compilation des actifs.

npm install yarn
npm install

Compilez les actifs JS et CSS.

npm run production

Générez une clé d'application. Ce sera APP_KEYautomatiquement réglé sur la valeur correcte.

php artisan key:generate

Exécutez les migrations et amorcez la base de données et les dossiers de liens symboliques.

php artisan setup:production

Changez la propriété du /var/www/monicarépertoire en www-data.

sudo chown -R www-data:www-data /var/www/monica

Problème possible: vue-directive-tooltipla structure de répertoire du package NPM a été modifiée, mais la monicahqconfiguration ne l'a pas encore modifiée (au 09/2019). Pour résoudre ce problème, la ligne suivante /var/www/monica/resources/assets/js/app.jsdoit être modifiée à partir de:

import 'vue-directive-tooltip/css/index.css'
to
import 'vue-directive-tooltip/src/css/index.css'

L'installation est terminée. Ouvrez votre domaine dans votre navigateur Web et suivez les instructions affichées à l'écran.