Sådan installeres Monica på Ubuntu 18.04 LTS

Monica er et open source system til styring af personlige relationer. Tænk på det som et CRM (et populært værktøj, der bruges af salgsteams i erhvervslivet) til dine venner eller familie. Dens kildekode er offentligt hostet på GitHub . I denne guide vil vi gennemgå installationsprocessen for en Monica-applikation.

Krav

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

Bemærk om Git : Git vil højst sandsynligt allerede være installeret på Ubuntu-serveren. Hvis det ikke er det, kan du nemt installere det ved at køre:sudo apt install -y git

Tjek Ubuntu-versionen.

lsb_release -ds
# Ubuntu 18.04 LTS

Opret en ny non-rootbrugerkonto med sudoadgang og skift til den.

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

BEMÆRK : Erstat johndoemed dit brugernavn .

Indstil tidszonen.

sudo dpkg-reconfigure tzdata

Sørg for, at dit system er opdateret.

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-udvidelser.

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

Tjek 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

Installer MySQL og opsæt en database

Installer MySQL.

sudo apt install -y mysql-server

Tjek versionen.

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

Kør mysql_secure installationscriptet for at forbedre MySQL-sikkerheden og indstil adgangskoden til MySQL- rootbrugeren.

sudo mysql_secure_installation

Opret forbindelse til MySQL-skallen som root-bruger.

sudo mysql -u root -p
# Enter password

Opret en tom MySQL-database og bruger til Monica, og husk legitimationsoplysningerne.

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

Tjek versionen.

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

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

Gem filen og afslut.

Aktiver den nye monica.confkonfiguration ved at linke filen til sites-enabledmappen.

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

Test konfigurationen.

sudo nginx -t

Genindlæs Nginx.

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

Tjek Node.js- og npm-versionerne.

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

Tjek versionen.

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

Installer og konfigurer Monica

Opret en tom dokumentrodmappe, hvor Monica skal installeres.

sudo mkdir -p /var/www/monica

Naviger til dokumentets rodmapp.

cd /var/www/monica

Skift ejerskab af /var/www/monicamappe til bruger 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

BEMÆRK : Find den seneste officielle version på udgivelsessiden på GitHub og opdater versionsnummeret ovenfor til den seneste udgivelse.

Kør følgende for at oprette din egen version af de miljøvariabler, der er nødvendige for projektet.

cp .env.example .env

Opdater .envfilen til dine specifikke behov. Glem ikke at indstille DB_USERNAMEog DB_PASSWORDmed de tidligere brugte indstillinger.

Installer alle pakker.

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

Installer alle frontend-afhængigheder og værktøjer, der er nødvendige for at kompilere aktiver.

npm install yarn
npm install

Kompiler JS- og CSS-aktiverne.

npm run production

Generer en applikationsnøgle. Dette indstilles APP_KEYautomatisk til den korrekte værdi.

php artisan key:generate

Kør migreringerne og seed databasen og symlink-mapperne.

php artisan setup:production

Skift ejerskab af /var/www/monicabiblioteket til www-data.

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

Muligt problem: NPM-pakken vue-directive-tooltiphar fået ændret sin mappestruktur, men monicahqconfig har ikke ændret den endnu (pr. 09/2019). For at rette op på det, skal følgende linje i /var/www/monica/resources/assets/js/app.jsændres fra:

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

Installationen er fuldført. Åbn dit domæne i din webbrowser og følg instruktionerne vist på skærmen.