So installieren Sie Monica unter Ubuntu 18.04 LTS

• Bedarf
• Installieren Sie PHP
• Installieren Sie MySQL und richten Sie eine Datenbank ein
• Installieren und konfigurieren Sie Nginx
• Installieren Sie Node.js und NPM
• Installieren Sie Composer
• Installieren und konfigurieren Sie Monica

Monica ist ein Open-Source-System für das persönliche Beziehungsmanagement. Stellen Sie sich das als CRM (ein beliebtes Tool für Verkaufsteams in der Unternehmenswelt) für Ihre Freunde oder Familie vor. Der Quellcode wird öffentlich auf GitHub gehostet . In diesem Handbuch werden wir den Installationsprozess einer Monica-Anwendung erläutern.

Bedarf

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

Hinweis zu Git : Git wird höchstwahrscheinlich bereits auf dem Ubuntu-Server installiert sein. Falls dies nicht der Fall ist, können Sie es einfach installieren, indem Sie Folgendes ausführen:sudo apt install -y git

Überprüfen Sie die Ubuntu-Version.

lsb_release -ds
# Ubuntu 18.04 LTS

Erstellen Sie ein neues non-rootBenutzerkonto mit sudoZugriff und wechseln Sie zu diesem.

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

HINWEIS : Ersetzen Sie johndoedurch Ihren Benutzernamen .

Richten Sie die Zeitzone ein.

sudo dpkg-reconfigure tzdata

Stellen Sie sicher, dass Ihr System auf dem neuesten Stand ist.

sudo apt update && sudo apt upgrade -y

Installieren Sie build-essentialund libpng-dev.

sudo apt install -y build-essential libpng-dev

Installieren Sie PHP

Installieren Sie PHP 7.2 und die erforderlichen PHP-Erweiterungen.

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

Überprüfe die Version.

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

Installieren Sie MySQL und richten Sie eine Datenbank ein

Installieren Sie MySQL.

sudo apt install -y mysql-server

Überprüfe die Version.

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

Führen Sie das mysql_secure installationSkript aus, um die MySQL-Sicherheit zu verbessern, und legen Sie das Kennwort für den MySQL- rootBenutzer fest.

sudo mysql_secure_installation

Stellen Sie als Root-Benutzer eine Verbindung zur MySQL-Shell her.

sudo mysql -u root -p
# Enter password

Erstellen Sie eine leere MySQL-Datenbank und einen Benutzer für Monica und merken Sie sich die Anmeldeinformationen.

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

Installieren und konfigurieren Sie Nginx

Installieren Sie Nginx.

sudo apt install -y nginx

Überprüfe die Version.

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

Führen Sie sudo vim /etc/nginx/sites-available/monica.confNginx für Monica aus und konfigurieren Sie es.

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;
    }
}

Speichern Sie die Datei und beenden Sie sie.

Aktivieren Sie die neue monica.confKonfiguration, indem Sie die Datei mit dem sites-enabledVerzeichnis verknüpfen .

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

Testen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo systemctl reload nginx.service

Installieren Sie Node.js und NPM

Installieren Sie Node.js.

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

Überprüfen Sie die Versionen Node.js und npm.

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

Installieren Sie Composer

Installieren Sie 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

Überprüfe die Version.

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

Installieren und konfigurieren Sie Monica

Erstellen Sie einen leeren Dokumentstammordner, in dem Monica installiert werden soll.

sudo mkdir -p /var/www/monica

Navigieren Sie zum Dokumentstammordner.

cd /var/www/monica

Ändern Sie den Besitz des /var/www/monicaOrdners in Benutzer johndoe.

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

Klonen Sie das Monica-Repository darauf.

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

HINWEIS : Suchen Sie die neueste offizielle Version auf der Release- Seite von GitHub und aktualisieren Sie die obige Versionsnummer auf die neueste Version.

Führen Sie die folgenden Schritte aus, um eine eigene Version der für das Projekt erforderlichen Umgebungsvariablen zu erstellen.

cp .env.example .env

Aktualisieren Sie die .envDatei auf Ihre spezifischen Anforderungen. Vergessen Sie nicht, Satz DB_USERNAMEund DB_PASSWORDmit den Einstellungen vorher verwendeten.

Installieren Sie alle Pakete.

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

Installieren Sie alle Front-End-Abhängigkeiten und -Tools, die zum Kompilieren von Assets erforderlich sind.

npm install yarn
npm install

Kompilieren Sie die JS- und CSS-Assets.

npm run production

Generieren Sie einen Anwendungsschlüssel. Dies wird APP_KEYautomatisch auf den richtigen Wert eingestellt.

php artisan key:generate

Führen Sie die Migrationen aus und legen Sie die Datenbank- und Symlink-Ordner fest.

php artisan setup:production

Ändern Sie den Besitz des /var/www/monicaVerzeichnisses in www-data.

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

Mögliches Problem: Die vue-directive-tooltipVerzeichnisstruktur des NPM-Pakets wurde geändert, die monicahqKonfiguration hat sie jedoch noch nicht geändert (Stand 09/2019). Um dies zu beheben, muss die folgende Zeile /var/www/monica/resources/assets/js/app.jsgeändert werden von:

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

Die Installation ist abgeschlossen. Öffnen Sie Ihre Domain in Ihrem Webbrowser und befolgen Sie die Anweisungen auf dem Bildschirm.