Wie man SuiteCRM auf Debian 12 installiert

SuiteCRM ist eine kostenlose und Open-Source-CRM-Software (Customer Relationship Management), die in PHP geschrieben ist. Sie hilft Ihnen, die Marketing-, Vertriebs- und Kundenservice-Abteilungen Ihres Unternehmens zu organisieren und zu verwalten. SuiteCRM ist für fast jede Branche geeignet, wie z.B. Fertigung, öffentliche Sektoren, Technologie, Finanzen, Bildung usw.

In diesem Leitfaden führen wir Sie Schritt für Schritt durch die Installation von SuiteCRM auf dem Debian 12-Server. Sie werden SuiteCRM mit dem LAMP-Stack (Apache2, MariaDB und PHP) auf Ihrem Debian-Rechner installieren und ausführen. Außerdem sichern Sie SuiteCRM mit SSL/TLS-Zertifikaten von Letsencrypt.

Voraussetzungen

Die folgenden Anforderungen sind notwendig, um mit diesem Leitfaden fortzufahren:

Ein Debian 12-Server.
Ein Nicht-Root-Benutzer mit Administratorrechten.
Ein Domainname, der auf eine Server-IP-Adresse verweist.

Abhängigkeiten installieren

SuiteCRM ist eine in PHP geschriebene CRM-Software mit MySQL/MariaDB als Datenbank. In diesem Leitfaden werden Sie SuiteCRM mit dem LAMP-Stack (Apache2, MariaDB und PHP) ausführen, und jetzt werden Sie die LAMP-Stack-Pakete mit zusätzlichen PHP-Erweiterungen installieren.

Zuerst aktualisieren Sie Ihr Debian-Paket-Index über den folgenden Befehl apt update.

sudo apt update

update repo

Jetzt installieren Sie die LAMP-Stack-Pakete (Apache2, MariaDB und PHP) mit einigen PHP-Erweiterungen mit dem folgenden Befehl.

sudo apt install apache2 mariadb-server php php-cli php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-opcache php-soap php-imap php-ldap unzip

Geben Sie y ein, um mit der Installation fortzufahren.

install dependencies

Führen Sie als Nächstes den folgenden systemctl-Befehl aus, um den apache2-Dienst zu überprüfen. Dies stellt sicher, dass der apache2-Dienst aktiviert und läuft.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Die Ausgabe enabled bestätigt, dass apache2 aktiviert ist, und die Ausgabe active (running) bestätigt, dass apache2 läuft.

check apache2

Überprüfen Sie den mariadb-Dienst mit dem folgenden Befehl.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Ähnlich wie bei der apache2-Dienstausgabe sollten Sie sehen, dass der mariadb-Dienst aktiviert und läuft.

check mariadb

Überprüfen Sie zuletzt die PHP-Version und einige aktivierte Erweiterungen, indem Sie den folgenden Befehl ausführen.

php -v  
php -m

Die folgende Ausgabe zeigt Ihnen, dass PHP 8.2 installiert ist, mit einigen aktivierten Modulen wie curl, exif, fileinfo und gd.

check php

MariaDB-Server konfigurieren

Nachdem Sie die Abhängigkeiten installiert haben, sichern Sie Ihre MariaDB-Serverinstallation und erstellen eine neue Datenbank und einen Benutzer, die für SuiteCRM verwendet werden.

Führen Sie den Befehl mariadb-secure-installation unten aus, um Ihren MariaDB-Server zu sichern.

sudo mariadb-secure-installation

Während des Prozesses geben Sie Y ein, um die Konfiguration zu bestätigen, oder n für Nein und verweigern die Änderungen.

Wechseln Sie zur unix_socket-Authentifizierung?. Geben Sie n ein und drücken Sie ENTER. Der Standard-MariaDB-Root-Benutzer ist bereits geschützt. Optional können Sie es auch aktivieren, indem Sie y für ja eingeben.
Passwort für den Root-Benutzer ändern?. Geben Sie y ein, um zu bestätigen und Ihr neues MariaDB-Root-Passwort festzulegen.
Anonymen Benutzer entfernen?. Geben Sie y ein, um zu bestätigen.
Root-Login aus der Ferne verbieten? Geben Sie y ein, um zu bestätigen. Nur lokale Verbindungen sind erlaubt, wenn Sie den MariaDB-Root-Benutzer verwenden.
Testdatenbank und Zugriff darauf entfernen?. Geben Sie y ein, um zu bestätigen und die Standarddatenbank ‘test’ zu entfernen.
Geben Sie zuletzt erneut y ein, um alle Tabellenberechtigungen auf Ihrem MariaDB-Server neu zu laden und die neuen Änderungen anzuwenden.

