Hvernig á að setja upp Monica á FreeBSD 12

• Kröfur
• Áður en þú byrjar
• Settu upp PHP
• Settu upp MariaDB og settu upp gagnagrunn
• Settu upp og stilltu Nginx
• Settu upp Composer
• Settu upp og stilltu Monica

Monica er opinn uppspretta persónuleg tengslastjórnunarkerfi. Hugsaðu um það sem CRM (vinsælt tól notað af söluteymum í fyrirtækjaheiminum) fyrir vini þína eða fjölskyldu. Frumkóði hans er hýst opinberlega á GitHub . Í þessari handbók munum við fara yfir uppsetningarferlið Monica forrits.

Kröfur

• FreeBSD 12 kerfi
• Git
• PHP útgáfa 7.2 eða nýrri með eftirfarandi PHP viðbótum:
  • json
  • táknv
  • alþj
  • opcache
  • mbstring
  • xml
  • mysqli
  • pdo_mysql
  • bcmath
  • krulla
  • gmp
  • zip
  • gd
• MariaDB
• Nginx
• Tónskáld

Áður en þú byrjar

Athugaðu FreeBSD útgáfuna.

uname -ro # FreeBSD 12.0-RELEASE

Gakktu úr skugga um að FreeBSD kerfið þitt sé uppfært.

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

Settu upp nauðsynlega pakka.

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

Búðu til nýjan notandareikning með valinn notandanafni þínu. Við munum nota 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!

Keyrðu visudoskipunina og afskrifaðu %wheel ALL=(ALL) ALLlínuna til að leyfa meðlimum wheelhópsins að framkvæma hvaða skipun sem er.

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

Nú skaltu skipta yfir í nýstofnaðan notanda með su.

su - johndoe

ATH: Skiptu út johndoefyrir notendanafnið þitt.

Settu upp tímabeltið.

sudo tzsetup

Settu upp PHP

Settu upp PHP, sem og nauðsynlegar PHP viðbætur.

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

Athugaðu útgáfuna.

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

Mjúkur hlekkur php.ini-productioná php.ini.

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

Virkjaðu og ræstu PHP-FPM.

sudo sysrc php_fpm_enable=yes sudo service php-fpm start

Settu upp MariaDB og settu upp gagnagrunn

Settu upp MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Athugaðu útgáfuna.

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

Ræstu og virkjaðu MariaDB.

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

Keyrðu mysql_secure_installationhandritið til að bæta öryggi uppsetningar þinnar.

sudo mysql_secure_installation

Skráðu þig inn á MariaDB sem rót notandi.

mysql -u root -p # Enter password:

Búðu til nýjan gagnagrunn og notanda. Mundu skilríki fyrir þennan nýja notanda.

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

Settu upp og stilltu Nginx

Settu upp Nginx.

sudo pkg install -y nginx

Athugaðu útgáfuna.

nginx -v # nginx version: nginx/1.14.2

Virkjaðu og ræstu Nginx.

sudo sysrc nginx_enable=yes sudo service nginx start

Keyra sudo vim /usr/local/etc/nginx/monica.confog setja upp Nginx fyrir 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; } }

Vistaðu skrána og hættu.

Nú þurfum við að hafa monica.confí nginx.confaðalskránni.

Hlaupa sudo vim /usr/local/etc/nginx/nginx.confog bæta eftirfarandi línu við http {}blokkina.

include monica.conf;

Prófaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo service nginx reload

Settu upp Composer

Settu upp Composer á heimsvísu.

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

Athugaðu útgáfuna.

composer --version # Composer version 1.8.6 2019-06-11 15:03:05

Settu upp og stilltu Monica

Búðu til tóma skjalrótarmöppu þar sem Monica ætti að vera uppsett.

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

Farðu í rótarmöppuna skjalsins.

cd /usr/local/www/monica

Breyttu eignarhaldi á /usr/local/www/monicamöppu í notanda johndoe.

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

Klónaðu Monica geymsluna við það.

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

ATH: Finndu nýjustu opinberu útgáfuna á útgáfusíðunni á GitHub og uppfærðu útgáfunúmerið hér að ofan í nýjustu útgáfuna.

Keyrðu eftirfarandi til að búa til þína eigin útgáfu af umhverfisbreytunum sem þarf fyrir verkefnið.

cp .env.example .env

Uppfærðu .envskrána að sérstökum þörfum þínum. Ekki gleyma að stilla DB_USERNAMEog DB_PASSWORDmeð stillingunum sem notaðar voru áður.

Settu upp alla pakkana.

composer install --no-interaction --no-suggest --no-dev

Búðu til forritalykil. Þetta mun APP_KEYsjálfkrafa stilla á rétt gildi.

php artisan key:generate

Keyrðu flutningana og sáðu gagnagrunninn og samtengingarmöppurnar.

php artisan setup:production -v

Breyttu eignarhaldi /usr/local/www/monicamöppunnar í www.

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

Uppsetningunni er lokið. Opnaðu lénið þitt í vafranum þínum og fylgdu leiðbeiningunum sem sýndar eru á skjánum.