Hvordan installere Monica på FreeBSD 12

• Krav
• Før du begynner
• Installer PHP
• Installer MariaDB og sett opp en database
• Installer og konfigurer Nginx
• Installer Composer
• Installer og konfigurer Monica

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

• FreeBSD 12-system
• Git
• PHP versjon 7.2 eller nyere med følgende PHP-utvidelser:
  • json
  • iconv
  • intl
  • opcache
  • mbstring
  • xml
  • mysqli
  • pdo_mysql
  • bcmath
  • krølle
  • gmp
  • glidelås
  • gd
• MariaDB
• Nginx
• Komponist

Før du begynner

Sjekk FreeBSD-versjonen.

uname -ro # FreeBSD 12.0-RELEASE

Sørg for at ditt FreeBSD-system er oppdatert.

freebsd-update fetch install pkg update && pkg upgrade -y

Installer de nødvendige pakkene.

pkg install -y sudo vim unzip curl wget bash socat git libpng-dev

Opprett en ny brukerkonto med ditt foretrukne brukernavn. Vi vil bruke johndoe.

adduser # Username: johndoe # Full name: John Doe # Uid (Leave empty for default): <Enter> # Login group [johndoe]: <Enter> # Login group is johndoe. Invite johndoe into other groups? []: wheel # Login class [default]: <Enter> # Shell (sh csh tcsh nologin) [sh]: bash # Home directory [/home/johndoe]: <Enter> # Home directory permissions (Leave empty for default): <Enter> # Use password-based authentication? [yes]: <Enter> # Use an empty password? (yes/no) [no]: <Enter> # Use a random password? (yes/no) [no]: <Enter> # Enter password: your_secure_password # Enter password again: your_secure_password # Lock out the account after creation? [no]: <Enter> # OK? (yes/no): yes # Add another user? (yes/no): no # Goodbye!

Kjør visudokommandoen og fjern kommentarfeltet for %wheel ALL=(ALL) ALLå la medlemmer av wheelgruppen utføre en hvilken som helst kommando.

visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL

Bytt nå til den nyopprettede brukeren med su.

su - johndoe

MERK: Erstatt johndoemed brukernavnet ditt.

Sett opp tidssonen.

sudo tzsetup

Installer PHP

Installer PHP, samt nødvendige PHP-utvidelser.

sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-pecl-imagick php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-phar php72-soap php72-xmlrpc php72-opcache php72-mysqli php72-bcmath php72-gmp

Sjekk versjonen.

php --version # PHP 7.2.19 (cli) (built: Jun 20 2019 01:25:01) ( NTS ) # Copyright (c) 1997-2018 The PHP Group # Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

Myklink php.ini-productiontil php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Aktiver og start PHP-FPM.

sudo sysrc php_fpm_enable=yes sudo service php-fpm start

Installer MariaDB og sett opp en database

Installer MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Sjekk versjonen.

mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1

Start og aktiver MariaDB.

sudo sysrc mysql_enable="yes" sudo service mysql-server start

Kjør mysql_secure_installationskriptet for å forbedre sikkerheten til installasjonen.

sudo mysql_secure_installation

Logg inn på MariaDB som root-bruker.

mysql -u root -p # Enter password:

Opprett en ny database og bruker. Husk legitimasjonen for denne nye brukeren.

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

Installer og konfigurer Nginx

Installer Nginx.

sudo pkg install -y nginx

Sjekk versjonen.

nginx -v # nginx version: nginx/1.14.2

Aktiver og start Nginx.

sudo sysrc nginx_enable=yes sudo service nginx start

Kjør sudo vim /usr/local/etc/nginx/monica.confog sett opp Nginx for Monica.

server { listen 80; listen [::]:80; server_name example.com; root /usr/local/www/monica/public; index index.php; location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { try_files $uri =404; include fastcgi_params; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass 127.0.0.1:9000; } }

Lagre filen og avslutt.

Nå må vi inkludere monica.confi hovedfilen nginx.conf.

Kjør sudo vim /usr/local/etc/nginx/nginx.confog legg til følgende linje i http {}blokken.

include monica.conf;

Test konfigurasjonen.

sudo nginx -t

Last inn Nginx på nytt.

sudo service nginx reload

Installer Composer

Installer Composer globalt.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r "if (hash_file('SHA384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { 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.8.6 2019-06-11 15:03:05

Installer og konfigurer Monica

Opprett en tom dokumentrotmappe der Monica skal installeres.

sudo mkdir -p /usr/local/www/monica

Naviger til dokumentrotmappen.

cd /usr/local/www/monica

Endre eierskap av /usr/local/www/monicamappe til bruker johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/monica

Klon Monica-depotet til det.

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

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

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 -v

Endre eierskap av /usr/local/www/monicakatalogen til www.

sudo chown -R www:www /usr/local/www/monica

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