Jetzt, da MariaDB gesichert ist, erstellen Sie eine neue Datenbank und einen Benutzer für SuiteCRM.

Melden Sie sich über den MariaDB-Client-Befehl unten am MariaDB-Server an. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie als Nächstes die folgenden Abfragen aus, um eine neue Datenbank suitecrmdb und den Benutzer suitecrm mit dem Passwort password zu erstellen. Stellen Sie sicher, dass Sie das Passwort durch Ihr eigenes Passwort ersetzen.

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

create database and user

Führen Sie jetzt die folgende Abfrage aus, um den Benutzer suitecrm zu überprüfen.

SHOW GRANTS FOR 'suitecrm'@'localhost';

In der folgenden Ausgabe sollten Sie sehen, dass der Benutzer suitecrm Zugriff auf die Datenbank suitecrmdb hat.

veridy database user

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

PHP konfigurieren

Jetzt, da der MariaDB-Server konfiguriert ist, besteht der nächste Schritt darin, Ihre PHP-Installation zu konfigurieren. SuiteCRM erfordert einige Änderungen an den PHP-Konfigurationen, wie z.B. benutzerdefiniertes error_reporting, Aktivierung des OPCache-Moduls sowie benutzerdefinierte upload_max_filesize und post_max_size.

Öffnen Sie die Standard-PHP-Konfiguration /etc/php/8.2/apache2/php.ini und /etc/php/8.2/cli/php.ini mit dem folgenden nano-Editor-Befehl.

sudo nano /etc/php/8.2/apache2/php.ini  
sudo nano /etc/php/8.2/cli/php.ini

Ändern Sie die Standardparameter einiger Konfigurationen mit den folgenden Zeilen. Stellen Sie sicher, dass Sie date.timezone mit Ihrer Serverzeitzone und memory_limit mit dem Serverspeicher anpassen.

date.timezone = Europe/Amsterdam  
  
max_execution_time = 60  
memory_limit = 256M  
  
upload_max_filesize = 25M  
post_max_size = 25M

Ändern Sie den Standardwert für error_reporting wie folgt:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

Kommentieren Sie den Parameter session.save_path aus, um den Standard-Speicherort für Sitzungen auf /var/lib/php/sessions zu konfigurieren.

session.save_path = "/var/lib/php/sessions"

Aktivieren Sie jetzt die OPCache-Erweiterung und passen Sie einige Einstellungen wie folgt an:

opcache.enable=1  
  
; Die Größe des gemeinsamen Speichers für OPcache.  
opcache.memory_consumption=256  
  
; Die maximale Anzahl von Schlüsseln (Skripten) in der OPcache-Hash-Tabelle.  
; Nur Zahlen zwischen 200 und 100000 sind erlaubt.  
opcache.max_accelerated_files=20000  
  
; Wenn deaktiviert, müssen Sie den OPcache manuell zurücksetzen oder den  
; Webserver neu starten, damit Änderungen am Dateisystem wirksam werden.  
opcache.validate_timestamps=0

Speichern und schließen Sie die Datei, wenn Sie fertig sind.

Führen Sie jetzt den folgenden systemctl-Befehl aus, um den apache2-Dienst neu zu starten und die Änderungen anzuwenden, die Sie vorgenommen haben.

sudo systemctl restart apache2

SuiteCRM herunterladen und installieren

An diesem Punkt ist der LAMP-Stack jetzt für SuiteCRM konfiguriert. Jetzt werden Sie den Quellcode von SuiteCRM herunterladen und über die Befehlszeile installieren.

Erstellen Sie ein neues Verzeichnis /var/www/suitecrm, das als Zielinstallation für SuiteCRM verwendet wird.

mkdir -p /var/www/suitecrm

Wechseln Sie in das Verzeichnis /var/www/suitecrm und laden Sie den Quellcode von SuiteCRM mit dem folgenden wget-Befehl herunter. Stellen Sie sicher, dass Sie die SuiteCRM-Download-Seite überprüfen, um die neueste Version des Quellcodes zu erhalten. Zu diesem Zeitpunkt ist SuiteCRM 8.4 die neueste Version.

cd /var/www/suitecrm  
wget https://suitecrm.com/download/142/suite84/562972/suitecrm-8-4-0.zip

Sobald der Download abgeschlossen ist, extrahieren Sie die Datei suitecrm-8-4-0.zip mit dem folgenden unzip-Befehl.

unzip suitecrm-8-4-0.zip

Führen Sie dann den folgenden Befehl aus, um die richtigen Berechtigungen und den Besitz des SuiteCRM-Quellcodes festzulegen.

find . -type d -not -perm 2755 -exec chmod 2755 {} \;  
find . -type f -not -perm 0644 -exec chmod 0644 {} \;  
find . ! -user www-data -exec chown www-data:www-data {} \;  
chmod +x bin/console

