Si të instaloni Monica Personal Relationship Manager në Debian 11

Monica CRM është një CRM pa pagesë dhe me burim të hapur (Menaxheri i Marrëdhënieve me Klientin) i shkruar në PHP. Monica CRM ju ndihmon të gjurmoni ngjarjet personale, aktivitetet, informacionet e punës, kontaktet, ditarët, shënimet dhe shumë të tjera.

Monica CRM ofron kaq shumë veçori të tilla si menaxhimi i kontakteve dhe marrëdhëniet midis kontakteve, kujtesave, aktiviteteve dhe menaxhimit të detyrave, ditarit bazë, importimit dhe eksportimit të të dhënave, ngarkimi i skedarëve media si Dokumentet dhe fotot, dhe shumë të tjera. Mund të instalohet në mënyra të shumta, nëpërmjet Docker, manualisht në server (VPS) ose duke përdorur PaaS (Platforma si Shërbim).

Në këtë udhëzues, do të shihni se si të instaloni Menaxherin e Marrëdhënieve Personale Monica CRM në serverin Debian 11. Ju gjithashtu do të instaloni dhe konfiguroni LEMP Stack (Nginx, MariaDB, PHP-FPM), do të instaloni varësitë PHP përmes Composer, duke instaluar dhe përpiluar asete statike duke përdorur Node.js dhe Yarn.

Parakushtet

Që ky tutorial të funksionojë, do t'ju duhet një server Debian 11 dhe do të konfiguroni përdoruesin jo-root me privilegje rrënjësore ose administratori. Gjithashtu, nëse planifikoni të vendosni në prodhim, do t'ju duhet një emër domeni i treguar në adresën IP të serverit tuaj Debian. Për më tepër, rekomandohet të aktivizoni Firewall-in në prodhimin e serverit tuaj Debian.

Instalimi i serverit në internet Nginx

Monica CRM është një aplikacion ueb i shkruar kryesisht në PHP. Për të instaluar Monica CRM, mund të përdorni një server në internet si serveri në internet Apache2, Nginx ose Caddy.

Në këtë udhëzues, ju do të ekzekutoni Monica CRM me serverin e internetit Nginx. Pra, tani do të instaloni paketat Nginx në serverin tuaj Debian.

Përpara se të filloni instalimin e paketave, ekzekutoni komandën e mëposhtme apt për të përditësuar dhe rifreskuar indeksin e paketave Debian.

sudo apt update

Tani, instaloni paketat Nginx përmes komandës apt më poshtë. Kur ju kërkohet të konfirmoni instalimin, futni Y dhe shtypni ENTER për të vazhduar.

sudo apt install nginx

Pasi të jetë instaluar Nginx, verifikoni shërbimin nginx për t'u siguruar që funksionon nëpërmjet komandës systemctl më poshtë.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Tani do të shihni se shërbimi nginx është aktivizuar dhe do të funksionojë automatikisht në nisjen e sistemit. Dhe statusi i shërbimit Nginx tani po funksionon.

Instalimi i serverit MariaDB

Monica CRM mbështet MySQL/MariaDB për instalim. Tani do të instaloni MariaDB në serverin tuaj Debian. Ju gjithashtu do të siguroni vendosjen e serverit MariaDB nëpërmjet skriptit mysql_secure_installation.

Instaloni serverin MariaDB përmes komandës apt më poshtë. Kur ju kërkohet të konfirmoni instalimin, futni Y dhe shtypni ENTER për të vazhduar.

sudo apt install mariadb-server

Nëse MariaDB është i instaluar, verifikoni shërbimin MariaDB dhe sigurohuni që shërbimi po funksionon. Ekzekutoni komandën e mëposhtme systemctl.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Do të shihni se serveri MariaDB është aktivizuar dhe do të funksionojë automatikisht në nisjen e sistemit. Dhe statusi aktual i shërbimit MariaDB po funksionon.

Më pas, ju do të siguroni vendosjen e serverit MariaDB nëpërmjet skriptit mysql_secure_installation, i cili ofrohet nga paketat MariaDB.

