So installieren Sie SolidInvoice auf Ubuntu 22.04

SolidInvoice ist eine kostenlose, einfache und elegante Rechnungsstellungslösung, die auf PHP basiert. Sie wurde für kleine Unternehmen entwickelt, um ihre täglichen Abrechnungsoperationen zu verwalten. SolidInvoice bietet eine RESTful API für die Integration und verschiedene Benachrichtigungskanäle wie Textnachrichten, E-Mails oder HipChat.

Dieser Leitfaden zeigt Ihnen, wie Sie SolidInvoice auf einem Ubuntu 22.04-Server installieren. Sie richten SolidInvoice mit dem LAMP-Stack ein und sichern die Installation mit Certbot und letsencrypt.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

• Einen Ubuntu 22.04-Server.
• Einen Nicht-Root-Benutzer mit Sudo-Rechten.
• Einen Domainnamen, der auf eine Server-IP-Adresse zeigt.

Abhängigkeiten installieren

SolidInvoice ist eine Open-Source-Rechnungsanwendung, die in PHP und MySQL geschrieben ist. Um es zu installieren, müssen Sie den LAMP-Stack auf Ihrem Ubuntu-System installieren. In diesem ersten Schritt installieren Sie den LAMP-Stack aus dem Standard-Ubuntu-Repository.

Aktualisieren Sie Ihren Ubuntu-Paketindex mit dem folgenden Befehl.

sudo apt update

Installieren Sie nun die Abhängigkeiten des LAMP-Stacks (Linux, Apache, MySQL/MariaDB und PHP) mit dem folgenden Befehl. In diesem Beispiel verwenden Sie die Standard-PHP-Version 8.x für die Installation von SolidInvoice.

sudo apt install apache2 mariadb-server mariadb-client php php-curl php-common php-mbstring php-json php-mysql php-opcache php-bcmath php-intl php-gd php-xml php-soap php-zip php-apcu

Geben Sie Y ein, um die Installation zu bestätigen.

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um den Status der Apache- und MariaDB-Dienste zu überprüfen, um sicherzustellen, dass beide Dienste laufen.

sudo systemctl status apache2  
sudo systemctl status mysql

Wenn Apache oder MariaDB läuft, sehen Sie eine Ausgabe active(running).

Überprüfen Sie zuletzt die PHP-Version mit dem folgenden Befehl. Sie sollten PHP 8.x auf Ihrem Ubuntu-System installiert sehen.

php -v

MariaDB-Server einrichten

Nachdem Sie den LAMP-Stack installiert haben, müssen Sie Ihre MariaDB-Serverinstallation einrichten. Zuerst sichern Sie den MariaDB-Server, dann erstellen Sie eine neue Datenbank und einen Benutzer, die SolidInvoice verwenden wird.

Um die MariaDB-Serverinstallation zu sichern, geben Sie Folgendes ein:

sudo mariadb-secure-installation

Im Verlauf geben Sie Y ein, um die Änderungen an der MariaDB zu bestätigen, oder N, um sie abzulehnen. Im Folgenden sind die MariaDB-Serverkonfigurationen aufgeführt, nach denen Sie gefragt werden:

• Die Standardinstallation von MariaDB kommt ohne Passwort, drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
• Geben Sie nun Y ein, um das MariaDB-Root-Passwort einzurichten. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
• Geben Sie Y ein, um den anonymen Benutzer von Ihrer MariaDB-Installation zu entfernen.
• Geben Sie erneut Y ein, wenn Sie gefragt werden, um den Remote-Login für den MariaDB-Root-Benutzer zu deaktivieren.
• Geben Sie Y ein, um die Standarddatenbank test von Ihrer MariaDB zu entfernen.
• Geben Sie zuletzt Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Jetzt, da Sie MariaDB gesichert haben, geben Sie Folgendes ein, um sich als Standard-Root-Benutzer bei MariaDB anzumelden. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Sobald Sie angemeldet sind, führen Sie die folgenden Abfragen aus, um eine neue Datenbank solidinvoicedb, einen Benutzer solidinvoice mit dem Passwort p4ssword zu erstellen. Stellen Sie sicher, dass Sie die Details mit Ihren Informationen ändern; diese Datenbankdetails werden von SolidInvoice verwendet.

