Hvordan installere Monica på Ubuntu 18.04 LTS

Monica er et åpen kildekodesystem for personlig relasjonsstyring. Tenk på det som et CRM (et populært verktøy som brukes av salgsteam i bedriftsverdenen) for venner eller familie. Kildekoden er offentlig vert på GitHub . I denne veiledningen vil vi gå gjennom installasjonsprosessen til en Monica-applikasjon.

Krav

• Ubuntu Server 18.04 LTS (Bionic Beaver)
• Git
• NPM (Node Package Manager)
• PHP 7.1+ eller nyere
• MySQL
• Nginx
• Komponist

Merknad om Git : Git vil mest sannsynlig allerede være installert på Ubuntu-serveren. Hvis det ikke er det, kan du enkelt installere det ved å kjøre:sudo apt install -y git

Sjekk Ubuntu-versjonen.

lsb_release -ds
# Ubuntu 18.04 LTS

Opprett en ny non-rootbrukerkonto med sudotilgang og bytt til den.

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

MERK : Erstatt johndoemed brukernavnet ditt .

Sett opp tidssonen.

sudo dpkg-reconfigure tzdata

Sørg for at systemet ditt er oppdatert.

sudo apt update && sudo apt upgrade -y

Installer build-essentialog libpng-dev.

sudo apt install -y build-essential libpng-dev

Installer PHP

Installer PHP 7.2 og nødvendige PHP-utvidelser.

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

Sjekk versjonen.

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 og sett opp en database

Installer MySQL.

sudo apt install -y mysql-server

Sjekk versjonen.

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

Kjør mysql_secure installationskriptet for å forbedre MySQL-sikkerheten og angi passordet for MySQL- rootbrukeren.

sudo mysql_secure_installation

Koble til MySQL-skallet som root-bruker.

sudo mysql -u root -p
# Enter password

Lag en tom MySQL-database og bruker for Monica, og husk legitimasjonen.

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

Installer og konfigurer Nginx

Installer Nginx.

sudo apt install -y nginx

Sjekk versjonen.

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

Kjør sudo vim /etc/nginx/sites-available/monica.confog konfigurer Nginx for 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;
    }
}

Lagre filen og avslutt.

Aktiver den nye monica.confkonfigurasjonen ved å koble filen til sites-enabledkatalogen.

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

Test konfigurasjonen.

sudo nginx -t

Last inn Nginx på nytt.

sudo systemctl reload nginx.service

Installer Node.js og NPM

Installer Node.js.

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

Sjekk Node.js- og npm-versjonene.

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

Installer Composer

Installer 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

Sjekk versjonen.

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

Installer og konfigurer Monica

Opprett en tom dokumentrotmappe der Monica skal installeres.

sudo mkdir -p /var/www/monica

Naviger til dokumentrotmappen.

cd /var/www/monica

Endre eierskap av /var/www/monicamappe til bruker johndoe.

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

Klon Monica-depotet til det.

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

MERK : Finn den siste offisielle versjonen på utgivelsessiden på GitHub og oppdater versjonsnummeret ovenfor til den siste utgivelsen.

Kjør følgende for å lage din egen versjon av miljøvariablene som trengs for prosjektet.

cp .env.example .env

Oppdater .envfilen til dine spesifikke behov. Ikke glem å stille inn DB_USERNAMEog DB_PASSWORDmed innstillingene som ble brukt tidligere.

Installer alle pakkene.

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

Installer alle front-end-avhengigheter og verktøy som trengs for å kompilere eiendeler.

npm install yarn
npm install

Kompiler JS- og CSS-elementene.

npm run production

Generer en applikasjonsnøkkel. Dette vil automatisk settes APP_KEYtil riktig verdi.

php artisan key:generate

Kjør migreringene og seed databasen og symlinkmappene.

php artisan setup:production

Endre eierskap av /var/www/monicakatalogen til www-data.

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

Mulig problem: NPM-pakken vue-directive-tooltiphar fått sin katalogstruktur endret, men monicahqconfig har ikke endret den ennå (fra 09/2019). For å fikse det, må følgende linje inn /var/www/monica/resources/assets/js/app.jsendres fra:

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

Installasjonen er fullført. Åpne domenet ditt i nettleseren og følg instruksjonene som vises på skjermen.