Drejtoni komandën e mëposhtme për të filluar sigurimin e vendosjes së MariaDB.

sudo mysql_secure_installation

Do të pyeteni për konfigurime të shumta MariaDB:

  • Të ndryshohet vërtetimi në unix_socket? hyrje n.
  • Të ndryshohet fjalëkalimi rrënjësor i MariaDB? futni y për të konfirmuar, futni fjalëkalimin e ri për serverin tuaj MariaDB dhe përsërisni fjalëkalimin.
  • Të çaktivizohet identifikimi në distancë nga rrënjët? futni y për të konfirmuar - përdoruesi rrënjë nuk duhet të lejohet të lidhet nga distanca. Të hiqet përdoruesi anonim? futni y për të konfirmuar.
  • Të hiqet testi i paracaktuar i bazës së të dhënave? futni y për të konfirmuar dhe hequr bazën e të dhënave të testit.
  • Së fundi, fut y për të ringarkuar privilegjet e tabelave dhe për të aplikuar ndryshime të reja.

Serveri MariaDB tani është i instaluar dhe i siguruar.

Instalimi dhe konfigurimi i PHP-FPM 8.1

Monica CRM është një aplikacion ueb i bazuar në PHP, kështu që duhet të instaloni paketa PHP në serverin tuaj Debian. Versioni aktual i Monica CRM kërkon të paktën PHP v8.1 ose më të ri.

Për sistemin Debian 11, ju do të instaloni paketat PHP 8.1 nëpërmjet një depoje të palëve të treta. Tani do të instaloni PHP-FPM 8.1 përmes depove sury.org dhe do të konfiguroni instalimin tuaj PHP sipas kërkesave të Monica CRM.

Ekzekutoni komandën e mëposhtme për të shtuar depon e PHP 8.1 në serverin tuaj Debian.

curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x

Tani do të shihni se depoja e re për PHP 8.1 është shtuar dhe indeksi i paketës rifreskohet dhe përditësohet automatikisht.

Më pas, instaloni paketat PHP-FPM 8.1 nëpërmjet komandës apt më poshtë.

sudo apt install php8.1 php8.1-cli php8.1-fpm php8.1-common php8.1-mbstring php8.1-xml php8.1-mysql php8.1-curl php8.1-zip php8.1-intl php8.1-bcmath php8.1-gd php8.1-gmp php8.1-redis

Fut Y për të konfirmuar instalimin dhe shtyp ENTER për të vazhduar.

Pasi të instalohet PHP 8.1, modifikoni skedarin e konfigurimit /etc/php/8.1/fpm/php.ini duke përdorur komandën e redaktuesit nano.

sudo nano /etc/php/8.1/fpm/php.ini

Ndryshoni konfigurimin e paracaktuar të PHP me cilësimet e mëposhtme.

date.timezone = Europe/Paris
max_execution_time = 130
memory_limit = 256M
post_max_size = 128M
upload_max_filesize = 128M

Ruani skedarin dhe mbyllni redaktorin kur të keni mbaruar.

Më pas, rinisni shërbimin PHP-FPM 8.1 për të aplikuar ndryshime të reja nëpërmjet komandës systemctl më poshtë.

sudo systemctl restart php8.1-fpm

Së fundi, ekzekutoni komandën e mëposhtme systemctl për të verifikuar shërbimin PHP-FPM 8.1 dhe sigurohuni që shërbimi të jetë i aktivizuar dhe ekzekutuar.

sudo systemctl is-enabled php8.1-fpm
sudo systemctl status php8.1-fpm

Do të shihni që PHP-FPM 8.1 është aktivizuar dhe do të funksionojë automatikisht në fillimin e sistemit. Dhe statusi aktual i shërbimit PHP-FPM 8.1 po funksionon.

Stack LEMP tani është instaluar dhe konfiguruar, më pas filloni të krijoni një bazë të dhënash dhe përdorues të ri për Monica CRM.

Vendosja e bazës së të dhënave MariaDB dhe përdoruesit

Për të konfiguruar bazën e të dhënave MariaDB dhe përdoruesin për instalimin e Monica CRM, duhet të identifikoheni në guaskën MariaDB.