Führen Sie zuletzt die Binärdatei /var/www/suitecrm/bin/console aus, um SuiteCRM über die Befehlszeile zu installieren. Stellen Sie sicher, dass Sie die Details des Datenbanknamens, Benutzers, Hosts, Ziel-Domainnamens, Admin-Benutzers und Passworts ändern, die für Ihre SuiteCRM-Installation verwendet werden.

sudo -u www-data ./bin/console suitecrm:app:install -u "alice" -p "password" -U "suitecrm" -P "password" -H "127.0.0.1" -N "suitecrmdb" -S "http://suitecrm.howtoforge.local/"

Sobald die Installation abgeschlossen ist, wird die folgende Ausgabe in Ihrem Terminal angezeigt:

install suitcrm via cli

Apache2-Virtualhost für Suite konfigurieren

Im nächsten Schritt erstellen Sie eine neue Apache2-Virtualhost-Konfiguration, die zum Ausführen von SuiteCRM verwendet wird. Stellen Sie vor dem Fortfahren sicher, dass Sie einen Domainnamen haben, der auf Ihre Server-IP-Adresse verweist.

Führen Sie den a2enmod-Befehl unten aus, um die von SuiteCRM benötigten Apache2-Module zu aktivieren.

sudo a2enmod rewrite ssl header

Erstellen Sie dann eine neue Apache2-Virtualhost-Konfiguration /etc/apache2/sites-available/suitecrm.conf mit dem folgenden nano-Editor-Befehl.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die Option ServerName mit Ihrem Domainnamen ändern.

  
  
 DocumentRoot /var/www/suitecrm/public  
 ServerName suitecrm.howtoforge.local  
  
   
    Options FollowSymLinks  
    AllowOverride All  
   
  
 ErrorLog /var/log/apache2/suitecrm-error.log  
 CustomLog /var/log/apache2/suitecrm-access.log common

Speichern und schließen Sie die Datei, wenn Sie fertig sind.

Führen Sie jetzt den folgenden Befehl aus, um die Virtualhost-Datei suitecrm.conf zu aktivieren und Ihre Apache2-Konfigurationen zu überprüfen.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Wenn Sie eine korrekte Syntax haben, sollten Sie die Ausgabe Syntax OK erhalten.

setup vhosts

Führen Sie als Nächstes den systemctl-Befehl unten aus, um den apache2-Dienst neu zu starten und die Änderungen anzuwenden.

sudo systemctl restart apache2

Öffnen Sie zuletzt Ihren Webbrowser und besuchen Sie den Domainnamen Ihrer SuiteCRM-Installation, z.B. http://suitecrm.howtoforge.local/. Wenn alles gut geht, sollten Sie die Anmeldeseite von SuiteCRM sehen.

SuiteCRM mit SSL/TLS von Letsencrypt sichern

Mit allem konfiguriert, werden Sie jetzt SuiteCRM mit SSL/TLS-Zertifikaten von Letsencrypt sichern.

Installieren Sie Certbot und das Certbot-Apache-Plugin mit dem folgenden apt install-Befehl. Geben Sie y ein, um mit der Installation fortzufahren.

sudo apt install certbot python3-certbot-apache

Führen Sie jetzt den certbot-Befehl unten aus, um SSL/TLS-Zertifikate zu generieren. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse im folgenden Befehl ändern.

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

Sobald der Prozess abgeschlossen ist, werden Ihre SSL-Zertifikate im Verzeichnis /etc/letsencrypt/live/suitecrm.howtoforge.local generiert. Außerdem wird die SuiteCRM-Virtualhost-Datei suitecrm.conf automatisch mit HTTPS konfiguriert.

Gehen Sie zurück zu Ihrem Webbrowser und besuchen Sie Ihren SuiteCRM-Domainnamen, Sie sollten zur Anmeldeseite von SuiteCRM für sichere HTTPS-Verbindungen weitergeleitet werden. Geben Sie Ihren Admin-Benutzer und Ihr Passwort ein und klicken Sie auf Anmelden.

suitecrm login page

Wenn alles gut geht, sollten Sie das SuiteCRM-Administrations-Dashboard wie folgt sehen:

suitecrm dashboard

Fazit

Zusammenfassend haben Sie nun erfolgreich SuiteCRM auf dem Debian 12-Server mit dem LAMP-Stack (Apache2, MariaDB und PHP) installiert. Sie haben auch SuiteCRM mit SSL/TLS von Letsencrypt gesichert, das über Certbot generiert wurde. Jetzt können Sie SuiteCRM als Haupt-CRM-Anwendung für Ihr Unternehmen verwenden und Sie können damit beginnen, den SMTP-Server zu Ihrer SuiteCRM-Installation hinzuzufügen.