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
- Debian 9.x (Stretch)
- Git
- NPM (Node Package Manager)
- PHP 7.1+ oder neuer
- MySQL
- Nginx
- Komponist
Überprüfen Sie die Debian-Version.
lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)
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 die build-essential, curl, git, apt-transport-https, libpng-devPakete.
sudo apt install -y build-essential curl git apt-transport-https libpng-dev
Installieren Sie PHP
Fügen Sie das Repository für neuere Versionen von PHP hinzu.
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update
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 php7.2-bcmath php7.2-gd
Überprüfe die Version.
php --version
# PHP 7.2.5-1+0~20180505045740.21+stretch~1.gbpca2fa6 (cli) (built: May 5 2018 04:57:44) ( 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-1+0~20180505045740.21+stretch~1.gbpca2fa6, Copyright (c) 1999-2018, by Zend Technologies
Installieren Sie MySQL und richten Sie die Datenbank ein
Installieren Sie MySQL.
cd /tmp
wget https://dev.mysql.com/get/mysql-apt-config_0.8.10-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.10-1_all.deb
rm mysql-apt-config_0.8.10-1_all.deb
sudo apt update
sudo apt install -y mysql-server
Überprüfe die Version.
mysql --version
# mysql Ver 8.0.11 for Linux on x86_64 (MySQL Community Server - GPL)
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;
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON dbname.* TO username@localhost;
FLUSH PRIVILEGES;
EXIT;
Installieren Sie Nginx.
sudo apt install -y nginx
Überprüfe die Version.
sudo nginx -v
# nginx version: nginx/1.10.3
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
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 oben genannte Versionsnummer auf die neueste Version.
Erstellen Sie Ihre eigene Datei mit den von Monica benötigten Umgebungsvariablen.
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
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
Die Installation ist abgeschlossen. Öffnen Sie Ihre Domain in Ihrem Webbrowser und befolgen Sie die Anweisungen auf dem Bildschirm.