Hyni në guaskën MariaDB përmes komandës mysql më poshtë.

sudo mysql -u root -p

Drejtoni pyetjet e mëposhtme për të krijuar një bazë të dhënash dhe përdorues të ri për Monica CRM. Për këtë udhëzues, ju do të krijoni një bazë të dhënash të re monicacrm_db me përdoruesin MariaDB [email e mbrojtur]. Gjithashtu, sigurohuni që të ndryshoni fjalëkalimin me fjalëkalimin e ri.

CREATE DATABASE monicacrm_db;
CREATE USER ;
GRANT ALL ON monicacrm_db.* TO 'monica'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Më pas, ekzekutoni pyetjen e mëposhtme për të verifikuar privilegjet për përdoruesin e MariaDB [email e mbrojtur].

SHOW GRANTS FOR ;
quit

Dhe do të shihni se përdoruesi i MariaDB [email e mbrojtur] i lejohet të hyjë në bazën e të dhënave të Monica CRM monicacrm_db.

Instalimi i Kompozitorit

Pasi të jetë konfiguruar baza e të dhënave MariaDB dhe përdoruesi, tani do të instaloni Kompozitorin që do të përdoret për të instaluar varësitë PHP për Monica CRM.

Instaloni Composer përmes komandës me një rresht më poshtë. Kjo komandë do të shkarkojë skriptin e instaluesit për Composer dhe do ta ekzekutojë atë. Më pas, instaloni Kompozitorin në /usr/bin/composer.

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer

Pasi të instalohet Composer, verifikoni duke përdorur komandën e mëposhtme të kompozitorit. Ju duhet të shihni versionin e detajuar të Composer dhe faqen e ndihmës se si të përdorni Composer.

sudo -u www-data composer -v

Instalimi i Node.js dhe Yarn

Pas instalimit të Composer, tani do të instaloni Node.js dhe Yarn. Të dyja paketat do të përdoren për të përpiluar skedarë statikë për Monica CRM. Dhe versioni aktual i Monica CRM kërkon të paktën Node.js v16.

Depoja e parazgjedhur e Debian ofron Node.js v12, kështu që ju do të instaloni versionin më të fundit të Node.js përmes depove të palëve të treta Nodesource.

Ekzekutoni komandën e mëposhtme për të shtuar depon e Node.js Nodesource. Në këtë shembull, ju do të instaloni Node.js v16.

curl -fsSL https://deb.nodesource.com/setup_16.x | bash -

Tani do të shihni se depoja e Nodesource është shtuar në sistemin ypur Debian dhe indeksi i paketës rifreskohet.

Më pas, ekzekutoni komandën e mëposhtme për të shtuar depon e paketave të fijeve në sistemin tuaj.

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/yarnkey.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

Tani përditësoni dhe rifreskoni indeksin tuaj të paketës Debian. Më pas, instaloni Node.js dhe Yarn nëpërmjet komandës apt të mëposhtme.

sudo apt update
sudo apt install nodejs yarn

Futni y për të konfirmuar instalimin dhe shtypni ENTER për të konfirmuar dhe vazhduar.

Pasi të instalohet Node.js dhe Yarn, ekzekutoni komandën e mëposhtme për të kontrolluar skedarin binar të të dy aplikacioneve.

which node
which yarn

Së fundi, kontrolloni versionin Node.js dhe Yarn duke përdorur komandën e mëposhtme. Do të shihni versionin e instaluar të Node.js dhe Yarn në dalje.

node --version
yarn --version

Në këtë pikë, është instaluar varësia e paketës për Monica CRM. Më pas, do të filloni instalimin e Monica CRM duke shkarkuar kodin burimor, duke instaluar varësitë e paketës përmes Composer, më pas duke përpiluar skedarë statikë duke përdorur Node.js dhe Yarn.

Instalimi i Monica CRM

Tani do të filloni instalimin e Monica CRM. Do të shkarkoni kodin burimor, do të konfiguroni lejen dhe pronësinë e duhur, do të instaloni varësitë e PHP përmes Composer, do të instaloni dhe gjeneroni skedarë statikë përmes Yarn dhe Node.js, më pas do të gjeneroni çelësin e aplikacionit dhe do të migroni bazën e të dhënave për prodhim.

