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
- Debian 9.x (Stretch)
- Git
- NPM (Node Package Manager)
- PHP 7.1+ ou plus récent
- MySQL
- Nginx
- Compositeur
Vérifiez la version Debian.
lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)
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 les build-essential, curl, git, apt-transport-https, libpng-devpaquets.
sudo apt install -y build-essential curl git apt-transport-https libpng-dev
Installer PHP
Ajoutez le référentiel pour les nouvelles versions de PHP.
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update
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 php7.2-bcmath php7.2-gd
Vérifiez la version.
php --version
# PHP 7.2.5-1+0~20180505045740.21+stretch~1.gbpca2fa6 (cli) (built: May 5 2018 04:57:44) ( 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-1+0~20180505045740.21+stretch~1.gbpca2fa6, Copyright (c) 1999-2018, by Zend Technologies
Installer MySQL et configurer la base de données
Installez MySQL.
cd /tmp
wget https://dev.mysql.com/get/mysql-apt-config_0.8.10-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.10-1_all.deb
rm mysql-apt-config_0.8.10-1_all.deb
sudo apt update
sudo apt install -y mysql-server
Vérifiez la version.
mysql --version
# mysql Ver 8.0.11 for Linux on x86_64 (MySQL Community Server - GPL)
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;
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON dbname.* TO username@localhost;
FLUSH PRIVILEGES;
EXIT;
Installez Nginx.
sudo apt install -y nginx
Vérifiez la version.
sudo nginx -v
# nginx version: nginx/1.10.3
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
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.
Créez votre propre fichier contenant les variables d'environnement requises par Monica.
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
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
L'installation est terminée. Ouvrez votre domaine dans votre navigateur Web et suivez les instructions affichées à l'écran.