Hur man installerar Monica på Ubuntu 18.04 LTS

Monica är ett personligt relationshanteringssystem med öppen källkod. Se det som ett CRM (ett populärt verktyg som används av säljteam i företagsvärlden) för dina vänner eller familj. Dess källkod är offentligt värd på GitHub . I den här guiden kommer vi att gå igenom installationsprocessen för en Monica-applikation.

Krav

• Ubuntu Server 18.04 LTS (Bionic Beaver)
• Git
• NPM (Node Package Manager)
• PHP 7.1+ eller senare
• MySQL
• Nginx
• Kompositör

Anmärkning om Git : Git kommer troligen redan att vara installerat på Ubuntu-servern. Om det inte är det kan du enkelt installera det genom att köra:sudo apt install -y git

Kontrollera Ubuntu-versionen.

lsb_release -ds
# Ubuntu 18.04 LTS

Skapa ett nytt non-rootanvändarkonto med sudoåtkomst och byt till det.

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

OBS : Ersätt johndoemed ditt användarnamn .

Ställ in tidszonen.

sudo dpkg-reconfigure tzdata

Se till att ditt system är uppdaterat.

sudo apt update && sudo apt upgrade -y

Installera build-essentialoch libpng-dev.

sudo apt install -y build-essential libpng-dev

Installera PHP

Installera PHP 7.2 och nödvändiga PHP-tillägg.

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

Kontrollera versionen.

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

Installera MySQL och ställ in en databas

Installera MySQL.

sudo apt install -y mysql-server

Kontrollera versionen.

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

Kör mysql_secure installationskriptet för att förbättra MySQL-säkerheten och ställ in lösenordet för MySQL- rootanvändaren.

sudo mysql_secure_installation

Anslut till MySQL-skalet som root-användare.

sudo mysql -u root -p
# Enter password

Skapa en tom MySQL-databas och användare för Monica, och kom ihåg autentiseringsuppgifterna.

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

Installera och konfigurera Nginx

Installera Nginx.

sudo apt install -y nginx

Kontrollera versionen.

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

Kör sudo vim /etc/nginx/sites-available/monica.confoch konfigurera Nginx för 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;
    }
}

Spara filen och avsluta.

Aktivera den nya monica.confkonfigurationen genom att länka filen till sites-enabledkatalogen.

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

Testa konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Node.js och NPM

Installera Node.js.

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

Kontrollera versionerna Node.js och npm.

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

Installera Composer

Installera 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

Kontrollera versionen.

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

Installera och konfigurera Monica

Skapa en tom dokumentrotmapp där Monica ska installeras.

sudo mkdir -p /var/www/monica

Navigera till dokumentets rotmapp.

cd /var/www/monica

Ändra ägande av /var/www/monicamapp till användare johndoe.

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

Klona Monica-förvaret till det.

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

OBS : Hitta den senaste officiella versionen på releasesidan på GitHub och uppdatera versionsnumret ovan till den senaste versionen.

Kör följande för att skapa din egen version av de miljövariabler som behövs för projektet.

cp .env.example .env

Uppdatera .envfilen efter dina specifika behov. Glöm inte att ställa in DB_USERNAMEoch DB_PASSWORDmed de inställningar som användes tidigare.

Installera alla paket.

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

Installera alla front-end-beroenden och verktyg som behövs för att kompilera tillgångar.

npm install yarn
npm install

Kompilera JS- och CSS-tillgångarna.

npm run production

Skapa en applikationsnyckel. Detta kommer APP_KEYautomatiskt att ställas in på rätt värde.

php artisan key:generate

Kör migreringarna och seed databasen och symlinkmapparna.

php artisan setup:production

Ändra ägande av /var/www/monicakatalogen till www-data.

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

Möjligt problem: NPM-paketet vue-directive-tooltiphar fått sin katalogstruktur ändrad, men monicahqconfig har inte ändrat den ännu (från och med 09/2019). För att fixa det /var/www/monica/resources/assets/js/app.jsmåste följande rad ändras från:

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

Installationen är klar. Öppna din domän i din webbläsare och följ instruktionerna som visas på skärmen.