Përpara se të filloni instalimin, sigurohuni që paketa git të jetë e instaluar. Nëse jo, mund ta instaloni përmes komandës apt më poshtë.

sudo apt install git -y

Tani, zhvendosni direktorinë e punës në \/var/www/\ dhe shkarkoni kodin burimor të Monica CRM nëpërmjet komandës git si më poshtë. Do të shihni drejtorinë e re \monica\.

cd /var/www/
git clone https://github.com/monicahq/monica.git

Kalo te drejtoria \/var/www/monica\ dhe zhvendos degën kryesore në versionin specifik \3.7.0\. Mund të kontrolloni faqen GitHub të Monica CRM për të marrë versione të detajuara të Monica CRM.

cd /var/www/monica
git checkout tags/v3.7.0

Më pas, kopjoni konfigurimin e paracaktuar .env.example në .env. Më pas, ndrysho pronësinë në www-data.

cp /var/www/monica/.env.example /var/www/monica/.env
sudo chown www-data:www-data /var/www/monica/.env

Redaktoni skedarin .env duke përdorur nano editor.

nano /var/www/monica/.env

Ndrysho APP_ENV në prodhim dhe APP_URL në emrin e domenit të instalimit të Monica CRM. Më pas, ndryshoni detajet e bazës së të dhënave MariaDB me bazën e të dhënave dhe përdoruesin që keni krijuar më parë.

APP_ENV=production
...
APP_URL=https://hwdomain.io/
...
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
...
DB_DATABASE=monica
DB_USERNAME=homestead
DB_PASSWORD=password

Ruani skedarin dhe dilni nga redaktori kur të keni mbaruar.

Tani ekzekutoni komandën e mëposhtme për të ndryshuar pronësinë e dosjes së instalimit të Monica CRM /var/www/monica te përdoruesi www-data. Më pas, krijoni një drejtori tjetër /var/www/.cache dhe ndryshoni pronësinë në www-data.

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

sudo mkdir -p /var/www/.cache
sudo chown -R www-data:www-data /var/www/.cache

Më pas, ekzekutoni komandën e mëposhtme të kompozitorit për të instaluar varësitë e paketës PHP për Monica CRM.

sudo -u www-data composer install --no-interaction --no-dev

Më poshtë mund të shihni instalimin e varësive të PHP.

Pasi të instalohen varësitë, do të shihni daljen si më poshtë:

Më pas, krijoni një drejtori tjetër të re që do të përdoret për të ruajtur cache-in e paketave JavaScript. Më pas, ndryshoni pronësinë në www-data.

sudo mkdir -p /var/www/.yarn
sudo chown -R www-data:www-data /var/www/.yarn

Pas kësaj, instaloni paketat JavaScript për aplikacionet në internet Monica CRM dhe gjeneroni skedarë statikë për mjedisin e prodhimit nëpërmjet komandës fije më poshtë.

sudo -u www-data yarn install
sudo -u www-data yarn run production

Më poshtë mund të shihni procesin e shkarkimit të paketave JavaScript.

Më poshtë mund të shihni procesin e përpilimit të skedarëve statikë.

Kur përpilohen skedarët statikë, do të shihni mesazhin dalës të tillë si \Përpiluar me sukses në ...\.

Tani, ekzekutoni komandën e mëposhtme për të gjeneruar çelësin e aplikacionit për Monica CRM. Pastaj, migroni bazën e të dhënave për prodhim. Kur ju kërkohet të konfirmoni veprimin, futni po dhe shtypni ENTER për të vazhduar.

sudo -u www-data php artisan key:generate
sudo -u www-data php artisan setup:production -v

Pasi të migrohet baza e të dhënave, do të shihni daljen si më poshtë:

Së fundi, për të përfunduar konfigurimin e Monica CRM, do t'ju duhet gjithashtu të krijoni një Cronjob. Ekzekutoni komandën e mëposhtme për të krijuar një cron të ri për përdoruesin www-data.

