Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Adminer
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Adminer ist eine Weboberfläche für Datenbanken, die aus einem einzigen PHP-Programm besteht. Im Browser sieht man damit Tabellen und ihre Inhalte, legt Tabellen an, ändert Datensätze, führt SQL-Befehle aus und exportiert Daten. Adminer versteht MariaDB, MySQL und PostgreSQL, außerdem SQLite, Oracle und MS SQL. Es ist eine schlanke Alternative zu DBeaver, weil kein eigenes Programmfenster nötig ist. Diese Anleitung startet Adminer bei Bedarf mit dem eingebauten Webserver von PHP, nur für diesen Rechner.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Adminer 5.4.1 im Paket
adminer. - Ohne Apache: Das Paket empfiehlt den Webserver Apache und würde ihn ohne weitere Angaben mitinstallieren. Er wäre danach dauerhaft auf Port 80 erreichbar. Schritt 2 verhindert das mit
--no-install-recommendsund installiert nur die nötigen PHP-Teile. - Nur bei Bedarf und nur lokal: Adminer läuft in dieser Anleitung nur, solange das Terminal aus Schritt 8 geöffnet ist, und nur unter
127.0.0.1. Andere Rechner im Netz erreichen es nicht. - Keine Abfrage nach Updates: Die Ubuntu-Fassung fragt nicht beim Hersteller nach neuen Versionen. Updates kommen über
apt. - Anmeldung mit Passwort: Adminer meldet sich wie jedes andere Programm über das Netzwerk an der Datenbank an. Der Datenbankbenutzer braucht daher ein Passwort. Für PostgreSQL legen die Schritte 4 bis 6 einen solchen Benutzer an.
- Version: Getestet mit Adminer 5.4.1 und PHP 8.5 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Adminer installieren
adminer– das Programm selbst.libjs-jush– färbt SQL-Befehle in Adminer farbig ein.php-cli– enthält den eingebauten Webserver von PHP.php-cgi– erfüllt die Abhängigkeit des Pakets von einer PHP-Ausführung, ohne einen Dienst zu starten.php-mysqlundphp-pgsql– die Treiber für MariaDB/MySQL und PostgreSQL.--no-install-recommends– verhindert, dass Apache mitinstalliert wird.
sudo apt install --no-install-recommends adminer libjs-jush php-cli php-cgi php-mysql php-pgsql
Prüfen: In der Liste der neuen Pakete taucht apache2 nicht auf. Erscheint es doch, brich mit n ab und prüfe den Befehl.
3. Prüfen, ob Adminer da ist
Das Programm liegt in /usr/share/adminer, die Datei zum Starten in /etc/adminer.
ls /etc/adminer
Prüfen: Es erscheint conf.php.
PostgreSQL-Benutzer mit Passwort anlegen
Nur nötig, wenn du Adminer mit PostgreSQL verwenden willst. Die Anleitung PostgreSQL muss vorher durchlaufen sein. Für MariaDB und MySQL legen die dortigen Anleitungen bereits Benutzer mit Passwort an.
4. Benutzer anlegen
createuser legt einen neuen Datenbankbenutzer namens uebung an. --pwprompt fragt zweimal nach seinem Passwort. Der Befehl läuft als Verwalter postgres.
sudo -u postgres createuser --pwprompt uebung
5. Datenbank für den Benutzer anlegen
--owner uebung macht den neuen Benutzer zum Besitzer. Er darf in dieser Datenbank dann alles, in anderen Datenbanken nichts.
sudo -u postgres createdb --owner uebung uebung
6. Anmeldung mit Passwort testen
-h localhost erzwingt die Verbindung über das Netzwerk, wie Adminer sie nutzt. psql fragt nach dem Passwort aus Schritt 4.
psql -h localhost -U uebung -d uebung -c "SELECT current_user"
Prüfen: Die Ausgabe zeigt uebung.
Adminer starten
7. Freien Port prüfen
Adminer soll auf Port 8090 laufen. Der Befehl prüft, ob ein anderes Programm ihn schon belegt.
ss -ltn | grep ':8090 '
Prüfen: Der Befehl gibt nichts aus. Erscheint eine Zeile, wähle in Schritt 8 eine andere Zahl, z. B. 8091.
8. Adminer starten
php -S startet den eingebauten Webserver von PHP. 127.0.0.1:8090 ist die Adresse, /etc/adminer/conf.php beantwortet jede Anfrage. Der Webserver läuft mit deinen Benutzerrechten, solange das Terminal geöffnet ist.
php -S 127.0.0.1:8090 /etc/adminer/conf.php
Prüfen: Es erscheint Development Server (http://127.0.0.1:8090) started. Lass das Terminal offen. Jede Anfrage des Browsers erscheint dort als eigene Zeile.
9. Adminer im Browser öffnen
http://127.0.0.1:8090/
Prüfen: Es erscheint die Seite Login mit den Feldern Datenbank System, Server, Benutzer, Passwort und Datenbank. Die Sprache stellt Adminer nach dem Browser ein, oben links lässt sie sich unter Sprache ändern.
Mit einer Datenbank arbeiten
10. Anmelden
Trage ein:
- Datenbank System:
PostgreSQL(für MariaDB oder MySQL:MySQL / MariaDB) - Server:
localhost - Benutzer:
uebung - Passwort: das Passwort aus Schritt 4
- Datenbank:
uebung
Klicke auf Login. Den Haken bei Passwort speichern lässt du weg, dann merkt sich Adminer das Passwort nur bis zum Schließen des Browsers.
Prüfen: Die Überschrift lautet Schema: public, links stehen unter anderem SQL-Kommando und Tabelle erstellen.
11. SQL-Kommando öffnen
Klicke links auf SQL-Kommando.
12. Tabelle anlegen, füllen und abfragen
Füge diesen Text in das Eingabefeld ein (Strg+V) und klicke auf Ausführen:
CREATE TABLE ausflug (
id serial PRIMARY KEY,
ziel text NOT NULL,
km numeric
);
INSERT INTO ausflug (ziel, km) VALUES
('Hamfelder Hof', 6.5),
('Großensee', 12);
SELECT ziel, km FROM ausflug ORDER BY km DESC;
Prüfen: Unter dem Eingabefeld erscheint für jeden der drei Befehle eine Meldung, zuletzt eine Tabelle mit Großensee und Hamfelder Hof.
13. Tabelle ansehen und bearbeiten
Klicke links auf ausflug und dann auf Daten auswählen. Über Bearbeiten neben einer Zeile änderst du einen Datensatz, über Neuer Datensatz legst du einen weiteren an.
14. Daten exportieren
Klicke links auf Exportieren. Wähle bei Ergebnis die Möglichkeit Datei und bei Format SQL oder CSV, dann klicke unten auf Exportieren. Der Browser lädt die Datei herunter.
15. Abmelden
Klicke oben rechts auf Abmelden.
16. Adminer beenden
Wechsle in das Terminal aus Schritt 8 und drücke Strg+C. Danach ist Adminer nicht mehr erreichbar.
Wie geht es weiter?
- SQLite: Adminer lässt aus Sicherheitsgründen keine Anmeldung ohne Passwort zu. Für SQLite ist deshalb ein Zusatz nötig (
/usr/share/adminer/plugins/login-password-less.php). Einfacher geht es mit DBeaver oder dem Kommandozeilenprogramm aus der Anleitung SQLite. - Dauerhaft über nginx: Statt
php -Skann Adminer auch über nginx und PHP-FPM laufen. Dann sollte der Zugang mitallow 127.0.0.1; deny all;oder einem Passwortschutz auf bekannte Rechner beschränkt sein, weil sonst jeder im Netz die Anmeldeseite erreicht. - Apache: Das Paket legt die Datei
/etc/apache2/conf-available/adminer.confab, aktiviert sie aber nicht. Sie erlaubt den Zugriff von überall und sollte nicht ungeprüft mita2enconfeingeschaltet werden. - Dokumentation: https://www.adminer.org/
Deinstallieren
1. PostgreSQL-Übungsdatenbank löschen (falls angelegt)
Achtung: Die Tabelle aus Schritt 12 ist danach weg.
sudo -u postgres dropdb uebung
2. PostgreSQL-Übungsbenutzer löschen (falls angelegt)
sudo -u postgres dropuser uebung
3. Adminer entfernen
Entfernt Adminer und die Pakete aus Schritt 2. Brauchst du PHP noch für andere Anleitungen, z. B. PHP, lässt du php-cli und die Treiber in der Liste weg.
sudo apt purge adminer libjs-jush php-cgi php-mysql php-pgsql php-cli
4. Übrige Abhängigkeiten entfernen
apt listet die Pakete auf und fragt vor dem Löschen nach. Ist ein Paket dabei, das du noch brauchst, brich mit n ab.
sudo apt autoremove --purge
Prüfen: Der Ordner /etc/adminer ist verschwunden.
ls /etc/adminer
ls meldet, dass es den Ordner nicht gibt (Datei oder Verzeichnis nicht gefunden).
Quellen und Lizenz
- Offizielle Dokumentation: https://www.adminer.org/
- Lizenz: Adminer steht unter der Apache-2.0 / GPL-2.0.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.