Installation · 5 min read · Dec 09, 2025

So installieren Sie InvoicePlane mit Nginx auf FreeBSD 12

InvoicePlane ist eine kostenlose und Open-Source-Rechnungsanwendung. Dieses Tutorial zeigt Ihnen, wie Sie InvoicePlane auf einem FreeBSD 12-System installieren.

Anforderungen

  • WebServer (Apache, NGINX). Dieses Tutorial verwendet Nginx.
  • MySQL Version 5.5 oder höher oder die entsprechende Version von MariaDB.
  • PHP Version 7.0, 7.1 oder 7.2 mit den folgenden installierten und aktivierten PHP-Erweiterungen:
    • php-gd
    • php-hash
    • php-json
    • php-mbstring
    • php-mcrypt
    • php-mysqli
    • php-openssl
    • php-recode
    • php-xmlrpc
    • php-zlib

Voraussetzungen

  • Ein Server, der FreeBSD 12 ausführt.
  • Ein Nicht-Root-Benutzer mit Sudo-Rechten.

Erste Schritte

Überprüfen Sie Ihre FreeBSD-Version:

uname -ro  
# FreeBSD 12.1-RELEASE

Richten Sie die Zeitzone ein:

tzsetup

Aktualisieren Sie Ihre Betriebssystempakete (Software). Dies ist ein wichtiger erster Schritt, da er sicherstellt, dass Sie die neuesten Updates und Sicherheitsfixes für die Standardsoftwarepakete Ihres Betriebssystems haben:

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

Installieren Sie einige wichtige Pakete, die für die grundlegende Verwaltung des FreeBSD 12.0-Betriebssystems erforderlich sind:

pkg install -y sudo vim unzip wget bash

Schritt 1 - PHP und erforderliche PHP-Erweiterungen installieren

Die InvoicePlane-Webanwendung benötigt PHP Version 7.0 oder höher.

Installieren Sie PHP sowie die erforderlichen PHP-Erweiterungen:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-mysqli php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Überprüfen Sie die PHP-Version:

php --version  
  
# PHP 7.2.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies

Aktivieren und starten Sie den PHP-FPM-Dienst:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Schritt 2 - MySQL installieren

Installieren Sie den MySQL-Datenbankserver:

sudo pkg install -y mysql57-server

Überprüfen Sie die MySQL-Version:

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using  EditLine wrapper

Aktivieren und starten Sie den MySQL-Dienst:

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

Führen Sie das Skript mysql_secure_installation aus, um die MySQL-Sicherheit zu verbessern und das Passwort für den MySQL root-Benutzer festzulegen:

sudo mysql_secure_installation

Beantworten Sie jede der Fragen:

Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y

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

sudo mysql -u root -p  
# Passwort eingeben

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

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

Verlassen Sie MySQL:

exit

Ersetzen Sie dbname, username und password durch Ihre eigenen Namen.

Schritt 3 - acme.sh-Client installieren und Let’s Encrypt-Zertifikat erhalten (optional)

Die Sicherung Ihrer Website mit HTTPS ist nicht notwendig, aber es ist eine gute Praxis, den Datenverkehr Ihrer Website abzusichern. Um ein TLS-Zertifikat von Let’s Encrypt zu erhalten, verwenden wir den Acme.sh-Client. Acme.sh ist eine reine UNIX-Shell-Software zum Abrufen von TLS-Zertifikaten von Let’s Encrypt mit null Abhängigkeiten. 

Laden Sie Acme.sh herunter und installieren Sie es:

sudo pkg install -y acme.sh

Überprüfen Sie die Acme.sh-Version:

acme.sh --version  
# v2.8.2

Erhalten Sie RSA- und ECC/ECDSA-Zertifikate für Ihre Domain/Hostname:

# RSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Nachdem Sie die obigen Befehle ausgeführt haben, befinden sich Ihre Zertifikate und Schlüssel in:

  • Für RSA: Verzeichnis /etc/letsencrypt/example.com.
  • Für ECC/ECDSA: Verzeichnis /etc/letsencrypt/example.com_ecc.

Schritt 3 - NGINX installieren

Installieren Sie den NGINX-Webserver:

sudo pkg install -y nginx

Überprüfen Sie die NGINX-Version:

nginx -v  
# nginx version: nginx/1.14.2

Starten und aktivieren Sie den NGINX-Dienst:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Konfigurieren Sie Nginx für InvoicePlane, indem Sie Folgendes ausführen:

sudo vim /usr/local/etc/nginx/invoiceplane.conf

Und fügen Sie die folgende Konfiguration in die Datei 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_pass 127.0.0.1:9000;  
      include fastcgi_params;  
      fastcgi_index index.php5;  
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    }
}

Testen Sie die NGINX-Konfiguration:

sudo nginx -t

Laden Sie NGINX neu:

sudo service nginx restart

Schritt 4 - InvoicePlane installieren

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

sudo mkdir -p /usr/local/www  
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 Verzeichnis /var/www/invoiceplane:

cd /usr/local/www/invoiceplane

Machen Sie eine Kopie der Datei ipconfig.php.example und benennen Sie die Kopie in ipconfig.php um:

sudo cp ipconfig.php.example ipconfig.php

Öffnen Sie die Datei ipconfig.php und fügen Sie Ihre URL hinzu:

sudo vim ipconfig.php  
# Etwas wie dies  
IP_URL=http://example.com

Ändern Sie den Eigentümer des Verzeichnisses /usr/local/www/invoiceplane in www:

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

Führen Sie sudo vim /etc/php.ini aus und setzen Sie date.timezone:

date.timezone = Region/Stadt

Starten Sie den PHP-FPM-Dienst neu:

sudo service php-fpm restart

Führen Sie den InvoicePlane-Installer über Ihren Webbrowser aus und folgen Sie den Anweisungen:

http://example.com/index.php/setup

Sobald die Installation abgeschlossen ist, können Sie sich mit der E-Mail-Adresse und dem Passwort, die Sie während der Installation gewählt haben, bei InvoicePlane anmelden.

Wenn Sie Ihre Installation sichern möchten, können Sie das Setup deaktivieren. Ersetzen Sie dazu die Zeile DISABLE_SETUP=false durch DISABLE_SETUP=true in Ihrer Datei ipconfig.php.

Schritt 5 - Abschluss der InvoicePlane-Einrichtung

InvoicePlane ist jetzt installiert und konfiguriert, es ist Zeit, auf den Webinstallationsassistenten zuzugreifen.

Öffnen Sie Ihren Webbrowser und geben Sie die URL http://example.com ein. Sie werden auf die folgende Seite weitergeleitet:

InvoicePlane-Webinstaller

Klicken Sie nun auf die Schaltfläche Setup. Sie sollten die folgende Seite sehen:

Sprache wählen

Wählen Sie als Nächstes die Sprache aus und klicken Sie auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Überprüfen der Systemanforderungen

Klicken Sie als Nächstes auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Datenbankdetails

Geben Sie hier Ihre Datenbankdetails ein und klicken Sie auf die Schaltfläche Erneut versuchen. Sie sollten die folgende Seite sehen:

Datenbankverbindung erfolgreich

Klicken Sie nun auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Benutzerkonto erstellen

Klicken Sie nun auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Installation von InvoicePlane abgeschlossen

Geben Sie nun alle erforderlichen Details ein und klicken Sie auf die Schaltfläche Weiter. Sobald die Installation abgeschlossen ist, sollten Sie die folgende Seite sehen:

Anmelden bei InvoicePlane

Klicken Sie nun auf die Schaltfläche Anmelden, um auf die Verwaltung von InvoicePlane zuzugreifen.

Links

Share: X/Twitter LinkedIn
#Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.