CREATE DATABASE solidinvoicedb;  
CREATE USER solidinvoice@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON solidinvoicedb.* TO solidinvoice@localhost;  
FLUSH PRIVILEGES;

Führen Sie nun die folgende Abfrage aus, um die Berechtigungen für den Benutzer solidinvoice zu überprüfen. Stellen Sie sicher, dass der Benutzer solidinvoice auf die Datenbank solidinvoicedb zugreifen kann.

SHOW GRANTS FOR solidinvoice@localhost;

Geben Sie zuletzt quit ein, um die MariaDB-Server zu verlassen.

PHP einrichten

Nachdem der MariaDB-Server gesichert und konfiguriert ist, richten Sie Ihre PHP-Installation ein. In diesem Fall müssen Sie die Standard-PHP-Konfigurationsdatei php.ini ändern.

Öffnen Sie die Standard-PHP-Konfiguration /etc/php/8.1/apache2/php.ini mit dem Nano-Editor.

sudo nano /etc/php/8.1/apache2/php.ini

Ändern Sie die Standard-PHP-Konfigurationen wie folgt und stellen Sie sicher, dass Sie memory_limit und date.timezone an Ihre Serverumgebung anpassen.

date.timezone = Europe/Amsterdam  
memory_limit=512M  
upload_max_filesize=64M  
post_max_size=120M  
max_execution_time=120

Speichern Sie die Datei und beenden Sie den Editor.

Starten Sie nun den Apache-Dienst neu, um Ihre Änderungen an PHP mit dem folgenden Befehl anzuwenden.

sudo systemctl restart apache2

SolidInvoice herunterladen

Jetzt, da Sie MariaDB und PHP konfiguriert haben, können Sie den Quellcode von SolidInvoice herunterladen und die Installation mit den richtigen Berechtigungen und Eigentümern einrichten.

Gehen Sie in das Verzeichnis /var/www und laden Sie den Quellcode von SolidInvoice mit wget herunter. Überprüfen Sie die SolidInvoice-Release-Seite, um die neueste Version zu erhalten.

cd /var/www/  
wget https://github.com/SolidInvoice/SolidInvoice/releases/download/2.2.5/SolidInvoice-2.2.5.zip

Extrahieren Sie den Quellcode von SolidInvoice in das Verzeichnis solidinvoice und ändern Sie den Eigentümer in den www-data-Benutzer. Das DocumentRoot oder Web-root-Verzeichnis für die SolidInvoice-Installation wird /var/www/solidinvoice sein.

unzip SolidInvoice-2.2.5.zip -d solidinvoice  
sudo chown -R www-data:www-data /var/www/solidinvoice

Führen Sie nun den folgenden Befehl aus, um sicherzustellen, dass der www-data-Benutzer in einige der Verzeichnisse und Dateien von SolidInvoice schreiben kann.

sudo chmod u+rw /var/www/solidinvoice/app/cache  
sudo chmod u+rw /var/www/solidinvoice/app/logs  
sudo chmod u+rw /var/www/solidinvoice/var/cache  
sudo chmod u+rw /var/www/solidinvoice/var/logs

sudo chmod u+rw /var/www/solidinvoice/web/upload  
sudo chmod u+rw /var/www/solidinvoice/app/config/parameters.yml

Apache-virtuellen Host einrichten

Nachdem Sie das DocumentRoot-Verzeichnis für SolidInvoice konfiguriert haben, müssen Sie einen neuen Apache-virtuellen Host erstellen, der für die Ausführung der Installation verwendet wird. Stellen Sie sicher, dass Sie Ihren Domainnamen für SolidInvoice vorbereitet haben.

Zuerst führen Sie den folgenden Befehl aus, um das rewrite-Modul in Apache zu aktivieren.

sudo a2enmod rewrite

Erstellen Sie eine neue Apache-virtuelle Hostkonfiguration /etc/apache2/sites-available/solidinvoice.conf mit dem folgenden Nano-Editor-Befehl.

sudo nano /etc/apache2/sites-available/solidinvoice.conf

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die ServerName-Option mit Ihrer Ziel-Domain ändern.

  
 ServerName invoice.howtoforge.local  
 ServerAlias www.invoice.howtoforge.local  
  
 DocumentRoot /var/www/solidinvoice/public  
   
 # .htaccess-Rewrites aktivieren  
 AllowOverride All  
 Order allow,deny  
 Allow from All  
   
  
 ErrorLog /var/log/apache2/solidinvoice.error.log  
 CustomLog /var/log/apache2/solidinvoice.access.log combined  

