So installieren Sie InvoicePlane unter FreeBSD 12

• Bedarf
• Bevor Sie beginnen
• Installieren Sie PHP und die erforderlichen PHP-Erweiterungen
• Installieren Sie MariaDB
• Installieren Sie Nginx
• Installieren Sie InvoicePlane

InvoicePlane ist eine kostenlose Open-Source-Rechnungsanwendung. Der Quellcode befindet sich in diesem Github-Repository . In diesem Handbuch erfahren Sie, wie Sie InvoicePlane auf einer neuen FreeBSD 12 Vultr-Instanz installieren.

Bedarf

• Nginx
• MySQL Version 5.5 oder höher oder MariaDB-Äquivalent
• PHP Version 7.0 oder höher
• Die folgenden PHP-Erweiterungen müssen installiert und aktiviert sein:
  • php-gd
  • php-hash
  • php-json
  • php-mbstring
  • php-mcrypt
  • php-mysqli
  • php-openssl
  • php-recode
  • php-xmlrpc
  • php-zlib

Bevor Sie beginnen

Überprüfen Sie die FreeBSD-Version.

uname -ro
# FreeBSD 12.0-RELEASE

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

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

Installieren Sie die erforderlichen Pakete.

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

Erstellen Sie ein neues Benutzerkonto mit Ihrem bevorzugten Benutzernamen. Wir werden verwenden 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!

Führen Sie den visudoBefehl aus und kommentieren Sie die %wheel ALL=(ALL) ALLZeile aus, damit Mitglieder der wheelGruppe einen beliebigen Befehl ausführen können.

visudo

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

Wechseln Sie nun mit zu Ihrem neu erstellten Benutzer su.

su - johndoe

HINWEIS: Ersetzen Sie johndoedurch Ihren Benutzernamen.

Richten Sie die Zeitzone ein.

sudo tzsetup

Installieren Sie PHP und die erforderlichen PHP-Erweiterungen

Installieren Sie PHP sowie die erforderlichen PHP-Erweiterungen.

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

Überprüfe die Version.

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

Softlink php.ini-productionzu php.ini.

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

Aktivieren und starten Sie PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Installieren Sie MariaDB

Installieren Sie MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Überprüfe die Version.

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

Starten und aktivieren Sie MariaDB.

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

Führen Sie das mysql_secure_installationSkript aus, um die Sicherheit Ihrer MariaDB-Installation zu verbessern.

sudo mysql_secure_installation

Melden Sie sich bei MariaDB als Root an.

mysql -u root -p
# Enter password:

Erstellen Sie eine neue MariaDB-Datenbank und einen neuen Benutzer. Merken Sie sich die Anmeldeinformationen für diesen neuen Benutzer.

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

Installieren Sie Nginx

Installieren Sie Nginx.

sudo pkg install -y nginx

Überprüfe die Version.

nginx -v
# nginx version: nginx/1.16.0

Aktivieren und starten Sie Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Führen Sie sudo vim /usr/local/etc/nginx/invoiceplane.confNginx für InvoicePlane aus und richten Sie es ein.

server {
  listen 80;
  listen [::]:80;

  server_name example.com;

  root /usr/local/www/invoiceplane;

  index index.php index.html;

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }

  location ~ \.php$ {
    fastcgi_index index.php;
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass 127.0.0.1:9000;
  }
}

Speichern Sie die Datei und beenden Sie sie.

Jetzt müssen wir invoiceplane.confin die Hauptdatei aufnehmen nginx.conf.

Führen sudo vim /usr/local/etc/nginx/nginx.confSie die folgende Zeile aus und fügen Sie sie dem http {}Block hinzu.

include invoiceplane.conf;

Testen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo service nginx reload

Installieren Sie InvoicePlane

Laden Sie die neueste stabile Version von InvoicePlane herunter und extrahieren Sie das Archiv.

cd /usr/local/www/
sudo curl -O -J -L https://invoiceplane.com/download/v1.5.9
sudo unzip v1.5.9.zip
sudo rm v1.5.9.zip
sudo mv ip invoiceplane

Navigieren Sie zum /usr/local/www/invoiceplaneOrdner.

cd /usr/local/www/invoiceplane

Erstellen Sie eine Kopie der ipconfig.php.exampleDatei und benennen Sie die Kopie um ipconfig.php.

sudo cp ipconfig.php.example ipconfig.php

Öffnen Sie die ipconfig.phpDatei und fügen Sie Ihre URL hinzu.

sudo vim ipconfig.php
# Something like this
IP_URL=http://example.com

HINWEIS: Vergessen Sie nicht, die http://example.comURL durch Ihre eigene URL zu ersetzen .

Ändern Sie den Besitz des /usr/local/www/invoiceplaneVerzeichnisses in www.

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

Führen Sie das InvoicePlane-Installationsprogramm in Ihrem Webbrowser aus und befolgen Sie die Anweisungen.

http://your-domain.com/index.php/setup

Nach Abschluss der Installation können Sie sich mit der E-Mail-Adresse und dem Kennwort, die Sie während der Installation ausgewählt haben, bei InvoicePlane anmelden.

Wenn Sie Ihre Installation sichern möchten, können Sie das Setup deaktivieren. Dazu ersetzen Sie die Zeile DISABLE_SETUP=falsemit DISABLE_SETUP=truein Ihrer ipconfig.phpDatei.