phpMyAdmin auf Ubuntu 24.04 installieren: Schritt-für-Schritt-Anleitung
phpMyAdmin ist ein webbasiertes Open-Source-Tool zur Verwaltung von MySQL-Datenbanken. Es stellt eine benutzerfreundliche Oberfläche bereit, mit der sich Datenbanken, Tabellen und Felder bequem erstellen, bearbeiten und löschen lassen. Darüber hinaus können Benutzerkonten verwaltet, Datenbanken importiert und exportiert sowie SQL-Abfragen ausgeführt werden. Dank der grafischen Weboberfläche ist keine Nutzung der Kommandozeile notwendig.
In dieser Anleitung erfährst du, wie du phpMyAdmin unter Ubuntu 24.04 installierst. Du lernst, MySQL-Datenbanken einzurichten und die phpMyAdmin-Oberfläche zu nutzen, um Benutzer und Datenbanken effizient zu verwalten.
Voraussetzungen
Stelle vor Beginn sicher, dass du:
- Zugriff auf ein Ubuntu 24.04-System mit einem Nicht-Root-Benutzer und sudo-Rechten hast.
MySQL-Server installieren und einrichten
Führe die folgenden Schritte aus, um den MySQL-Server zu installieren und eine Testdatenbank für phpMyAdmin vorzubereiten.
APT-Paketindex aktualisieren
Aktualisiere die Paketliste deines Systems mit folgendem Befehl:
$ sudo apt update
MySQL-Server installieren
Falls MySQL noch nicht installiert ist, kannst du es mit folgendem Befehl installieren:
$ sudo apt install mysql-server -y
MySQL-Shell öffnen
Melde dich in der MySQL-Kommandozeile an:
$ sudo mysql
Beispieldatenbank erstellen
Erstelle eine neue Datenbank mit dem Namen my_company:
mysql> CREATE DATABASE my_company;
Neuen Benutzer anlegen
Lege einen neuen Benutzer company_admin mit einem sicheren Passwort an. Ersetze your_password durch dein eigenes starkes Passwort:
mysql> CREATE USER 'company_admin'@'localhost' IDENTIFIED BY 'your_password';
Benutzerrechte vergeben
Gib dem Benutzer company_admin vollständigen Zugriff auf die my_company-Datenbank:
mysql> GRANT ALL PRIVILEGES ON my_company.* TO 'company_admin'@'localhost';
Rechte übernehmen
Aktualisiere die Berechtigungstabelle, damit die Änderungen wirksam werden:
mysql> FLUSH PRIVILEGES;
MySQL-Sitzung beenden
Verlasse die MySQL-Kommandozeile mit folgendem Befehl:
mysql> EXIT;
phpMyAdmin unter Ubuntu 24.04 installieren
phpMyAdmin ist in den offiziellen Paketquellen von Ubuntu 24.04 enthalten. Die folgenden Schritte zeigen dir, wie du die Installation mit dem APT-Paketmanager durchführst.
Paketliste aktualisieren
Aktualisiere die Liste der verfügbaren Pakete mit folgendem Befehl:
$ sudo apt update
PHP und notwendige Erweiterungen installieren
Installiere PHP zusammen mit allen für phpMyAdmin erforderlichen Erweiterungen:
$ sudo apt install php php-mysql php-mbstring php-json php-xml php-curl php-zip php-common -y
phpMyAdmin installieren
Installiere phpMyAdmin mit folgendem Befehl:
$ sudo apt install phpmyadmin -y
Hinweise zur Installation
Während der Installation wirst du aufgefordert, einige Optionen zu konfigurieren:
- Wähle
apache2aus, indem du Leertaste drückst und bestätige mit Enter. - Wenn du gefragt wirst, ob die Datenbank mit
dbconfig-commonkonfiguriert werden soll, bestätige mit Ja und drücke Enter. - Vergib ein sicheres Passwort für phpMyAdmin und bestätige es durch zweimalige Eingabe.
Erfolg der Installation prüfen
Führe den folgenden Befehl aus, um zu überprüfen, ob phpMyAdmin korrekt installiert wurde:
$ dpkg -l | awk '/phpmyadmin / {print}'
Erwartete Ausgabe:
ii phpmyadmin 4:5.2.1+dfsg-3 all MySQL web administration tool
phpMyAdmin konfigurieren
Nach der Installation ist phpMyAdmin über die URL /phpmyadmin auf deinem Server erreichbar. Führe die folgenden Schritte aus, um sicherzustellen, dass die Apache-Konfiguration aktiviert ist und der Webserver korrekt läuft.
Apache-Konfiguration für phpMyAdmin aktivieren
Aktiviere die Konfigurationsdatei von phpMyAdmin mit diesem Befehl:
$ sudo a2enconf phpmyadmin.conf
Erwartete Ausgabe: Conf phpmyadmin already enabled
Apache neu starten
Starte den Apache-Webserver neu, damit die Änderungen übernommen werden:
$ sudo systemctl restart apache2
Status des Apache-Servers prüfen
Überprüfe, ob der Apache-Dienst aktiv ist:
$ sudo systemctl status apache2
Erwartete Ausgabe:
● apache2.service - The Apache HTTP Server
Loaded: loaded (/usr/lib/systemd/system/apache2.service; enabled; preset: enabled)
Active: active (running) since Wed 2025-02-19 14:03:08 UTC; 5min ago
Docs: https://httpd.apache.org/docs/2.4/
Process: 84623 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
Main PID: 74567 (apache2)
Tasks: 6 (limit: 1061)
Firewall-Status mit UFW prüfen
Prüfe den aktuellen Status der Firewall:
$ sudo ufw status
UFW installieren und SSH freigeben (falls nötig)
Falls UFW noch nicht installiert ist, kannst du es mit folgendem Befehl installieren und SSH-Zugriff aktivieren:
$ sudo apt install ufw -y && sudo ufw allow ssh
HTTP- und HTTPS-Zugriff für Apache erlauben
Aktiviere den vollständigen Apache-Profilzugriff über die Firewall:
$ sudo ufw allow 'Apache Full'
Firewall-Konfiguration neu laden
Wende die Änderungen an der Firewall mit folgendem Befehl an:
$ sudo ufw reload
Zugriff auf phpMyAdmin unter Ubuntu 24.04
In diesem Abschnitt erfährst du, wie du auf die phpMyAdmin-Weboberfläche zugreifst und die zuvor erstellte my_company-Datenbank verwalten kannst.
phpMyAdmin im Browser aufrufen
Öffne einen Webbrowser (z. B. Chrome) und gib folgende Adresse ein – ersetze your_server_ip durch die IP-Adresse oder Domain deines Servers:
http://your_server_ip/phpmyadmin
Bei phpMyAdmin anmelden
Logge dich mit dem MySQL-Benutzer company_admin ein, den du zuvor eingerichtet hast.
Oberfläche prüfen und Datenbank öffnen
Stelle sicher, dass das phpMyAdmin-Dashboard korrekt angezeigt wird. Wähle in der linken Navigation die Datenbank my_company, um diese zu verwalten.
Wichtiger Sicherheitshinweis
Warnung: Vermeide es, dich mit dem MySQL-Root-Benutzer bei phpMyAdmin anzumelden. Dies kann zu versehentlichen Änderungen oder Sicherheitsproblemen führen. Verwende stattdessen immer dedizierte Benutzer mit gezielten Berechtigungen – das erhöht die Sicherheit und senkt das Risiko bei unbefugtem Zugriff.
phpMyAdmin-URL mit Zugriffsschutz absichern
Zur Absicherung der phpMyAdmin-Oberfläche kannst du eine einfache HTTP-Authentifizierung aktivieren. Dadurch wird ein zusätzlicher Login mit Benutzername und Passwort erforderlich.
.htpasswd-Datei anlegen
Erstelle eine neue .htpasswd-Datei mit Benutzername und Passwort deiner Wahl. Ersetze your_username z. B. mit smith und gib dann das Passwort ein:
$ sudo htpasswd -c /etc/phpmyadmin/.htpasswd your_username
Apache-Konfigurationsdatei bearbeiten
Öffne die Konfigurationsdatei von phpMyAdmin mit dem Nano-Editor:
$ sudo nano /etc/apache2/conf-available/phpmyadmin.conf
Füge innerhalb des /usr/share/phpmyadmin-Verzeichnisses die Direktive AllowOverride All ein.
Beispiel für einen Directory-Block:
<Directory /usr/share/phpmyadmin>
AllowOverride All
...
</Directory>
.htaccess-Datei erstellen
Erstelle jetzt eine neue Datei namens .htaccess im Verzeichnis /usr/share/phpmyadmin/:
$ sudo nano /usr/share/phpmyadmin/.htaccess
Füge folgenden Inhalt in die .htaccess-Datei ein:
AuthType Basic
AuthName "Restricted Access to PhpMyAdmin"
AuthUserFile /etc/phpmyadmin/.htpasswd
Require valid-user
Erklärung der .htaccess-Konfiguration
AuthType Basic: Legt die Authentifizierungsmethode auf “Basic” fest.AuthName "Restricted Access to PhpMyAdmin": Zeigt diesen Hinweis im Anmeldefenster an.AuthUserFile /etc/phpmyadmin/.htpasswd: Gibt den Pfad zur Datei mit Benutzern und Passwörtern an.Require valid-user: Lässt nur gültige Benutzer zu.
Apache neu starten
Starte Apache neu, damit die neuen Einstellungen übernommen werden:
$ sudo systemctl restart apache2
Zugriffsschutz überprüfen
Öffne erneut http://your_server_ip/phpmyadmin. Du solltest nun zur Eingabe von Benutzername und Passwort aufgefordert werden.
Nach erfolgreicher Anmeldung kannst du dich wie gewohnt mit deinem MySQL-Benutzerkonto einloggen und deine Datenbanken über die phpMyAdmin-Oberfläche verwalten.
phpMyAdmin unter Ubuntu 24.04: Fehlerbehebung
Falls bei der Nutzung von phpMyAdmin Probleme auftreten, helfen dir die folgenden Abschnitte dabei, gängige Fehler zu erkennen und zu beheben.
Probleme bei der Anmeldung
Prüfe zuerst, ob der MySQL-Dienst aktiv ist:
$ sudo systemctl status mysql
Überprüfe außerdem, ob du den richtigen MySQL-Benutzernamen und das passende Passwort verwendest.
Öffne die Konfigurationsdatei von phpMyAdmin und suche nach möglichen Fehlern:
$ sudo nano /etc/phpmyadmin/config.inc.php
Fehler “Internal Server Error”
Wenn du eine interne Serverfehlermeldung erhältst, prüfe das Apache-Fehlerprotokoll auf Details:
$ sudo tail -f /var/log/apache2/error.log
Stelle sicher, dass alle erforderlichen PHP-Erweiterungen installiert und aktiv sind:
$ sudo apt install php-mysql php-mbstring php-json php-xml php-curl php-zip php-common -y
Zugriff verweigert (Access Denied)
Melde dich an der MySQL-Konsole an, um Berechtigungsprobleme zu beheben:
$ sudo mysql
Erstelle einen neuen Benutzer mit gewünschtem Namen und Passwort:
mysql> CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
Gib diesem Benutzer vollständige Rechte auf alle Datenbanken:
mysql> GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
Aktualisiere die Berechtigungen in MySQL mit folgendem Befehl:
mysql> FLUSH PRIVILEGES;
Verlasse die MySQL-Konsole und versuche erneut, dich bei phpMyAdmin anzumelden:
mysql> EXIT;
Fazit
Herzlichen Glückwunsch! Du hast phpMyAdmin erfolgreich auf Ubuntu 24.04 installiert. Das Tool bietet dir eine komfortable und leistungsfähige Weboberfläche zur Verwaltung von MySQL-Datenbanken. Du kannst jetzt Datenbanken verwalten, Daten einfügen, SQL-Abfragen ausführen und Berichte erstellen. Für weiterführende Konfigurationen und Tipps findest du Informationen in der offiziellen phpMyAdmin-Dokumentation.