Speichern Sie die Datei und beenden Sie den Editor.

Geben Sie nun den folgenden Befehl ein, um die virtuelle Hostdatei solidinvoice.conf zu aktivieren und Ihre Apache-Syntax zu überprüfen. Wenn Sie eine korrekte Syntax haben, sehen Sie eine Ausgabe ‘ Syntax OK ‘.

sudo a2ensite solidinvoice.conf  
sudo apachectl configtest

Geben Sie zuletzt den folgenden Befehl ein, um Apache neu zu starten und die neue virtuelle Hostdatei solidinvoice.conf anzuwenden. Nach der Ausführung sollte Ihre SolidInvoice laufen.

sudo systemctl restart apache2

SolidInvoice mit HTTPS sichern

In diesem Beispiel sichern Sie SolidInvoice mit SSL/TLS-Zertifikaten über Certbot und letsencrypt. Jetzt installieren Sie Certbot und generieren SSL/TLS-Zertifikate für Ihren SolidInvoice-Domainnamen.

Zuerst installieren Sie Certbot und das Certbot-Apache-Plugin mit dem folgenden Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-apache

Sobald die Installation abgeschlossen ist, generieren Sie SSL/TLS-Zertifikate mit dem folgenden Certbot-Befehl. Stellen Sie sicher, dass Sie die Informationen des Domainnamens und die E-Mail-Adresse mit Ihren Details ändern.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Nachdem der Vorgang abgeschlossen ist, sollten Ihre SSL/TLS-Zertifikate im Verzeichnis /etc/letsencrypt/live/domain.com verfügbar sein. Außerdem sollte Ihre SolidInvoice-Installation automatisch mit HTTPS gesichert sein.

SolidInvoice installieren

Öffnen Sie Ihren Webbrowser und besuchen Sie Ihren Domainnamen, z. B. https://invoice.howtoforge.local/. Überprüfen Sie im System Requirements Check, ob alles in Ordnung ist, und klicken Sie dann auf Next, um zu bestätigen.

Wählen Sie den Datenbanktreiber MySQL aus und geben Sie die Details Ihrer MariaDB-Datenbank und des Benutzers für SolidInvoice ein. Klicken Sie, wenn Sie fertig sind, erneut auf Next.

Jetzt sehen Sie, dass das Datenbankschema für SolidInvoice erstellt wurde. Klicken Sie auf Next, um fortzufahren.

Für die Systemeinstellungen wählen Sie die Standardsprache Englisch aus und geben Sie die Details Ihres Administrators, E-Mail und Passwort ein. Klicken Sie dann erneut auf Next, um zu bestätigen.

Sobald die Installation abgeschlossen ist, sehen Sie die Ausgabe ‘ Sie haben SolidInvoice erfolgreich installiert! ‘ und zusätzliche Anweisungen zur Erstellung eines Cron-Jobs.

Gehen Sie zurück zum Serverterminal und erstellen Sie einen neuen Cron-Job für den Benutzer www-data mit dem folgenden Befehl.

sudo crontab -u www-data -e

Fügen Sie das Crontab-Skript von der Seite ein, speichern Sie die Datei und schließen Sie sie.

* * * * * php /var/www/solidinvoice/bin/console cron:run -e prod -n

Gehen Sie zurück zu Ihrem Webbrowser und klicken Sie auf Log In.

Jetzt werden Sie aufgefordert, Ihren Firmennamen und die Standardwährung zu erstellen. Klicken Sie auf Create, um zu bestätigen.

Wenn alles gut geht, sollten Sie das SolidInvoice-Dashboard wie folgt sehen.

Fazit

Herzlichen Glückwunsch! Sie haben SolidInvoice auf einem Ubuntu 22.04-Server installiert. Sie haben SolidInvoice mit dem LAMP-Stack (Apache, MySQL/MariaDB und PHP) auf Ubuntu zum Laufen gebracht und Ihre Installation mit HTTPS über Letsencrypt gesichert. Sie können jetzt neue Komponenten wie den SMTP-Server zu SolidInvoice hinzufügen und ihn verwenden.