crontab -u www-data -e

Zgjidhni redaktorin tuaj të preferuar dhe shijoni konfigurimin e mëposhtëm në skedar.

* * * * *   /usr/bin/php /var/www/monica/artisan schedule:run >> /dev/null 2>&1

Ruani skedarin dhe dilni nga redaktori kur të keni mbaruar.

Për të siguruar lejen e drejtorisë së instalimit të Monica CRM, ekzekutoni komandën e mëposhtme për të ndryshuar pronësinë në www-data. Më pas, ndryshoni lejen e drejtorisë store në 775.

sudo chown -R www-data:www-data /var/www/monica
sudo chmod -R 775 /var/www/monica/storage

Në këtë pikë, ju keni përfunduar konfigurimin e Monica CRM. më pas, do të konfiguroni bllokun e serverit Nginx për Monica CRM.

Konfigurimi i bllokut të serverit Nginx

Përpara se të konfiguroni bllokun e serverit Nginx, nëse emri juaj i domenit është i drejtuar në adresën IP të serverit, gjithashtu sigurohuni që tashmë keni certifikata SSL. Nëse nuk keni certifikata SSL, mund të gjeneroni SSL falas nëpërmjet Letsencrypt.

Krijo një skedar të ri /etc/nginx/sites-available/monicacrm duke përdorur redaktuesin nano.

sudo nano /etc/nginx/sites-available/monicacrm

Shtoni konfigurimet Nginx më poshtë. Dhe sigurohuni që të ndryshoni emrin e domenit dhe shtegun e certifikatave SSL.

server {

    listen 80;
    server_name hwdomain.io;
    return 301 https://$host$request_uri;

}

server {
    listen 443 ssl http2;

    ssl_certificate /etc/letsencrypt/live/hwdomain.io/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/hwdomain.io/private.key;

    server_name hwdomain.io;
    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/php8.1-fpm.sock;
    }
}

Ruani skedarin dhe dilni nga redaktori kur të keni mbaruar.

Më pas, ekzekutoni komandën e mëposhtme për të aktivizuar bllokun e serverit Nginx monicacrm. Më pas, verifikoni konfigurimin Nginx për t'u siguruar që keni konfigurimin e duhur.

sudo ln -s /etc/nginx/sites-available/monicacrm /etc/nginx/sites-enabled/
sudo nginx -t

Nëse keni konfigurimin e duhur Nginx, duhet të shihni mesazhin dalës, si p.sh. \Sintaksa OK - testoni me sukses\.

Tani, ekzekutoni komandën e mëposhtme systemctl për të rifilluar shërbimin Nginx dhe për të aplikuar konfigurimin e bllokut të serverit nee.

sudo systemctl restart nginx

Instalimi juaj i Monica CRM tani është i aksesueshëm nëpërmjet shfletuesit të internetit.

Duke përfunduar

Hapni shfletuesin e internetit dhe vizitoni emrin e domenit të instalimit tuaj Monica CRM (p.sh.: https://hwdomain.io/). Në konfigurimin e parë, do t'ju duhet të regjistroni një llogari për instalimin tuaj të Monica CRM.

Futni detajet e emrit të përdoruesit, fjalëkalimin dhe adresën e emailit. Më pas kliko Regjistrohu.

Pasi përdoruesi të regjistrohet, tani do të shihni panelin e përdoruesit të Monica CRM.

konkluzioni

Në këtë tutorial, ju keni instaluar Monica CRM në serverin Debian 11. Ju gjithashtu keni konfiguruar LEMP Stack (Nginx, MariaDB dhe PHP-FPM) në serverin Debian, keni instaluar Kompozitorin e menaxhimit të paketave PHP dhe keni instaluar Node.js dhe Yarn.

Përgjatë këtij tutoriali, ju tani keni monica CRM të instaluar dhe të siguruar nëpërmjet lidhjeve HTTPS. Tani mund të filloni të organizoni kontaktet tuaja, të krijoni revista dhe të gjurmoni çdo gjë të rëndësishme në lidhje me kontaktet tuaja.