Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Einleitung
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Dieses Buch sammelt Schritt-für-Schritt-Anleitungen, um Programme auf einem Ubuntu-Rechner zu installieren.
- System: Ubuntu 26.04 LTS, x86_64 (amd64)
- Jede Anleitung erklärt jeden Schritt, zeigt, wie man die Installation prüft, und wie man das Programm wieder entfernt.
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.
nginx
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
nginx ist ein schneller Webserver. Auf dem Entwicklungsrechner dient er dazu, Webseiten und Webanwendungen lokal unter http://localhost zu testen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von nginx aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. nginx installieren
Installiert nginx aus den offiziellen Ubuntu-Paketquellen. Der Dienst wird dabei automatisch gestartet.
sudo apt install nginx
Prüfen: Die Versionsnummer wird angezeigt.
nginx -v
3. Prüfen, ob der Dienst läuft
nginx läuft als Hintergrunddienst (systemd). Hier siehst du, ob er gestartet ist.
systemctl status nginx
Prüfen: In der Ausgabe steht Active: active (running). Mit q verlässt du die Anzeige.
4. Startseite im Browser aufrufen
Zeigt, dass nginx Anfragen beantwortet.
curl -I http://localhost
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK. Im Browser erscheint unter http://localhost die Seite „Welcome to nginx!“.
Eigene Entwicklungsseite einrichten
5. Ordner für die Seite anlegen
Die Dateien kommen nach /var/www/dev. Der Ordner gehört deinem Benutzer, damit du ohne sudo darin arbeiten kannst. Das Home-Verzeichnis eignet sich nicht, weil nginx (Benutzer www-data) dort keine Leserechte hat.
sudo mkdir -p /var/www/dev
sudo chown "$USER":"$USER" /var/www/dev
6. Testseite anlegen
Eine einfache HTML-Datei, um die Einrichtung zu prüfen.
nano /var/www/dev/index.html
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<h1>Entwicklung läuft</h1>
7. Konfiguration für die Seite anlegen
Die Seite läuft auf Port 8081, damit sie die Standardseite auf Port 80 nicht stört. Port 8080 bleibt frei für Apache (siehe nginx als Proxy vor Apache). listen 127.0.0.1 sorgt dafür, dass nur dein eigener Rechner darauf zugreifen kann.
sudo nano /etc/nginx/sites-available/dev
Die Datei hat schon Inhalt, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8081;
server_name localhost;
root /var/www/dev;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
8. Seite aktivieren
nginx lädt nur Konfigurationen aus sites-enabled. Ein Link dorthin schaltet die Seite ein.
sudo ln -s /etc/nginx/sites-available/dev /etc/nginx/sites-enabled/dev
9. Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
10. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Prüfen: Die Testseite wird angezeigt.
curl http://localhost:8081
Die Ausgabe ist <h1>Entwicklung läuft</h1>. Im Browser: http://localhost:8081.
Optional: Autostart ausschalten
Auf einem Entwicklungsrechner muss nginx nicht bei jedem Systemstart laufen.
Autostart ausschalten:
sudo systemctl disable nginx
Bei Bedarf von Hand starten und stoppen:
sudo systemctl start nginx
sudo systemctl stop nginx
Deinstallieren
1. Entwicklungsseite entfernen
Löscht die Konfiguration und die Dateien der Seite. Achtung: Alles in /var/www/dev geht verloren.
sudo rm /etc/nginx/sites-enabled/dev /etc/nginx/sites-available/dev
sudo rm -r /var/www/dev
2. nginx entfernen
purge entfernt auch die Konfigurationsdateien unter /etc/nginx.
sudo apt purge nginx nginx-common
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für nginx installiert wurden.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
nginx -v
Quellen und Lizenz
- Offizielle Dokumentation: https://nginx.org/en/docs/
- Lizenz: nginx steht unter der 2-Clause BSD License.
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.
nginx auf dem Produktionsserver
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Auf einem Server im Internet liefert nginx Websites dauerhaft und verschlüsselt an Besucher aus. Diese Anleitung richtet nginx auf einem frischen Ubuntu-Server für den echten Betrieb ein: mit Firewall, automatischen Sicherheitsupdates, Wildcard-Zertifikat von Let's Encrypt und einer abgesicherten Grundkonfiguration. Als Beispiel dient die Domain wissen-ahrensburg.de.
Vorbemerkungen
- Unterschied zur Anleitung nginx: Dort läuft nginx auf dem eigenen Rechner zum Testen. Hier ist der Server aus dem Internet erreichbar. Deshalb kommen Firewall, HTTPS und Schutz vor fremden Anfragen dazu.
- Voraussetzungen:
- Ein Server mit Ubuntu 26.04 LTS, auf den du per SSH mit einem Benutzer mit
sudo-Rechten zugreifst. - Die Domain
wissen-ahrensburg.dezeigt perA-Eintrag (IPv4) und, falls vorhanden,AAAA-Eintrag (IPv6) auf den Server. Dasselbe gilt fürwwwoder für*, wenn beliebige Subdomains auf den Server zeigen sollen.
- Ein Server mit Ubuntu 26.04 LTS, auf den du per SSH mit einem Benutzer mit
- Eigene Domain: Ersetze
wissen-ahrensburg.dein allen Befehlen und Dateien durch deine Domain. - apt statt Snap: Certbot gibt es auch als Snap-Paket. Ubuntu 26.04 bringt Certbot aber selbst mit. Das
apt-Paket bekommt Sicherheitsupdates zusammen mit dem restlichen System, undsnapdwird dafür nicht gebraucht. - Alle Befehle laufen auf dem Server, also in der SSH-Sitzung, nicht auf deinem eigenen Rechner.
System vorbereiten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aller Pakete kennt.
sudo apt update
2. Installierte Pakete aktualisieren
Ein Server im Internet sollte vor der Einrichtung auf dem neuesten Stand sein, damit keine bekannten Sicherheitslücken offen sind.
sudo apt upgrade
Prüfen: Die Frage nach der Installation mit J bzw. Y bestätigen. Meldet apt danach, dass ein Neustart nötig ist (Datei /var/run/reboot-required existiert), starte den Server mit sudo reboot neu und melde dich wieder an.
3. Automatische Sicherheitsupdates installieren
unattended-upgrades spielt Sicherheitsupdates jeden Tag von selbst ein, auch für nginx und Certbot. Auf Ubuntu-Servern ist das Paket meist schon vorhanden, der Befehl schadet dann nicht.
sudo apt install unattended-upgrades
4. Automatische Updates einschalten
Der Dialog fragt, ob Updates automatisch installiert werden sollen. Wähle Ja.
sudo dpkg-reconfigure -plow unattended-upgrades
Prüfen: Die Datei enthält zwei Zeilen, die beide mit "1"; enden.
cat /etc/apt/apt.conf.d/20auto-upgrades
nginx installieren
5. nginx installieren
Installiert nginx aus den Ubuntu-Paketquellen. Der Dienst startet sofort und beim Hochfahren des Servers automatisch.
sudo apt install nginx
Prüfen: Die Versionsnummer wird angezeigt.
nginx -v
6. Autostart prüfen
Auf einem Produktionsserver muss nginx nach jedem Neustart von selbst laufen.
systemctl is-enabled nginx
Prüfen: Die Ausgabe lautet enabled. Steht dort disabled, schalte den Autostart mit sudo systemctl enable nginx ein.
7. Standardseite ausschalten
Die mitgelieferte Seite „Welcome to nginx!“ würde sonst jedem angezeigt, der die IP-Adresse des Servers aufruft. Gelöscht wird nur der Link in sites-enabled. Das Original in sites-available bleibt als Vorlage erhalten.
sudo rm /etc/nginx/sites-enabled/default
Firewall einrichten
8. SSH in der Firewall erlauben
Wichtig: Dieser Schritt muss vor dem Einschalten der Firewall kommen. Sonst sperrt ufw die laufende SSH-Verbindung, und du kommst nicht mehr auf den Server.
sudo ufw allow OpenSSH
9. HTTP und HTTPS in der Firewall erlauben
Das Profil Nginx Full wurde mit nginx installiert und öffnet Port 80 (HTTP) und Port 443 (HTTPS).
sudo ufw allow 'Nginx Full'
10. Firewall einschalten
Ab jetzt sind nur noch SSH, HTTP und HTTPS von außen erreichbar. Die Rückfrage mit y bestätigen.
sudo ufw enable
Prüfen: Die Liste enthält OpenSSH und Nginx Full, jeweils mit ALLOW.
sudo ufw status
Grundkonfiguration absichern
11. Eigene Einstellungen für alle Websites anlegen
Dateien in /etc/nginx/conf.d/ gelten für alle Websites auf dem Server. Eine eigene Datei ist besser, als nginx.conf direkt zu ändern, weil ein Update von nginx sie nicht anfasst.
server_tokens offblendet die Versionsnummer von nginx in Fehlerseiten und im HeaderServeraus. Angreifer sehen so nicht sofort, welche Version läuft.client_max_body_sizebegrenzt, wie groß hochgeladene Daten sein dürfen.10mreicht für Formulare und kleine Uploads.- Die
gzip-Zeilen komprimieren Text, CSS, JavaScript und JSON. Seiten laden dadurch schneller.gzip onsteht bei Ubuntu schon innginx.confund fehlt deshalb hier.
sudo nano /etc/nginx/conf.d/produktion.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Gilt für alle Websites auf diesem Server
server_tokens off;
client_max_body_size 10m;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 5;
gzip_types text/plain text/css text/xml application/json application/javascript application/xml image/svg+xml;
12. Konfiguration testen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Meldet nginx "gzip_types" directive is duplicate (oder eine andere gzip-Zeile), ist diese Zeile in /etc/nginx/nginx.conf schon aktiv. Lösche sie dann in produktion.conf.
Wildcard-Zertifikat holen
Die Einzelheiten zum Nachweis über DNS stehen in der Anleitung Wildcard-Zertifikat mit Certbot. Hier folgt die Kurzfassung für den Server.
13. Certbot installieren
certbot beantragt das Zertifikat, bind9-dnsutils liefert den Befehl dig zum Prüfen der DNS-Einträge.
sudo apt install certbot bind9-dnsutils
Prüfen: Die Version wird angezeigt.
certbot --version
14. Zertifikat anfordern
nginx muss dafür nicht gestoppt werden. Der Nachweis läuft über TXT-Einträge im DNS und nicht über den Webserver. Anhalten müsste man nginx nur beim Verfahren --standalone, bei dem Certbot selbst Port 80 belegt.
--cert-namelegt den Ordner fest:/etc/letsencrypt/live/wissen-ahrensburg.de/.'*.wissen-ahrensburg.de'steht in einfachen Anführungszeichen, damit die Shell den Stern nicht als Dateimuster auswertet.
sudo certbot certonly --manual --preferred-challenges dns --cert-name wissen-ahrensburg.de -d wissen-ahrensburg.de -d '*.wissen-ahrensburg.de'
Beim ersten Aufruf fragt Certbot nach einer E-Mail-Adresse und den Nutzungsbedingungen (mit Y zustimmen).
15. Die beiden TXT-Einträge anlegen
Certbot zeigt nacheinander zwei Werte für den Namen _acme-challenge.wissen-ahrensburg.de. Lege beim Domain-Anbieter für jeden Wert einen eigenen TXT-Eintrag mit dem Namen _acme-challenge an. Beide Einträge müssen gleichzeitig bestehen. Drücke nach dem zweiten Wert noch nicht Enter.
16. TXT-Einträge prüfen
In einem zweiten Terminal (zweite SSH-Sitzung) fragst du einen öffentlichen DNS-Server, ob die Einträge schon sichtbar sind.
dig +short TXT _acme-challenge.wissen-ahrensburg.de @1.1.1.1
Prüfen: Beide Werte erscheinen. Wenn nicht, einige Minuten warten und erneut fragen. Danach im ersten Terminal Enter drücken.
Prüfen: Certbot meldet Successfully received certificate. Die TXT-Einträge kannst du danach beim Anbieter wieder löschen.
17. Zertifikat als Baustein anlegen
Die Pfade zum Zertifikat kommen in eine eigene Datei. Jede Website unter der Domain bindet sie mit einer Zeile ein.
sudo nano /etc/nginx/snippets/ssl-wissen-ahrensburg.de.conf
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Wildcard-Zertifikat für wissen-ahrensburg.de und *.wissen-ahrensburg.de
ssl_certificate /etc/letsencrypt/live/wissen-ahrensburg.de/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/wissen-ahrensburg.de/privkey.pem;
18. Sicherheits-Header als Baustein anlegen
Diese Header weisen den Browser an, sich vorsichtiger zu verhalten:
Strict-Transport-Security(HSTS): Der Browser ruft die Domain ein Jahr lang nur noch über HTTPS auf, auch wenn jemandhttp://eintippt. Achtung: Diese Zusage lässt sich nicht einfach zurücknehmen. Lass den Header weg, solange HTTPS noch nicht zuverlässig läuft.X-Content-Type-Options: Der Browser hält sich an den angegebenen Dateityp und rät nicht selbst.X-Frame-Options: Fremde Seiten dürfen deine Seite nicht in einem Rahmen einbetten (Schutz vor untergeschobenen Klicks).Referrer-Policy: Beim Klick auf fremde Links wird nur die Domain weitergegeben, nicht die ganze Adresse.
always sorgt dafür, dass die Header auch bei Fehlerseiten mitgeschickt werden.
sudo nano /etc/nginx/snippets/sicherheitsheader.conf
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
Hinweis: Steht in einem
location-Block eine eigeneadd_header-Zeile, gelten dort die Header aus demserver-Block nicht mehr. Binde den Baustein dann zusätzlich in diesemlocation-Block ein.
Fremde Anfragen abweisen
19. Standard-Server anlegen
Viele automatische Scanner rufen Server nur über die IP-Adresse oder mit erfundenen Domainnamen auf. Ohne passenden Eintrag würde nginx ihnen die erste Website zeigen. Dieser Standard-Server fängt alle Anfragen ab, deren Name zu keiner deiner Websites passt:
- Auf Port 80 beendet
return 444die Verbindung ohne Antwort. - Auf Port 443 lehnt
ssl_reject_handshake ondie verschlüsselte Verbindung ab, bevor ein Zertifikat gezeigt wird. So verrät der Server nicht, welche Domains auf ihm liegen.
Die 000 am Anfang des Dateinamens sorgt dafür, dass die Datei als Erstes geladen wird und leicht zu finden ist.
sudo nano /etc/nginx/sites-available/000-standard
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Anfragen ohne bekannten Domainnamen abweisen
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
return 444;
}
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
server_name _;
ssl_reject_handshake on;
}
20. Standard-Server einschalten
sudo ln -s /etc/nginx/sites-available/000-standard /etc/nginx/sites-enabled/000-standard
Website einrichten
21. Ordner für die Website anlegen
Die Dateien der Website liegen im Unterordner html. Der Ordner gehört deinem Benutzer, damit du ohne sudo Dateien hochladen kannst. nginx braucht nur Leserechte.
sudo mkdir -p /var/www/wissen-ahrensburg.de/html
sudo chown -R "$USER":"$USER" /var/www/wissen-ahrensburg.de
22. Startseite anlegen
Eine einfache Seite zum Testen. Später ersetzt du sie durch die echte Website.
nano /var/www/wissen-ahrensburg.de/html/index.html
Füge diese Zeile ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
<h1>wissen-ahrensburg.de läuft</h1>
23. Konfiguration der Website anlegen
Die Datei enthält drei server-Blöcke:
- Der erste leitet alle HTTP-Anfragen für die Domain und jede Subdomain dauerhaft auf HTTPS um.
- Der zweite leitet
www.wissen-ahrensburg.deauf die Adresse ohnewwwum. So hat jede Seite genau eine Adresse, was auch Suchmaschinen bevorzugen. - Der dritte ist die eigentliche Website.
http2 onschaltet das schnellere Protokoll HTTP/2 ein. Eigene Log-Dateien pro Website erleichtern die Fehlersuche.
sudo nano /etc/nginx/sites-available/wissen-ahrensburg.de
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
# HTTP: alles auf HTTPS umleiten
server {
listen 80;
listen [::]:80;
server_name wissen-ahrensburg.de *.wissen-ahrensburg.de;
return 301 https://$host$request_uri;
}
# HTTPS: www auf die Adresse ohne www umleiten
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name www.wissen-ahrensburg.de;
include snippets/ssl-wissen-ahrensburg.de.conf;
return 301 https://wissen-ahrensburg.de$request_uri;
}
# HTTPS: die Website
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name wissen-ahrensburg.de;
include snippets/ssl-wissen-ahrensburg.de.conf;
include snippets/sicherheitsheader.conf;
root /var/www/wissen-ahrensburg.de/html;
index index.html;
access_log /var/log/nginx/wissen-ahrensburg.de.access.log;
error_log /var/log/nginx/wissen-ahrensburg.de.error.log;
location / {
try_files $uri $uri/ =404;
}
# Versteckte Dateien wie .git oder .env nie ausliefern
location ~ /\. {
deny all;
}
}
24. Website einschalten
sudo ln -s /etc/nginx/sites-available/wissen-ahrensburg.de /etc/nginx/sites-enabled/wissen-ahrensburg.de
25. Konfiguration testen und nginx neu laden
&& sorgt dafür, dass nginx nur neu geladen wird, wenn der Test erfolgreich war. Eine fehlerhafte Konfiguration legt die laufenden Websites so nicht lahm.
sudo nginx -t && sudo systemctl reload nginx
Prüfen: Die Ausgabe enthält test is successful. Meldet nginx cannot load certificate, stimmt der Pfad in Schritt 17 nicht mit dem Ordner unter /etc/letsencrypt/live/ überein.
Testen
Diese Befehle funktionieren auf dem Server und auf jedem anderen Rechner mit Internetzugang.
26. Umleitung auf HTTPS prüfen
curl -sI http://wissen-ahrensburg.de/ | grep -E '^HTTP|^Location'
Prüfen: Die Ausgabe lautet HTTP/1.1 301 Moved Permanently und Location: https://wissen-ahrensburg.de/.
27. Umleitung von www prüfen
curl -sI https://www.wissen-ahrensburg.de/ | grep -E '^HTTP|^location'
Prüfen: Die Ausgabe lautet HTTP/2 301 und location: https://wissen-ahrensburg.de/.
28. Website und Header prüfen
curl -sI https://wissen-ahrensburg.de/
Prüfen: Die erste Zeile lautet HTTP/2 200. Die Zeile server: zeigt nur nginx ohne Versionsnummer. Außerdem stehen dort die vier Header aus Schritt 18, z. B. strict-transport-security: max-age=31536000.
29. Abweisung über die IP-Adresse prüfen
Ersetze 203.0.113.10 durch die IPv4-Adresse deines Servers.
curl -sI http://203.0.113.10/
Prüfen: Es kommt keine Ausgabe. Ohne -s meldet curl Empty reply from server. Der Standard-Server aus Schritt 19 hat die Verbindung beendet.
30. Log-Dateien ansehen
Hier siehst du jeden Aufruf der Website. Mit Strg+C beendest du die Anzeige. Die Log-Dateien werden von logrotate täglich gewechselt und nach 14 Tagen gelöscht, damit die Festplatte nicht voll läuft.
sudo tail -f /var/log/nginx/wissen-ahrensburg.de.access.log
Zertifikat verlängern
Ein manuell beantragtes Zertifikat verlängert sich nicht von selbst. Es gilt derzeit 90 Tage. Trage dir etwa 30 Tage vor Ablauf einen Termin ein. Das genaue Vorgehen steht in der Anleitung Wildcard-Zertifikat mit Certbot im Abschnitt „Verlängern“: Schritt 14 wiederholen, neue TXT-Einträge setzen und danach nginx neu laden.
sudo systemctl reload nginx
Prüfen: Das Ablaufdatum steht bei Expiry Date.
sudo certbot certificates
Prüfen der Installation
nginx -v
systemctl is-active nginx
sudo ufw status
Prüfen: Der erste Befehl zeigt die Version, der zweite active, der dritte OpenSSH und Nginx Full mit ALLOW.
Deinstallieren
1. Websites ausschalten und Konfiguration löschen
sudo rm /etc/nginx/sites-enabled/wissen-ahrensburg.de /etc/nginx/sites-available/wissen-ahrensburg.de
sudo rm /etc/nginx/sites-enabled/000-standard /etc/nginx/sites-available/000-standard
2. Bausteine und eigene Einstellungen löschen
sudo rm /etc/nginx/snippets/ssl-wissen-ahrensburg.de.conf /etc/nginx/snippets/sicherheitsheader.conf /etc/nginx/conf.d/produktion.conf
3. Dateien der Website löschen
Achtung: Alles in /var/www/wissen-ahrensburg.de geht verloren. Sichere die Website vorher, wenn du sie noch brauchst.
sudo rm -r /var/www/wissen-ahrensburg.de
4. Zertifikat löschen
Entfernt Zertifikat und Schlüssel unter /etc/letsencrypt. Certbot fragt zur Sicherheit nach.
sudo certbot delete --cert-name wissen-ahrensburg.de
5. HTTP und HTTPS in der Firewall schließen
Die Regel für SSH bleibt bestehen, sonst sperrst du dich aus.
sudo ufw delete allow 'Nginx Full'
6. nginx und Certbot entfernen
purge entfernt auch die Konfigurationsdateien unter /etc/nginx.
sudo apt purge nginx nginx-common certbot
7. Nicht mehr benötigte Pakete entfernen
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
nginx -v
Quellen und Lizenz
- Offizielle Dokumentation: https://nginx.org/en/docs/
- Lizenz: nginx steht unter der 2-Clause BSD License.
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.
nginx als Proxy vor Apache
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
nginx nimmt die Anfragen auf Port 80 an und reicht sie an Apache weiter. Apache lauscht dabei nur lokal auf Port 8080. So laufen beide Webserver auf demselben Rechner, und Programme, die Apache brauchen (z. B. der Tileserver mit mod_tile), sind trotzdem ohne :8080 in der Adresse erreichbar.
Browser ──► nginx (Port 80) ──► Apache (127.0.0.1:8080)
Voraussetzung: nginx ist installiert und läuft (siehe nginx).
Warum kein Unix-Socket? Apache kann nur auf TCP-Ports lauschen, nicht auf einem Unix-Socket. Die Anweisung
Listennimmt nur eine IP-Adresse und einen Port an. Mit127.0.0.1ist Apache trotzdem nur vom eigenen Rechner aus erreichbar.
Apache auf Port 8080 einrichten
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Apache aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Apache installieren
Ist Apache schon installiert (z. B. durch den Tileserver), meldet apt nur, dass das Paket bereits die neueste Version hat.
sudo apt install apache2
Belegt nginx schon Port 80, kann Apache nach der Installation nicht starten. Dann erscheint Address already in use. Das ist an dieser Stelle normal und wird in den nächsten Schritten behoben.
3. Apache nur lokal auf Port 8080 lauschen lassen
Ändert in ports.conf die Zeile Listen 80 (oder Listen 8080) zu Listen 127.0.0.1:8080. Danach ist Port 80 für nginx frei, und Apache nimmt nur noch Verbindungen vom eigenen Rechner an. Von außen kommt man nur noch über nginx an Apache heran.
sudo nano /etc/apache2/ports.conf
Suche mit Strg+W nach Listen und drücke Enter. Die erste Fundstelle ist die Zeile Listen 80 oder Listen 8080, die Zeilen mit Listen 443 weiter unten bleiben unverändert. Ändere die gefundene Zeile so, dass sie lautet:
Listen 127.0.0.1:8080
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe lautet Listen 127.0.0.1:8080.
grep '^Listen' /etc/apache2/ports.conf
4. Die Standardseite von Apache auf Port 8080 umstellen
Der VirtualHost muss zum neuen Port passen. Sonst findet Apache für Anfragen auf Port 8080 keine passende Seite.
sudo nano /etc/apache2/sites-available/000-default.conf
Suche mit Strg+W nach VirtualHost und drücke Enter. Steht dort schon *:8080, ist nichts zu tun. Ändere die gefundene Zeile so, dass sie lautet:
<VirtualHost *:8080>
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe lautet <VirtualHost *:8080>.
grep '<VirtualHost' /etc/apache2/sites-available/000-default.conf
5. Das Modul remoteip einschalten
Alle Anfragen kommen jetzt von nginx, also von 127.0.0.1. Ohne dieses Modul stünde in Apaches Logdateien bei jeder Anfrage diese Adresse. Mit remoteip übernimmt Apache die echte Adresse des Besuchers, die nginx mitschickt.
sudo a2enmod remoteip
6. remoteip konfigurieren
RemoteIPHeader gibt an, in welchem Header nginx die echte Adresse mitschickt. Wegen RemoteIPInternalProxy glaubt Apache diesem Header nur, wenn die Anfrage von 127.0.0.1 kommt. Sonst könnte jeder Besucher eine falsche Adresse vortäuschen.
sudo nano /etc/apache2/conf-available/remoteip.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
RemoteIPHeader X-Forwarded-For
RemoteIPInternalProxy 127.0.0.1
7. Die Konfiguration einbinden
Schaltet die Datei aus Schritt 6 ein. Apache liest nur Dateien aus conf-enabled.
sudo a2enconf remoteip
8. Die Apache-Konfiguration testen
Findet Tippfehler, bevor Apache neu startet.
sudo apache2ctl configtest
Prüfen: Die Ausgabe endet mit Syntax OK.
9. Apache neu starten
Erst nach einem Neustart gilt die neue Listen-Adresse. reload reicht dafür nicht.
sudo systemctl restart apache2
Prüfen: In der Ausgabe steht 127.0.0.1:8080 (nicht *:8080 oder 0.0.0.0:8080) mit dem Prozess apache2.
sudo ss -tlnp | grep ':8080'
10. Apache direkt aufrufen
Zeigt, dass Apache auf Port 8080 antwortet, noch ohne nginx.
curl -I http://127.0.0.1:8080
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK, weiter unten steht Server: Apache.
nginx als Proxy einrichten
11. Proxy-Einstellungen als Baustein anlegen
Die Einstellungen kommen in eine eigene Datei unter snippets. So kann man sie in jedem location-Block mit einer einzigen Zeile einbinden.
proxy_passgibt an, wohin nginx die Anfrage weiterreicht.- Die
proxy_set_header-Zeilen schicken den ursprünglichen Hostnamen, die Adresse des Besuchers und das Protokoll (httpoderhttps) an Apache mit. Ohne diese Zeilen sähe Apache nur127.0.0.1. proxy_read_timeoutlässt Apache bis zu 120 Sekunden Zeit für eine Antwort. Der Standardwert von 60 Sekunden reicht nicht immer, zum Beispiel wenn der Tileserver eine Kachel erst noch zeichnen muss.
sudo nano /etc/nginx/snippets/apache-proxy.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 120s;
12. Die Standardseite von nginx öffnen
In dieser Datei legt man fest, welche Adressen nginx an Apache weiterreicht.
sudo nano /etc/nginx/sites-available/default
13. Die Weiterleitung eintragen
Suche im Block server { … } den Abschnitt location / { … }. Es gibt zwei Möglichkeiten.
Variante A – alles an Apache: Ersetze die Zeile try_files $uri $uri/ =404; durch die include-Zeile. nginx liefert danach selbst keine Dateien mehr aus, sondern reicht jede Anfrage an Apache weiter.
location / {
include snippets/apache-proxy.conf;
}
Variante B – nur einen Pfad an Apache: Lass location / { … } unverändert und füge darunter einen eigenen Block ein. Nur Adressen, die mit diesem Pfad beginnen, gehen an Apache, alles andere liefert nginx wie bisher selbst aus. Beim Tileserver ist das der Kachelpfad /osm/.
location /osm/ {
include snippets/apache-proxy.conf;
}
Speichern mit Strg+O und Enter, beenden mit Strg+X.
14. Die nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
15. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Prüfen
16. Eine Anfrage über nginx schicken
Die Anfrage geht an Port 80, also an nginx. Bei Variante B hängst du den Pfad an, beim Tileserver zum Beispiel http://localhost/osm/0/0/0.png.
curl -I http://localhost/
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK, und bei Server: steht nginx, denn nach außen antwortet immer nginx.
17. Im Log von Apache nachsehen
Hier sieht man, ob die Anfrage aus Schritt 16 wirklich bei Apache angekommen ist.
sudo tail -n 3 /var/log/apache2/access.log
Prüfen: Die letzte Zeile enthält die Anfrage aus Schritt 16 (z. B. "HEAD / HTTP/1.1") mit curl als Programmnamen. Am Zeilenanfang steht die Adresse des Besuchers, die nginx mitgeschickt hat. Bei einem Test auf dem eigenen Rechner ist das ::1 oder 127.0.0.1, bei einem anderen Rechner im Netz dessen IP-Adresse. Fehlt sie, hat nginx die Anfrage selbst beantwortet. Dann den location-Block aus Schritt 13 prüfen.
18. Prüfen, dass Apache von außen nicht erreichbar ist
Ersetze 192.168.1.10 durch die IP-Adresse deines Rechners im Netzwerk (anzeigen mit hostname -I).
curl -I --max-time 5 http://192.168.1.10:8080
Prüfen: Der Befehl meldet Connection refused oder Failed to connect. Apache ist also nur über nginx erreichbar.
Fehlersuche
502 Bad Gateway: nginx erreicht Apache nicht. Meist läuft Apache nicht oder lauscht auf einem anderen Port. Prüfen mitsystemctl status apache2undsudo ss -tlnp | grep ':8080'.504 Gateway Timeout: Apache antwortet zu langsam. Den Wertproxy_read_timeoutin/etc/nginx/snippets/apache-proxy.conferhöhen, danach nginx neu laden.- Port 8080 ist schon belegt: Apache startet nicht und meldet
Address already in use. Ein anderes Programm lauscht dann schon auf 8080. Welches, zeigtsudo ss -tlnp | grep ':8080'. Dann für Apache einen freien Port wählen und ihn inports.conf,000-default.confundapache-proxy.confeintragen.
Rückgängig machen
1. Die Weiterleitung aus nginx entfernen
Öffne die Datei wieder und mache die Änderung aus Schritt 13 rückgängig: Bei Variante A kommt try_files $uri $uri/ =404; zurück an die Stelle der include-Zeile, bei Variante B wird der zusätzliche location-Block gelöscht.
sudo nano /etc/nginx/sites-available/default
2. Den Proxy-Baustein löschen
Die Datei wird nicht mehr gebraucht.
sudo rm /etc/nginx/snippets/apache-proxy.conf
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. remoteip in Apache ausschalten
Ohne nginx davor wird das Modul nicht mehr gebraucht.
sudo a2disconf remoteip && sudo a2dismod remoteip
sudo rm /etc/apache2/conf-available/remoteip.conf
5. Apache wieder auf allen Adressen lauschen lassen
Apache bleibt auf Port 8080, ist aber wieder aus dem Netzwerk erreichbar. Port 80 bleibt für nginx frei.
sudo nano /etc/apache2/ports.conf
Suche mit Strg+W nach Listen 127 und drücke Enter. Ändere die gefundene Zeile so, dass sie lautet:
Listen 8080
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
sudo systemctl restart apache2
Prüfen: In der Ausgabe steht *:8080.
sudo ss -tlnp | grep ':8080'
Soll Apache ganz verschwinden: sudo apt purge apache2 und danach sudo apt autoremove. Das aber nur, wenn kein anderes Programm (z. B. der Tileserver) Apache noch braucht.
Quellen und Lizenz
- Offizielle Dokumentation: https://httpd.apache.org/docs/
- Lizenz: Apache und nginx steht unter der Apache-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.
Statische Website mit nginx
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
nginx liefert eine statische Website (HTML, CSS, Bilder, JavaScript ohne Server-Programm) sehr schnell und mit wenig Speicher aus. Diese Anleitung richtet als Beispiel die Website start.de ein.
Voraussetzung: nginx ist installiert und läuft (siehe nginx).
Zum Beispiel
start.de: Die Domain ist nur ein Beispiel. Ersetzestart.dein allen Befehlen durch deine eigene Domain. Zum Ausprobieren auf dem eigenen Rechner zeigt Schritt 11, wie der Rechnerstart.deauf sich selbst umleitet. Die echte Website unter diesem Namen ist dann auf diesem Rechner nicht mehr erreichbar, bis der Eintrag wieder entfernt ist.
Dateien der Website anlegen
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von nginx kennt, falls es noch nachinstalliert oder aktualisiert werden muss.
sudo apt update
2. Ordner für die Website anlegen
Jede Website bekommt einen eigenen Ordner unter /var/www. Der Unterordner html enthält nur die Dateien, die Besucher sehen dürfen. Andere Dateien (z. B. Notizen oder Quelldateien) kann man daneben in /var/www/start.de ablegen, ohne dass nginx sie ausliefert.
sudo mkdir -p /var/www/start.de/html
3. Den Ordner deinem Benutzer geben
So kannst du die Dateien der Website ohne sudo bearbeiten. nginx läuft als Benutzer www-data und braucht nur Leserechte, die es über die normalen Rechte (755 für Ordner, 644 für Dateien) bekommt.
sudo chown -R "$USER":"$USER" /var/www/start.de
Prüfen: Als Besitzer steht dein Benutzername.
ls -ld /var/www/start.de/html
4. Startseite anlegen
index.html ist die Seite, die nginx zeigt, wenn nur die Domain aufgerufen wird. Sie bindet ein Stylesheet ein, damit man später sieht, dass auch weitere Dateien ausgeliefert werden.
nano /var/www/start.de/html/index.html
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>start.de</title>
<link rel="stylesheet" href="/style.css">
</head>
<body>
<h1>Willkommen auf start.de</h1>
<p>Diese Seite liefert nginx als statische Datei aus.</p>
</body>
</html>
5. Stylesheet anlegen
Eine kleine CSS-Datei als Beispiel für zusätzliche Dateien wie Bilder oder Skripte.
nano /var/www/start.de/html/style.css
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
body { font-family: sans-serif; max-width: 40rem; margin: 3rem auto; padding: 0 1rem; }
h1 { color: #2a6f4f; }
6. Eigene Fehlerseite anlegen
Diese Seite erscheint, wenn jemand eine Adresse aufruft, die es nicht gibt. Ohne sie zeigt nginx eine schlichte Standardseite.
nano /var/www/start.de/html/404.html
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head><meta charset="utf-8"><title>Nicht gefunden</title><link rel="stylesheet" href="/style.css"></head>
<body><h1>Seite nicht gefunden</h1><p><a href="/">Zur Startseite</a></p></body>
</html>
nginx einrichten
7. Konfiguration für start.de anlegen
Jede Website bekommt in sites-available eine eigene Datei mit einem server-Block. Die wichtigsten Zeilen:
listen 80undlisten [::]:80– nimmt Anfragen auf Port 80 an, über IPv4 und IPv6.server_name– nginx wählt diesen Block nur, wenn der Browserstart.deoderwww.start.deaufruft. So können mehrere Websites denselben Port nutzen.root– der Ordner, aus dem die Dateien kommen.access_logunderror_log– eigene Logdateien, damit die Einträge dieser Website nicht mit anderen vermischt sind.try_files– liefert die angefragte Datei oder den Ordner aus. Gibt es beides nicht, antwortet nginx mit dem Fehler 404.error_page 404– zeigt dann die Fehlerseite aus Schritt 6.expires 7d– der Browser darf CSS, Skripte, Bilder und Schriften sieben Tage zwischenspeichern und lädt sie nicht bei jedem Seitenaufruf neu.
sudo nano /etc/nginx/sites-available/start.de
Steht aus einer anderen Anleitung schon Inhalt in der Datei, lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 80;
listen [::]:80;
server_name start.de www.start.de;
root /var/www/start.de/html;
index index.html;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
location / {
try_files $uri $uri/ =404;
}
error_page 404 /404.html;
location ~* \.(css|js|png|jpe?g|gif|svg|webp|ico|woff2?)$ {
expires 7d;
}
}
Mehr zum Aufbau der Konfiguration, zu späteren Änderungen und zur Fehlersuche steht in der Anleitung nginx-Konfiguration mit nano bearbeiten.
8. Website einschalten
nginx lädt nur Konfigurationen aus sites-enabled. Ein Link dorthin schaltet die Website ein. Die Datei selbst bleibt in sites-available, so kann man die Website später durch Löschen des Links wieder ausschalten.
sudo ln -s /etc/nginx/sites-available/start.de /etc/nginx/sites-enabled/start.de
9. Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
10. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Auf dem eigenen Rechner testen
11. start.de auf den eigenen Rechner umleiten
Normalerweise fragt der Rechner im Internet (DNS) nach, wohin start.de gehört. Ein Eintrag in /etc/hosts hat Vorrang und schickt die Anfragen stattdessen an den eigenen Rechner (127.0.0.1). So lässt sich die Website testen, bevor die Domain wirklich auf einen Server zeigt.
sudo nano /etc/hosts
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile diesen Eintrag ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
127.0.0.1 start.de www.start.de
Prüfen: Als Adresse erscheint 127.0.0.1.
getent hosts start.de
12. Startseite abrufen
curl http://start.de
Prüfen: Die Ausgabe enthält <h1>Willkommen auf start.de</h1>. Im Browser: http://start.de. Die Überschrift ist dort grün, das Stylesheet wird also mitgeladen.
13. Zwischenspeichern für CSS prüfen
-I zeigt nur die Kopfzeilen der Antwort.
curl -I http://start.de/style.css
Prüfen: In der Ausgabe stehen Content-Type: text/css und Cache-Control: max-age=604800 (sieben Tage in Sekunden).
14. Fehlerseite prüfen
Ruft eine Adresse auf, die es nicht gibt.
curl -i http://start.de/gibt-es-nicht
Prüfen: Die erste Zeile lautet HTTP/1.1 404 Not Found, darunter folgt der Inhalt der eigenen Fehlerseite mit Seite nicht gefunden.
15. Die Logdatei ansehen
Hier steht jede Anfrage an start.de mit Zeit, Adresse und Statuscode.
sudo tail -n 5 /var/log/nginx/start.de.access.log
Website ändern
Neue oder geänderte Dateien einfach in /var/www/start.de/html ablegen. nginx liefert sie sofort aus, ein Neuladen ist nicht nötig. Neu laden (Schritte 9 und 10) muss man nur nach Änderungen an /etc/nginx/sites-available/start.de.
Der Browser kann CSS- und Bilddateien bis zu sieben Tage aus seinem Zwischenspeicher nehmen. Nach einer Änderung an style.css im Browser deshalb mit Strg+Shift+R neu laden.
Optional: Im Internet veröffentlichen
Ein Zertifikat, das auch für alle Subdomains wie blog.start.de gilt, beschreibt die Anleitung Wildcard-Zertifikat mit Certbot.
Diese Schritte gehen nur auf einem Server, der aus dem Internet erreichbar ist, und nur mit einer Domain, die dir gehört.
1. Den Testeintrag entfernen
Der Eintrag aus Schritt 11 würde sonst weiter auf den eigenen Rechner zeigen.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
2. Die Domain auf den Server zeigen lassen
Beim Anbieter der Domain für start.de und www.start.de je einen A-Eintrag mit der öffentlichen IPv4-Adresse des Servers anlegen (bei IPv6 zusätzlich einen AAAA-Eintrag). Das geschieht in der Weboberfläche des Anbieters, nicht auf dem Server.
Prüfen: Nach einigen Minuten bis Stunden erscheint die IP-Adresse des Servers.
getent hosts start.de
3. Die Firewall für nginx öffnen
Nur nötig, wenn die Firewall ufw eingeschaltet ist. Nginx Full öffnet die Ports 80 (HTTP) und 443 (HTTPS).
sudo ufw allow 'Nginx Full'
4. Certbot installieren
Certbot holt kostenlose HTTPS-Zertifikate von Let's Encrypt. Das Zusatzpaket für nginx trägt die Zertifikate auch gleich in die Konfiguration ein.
sudo apt install certbot python3-certbot-nginx
5. Zertifikat holen und HTTPS einschalten
Certbot fragt beim ersten Aufruf nach einer E-Mail-Adresse und den Nutzungsbedingungen. Danach ergänzt es die Datei /etc/nginx/sites-available/start.de um HTTPS und leitet HTTP-Aufrufe auf HTTPS um.
sudo certbot --nginx -d start.de -d www.start.de
Prüfen: Die erste Zeile lautet HTTP/2 200 oder HTTP/1.1 200 OK.
curl -I https://start.de
Das Zertifikat gilt 90 Tage. Das Paket richtet eine automatische Verlängerung ein. Ob sie funktioniert, zeigt ein Probelauf:
sudo certbot renew --dry-run
Prüfen der Installation
nginx -v
sudo nginx -T 2>/dev/null | grep 'server_name start.de'
Prüfen: Der erste Befehl zeigt die Version von nginx, der zweite die Zeile server_name start.de www.start.de;.
Deinstallieren
nginx selbst bleibt installiert. Wie man nginx ganz entfernt, steht in der Anleitung nginx.
1. Website ausschalten
Löscht den Link in sites-enabled. nginx lädt die Konfiguration danach nicht mehr.
sudo rm /etc/nginx/sites-enabled/start.de
2. Konfiguration löschen
sudo rm /etc/nginx/sites-available/start.de
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. Dateien der Website löschen
Achtung: Alles in /var/www/start.de geht verloren. Vorher bei Bedarf sichern.
sudo rm -r /var/www/start.de
5. Logdateien löschen
sudo rm /var/log/nginx/start.de.*
6. Testeintrag aus /etc/hosts entfernen
Nur nötig, wenn der Eintrag aus Schritt 11 noch besteht. Danach ist die echte Website start.de wieder erreichbar.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Es erscheint nicht mehr 127.0.0.1.
getent hosts start.de
7. Zertifikat löschen
Nur nötig, wenn im optionalen Teil ein Zertifikat geholt wurde.
sudo certbot delete --cert-name start.de
Quellen und Lizenz
- Offizielle Dokumentation: https://nginx.org/en/docs/
- Lizenz: nginx steht unter der 2-Clause BSD License.
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.
nginx-Konfiguration mit nano bearbeiten
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Anleitung zeigt, wie man die Konfiguration einer statischen Website von Hand im Terminal-Editor GNU nano anlegt und ändert, am Beispiel start.de. Dabei geht es auch um den Aufbau einer nginx-Konfiguration und darum, Tippfehler anhand der Meldungen von nginx -t zu finden.
Voraussetzung: nginx ist installiert (siehe nginx), und die Dateien der Website liegen in /var/www/start.de/html. Wie man sie anlegt, zeigen die Schritte 2 bis 6 der Anleitung Statische Website mit nginx. Dort wird die fertige Konfiguration nur eingefügt. Hier geht es ausführlicher um ihren Aufbau, um spätere Änderungen und um die Fehlersuche.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von nano kennt.
sudo apt update
2. nano installieren
Unter Ubuntu ist nano meist schon vorhanden. Dann meldet apt das nur.
sudo apt install nano
Prüfen: Die Versionsnummer wird angezeigt, z. B. GNU Nano, Version 8.7.1.
nano --version
3. Vorhandene Konfiguration sichern
Nur nötig, wenn es die Datei /etc/nginx/sites-available/start.de schon gibt, z. B. aus der Anleitung Statische Website mit nginx. Die Kopie liegt bewusst außerhalb von sites-available und sites-enabled. So kann nginx sie nicht versehentlich als zweite Website laden. -p behält Rechte und Zeitstempel bei.
sudo cp -p /etc/nginx/sites-available/start.de /root/start.de.sicherung
Prüfen: Ohne vorhandene Datei meldet cp Datei oder Verzeichnis nicht gefunden. Das ist dann in Ordnung, es gibt nichts zu sichern.
So ist eine nginx-Konfiguration aufgebaut
Bevor du tippst, lohnt ein Blick auf die Schreibregeln. nginx ist dabei streng. Ein einziges fehlendes Zeichen verhindert, dass die neue Konfiguration geladen wird.
| Regel | Beispiel |
|---|---|
Jede Einstellung (Anweisung) steht meist in einer eigenen Zeile: vorne das Stichwort, dahinter ein oder mehrere Werte. Den Schluss bildet immer ein ; | root /var/www/start.de/html; |
Ein Block fasst Anweisungen in geschweiften Klammern zusammen. Jede { braucht eine passende }. Nach } steht kein ; | server { … } |
| Der server-Block beschreibt eine Website | server { listen 80; … } |
| Ein location-Block gilt nur für bestimmte Adressen innerhalb der Website | location / { … } |
Mit # beginnen Kommentare: Notizen für Menschen, die nginx beim Lesen einfach überspringt. Sie dürfen auch hinter einer Anweisung stehen | expires 7d; # eine Woche |
| Einrückungen sind für nginx egal, machen die Datei aber lesbar. Üblich sind vier Leerzeichen pro Ebene |
Konfiguration in nano anlegen
4. Datei in nano öffnen
sudo ist nötig, weil Dateien unter /etc/nginx dem Benutzer root gehören. -l zeigt links Zeilennummern an. Die braucht man später, weil nginx -t Fehler mit Zeilennummer meldet.
sudo nano -l /etc/nginx/sites-available/start.de
Prüfen: Unten steht Neue Datei, wenn es die Datei noch nicht gab. Sonst zeigt nano ihren Inhalt und meldet z. B. 28 Zeilen gelesen.
5. Vorhandenen Inhalt löschen
Nur nötig, wenn die Datei schon Text enthält. Drücke so oft Strg+K, bis die Datei leer ist. Jeder Druck schneidet eine Zeile aus. Die gesicherte Kopie aus Schritt 3 bleibt davon unberührt.
6. Konfiguration eingeben
Tippe den folgenden Text ab oder kopiere ihn und füge ihn im Terminal mit Strg+Umschalt+V ein. Die Bedeutung der Zeilen:
listen– Port 80, über IPv4 und IPv6server_name– der Block gilt nur für Anfragen anstart.deundwww.start.deroot– Ordner mit den Dateien der Website,index– Startdatei eines Ordnersaccess_log,error_log– eigene Logdateien für diese Websitelocation /– liefert die angefragte Datei aus, sonst Fehler 404error_page– eigene Fehlerseite statt der schlichten Seite von nginx- zweiter
location-Block – CSS, Skripte, Bilder und Schriften darf der Browser 7 Tage zwischenspeichern
# Statische Website start.de
server {
listen 80;
listen [::]:80;
server_name start.de www.start.de;
root /var/www/start.de/html;
index index.html;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
location / {
try_files $uri $uri/ =404;
}
error_page 404 /404.html;
location ~* \.(css|js|png|jpe?g|gif|svg|webp|ico|woff2?)$ {
expires 7d;
}
}
Beim Einfügen rückt nano manchmal zusätzlich ein. Das stört nginx nicht.
Prüfen: Links stehen die Zeilennummern 1 bis 22. Die letzte Zeile ist } ganz am Zeilenanfang.
7. Datei speichern
Drücke Strg+O. Unten fragt nano nach dem Dateinamen, der schon eingetragen ist. Bestätige mit Enter.
Prüfen: Unten erscheint 22 Zeilen geschrieben.
8. nano beenden
Drücke Strg+X. Fragt nano Geänderten Puffer speichern?, wurde nach dem Speichern noch etwas geändert. Dann mit J speichern oder mit N verwerfen.
9. Website einschalten
nginx lädt nur Dateien aus sites-enabled. Der Link schaltet die Website ein. Meldet der Befehl Die Datei existiert bereits, ist die Website schon eingeschaltet. Dann geht es mit dem nächsten Schritt weiter.
sudo ln -s /etc/nginx/sites-available/start.de /etc/nginx/sites-enabled/start.de
10. Konfiguration testen
nginx -t liest alle Konfigurationsdateien und prüft sie, ohne den laufenden Webserver zu verändern. Diesen Schritt nie auslassen: Bei einem Fehler würde nginx die Konfiguration beim Neuladen nicht übernehmen, und ein späterer Neustart würde scheitern.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Steht dort test failed, hilft der Abschnitt Fehler finden und beheben.
11. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
12. Website abrufen
Zum Test auf dem eigenen Rechner muss start.de auf 127.0.0.1 zeigen. Wie das geht, steht in Schritt 11 der Anleitung Statische Website mit nginx.
curl -I http://start.de/style.css
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK, weiter unten steht Cache-Control: max-age=604800 (7 Tage in Sekunden).
Konfiguration ändern
Als Beispiel werden zwei Einstellungen geändert: Der Browser soll CSS und Bilder 30 statt 7 Tage zwischenspeichern, und nginx soll CSS und JavaScript komprimiert übertragen.
13. Datei erneut öffnen
sudo nano -l /etc/nginx/sites-available/start.de
14. Die Stelle suchen
Drücke Strg+W, tippe expires und drücke Enter. Der Cursor springt zur ersten Fundstelle. Alt+W springt zur nächsten.
Prüfen: Der Cursor steht in der Zeile expires 7d;.
15. Wert ändern
Bewege den Cursor mit den Pfeiltasten auf die 7, lösche sie mit Entf und tippe 30. Die Zeile lautet danach expires 30d;. Das Semikolon am Ende muss stehen bleiben.
16. Komprimierung ergänzen
Ubuntu schaltet die Komprimierung in /etc/nginx/nginx.conf mit gzip on; ein, dort aber nur für HTML. Welche weiteren Dateitypen komprimiert werden, legt gzip_types fest. Die Einstellung gilt hier nur für diese Website.
Setze den Cursor an das Ende der Zeile index index.html;, drücke Enter und tippe:
gzip_types text/css application/javascript image/svg+xml;
Prüfen: Die neue Zeile steht direkt unter index index.html; und endet mit ;.
17. Speichern und beenden
Strg+O, Enter, dann Strg+X.
Prüfen: Vor dem Beenden meldet nano 23 Zeilen geschrieben, eine Zeile mehr als vorher.
18. Testen und neu laden
Erst testen, dann laden. Das && sorgt dafür, dass nginx nur neu geladen wird, wenn der Test erfolgreich war.
sudo nginx -t && sudo systemctl reload nginx
Prüfen: Die Ausgabe enthält test is successful.
19. Änderungen prüfen
-H 'Accept-Encoding: gzip' teilt nginx mit, dass curl komprimierte Antworten versteht, so wie es jeder Browser tut.
curl -sI -H 'Accept-Encoding: gzip' http://start.de/style.css | grep -iE 'cache-control|content-encoding'
Prüfen: Die Ausgabe lautet Cache-Control: max-age=2592000 (30 Tage in Sekunden) und Content-Encoding: gzip.
Fehler finden und beheben
20. Fehlermeldung lesen
Schlägt nginx -t fehl, nennt die Meldung die Art des Fehlers, die Datei und nach dem Doppelpunkt die Zeile, zum Beispiel:
nginx: [emerg] invalid number of arguments in "root" directive in /etc/nginx/sites-enabled/start.de:8
Die häufigsten Meldungen:
| Meldung | Ursache |
|---|---|
invalid number of arguments in "root" directive | Meist fehlt am Ende der Zeile davor das ;. nginx liest dann zwei Zeilen als eine Anweisung und meldet die Zeile, in der es das nächste ; findet. Im Beispiel steht der Fehler also in Zeile 7. |
unknown directive "roott" | Tippfehler im Namen einer Anweisung |
unexpected end of file, expecting "}" | Eine } fehlt. nginx bemerkt das erst am Dateiende. |
unexpected "}" | Eine } zu viel |
conflicting server name "start.de" (Warnung) | Zwei Dateien in sites-enabled beanspruchen dieselbe Domain, z. B. wenn eine Kopie der Konfiguration dort liegt |
Der Pfad in der Meldung zeigt meist auf sites-enabled. Das ist nur der Link. Bearbeitet wird immer die Datei in sites-available.
21. Direkt zur gemeldeten Zeile springen
+8 öffnet die Datei und setzt den Cursor gleich in Zeile 8. Ersetze die Zahl durch die Zeile aus deiner Meldung. Bei invalid number of arguments schau auch in die Zeile darüber. In einer bereits geöffneten Datei springt Strg+_ zu einer Zeilennummer.
sudo nano -l +8 /etc/nginx/sites-available/start.de
Korrigiere den Fehler, speichere mit Strg+O, Enter, beende mit Strg+X und teste erneut mit sudo nginx -t.
22. Optional: Fehler zum Üben einbauen
Öffne die Datei wie in Schritt 13, lösche am Ende der Zeile root /var/www/start.de/html; das ;, speichere und teste mit sudo nginx -t. Die Meldung nennt die Zeile unter der geänderten Zeile. Setze das ; wieder ein, speichere und teste erneut, bis test is successful erscheint. Solange du nicht neu lädst, läuft nginx mit der alten, fehlerfreien Konfiguration einfach weiter.
Nützliche Tastenkürzel in nano
| Tasten | Wirkung |
|---|---|
| Strg+O, Enter | Speichern |
| Strg+X | Beenden |
| Strg+W | Suchen, Alt+W springt zum nächsten Treffer |
| Strg+_ | Zu einer Zeilennummer springen |
| Strg+K / Strg+U | Zeile ausschneiden / wieder einfügen, auch an anderer Stelle |
| Alt+U / Alt+E | Rückgängig / Wiederherstellen |
| Alt+3 | Aktuelle Zeile mit # aus- oder wieder einkommentieren. Praktisch, um eine Einstellung vorübergehend abzuschalten |
| Alt+N | Zeilennummern ein- und ausblenden |
| Strg+G | Hilfe mit allen Tastenkürzeln |
Prüfen der Installation
nano --version
sudo nginx -T 2>/dev/null | grep -E 'expires|gzip_types'
Prüfen: Der erste Befehl zeigt die Version von nano, der zweite die Zeilen gzip_types … und expires 30d; aus der Konfiguration.
Rückgängig machen und deinstallieren
1. Alte Konfiguration zurückholen
Nur möglich, wenn in Schritt 3 eine Sicherung angelegt wurde. Überschreibt die Datei mit dem Stand vor dieser Anleitung.
sudo cp -p /root/start.de.sicherung /etc/nginx/sites-available/start.de
2. Oder: Website ganz entfernen
Gab es vorher keine Konfiguration, entfernst du Link und Datei. Die Dateien der Website und weitere Reste entfernt der Abschnitt „Deinstallieren“ der Anleitung Statische Website mit nginx.
sudo rm /etc/nginx/sites-enabled/start.de /etc/nginx/sites-available/start.de
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. Sicherung löschen
sudo rm -f /root/start.de.sicherung
5. nano entfernen (nicht empfohlen)
nano ist unter Ubuntu der vorgegebene Editor, etwa für sudo visudo oder crontab -e. Entferne es nur, wenn ein anderer Editor eingerichtet ist. Die genauen Schritte stehen in der Anleitung GNU nano.
Prüfen: Nach Schritt 3 meldet sudo nginx -t wieder test is successful.
Quellen und Lizenz
- Offizielle Dokumentation: https://nginx.org/en/docs/
- Lizenz: nginx steht unter der 2-Clause BSD License.
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.
Drupal mit nginx unter eigener Domain
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Anleitung macht eine vorhandene Drupal-Installation unter einer eigenen Domain erreichbar, hier am Beispiel start.de. nginx nimmt die Anfragen auf Port 80 an, führt PHP über PHP-FPM aus und leitet www.start.de auf start.de um.
Voraussetzung: Drupal ist nach der Anleitung Drupal vollständig eingerichtet (Dateien in /var/www/drupal, Datenbank installiert, Test unter http://localhost:8090 erfolgreich).
Zum Beispiel
start.de: Die Domain ist nur ein Beispiel. Ersetzestart.dein allen Befehlen durch deine eigene Domain. Zum Ausprobieren auf dem eigenen Rechner leitet Schritt 9start.deauf den eigenen Rechner um. Die echte Website unter diesem Namen ist dann auf diesem Rechner nicht mehr erreichbar, bis der Eintrag wieder entfernt ist.
nginx einrichten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von nginx und PHP-FPM kennt, falls sie noch aktualisiert werden müssen.
sudo apt update
2. Drupal-Regeln als Baustein anlegen
Die Regeln, die Drupal braucht, kommen in eine eigene Datei unter snippets. Der server-Block in Schritt 3 bindet sie mit einer einzigen include-Zeile ein. So lassen sich die Regeln auch für weitere Drupal-Websites wiederverwenden.
nginx prüft Blöcke mit regulären Ausdrücken (~) von oben nach unten und nimmt den ersten Treffer. Deshalb stehen die Sperren vor dem Block, der PHP ausführt:
- Sperren: versteckte Dateien wie
.git, interne Drupal-Dateien wie.ymlund.twigsowie PHP-Dateien im Upload-Ordnersites/…/files. Eine hochgeladene Datei lässt sich so nie als Programm starten. - PHP: Alle
.php-Dateien gehen an PHP-FPM, auch mit angehängtem Pfad wie/update.php/selection. - Bilder, CSS, JavaScript: Der Browser darf sie 30 Tage zwischenspeichern. Fehlt eine Datei, erzeugt Drupal sie, z. B. verkleinerte Bilder.
- Alles andere: Adressen wie
/node/1beantwortet Drupal überindex.php.
sudo nano /etc/nginx/snippets/drupal.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Versteckte Dateien und Ordner sperren, außer .well-known (für HTTPS-Zertifikate)
location ~ /\.(?!well-known/) {
return 403;
}
# Interne Drupal-Dateien sperren
location ~* \.(engine|inc|install|module|profile|theme|twig|yml|yaml|sql|lock|log|md)$ {
return 403;
}
# Hochgeladene Dateien nie als PHP ausführen
location ~ ^/sites/[^/]+/files/.*\.php$ {
return 403;
}
# PHP über PHP-FPM ausführen
location ~ \.php(/|$) {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
# Statische Dateien zwischenspeichern, fehlende von Drupal erzeugen lassen
location ~* \.(css|js|png|jpe?g|gif|ico|svg|webp|woff2?)$ {
try_files $uri /index.php?$query_string;
expires 30d;
access_log off;
}
# Alle übrigen Adressen beantwortet Drupal
location / {
try_files $uri $uri/ /index.php?$query_string;
}
3. Konfiguration für start.de anlegen
Die Datei enthält zwei server-Blöcke:
- Der erste beantwortet nur Anfragen an
www.start.deund leitet sie dauerhaft (Status301) aufstart.deum. So gibt es jede Seite nur unter einer Adresse, was auch Suchmaschinen bevorzugen.$schemebehälthttpoderhttpsbei,$request_uriden Pfad. - Der zweite ist die eigentliche Website.
rootzeigt auf den Ordnerwebder Drupal-Installation.client_max_body_sizeerlaubt Uploads bis 20 MB, ohne diese Zeile lehnt nginx alles über 1 MB ab. Die eigenen Logdateien halten die Einträge dieser Website getrennt.
sudo nano /etc/nginx/sites-available/start.de
Steht aus einer anderen Anleitung schon Inhalt in der Datei, lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 80;
listen [::]:80;
server_name www.start.de;
return 301 $scheme://start.de$request_uri;
}
server {
listen 80;
listen [::]:80;
server_name start.de;
root /var/www/drupal/web;
index index.php;
client_max_body_size 20m;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
include snippets/drupal.conf;
}
4. Website einschalten
nginx lädt nur Konfigurationen aus sites-enabled. Der Link schaltet die Website ein, die Datei selbst bleibt in sites-available.
sudo ln -s /etc/nginx/sites-available/start.de /etc/nginx/sites-enabled/start.de
5. Konfiguration testen
Findet Tippfehler in beiden neuen Dateien, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
6. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Drupal einstellen
7. Erlaubte Hostnamen festlegen
Drupal beantwortet sonst Anfragen mit jedem beliebigen Hostnamen. Das nutzen Angreifer, um gefälschte Links zu erzeugen, etwa in E-Mails zum Zurücksetzen von Passwörtern. trusted_host_patterns legt fest, unter welchen Namen die Website antworten darf. localhost bleibt erlaubt, damit der Zugang über http://localhost:8090 aus der Drupal-Anleitung weiter funktioniert. Die Punkte sind mit \ geschützt, weil die Angaben reguläre Ausdrücke sind.
Die Datei settings.php ist nach der Installation schreibgeschützt. Mit sudo darf nano sie trotzdem speichern. Die erste Zeile des neuen Abschnitts ist ein Kommentar, an dem er sich beim Deinstallieren wiederfinden lässt.
sudo nano /var/www/drupal/web/sites/default/settings.php
Springe mit Strg+Ende ans Ende der Datei, füge nach einer Leerzeile diesen Abschnitt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
// start.de: erlaubte Hostnamen
$settings['trusted_host_patterns'] = [
'^start\.de$',
'^www\.start\.de$',
'^localhost$',
];
Prüfen: PHP meldet No syntax errors detected.
sudo php -l /var/www/drupal/web/sites/default/settings.php
8. Drupal-Zwischenspeicher leeren
Drupal liest settings.php zwar bei jeder Anfrage neu, hat aber fertige Seiten im Zwischenspeicher. Nach dem Leeren entstehen alle Seiten neu.
sudo -u www-data /var/www/drupal/vendor/bin/drush cache:rebuild --root=/var/www/drupal/web
Prüfen: Die Ausgabe lautet [success] Cache rebuild complete.
Auf dem eigenen Rechner testen
9. start.de auf den eigenen Rechner umleiten
Ein Eintrag in /etc/hosts hat Vorrang vor dem DNS im Internet und schickt die Anfragen an den eigenen Rechner. So lässt sich die Website testen, bevor die Domain auf einen Server zeigt.
sudo nano /etc/hosts
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile diesen Eintrag ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
127.0.0.1 start.de www.start.de
Prüfen: Als Adresse erscheint 127.0.0.1.
getent hosts start.de
10. Startseite abrufen
-I zeigt nur die Kopfzeilen der Antwort.
curl -I http://start.de/
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK, weiter unten steht X-Generator: Drupal. Im Browser: http://start.de.
11. Anmeldeseite abrufen
Eine Adresse, die es nicht als Datei gibt. nginx muss sie an Drupal weiterreichen.
curl -sI http://start.de/user/login | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 200 OK. Im Browser kannst du dich unter http://start.de/user/login mit dem Administrator-Konto aus der Drupal-Anleitung anmelden.
12. Umleitung von www prüfen
curl -sI http://www.start.de/user/login | grep -E '^HTTP|^Location'
Prüfen: Die Ausgabe lautet HTTP/1.1 301 Moved Permanently und Location: http://start.de/user/login.
13. Sperren prüfen
Stichprobe, ob interne Dateien wirklich gesperrt sind. core.services.yml ist eine Einstellungsdatei aus dem Drupal-Kern.
curl -sI http://start.de/core/core.services.yml | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 403 Forbidden.
14. Erlaubte Hostnamen prüfen
Schickt eine Anfrage mit einem fremden Hostnamen an den Zugang auf Port 8090 aus der Drupal-Anleitung. Über Port 80 geht das nicht, weil nginx dort nur die Namen start.de und www.start.de an Drupal weitergibt.
curl -s -H 'Host: boese.example' http://127.0.0.1:8090/ | head -n 1
Prüfen: Drupal antwortet mit The provided host name is not valid for this server. Ohne Schritt 7 käme stattdessen die normale Startseite.
15. Logdatei ansehen
Hier steht jede Anfrage an start.de mit Zeit, Adresse und Statuscode.
sudo tail -n 5 /var/log/nginx/start.de.access.log
Optional: Im Internet veröffentlichen
Diese Schritte gehen nur auf einem Server, der aus dem Internet erreichbar ist, und nur mit einer Domain, die dir gehört.
1. Testeintrag entfernen
Sonst zeigt start.de auf diesem Rechner weiter auf 127.0.0.1.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
2. Domain auf den Server zeigen lassen
In der Weboberfläche des Domain-Anbieters für start.de und www.start.de je einen A-Eintrag mit der öffentlichen IPv4-Adresse des Servers anlegen, bei IPv6 zusätzlich einen AAAA-Eintrag.
Prüfen: Nach einigen Minuten bis Stunden erscheint die Adresse des Servers.
getent hosts start.de
3. Firewall öffnen
Nur nötig, wenn ufw eingeschaltet ist. Das Profil Nginx Full öffnet Port 80 und 443.
sudo ufw allow 'Nginx Full'
4. Certbot installieren
Certbot besorgt kostenlose Zertifikate von Let's Encrypt. Das Zusatzpaket trägt sie direkt in die nginx-Konfiguration ein.
sudo apt install certbot python3-certbot-nginx
5. HTTPS einschalten
Certbot fragt beim ersten Aufruf nach einer E-Mail-Adresse und den Nutzungsbedingungen. Danach ergänzt es beide server-Blöcke in /etc/nginx/sites-available/start.de um HTTPS und leitet HTTP auf HTTPS um. Drupal erkennt HTTPS selbst und erzeugt danach Links mit https://.
sudo certbot --nginx -d start.de -d www.start.de
Prüfen: Die erste Zeile lautet HTTP/2 200 oder HTTP/1.1 200 OK.
curl -sI https://start.de/ | head -n 1
Das Zertifikat gilt 90 Tage und wird automatisch verlängert. Einen Probelauf der Verlängerung startet dieser Befehl:
sudo certbot renew --dry-run
Prüfen der Installation
nginx -v
sudo nginx -T 2>/dev/null | grep 'include snippets/drupal.conf'
Prüfen: Der erste Befehl zeigt die Version von nginx, der zweite die include-Zeile aus Schritt 3.
Deinstallieren
Drupal selbst bleibt erhalten und ist weiter unter http://localhost:8090 erreichbar. Wie man Drupal ganz entfernt, steht in der Anleitung Drupal.
1. Website ausschalten
Löscht den Link in sites-enabled.
sudo rm /etc/nginx/sites-enabled/start.de
2. Konfiguration und Baustein löschen
sudo rm /etc/nginx/sites-available/start.de /etc/nginx/snippets/drupal.conf
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. Erlaubte Hostnamen aus Drupal entfernen
Löscht den Abschnitt aus Schritt 7, vom Kommentar bis zur schließenden Klammer ];.
sudo nano /var/www/drupal/web/sites/default/settings.php
Suche mit Strg+W nach start.de: erlaubte Hostnamen und drücke Enter. Der Cursor steht in der Kommentarzeile. Drücke sechsmal Strg+K. Das entfernt den Kommentar, die Zeile mit trusted_host_patterns, die drei Namen und die schließende Klammer ];. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe ist leer, und PHP meldet keinen Syntaxfehler.
sudo grep -n "start" /var/www/drupal/web/sites/default/settings.php
sudo php -l /var/www/drupal/web/sites/default/settings.php
5. Logdateien löschen
sudo rm /var/log/nginx/start.de.*
6. Testeintrag aus /etc/hosts entfernen
Nur nötig, wenn der Eintrag aus Schritt 9 noch besteht.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Es erscheint nicht mehr 127.0.0.1.
getent hosts start.de
7. Zertifikat löschen
Nur nötig, wenn im optionalen Teil ein Zertifikat geholt wurde.
sudo certbot delete --cert-name start.de
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.
MediaWiki mit nginx unter eigener Domain
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Anleitung macht ein vorhandenes MediaWiki unter einer eigenen Domain erreichbar, hier am Beispiel start.de. nginx nimmt die Anfragen auf Port 80 an, führt PHP über PHP-FPM aus und sorgt für kurze Adressen wie start.de/Hauptseite. Aufrufe von www.start.de leitet es auf start.de um.
Voraussetzung: MediaWiki ist nach der Anleitung MediaWiki vollständig eingerichtet (Dateien in /var/www/mediawiki, kurze Adressen eingeschaltet, Test unter http://localhost:8085 erfolgreich).
Zum Beispiel
start.de: Die Domain ist nur ein Beispiel. Ersetzestart.dein allen Befehlen durch deine eigene Domain. Zum Ausprobieren auf dem eigenen Rechner leitet Schritt 10start.deauf den eigenen Rechner um. Die echte Website unter diesem Namen ist dann auf diesem Rechner nicht mehr erreichbar, bis der Eintrag wieder entfernt ist.
nginx einrichten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von nginx und PHP-FPM kennt, falls sie noch aktualisiert werden müssen.
sudo apt update
2. MediaWiki-Regeln als Baustein anlegen
Die Regeln, die MediaWiki braucht, kommen in eine eigene Datei unter snippets. Der server-Block in Schritt 3 bindet sie mit einer include-Zeile ein.
nginx prüft Blöcke mit regulären Ausdrücken (~) von oben nach unten und nimmt den ersten Treffer. Deshalb stehen die Sperren vor dem Block, der PHP ausführt:
- Sperren: versteckte Dateien wie
.git, die internen Ordner von MediaWiki (z. B.includes,maintenance,vendor) und Dateien wiecomposer.json. Aus diesen Ordnern ruft der Browser nie etwas ab, sie enthalten nur Programmcode und Werkzeuge. - Upload-Ordner
images:^~sorgt dafür, dass für Adressen unter/images/keine der Regeln mit regulären Ausdrücken gilt, also auch nicht der PHP-Block. Der innere Block lehnt PHP-Dateien dort ausdrücklich ab. So lässt sich eine hochgeladene Datei nie als Programm starten. - PHP:
index.php,load.php(liefert CSS und JavaScript) und die übrigen Einstiegsdateien von MediaWiki gehen an PHP-FPM. - Bilder, CSS, JavaScript: Der Browser darf sie 7 Tage zwischenspeichern. Gibt es eine solche Datei nicht, ist die Adresse eine Wiki-Seite, deren Name nur auf
.pngo. Ä. endet, z. B. die Dateiseite/Datei:Bild.png. Dann ist MediaWiki zuständig. - Kurze Adressen:
/Hauptseitegibt es nicht als Datei.try_filesübergibt solche Anfragen anindex.php, hängt aber nichts an. nginx reicht die ursprüngliche Adresse alsREQUEST_URIan PHP weiter. MediaWiki vergleicht sie mit$wgArticlePath = "/$1"aus der Anleitung MediaWiki und erkennt so, dass die SeiteHauptseitegemeint ist. Auch Seitennamen mit Sonderzeichen wie&kommen so unverändert an.
sudo nano /etc/nginx/snippets/mediawiki.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Versteckte Dateien und Ordner sperren, außer .well-known (für HTTPS-Zertifikate)
location ~ /\.(?!well-known/) {
return 403;
}
# Interne Ordner und Dateien von MediaWiki sperren
location ~ ^/(cache|includes|languages|maintenance|serialized|tests|vendor)/ {
return 403;
}
location ~ \.(lock|json|yml|yaml|md)$ {
return 403;
}
# Upload-Ordner: Dateien ausliefern, aber nie als PHP ausführen
location ^~ /images/ {
location ~ \.php$ {
return 403;
}
}
# PHP über PHP-FPM ausführen
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
# Statische Dateien eine Woche im Browser zwischenspeichern.
# Gibt es die Datei nicht, ist es eine Wiki-Seite wie /Datei:Bild.png
location ~* \.(js|css|png|jpe?g|gif|ico|svg|webp|woff2?)$ {
try_files $uri /index.php?$args;
expires 7d;
access_log off;
}
# Kurze Adressen: Was es nicht als Datei gibt, bekommt index.php.
# MediaWiki liest den Seitennamen selbst aus der ursprünglichen Adresse.
location / {
try_files $uri $uri/ /index.php?$args;
}
3. Konfiguration für start.de anlegen
Die Datei enthält zwei server-Blöcke:
- Der erste beantwortet nur Anfragen an
www.start.deund leitet sie dauerhaft (Status301) aufstart.deum.$schemebehälthttpoderhttpsbei,$request_uriden Pfad. - Der zweite ist das Wiki.
rootzeigt auf den MediaWiki-Ordner.client_max_body_sizeerlaubt hochgeladene Dateien bis 20 MB, ohne diese Zeile lehnt nginx alles über 1 MB ab. Eigene Logdateien halten die Einträge des Wikis getrennt.
sudo nano /etc/nginx/sites-available/start.de
Steht aus einer anderen Anleitung schon Inhalt in der Datei, lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 80;
listen [::]:80;
server_name www.start.de;
return 301 $scheme://start.de$request_uri;
}
server {
listen 80;
listen [::]:80;
server_name start.de;
root /var/www/mediawiki;
index index.php;
client_max_body_size 20m;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
include snippets/mediawiki.conf;
}
Achtung: Gibt es /etc/nginx/sites-available/start.de schon, z. B. aus der Anleitung Statische Website mit nginx oder Drupal mit nginx unter eigener Domain, ersetzt du damit ihren Inhalt und die bisherige Website ist unter start.de nicht mehr erreichbar. Eine Domain kann immer nur zu einer Website gehören.
4. Website einschalten
nginx lädt nur Konfigurationen aus sites-enabled. Der Link schaltet die Website ein. Meldet der Befehl File exists, ist die Website schon eingeschaltet.
sudo ln -s /etc/nginx/sites-available/start.de /etc/nginx/sites-enabled/start.de
5. Konfiguration testen
Findet Tippfehler in beiden neuen Dateien, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
6. nginx neu laden
Übernimmt die neue Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
MediaWiki einstellen
7. Einstellungsdatei sichern
Die nächsten Schritte ändern LocalSettings.php. Die Kopie erlaubt, jederzeit zum alten Stand zurückzukehren. -p übernimmt Besitzer und Rechte, damit auch die Kopie das Datenbank-Passwort schützt.
sudo cp -p /var/www/mediawiki/LocalSettings.php /var/www/mediawiki/LocalSettings.php.vor-start.de
8. Adresse des Wikis ändern
MediaWiki baut vollständige Adressen aus $wgServer zusammen, z. B. für die Weiterleitung von / auf die Hauptseite, für Links in E-Mails und für die Angabe der „kanonischen“ Adresse an Suchmaschinen. Bei der Installation wurde dort http://localhost:8085 eingetragen, jetzt kommt http://start.de hinein.
Die Datei gehört nach der Anleitung MediaWiki deinem Benutzer, deshalb ist sudo nicht nötig. nano schreibt beim Speichern in die vorhandene Datei, Gruppe www-data und Rechte bleiben erhalten.
nano /var/www/mediawiki/LocalSettings.php
Suche mit Strg+W nach $wgServer und drücke Enter. Die Zeile lautet $wgServer = "http://localhost:8085";. Ändere die gefundene Zeile so, dass sie lautet:
$wgServer = "http://start.de";
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe lautet $wgServer = "http://start.de";, und die Gruppe ist weiterhin www-data.
grep '^\$wgServer' /var/www/mediawiki/LocalSettings.php
ls -l /var/www/mediawiki/LocalSettings.php
Das Wiki ist danach auch weiterhin über http://localhost:8085 erreichbar. Die Weiterleitung von / und alle vollständigen Links führen aber jetzt zu start.de.
9. Prüfen, ob die Datei gültig ist
Ein Tippfehler in LocalSettings.php legt das ganze Wiki lahm. MediaWiki leert seinen Seitenzwischenspeicher von selbst, sobald sich die Datei ändert.
sudo php -l /var/www/mediawiki/LocalSettings.php
Prüfen: Die Ausgabe lautet No syntax errors detected in /var/www/mediawiki/LocalSettings.php.
Auf dem eigenen Rechner testen
10. start.de auf den eigenen Rechner umleiten
Ein Eintrag in /etc/hosts hat Vorrang vor dem DNS im Internet und schickt die Anfragen an den eigenen Rechner. So lässt sich das Wiki testen, bevor die Domain auf einen Server zeigt. Steht der Eintrag schon aus einer anderen Anleitung in der Datei, diesen Schritt überspringen.
sudo nano /etc/hosts
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile diesen Eintrag ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
127.0.0.1 start.de www.start.de
Prüfen: Als Adresse erscheint 127.0.0.1.
getent hosts start.de
11. Adresse des Wikis prüfen
Die Spezialseite „Zufällige Seite“ antwortet immer mit einer Weiterleitung auf eine vollständige Adresse. Daran lässt sich ablesen, ob MediaWiki die neue Adresse aus Schritt 8 verwendet. %C3%A4 ist die Schreibweise für ä in einer Adresse.
curl -sI http://start.de/Spezial:Zuf%C3%A4llige_Seite | grep -E '^HTTP|^Location'
Prüfen: Die erste Zeile enthält 302, und Location beginnt mit http://start.de/, z. B. Location: http://start.de/Hauptseite. Steht dort noch localhost:8085, hat Schritt 8 nicht gegriffen.
12. Hauptseite abrufen
Die kurze Adresse gibt es nicht als Datei. nginx muss sie an MediaWiki weiterreichen.
curl -sI http://start.de/Hauptseite | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 200 OK. Im Browser zeigt http://start.de die Hauptseite im Vector-Design. Oben rechts kannst du dich mit WikiAdmin anmelden.
13. Umleitung von www prüfen
curl -sI http://www.start.de/Hauptseite | grep -E '^HTTP|^Location'
Prüfen: Die Ausgabe lautet HTTP/1.1 301 Moved Permanently und Location: http://start.de/Hauptseite.
14. Sperren prüfen
Stichprobe für zwei gesperrte Bereiche: den Git-Ordner, der sonst die Versionsgeschichte preisgeben würde, und composer.json.
curl -sI http://start.de/.git/config | head -n 1
curl -sI http://start.de/composer.json | head -n 1
Prüfen: Beide Male lautet die Ausgabe HTTP/1.1 403 Forbidden.
15. Logdatei ansehen
Hier steht jede Anfrage an start.de mit Zeit, Adresse und Statuscode.
sudo tail -n 5 /var/log/nginx/start.de.access.log
Optional: Im Internet veröffentlichen
Diese Schritte gehen nur auf einem Server, der aus dem Internet erreichbar ist, und nur mit einer Domain, die dir gehört.
1. Testeintrag entfernen
Sonst zeigt start.de auf diesem Rechner weiter auf 127.0.0.1.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
2. Domain auf den Server zeigen lassen
In der Weboberfläche des Domain-Anbieters für start.de und www.start.de je einen A-Eintrag mit der öffentlichen IPv4-Adresse des Servers anlegen, bei IPv6 zusätzlich einen AAAA-Eintrag.
Prüfen: Nach einigen Minuten bis Stunden erscheint die Adresse des Servers.
getent hosts start.de
3. Firewall öffnen
Nur nötig, wenn ufw eingeschaltet ist. Das Profil Nginx Full öffnet Port 80 und 443.
sudo ufw allow 'Nginx Full'
4. Certbot installieren
Certbot besorgt kostenlose Zertifikate von Let's Encrypt und trägt sie direkt in die nginx-Konfiguration ein.
sudo apt install certbot python3-certbot-nginx
5. HTTPS einschalten
Certbot fragt beim ersten Aufruf nach einer E-Mail-Adresse und den Nutzungsbedingungen. Danach ergänzt es beide server-Blöcke um HTTPS und leitet HTTP auf HTTPS um.
sudo certbot --nginx -d start.de -d www.start.de
6. MediaWiki auf HTTPS umstellen
Anders als nginx weiß MediaWiki nichts vom neuen Zertifikat. Ohne diesen Schritt würden Weiterleitungen und vollständige Links weiter auf http:// zeigen.
nano /var/www/mediawiki/LocalSettings.php
Suche mit Strg+W nach $wgServer und drücke Enter. Ändere die gefundene Zeile so, dass sie lautet:
$wgServer = "https://start.de";
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Weiterleitung beginnt jetzt mit https://start.de/.
curl -sI https://start.de/Spezial:Zuf%C3%A4llige_Seite | grep -i '^location'
Das Zertifikat gilt 90 Tage und wird automatisch verlängert. Einen Probelauf der Verlängerung startet dieser Befehl:
sudo certbot renew --dry-run
Prüfen der Installation
nginx -v
sudo nginx -T 2>/dev/null | grep 'include snippets/mediawiki.conf'
grep '^\$wgServer' /var/www/mediawiki/LocalSettings.php
Prüfen: Der erste Befehl zeigt die Version von nginx, der zweite die include-Zeile aus Schritt 3, der dritte die Adresse start.de.
Deinstallieren
MediaWiki selbst bleibt erhalten und ist danach wieder wie vorher unter http://localhost:8085 erreichbar. Wie man MediaWiki ganz entfernt, steht in der Anleitung MediaWiki.
1. Website ausschalten
Löscht den Link in sites-enabled.
sudo rm /etc/nginx/sites-enabled/start.de
2. Konfiguration und Baustein löschen
sudo rm /etc/nginx/sites-available/start.de /etc/nginx/snippets/mediawiki.conf
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. Alte Einstellungsdatei zurückholen
Ersetzt LocalSettings.php durch die Sicherung aus Schritt 7. Damit steht dort wieder http://localhost:8085. Hast du seit Schritt 7 weitere Einstellungen geändert, trage sie danach erneut ein. Alternativ änderst du nur die Zeile mit $wgServer von Hand zurück.
sudo mv /var/www/mediawiki/LocalSettings.php.vor-start.de /var/www/mediawiki/LocalSettings.php
Prüfen: Die Ausgabe lautet $wgServer = "http://localhost:8085";.
grep '^\$wgServer' /var/www/mediawiki/LocalSettings.php
5. Logdateien löschen
sudo rm /var/log/nginx/start.de.*
6. Testeintrag aus /etc/hosts entfernen
Nur nötig, wenn der Eintrag aus Schritt 10 noch besteht und keine andere Anleitung ihn braucht.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Es erscheint nicht mehr 127.0.0.1.
getent hosts start.de
7. Zertifikat löschen
Nur nötig, wenn im optionalen Teil ein Zertifikat geholt wurde.
sudo certbot delete --cert-name start.de
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.
WordPress mit nginx unter eigener Domain
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
WordPress ist das meistgenutzte Programm für Websites und Blogs. Beiträge, Seiten, Bilder, Designs und Erweiterungen verwaltet man bequem im Browser. Diese Anleitung installiert WordPress mit nginx, PHP-FPM und MariaDB und macht es unter einer eigenen Domain erreichbar, hier am Beispiel start.de.
Vorbemerkungen
- Voraussetzung: nginx und PHP mit PHP-FPM sind nach den jeweiligen Anleitungen installiert und laufen.
- Warum nicht das apt-Paket? Ubuntu 26.04 enthält zwar ein Paket
wordpress, aber nur in Version 6.7 aus dem Bereich „universe“, für den Ubuntu keine Sicherheitsupdates zusagt. Aktuell ist WordPress 7.1. Weil eine Website aus dem Internet erreichbar ist, installiert diese Anleitung das offizielle deutsche Paket von wordpress.org. WordPress hält sich danach selbst mit Sicherheitsupdates aktuell. - Datenbank: WordPress braucht MySQL oder MariaDB. PostgreSQL wird nicht unterstützt. MariaDB kommt aus den Ubuntu-Paketquellen.
- Version: Die Befehle verwenden WordPress 7.1.2. Ist eine neuere Version erschienen, ersetzt du die Versionsnummer in den Schritten 8 und 9. Die aktuelle Version steht auf https://de.wordpress.org/download/.
- Passwörter:
geheimes_passwortist ein Beispiel. Ersetze es durch ein eigenes Passwort.
Zum Beispiel
start.de: Die Domain ist nur ein Beispiel. Ersetzestart.dein allen Befehlen durch deine eigene Domain. Zum Ausprobieren auf dem eigenen Rechner leitet Schritt 19start.deauf den eigenen Rechner um. Die echte Website unter diesem Namen ist dann auf diesem Rechner nicht mehr erreichbar, bis der Eintrag wieder entfernt ist.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von MariaDB und den PHP-Modulen kennt.
sudo apt update
2. MariaDB installieren
Installiert den Datenbankserver. Der Dienst startet automatisch.
sudo apt install mariadb-server
Prüfen: Die Ausgabe lautet active.
systemctl is-active mariadb
3. PHP-Module für WordPress installieren
php-mysql– Verbindung zu MariaDBphp-gdundphp-imagick– verkleinern hochgeladene Bilder und erzeugen Vorschaubilderphp-curl– Anfragen an andere Server, z. B. für Updatesphp-intl,php-mbstring– Umgang mit Sprachen und Sonderzeichenphp-xml,php-zip– lesen XML-Daten und entpacken Updates, Designs und Erweiterungen
sudo apt install php-mysql php-gd php-imagick php-curl php-intl php-mbstring php-xml php-zip
4. Größere Uploads erlauben
PHP nimmt ohne weitere Einstellung nur Dateien bis 2 MB an. Für Fotos ist das zu wenig. Die Datei im Ordner conf.d hebt die Grenze für PHP-FPM auf 64 MB an. post_max_size muss mindestens so groß sein, weil die Datei im Formular mitgeschickt wird.
sudo nano /etc/php/8.5/fpm/conf.d/99-wordpress.ini
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
upload_max_filesize = 64M
post_max_size = 64M
5. PHP-FPM neu starten
PHP-FPM lädt neue Module und Einstellungen erst nach einem Neustart.
sudo systemctl restart php8.5-fpm
Prüfen: Die Liste enthält mysqli und imagick.
php -m | grep -E 'mysqli|imagick'
Datenbank anlegen
6. Datenbank erstellen
Legt die leere Datenbank wordpress an. utf8mb4 speichert alle Zeichen, auch Emojis. Unter Ubuntu meldet sich sudo mariadb ohne Passwort als Datenbank-Administrator an, weil MariaDB den Ubuntu-Benutzer root erkennt.
sudo mariadb -e "CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
7. Datenbankbenutzer anlegen
WordPress bekommt einen eigenen Benutzer, der nur auf diese eine Datenbank zugreifen darf. So kann eine Lücke in WordPress keine anderen Datenbanken gefährden.
sudo mariadb -e "CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'geheimes_passwort'; GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost';"
Prüfen: Die Anmeldung mit dem neuen Benutzer klappt, und die Liste enthält wordpress.
mariadb -u wpuser -p'geheimes_passwort' -e "SHOW DATABASES;"
WordPress herunterladen
8. In den Download-Ordner wechseln
Das Paket wird hier abgelegt und nach dem Entpacken gelöscht.
cd ~/Downloads
9. Paket und Prüfsumme herunterladen
Lädt die deutsche Ausgabe von WordPress (etwa 43 MB) und die zugehörige SHA-1-Prüfsumme.
wget https://de.wordpress.org/wordpress-7.1.2-de_DE.tar.gz https://de.wordpress.org/wordpress-7.1.2-de_DE.tar.gz.sha1
10. Paket prüfen
Die .sha1-Datei enthält nur die Prüfsumme. sha1sum -c erwartet dahinter noch den Dateinamen, den echo ergänzt. So erkennst du, ob die Datei vollständig und unverändert angekommen ist.
echo "$(cat wordpress-7.1.2-de_DE.tar.gz.sha1) wordpress-7.1.2-de_DE.tar.gz" | sha1sum -c
Prüfen: Die Ausgabe lautet wordpress-7.1.2-de_DE.tar.gz: OK. Bei FEHLSCHLAG die Datei löschen und neu herunterladen.
11. Entpacken
Das Archiv enthält einen Ordner wordpress, der direkt nach /var/www entpackt wird.
sudo tar -xzf wordpress-7.1.2-de_DE.tar.gz -C /var/www
Prüfen: Im Ordner liegen unter anderem wp-config-sample.php und wp-admin.
ls /var/www/wordpress
12. Heruntergeladene Dateien löschen
rm wordpress-7.1.2-de_DE.tar.gz wordpress-7.1.2-de_DE.tar.gz.sha1
13. Dateien dem Webserver übergeben
WordPress lädt Bilder hoch, installiert Designs und Erweiterungen und spielt Updates selbst ein. Dafür muss PHP-FPM, das als Benutzer www-data läuft, in den Ordner schreiben dürfen. Der Nachteil: Eine Lücke in einer Erweiterung könnte ebenfalls Dateien verändern. Halte WordPress und alle Erweiterungen deshalb immer aktuell.
sudo chown -R www-data:www-data /var/www/wordpress
nginx einrichten
14. WordPress-Regeln als Baustein anlegen
Die Regeln kommen in eine eigene Datei unter snippets, die der server-Block in Schritt 15 mit include einbindet. nginx prüft Blöcke mit regulären Ausdrücken (~) von oben nach unten und nimmt den ersten Treffer. Deshalb stehen die Sperren vor dem Block, der PHP ausführt:
- Sperren: versteckte Dateien (z. B.
.htaccess), PHP-Dateien im Upload-Ordnerwp-content/uploadsundxmlrpc.php. Diese alte Schnittstelle nutzen Angreifer gern, um Passwörter durchzuprobieren. Brauchst du sie, etwa für die WordPress-App auf dem Handy, lösche diesen Block. - PHP: Alle übrigen
.php-Dateien gehen an PHP-FPM. - Bilder, CSS, JavaScript: Der Browser darf sie 30 Tage zwischenspeichern.
- Alles andere: Schöne Adressen wie
/hallo-welt/gibt es nicht als Datei.try_filesreicht sie anindex.phpweiter. WordPress liest die gewünschte Seite aus der ursprünglichen Adresse.
sudo nano /etc/nginx/snippets/wordpress.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Versteckte Dateien sperren, außer .well-known (für HTTPS-Zertifikate)
location ~ /\.(?!well-known/) {
return 403;
}
# Hochgeladene Dateien nie als PHP ausführen
location ~* ^/wp-content/uploads/.*\.php$ {
return 403;
}
# Alte Schnittstelle, beliebtes Angriffsziel
location = /xmlrpc.php {
return 403;
}
# PHP über PHP-FPM ausführen
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
# Statische Dateien 30 Tage im Browser zwischenspeichern
location ~* \.(css|js|png|jpe?g|gif|ico|svg|webp|avif|woff2?)$ {
expires 30d;
access_log off;
}
# Schöne Adressen an WordPress weiterreichen
location / {
try_files $uri $uri/ /index.php?$args;
}
15. Konfiguration für start.de anlegen
- Der erste Block leitet
www.start.dedauerhaft (Status301) aufstart.deum.$schemebehälthttpoderhttpsbei. - Der zweite Block ist die Website.
client_max_body_size 64mpasst zur PHP-Grenze aus Schritt 4. Ohne diese Zeile lehnt nginx Uploads über 1 MB ab, bevor PHP sie überhaupt sieht.
sudo nano /etc/nginx/sites-available/start.de
Steht aus einer anderen Anleitung schon Inhalt in der Datei, lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 80;
listen [::]:80;
server_name www.start.de;
return 301 $scheme://start.de$request_uri;
}
server {
listen 80;
listen [::]:80;
server_name start.de;
root /var/www/wordpress;
index index.php;
client_max_body_size 64m;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
include snippets/wordpress.conf;
}
Achtung: Gibt es /etc/nginx/sites-available/start.de schon aus einer anderen Anleitung dieses Buchs, ersetzt du damit ihren Inhalt und die bisherige Website ist unter start.de nicht mehr erreichbar. Eine Domain kann immer nur zu einer Website gehören.
16. Website einschalten
Der Link in sites-enabled schaltet die Website ein. Meldet der Befehl Die Datei existiert bereits, ist sie schon eingeschaltet.
sudo ln -s /etc/nginx/sites-available/start.de /etc/nginx/sites-enabled/start.de
17. Konfiguration testen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
18. nginx neu laden
sudo systemctl reload nginx
WordPress einrichten
19. start.de auf den eigenen Rechner umleiten
Ein Eintrag in /etc/hosts hat Vorrang vor dem DNS im Internet. So lässt sich WordPress einrichten und testen, bevor die Domain auf einen Server zeigt. Steht der Eintrag schon aus einer anderen Anleitung in der Datei, diesen Schritt überspringen.
sudo nano /etc/hosts
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile diesen Eintrag ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
127.0.0.1 start.de www.start.de
Prüfen: Als Adresse erscheint 127.0.0.1.
getent hosts start.de
20. Einrichtungsassistenten öffnen
WordPress merkt sich die Adresse, unter der es eingerichtet wird, als Adresse der Website. Rufe den Assistenten deshalb unbedingt über start.de auf und nicht über localhost.
xdg-open http://start.de
Prüfen: Es erscheint die Seite „Willkommen bei WordPress“ mit der Liste der benötigten Angaben.
21. Datenbank-Zugang eintragen
Klicke auf Los geht's! und trage ein:
| Feld | Eingabe |
|---|---|
| Datenbank-Name | wordpress |
| Benutzername | wpuser |
| Passwort | das Passwort aus Schritt 7 |
| Datenbank-Host | localhost |
| Tabellen-Präfix | wp_ (unverändert lassen) |
Klicke auf Senden und dann auf Installation durchführen. WordPress schreibt dabei die Einstellungsdatei wp-config.php mit dem Datenbank-Zugang und zufälligen Sicherheitsschlüsseln.
22. Website und Administrator anlegen
Gib einen Titel der Website, einen Benutzernamen, ein starkes Passwort und deine E-Mail-Adresse ein. Nimm als Benutzernamen nicht admin, weil Angreifer diesen Namen zuerst ausprobieren. Klicke auf WordPress installieren.
Prüfen: Es erscheint „Installation erfolgreich“. Mit Anmelden gelangst du unter http://start.de/wp-admin/ in die Verwaltung.
23. Einstellungsdatei schützen
wp-config.php enthält das Datenbank-Passwort. Mit 640 darf nur www-data sie lesen und schreiben, alle anderen Benutzer des Rechners haben keinen Zugriff.
sudo chmod 640 /var/www/wordpress/wp-config.php
Prüfen: Die Rechte lauten -rw-r-----, Besitzer ist www-data.
ls -l /var/www/wordpress/wp-config.php
24. Schöne Adressen einschalten
Öffne in der Verwaltung Einstellungen → Permalinks, wähle Beitragsname und klicke auf Änderungen speichern. Beiträge heißen danach z. B. /hallo-welt/ statt /?p=1. Anders als bei Apache ist dafür keine Datei .htaccess nötig, das erledigt der location /-Block aus Schritt 14.
Testen
25. Startseite abrufen
curl -sI http://start.de/ | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 200 OK. Im Browser zeigt http://start.de die Website mit dem Beispielbeitrag „Hallo Welt!“.
26. Schöne Adresse abrufen
Der Beispielbeitrag ist nach Schritt 24 unter /hallo-welt/ erreichbar. Die Adresse gibt es nicht als Datei, nginx muss sie an WordPress weiterreichen.
curl -sI http://start.de/hallo-welt/ | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 200 OK.
27. Umleitung von www prüfen
curl -sI http://www.start.de/hallo-welt/ | grep -E '^HTTP|^Location'
Prüfen: Die Ausgabe lautet HTTP/1.1 301 Moved Permanently und Location: http://start.de/hallo-welt/.
28. Sperren prüfen
curl -sI http://start.de/xmlrpc.php | head -n 1
Prüfen: Die Ausgabe lautet HTTP/1.1 403 Forbidden.
29. Website-Zustand in WordPress prüfen
Öffne in der Verwaltung Werkzeuge → Website-Zustand. WordPress prüft dort unter anderem PHP-Module, Upload-Grenze und Verbindungen.
Prüfen: Unter Info → Medienverarbeitung steht bei der maximalen Upload-Dateigröße 64 MB. Hinweise zu HTTPS verschwinden erst mit dem optionalen Teil unten.
Optional: Im Internet veröffentlichen
Diese Schritte gehen nur auf einem Server, der aus dem Internet erreichbar ist, und nur mit einer Domain, die dir gehört.
1. Testeintrag entfernen
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
2. Domain auf den Server zeigen lassen
In der Weboberfläche des Domain-Anbieters für start.de und www.start.de je einen A-Eintrag mit der öffentlichen IPv4-Adresse des Servers anlegen, bei IPv6 zusätzlich einen AAAA-Eintrag.
Prüfen: Nach einigen Minuten bis Stunden erscheint die Adresse des Servers.
getent hosts start.de
3. Firewall öffnen
Nur nötig, wenn ufw eingeschaltet ist. Das Profil Nginx Full öffnet Port 80 und 443.
sudo ufw allow 'Nginx Full'
4. Certbot installieren
sudo apt install certbot python3-certbot-nginx
5. HTTPS einschalten
Certbot fragt nach einer E-Mail-Adresse und den Nutzungsbedingungen, holt ein Zertifikat von Let's Encrypt und ergänzt beide server-Blöcke um HTTPS.
sudo certbot --nginx -d start.de -d www.start.de
6. WordPress auf HTTPS umstellen
WordPress speichert seine Adresse in der Datenbank und erzeugt sonst weiter Links mit http://. Öffne Einstellungen → Allgemein und ändere bei WordPress-Adresse (URL) und Website-Adresse (URL) jeweils http:// in https://. Nach dem Speichern meldet WordPress dich ab. Melde dich unter https://start.de/wp-admin/ neu an.
Prüfen: Die erste Zeile lautet HTTP/2 200 oder HTTP/1.1 200 OK.
curl -sI https://start.de/ | head -n 1
Das Zertifikat gilt 90 Tage und wird automatisch verlängert. Einen Probelauf startet dieser Befehl:
sudo certbot renew --dry-run
Aktualisieren
WordPress spielt Sicherheitsupdates von selbst ein. Größere Updates, Designs und Erweiterungen aktualisierst du in der Verwaltung unter Dashboard → Aktualisierungen. MariaDB, PHP und nginx kommen aus apt und werden mit sudo apt upgrade aktualisiert.
Prüfen der Installation
grep "wp_version =" /var/www/wordpress/wp-includes/version.php
sudo nginx -T 2>/dev/null | grep 'include snippets/wordpress.conf'
Prüfen: Der erste Befehl zeigt die Version von WordPress, z. B. $wp_version = '7.1.2';, der zweite die include-Zeile aus Schritt 15.
Deinstallieren
1. Website ausschalten
sudo rm /etc/nginx/sites-enabled/start.de
2. nginx-Konfiguration löschen
sudo rm /etc/nginx/sites-available/start.de /etc/nginx/snippets/wordpress.conf
3. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
4. WordPress-Dateien löschen
Achtung: Löscht auch alle hochgeladenen Bilder und Dateien in wp-content/uploads. Vorher bei Bedarf sichern.
sudo rm -rf /var/www/wordpress
5. Datenbank und Benutzer löschen
Achtung: Alle Beiträge, Seiten, Kommentare und Einstellungen gehen verloren.
sudo mariadb -e "DROP DATABASE wordpress; DROP USER 'wpuser'@'localhost';"
6. PHP-Einstellung entfernen und PHP-FPM neu starten
sudo rm /etc/php/8.5/fpm/conf.d/99-wordpress.ini
sudo systemctl restart php8.5-fpm
7. Logdateien löschen
sudo rm /var/log/nginx/start.de.*
8. Testeintrag aus /etc/hosts entfernen
Nur nötig, wenn der Eintrag aus Schritt 19 noch besteht und keine andere Anleitung ihn braucht.
sudo nano /etc/hosts
Suche mit Strg+W nach start.de und drücke Enter. Lösche die Zeile 127.0.0.1 start.de www.start.de mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Zertifikat löschen
Nur nötig, wenn im optionalen Teil ein Zertifikat geholt wurde.
sudo certbot delete --cert-name start.de
10. Optional: MariaDB und PHP-Module entfernen
Nur ausführen, wenn kein anderes Programm MariaDB oder diese PHP-Module braucht. Achtung: purge bei mariadb-server fragt, ob alle Datenbanken gelöscht werden sollen.
sudo apt purge mariadb-server php-mysql php-imagick
sudo apt autoremove
Prüfen: Unter http://start.de antwortet kein WordPress mehr, und die Datenbank ist entfernt, falls MariaDB noch installiert ist:
sudo mariadb -e "SHOW DATABASES;" | grep -c wordpress
Die Ausgabe 0 bedeutet: Die Datenbank ist entfernt.
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.
Wildcard-Zertifikat mit Certbot für nginx
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ein Wildcard-Zertifikat gilt für alle Subdomains einer Domain auf einmal, z. B. für www.start.de, blog.start.de und wiki.start.de. Neue Subdomains bekommen damit sofort HTTPS, ohne dass für jede ein eigenes Zertifikat nötig ist. Diese Anleitung holt ein kostenloses Wildcard-Zertifikat von Let's Encrypt mit Certbot und bindet es in nginx ein, am Beispiel start.de.
Vorbemerkungen
- Voraussetzung: Ein Server, der aus dem Internet erreichbar ist, mit nginx und der Website aus der Anleitung Statische Website mit nginx. Die Domain
start.degehört dir und zeigt perA-Eintrag auf den Server (dort Abschnitt „Im Internet veröffentlichen“, Schritte 1 bis 3). - Was
*.start.deabdeckt: Der Stern steht für genau eine Ebene.blog.start.deist abgedeckt,test.blog.start.denicht. Die Domainstart.deselbst ist ebenfalls nicht enthalten. Deshalb beantragt diese Anleitung ein Zertifikat für beide Namen,start.deund*.start.de. - Nachweis über DNS: Bei normalen Zertifikaten legt Certbot eine Datei auf den Webserver, die Let's Encrypt abruft. Für Wildcard-Zertifikate verlangt Let's Encrypt einen anderen Nachweis: einen
TXT-Eintrag im DNS der Domain. Damit zeigst du, dass du die ganze Domain verwaltest und nicht nur einen Webserver. - Manueller Weg: Diese Anleitung setzt den
TXT-Eintrag von Hand in der Weboberfläche deines Domain-Anbieters. Das funktioniert bei jedem Anbieter. Der Nachteil: Das Zertifikat gilt derzeit 90 Tage, und auch die Verlängerung ist Handarbeit (Abschnitt „Verlängern“). Let's Encrypt verschickt keine Erinnerungs-E-Mails mehr. Trage dir den Termin deshalb selbst in den Kalender ein. - Automatisch geht es nur mit Plugin: Für einige Anbieter gibt es Certbot-Plugins in apt, die den
TXT-Eintrag selbst setzen und die Verlängerung automatisch erledigen, z. B.python3-certbot-dns-netcup,python3-certbot-dns-cloudflareoderpython3-certbot-dns-ovh. Die ganze Liste zeigtapt search certbot-dns.
Zertifikat beantragen
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Certbot und den DNS-Werkzeugen kennt.
sudo apt update
2. Certbot und DNS-Werkzeuge installieren
certbot beantragt das Zertifikat. bind9-dnsutils enthält den Befehl dig, mit dem du prüfst, ob der TXT-Eintrag schon im Internet sichtbar ist.
sudo apt install certbot bind9-dnsutils
Prüfen: Die Ausgabe nennt die Version, z. B. certbot 4.0.0.
certbot --version
3. Zertifikat anfordern
certonlyholt nur das Zertifikat und ändert nichts an nginx. Die Konfiguration schreibst du danach selbst.--manualmit--preferred-challenges dnswählt den Nachweis über einenTXT-Eintrag, den du von Hand setzt.--cert-name start.delegt den Namen fest, unter dem Certbot das Zertifikat ablegt:/etc/letsencrypt/live/start.de/.- Die beiden
-dnennen die Namen im Zertifikat.'*.start.de'steht in einfachen Anführungszeichen, damit die Shell den Stern nicht als Platzhalter für Dateinamen auswertet.
sudo certbot certonly --manual --preferred-challenges dns --cert-name start.de -d start.de -d '*.start.de'
Beim allerersten Aufruf fragt Certbot nach einer E-Mail-Adresse für wichtige Hinweise und nach den Nutzungsbedingungen von Let's Encrypt (mit Y zustimmen). Die Frage nach Werbe-E-Mails kannst du mit N beantworten.
4. Ersten TXT-Eintrag anlegen
Certbot zeigt jetzt einen Namen und einen Wert, etwa so:
Please deploy a DNS TXT record under the name:
_acme-challenge.start.de.
with the following value:
<zufälliger Wert aus etwa 43 Zeichen>
Noch nicht Enter drücken. Öffne in der Weboberfläche deines Domain-Anbieters die DNS-Einstellungen von start.de und lege einen neuen Eintrag an:
| Feld | Eingabe |
|---|---|
| Typ | TXT |
| Name / Host | _acme-challenge (manche Anbieter wollen den vollen Namen _acme-challenge.start.de) |
| Wert / Inhalt | der Wert aus dem Terminal, genau abgeschrieben, am besten kopiert |
| TTL | der kleinste angebotene Wert, z. B. 300 Sekunden |
Speichere den Eintrag und drücke dann im Terminal Enter.
5. Zweiten TXT-Eintrag anlegen
Weil das Zertifikat zwei Namen enthält, zeigt Certbot einen zweiten Wert unter demselben Namen _acme-challenge.start.de. Lege dafür einen weiteren TXT-Eintrag an, mit gleichem Namen und dem neuen Wert. Den ersten Eintrag nicht ändern oder löschen, beide müssen gleichzeitig bestehen.
Drücke noch nicht Enter, sondern prüfe zuerst im nächsten Schritt, ob beide Einträge sichtbar sind.
6. TXT-Einträge prüfen
Öffne ein zweites Terminal. dig fragt hier gezielt einen öffentlichen DNS-Server (1.1.1.1) nach den TXT-Einträgen. So siehst du, was auch Let's Encrypt sehen wird.
dig +short TXT _acme-challenge.start.de @1.1.1.1
Prüfen: Die Ausgabe enthält beide Werte in Anführungszeichen. Erscheint nichts oder nur ein Wert, warte eine bis fünf Minuten und frage erneut. Manche Anbieter brauchen länger, bis Änderungen im Internet sichtbar sind.
7. Nachweis abschließen
Wechsle zurück ins erste Terminal und drücke Enter. Let's Encrypt prüft jetzt beide Einträge und stellt das Zertifikat aus.
Prüfen: Die Ausgabe enthält Successfully received certificate. und die Pfade /etc/letsencrypt/live/start.de/fullchain.pem und privkey.pem. Meldet Certbot Incorrect TXT record oder No TXT record found, war ein Eintrag noch nicht sichtbar oder falsch abgeschrieben. Dann Schritt 3 wiederholen. Certbot zeigt dabei neue Werte, die alten TXT-Einträge ersetzt du durch die neuen.
8. Zertifikat anzeigen
sudo certbot certificates
Prüfen: Beim Eintrag Certificate Name: start.de stehen Domains: start.de *.start.de und bei Expiry Date ein Datum in knapp 90 Tagen. Trage dir einen Termin etwa 30 Tage vorher für die Verlängerung ein.
9. TXT-Einträge entfernen
Die beiden TXT-Einträge werden nicht mehr gebraucht. Lösche sie in der Weboberfläche des Anbieters. Bei der Verlängerung verlangt Certbot ohnehin neue Werte.
nginx einrichten
10. Bisherige Konfiguration sichern
Die folgenden Schritte ersetzen die Konfiguration von start.de. Die Kopie liegt außerhalb von sites-enabled, damit nginx sie nicht als zweite Website lädt.
sudo cp -p /etc/nginx/sites-available/start.de /root/start.de.vor-wildcard
11. Zertifikat als Baustein anlegen
Die beiden Zeilen, die auf das Zertifikat zeigen, kommen in eine eigene Datei. Jede Website unter start.de bindet sie mit einer include-Zeile ein. Das ist der eigentliche Vorteil des Wildcard-Zertifikats: Für eine neue Subdomain genügt diese eine Zeile.
fullchain.pem– das Zertifikat samt Zwischenzertifikat von Let's Encrypt, das Browser zur Prüfung brauchenprivkey.pem– der geheime Schlüssel. Er ist nur fürrootlesbar, nginx liest ihn beim Start mit Administratorrechten.
sudo nano /etc/nginx/snippets/ssl-start.de.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Wildcard-Zertifikat für start.de und *.start.de
ssl_certificate /etc/letsencrypt/live/start.de/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/start.de/privkey.pem;
12. Website auf HTTPS umstellen
Die Datei bekommt zwei server-Blöcke:
- Der erste nimmt alle Anfragen auf Port 80 an, für
start.deund jede Subdomain (*.start.de), und leitet sie dauerhaft auf HTTPS um.$hostbehält den aufgerufenen Namen bei,$request_uriden Pfad. - Der zweite ist die Website auf Port 443.
sslschaltet die Verschlüsselung ein,http2 ondas schnellere Protokoll HTTP/2. nginx 1.28 erlaubt ab Werk nur die sicheren Verfahren TLS 1.2 und 1.3. Eigene Einstellungen dafür sind nicht nötig.
sudo nano /etc/nginx/sites-available/start.de
Die Datei hat schon Inhalt, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
# HTTP: alles auf HTTPS umleiten
server {
listen 80;
listen [::]:80;
server_name start.de *.start.de;
return 301 https://$host$request_uri;
}
# HTTPS: die Website start.de
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name start.de www.start.de;
include snippets/ssl-start.de.conf;
root /var/www/start.de/html;
index index.html;
access_log /var/log/nginx/start.de.access.log;
error_log /var/log/nginx/start.de.error.log;
location / {
try_files $uri $uri/ =404;
}
error_page 404 /404.html;
location ~* \.(css|js|png|jpe?g|gif|svg|webp|ico|woff2?)$ {
expires 7d;
}
}
Beispiel: eine weitere Subdomain
Als Beispiel bekommt test.start.de eine eigene kleine Website, die dasselbe Zertifikat nutzt.
13. DNS-Eintrag für die Subdomain anlegen
Lege beim Domain-Anbieter einen A-Eintrag mit dem Namen test und der IPv4-Adresse des Servers an (bei IPv6 zusätzlich AAAA). Alternativ ein A-Eintrag mit dem Namen *: Dann zeigt jede beliebige Subdomain auf den Server.
Prüfen: Nach einigen Minuten erscheint die Adresse des Servers.
dig +short test.start.de @1.1.1.1
14. Ordner für die Subdomain anlegen
Wie in der Anleitung Statische Website mit nginx gehört der Ordner deinem Benutzer, damit du ohne sudo Dateien ablegen kannst.
sudo mkdir -p /var/www/test.start.de/html
sudo chown -R "$USER":"$USER" /var/www/test.start.de
15. Startseite anlegen
nano /var/www/test.start.de/html/index.html
Füge diese Zeile ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
<h1>test.start.de mit Wildcard-Zertifikat</h1>
16. Konfiguration für die Subdomain anlegen
Nur ein HTTPS-Block ist nötig. Die Umleitung von HTTP erledigt schon der erste Block aus Schritt 12, weil er für *.start.de gilt. Das Zertifikat kommt über dieselbe include-Zeile.
sudo nano /etc/nginx/sites-available/test.start.de
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name test.start.de;
include snippets/ssl-start.de.conf;
root /var/www/test.start.de/html;
index index.html;
}
17. Subdomain einschalten
sudo ln -s /etc/nginx/sites-available/test.start.de /etc/nginx/sites-enabled/test.start.de
18. Konfiguration testen und nginx neu laden
&& sorgt dafür, dass nginx nur neu geladen wird, wenn der Test erfolgreich war.
sudo nginx -t && sudo systemctl reload nginx
Prüfen: Die Ausgabe enthält test is successful. Meldet nginx cannot load certificate, stimmt der Pfad in Schritt 11 nicht mit dem aus Schritt 7 überein.
19. Firewall für HTTPS öffnen
Nur nötig, wenn ufw eingeschaltet ist. Das Profil Nginx Full öffnet Port 80 und 443.
sudo ufw allow 'Nginx Full'
Testen
20. Umleitung auf HTTPS prüfen
curl -sI http://start.de/ | grep -E '^HTTP|^Location'
Prüfen: Die Ausgabe lautet HTTP/1.1 301 Moved Permanently und Location: https://start.de/.
21. Beide Websites über HTTPS abrufen
curl prüft dabei das Zertifikat. Wäre es ungültig oder passte nicht zum Namen, bräche der Befehl mit einer Fehlermeldung ab.
curl -sI https://start.de/ | head -n 1
curl -s https://test.start.de/
Prüfen: Die erste Ausgabe lautet HTTP/2 200, die zweite <h1>test.start.de mit Wildcard-Zertifikat</h1>.
22. Namen im Zertifikat anzeigen
openssl s_client baut eine Verbindung auf wie ein Browser, openssl x509 zeigt die Namen, für die das gelieferte Zertifikat gilt.
openssl s_client -connect test.start.de:443 -servername test.start.de < /dev/null 2>/dev/null | openssl x509 -noout -ext subjectAltName
Prüfen: Die Ausgabe enthält DNS:*.start.de und DNS:start.de.
Verlängern
Das Zertifikat gilt derzeit 90 Tage. Certbot schlägt die Verlängerung ab 30 Tage vor Ablauf vor, früher ist sie auch möglich. sudo certbot renew funktioniert bei manuell beantragten Zertifikaten nicht, weil Certbot den TXT-Eintrag nicht selbst setzen kann. Der automatische Verlängerungsdienst von Certbot meldet deshalb im Log für dieses Zertifikat einen Fehler. Das ist bei diesem Weg normal.
1. Ablaufdatum prüfen
sudo certbot certificates
Prüfen: Bei Expiry Date steht, wie viele Tage das Zertifikat noch gilt (VALID: … days).
2. Zertifikat neu anfordern
Derselbe Befehl wie in Schritt 3. Certbot erkennt das vorhandene Zertifikat und fragt, ob es erneuert werden soll: Wähle Renew & replace the certificate. Danach folgen wieder zwei TXT-Einträge mit neuen Werten. Gehe dabei wie in den Schritten 4 bis 7 vor und lösche danach die Einträge (Schritt 9).
sudo certbot certonly --manual --preferred-challenges dns --cert-name start.de -d start.de -d '*.start.de'
3. nginx neu laden
nginx liest das neue Zertifikat erst beim Neuladen. Die Pfade bleiben gleich, die Konfiguration muss nicht geändert werden.
sudo systemctl reload nginx
Prüfen: Das neue Ablaufdatum liegt wieder knapp 90 Tage in der Zukunft.
echo | openssl s_client -connect start.de:443 -servername start.de 2>/dev/null | openssl x509 -noout -enddate
Prüfen der Installation
certbot --version
sudo nginx -T 2>/dev/null | grep 'include snippets/ssl-start.de.conf'
Prüfen: Der erste Befehl zeigt die Version von Certbot, der zweite zwei include-Zeilen, je eine pro Website.
Deinstallieren
1. Subdomain ausschalten und löschen
sudo rm /etc/nginx/sites-enabled/test.start.de /etc/nginx/sites-available/test.start.de
Achtung: Löscht auch die Dateien der Test-Website.
sudo rm -r /var/www/test.start.de
2. Alte Konfiguration von start.de zurückholen
Stellt die HTTP-Konfiguration aus Schritt 10 wieder her.
sudo cp -p /root/start.de.vor-wildcard /etc/nginx/sites-available/start.de
3. Zertifikats-Baustein löschen
sudo rm /etc/nginx/snippets/ssl-start.de.conf
4. nginx testen und neu laden
sudo nginx -t && sudo systemctl reload nginx
5. Zertifikat löschen
Entfernt Zertifikat, Schlüssel und Verlängerungseinstellungen unter /etc/letsencrypt. Certbot fragt zur Sicherheit nach.
sudo certbot delete --cert-name start.de
6. Sicherung löschen
sudo rm /root/start.de.vor-wildcard
7. DNS-Einträge aufräumen
Lösche beim Domain-Anbieter den A-Eintrag für test (oder *) aus Schritt 13 und eventuell noch vorhandene TXT-Einträge _acme-challenge.
8. Optional: Certbot entfernen
Nur ausführen, wenn keine andere Website ein Zertifikat von Certbot nutzt. bind9-dnsutils bleibt installiert, weil dig auch sonst nützlich ist.
sudo apt purge certbot
sudo apt autoremove
Prüfen: Es wird kein Zertifikat mehr angezeigt, bzw. der Befehl wird nicht mehr gefunden.
sudo certbot certificates
Quellen und Lizenz
- Offizielle Dokumentation: https://certbot.eff.org/
- Lizenz: Certbot steht unter der Apache-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.
Keycloak
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Keycloak ist eine freie Benutzer- und Anmeldeverwaltung. Andere Programme wie Outline überlassen ihm die Anmeldung über die Standards OpenID Connect (OIDC) oder SAML. Benutzer haben dann ein Konto an einer zentralen Stelle statt in jedem Programm ein eigenes. Diese Anleitung richtet Keycloak als Dienst auf dem eigenen Rechner ein und speichert alle Daten in PostgreSQL.
Vorbemerkungen
- Voraussetzung: PostgreSQL ist nach der Anleitung installiert und läuft.
- Keine Installation über apt: Ubuntu enthält kein Keycloak-Paket. Das Projekt stellt aber ein fertiges Archiv bereit, das nur Java braucht. Java kommt aus den Paketquellen von Ubuntu.
- Version: Getestet mit Keycloak 26.7.4 und PostgreSQL 18. Keycloak 26.7 setzt Java 25 voraus und lief im Test auch mit Java 26.
- Port: Keycloak läuft normalerweise auf Port 8080. Auf diesem Rechner belegt Apache diesen Port schon (siehe Tileserver). Die Anleitung verwendet deshalb Port 8083. Dazu kommt Port 9000 für interne Gesundheitsprüfungen. Beide Ports sind nur vom eigenen Rechner aus erreichbar.
- Ohne HTTPS: Keycloak läuft hier im Produktionsmodus, aber ohne Verschlüsselung. Das ist nur in Ordnung, solange Keycloak ausschließlich über
localhosterreichbar ist. Für den Zugriff aus dem Netz gehört ein Proxy mit Zertifikat davor, z. B. nginx. - Passwörter:
geheimes_passwortist ein Beispiel. Ersetze es überall durch ein eigenes Passwort.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Java und curl installieren
Keycloak ist in Java geschrieben. openjdk-25-jre-headless ist die Java-Laufzeitumgebung ohne grafische Teile, die ein Server nicht braucht. Mit curl lädst du später das Programmarchiv herunter.
sudo apt install openjdk-25-jre-headless curl
Prüfen: Die erste Zeile beginnt mit openjdk version "25. Sind mehrere Java-Versionen installiert, kann hier auch eine neuere stehen. Keycloak verwendet dieselbe Version wie dieser Befehl.
java -version
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer für Keycloak anlegen
Legt in PostgreSQL den Benutzer keycloak an. Mit ihm meldet sich Keycloak an der Datenbank an.
sudo -u postgres psql -c "CREATE USER keycloak WITH PASSWORD 'geheimes_passwort';"
4. Datenbank für Keycloak anlegen
Legt die leere Datenbank keycloak an und macht den gleichnamigen Benutzer zu ihrem Eigentümer. Die Tabellen erstellt Keycloak beim ersten Start selbst.
sudo -u postgres psql -c "CREATE DATABASE keycloak OWNER keycloak;"
Prüfen: Die Datenbank erscheint in der Liste.
sudo -u postgres psql -l | grep keycloak
Keycloak installieren
5. Systembenutzer anlegen
Keycloak soll weder mit Administratorrechten noch unter deinem Benutzerkonto laufen, sondern unter einem eigenen Benutzer keycloak, mit dem man sich nicht anmelden kann.
sudo useradd --system --home-dir /opt/keycloak --shell /usr/sbin/nologin keycloak
6. Programmarchiv herunterladen
Lädt Keycloak 26.7.4 (etwa 170 MB) in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://github.com/keycloak/keycloak/releases. Bei einer neueren Version ersetzt du die Nummer an beiden Stellen im Befehl.
curl -L -o /tmp/keycloak.tar.gz https://github.com/keycloak/keycloak/releases/download/26.7.4/keycloak-26.7.4.tar.gz
Prüfen: Die Datei ist ungefähr 170 MB groß.
ls -lh /tmp/keycloak.tar.gz
7. Programmordner anlegen
Legt den Ordner an, in dem Keycloak liegen soll.
sudo mkdir /opt/keycloak
8. Archiv entpacken
Im Archiv steckt alles in einem Unterordner keycloak-26.7.4. --strip-components=1 lässt diese Ebene weg, sodass die Dateien direkt in /opt/keycloak landen.
sudo tar xzf /tmp/keycloak.tar.gz -C /opt/keycloak --strip-components=1
Prüfen: Der Ordner enthält unter anderem bin, conf und lib.
ls /opt/keycloak
9. Einstellungsdatei schreiben
Die Datei keycloak.conf legt fest, welche Datenbank Keycloak nutzt und unter welcher Adresse es erreichbar ist. Sie enthält schon Beispiele, die alle auskommentiert sind.
sudo nano /opt/keycloak/conf/keycloak.conf
Lösche den bisherigen Inhalt: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles aus. Füge dann diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Datenbank
db=postgres
db-url=jdbc:postgresql://127.0.0.1:5432/keycloak
db-username=keycloak
db-password=geheimes_passwort
# HTTP
http-enabled=true
http-host=127.0.0.1
http-port=8083
hostname=http://localhost:8083
# Gesundheitsprüfung
health-enabled=true
Was die Einträge bedeuten:
dbunddb-url– Keycloak nutzt PostgreSQL auf dem eigenen Rechner und dort die Datenbankkeycloak.db-usernameunddb-password– die Zugangsdaten aus Schritt 3.http-enabled=true– erlaubt unverschlüsseltes HTTP. Im Produktionsmodus ist es sonst abgeschaltet.http-hostundhttp-port– Keycloak nimmt Anfragen nur vom eigenen Rechner an, und zwar auf Port 8083.hostname– die Adresse, die Keycloak in Links und Anmeldedaten für andere Programme einträgt. Sie muss genau so lauten, wie Browser und Programme Keycloak aufrufen.health-enabled=true– schaltet unter Port 9000 eine Seite ein, die meldet, ob Keycloak bereit ist.
10. Eigentümer und Rechte setzen
Der erste Befehl übergibt den Programmordner dem Benutzer keycloak. Der zweite sorgt dafür, dass nur noch dieser Benutzer die Einstellungsdatei mit dem Datenbank-Passwort lesen darf.
sudo chown -R keycloak:keycloak /opt/keycloak
sudo chmod 600 /opt/keycloak/conf/keycloak.conf
11. Keycloak für diese Einstellungen vorbereiten
Keycloak übersetzt einen Teil der Einstellungen, z. B. die Wahl der Datenbank, vorab in eine optimierte Fassung. Dann startet es später schneller. Dieser Schritt ist nach jeder Änderung an db oder health-enabled nötig.
sudo -u keycloak /opt/keycloak/bin/kc.sh build
Prüfen: Die Ausgabe endet mit Server configuration updated and persisted.
12. Ersten Administrator anlegen
Ein neues Keycloak hat noch keinen Benutzer, mit dem man es verwalten kann. Dieser Befehl legt den Administrator admin an und legt dabei auch die Tabellen in PostgreSQL an. Er funktioniert nur, solange Keycloak noch nicht als Dienst läuft, deshalb kommt er vor Schritt 15. Nach dem Start fragt er zweimal nach dem gewünschten Passwort (Enter password:). Die Eingabe bleibt beim Tippen unsichtbar.
sudo -u keycloak /opt/keycloak/bin/kc.sh bootstrap-admin user --optimized --username admin
Prüfen: Unter den Meldungen steht Created temporary admin user with username admin. Keycloak nennt dieses Konto „temporär“ und empfiehlt in der Verwaltungsoberfläche, später ein dauerhaftes Administratorkonto anzulegen. Für einen Entwicklungsrechner reicht admin.
Als Dienst einrichten
13. systemd-Dienst anlegen
Damit Keycloak beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/keycloak.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Keycloak
After=network.target postgresql.service
[Service]
Type=simple
User=keycloak
Group=keycloak
ExecStart=/opt/keycloak/bin/kc.sh start --optimized
Restart=on-failure
[Install]
WantedBy=multi-user.target
After=– Keycloak startet erst, wenn PostgreSQL bereit ist.ExecStart=–startist der Produktionsmodus.--optimizednutzt die vorbereitete Fassung aus Schritt 11.Restart=on-failure– systemd startet Keycloak nach einem Absturz neu.
14. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
15. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet Keycloak zusätzlich sofort.
sudo systemctl enable --now keycloak
16. Start prüfen
Keycloak braucht nach dem Start noch einige Sekunden, bis es Anfragen beantwortet. Die Gesundheitsprüfung zeigt, ob es so weit ist.
curl -s http://localhost:9000/health/ready
Prüfen: Die Ausgabe enthält "status": "UP". Steht dort noch DOWN, wiederhole den Befehl nach ein paar Sekunden. Kommt gar keine Antwort, zeigt sudo journalctl -u keycloak -n 50 die letzten Meldungen.
17. Verwaltungsoberfläche öffnen
Öffne im Browser http://localhost:8083/admin/ und melde dich mit admin und dem Passwort aus Schritt 12 an.
Realm und ersten Benutzer anlegen
Ein Realm ist in Keycloak ein abgetrennter Bereich mit eigenen Benutzern und eigenen angebundenen Programmen. Der vorhandene Realm master ist nur für die Verwaltung von Keycloak selbst gedacht. Für deine Anwendungen legst du einen eigenen an, hier mit dem Namen intern. Die Schritte nutzen das Befehlszeilenwerkzeug kcadm.sh, das bei Keycloak dabei ist. Alles geht genauso in der Verwaltungsoberfläche.
18. Befehlszeilenwerkzeug anmelden
Meldet kcadm.sh als Administrator bei Keycloak an. Das Werkzeug fragt nach dem Passwort aus Schritt 12 und merkt sich die Anmeldung für die nächsten Befehle in ~/.keycloak/kcadm.config.
/opt/keycloak/bin/kcadm.sh config credentials --server http://localhost:8083 --realm master --user admin
Prüfen: Nach der Passworteingabe erscheint keine Fehlermeldung.
19. Realm anlegen
Erstellt den Realm intern und schaltet ihn ein.
/opt/keycloak/bin/kcadm.sh create realms -s realm=intern -s enabled=true
Prüfen: Die Ausgabe lautet Created new realm with id 'intern'.
20. Benutzer anlegen
Erstellt einen Benutzer im Realm intern. Ersetze Benutzername, E-Mail und Namen durch deine Angaben. Die E-Mail-Adresse und der Name werden gebraucht, weil angebundene Programme wie Outline sie übernehmen. emailVerified=true kennzeichnet die Adresse als bestätigt, weil hier kein E-Mail-Versand eingerichtet ist.
/opt/keycloak/bin/kcadm.sh create users -r intern -s username=erika -s email=erika@example.com -s emailVerified=true -s firstName=Erika -s lastName=Mustermann -s enabled=true
21. Passwort für den Benutzer setzen
Legt das Passwort fest, mit dem sich der Benutzer später anmeldet. kcadm.sh fragt danach, die Eingabe bleibt unsichtbar.
/opt/keycloak/bin/kcadm.sh set-password -r intern --username erika
Prüfen: Öffne http://localhost:8083/realms/intern/account/ und melde dich mit dem neuen Benutzer an. Es erscheint die Kontoseite des Benutzers.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Keycloak und verhindert den Start beim Hochfahren.
sudo systemctl disable --now keycloak
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 13.
sudo rm /etc/systemd/system/keycloak.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programmordner und Archiv löschen
Entfernt Keycloak samt Einstellungen und das heruntergeladene Archiv.
sudo rm -rf /opt/keycloak /tmp/keycloak.tar.gz
5. Anmeldung des Befehlszeilenwerkzeugs löschen
Entfernt die gespeicherte Anmeldung aus Schritt 18.
rm -rf ~/.keycloak
6. Datenbank löschen
Löscht die Datenbank keycloak. Achtung: Alle Realms, Benutzer und Einstellungen gehen unwiderruflich verloren. Programme, die sich über Keycloak anmelden, funktionieren danach nicht mehr.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS keycloak;"
7. Datenbankbenutzer löschen
Entfernt den PostgreSQL-Benutzer aus Schritt 3.
sudo -u postgres psql -c "DROP USER IF EXISTS keycloak;"
8. Systembenutzer löschen
Entfernt den Linux-Benutzer aus Schritt 5.
sudo userdel keycloak
9. Java entfernen (optional)
Nur ausführen, wenn kein anderes Programm Java 25 braucht.
sudo apt purge openjdk-25-jre-headless
sudo apt autoremove
Prüfen: Unter Port 8083 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8083/
Quellen und Lizenz
- Offizielle Dokumentation: https://www.keycloak.org/documentation
- Lizenz: Keycloak steht unter der Apache-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.
Artemis
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Artemis ist eine an der TU München entwickelte Lernplattform für Kurse, Aufgaben und Prüfungen.
Diese Anleitung richtet auf Ubuntu 26.04 LTS (amd64) eine eigene lokale Testinstanz direkt auf dem Rechner ein. Wenn du lediglich an einem TUM-Kurs teilnehmen möchtest, öffne stattdessen die Artemis-Instanz der TUM im Browser und verwende deinen Hochschulzugang.
Umfang und Voraussetzungen
Die Testinstanz verwendet PostgreSQL und ist nur vom eigenen Rechner erreichbar. Sie ist unabhängig von den Kursen und Benutzerkonten der TUM. Internetzugang ist für die Downloads erforderlich. Plane für den Quellcode, die Abhängigkeiten und den Build mehrere GB freien Speicher ein; für den Build sind 16 GB RAM eine sinnvolle Planungsgröße.
Grenze des Aufbaus: Die integrierte automatische Ausführung von Programmierabgaben benötigt Build-Agenten mit Container-Laufzeit. Diese Anleitung lässt deshalb die Profile localci, localvc und buildagent weg. Für Kurse mit automatisch getesteten Programmieraufgaben reicht dieser Aufbau nicht aus. Siehe die offizielle Beschreibung der Build-Infrastruktur.
Verwendet wird der Entwicklungszweig develop. Er verändert sich laufend; dies ist keine Anleitung für einen öffentlichen Hochschulserver. Die folgenden Build-Einstellungen wurden anhand des offiziellen Build-Skripts geprüft: Java 25 sowie ein projektverwalteter Download von Node.js und pnpm. Ein separates systemweites Gradle, Node.js oder pnpm ist für diesen Weg nicht nötig.
System vorbereiten
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren Paketversionen kennt.
sudo apt update
2. Voraussetzungen installieren
Java übersetzt und startet Artemis. PostgreSQL speichert die Daten; Git lädt den Quellcode. Die übrigen Werkzeuge dienen dem Build, der Konfiguration und den Prüfungen.
sudo apt install openjdk-25-jdk postgresql postgresql-client git curl ca-certificates build-essential graphviz nano openssl
3. Java für dieses Terminal auswählen
Die feste Auswahl verhindert, dass ein anderes installiertes JDK für den Build verwendet wird. Wiederhole diesen Schritt in einem neuen Terminal vor dem Artemis-Start.
export JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64
4. Java in den Suchpfad aufnehmen
Damit auch der direkte Aufruf von java die ausgewählte Version verwendet.
export PATH="$JAVA_HOME/bin:$PATH"
Prüfen: Die Ausgabe muss Java 25 nennen.
java -version
5. PostgreSQL starten
Aktiviert den Datenbankdienst auch für spätere Rechnerstarts.
sudo systemctl enable --now postgresql
Prüfen: Der Server muss Verbindungen annehmen.
pg_isready -h 127.0.0.1 -p 5432
Eigene Datenbank einrichten
6. Datenbankbenutzer anlegen
Der Benutzer erhält keine Administratorrechte. Gib auf Nachfrage ein eigenes Datenbankpasswort ein und bewahre es für Schritt 12 auf. Die Namen artemis_local werden ausschließlich für diese Testinstanz verwendet.
sudo -u postgres createuser --pwprompt artemis_local
7. Datenbank anlegen
Die separate Datenbank gehört dem neuen Benutzer. Artemis legt seine Tabellen später selbst an.
sudo -u postgres createdb --owner=artemis_local --encoding=UTF8 artemis_local
Prüfen: Gib das soeben gewählte Passwort ein. Die Ausgabe soll den Benutzer und die Datenbank artemis_local zeigen. Falls PostgreSQL bereits vor dieser Anleitung eingerichtet war, muss seine Zugriffskonfiguration lokale TCP-Verbindungen mit Passwort erlauben.
psql -h 127.0.0.1 -U artemis_local -d artemis_local -W -c 'SELECT current_user, current_database();'
Artemis herunterladen und konfigurieren
8. Ins Home-Verzeichnis wechseln
Der Quellcode wird im eigenen Benutzerkonto gespeichert; Artemis wird ohne sudo gebaut und gestartet.
cd ~
9. Quellcode laden
Lädt den Entwicklungszweig ohne die vollständige Änderungshistorie. Der Zielordner darf noch nicht existieren.
git clone --depth 1 --branch develop https://github.com/ls1intum/Artemis.git artemis-tum
10. In den Projektordner wechseln
Alle nachfolgenden Build-Befehle werden hier ausgeführt.
cd ~/artemis-tum
Prüfen: Notiere diese Kennung, damit du später weißt, welchen Quellstand du eingerichtet hast. Bei einem späteren Download können sich die Voraussetzungen ändern.
git rev-parse HEAD
11. Anmeldeschlüssel erzeugen
Der zufällige Schlüssel dient zur Signierung der Anmeldetokens. Kopiere die ausgegebene Zeile für die Konfiguration.
openssl rand -base64 64 | tr -d '\n'; echo
12. Lokale Konfiguration anlegen
Öffnet die Datei für die Einstellungen dieser Instanz. Die Kombination aus PostgreSQL und dem Profil local wird im offiziellen Setup-Handbuch beschrieben.
nano src/main/resources/config/application-local.yml
Trage den folgenden Inhalt ein. Ersetze die drei Platzhalter durch dein Datenbankpasswort, ein eigenes Adminpasswort und den Schlüssel aus Schritt 11. Verwende bei Passwörtern innerhalb einfacher YAML-Anführungszeichen für ein enthaltenes ' jeweils ''. Die Adminadresse ist für diesen lokalen Versuch ein Platzhalter; Mailversand wird hier nicht eingerichtet.
server:
address: 127.0.0.1
port: 8080
url: http://localhost:8080
spring:
datasource:
url: jdbc:postgresql://127.0.0.1:5432/artemis_local
username: artemis_local
password: 'DATENBANKPASSWORT_ERSETZEN'
jpa:
database: POSTGRESQL
jhipster:
security:
authentication:
jwt:
base64-secret: 'SCHLUESSEL_ERSETZEN'
artemis:
user-management:
use-external: false
internal-admin:
username: lokaladmin
password: 'ADMINPASSWORT_ERSETZEN'
email: admin@localhost
Speichere mit Strg+O, bestätige mit Enter und schließe nano mit Strg+X. Die Admin-Einstellungen entsprechen den Schlüsseln der Artemis-Konfiguration.
13. Konfigurationsdatei schützen
Nur dein Benutzerkonto soll die Datei mit den Zugangsdaten lesen und ändern können.
chmod 600 src/main/resources/config/application-local.yml
Starten und prüfen
14. Artemis starten
Der Gradle Wrapper lädt die benötigten Build-Werkzeuge und Bibliotheken, baut die Weboberfläche und startet den Server. Der erste Aufruf kann erheblich dauern. Das Terminal bleibt während des Betriebs belegt. Die Einbindung des Frontend-Builds ist im Gradle-Entwicklungsprofil hinterlegt.
./gradlew bootRun --args='--spring.profiles.active=dev,artemis,scheduling,core,local'
Prüfen: Warte auf die Meldung, dass ArtemisApp gestartet wurde. Bei Connection refused prüfe PostgreSQL; bei einem Authentifizierungsfehler prüfe das Datenbankpasswort. Falls Port 8080 belegt ist, beende den dort laufenden eigenen Dienst oder wähle in der Konfiguration einen anderen Port und passe die folgenden Adressen an.
15. HTTP-Antwort prüfen
Öffne ein zweites Terminal. Eine Antwort mit HTTP-Status 200 zeigt, dass die Startseite ausgeliefert wird.
curl --fail --output /dev/null --write-out '%{http_code}\n' http://localhost:8080/
16. Im Browser anmelden
Öffne die lokale Adresse und melde dich mit lokaladmin und deinem Adminpasswort an. Prüfe, ob die Verwaltungsfunktionen erreichbar sind.
http://localhost:8080
17. Artemis beenden
Drücke im Serverterminal Strg+C. Die Daten bleiben in PostgreSQL und im Projektordner erhalten. Zum erneuten Start wiederholst du die Schritte 3, 4, 10 und 14.
Für einen öffentlichen Betrieb sind weitere Arbeiten nötig, unter anderem TLS, Backups, Mailversand und eine Produktionskonfiguration. Der lokale Entwicklungsaufbau ist dafür kein fertiger Ersatz. Ausgangspunkt ist das offizielle Administratorhandbuch.
Deinstallieren
Die folgenden Schritte löschen die Daten dieser Testinstanz unwiderruflich. Sichere benötigte Kurse, Uploads und eigene Quellcodeänderungen vorher.
1. Server beenden
Drücke im Serverterminal Strg+C, damit Artemis nicht mehr auf die Datenbank zugreift.
2. Datenbank löschen
Entfernt alle in dieser Testinstanz gespeicherten Datenbankinhalte.
sudo -u postgres dropdb artemis_local
3. Datenbankbenutzer löschen
Entfernt das ausschließlich für diese Instanz angelegte Datenbankkonto.
sudo -u postgres dropuser artemis_local
4. Projektordner löschen
Entfernt Quellcode, Konfiguration, Build-Dateien und dort abgelegte Artemis-Dateien. Gemeinsame Gradle-Caches im Home-Verzeichnis bleiben für andere Projekte erhalten.
rm -rf -- ~/artemis-tum
Prüfen: Die Ausgabe soll entfernt lauten.
test ! -e ~/artemis-tum && echo entfernt
5. Optional: Java-Entwicklungspaket entfernen
Führe dies nur aus, wenn du das Paket für kein anderes Projekt benötigst. PostgreSQL und die Hilfsprogramme bleiben installiert, damit bestehende Datenbanken und andere Anwendungen erhalten bleiben.
sudo apt remove openjdk-25-jdk
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.
Autolab
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Autolab ist eine an der Carnegie Mellon University entwickelte Webanwendung zum Verwalten von Programmieraufgaben, Abgaben und Bewertungen.
Einordnung und Grenzen
Diese Anleitung beschreibt eine lokale Testinstallation ohne Container auf Ubuntu 26.04 LTS (amd64). Sie installiert die Rails-Webanwendung mit SQLite im eigenen Benutzerkonto. Für die Teilnahme an einem bestehenden Hochschulkurs genügt normalerweise der Browser mit der von der Hochschule mitgeteilten Adresse.
Kompatibilitätsstand: Die offizielle manuelle Anleitung behandelt Ubuntu 22.04. Die Übertragung auf Ubuntu 26.04 wurde hier anhand des Quellcodes vorbereitet, aber nicht praktisch durchinstalliert. Insbesondere das Übersetzen älterer Ruby-Erweiterungen kann Anpassungen erfordern. Dieser Aufbau ist deshalb keine bestätigte Produktionsinstallation.
Der geprüfte Quellstand bindet Ruby 3.2.2 und Rails 6.1.7.6. Ruby 3.2 erhält seit April 2026 keine Pflege mehr; siehe den Ruby-Wartungsstatus. Verwende diese Testinstanz ausschließlich lokal und ohne echte Studierendendaten. Für einen öffentlichen Lehrbetrieb müssen die veralteten Abhängigkeiten zuerst durch eine unterstützte und getestete Kombination ersetzt werden.
Automatische Bewertungen übernimmt der separate Dienst Tango. Dessen dokumentierte Ausführungsumgebungen verwenden Docker oder AWS-EC2-VMs. Dieser lokale Aufbau enthält weder Tango noch automatische Programmausführung. Die Webanwendung kann unabhängig davon laufen; siehe die Komponentenübersicht und die Tango-Anleitung. Redis und MySQL werden für diesen SQLite-Versuch nicht benötigt.
Voraussetzungen installieren
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren Paketversionen kennt.
sudo apt update
2. Hilfsprogramme und Entwicklungsbibliotheken installieren
Die Compiler und Bibliotheken werden zum Bauen von Ruby und nativen Gems gebraucht. Die MySQL-Entwicklungsbibliothek bleibt erforderlich, weil Autolab das Gem mysql2 auch bei dieser SQLite-Konfiguration installiert. Ein MySQL-Server wird dadurch nicht eingerichtet.
sudo apt install build-essential git curl ca-certificates autoconf bison patch libssl-dev libyaml-dev libreadline-dev libncurses-dev libgdbm-dev libffi-dev zlib1g-dev libmysqlclient-dev libjansson-dev universal-ctags sqlite3 libsqlite3-dev pkg-config shared-mime-info openssl perl nano rbenv ruby-build
3. rbenv für dieses Terminal aktivieren
Ubuntu liefert rbenv als Paket. Damit lässt sich die vom Projekt verlangte Ruby-Version zusätzlich zum System-Ruby verwenden. Wiederhole diesen Schritt in einem neuen Terminal vor der Arbeit an Autolab.
eval "$(rbenv init - bash)"
4. Plugin-Verzeichnis anlegen
Hier wird eine aktuelle Bauanleitung für Ruby abgelegt, damit der Build nicht von der Version des Ubuntu-Pakets ruby-build abhängt.
mkdir -p ~/.rbenv/plugins
5. Aktuelles ruby-build laden
Das offizielle Plugin kennt zusätzliche Build-Korrekturen. Falls dieses Verzeichnis bereits existiert, verwende deine vorhandene Installation und aktualisiere sie bei Bedarf, statt sie zu überschreiben.
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
Quellcode und Ruby einrichten
6. Ins Home-Verzeichnis wechseln
Autolab erhält einen eigenen Ordner im Benutzerkonto.
cd ~
7. Repository herunterladen
Lädt den Quellcode. Der Zielordner darf noch nicht existieren.
git clone https://github.com/autolab/Autolab.git autolab-cmu
8. Projektordner öffnen
Alle weiteren Autolab-Befehle beziehen sich auf diesen Ordner.
cd ~/autolab-cmu
9. Geprüften Quellstand auswählen
Der feste Commit verhindert, dass spätere Änderungen unbemerkt andere Voraussetzungen einführen. Git meldet dabei einen abgetrennten HEAD; für diesen Installationsversuch ist das vorgesehen.
git checkout --detach 5497901b2dfac43d73404e9059dde2067a733346
10. Ruby übersetzen und installieren
Verwendet die Version aus .ruby-version. RUBY_BUILD_VENDOR_OPENSSL=1 lässt ruby-build eine zu dieser alten Ruby-Version passende OpenSSL-Bibliothek mitbauen, statt sich auf die neuere Systembibliothek zu verlassen. Ruby und diese Bibliothek landen im Benutzerkonto. Die ruby-build-Dokumentation erläutert die Option.
RUBY_BUILD_VENDOR_OPENSSL=1 rbenv install --skip-existing "$(cat .ruby-version)"
Prüfen: Im Projektordner muss Ruby 3.2.2 aus deinem rbenv-Verzeichnis verwendet werden.
rbenv which ruby
ruby --version
11. Passenden Bundler installieren
Verwendet die in Gemfile.lock festgelegte Version des Ruby-Paketmanagers. Hier und bei allen folgenden Gem-Befehlen ist kein sudo nötig.
gem install bundler -v 2.5.3 --no-document
12. Gems im Projektordner ablegen
Die Bibliotheken werden getrennt von anderen Ruby-Projekten unter vendor/bundle gespeichert.
bundle _2.5.3_ config set --local path vendor/bundle
13. Projektabhängigkeiten installieren
Bundler verwendet die vorhandene Sperrdatei. Das Bauen nativer Erweiterungen kann mehrere Minuten dauern und viel Speicher benötigen. Bricht es mit einem Compilerfehler ab, ist die Installation noch nicht abgeschlossen; entferne dann nicht einfach Versionsbindungen aus der Gemfile.
bundle _2.5.3_ install
Prüfen: Bundler soll alle Abhängigkeiten als erfüllt melden.
bundle check
Lokale Einstellungen
14. Datenbankkonfiguration anlegen
SQLite speichert die Daten direkt als Dateien. Öffne die neue Konfiguration und füge den nachfolgenden Inhalt ein.
nano config/database.yml
development:
adapter: sqlite3
database: db/autolab_development.sqlite3
pool: 5
timeout: 5000
test:
adapter: sqlite3
database: db/autolab_test.sqlite3
pool: 5
timeout: 5000
Speichere mit Strg+O, bestätige mit Enter und beende nano mit Strg+X.
15. Organisationskonfiguration kopieren
Erzeugt die lokale Datei aus der zum Quellstand gehörenden Vorlage.
cp config/school.yml.template config/school.yml
16. Organisation anpassen
Ändere im Abschnitt development beispielsweise school_name auf Lokaler Autolab-Test und school_short_name auf TEST. Trage eigene Kontaktadressen ein. Dadurch gibt sich deine unabhängige Testinstanz nicht als CMU-Installation aus.
nano config/school.yml
17. Autograding-Konfiguration vorbereiten
Auch ohne laufenden Tango-Dienst wird die vom Projekt vorgesehene Konfigurationsdatei angelegt. Automatische Bewertungen werden dadurch noch nicht eingerichtet.
cp config/autogradeConfig.rb.template config/autogradeConfig.rb
18. Umgebungsdatei anlegen
Die Datei nimmt Schlüssel und lokale Verbindungsangaben auf.
cp .env.template .env
19. Lokale URL einstellen
Ersetze in der Datei die Zeile für MAILER_HOST durch MAILER_HOST=localhost:3000. Mailversand wird in dieser Anleitung nicht eingerichtet. Die Tango-Werte RESTFUL_HOST, RESTFUL_PORT und RESTFUL_KEY bleiben zunächst leer.
nano .env
20. Zufällige Anwendungsschlüssel erzeugen
Das mitgelieferte Skript ersetzt die Schlüsselplatzhalter in .env. Führe es bei einer bestehenden Instanz nicht als routinemäßigen Startschritt aus.
./bin/initialize_secrets.sh
21. Schlüsseldatei schützen
Beschränkt den Dateizugriff auf dein Benutzerkonto.
chmod 600 .env
Datenbank und Anmeldung
22. Entwicklungsdatenbank anlegen
Erzeugt die lokale SQLite-Datei, ohne eine vorhandene Datenbank zurückzusetzen.
RAILS_ENV=development bundle exec rails db:create
23. Datenbankschema einrichten
Die Migrationen legen die benötigten Tabellen an. Ein Fehler muss behoben werden, bevor du mit dem Serverstart fortfährst.
RAILS_ENV=development bundle exec rails db:migrate
24. Administratorkonto anlegen
Das Projektskript fragt E-Mail-Adresse, Passwort und Namen ab. -d wählt die Entwicklungsdatenbank. Verwende für diesen Test ein eigenes Passwort ohne Kommas oder eckige Klammern, weil das Skript die Eingaben als Rake-Argumentliste weitergibt.
./bin/initialize_user.sh -d
Starten und prüfen
25. Webanwendung starten
Bindet den Entwicklungsserver ausschließlich an die lokale IPv4-Adresse. Lass dieses Terminal geöffnet.
RAILS_ENV=development bundle exec rails server --binding=127.0.0.1 --port=3000
26. HTTP-Verbindung prüfen
Führe die Abfrage in einem zweiten Terminal aus. Erwartet wird eine erfolgreiche Antwort oder eine Weiterleitung zur Anmeldung. Ein Status 500 weist auf einen Anwendungsfehler hin; Details stehen im Serverterminal.
curl --head http://127.0.0.1:3000/
27. Im Browser anmelden
Öffne diese Adresse und verwende das in Schritt 24 angelegte Konto. Prüfe, ob du die Kursverwaltung öffnen kannst. Autograding-Funktionen bleiben ohne Tango unbenutzbar.
http://127.0.0.1:3000
28. Server beenden
Drücke im Serverterminal Strg+C. Zum erneuten Start aktivierst du rbenv wie in Schritt 3, wechselst in den Projektordner und wiederholst Schritt 25. Datenbank und Abgaben bleiben im Projektverzeichnis erhalten.
Deinstallieren
1. Autolab beenden
Drücke im Serverterminal Strg+C, damit keine Dateien mehr geschrieben werden.
2. Projektordner entfernen
Achtung: Dieser Befehl löscht die Testdatenbank, Abgaben, Schlüssel und alle eigenen Änderungen im Projekt. Sichere benötigte Dateien vorher.
rm -rf -- ~/autolab-cmu
3. Optional: Ruby-Version entfernen
Nur ausführen, wenn kein anderes Projekt Ruby 3.2.2 aus rbenv verwendet. Die übrigen rbenv-Versionen bleiben erhalten.
rbenv uninstall 3.2.2
4. Entfernung prüfen
Die Ausgabe soll Autolab entfernt lauten. Systembibliotheken und rbenv bleiben für andere Projekte installiert; es wurde kein eigener Datenbankdienst eingerichtet.
test ! -e ~/autolab-cmu && echo 'Autolab entfernt'
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.
nbgrader
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
nbgrader hilft dabei, Aufgaben in Jupyter-Notebooks zu erstellen, Abgaben zu prüfen und Bewertungen zu verwalten.
Voraussetzungen und Aufbau
Diese Anleitung richtet nbgrader auf Ubuntu 26.04 LTS (amd64) für die lokale Arbeit im eigenen Benutzerkonto ein. JupyterLab liefert die Oberfläche im Browser. Ein eigener Datenbankserver und Container sind nicht erforderlich.
Die Systemwerkzeuge kommen aus apt. nbgrader wird nach dem offiziellen Installationsweg mit pip in eine eigene virtuelle Python-Umgebung installiert. So bleiben Ubuntu-Pakete und die Pakete dieser Anwendung getrennt. Eine virtuelle Python-Umgebung ist kein Container.
Stand November 2026 ist nbgrader 0.9.6 verfügbar und verlangt Python ab 3.11. Diese Anleitung verwendet diese Version mit JupyterLab 4 und dem Python von Ubuntu. Die vollständige Installation auf Ubuntu 26.04 wurde hier nicht praktisch getestet.
Bei der Bewertung beachten: Notebook-Code läuft mit den Rechten des Benutzerkontos, das den Kernel startet. Die virtuelle Python-Umgebung schützt weder deine Dateien noch dein Netzwerk vor fremdem Code. Führe fremde Abgaben deshalb ausschließlich in einer dafür vorgesehenen, getrennten Ausführungsumgebung aus. Die folgenden Schritte dienen zunächst der Arbeit mit eigenen Beispielen.
Installation
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren Paketversionen kennt.
sudo apt update
2. Python-Werkzeuge installieren
python3-venv stellt die getrennte Python-Umgebung bereit. python3-pip liefert den Paketmanager; der Browser wird später nur zur Bedienung verwendet.
sudo apt install python3 python3-venv python3-pip
Prüfen: Auf Ubuntu 26.04 sollte Python 3.14 angezeigt werden.
python3 --version
3. Arbeitsordner anlegen
Hier werden die Python-Umgebung und später deine Kursordner gespeichert.
mkdir -p ~/nbgrader-arbeitsplatz
4. In den Arbeitsordner wechseln
Alle folgenden relativen Pfade beziehen sich zunächst auf diesen Ordner.
cd ~/nbgrader-arbeitsplatz
5. Python-Umgebung erstellen
Erzeugt .venv mit eigenen Paketverzeichnissen. Verwende einen neuen Arbeitsordner, falls dort bereits eine Umgebung für einen anderen Zweck liegt.
python3 -m venv .venv
6. Python-Umgebung aktivieren
Die Befehle python, pip, jupyter und später nbgrader werden in diesem Terminal aus der Umgebung verwendet.
source .venv/bin/activate
Prüfen: Der Pfad muss auf .venv/bin/python im Arbeitsordner zeigen.
command -v python
7. pip innerhalb der Umgebung aktualisieren
Eine aktuelle Version verbessert die Erkennung passender Paketdateien für das Python von Ubuntu.
python -m pip install --upgrade pip
8. nbgrader und Notebook-Werkzeuge installieren
Installiert die festgelegte nbgrader-Version, JupyterLab 4 und einen Python-Kernel. Alle Pakete landen in .venv; sudo ist hier nicht erforderlich. Die nbgrader-Erweiterungen werden automatisch mit eingerichtet. Ein separates Node.js oder ein manueller JavaScript-Build ist für diesen Installationsweg nicht nötig.
python -m pip install 'nbgrader==0.9.6' 'jupyterlab>=4.2,<5' ipykernel
9. Paketabhängigkeiten prüfen
Die Ausgabe soll No broken requirements found lauten. Bei Konflikten behebe zuerst die gemeldeten Abhängigkeiten, bevor du einen Kurs anlegst.
python -m pip check
10. nbgrader-Version prüfen
Damit lässt sich feststellen, ob der Programmaufruf aus der neuen Umgebung funktioniert. Erwartet wird Version 0.9.6.
nbgrader --version
11. JupyterLab-Erweiterung prüfen
Die Ausgabe soll die Erweiterung @jupyter/nbgrader als aktiviert und ohne Kompatibilitätsfehler aufführen.
jupyter labextension list
12. Server-Erweiterungen prüfen
Kontrolliert die nbgrader-Komponenten auf der Serverseite. Die Einträge unter nbgrader.server_extensions sollen aktiviert sein und die Validierung bestehen.
jupyter server extension list
Einen Beispielkurs öffnen
13. Beispielkurs erzeugen
quickstart legt einen Kursordner mit Beispieldateien und einer Kurskonfiguration an. Der Name uebungskurs darf im Arbeitsordner noch nicht als Kursverzeichnis existieren.
nbgrader quickstart uebungskurs
14. In den Kursordner wechseln
nbgrader findet seine Kurskonfiguration über das aktuelle Arbeitsverzeichnis. Starte JupyterLab deshalb für diesen Versuch von hier aus.
cd ~/nbgrader-arbeitsplatz/uebungskurs
Prüfen: Im Verzeichnis sollten unter anderem nbgrader_config.py und der Ordner source liegen. source enthält die Lehrendenfassung der Aufgaben; gib diesen Ordner nicht als Studierendenfassung weiter.
ls
15. JupyterLab starten
Der Server lauscht nur auf dem eigenen Rechner. Die Anmeldung über den automatisch erzeugten Token bleibt eingeschaltet. Das Terminal bleibt während des Betriebs belegt.
jupyter lab --ip=127.0.0.1 --port=8888 --no-browser
16. Oberfläche im Browser öffnen
Kopiere die im Terminal ausgegebene vollständige lokale URL einschließlich token=… in den Browser. Der Token gewährt Zugang zu dieser Sitzung; teile ihn nicht mit anderen Personen.
17. Aufgabenverwaltung prüfen
Öffne in JupyterLab über View → Activate Command Palette die Befehlssuche, suche nach formgrader und öffne den entsprechenden nbgrader-Befehl. Die Aufgabenverwaltung soll als zusätzlicher Tab erscheinen. Diesen Einstieg beschreibt auch die offizielle Anleitung zur Aufgabenbearbeitung.
18. Ein Beispielnotebook öffnen
Öffne im Dateibrowser unter source einen Aufgabenordner und darin ein Notebook. Verwende bei Bedarf den Kernel Python 3 (ipykernel). Die nbgrader-Seitenleiste Create Assignment dient zum Kennzeichnen von Antwort- und Testzellen. Für einen ersten Funktionstest genügen die eigenen Beispieldateien.
19. JupyterLab beenden
Drücke im Serverterminal Strg+C und bestätige die Beendigung, falls Jupyter nachfragt. Das Schließen des Browserfensters allein beendet den Server nicht.
Später erneut starten
1. Umgebung aktivieren
In einem neuen Terminal muss die Umgebung erneut ausgewählt werden.
source ~/nbgrader-arbeitsplatz/.venv/bin/activate
2. Kursordner öffnen
Damit die richtige Kurskonfiguration verwendet wird.
cd ~/nbgrader-arbeitsplatz/uebungskurs
3. JupyterLab starten
Verwende anschließend wieder die im Terminal ausgegebene URL mit Token.
jupyter lab --ip=127.0.0.1 --port=8888 --no-browser
Typische Probleme
externally-managed-environment: Aktiviere die Umgebung aus Schritt 6. Verwende keinsudo pipund kein--break-system-packages.- Erweiterung fehlt: Beende JupyterLab und starte es aus derselben aktivierten Umgebung, in der nbgrader installiert ist. Wiederhole die beiden Erweiterungsprüfungen und lade die Browserseite neu. Alte Befehle mit
jupyter nbextensionbetreffen die klassische Notebook-Oberfläche und passen nicht zu diesem Aufbau. - Kernel fehlt oder startet nicht: Prüfe mit dem folgenden Befehl die verfügbaren Kernel. Der Kernel muss auf ein noch vorhandenes Python zeigen.
jupyter kernelspec list
- Port 8888 ist belegt: Jupyter kann einen anderen freien Port verwenden. Maßgeblich ist die tatsächlich im Terminal ausgegebene URL.
- Paketinstallation scheitert: Lies die erste konkrete Fehlermeldung. Eine Mindestanforderung wie Python ab 3.11 garantiert nicht, dass jede Abhängigkeit mit jeder neueren Python-Version funktioniert.
Für mehrere Lehrende und Studierende ist eine zusätzliche Benutzer- und Austauschkonfiguration erforderlich. Die lokale Einzelplatzinstallation richtet weder JupyterHub noch einen gemeinsamen Abgabedienst ein. Hinweise dazu stehen in der Dokumentation zu JupyterHub.
Deinstallieren
1. JupyterLab beenden
Drücke im Serverterminal Strg+C und bestätige gegebenenfalls die Rückfrage, damit keine Kursdateien mehr geschrieben werden.
2. Python-Umgebung verlassen
Führe dies in einem Terminal mit aktivierter Umgebung aus. Dadurch verwendet das Terminal wieder die normalen Systembefehle.
deactivate
3. Python-Umgebung entfernen
Löscht nbgrader, JupyterLab und alle zusätzlich in dieser Umgebung installierten Pakete. Die Kursordner bleiben erhalten. Es wurde kein Kernel mit --user registriert, der zusätzlich entfernt werden müsste.
rm -rf -- ~/nbgrader-arbeitsplatz/.venv
4. Optional: Arbeitsordner samt Kursdaten löschen
Achtung: Dabei gehen auch Aufgaben, Lösungen, Abgaben und die Bewertungsdatenbank in diesem Ordner verloren. Sichere benötigte Kursdaten vorher.
rm -rf -- ~/nbgrader-arbeitsplatz
5. Entfernung der Umgebung prüfen
Die Ausgabe soll nbgrader-Umgebung entfernt lauten. Das System-Python und seine Ubuntu-Werkzeuge bleiben installiert.
test ! -e ~/nbgrader-arbeitsplatz/.venv && echo 'nbgrader-Umgebung entfernt'
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.
Code-Ausführungsdienste und Sandboxes
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Übersicht führt zu den Anleitungen für Ubuntu 26.04 LTS (amd64).
-
Wähle einen HTTP-Ausführungsdienst oder eine lokale Sandbox.
Werkzeug Betriebsart Anleitung Judge0, GPL-3.0 Offiziell Docker; CE 1.13.1 benötigt cgroup v1 und ist auf dem vorgesehenen Host nicht als funktionierende Installation belegt Kompatibilitätsgrenze Piston, MIT Docker mit cgroup v2; lokal gebundene API Piston Jobe, MIT Apache/PHP direkt auf Ubuntu; Docker nicht erforderlich Jobe Isolate, GPL-2.0-or-later Direkte Sandboxinstallation über APT Isolate bubblewrap und systemd-run Eigener lokaler Python-Runner ohne Docker Runner -
Folge der jeweiligen Anleitung. Die dortigen Ausführungstests sind nötig, weil ein gestarteter Server noch keine funktionierenden Sandboxlimits beweist.
-
Entferne den Aufbau bei Bedarf mit den Deinstallationsschritten des jeweiligen Kapitels. Entferne systemd nicht von Ubuntu.
Die ausdrückliche Docker-Auswahl gilt hier für Judge0 und Piston. Die nativen Wege für Jobe und Isolate bleiben erhalten. Keiner der lokalen Einstiege richtet eine öffentliche, authentifizierte Mehrbenutzerplattform ein.
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.
Judge0
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Judge0 nimmt Quellcode über eine HTTP-API entgegen und lässt Programme durch getrennte Arbeitsprozesse übersetzen und ausführen.
Docker und Ubuntu 26.04
Docker ist für dieses Kapitel durch die ausdrückliche Produktwahl erlaubt. Judge0 CE 1.13.1 lässt sich mit dem dokumentierten offiziellen Docker-Weg dennoch nicht als funktionierende Standardinstallation auf Ubuntu 26.04 darstellen. Die Bereitstellung setzt cgroup v1 voraus. Ubuntu 26.04 verwendet systemd 259 und cgroup v2; seit systemd 258 wird cgroup v1 nicht mehr unterstützt. Docker liefert keinen eigenen Hostkernel und beseitigt diesen Unterschied nicht.
Die alte GRUB-Einstellung aus der Judge0-Anleitung wird daher hier nicht angewendet. Für CE 1.13.1 kommt eine getrennte VM mit dem dort dokumentierten Ubuntu 22.04 infrage; das ist ein anderes Zielsystem. Ein aktueller, nachweislich cgroup-v2-kompatibler Judge0-Aufbau müsste separat geprüft werden. Die folgenden Schritte laden nur Quellcode und installieren keinen Dienst.
1. cgroup-Modus prüfen
Auf dem vorgesehenen Ubuntu 26.04 ist cgroup2fs zu erwarten.
stat -fc %T /sys/fs/cgroup
2. systemd-Version prüfen
Zeigt die Version des Hosts; dies ist keine Prüfung eines Judge0-Containers.
systemd-run --version
Quellen: offizielle Judge0-Bereitstellung, systemd-Änderungen zu Version 258 und Ubuntu-26.04-Paket.
Geprüft wurde der offizielle Quellstand d0632c. Die Bereitstellungsanleitung für CE 1.13.1 nennt Ubuntu 22.04 und verlangt eine Umstellung auf cgroup v1. Das passt nicht als unveränderte Anleitung für Ubuntu 26.04 mit cgroup v2.
Der Dockerfile baut auf einem vorbereiteten Compiler-Image auf und setzt Ruby 2.7.0 sowie Bundler 2.1.4 voraus. Für einen nativen Betrieb fehlen damit nicht nur Rails, PostgreSQL und Redis: Auch Compilerbestände, feste Pfade, Sandbox und Startumgebung müssen aufeinander abgestimmt werden. Das Installieren eines gleichnamigen Client-SDKs richtet diese Dienste nicht ein.
Die Serverskripte enthalten Containerannahmen wie /api und einen Start auf allen Netzwerkschnittstellen. Ihre unveränderte Übernahme einschließlich der weitreichenden sudo-Regel aus dem Dockerfile ist keine geeignete Hostinstallation.
Quellcode zur Vorbereitung prüfen
Die folgenden optionalen Schritte laden ausschließlich Quellcode. Sie installieren weder einen Dienst noch eine Sandbox und ändern keine Bootparameter.
1. Paketlisten aktualisieren
Damit Ubuntu die aktuellen Informationen für Git kennt.
sudo apt update
2. Git installieren
Wird zum Abrufen und Prüfen des offiziellen Repositorys benötigt.
sudo apt install git ca-certificates
3. In das Home-Verzeichnis wechseln
Der Prüfordner wird im eigenen Benutzerkonto angelegt.
cd ~
4. Quellcode herunterladen
Der Zielordner darf noch nicht existieren.
git clone https://github.com/judge0/judge0.git judge0-quellpruefung
5. Prüfordner öffnen
Die weiteren Befehle beziehen sich auf dieses Repository.
cd ~/judge0-quellpruefung
6. Dokumentierten Stand auswählen
So beziehen sich die folgenden Prüfungen auf dieselben Dateien wie dieses Kapitel.
git checkout --detach d0632cffaaf4fcdbf83a83e7a55ed9baf8a86db6
7. Offizielle Bereitstellung lesen
Prüfe insbesondere den ersten Abschnitt Deployment Procedure und dessen Voraussetzungen.
less CHANGELOG.md
8. Native Startannahmen prüfen
Zeigt die Startbefehle; dieser Befehl führt die Skripte nicht aus.
cat scripts/server scripts/workers
Was für eine native Installation offenbleibt
Eine belastbare Portierung muss die Ruby- und Rails-Abhängigkeiten, Datenbank, Warteschlange, Worker, Compilerpfade, Sandbox mit cgroup v2 sowie eng begrenzte Dienstrechte gemeinsam einrichten und testen. Ein Austausch gegen aktuelles Isolate allein erfüllt das nicht. Änderungen an GRUB oder eine pauschale sudo-Freigabe werden hier deshalb nicht als Installationsschritt angeboten.
Installationsprüfung: Nach den obigen Schritten ist nur der Quellcode vorhanden. Eine echte Inbetriebnahme müsste mindestens die Sprachliste unter /languages, eine erfolgreiche /submissions-Anfrage sowie Zeit-, Speicher- und Netzwerkbegrenzungen überprüfen. Ein antwortender Rails-Server allein belegt noch keine funktionierende Sandbox.
Für einen direkt auf Ubuntu installierbaren Ausführungsdienst siehe Jobe; für eine lokale Sandbox ohne HTTP-API siehe Isolate. Beide haben andere Schnittstellen und ersetzen Judge0 nicht unverändert.
Prüfordner entfernen
1. Quellcode löschen
Entfernt nur den in dieser Anleitung angelegten Prüfordner. Eigene Änderungen darin gehen verloren. Es wurden keine Judge0-Dienste installiert, die zusätzlich deinstalliert werden müssten.
rm -rf -- ~/judge0-quellpruefung
2. Entfernung prüfen
Die Ausgabe soll Judge0-Prüfordner entfernt lauten.
test ! -e ~/judge0-quellpruefung && echo 'Judge0-Prüfordner entfernt'
Lizenz
Judge0 steht unter GPL-3.0. Docker ist eine Bereitstellungsform und ändert die Softwarelizenz nicht.
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.
Piston
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Piston führt Quellcode über eine lokale HTTP-API mit separat installierten Sprachlaufzeiten aus.
Vorbemerkungen
- Docker-Ausnahme: Diese Anleitung beschreibt Ubuntu 26.04 LTS (amd64) mit Docker und cgroup v2. Der offizielle Piston-Aufbau benötigt einen privilegierten Container; Docker ist hier ausdrücklich vorgesehen und damit eine begründete Ausnahme zur sonst containerfreien Vorgabe dieses Buchs.
- Sicherheit: Verwende für Piston einen separaten Ausführungsrechner oder eine virtuelle Maschine. Die API wird in dieser Anleitung ausschließlich an
127.0.0.1(localhost) gebunden, besitzt jedoch keine Authentifizierung – alle lokalen Programme können die API erreichen. - Sprachlaufzeiten: Der Piston-Kerncontainer enthält noch keine Compiler oder Interpreter; diese werden nach dem Start über die Paket-API separat installiert.
- Alternative ohne Docker: Wer Code direkt ohne Docker ausführen möchte, findet in Jobe oder dem eigenen Runner mit bubblewrap und systemd-run native Alternativen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aller benötigten Pakete aus den Ubuntu-Quellen kennt.
sudo apt update
2. Docker und Hilfswerkzeuge installieren
Installiert Docker und das Compose-Plugin direkt aus den offiziellen Ubuntu-Paketquellen, ohne fremde Installationsskripte.
sudo apt install docker.io docker-compose-v2 curl ca-certificates
3. Docker starten
Aktiviert den Docker-Dienst sofort und sorgt dafür, dass er auch nach einem Systemneustart automatisch läuft.
sudo systemctl enable --now docker
4. Docker prüfen
Prüft, ob Docker-Client und Docker-Daemon ordnungsgemäß gestartet sind und reagieren.
sudo docker version
5. Compose prüfen
Stellt sicher, dass das Compose-Plugin für Docker funktionsfähig ist.
sudo docker compose version
6. cgroup-Version prüfen
Piston benötigt cgroup v2. Die Ausgabe muss cgroup2fs lauten.
stat -fc %T /sys/fs/cgroup
7. Projektordner anlegen
Erstellt einen eigenen Ordner für die Piston-Konfiguration und die Daten.
mkdir ~/piston-lab
8. In den Projektordner wechseln
Alle weiteren Konfigurationsbefehle beziehen sich auf diesen Ordner.
cd ~/piston-lab
9. Compose-Konfiguration anlegen
Erstellt die Datei compose.yaml. Der Port 2000 wird gezielt nur an 127.0.0.1 gebunden, und ein Docker-Volume speichert die nachinstallierten Sprachpakete dauerhaft.
cat > compose.yaml <<'EOF'
services:
api:
image: ghcr.io/engineer-man/piston:latest
privileged: true
restart: unless-stopped
ports:
- "127.0.0.1:2000:2000"
volumes:
- packages:/piston/packages
tmpfs:
- /tmp:exec
volumes:
packages:
EOF
10. Konfiguration testen
Prüft die compose.yaml auf Syntaxfehler, bevor der Dienst gestartet wird.
sudo docker compose config --quiet
11. Image herunterladen
Lädt das offizielle Piston-Container-Image aus der GitHub-Container-Registry herunter.
sudo docker compose pull
12. Image-Digest festhalten
Ermittelt den kryptografischen Prüfwert (Digest) des geladenen Images zur Dokumentation des genauen Softwarestands.
sudo docker image inspect ghcr.io/engineer-man/piston:latest --format '{{index .RepoDigests 0}}'
13. Piston starten
Startet den Piston-Dienst als Hintergrundcontainer.
sudo docker compose up -d
14. Sprachliste abrufen
Fragt die verfügbaren Sprachlaufzeiten ab. Unmittelbar nach dem Start ist diese Liste noch leer.
curl --fail --show-error http://127.0.0.1:2000/api/v2/runtimes
15. Python-Laufzeit installieren
Lädt über die Paket-API von Piston die aktuelle Python-Laufzeitumgebung in das Docker-Volume herunter.
curl --fail --show-error \
--header 'Content-Type: application/json' \
--data '{"language":"python","version":"*"}' \
http://127.0.0.1:2000/api/v2/packages
Prüfung
1. Installierte Laufzeit prüfen
Prüft, ob Python jetzt in der Liste der installierten Laufzeiten aufgeführt wird.
curl --fail --show-error http://127.0.0.1:2000/api/v2/runtimes
2. Eigenen Programmcode ausführen
Sendet ein kleines Python-Skript an die API zur Ausführung in der Sandbox. Erwartet wird der Rückgabecode 0 und die Ausgabe Piston bereit.
curl --fail --show-error \
--header 'Content-Type: application/json' \
--data '{"language":"python","version":"*","files":[{"name":"probe.py","content":"print(\"Piston bereit\")"}],"run_timeout":3000,"run_memory_limit":134217728}' \
http://127.0.0.1:2000/api/v2/execute
3. Zeitbegrenzung testen
Sendet eine Endlosschleife, um zu prüfen, ob Piston die Ausführung nach Ablauf des Zeitlimits zuverlässig abbricht.
curl --fail --show-error \
--header 'Content-Type: application/json' \
--data '{"language":"python","version":"*","files":[{"content":"while True: pass"}],"run_timeout":1000,"run_cpu_time":1000}' \
http://127.0.0.1:2000/api/v2/execute
4. Dienst-Protokolle einsehen
Bei Fehlern lassen sich die Ausgaben des Piston-Containers anzeigen.
sudo docker compose logs --tail=80 api
Deinstallation
1. Container stoppen und entfernen
Beendet den Piston-Dienst im Ordner ~/piston-lab.
cd ~/piston-lab && sudo docker compose down
2. Sprachpakete und Volumes löschen
Entfernt auch das Docker-Volume mit den heruntergeladenen Sprachpaketen.
cd ~/piston-lab && sudo docker compose down --volumes
3. Entfernung prüfen
Stellt sicher, dass keine Piston-Container mehr vorhanden sind.
sudo docker compose ps --all
4. Projektordner löschen
Entfernt den Konfigurationsordner.
rm -rf ~/piston-lab
5. Docker optional deinstallieren
Falls Docker ausschließlich für diesen Test installiert wurde, können die Pakete wieder entfernt werden.
sudo apt purge docker.io docker-compose-v2
Quellen und Lizenz
- Piston: Quellcode und API-Dokumentation stehen unter der MIT-Lizenz.
- Referenzen: Offizielles Repository, Compose-Vorlage und Ubuntu-Paketseite docker-compose-v2.
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.
Jobe
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Jobe führt kleine Programmieraufgaben über eine HTTP-Schnittstelle aus und dient unter anderem als Ausführungsdienst für Moodle CodeRunner.
Voraussetzungen und Grenzen
Diese Anleitung beschreibt eine native Installation auf Ubuntu 26.04 LTS (amd64) mit Apache und PHP, ohne Docker. Für den Einstieg werden Python 3, C und C++ eingerichtet. Weitere Sprachen können später ergänzt werden.
Die offizielle Anleitung behandelt vor allem Ubuntu 22.04. Die hier beschriebenen Anpassungen für Ubuntu 26.04 wurden anhand des Quellstands bfca53c vorbereitet, aber nicht vollständig auf dem Zielsystem ausgeführt. Die HTTP- und Ausführungstests am Ende sind deshalb erforderlich, bevor du diesen Aufbau verwendest.
Rechnerwahl: Verwende einen eigenen Testrechner oder eine separate Ubuntu-VM ohne persönliche Daten. Jobe legt Systembenutzer und privilegierte sudo-Regeln an. Sein runguard begrenzt Prozesse und Ressourcen, ersetzt aber keine vollständig abgeschottete virtuelle Maschine. Die API wird hier nur über 127.0.0.1:8081 bereitgestellt. Vor einem späteren Einsatz mit Moodle sind eigene Zugriffsregeln und eine Prüfung der Netzwerktrennung erforderlich.
Die Anleitung setzt voraus, dass noch keine Jobe-Installation und keine gleichnamigen Systembenutzer vorhanden sind. Apache muss eingerichtet werden können; auf einem Rechner mit bestehendem nginx, Apache oder PHP-FPM ist die Webserverkonfiguration vorher abzustimmen. Insbesondere darf Apache nicht ungeplant einen bereits belegten Port 80 übernehmen.
Pakete installieren
1. Paketlisten aktualisieren
Damit Ubuntu die aktuellen Paketversionen kennt.
sudo apt update
2. Webserver und Werkzeuge installieren
Installiert PHP für Apache, die von Jobe benötigten PHP-Module und Werkzeuge zum Bauen des Ausführungshelfers. Ein Datenbankserver ist für diesen Aufbau nicht erforderlich.
sudo apt install apache2 libapache2-mod-php php-cli php-mbstring php-intl php-xml php-curl acl git build-essential libcgroup-dev python3 curl ca-certificates sudo nano
3. PHP-Erweiterungen prüfen
Alle ausgegebenen Werte müssen true sein. Besonders die Funktionen für gemeinsamen Speicher und Semaphoren werden für die Jobverwaltung benötigt.
php -r 'var_dump(extension_loaded("intl"), extension_loaded("mbstring"), function_exists("sem_get"), function_exists("shm_attach"));'
Apache vor dem Download absichern
4. Zugriff auf den künftigen Quellordner sperren
Öffne diese neue Apache-Konfiguration und füge den folgenden Inhalt ein. Sie verhindert, dass der standardmäßige DocumentRoot den Quellcode über Port 80 ausliefert. Nur das öffentliche Verzeichnis erhält später einen lokalen Zugang.
sudo nano /etc/apache2/conf-available/jobe-local-access.conf
<Directory /var/www/html/jobe>
AllowOverride None
Require all denied
</Directory>
<Directory /var/www/html/jobe/public>
Options -Indexes +FollowSymLinks
AllowOverride All
Require local
</Directory>
Speichere mit Strg+O, bestätige mit Enter und beende nano mit Strg+X. Verwende dieselben Tasten auch bei den späteren Konfigurationsdateien.
5. Zugriffskonfiguration aktivieren
Macht die neuen Verzeichnisregeln für Apache verfügbar.
sudo a2enconf jobe-local-access
6. Rewrite-Modul aktivieren
Jobe bringt im öffentlichen Verzeichnis Regeln für seine URLs mit.
sudo a2enmod rewrite
7. Lokalen API-Endpunkt anlegen
Öffne die neue Site-Datei und trage den nachfolgenden Inhalt ein. Der zusätzliche Port wird ausschließlich an Loopback gebunden. Der Alias erhält den von den Jobe-Testwerkzeugen erwarteten Pfad /jobe/.
sudo nano /etc/apache2/sites-available/jobe-local.conf
Listen 127.0.0.1:8081
<VirtualHost 127.0.0.1:8081>
ServerName localhost
DocumentRoot /var/www/html/jobe/public
Alias /jobe/ /var/www/html/jobe/public/
ErrorLog ${APACHE_LOG_DIR}/jobe-error.log
CustomLog ${APACHE_LOG_DIR}/jobe-access.log combined
</VirtualHost>
8. Lokale Site aktivieren
Nimmt die zusätzliche Site in die Apache-Konfiguration auf.
sudo a2ensite jobe-local
9. Apache-Konfiguration prüfen
Die Ausgabe muss Syntax OK enthalten. Behebe Fehler, bevor du fortfährst.
sudo apache2ctl configtest
10. Apache-Einstellungen übernehmen
Aktiviert die Zugriffssperre und den lokalen Port, bevor Jobe heruntergeladen wird.
sudo systemctl restart apache2
Jobe einrichten
11. Quellcode in den vorgesehenen Ordner laden
Der Installer erwartet Jobe unter /var/www/jobe oder /var/www/html/jobe. Verwende keinen symbolischen Link aus einem anderen Verzeichnis. Der Zielordner darf noch nicht existieren.
sudo git clone https://github.com/trampgeek/jobe.git /var/www/html/jobe
12. Geprüften Stand auswählen
Verwendet den oben genannten Commit einschließlich der Sicherheitskorrekturen aus September 2026. Die veraltete Versionszeile am Anfang der README ist hierfür nicht maßgeblich.
sudo git -C /var/www/html/jobe checkout --detach bfca53c0a449815d5c228353260c37b9f6e57f3d
13. Anzahl gleichzeitiger Jobs begrenzen
Öffne die Jobe-Konfiguration und ändere die vorhandene Zeile für $jobe_max_users auf den folgenden Wert. Zwei gleichzeitige Jobs reichen für den lokalen Einstieg und begrenzen den anfänglichen Ressourcenbedarf. Lass debugging ausgeschaltet. Die Schlüsselprüfung bleibt für diesen ausschließlich lokalen Test im voreingestellten Zustand deaktiviert.
sudo nano /var/www/html/jobe/app/Config/Jobe.php
public int $jobe_max_users = 2;
14. Installationsordner öffnen
Das Installationsskript verwendet das aktuelle Verzeichnis für seine Pfade.
cd /var/www/html/jobe
15. Nativen Installer ausführen
Das Skript erzeugt die Jobe-Benutzer, Arbeitsverzeichnisse und sudo-Regeln und übersetzt runguard sowie den Aufräumhelfer. Es benötigt einen laufenden Apache zur Erkennung des Webserverbenutzers. Fahre nur fort, wenn die Installation ohne Fehler abgeschlossen wird.
sudo ./install
16. Programmdateien root zuordnen
Der Installer macht zunächst große Teile des Projektbaums für den Webserver schreibbar. Für diesen Aufbau wird der Code anschließend root zugeordnet. Auch die über sudo gestarteten Helfer und ihre übergeordneten Verzeichnisse müssen gegen Austausch durch den Webserver geschützt sein.
sudo chown -R root:root /var/www/html/jobe
17. Schreibrechte für Code beschränken
Verhindert Änderungen am Programmbaum durch Gruppe und andere Benutzer. Die Ausführungsrechte der vom Installer gebauten Helfer bleiben erhalten.
sudo chmod -R go-w /var/www/html/jobe
18. Webserver-Leserechte einrichten
Eine ACL erlaubt Apache das Lesen und Durchqueren des Programmbaums. Sie gibt ihm keine Schreibrechte auf Code oder privilegierte Helfer. Die root-eigenen Verzeichnisse verhindern deren Austausch.
sudo setfacl -R -m u:www-data:r-X /var/www/html/jobe
19. Laufzeitverzeichnis dem Webserver zuordnen
Nur writable innerhalb des Projektbaums muss für Logs und Framework-Caches beschreibbar bleiben. Die vom Installer eingerichteten Verzeichnisse unter /home/jobe und /var/log/jobe behalten ihre gesonderten Rechte.
sudo chown -R www-data:www-data /var/www/html/jobe/writable
20. UTF-8 für Apache einstellen
Öffne die Umgebungsdatei. Ersetze die vorhandene Einstellung für LANG durch die folgende Zeile, damit Programmausgaben mit Umlauten korrekt verarbeitet werden.
sudo nano /etc/apache2/envvars
export LANG=C.UTF-8
21. sudo-Regeln prüfen
Die Ausgabe darf keine Syntaxfehler enthalten. Die Jobe-Regeln müssen auf die Helfer im tatsächlichen Installationsordner zeigen.
sudo visudo -c
22. Apache neu starten
Übernimmt die UTF-8-Umgebung und startet die Anwendung mit den endgültigen Dateirechten.
sudo systemctl restart apache2
Installation prüfen
23. Sprachliste abrufen
Die Antwort soll eine JSON-Liste mit den verfügbaren Sprachen enthalten. Beim ersten Aufruf muss Jobe die vorhandenen Interpreter und Compiler erkennen; das kann länger dauern.
curl --fail --show-error http://127.0.0.1:8081/jobe/index.php/restapi/languages
24. Eigenen Python-Code ausführen
Dieser Test prüft zusätzlich die Jobvergabe und Programmausführung. Erwartet werden outcome mit dem Wert 15 und die Ausgabe Jobe funktioniert in stdout.
curl --fail --show-error \
--header 'Content-Type: application/json' \
--data '{"run_spec":{"language_id":"python3","sourcecode":"print(\"Jobe funktioniert\")","sourcefilename":"probe.py"}}' \
http://127.0.0.1:8081/jobe/index.php/restapi/runs
25. Bind-Adresse prüfen
Port 8081 muss an 127.0.0.1 gebunden sein. Andere Apache-Ports gehören zur allgemeinen Apache-Konfiguration und werden durch die zusätzliche Site nicht entfernt.
sudo ss -ltnp 'sport = :8081'
Bei HTTP-Fehlern prüfe das Jobe-Fehlerprotokoll. Eine erfolgreiche Sprachliste allein reicht nicht: Auch der Ausführungstest muss funktionieren. Werden Sandbox- oder PHP-Fehler gemeldet, ist der Aufbau noch nicht einsatzbereit.
sudo tail -n 50 /var/log/apache2/jobe-error.log
Für eine spätere Anbindung von Moodle müssen der lokale Listener und die Zugriffsregel bewusst auf den vorgesehenen Client angepasst werden. Richte dabei eine eigene API-Schlüsselkonfiguration und Netzbeschränkung ein; öffne diesen Dienst nicht allgemein für das Internet. Die Details der Jobe-Schnittstelle stehen im offiziellen Repository.
Deinstallieren
Die folgenden Schritte sind nur für die in dieser Anleitung neu eingerichtete Instanz bestimmt. Sie löschen deren Benutzer, Cache und Arbeitsdaten. Sichere benötigte Daten vorher und warte, bis alle Jobs beendet sind.
1. Lokale Site deaktivieren
Entfernt den zusätzlichen Listener aus der aktiven Konfiguration.
sudo a2dissite jobe-local
2. Apache neu starten
Beendet die bisherigen Webprozesse und übernimmt die deaktivierte Site.
sudo systemctl restart apache2
3. Privilegierte Jobe-Freigaben entfernen
Entzieht dem Webserver die Jobe-spezifischen sudo-Berechtigungen. Der Deinstaller entfernt diese Datei nicht selbst.
sudo rm -- /etc/sudoers.d/jobe-sudoers
4. Installationsordner öffnen
Der Deinstaller benötigt dieses Arbeitsverzeichnis.
cd /var/www/html/jobe
5. Jobe-Systemkonten und Arbeitsdaten entfernen
Das Projektskript entfernt die Jobe-Workerbenutzer sowie unter anderem /home/jobe und /var/log/jobe. Verwende es nicht, wenn diese Benutzer noch für eine andere Jobe-Instanz gebraucht werden.
sudo ./install --uninstall
6. Ins Home-Verzeichnis wechseln
Verlässt den Ordner, der anschließend gelöscht wird.
cd ~
7. Programmordner löschen
Entfernt den Jobe-Quellcode samt lokaler Einstellungen und Framework-Caches.
sudo rm -rf -- /var/www/html/jobe
8. Zugriffskonfiguration deaktivieren
Die Sperre für den inzwischen entfernten Ordner wird nicht mehr benötigt.
sudo a2disconf jobe-local-access
9. Site-Datei entfernen
Entfernt die von dieser Anleitung angelegte Listener-Konfiguration.
sudo rm -- /etc/apache2/sites-available/jobe-local.conf
10. Zugriffskonfiguration entfernen
Löscht ausschließlich die zusätzliche Jobe-Konfiguration.
sudo rm -- /etc/apache2/conf-available/jobe-local-access.conf
11. Apache-Konfiguration übernehmen
Apache, PHP und Compiler bleiben für andere Anwendungen installiert.
sudo systemctl reload apache2
Prüfen: Für Port 8081 soll keine Jobe-Listenerzeile mehr erscheinen. Kontrolliere außerdem mit sudo visudo -c, dass die verbleibenden sudo-Regeln gültig sind.
sudo ss -ltnp 'sport = :8081'
Lizenz und Betriebsart
Jobe steht unter MIT. Docker ist optional; dieses Kapitel verwendet weiterhin die native Installation.
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.
Isolate
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Isolate führt Programme mit begrenzten Ressourcen in einer Linux-Sandbox aus und wird unter anderem für Programmierwettbewerbe eingesetzt.
Voraussetzungen
Diese Anleitung installiert IOI Isolate direkt auf Ubuntu 26.04 LTS (amd64), ohne Docker oder Podman. Die Sandbox verwendet Linux-Namespaces und cgroup v2; diese Betriebssystemfunktionen sind auch ohne Containerverwaltung verfügbar. Isolate stellt keine Weboberfläche und keine HTTP-API bereit.
Der Hersteller bietet ein eigenes APT-Repository mit der Paketserie resolute-isolate für Ubuntu 26.04 an. Dort ist zum Recherchezeitpunkt Version 2.7 verfügbar. Grundlage sind das offizielle Repository, die Projektbeschreibung und das Handbuch.
Die Befehle wurden anhand dieser Quellen geprüft, aber auf diesem Rechner nicht ausgeführt. Verwende für fremde Programme einen separaten Ausführungsrechner ohne persönliche Daten. Isolate benötigt privilegierte Systemfunktionen; im folgenden Einzelplatztest werden die Aufrufe ausdrücklich mit sudo ausgeführt.
Installation über APT
1. Architektur prüfen
Diese Anleitung setzt die Ausgabe amd64 voraus.
dpkg --print-architecture
2. cgroup-Version prüfen
Ubuntu 26.04 verwendet normalerweise cgroup v2. Die Ausgabe muss cgroup2fs lauten; ändere für diese Anleitung keine Kernel-Bootparameter.
stat -fc %T /sys/fs/cgroup
3. Paketlisten aktualisieren
Lädt die aktuellen Paketinformationen der bereits eingerichteten Quellen.
sudo apt update
4. Downloadwerkzeuge installieren
curl lädt den Repository-Schlüssel über HTTPS.
sudo apt install curl ca-certificates nano
5. Schlüsselverzeichnis anlegen
Hier legt APT die Schlüssel zusätzlich eingerichteter Paketquellen ab.
sudo install -d -m 0755 /etc/apt/keyrings
6. Herstellerschlüssel herunterladen
Der Schlüssel wird im nächsten Schritt ausschließlich dieser Paketquelle zugeordnet.
sudo curl --fail --location https://www.ucw.cz/isolate/debian/signing-key.asc --output /etc/apt/keyrings/isolate.asc
7. Schlüsseldatei lesbar machen
Damit auch der eingeschränkte APT-Downloadbenutzer die Signatur prüfen kann.
sudo chmod 0644 /etc/apt/keyrings/isolate.asc
8. Paketquelle eintragen
Öffne die neue Datei und trage den folgenden Inhalt ein. resolute-isolate ist die Ubuntu-26.04-Serie; verwende hier keine Debian-Serie.
sudo nano /etc/apt/sources.list.d/isolate.sources
Types: deb
URIs: https://www.ucw.cz/isolate/debian/
Suites: resolute-isolate
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/isolate.asc
Speichere mit Strg+O, bestätige mit Enter und beende nano mit Strg+X.
9. Paketlisten erneut aktualisieren
Macht die Pakete der neuen Quelle verfügbar. Bei Signaturfehlern zuerst die Quelle und den Schlüssel prüfen; die Signaturprüfung nicht abschalten.
sudo apt update
10. Paketkandidaten prüfen
Die Ausgabe soll das Hersteller-Repository und Version 2.7 oder eine neuere Version ausweisen. Installiere keine alte 1.x-Fassung nach dieser Anleitung.
apt-cache policy isolate
11. Isolate installieren
APT richtet das Programm, seine Konfiguration und die Systemintegration ein.
sudo apt install isolate
12. cgroup-Dienst starten
Der Dienst hält den von systemd an Isolate delegierten cgroup-Bereich bereit. Er soll auch nach einem Neustart verfügbar sein.
sudo systemctl enable --now isolate.service
Prüfen: Die Ausgabe soll active lauten.
systemctl is-active isolate.service
Installation praktisch prüfen
13. Programmversion abfragen
Verwende ausdrücklich das über APT installierte Programm unter /usr/bin, falls zuvor eine selbst gebaute Fassung unter /usr/local/bin installiert wurde.
sudo /usr/bin/isolate --version
14. Test-Sandbox anlegen
Verwendet die Box-ID 42. Diese ID muss frei sein: --init kann eine bereits vorhandene Box zurücksetzen. Die Ausgabe nennt das Sandbox-Verzeichnis.
sudo /usr/bin/isolate --cg --box-id=42 --init
15. Eigenes Testprogramm ausführen
Das harmlose Beispiel gibt einen Text aus. CPU-Zeit, verstrichene Zeit und cgroup-Speicher werden begrenzt; der Speicherwert ist in KiB angegeben.
sudo /usr/bin/isolate --cg --box-id=42 --time=1 --wall-time=5 --cg-mem=65536 --processes=1 --run -- /usr/bin/printf 'Isolate funktioniert\n'
Prüfen: Neben Isolate funktioniert sollte eine erfolgreiche Statusmeldung erscheinen. Bei cgroup-Fehlern zuerst den Dienst und dessen Journal prüfen.
sudo journalctl -u isolate.service -n 30 --no-pager
16. Test-Sandbox entfernen
Gibt die Testbox und ihre Ressourcen wieder frei. Führe dies auch nach einem fehlgeschlagenen Test aus.
sudo /usr/bin/isolate --cg --box-id=42 --cleanup
Isolate 2.x ist nicht automatisch ein kompatibler Ersatz für die in Judge0 oder Piston eingebauten älteren beziehungsweise angepassten Sandbox-Versionen. Vor einer solchen Integration müssen Aufrufoptionen, Verzeichnisse und Ressourcenbegrenzungen gemeinsam geprüft werden.
Deinstallieren
1. Eigene Sandbox-Jobs beenden
Beende alle Anwendungen, die diese Isolate-Installation verwenden. Räume ihre Boxen vor dem Entfernen des Programms jeweils mit der zugehörigen Box-ID und --cleanup auf.
2. Dienst deaktivieren
Stoppt den cgroup-Hilfsdienst und seinen automatischen Start.
sudo systemctl disable --now isolate.service
3. Paket entfernen
Entfernt Isolate und paketverwaltete Konfigurationen.
sudo apt purge isolate
4. Paketquelle entfernen
Damit APT die zusätzliche Quelle nicht mehr abfragt.
sudo rm -- /etc/apt/sources.list.d/isolate.sources
5. Repository-Schlüssel entfernen
Der nur für diese Quelle verwendete Schlüssel wird nicht mehr benötigt.
sudo rm -- /etc/apt/keyrings/isolate.asc
6. Paketlisten aktualisieren
Übernimmt die entfernte Quelle in den lokalen Paketinformationen.
sudo apt update
Prüfen: Der folgende Befehl soll melden, dass /usr/bin/isolate entfernt wurde. Andere manuell installierte Fassungen werden davon nicht erfasst.
test ! -e /usr/bin/isolate && echo 'APT-Installation von Isolate entfernt'
Lizenz und Betriebsart
IOI Isolate steht unter GPL-2.0-or-later. Dieses Kapitel installiert es direkt, ohne Docker.
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.
bubblewrap und systemd-run
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
bubblewrap trennt Dateisystem und Netzwerk eines Prozesses; systemd-run ergänzt Ressourcenlimits für einen kleinen eigenen Python-Runner.
Für Ubuntu 26.04 LTS (amd64), direkt ohne Docker. Dies ist ein lokales Beispiel für selbst kontrollierte Aufgaben, keine fertige HTTP-API und keine Freigabe zum öffentlichen Ausführen beliebigen Fremdcodes. Python und die Bibliotheken unter /usr bleiben sichtbar, Home und Hostkonfiguration werden nicht eingebunden. Ein eigener Laufzeitbaum, Systemaufruffilter und eine Begrenzung der Ausgabemenge sind hier nicht enthalten.
Installation
1. Paketlisten aktualisieren
Bereitet die Installation vor.
sudo apt update
2. Werkzeuge installieren
systemd-run gehört zu systemd. Der Rechner muss mit systemd gebootet sein und eine laufende Benutzersitzung besitzen.
sudo apt install bubblewrap systemd systemd-sysv python3 coreutils
3. bubblewrap prüfen
Zeigt die installierte Version.
bwrap --version
4. systemd prüfen
Die Ausgabe nennt den Stand des systemd-Werkzeugs.
systemd-run --version
5. cgroup v2 prüfen
Erwartet wird cgroup2fs.
stat -fc %T /sys/fs/cgroup
6. Benutzerdienst prüfen
Der Test muss erfolgreich enden. Bei fehlendem Benutzerbus melde dich regulär am Ubuntu-Rechner an; starte den Runner nicht ersatzweise als root.
systemd-run --user --wait --pipe --collect --property=MemoryMax=128M /usr/bin/true
7. Projektordner anlegen
Verwende einen neuen Ordner für die Beispiele.
mkdir ~/bubblewrap-lab
8. Projektordner öffnen
Die folgenden Dateien werden hier angelegt.
cd ~/bubblewrap-lab
9. Runner schreiben
Startet eine kurzlebige Benutzerservice-Unit. bubblewrap bindet nur die Programmdatei und Systemlaufzeiten ein; es teilt das Netzwerk des Hosts nicht.
cat > run-python <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
if [[ $# -ne 1 || ! -f "$1" ]]; then
echo 'Aufruf: ./run-python DATEI.py' >&2
exit 2
fi
runner_file=$(realpath -- "$1")
exec systemd-run --user --wait --pipe --collect --service-type=exec \
--expand-environment=no \
--property=MemoryMax=128M \
--property=MemorySwapMax=0 \
--property=TasksMax=32 \
--property=CPUQuota=50% \
--property=RuntimeMaxSec=5s \
--property=TimeoutStopSec=1s \
--property=KillMode=control-group \
-- /usr/bin/bwrap \
--unshare-all --die-with-parent --new-session --cap-drop ALL \
--ro-bind /usr /usr \
--symlink usr/bin /bin --symlink usr/sbin /sbin \
--symlink usr/lib /lib --symlink usr/lib64 /lib64 \
--proc /proc --dev /dev --tmpfs /tmp \
--dir /work --ro-bind "$runner_file" /work/main.py --chdir /work \
--clearenv --setenv PATH /usr/bin:/bin --setenv HOME /tmp \
--setenv LANG C.UTF-8 \
/usr/bin/python3 -I -B /work/main.py
EOF
10. Runner ausführbar machen
Erlaubt den direkten Aufruf des Skripts.
chmod +x run-python
11. Testprogramm schreiben
Prüft Ausgabe, fehlendes Home und Schreibrechte im eigenen temporären Verzeichnis.
cat > probe.py <<'EOF'
from pathlib import Path
print('Runner bereit')
assert not Path('/home').exists()
assert not Path('/etc/shadow').exists()
Path('/tmp/probe.txt').write_text('nur in dieser Sandbox')
print('Dateitrennung bestätigt')
EOF
Installation prüfen
1. Dateitrennung testen
Erwartet werden Runner bereit und Dateitrennung bestätigt. Die Datei in /tmp verschwindet mit dem Lauf.
./run-python probe.py
2. Netzwerktest anlegen
Verwendet eine numerische Zieladresse, damit kein DNS-Test mit dem Netzwerktest verwechselt wird.
cat > netz.py <<'EOF'
import socket
try:
socket.create_connection(('1.1.1.1', 443), timeout=1)
except OSError:
print('Keine externe Verbindung möglich')
else:
raise SystemExit('FEHLER: externe Verbindung gelang')
EOF
3. Netztrennung prüfen
Die Verbindung muss scheitern. Dieser einzelne Test ersetzt keine vollständige Netzprüfung.
./run-python netz.py
4. Zeitprüfung anlegen
Enthält ausschließlich eine Endlosschleife.
cat > endlos.py <<'EOF'
while True:
pass
EOF
5. Laufzeitgrenze prüfen
Der Lauf muss nach ungefähr fünf Sekunden beendet werden; nach einer zusätzlichen Sekunde Stop-Frist wird nötigenfalls hart abgebrochen und einen Fehlerstatus liefern. CPUQuota begrenzt den CPU-Anteil, nicht die aufsummierte CPU-Zeit.
./run-python endlos.py
6. Speichertest anlegen
Fordert mehr Speicher als die erlaubten 128 MiB an.
cat > speicher.py <<'EOF'
puffer = bytearray(512 * 1024 * 1024)
print(len(puffer))
EOF
7. Speichergrenze prüfen
Der Lauf muss scheitern; er darf die große Allokation nicht erfolgreich ausgeben.
./run-python speicher.py
MemoryMax und TasksMax gelten für die gesamte Service-cgroup. Der Runner begrenzt den Speicher auf 128 MiB, deaktiviert Swap für den Job und erlaubt höchstens 32 Tasks einschließlich Threads. Er bindet keine Host-Sockets und keine Benutzerdateien außer der ausgewählten Datei ein. Python -I ignoriert benutzerspezifische Importpfade; eigene Zusatzmodule werden nicht automatisch mitgeladen.
Bei namespace- oder AppArmor-Fehlern ist die Sandbox nicht einsatzbereit. Prüfe die Ubuntu-Paketprofile und die Systemmeldungen; schalte weder AppArmor noch die globale User-Namespace-Beschränkung pauschal ab. Fahre nur fort, wenn die Limits und Trennung tatsächlich funktionieren. Ausgabemengen werden nicht begrenzt; dieser Einstieg darf deshalb nicht unverändert als fremd erreichbarer Runner eingesetzt werden.
Deinstallieren
1. Laufende Prüfung beenden
Warte auf das Laufzeitlimit oder beende den eigenen Test im Terminal. --collect räumt beendete Service-Units auf.
2. Projektordner entfernen
Sichere eigene Aufgaben vorher.
rm -rf -- ~/bubblewrap-lab
3. bubblewrap optional entfernen
Nur wenn keine anderen Programme bubblewrap benötigen. systemd wird nicht entfernt: Es ist der Systemmanager von Ubuntu.
sudo apt purge bubblewrap
4. Projektentfernung prüfen
Die Bestätigung erscheint nach dem Löschen des Beispielordners.
test ! -e ~/bubblewrap-lab && echo 'Runner entfernt'
Quellen und Lizenz
bubblewrap, systemd-run, Ressourcenlimits. bubblewrap: LGPL-2.1-or-later; systemd enthält überwiegend LGPL-2.1-or-later-Komponenten. Das Shellskript ist ein eigenes Beispiel; es wird keine Weitergabelizenz im Namen des Benutzers festgelegt.
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.
DotNetLab
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
DotNetLab, auch .NET Lab beziehungsweise Razor Lab genannt, ist eine Browserumgebung zum Untersuchen und Ausführen von C#- und Razor-Beispielen.
Aufbau und Versionen
Gemeint ist das Projekt jjonescz/DotNetLab, dessen öffentliche Webfassung unter lab.razor.fyi läuft. Diese Anleitung baut die WebAssembly-Fassung selbst unter Ubuntu 26.04 LTS (amd64) und stellt sie nur lokal bereit. Docker ist nicht erforderlich.
Der hier dokumentierte Quellstand 3a274eb verlangt laut global.json das SDK 11.0.100-rc.2.26504.105 und einen festgelegten Workload-Stand. Die .nvmrc verlangt Node.js 24. Ubuntu 26.04 liefert regulär .NET 10 und Node.js 22; diese allein reichen für diesen Quellstand nicht aus. Ein neueres stabiles SDK wird hier nicht ungeprüft anstelle der Projektvorgabe verwendet.
Deshalb kommen die Systemvoraussetzungen aus APT und die projektspezifischen Werkzeuge in Unterordner des Projekts. Es handelt sich um einen Entwickleraufbau mit einem Vorab-SDK, nicht um eine fertige Ubuntu-Desktop-Anwendung. Für den Download von SDK, Workloads, npm- und NuGet-Paketen benötigst du Internetzugang und mehrere GB freien Speicher. Die vollständige Installation wurde hier nicht praktisch durchlaufen.
System vorbereiten
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren Paketversionen kennt.
sudo apt update
2. Grundwerkzeuge installieren
Das APT-SDK stellt eine regulär verwaltete .NET-Installation samt Systemabhängigkeiten bereit. Der spezielle Projektbuild verwendet später zusätzlich sein eigenes SDK. Compilerwerkzeuge werden für den WebAssembly-Build benötigt; Python stellt die fertigen Dateien lokal bereit.
sudo apt install dotnet-sdk-10.0 build-essential git curl ca-certificates python3 xz-utils
3. Ins Home-Verzeichnis wechseln
Der Projektordner wird im Benutzerkonto angelegt.
cd ~
4. Quellcode herunterladen
Der Zielordner darf noch nicht existieren.
git clone https://github.com/jjonescz/DotNetLab.git dotnetlab-lokal
5. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/dotnetlab-lokal
6. Dokumentierten Quellstand auswählen
Damit passen SDK-Auswahl, Build-Einstellungen und Projektdateien zu dieser Anleitung.
git checkout --detach 3a274eb08b61c58042a64405f9a182aaa98ce4c6
Projektwerkzeuge im Benutzerkonto einrichten
7. Microsoft-Installationsskript herunterladen
Der offizielle Installationsweg per Skript kann eine bestimmte SDK-Version ohne Administratorrechte installieren. Hier wird das Skript zunächst als Datei gespeichert.
curl --fail --location https://dot.net/v1/dotnet-install.sh --output dotnet-install.sh
8. SDK laut Projektdatei installieren
Python liest die Versionsnummer aus global.json. Das SDK wird ausschließlich unter .dotnet-sdk abgelegt. Falls der Hersteller diesen Vorab-Build nicht mehr bereitstellt, muss ein anderer, zusammen mit dem Projekt getesteter Quellstand gewählt werden; bloßes Ändern der Versionsnummer ist keine bestätigte Lösung.
bash ./dotnet-install.sh --version "$(python3 -c 'import json; print(json.load(open("global.json"))["sdk"]["version"])')" --install-dir "$PWD/.dotnet-sdk"
9. Projekt-SDK für dieses Terminal auswählen
Teilt .NET mit, wo die getrennte SDK-Installation liegt.
export DOTNET_ROOT="$PWD/.dotnet-sdk"
10. Projekt-SDK in den Suchpfad aufnehmen
Damit verwendet der Befehl dotnet in diesem Terminal das lokale SDK.
export PATH="$DOTNET_ROOT:$PATH"
Prüfen: Erwartet wird die Version 11.0.100-rc.2.26504.105.
dotnet --version
11. Node-Versionsverwaltung projektlokal laden
Die offizielle nvm-Versionsverwaltung installiert das benötigte Node.js im Benutzerkonto. Der eigene Unterordner verhindert, dass eine vorhandene nvm-Installation überschrieben wird. Diese Alternative ist hier nötig, weil die Node-Version aus den Ubuntu-26.04-Paketquellen von der Projektvorgabe abweicht.
git clone --depth 1 --branch v0.40.3 https://github.com/nvm-sh/nvm.git .nvm
12. Lokales nvm-Verzeichnis festlegen
Alle über diese nvm-Instanz geladenen Versionen werden im Projekt gespeichert.
export NVM_DIR="$PWD/.nvm"
13. nvm im Terminal laden
Stellt die Funktion nvm für die aktuelle Bash-Sitzung bereit.
source "$NVM_DIR/nvm.sh"
14. Node.js laut Projektvorgabe installieren
nvm liest die .nvmrc, installiert eine passende Node.js-24-Version und aktiviert sie. npm wird mitgeliefert.
nvm install
Prüfen: Die Ausgabe muss mit v24. beginnen.
node --version
15. WebAssembly-Workloads installieren
Installiert die beiden vom Projekt genannten Workloads in das schreibbare lokale SDK. Die Workload-Version wird durch global.json vorgegeben. Hier ist kein sudo erforderlich; installiere diese Vorab-Workloads nicht unbeabsichtigt in das systemweite APT-SDK.
dotnet workload install wasm-tools wasm-experimental
Prüfen: Beide Workloads sollen in der Liste erscheinen.
dotnet workload list
Webfassung bauen und starten
16. WebAssembly-Projekt veröffentlichen
Der Build lädt NuGet-Abhängigkeiten und baut über npm die Editorbestandteile. Die gezielte Projektauswahl vermeidet einen unnötigen Android- oder Windows-Build. -noAutoResponse entspricht dem Workaround im Projekt-Buildskript.
dotnet publish src/WebAssembly/WebAssembly.csproj --configuration Release --output "$PWD/ausgabe" -noAutoResponse
17. Ausgabe mit der Projektprüfung kontrollieren
Das mitgelieferte Prüfprogramm kontrolliert unter anderem, ob index.html im Service-Worker-Manifest enthalten ist. Erwartet wird eine Meldung mit OK.
dotnet run --file eng/check-publish-output.cs -- ausgabe
18. Dateien lokal bereitstellen
Startet einen einfachen Testserver auf Loopback. Die eigentliche C#-Ausführung dieser Fassung findet im Browser statt. Der Serverprozess bleibt im Terminal aktiv.
python3 -m http.server 5082 --bind 127.0.0.1 --directory ausgabe/wwwroot
19. Oberfläche im Browser öffnen
Öffne diese Adresse. Beim ersten Start können Compilerbestandteile und weitere Ressourcen nachgeladen werden; eine lokal ausgelieferte Startseite bedeutet deshalb noch keinen garantierten Offline-Betrieb.
http://127.0.0.1:5082
20. C#-Ausführung prüfen
Wähle den C#-Modus und gib dieses eigene Beispiel ein. Verwende die Ausführungsfunktion beziehungsweise die Konsolenausgabe der Oberfläche. Erwartet wird 42.
System.Console.WriteLine(6 * 7);
Prüfe zusätzlich eine Compileransicht, etwa IL oder Syntaxbaum. Eine Antwort des HTTP-Servers allein bestätigt noch nicht, dass Compiler, Worker und WebAssembly korrekt geladen wurden. Verwende für diesen Versuch nur eigenen Code und stelle ihn nicht als öffentlichen Ausführungsdienst bereit.
21. Testserver beenden
Drücke im Serverterminal Strg+C. Nach einem neuen Terminalstart musst du für einen erneuten Build die Schritte 5 und 9 bis 13 sowie nvm use wiederholen. Zum bloßen Bereitstellen einer bestehenden Ausgabe genügt Schritt 18 aus dem Projektordner.
Deinstallieren
1. Testserver beenden
Drücke in seinem Terminal Strg+C, falls er noch läuft.
2. Neues Terminal öffnen
Ein neues Terminal verwendet wieder seine normale Werkzeugauswahl. So arbeitest du nach dem Löschen nicht versehentlich mit Pfaden auf die projektlokalen Werkzeuge weiter.
3. Projekt und eigene Werkzeuge entfernen
Löscht Quellcode, Ausgabe, das projektspezifische SDK und die dort installierte Node-Version. Sichere eigene Beispiele vorher. Gemeinsame NuGet-Caches im Benutzerkonto bleiben erhalten.
rm -rf -- ~/dotnetlab-lokal
4. Optional: Browserdaten entfernen
Entferne in den Browsereinstellungen die Websitedaten für http://127.0.0.1:5082, wenn du auch PWA-Caches und dort gespeicherte Einstellungen löschen möchtest.
5. Entfernung prüfen
Die Ausgabe soll DotNetLab-Projekt entfernt lauten. Das reguläre APT-SDK bleibt für andere C#-Projekte installiert; seine optionale Entfernung ist in der Blazor-Anleitung beschrieben.
test ! -e ~/dotnetlab-lokal && echo 'DotNetLab-Projekt entfernt'
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.
WebVM und CheerpX
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
WebVM stellt eine Linux-Umgebung im Browser bereit und verwendet dafür die x86-Emulation CheerpX.
Was auf Ubuntu eingerichtet wird
Diese Anleitung baut auf Ubuntu 26.04 LTS (amd64) die WebVM-Oberfläche und liefert sie lokal mit nginx aus. Ein fertiges Linux-Datenträgerabbild erspart einen eigenen Image-Build. Docker wird nicht verwendet. Das Gastprogramm läuft im Browser, nicht als Linux-Prozess auf dem Webserver.
Grundlage ist der WebVM-Quellstand 667a02d. Das darin eingebundene NPM-Paket lädt die eigentliche CheerpX-Runtime vom Hersteller. Der Aufbau ist deshalb kein vollständig lokaler Offline-Betrieb. Die WebVM-Oberfläche ist unter Apache-2.0 veröffentlicht; für CheerpX gelten eigene Bedingungen. Nach der Herstellerbeschreibung setzt das Selbsthosten der Runtime eine kommerzielle Lizenz voraus. Prüfe bei institutioneller Nutzung insbesondere die Bedingungen für Hochschulen und Organisationen; die Lizenz der Oberfläche allein deckt CheerpX nicht ab.
Die Schritte beschreiben einen lokalen technischen Versuch. Abhängigkeitsinstallation und statischer Build waren in der Prüfumgebung erfolgreich; die vollständige Browserausführung auf Ubuntu 26.04 wurde hier nicht getestet. Für die Bedienung benötigst du einen aktuellen Browser mit WebAssembly und SharedArrayBuffer sowie Internetzugang zum CheerpX-Server.
Werkzeuge installieren
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren Pakete kennt.
sudo apt update
2. Build-Werkzeuge und nginx installieren
Node.js und npm bauen die Oberfläche, Git lädt den Quellcode und nginx liefert die Dateien aus. Ubuntu 26.04 bietet Node.js 22, das die Anforderungen des hier verwendeten Vite-5-Builds erfüllt. Beachte, dass das nginx-Paket auch einen Systemdienst einrichten kann; bei einem bereits vorhandenen Webserver muss dessen Portbelegung vorher berücksichtigt werden.
sudo apt install nodejs npm git nginx curl ca-certificates nano
Prüfen: Die Ausgabe sollte mit v22. oder einer geeigneten neueren Node-Version beginnen.
node --version
3. Ins Home-Verzeichnis wechseln
Die WebVM-Dateien werden im eigenen Benutzerkonto abgelegt.
cd ~
4. Quellcode laden
Der Zielordner darf noch nicht existieren.
git clone https://github.com/leaningtech/webvm.git webvm-lokal
5. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/webvm-lokal
6. Dokumentierten Quellstand auswählen
Verhindert, dass spätere Projektänderungen unbemerkt andere Voraussetzungen einführen.
git checkout --detach 667a02d79a3b91a48ed7bee8dca3693c33ef95a2
Fertiges Gastabbild verwenden
7. Image-Verzeichnis anlegen
Hier liegt das lokale Datenträgerabbild. Plane für Downloads und Build mehrere GB freien Speicher ein.
mkdir -p custom-disk-images
8. Offizielles Beispielabbild herunterladen
Lädt das in der Projektanleitung genannte Debian-Mini-Abbild. Es ist ein älteres Demonstrationssystem, keine aktuelle Ubuntu-Installation. Die darin enthaltene Software wird durch ein apt update auf dem Ubuntu-Host nicht aktualisiert.
curl --fail --location --output custom-disk-images/debian_mini_20230519_5022088024.ext2 https://github.com/leaningtech/webvm/releases/download/ext2_image/debian_mini_20230519_5022088024.ext2
9. Lokales Abbild konfigurieren
Öffne die Datei und ersetze ausschließlich die vorhandenen Definitionen für diskImageUrl und diskImageType durch die folgenden Zeilen. Die übrigen Einstellungen bleiben bestehen.
nano config_public_terminal.js
export const diskImageUrl = "/custom-disk-images/debian_mini_20230519_5022088024.ext2";
export const diskImageType = "bytes";
Speichere mit Strg+O, bestätige mit Enter und beende nano mit Strg+X.
10. JavaScript-Abhängigkeiten installieren
Verwendet die zum Quellstand gehörende Sperrdatei. Die Installation erfolgt ohne sudo im Projektordner.
npm ci
11. Oberfläche bauen
Erzeugt das Verzeichnis build mit den auslieferbaren Webdateien. Auch dieser Schritt benötigt Internetzugang, da das Projekt beim Erzeugen statischer Seiten externe Inhalte abfragt. Bei fetch failed prüfe zuerst die Netzwerkverbindung.
npm run build
Lokal ausliefern
12. Eigene nginx-Konfiguration erstellen
Öffne die neue Datei und füge den folgenden Inhalt ein. Sie startet einen separaten nginx-Prozess im Benutzerkonto und verändert keine bestehenden nginx-Sites. Port 8083 ist ausschließlich lokal erreichbar.
nano nginx-local.conf
daemon off;
pid nginx-local.pid;
error_log stderr;
events {
worker_connections 256;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
access_log off;
server {
listen 127.0.0.1:8083;
server_name localhost;
add_header Cross-Origin-Opener-Policy same-origin always;
add_header Cross-Origin-Embedder-Policy require-corp always;
location / {
root build;
index index.html;
}
location /custom-disk-images/ {
root .;
}
}
}
Die beiden Cross-Origin-Header ermöglichen die vom Browser benötigte Isolation. Ein gewöhnlicher HTTP-Dateiserver ohne diese Header genügt nicht; siehe den CheerpX-Einstieg.
13. nginx-Konfiguration prüfen
Der Präfix sorgt dafür, dass relative Pfade auf den Projektordner zeigen. Die Prüfung muss erfolgreich enden.
nginx -t -e stderr -p "$PWD/" -c nginx-local.conf
14. Lokalen Webserver starten
Der Prozess bleibt im Vordergrund. Port 8083 muss frei sein.
nginx -e stderr -p "$PWD/" -c nginx-local.conf
15. HTTP-Header prüfen
Öffne ein zweites Terminal. Die Antwort soll HTTP 200 sowie die Header Cross-Origin-Opener-Policy und Cross-Origin-Embedder-Policy enthalten.
curl --head http://127.0.0.1:8083/
16. Bereichsabruf des Abbilds prüfen
Die Antwort soll HTTP 206 und einen passenden Content-Range enthalten. Bereichsabrufe vermeiden, dass jeder Zugriff das gesamte Image übertragen muss.
curl --range 0-1023 --dump-header - --output /dev/null http://127.0.0.1:8083/custom-disk-images/debian_mini_20230519_5022088024.ext2
17. WebVM im Browser öffnen
Warte, bis die Linux-Shell erscheint. localhost gilt für die benötigten Browserfunktionen als lokale Entwicklungsumgebung; ein Zugriff über eine gewöhnliche HTTP-LAN-Adresse erfüllt diese Voraussetzung nicht.
http://127.0.0.1:8083
18. Gastumgebung prüfen
Gib diesen Befehl im WebVM-Terminal im Browser ein. Er zeigt die Distribution des Gasts, nicht die des Ubuntu-Hosts.
cat /etc/os-release
Die Browser-Entwicklerkonsole sollte bei folgendem JavaScript-Ausdruck true anzeigen, wenn die erforderliche Isolation aktiv ist:
crossOriginIsolated
Schreibzugriffe des Gasts können im Browserprofil gespeichert werden. Sichere benötigte Gastdateien vor dem Löschen von Websitedaten. Gast-Netzwerkzugang ist eine zusätzliche Funktion und wird hier nicht eingerichtet; erfolgreicher Zugriff auf die Oberfläche bedeutet nicht automatisch Internetzugang innerhalb der WebVM.
19. Webserver beenden
Drücke im nginx-Terminal Strg+C. Schließe auch den Browser-Tab, wenn die Gastumgebung nicht weiterlaufen soll.
Deinstallieren
1. Lokalen nginx-Prozess beenden
Drücke im zugehörigen Terminal Strg+C, falls er noch läuft. Der eventuell vorhandene nginx-Systemdienst ist ein anderer Prozess.
2. WebVM-Dateien löschen
Entfernt Quellcode, Build-Abhängigkeiten und Gastabbild. Sichere eigene Anpassungen vorher.
rm -rf -- ~/webvm-lokal
3. Optional: Browserdaten entfernen
Lösche in den Browsereinstellungen die Websitedaten für http://127.0.0.1:8083, wenn dort gespeicherte Gastdaten ebenfalls entfernt werden sollen. Dabei gehen nicht exportierte Gastdateien verloren.
4. Entfernung prüfen
Die Ausgabe soll WebVM-Dateien entfernt lauten. Gemeinsam verwendete Programme wie Node.js und nginx bleiben installiert.
test ! -e ~/webvm-lokal && echo 'WebVM-Dateien entfernt'
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.
Blazor WebAssembly
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Blazor WebAssembly ermöglicht Weboberflächen in C#, deren .NET-Code im Browser ausgeführt wird.
Aufbau
Auf Ubuntu 26.04 LTS (amd64) wird das .NET-10-SDK über APT installiert. Damit erzeugst und baust du eine eigenständige Browseranwendung. Die Vorlage heißt blazorwasm; sie unterscheidet sich von der Vorlage blazor für Blazor Web Apps. Grundlage sind die Microsoft-Anleitung für Ubuntu und die Blazor-Projektvorlagen.
Ein aktueller Browser genügt zur Benutzung der fertigen Anwendung. Docker und eine zusätzliche Datenbank werden nicht benötigt. Die Anwendung ist zunächst ein eigenes kleines Webprojekt, keine fertige Entwicklungsumgebung zum Ausführen beliebiger C#-Eingaben. Dafür siehe DotNetLab.
Das Erzeugen und Veröffentlichen des Beispielprojekts wurde mit dem .NET-10-SDK erfolgreich geprüft. Ein vollständiger Browserlauf auf Ubuntu 26.04 steht noch aus.
Installation und erstes Projekt
1. Paketlisten aktualisieren
Damit Ubuntu die verfügbaren SDK-Pakete kennt.
sudo apt update
2. SDK und Prüfwerkzeuge installieren
Das SDK enthält Compiler und Vorlagen. Python dient später als einfacher lokaler HTTP-Server für die gebauten Dateien.
sudo apt install dotnet-sdk-10.0 python3 curl
3. SDK prüfen
In der Ausgabe muss ein SDK der Version 10.0 erscheinen. Ein zusätzlich installiertes SDK wird nicht entfernt.
dotnet --list-sdks
4. Projekt erzeugen
Erstellt eine eigenständige WebAssembly-Anwendung für .NET 10 mit Beispielseiten. Der Zielordner darf noch nicht existieren. Beim Wiederherstellen der Abhängigkeiten ist Internetzugang zu NuGet erforderlich.
dotnet new blazorwasm --framework net10.0 --output ~/blazor-wasm-uebung
5. In den Projektordner wechseln
Die weiteren Befehle beziehen sich auf dieses Projekt.
cd ~/blazor-wasm-uebung
6. Entwicklungsserver starten
Startet die Anwendung ausschließlich auf dem eigenen Rechner. --no-launch-profile verhindert, dass Einstellungen aus einer Startkonfiguration die hier gewählte Adresse ersetzen. Das Terminal bleibt belegt.
dotnet run --no-launch-profile --urls http://127.0.0.1:5080
7. Anwendung im Browser prüfen
Öffne diese Adresse. Rufe die Beispielseite Counter auf und klicke auf den Zählerknopf. Der angezeigte Wert muss steigen.
http://127.0.0.1:5080
8. Entwicklungsserver beenden
Drücke im Serverterminal Strg+C. Damit kannst du das Projekt anschließend unabhängig vom Entwicklungsserver veröffentlichen.
Statische Dateien erzeugen
9. Release-Ausgabe bauen
Erzeugt im Projektordner die auslieferbaren Dateien unter ausgabe/wwwroot. Für das normale Beispiel sind keine zusätzlichen wasm-tools erforderlich. Solche Build-Werkzeuge werden etwa für AOT-Kompilierung benötigt; siehe die Microsoft-Dokumentation zu WebAssembly-Build-Werkzeugen.
dotnet publish --configuration Release --output ./ausgabe
Prüfen: Die Ausgabe muss eine Startseite und den Ordner _framework enthalten.
ls ausgabe/wwwroot
10. Release-Ausgabe lokal bereitstellen
Der einfache HTTP-Server liefert nur die gebauten Dateien aus. Die Anwendung benötigt zum Ausführen im Browser keinen laufenden .NET-Anwendungsserver.
python3 -m http.server 5081 --bind 127.0.0.1 --directory ausgabe/wwwroot
11. Ausgelieferte Startseite prüfen
Öffne ein zweites Terminal. Erwartet wird der HTTP-Status 200.
curl --fail --output /dev/null --write-out '%{http_code}\n' http://127.0.0.1:5081/
12. Fertige Anwendung im Browser prüfen
Öffne diese Adresse und teste den Zähler erneut. Erst das funktionierende Laden der Oberfläche und des .NET-Codes prüft die Anwendung vollständig; HTTP 200 allein genügt nicht.
http://127.0.0.1:5081
Der Python-Server ist für diesen lokalen Test gedacht. Direktaufrufe interner Routen wie /counter können dort beim Neuladen mit HTTP 404 scheitern. Ein produktiver Webserver braucht dafür eine Weiterleitung unbekannter Anwendungsrouten an index.html sowie passende MIME-Typen und gegebenenfalls Kompressionsregeln. Die Microsoft-Bereitstellungsanleitung beschreibt diese Anforderungen.
13. Testserver beenden
Drücke im Python-Serverterminal Strg+C. Die Dateien unter ausgabe/wwwroot bleiben erhalten.
Clientseitige Dateien und Konfigurationen sind für Browserbenutzer einsehbar. Lege dort keine geheimen API-Schlüssel oder Datenbankzugänge ab.
Deinstallieren
1. Laufende Testserver beenden
Drücke in noch laufenden Serverterminals Strg+C, damit das Projekt nicht mehr verwendet wird.
2. Projekt entfernen
Löscht Quellcode und Build-Ausgabe. Sichere eigene Änderungen vorher.
rm -rf -- ~/blazor-wasm-uebung
3. Optional: SDK entfernen
Führe dies nur aus, wenn keine anderen Projekte das über APT installierte .NET-10-SDK benötigen. Gemeinsam verwendete Laufzeiten und NuGet-Caches werden hier nicht pauschal gelöscht.
sudo apt remove dotnet-sdk-10.0
Prüfen: Die Ausgabe soll Blazor-Projekt entfernt lauten.
test ! -e ~/blazor-wasm-uebung && echo 'Blazor-Projekt entfernt'
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.
Try .NET
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Try .NET war ein Microsoft-Projekt für ausführbare C#-Beispiele in Webseiten und interaktiver Markdown-Dokumentation.
Projektstatus
Try .NET wurde zum 31. Dezember 2025 eingestellt. Das offizielle Repository ist seit dem 3. Dezember 2025 archiviert. Deshalb gibt es hier keine Empfehlung für eine Neuinstallation als aktuelle Software auf Ubuntu 26.04.
Die historischen Anweisungen beziehen sich unter anderem auf .NET Core 3.0 und das globale Werkzeug Microsoft.dotnet-try. Sie sind keine bestätigte Installationsanleitung für das heutige Ubuntu und .NET 10. Die damalige Browserintegration und das lokale Markdown-Werkzeug waren zudem unterschiedliche Einsatzformen.
Für aktuelle Arbeiten im Buch eignen sich:
- DotNetLab, wenn du C#- und Razor-Code im Browser untersuchen möchtest.
- Blazor WebAssembly, wenn du eine eigene C#-Webanwendung bauen möchtest.
- C#, wenn du Programme direkt unter Ubuntu entwickeln und ausführen möchtest.
Vorhandene Altinstallation prüfen und entfernen
1. Globale .NET-Werkzeuge auflisten
Falls dotnet bereits installiert ist, zeigt dieser Befehl die globalen Werkzeuge des aktuellen Benutzerkontos. Suche nach microsoft.dotnet-try. Diese Prüfung benötigt keine neue Softwareinstallation und kein sudo.
dotnet tool list --global
2. Altes Werkzeug deinstallieren
Nur ausführen, wenn das Paket in der Liste steht. Entfernt das globale Try-.NET-Werkzeug dieses Benutzerkontos. Eigene Dokumentationen und Beispielprojekte bleiben erhalten.
dotnet tool uninstall --global Microsoft.dotnet-try
3. Entfernung kontrollieren
Der Paketname darf in der Liste nicht mehr erscheinen. Lokal über ein Toolmanifest installierte Fassungen werden davon nicht erfasst.
dotnet tool list --global
4. Optional: Lokales Toolmanifest prüfen
Führe den Befehl im Ordner einer vorhandenen interaktiven Dokumentation aus. Er listet die dort über ein Manifest verwalteten .NET-Werkzeuge auf.
dotnet tool list --local
5. Optional: Lokale Fassung entfernen
Nur ausführen, wenn das lokale Manifest microsoft.dotnet-try enthält. Ändert die Werkzeugkonfiguration dieses Projekts; die Markdown-Dateien werden nicht gelöscht.
dotnet tool uninstall --local Microsoft.dotnet-try
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.
Git und cgit
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Git ist ein Versionsverwaltungssystem: Es speichert jeden Stand deiner Dateien und macht Änderungen nachvollziehbar. cgit ist eine schlanke Weboberfläche, mit der du Git-Repositories im Browser ansehen kannst, also Dateien, Änderungsverlauf und Unterschiede. Zusammen ergeben sie einen einfachen, lokalen Git-Server.
Vorbemerkungen
- Installation über apt: Git und cgit sind beide in den Ubuntu-Paketquellen enthalten.
- Voraussetzung für cgit: nginx ist nach der Anleitung installiert und läuft. cgit ist ein CGI-Programm. nginx kann solche Programme nicht selbst starten, deshalb übernimmt das der kleine Hilfsdienst fcgiwrap.
- Aufbau: Die zentralen Repositories liegen als sogenannte Bare-Repositories (ohne Arbeitskopie, Name endet auf
.git) im Ordner/srv/git. Dort liest cgit sie aus. Gearbeitet wird in Klonen, z. B. in deinem Home-Verzeichnis. - Nur lesen im Browser: cgit zeigt Repositories an und erlaubt das Klonen über HTTP. Änderungen hochladen (
git push) geht in dieser Anleitung nur lokal über den Dateipfad.
Git installieren und einrichten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Git und cgit aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Git installieren
Installiert Git. Unter Ubuntu ist es oft schon vorhanden, dann meldet apt das nur.
sudo apt install git
Prüfen: Die Versionsnummer wird angezeigt, z. B. git version 2.53.0.
git --version
3. Namen festlegen
Git schreibt zu jeder gespeicherten Änderung (Commit), wer sie gemacht hat. --global speichert die Einstellung für alle deine Repositories in der Datei ~/.gitconfig.
git config --global user.name "Dein Name"
4. E-Mail-Adresse festlegen
Gehört ebenfalls zu jedem Commit. Verwende die Adresse, die du auch bei Diensten wie GitHub oder GitLab angibst.
git config --global user.email "du@example.org"
5. Namen des Hauptzweigs festlegen
Neue Repositories bekommen damit den Hauptzweig main statt master. Das entspricht dem heute üblichen Standard.
git config --global init.defaultBranch main
Prüfen: Die Ausgabe enthält die drei Einstellungen.
git config --global --list
Zentrales Repository anlegen
6. Ordner für die Repositories anlegen
/srv ist unter Linux für Daten gedacht, die ein Dienst bereitstellt, hier cgit.
sudo mkdir -p /srv/git
7. Ordner deinem Benutzer übergeben
So kannst du ohne sudo Repositories anlegen und Änderungen hochladen. cgit läuft als Benutzer www-data und braucht nur Leserechte. Die hat es, weil neue Dateien unter Ubuntu für alle lesbar angelegt werden.
sudo chown "$USER":"$USER" /srv/git
8. Bare-Repository anlegen
Legt das leere, zentrale Repository test.git an. --bare bedeutet: Es enthält nur die Versionsgeschichte, keine Arbeitskopie zum Bearbeiten.
git init --bare /srv/git/test.git
9. Beschreibung eintragen
cgit zeigt den Inhalt der Datei description in der Übersicht aller Repositories an.
nano /srv/git/test.git/description
Git hat die Datei mit einem englischen Platzhaltertext angelegt. Lösche diese Zeile mit Strg+K und füge stattdessen ein (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
Test-Repository für cgit
10. Repository klonen
Erstellt eine Arbeitskopie in ~/test. Die Meldung, dass ein leeres Repository geklont wurde, ist hier richtig.
git clone /srv/git/test.git ~/test
11. Erste Datei anlegen
Eine README-Datei in Markdown. cgit zeigt sie später auf der Seite about des Repositorys an.
nano ~/test/README.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Test
Hallo **cgit**.
12. Datei für den Commit vormerken
git add nimmt die Datei in den nächsten Commit auf. -C ~/test führt den Befehl im Ordner ~/test aus, ohne dass du hineinwechseln musst.
git -C ~/test add README.md
13. Commit erstellen
Speichert den vorgemerkten Stand mit einer kurzen Beschreibung dauerhaft in der Versionsgeschichte.
git -C ~/test commit -m "Erster Commit"
14. Änderungen ins zentrale Repository hochladen
Überträgt den Commit nach /srv/git/test.git. -u merkt sich die Verbindung, danach genügt künftig git push.
git -C ~/test push -u origin main
Prüfen: Das zentrale Repository enthält den Commit „Erster Commit“.
git -C /srv/git/test.git log --oneline
cgit einrichten
15. cgit und Hilfsprogramme installieren
cgit– die Weboberflächefcgiwrap– startet cgit im Auftrag von nginxpython3-markdown– stellt README-Dateien in Markdown formatiert darpython3-pygments– färbt Quellcode in der Dateiansicht ein
cgit empfiehlt den Webserver Apache. Weil nginx schon installiert ist, gilt diese Empfehlung als erfüllt, und Apache wird nicht mitinstalliert.
sudo apt install cgit fcgiwrap python3-markdown python3-pygments
Prüfen: Die Ausgabe lautet active. fcgiwrap wartet damit auf Anfragen von nginx.
systemctl is-active fcgiwrap.socket
16. cgit konfigurieren
Ersetzt die Einstellungsdatei /etc/cgitrc. Die Angaben bewirken Folgendes:
css,logo,favicon– Adressen von Stildatei und Bildernroot-title,root-desc– Überschrift und Untertitel der Startseitevirtual-root=/– kurze Adressen wie/test/log/statt/?url=test/log/enable-http-clone,clone-url– Repositories lassen sich über HTTP klonen, die Adresse wird auf jeder Repository-Seite angezeigtreadme,about-filter– zeigtREADME.mdformatiert auf der Seite about ansource-filter– Syntaxhervorhebung für Quellcoderemove-suffix=1– zeigtteststatttest.gitanscan-path– Ordner, in dem cgit nach Repositories sucht. Diese Zeile muss am Ende stehen, weil nur die Einstellungen darüber für die gefundenen Repositories gelten.
sudo nano /etc/cgitrc
Die Datei hat schon Inhalt, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
css=/cgit.css
logo=/cgit.png
favicon=/favicon.ico
root-title=Meine Git-Repositories
root-desc=Lokaler Git-Server auf dem Entwicklungsrechner
virtual-root=/
enable-http-clone=1
clone-url=http://localhost:8086/$CGIT_REPO_URL
readme=:README.md
about-filter=/usr/lib/cgit/filters/about-formatting.sh
source-filter=/usr/lib/cgit/filters/syntax-highlighting.py
remove-suffix=1
scan-path=/srv/git
17. nginx-Konfiguration für cgit anlegen
cgit läuft auf Port 8086 und ist nur vom eigenen Rechner aus erreichbar. Die festen Dateien, die cgit mitbringt (Stildatei, Skript, Logo und Symbol im Ordner /usr/share/cgit), liefert nginx direkt aus. Alle anderen Adressen reicht nginx über fcgiwrap an cgit weiter: SCRIPT_FILENAME nennt das Programm, das fcgiwrap starten soll, und PATH_INFO übergibt die aufgerufene Adresse. Daraus liest cgit ab, welches Repository und welche Ansicht gemeint sind, z. B. /test/log/.
sudo nano /etc/nginx/sites-available/cgit
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8086;
server_name localhost;
# Stildatei, Skript, Logo und Symbol bringt cgit mit, nginx liefert sie direkt aus
location ~ ^/(cgit\.(css|js|png)|favicon\.ico|robots\.txt)$ {
root /usr/share/cgit;
}
# Alle übrigen Adressen beantwortet cgit, gestartet über fcgiwrap
location / {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
fastcgi_param PATH_INFO $uri;
fastcgi_pass unix:/run/fcgiwrap.socket;
}
}
18. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/cgit /etc/nginx/sites-enabled/cgit
19. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
20. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Testen
21. Startseite aufrufen
Prüft, ob cgit antwortet und das Repository findet.
curl -s http://localhost:8086/ | grep "Test-Repository"
Prüfen: Die Ausgabe enthält Test-Repository für cgit. Im Browser zeigt http://localhost:8086 die Liste der Repositories. Ein Klick auf test öffnet das Repository, unter about erscheint die formatierte README-Datei, unter log der Commit.
22. Über HTTP klonen
Prüft, ob das Klonen über die Weboberfläche funktioniert. Der Klon landet in ~/test-klon.
git clone http://localhost:8086/test ~/test-klon
Prüfen: Der Klon enthält den Commit „Erster Commit“.
git -C ~/test-klon log --oneline
23. Test-Klon wieder löschen
Der Klon aus dem vorigen Schritt wird nicht mehr gebraucht.
rm -rf ~/test-klon
Weitere Repositories hinzufügen
Jedes Bare-Repository, das du in /srv/git anlegst, erscheint automatisch in cgit, genau wie in den Schritten 8 und 9. Ein bestehendes Projekt lädst du so hoch: Leeres Bare-Repository anlegen, dann im Projektordner das Ziel eintragen und hochladen:
git remote add origin /srv/git/projekt.git
git push -u origin main
Deinstallieren
1. Seite in nginx deaktivieren
Löscht den Link aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/cgit
2. nginx-Konfigurationsdatei löschen
Löscht die Konfigurationsdatei der Seite.
sudo rm -f /etc/nginx/sites-available/cgit
3. nginx neu laden
Übernimmt das Abschalten der Seite.
sudo systemctl reload nginx
4. cgit und Hilfsprogramme entfernen
purge entfernt auch die Einstellungsdatei /etc/cgitrc. python3-pygments bleibt installiert, weil es auch andere Programme nutzen.
sudo apt purge cgit fcgiwrap python3-markdown
5. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für cgit installiert wurden.
sudo apt autoremove
6. Repositories und Arbeitskopie löschen (optional)
Achtung: Löscht alle zentralen Repositories in /srv/git und die Arbeitskopie ~/test endgültig. Nur ausführen, wenn du sie nicht mehr brauchst oder vorher gesichert hast.
sudo rm -rf /srv/git ~/test
7. Git entfernen (optional)
Git brauchen viele andere Programme und Anleitungen (z. B. MediaWiki). Entferne es nur, wenn du sicher bist, dass du es nicht mehr brauchst. Deine persönlichen Einstellungen in ~/.gitconfig bleiben dabei erhalten.
sudo apt purge git
Prüfen: Unter http://localhost:8086 antwortet kein Webserver mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8086/
Quellen und Lizenz
- Offizielle Dokumentation: https://git-scm.com/doc
- Lizenz: Git und cgit steht unter der 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.
Tileserver (OpenStreetMap)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ein Tileserver erzeugt aus OpenStreetMap-Daten eigene Kartenkacheln (PNG-Bilder), die sich in Webkarten wie Leaflet oder OpenLayers einbinden lassen – ohne Abhängigkeit von fremden Kartendiensten.
Vorbemerkungen
Der Tileserver besteht aus mehreren Bausteinen, die zusammenarbeiten:
| Baustein | Aufgabe |
|---|---|
| PostgreSQL + PostGIS | speichert die importierten OSM-Daten mit Geometrien |
| osm2pgsql | liest eine .osm.pbf-Datei und schreibt sie in die Datenbank |
| OpenStreetMap Carto | Kartenstil (Farben, Linien, Beschriftungen) im CartoCSS-Format |
| carto | übersetzt den Kartenstil in eine Mapnik-XML-Datei |
| Mapnik | zeichnet aus Datenbank und Stil die Kartenbilder |
| renderd | Hintergrunddienst, der Kacheln mit Mapnik rendert und zwischenspeichert |
| Apache + mod_tile | liefert die Kacheln per HTTP aus und beauftragt bei Bedarf renderd |
Hinweise zum Umfang:
- Diese Anleitung importiert als Beispiel nur die Stadt Ahrensburg (Kreis Stormarn). Der kleine Ausschnitt ist in wenigen Sekunden importiert. Größere Gebiete brauchen deutlich mehr Arbeitsspeicher, Festplattenplatz und Zeit. Für ganz Deutschland sollten es mindestens 32 GB RAM und rund 200 GB SSD-Speicher sein.
- Die Kartendaten und der Kartenstil liegen unter
/srv/osm. So muss das Home-Verzeichnis nicht für andere Benutzer freigegeben werden. - Ubuntu 26.04 bringt PostgreSQL 18 und Mapnik 4.2 mit. Pfade und Paketnamen unten sind darauf abgestimmt.
- Quelle und Lizenz: Alle Texte und Beispiele dieser Anleitung sind eigenständig geschrieben. Angaben zu den Lizenzen der beteiligten Softwarekomponenten und zur switch2osm-Befehlsreferenz stehen im Abschnitt Quellen und Lizenz.
Installation der Pakete
1. Paketlisten aktualisieren
Sorgt dafür, dass apt die neuesten Paketversionen aus den Ubuntu-Quellen kennt.
sudo apt update
2. Datenbank-Pakete installieren
Installiert PostgreSQL, die Geodaten-Erweiterung PostGIS und das Importwerkzeug osm2pgsql.
sudo apt install -y postgresql postgresql-contrib postgis postgresql-18-postgis-3 postgresql-18-postgis-3-scripts osm2pgsql
Prüfen: Die Version von osm2pgsql wird ausgegeben.
osm2pgsql --version
3. Render-Pakete installieren
Installiert den Renderdienst renderd, das Apache-Modul mod_tile, den Webserver Apache sowie die Mapnik-Werkzeuge.
sudo apt install -y apache2 renderd libapache2-mod-tile mapnik-utils
Prüfen: Apache läuft (active). renderd meldet an dieser Stelle noch failed – das ist richtig so, denn es ist noch kein Kartenstil eingetragen (Schritt 22).
systemctl is-active apache2 renderd
[!NOTE] Port 80 schon belegt? Läuft auf dem Rechner bereits ein anderer Webserver (z. B. nginx), kann Apache nicht starten und meldet
failedmitAddress already in usebzw.no listening sockets available. In diesem Fall Apache auf Port 8080 legen und in allen späteren URLslocalhost:8080stattlocalhostverwenden.
Suche mit nano in der Konfiguration nach Listen 80:
sudo nano /etc/apache2/ports.conf
Suche mit Strg+W nach Listen 80, ändere die Zeile in Listen 8080, speichere mit Strg+O und Enter und beende nano mit Strg+X.
Passe danach die Standardseite an:
sudo nano /etc/apache2/sites-available/000-default.conf
Ändere die erste Zeile <VirtualHost *:80> in <VirtualHost *:8080>, speichere und beende nano. Danach Apache neu starten:
sudo systemctl restart apache2
Damit die Karte später auch ohne :8080 erreichbar ist, kann nginx die Kachelanfragen an Apache weiterreichen – siehe nginx als Proxy vor Apache.
4. Werkzeuge für den Kartenstil installieren
node-carto übersetzt den Kartenstil, osmium-tool schneidet ein Stadtgebiet aus einer größeren OSM-Datei aus, gdal-bin und die Python-Module werden vom Hilfsskript für die Küstenlinien- und Grenzdaten gebraucht, git holt den Kartenstil.
sudo apt install -y git curl unzip osmium-tool node-carto gdal-bin python3-psycopg2 python3-yaml python3-requests
Prüfen: carto meldet mindestens Version 1.2.0.
carto -v
5. Schriftarten installieren
Der Kartenstil beschriftet Orte in vielen Schriftsystemen und erwartet dafür die Noto-Schriften. Über apt installiert, findet Mapnik sie automatisch unter /usr/share/fonts.
sudo apt install -y fonts-noto-core fonts-noto-ui-core fonts-noto-cjk fonts-noto-extra fonts-hanazono fonts-unifont
Datenbank einrichten
6. Datenbank gis anlegen
Der Dienst renderd läuft als Systembenutzer _renderd (wurde mit dem Paket angelegt). Deshalb bekommt dieser Benutzer eine gleichnamige Datenbankrolle und wird Besitzer der Datenbank gis. Der Name gis ist im Kartenstil fest eingetragen.
sudo -u postgres createuser _renderd
sudo -u postgres createdb -E UTF8 -O _renderd gis
7. Erweiterungen PostGIS und hstore aktivieren
PostGIS ergänzt die Datenbank um Geometrie-Datentypen, hstore speichert beliebige OSM-Schlüssel/Wert-Paare in einer Spalte.
sudo -u postgres psql -d gis -c "CREATE EXTENSION postgis;" -c "CREATE EXTENSION hstore;"
8. Besitz der PostGIS-Tabellen übertragen
Die beiden Verwaltungstabellen von PostGIS gehören nach dem Anlegen postgres. _renderd braucht Schreibrechte darauf, damit der Import funktioniert.
sudo -u postgres psql -d gis -c "ALTER TABLE geometry_columns OWNER TO _renderd;" -c "ALTER TABLE spatial_ref_sys OWNER TO _renderd;"
Prüfen: In der Liste der Erweiterungen stehen postgis und hstore.
sudo -u postgres psql -d gis -c "\dx"
Kartenstil vorbereiten
9. Arbeitsverzeichnis anlegen
Legt /srv/osm an und macht den eigenen Benutzer zum Besitzer, damit die folgenden Schritte ohne sudo auskommen.
sudo mkdir -p /srv/osm
sudo chown "$USER": /srv/osm
10. OpenStreetMap Carto herunterladen
Klont den Standard-Kartenstil von openstreetmap.org.
git clone https://github.com/gravitystorm/openstreetmap-carto.git /srv/osm/openstreetmap-carto
11. Feste Version auswählen
Wechselt auf die veröffentlichte Version 5.9.0, damit Stil, Importregeln und Datenbankfunktionen sicher zueinander passen.
git -C /srv/osm/openstreetmap-carto switch --detach v5.9.0
12. Kartenstil in Mapnik-XML übersetzen
carto wandelt die Projektdatei project.mml in die Datei mapnik.xml um, die renderd später lädt.
cd /srv/osm/openstreetmap-carto && carto project.mml > mapnik.xml
Prüfen: Die Datei existiert und ist mehrere Megabyte groß. Warnungen von carto sind unkritisch, solange die Datei entsteht.
ls -lh /srv/osm/openstreetmap-carto/mapnik.xml
OSM-Daten importieren
13. Datenverzeichnis anlegen
Hier landet der heruntergeladene Kartenausschnitt.
mkdir -p /srv/osm/data
14. Bundesland Schleswig-Holstein herunterladen
Geofabrik bietet tagesaktuelle Ausschnitte der OSM-Daten an, allerdings nur bis hinunter zu Bundesländern und Regierungsbezirken. Für Ahrensburg wird deshalb zuerst das ganze Bundesland geladen (rund 150 MB). Für ein anderes Gebiet die passende URL von https://download.geofabrik.de/ einsetzen.
curl -L -o /srv/osm/data/schleswig-holstein-latest.osm.pbf https://download.geofabrik.de/europe/germany/schleswig-holstein-latest.osm.pbf
15. Ahrensburg ausschneiden
osmium extract schneidet ein Rechteck aus der Datei heraus. Die Werte nach -b sind die Ecken des Rechtecks als westliche Länge, südliche Breite, östliche Länge, nördliche Breite und umschließen das Stadtgebiet von Ahrensburg. Die Grenzen einer anderen Stadt lassen sich z. B. auf https://www.openstreetmap.org über „Export“ ablesen.
osmium extract -b 10.16,53.63,10.32,53.71 /srv/osm/data/schleswig-holstein-latest.osm.pbf -o /srv/osm/data/ahrensburg.osm.pbf
Prüfen: Die neue Datei ist nur wenige Megabyte groß.
ls -lh /srv/osm/data
16. Daten in die Datenbank importieren
osm2pgsql liest die PBF-Datei und legt die Tabellen an, die OpenStreetMap Carto erwartet. Der Import läuft als _renderd, damit dieser Benutzer die Tabellen besitzt.
Bedeutung der Optionen:
--create --slim: neue Datenbank aufbauen, Zwischendaten in der Datenbank statt im RAM halten (Voraussetzung für spätere Updates)-G: Multipolygone als eine zusammenhängende Geometrie speichern--hstore: legt zusätzlich die Spaltetagsan. Darin landen als Schlüssel/Wert-Paare alle Merkmale eines Objekts, die in der Spaltenliste (-S) nicht vorkommen--tag-transform-scriptund-S: Regeln und Spaltenliste aus dem Kartenstil-C 2500: bis zu 2500 MB Arbeitsspeicher als Zwischenspeicher nutzen – bei wenig RAM kleiner wählen
sudo -u _renderd osm2pgsql -d gis --create --slim -G --hstore \
--tag-transform-script /srv/osm/openstreetmap-carto/openstreetmap-carto.lua \
-S /srv/osm/openstreetmap-carto/openstreetmap-carto.style \
-C 2500 --number-processes 1 \
/srv/osm/data/ahrensburg.osm.pbf
Prüfen: Am Ende meldet osm2pgsql osm2pgsql took ... overall. Die Tabellen sind vorhanden:
sudo -u _renderd psql -d gis -c "\dt"
17. Indizes anlegen
Zusätzliche Indizes beschleunigen die Abfragen, die Mapnik beim Zeichnen der Kacheln stellt.
cd /srv/osm/openstreetmap-carto && sudo -u _renderd psql -d gis -f indexes.sql
18. Datenbankfunktionen einspielen
Der Kartenstil ruft einige eigene SQL-Funktionen auf (z. B. zur Auswahl von Beschriftungen), die hier angelegt werden.
cd /srv/osm/openstreetmap-carto && sudo -u _renderd psql -d gis -f functions.sql
19. Externe Daten laden
Küstenlinien, Meeresflächen und einige Grenzen stammen nicht aus der PBF-Datei, sondern werden separat heruntergeladen und in die Datenbank geladen. Das Verzeichnis data muss _renderd gehören, weil das Skript als dieser Benutzer läuft.
mkdir -p /srv/osm/openstreetmap-carto/data
sudo chown _renderd /srv/osm/openstreetmap-carto/data
cd /srv/osm/openstreetmap-carto && sudo -u _renderd scripts/get-external-data.py
Prüfen: Das Skript endet ohne Fehlermeldung; die Tabelle water_polygons ist gefüllt.
sudo -u _renderd psql -d gis -c "SELECT count(*) FROM water_polygons;"
renderd konfigurieren
20. Konfigurationsdatei öffnen
Die Einstellungen von renderd liegen in /etc/renderd.conf.
sudo nano /etc/renderd.conf
21. Mapnik-Pfade korrigieren
Die mitgelieferte Datei zeigt noch auf das Plugin-Verzeichnis von Mapnik 3.1. Unter Ubuntu 26.04 liegt Mapnik 4.2 an anderer Stelle. Außerdem soll renderd alle Schriften unter /usr/share/fonts finden (die CJK-Schriften liegen unter opentype, nicht unter truetype). Den Abschnitt [mapnik] so ändern:
[mapnik]
plugins_dir=/usr/lib/x86_64-linux-gnu/mapnik/4.2/input
font_dir=/usr/share/fonts
font_dir_recurse=true
Prüfen: Im angegebenen Verzeichnis liegt u. a. postgis+pgraster.input – das ist das Plugin, mit dem Mapnik die Datenbank liest.
ls /usr/lib/x86_64-linux-gnu/mapnik/4.2/input
22. Kartenstil als Kachelsatz eintragen
Am Ende der Datei einen eigenen Abschnitt ergänzen. URI ist der URL-Pfad, unter dem die Kacheln erreichbar sind, XML der in Schritt 12 erzeugte Stil.
[osm]
URI=/osm/
XML=/srv/osm/openstreetmap-carto/mapnik.xml
HOST=localhost
TILESIZE=256
MAXZOOM=20
Anschließend speichern (Strg+O, Enter) und schließen (Strg+X).
23. renderd neu starten
Lädt die geänderte Konfiguration und den Kartenstil.
sudo systemctl restart renderd
Prüfen: Der Dienst ist active (running). Fehler beim Laden des Stils stehen im Journal.
systemctl status renderd --no-pager
journalctl -u renderd -n 30 --no-pager
Apache konfigurieren
24. Modul mod_tile aktivieren
Schaltet das Apache-Modul ein, das Kachel-URLs erkennt und mit renderd spricht. Meist hat das Paket das schon erledigt; die Meldung Module tile already enabled ist dann in Ordnung.
sudo a2enmod tile
25. Konfiguration für mod_tile anlegen
Die Datei sagt mod_tile, wo die Kachelsätze beschrieben sind und über welchen Socket renderd erreichbar ist. Die Zeitlimits legen fest, wie lange Apache auf eine neu gerenderte Kachel wartet.
sudo nano /etc/apache2/conf-available/renderd.conf
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /run/renderd/renderd.sock
ModTileRequestTimeout 3
ModTileMissingRequestTimeout 60
26. Konfiguration aktivieren
Bindet die neue Datei in Apache ein.
sudo a2enconf renderd
27. Apache neu starten
Neu starten statt nur neu laden, weil ein Modul hinzugekommen ist.
sudo systemctl restart apache2
Prüfen: Die Konfiguration ist fehlerfrei.
sudo apache2ctl configtest
Tileserver testen
28. Erste Kachel abrufen
Fordert die Weltkarte in Zoomstufe 0 an. Beim ersten Aufruf rendert renderd die Kachel, das kann einige Sekunden dauern.
curl -o /tmp/kachel.png http://localhost/osm/0/0/0.png
Prüfen: Die Datei ist ein PNG-Bild mit 256 × 256 Pixeln.
file /tmp/kachel.png
29. Testseite mit Leaflet anlegen
Eine kleine HTML-Seite zeigt die eigenen Kacheln als verschiebbare Karte, zentriert auf die Ahrensburger Innenstadt.
sudo nano /var/www/html/karte.html
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Eigener Tileserver</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/leaflet@1.9.4/dist/leaflet.css">
<script src="https://cdn.jsdelivr.net/npm/leaflet@1.9.4/dist/leaflet.js"></script>
<style>html, body, #karte { height: 100%; margin: 0; }</style>
</head>
<body>
<div id="karte"></div>
<script>
const karte = L.map('karte').setView([53.675, 10.236], 14);
L.tileLayer('/osm/{z}/{x}/{y}.png', {
maxZoom: 20,
attribution: '© OpenStreetMap-Mitwirkende'
}).addTo(karte);
</script>
</body>
</html>
30. Karte im Browser öffnen
Beim Verschieben und Zoomen werden fehlende Kacheln nachgerendert; bereits erzeugte Kacheln kommen aus dem Zwischenspeicher unter /var/cache/renderd/tiles.
xdg-open http://localhost/karte.html
Prüfen: Die Zahl der zwischengespeicherten Metakacheln (je 8 × 8 Kacheln in einer .meta-Datei) wächst, während man in der Karte herumzoomt.
find /var/cache/renderd/tiles -name '*.meta' | wc -l
Installation prüfen
osm2pgsql --version
systemctl is-active postgresql renderd apache2
curl -sI http://localhost/osm/0/0/0.png | head -n 1
Die letzte Zeile sollte HTTP/1.1 200 OK lauten.
Deinstallieren
1. Dienste stoppen
Beendet renderd und Apache, damit keine Dateien mehr in Benutzung sind.
sudo systemctl stop renderd apache2
2. Datenbank und Rolle löschen
Achtung: Alle importierten Kartendaten gehen verloren.
sudo -u postgres dropdb gis
sudo -u postgres dropuser _renderd
3. Kartenstil, Daten und Kachel-Zwischenspeicher löschen
sudo rm -r /srv/osm /var/cache/renderd
4. Testseite und Apache-Konfiguration entfernen
sudo rm /var/www/html/karte.html /etc/apache2/conf-available/renderd.conf
5. Pakete entfernen
purge entfernt auch die Konfigurationsdateien wie /etc/renderd.conf. PostgreSQL und Apache nur mit entfernen, wenn sie nicht für andere Zwecke gebraucht werden.
sudo apt purge renderd libapache2-mod-tile mapnik-utils node-carto osmium-tool osm2pgsql postgresql-18-postgis-3 postgresql-18-postgis-3-scripts postgis
6. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für den Tileserver installiert wurden.
sudo apt autoremove
Prüfen: Die Befehle werden nicht mehr gefunden.
renderd -h
osm2pgsql --version
Quellen und Lizenz
- Kartenwerkzeuge: Mapnik steht unter LGPL-2.1, osm2pgsql unter GPL-2.0.
- Kartenstil: Der Stil OpenStreetMap Carto steht unter CC0 1.0 Universal.
- Kartendaten: Die OpenStreetMap-Daten stehen unter der Open Database License (ODbL).
- Technische Referenz: Als Grundlage für die Abfolge der Dienst- und Datenbankkommandos diente der technische Leitfaden „Manually building a tile server“ der switch2osm-Gemeinschaft (CC BY-SA 2.0). Alle Texte, Pfade und Beispielkonfigurationen sind eigenständig verfasst und auf Ubuntu 26.04 LTS mit Mapnik 4.2 und Ahrensburg abgestimmt.
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.
Martin (Vektor-Tileserver)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Martin liefert aus PostGIS-Tabellen Vektorkacheln, die ein Webbrowser erst beim Anzeigen zeichnet. Diese Anleitung importiert die Stadt Ahrensburg aus der Datei ahrensburg.osm.pbf in PostgreSQL und veröffentlicht sie über Martin.
Vorbemerkungen
So arbeiten die Bausteine zusammen:
| Baustein | Aufgabe |
|---|---|
| PostgreSQL + PostGIS | hält die OSM-Daten samt Geometrien |
| osm2pgsql | liest ahrensburg.osm.pbf und legt dabei eigene, schlanke Tabellen an |
| Martin | findet die Tabellen selbst und erzeugt daraus auf Anfrage Vektorkacheln (Format MVT) |
| MapLibre GL JS | zeichnet die Vektorkacheln im Browser und bestimmt Farben und Linien |
Hinweise:
- Martin rendert keine Bilder. Das Aussehen der Karte legt allein die Webseite fest (Schritt 22). Einen Kartenstil wie OpenStreetMap Carto braucht es deshalb nicht.
- Martin ist nicht in den Ubuntu-Paketquellen enthalten. Das Projekt stellt aber ein fertiges
.deb-Paket bereit. Getestet wurde diese Anleitung mit Martin 1.16.1, PostgreSQL 18 und osm2pgsql 2.2. - Die Daten liegen in einer eigenen Datenbank
osm. Eine vorhandene Datenbankgisaus der Anleitung Tileserver (OpenStreetMap) wird nicht verändert. - Martin läuft unter einem eigenen Systembenutzer
martin. Weil die Datenbankrolle genauso heißt, meldet sich Martin über den lokalen Socket ohne Passwort an (Anmeldeart peer). - Martin hört nur auf
127.0.0.1:3000, ist also von anderen Rechnern aus nicht erreichbar.
Installation der Pakete
1. Paketlisten aktualisieren
Damit apt die neuesten Paketversionen kennt.
sudo apt update
2. Datenbank und Importwerkzeuge installieren
Installiert PostgreSQL mit der Geodaten-Erweiterung PostGIS, das Importprogramm osm2pgsql, das Ausschneidewerkzeug osmium und curl für Downloads. Bereits installierte Pakete lässt apt einfach stehen.
sudo apt install -y postgresql postgis postgresql-18-postgis-3 osm2pgsql osmium-tool curl
Prüfen: osm2pgsql meldet Version 2.0 oder neuer. Ältere Versionen verstehen die Importregeln aus Schritt 13 nicht.
osm2pgsql --version
3. Martin-Paket herunterladen
Lädt das .deb-Paket von der Release-Seite des Projekts (https://github.com/maplibre/martin/releases). Für eine neuere Version die Versionsnummer in der Adresse austauschen.
curl -L -o /tmp/martin.deb https://github.com/maplibre/martin/releases/download/martin-v1.16.1/debian-x86_64.deb
Prüfen: Die Datei ist rund 28 MB groß.
ls -lh /tmp/martin.deb
4. Martin installieren
apt installiert auch lokale Dateien. Wichtig ist das ./ bzw. der volle Pfad, sonst sucht apt in den Paketquellen nach einem Paket dieses Namens. Das Paket bringt die Programme martin, martin-cp und mbtiles, eine Beispielkonfiguration in /etc/martin/config.yaml und einen systemd-Dienst mit.
sudo apt install -y /tmp/martin.deb
Prüfen:
martin --version
5. Heruntergeladene Datei löschen
Das Paket ist installiert, die Datei wird nicht mehr gebraucht.
rm /tmp/martin.deb
Benutzer und Datenbank einrichten
6. Systembenutzer martin anlegen
Unter diesem Benutzer laufen später der Import und der Dienst. Er hat kein Home-Verzeichnis und keine Login-Shell, weil er nur für Martin da ist.
sudo useradd --system --no-create-home --shell /usr/sbin/nologin martin
7. Datenbankrolle martin anlegen
Eine gleichnamige Rolle in PostgreSQL erlaubt dem Systembenutzer martin die passwortlose Anmeldung über den lokalen Socket.
sudo -u postgres createuser martin
8. Datenbank osm anlegen
Die Datenbank gehört martin. So darf der Import darin Tabellen anlegen und löschen.
sudo -u postgres createdb -E UTF8 -O martin osm
9. PostGIS aktivieren
Erst mit dieser Erweiterung kennt die Datenbank Geometrien. Nur postgres darf sie einschalten.
sudo -u postgres psql -d osm -c "CREATE EXTENSION postgis;"
Prüfen: Die Anmeldung als martin klappt, und die PostGIS-Version wird angezeigt.
sudo -u martin psql -d osm -c "SELECT postgis_version();"
Kartendaten vorbereiten
Liegt /srv/osm/data/ahrensburg.osm.pbf schon vor (z. B. aus der Anleitung Tileserver (OpenStreetMap)), geht es direkt mit Schritt 13 weiter.
10. Datenverzeichnis anlegen
Unter /srv/osm kann der Benutzer martin die Dateien lesen. Aus dem Home-Verzeichnis ginge das nicht ohne Weiteres.
sudo mkdir -p /srv/osm/data
sudo chown "$USER": /srv/osm/data
11. Schleswig-Holstein herunterladen
Geofabrik stellt OSM-Auszüge je Bundesland bereit (rund 150 MB), aber keine einzelnen Städte. Deshalb zuerst das Bundesland laden.
curl -L -o /srv/osm/data/schleswig-holstein-latest.osm.pbf https://download.geofabrik.de/europe/germany/schleswig-holstein-latest.osm.pbf
12. Ahrensburg ausschneiden
osmium extract schneidet ein Rechteck aus. Die vier Zahlen hinter -b sind westliche Länge, südliche Breite, östliche Länge und nördliche Breite rund um Ahrensburg.
osmium extract -b 10.16,53.63,10.32,53.71 /srv/osm/data/schleswig-holstein-latest.osm.pbf -o /srv/osm/data/ahrensburg.osm.pbf
Prüfen: ahrensburg.osm.pbf ist nur wenige Megabyte groß.
ls -lh /srv/osm/data
Importregeln festlegen
13. Ordner für die Importregeln anlegen
In diesem Ordner liegt die Lua-Datei, die osm2pgsql sagt, welche OSM-Objekte in welche Tabelle kommen.
sudo mkdir -p /srv/osm/martin
14. Lua-Datei anlegen
osm2pgsql arbeitet hier mit der Flex-Ausgabe: Ein Lua-Skript legt die Tabellen fest und entscheidet für jedes Objekt, wohin es gehört. Das Beispiel legt vier Tabellen an: strassen (Wege und Straßen als Linien), gebaeude (Umrisse), flaechen (Wald, Wasser, Wiesen, Parks usw.) und orte (Punkte wie Geschäfte, Ärzte, Schulen). Die Geometrien speichert osm2pgsql automatisch in Web-Mercator (EPSG:3857), der Projektion der Webkarten. Martin muss dann nichts umrechnen.
sudo nano /srv/osm/martin/ahrensburg.lua
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
-- Importregeln für Martin: vier einfache Tabellen in Web-Mercator (EPSG:3857)
local strassen = osm2pgsql.define_way_table('strassen', {
{ column = 'art', type = 'text' },
{ column = 'name', type = 'text' },
{ column = 'geom', type = 'linestring', not_null = true },
})
local gebaeude = osm2pgsql.define_area_table('gebaeude', {
{ column = 'art', type = 'text' },
{ column = 'hausnummer', type = 'text' },
{ column = 'geom', type = 'geometry', not_null = true },
})
local flaechen = osm2pgsql.define_area_table('flaechen', {
{ column = 'art', type = 'text' },
{ column = 'name', type = 'text' },
{ column = 'geom', type = 'geometry', not_null = true },
})
local orte = osm2pgsql.define_node_table('orte', {
{ column = 'art', type = 'text' },
{ column = 'name', type = 'text' },
{ column = 'geom', type = 'point', not_null = true },
})
-- Welche Schlüssel eine Fläche beschreiben (in dieser Reihenfolge geprüft)
local flaechen_schluessel = { 'natural', 'landuse', 'leisure', 'water' }
local function flaechen_art(tags)
for _, schluessel in ipairs(flaechen_schluessel) do
if tags[schluessel] then
return schluessel .. '=' .. tags[schluessel]
end
end
return nil
end
function osm2pgsql.process_node(object)
local art = object.tags.amenity or object.tags.shop or object.tags.place
if art then
orte:insert({
art = art,
name = object.tags.name,
geom = object:as_point(),
})
end
end
function osm2pgsql.process_way(object)
local tags = object.tags
if tags.building and object.is_closed then
gebaeude:insert({
art = tags.building,
hausnummer = tags['addr:housenumber'],
geom = object:as_polygon(),
})
elseif tags.highway then
strassen:insert({
art = tags.highway,
name = tags.name,
geom = object:as_linestring(),
})
elseif object.is_closed then
local art = flaechen_art(tags)
if art then
flaechen:insert({
art = art,
name = tags.name,
geom = object:as_polygon(),
})
end
end
end
function osm2pgsql.process_relation(object)
local tags = object.tags
if tags.type ~= 'multipolygon' then
return
end
if tags.building then
gebaeude:insert({
art = tags.building,
hausnummer = tags['addr:housenumber'],
geom = object:as_multipolygon(),
})
return
end
local art = flaechen_art(tags)
if art then
flaechen:insert({
art = art,
name = tags.name,
geom = object:as_multipolygon(),
})
end
end
Bei Flächen steht in der Spalte art Schlüssel und Wert zusammen, z. B. natural=water oder landuse=forest. Danach richtet die Testseite in Schritt 22 die Farben aus.
Daten importieren
15. In ein Verzeichnis wechseln, das martin lesen darf
sudo -u martin behält das aktuelle Verzeichnis bei. Liegt das im eigenen Home-Verzeichnis, gibt es sonst eine Warnung über fehlende Rechte.
cd /srv/osm
16. ahrensburg.osm.pbf importieren
Der Import läuft als martin, damit dieser Benutzer die neuen Tabellen besitzt.
-d osm: Zieldatenbank-O flex: Flex-Ausgabe mit eigenen Tabellen-S …/ahrensburg.lua: die Importregeln aus Schritt 14
sudo -u martin osm2pgsql -d osm -O flex -S /srv/osm/martin/ahrensburg.lua /srv/osm/data/ahrensburg.osm.pbf
Prüfen: Am Ende steht osm2pgsql took … overall. Die vier Tabellen sind gefüllt (zum Zeitpunkt des Tests je nach Tabelle zwischen 2 000 und 21 000 Zeilen):
sudo -u martin psql -d osm -c "SELECT 'strassen' AS tabelle, count(*) FROM strassen UNION ALL SELECT 'gebaeude', count(*) FROM gebaeude UNION ALL SELECT 'flaechen', count(*) FROM flaechen UNION ALL SELECT 'orte', count(*) FROM orte;"
Ein erneuter Aufruf von Schritt 16 (z. B. mit neueren Daten) löscht die Tabellen und baut sie neu auf.
Martin einrichten
17. Konfigurationsdatei öffnen
Das Paket hat unter /etc/martin/config.yaml schon eine Beispieldatei angelegt. Sie wird komplett ersetzt.
sudo nano /etc/martin/config.yaml
Lösche den vorhandenen Inhalt: Alt+\ (Dateianfang), Alt+A (Markierung starten), Alt+/ (Dateiende), Strg+K (Markiertes ausschneiden).
18. Neue Konfiguration eintragen
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Nur lokal erreichbar
listen_addresses: '127.0.0.1:3000'
# Übersichtsseite mit allen Kachelquellen unter http://localhost:3000/
web_ui: enable-for-all
cache:
size_mb: 256
postgres:
# Anmeldung über den lokalen Socket, ohne Passwort
connection_string: 'postgresql:///osm?host=/var/run/postgresql&user=martin'
# Ausdehnung der Daten beim Start genau berechnen
auto_bounds: calc
auto_publish:
tables: true
functions: false
Was die Einträge bewirken:
connection_string: Der leere Teil zwischen//und/osmheißt „kein Rechnername“. Mithost=/var/run/postgresqlnutzt Martin den Unix-Socket statt TCP. Nur so greift die passwortlose Anmeldung.auto_publish.tables: true: Martin veröffentlicht jede Tabelle mit Geometriespalte als eigene Kachelquelle, benannt nach der Tabelle.auto_bounds: calc: Martin trägt in die Beschreibung jeder Quelle den Ausschnitt ein, der tatsächlich Daten enthält.
19. Ordner für die Dienst-Ergänzung anlegen
Der mitgelieferte Dienst würde Martin als root starten. Das ist unnötig, und die Anmeldung als martin bei der Datenbank würde scheitern. Eine Ergänzungsdatei (Drop-in) ändert das, ohne die Paketdatei anzufassen, die bei einem Update überschrieben würde.
sudo mkdir -p /etc/systemd/system/martin.service.d
20. Ergänzungsdatei anlegen
sudo nano /etc/systemd/system/martin.service.d/override.conf
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Service]
User=martin
Group=martin
Restart=on-failure
Restart=on-failure startet Martin neu, falls er abstürzt, z. B. weil PostgreSQL beim Hochfahren noch nicht bereit war.
21. Dienst einschalten und starten
daemon-reload liest die neue Ergänzungsdatei ein. enable --now startet Martin sofort und bei jedem Systemstart.
sudo systemctl daemon-reload
sudo systemctl enable --now martin
Prüfen: Der Dienst ist active (running). Im Journal steht für jede Tabelle eine Zeile Published source und am Ende Martin server is now active at http://127.0.0.1:3000/.
systemctl status martin --no-pager
journalctl -u martin -n 30 --no-pager
Prüfen: Der Katalog listet die vier Quellen flaechen, gebaeude, orte und strassen.
curl -s http://localhost:3000/catalog
Prüfen: Eine Kachel über der Ahrensburger Innenstadt (Zoomstufe 14) wird mit Status 200 und einigen zehn Kilobyte geliefert. Mehrere Quellen, durch Kommas getrennt, fasst Martin zu einer Kachel zusammen.
curl -s -o /dev/null -w '%{http_code} %{size_download}\n' http://localhost:3000/strassen,gebaeude,flaechen,orte/14/8657/5285
Status 204 bedeutet: Die Kachel ist gültig, enthält an dieser Stelle aber keine Daten.
Karte ansehen
22. Testseite anlegen
Eine kleine HTML-Datei holt sich über die TileJSON-Adresse http://localhost:3000/flaechen,gebaeude,strassen,orte die Kacheln und legt fest, wie jede Tabelle gezeichnet wird. source-layer ist dabei immer der Tabellenname. Martin erlaubt Zugriffe von fremden Seiten (CORS), deshalb klappt das auch mit einer lokal geöffneten Datei.
nano ~/martin-karte.html
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Martin – Ahrensburg</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/maplibre-gl@5.24.0/dist/maplibre-gl.css">
<script src="https://cdn.jsdelivr.net/npm/maplibre-gl@5.24.0/dist/maplibre-gl.js"></script>
<style>html, body, #karte { height: 100%; margin: 0; }</style>
</head>
<body>
<div id="karte"></div>
<script>
const karte = new maplibregl.Map({
container: 'karte',
center: [10.236, 53.675],
zoom: 14,
style: {
version: 8,
sources: {
ahrensburg: {
type: 'vector',
url: 'http://localhost:3000/flaechen,gebaeude,strassen,orte',
attribution: '© OpenStreetMap-Mitwirkende'
}
},
layers: [
{ id: 'hintergrund', type: 'background',
paint: { 'background-color': '#f4f1ea' } },
{ id: 'flaechen', type: 'fill', source: 'ahrensburg', 'source-layer': 'flaechen',
paint: { 'fill-color': ['match', ['get', 'art'],
['natural=water', 'water=pond', 'water=lake'], '#9cc3e6',
['landuse=forest', 'natural=wood'], '#a7c796',
['landuse=grass', 'landuse=meadow', 'leisure=park'], '#cfe5b5',
['landuse=residential'], '#e8e2d8',
'#dcd8c8'] } },
{ id: 'gebaeude', type: 'fill', source: 'ahrensburg', 'source-layer': 'gebaeude',
minzoom: 13,
paint: { 'fill-color': '#c9b8a8', 'fill-outline-color': '#a8968a' } },
{ id: 'strassen', type: 'line', source: 'ahrensburg', 'source-layer': 'strassen',
paint: {
'line-color': ['match', ['get', 'art'],
['motorway', 'trunk', 'primary'], '#e8925a',
['secondary', 'tertiary'], '#f2c96b',
'#ffffff'],
'line-width': ['match', ['get', 'art'],
['motorway', 'trunk', 'primary'], 4,
['secondary', 'tertiary'], 3,
['footway', 'path', 'cycleway', 'track'], 1,
2] } },
{ id: 'orte', type: 'circle', source: 'ahrensburg', 'source-layer': 'orte',
minzoom: 15,
paint: { 'circle-radius': 3, 'circle-color': '#b0406a' } }
]
}
});
karte.addControl(new maplibregl.NavigationControl());
// Beim Klick auf einen Punkt dessen Art und Namen anzeigen
karte.on('click', 'orte', (e) => {
const p = e.features[0].properties;
new maplibregl.Popup()
.setLngLat(e.lngLat)
.setText(`${p.art}${p.name ? ': ' + p.name : ''}`)
.addTo(karte);
});
</script>
</body>
</html>
Die Seite lädt MapLibre GL JS aus dem Netz. Es braucht also eine Internetverbindung, die Kartendaten selbst kommen aber vom eigenen Rechner.
23. Karte im Browser öffnen
xdg-open ~/martin-karte.html
Prüfen: Ahrensburg erscheint mit Flächen, Gebäuden und Straßen. Ab Zoomstufe 15 zeigen violette Punkte Geschäfte und Einrichtungen, ein Klick darauf nennt Art und Namen.
24. Übersichtsseite von Martin öffnen
Die eingebaute Oberfläche (dank web_ui aus Schritt 18) listet alle Quellen samt Feldern und hat eine einfache Vorschau.
xdg-open http://localhost:3000/
Über nginx veröffentlichen? Soll die Karte von außen erreichbar sein, bleibt Martin auf
127.0.0.1:3000, und nginx reicht einen Pfad wie/martin/weiter. Dafür in Schritt 18 die Zeileroute_prefix: '/martin'ergänzen und in nginxproxy_pass http://127.0.0.1:3000;verwenden, ohne Schrägstrich am Ende, damit/martinin der Adresse erhalten bleibt. nginx muss außerdem den KopfHostweitergeben (proxy_set_header Host $host;), denn aus ihm baut Martin die Kachel-Adressen in den TileJSON-Antworten. Wie ein solcher Proxy grundsätzlich eingerichtet wird, zeigt nginx als Proxy vor Apache.
Installation prüfen
martin --version
systemctl is-active postgresql martin
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3000/health
Die letzte Zeile sollte 200 lauten.
Deinstallieren
1. Dienst stoppen und abschalten
Beendet Martin und entfernt den Autostart.
sudo systemctl disable --now martin
2. Paket entfernen
purge löscht auch /etc/martin/config.yaml.
sudo apt purge martin
3. Dienst-Ergänzung entfernen
Die Datei aus Schritt 20 gehört nicht zum Paket und bleibt sonst liegen.
sudo rm -r /etc/systemd/system/martin.service.d
sudo systemctl daemon-reload
4. Datenbank löschen
Achtung: Alle importierten Daten in osm gehen verloren. Die Datenbank gis eines anderen Tileservers bleibt unberührt.
sudo -u postgres dropdb osm
5. Datenbankrolle löschen
Geht erst, wenn der Rolle keine Datenbank mehr gehört (Schritt 4).
sudo -u postgres dropuser martin
6. Systembenutzer löschen
sudo userdel martin
7. Importregeln und Testseite löschen
/srv/osm/data bleibt stehen, falls ein anderer Tileserver die Daten noch nutzt. Sonst /srv/osm/data ebenfalls löschen.
sudo rm -r /srv/osm/martin
rm ~/martin-karte.html
Prüfen: Das Programm und der Dienst sind verschwunden.
martin --version
systemctl status martin
Beide Befehle melden einen Fehler (Kommando nicht gefunden bzw. Unit martin.service could not be found).
Quellen und Lizenz
- Offizielle Dokumentation: https://martin.maplibre.org/
- Lizenz: Martin steht unter der MIT / Apache-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.
PostgreSQL
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
PostgreSQL ist eine freie Datenbank, die Daten in Tabellen ablegt und per SQL abfragen lässt. Auf dem Entwicklungsrechner dient es als robuste Datenbank für Webanwendungen und lokale Softwareprojekte. Mit der Erweiterung pgvector kann PostgreSQL außerdem Vektoren speichern und nach Ähnlichkeit durchsuchen, etwa für KI-Anwendungen mit Embeddings.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert PostgreSQL 18 und die Erweiterung pgvector direkt in den eigenen Paketquellen. Für die meisten Fälle reicht das.
- Offizielles PostgreSQL-Archiv (optional): Das PostgreSQL-Projekt betreibt ein eigenes apt-Archiv (PGDG). Es liefert Fehlerbehebungen oft früher als Ubuntu und bietet auch ältere Hauptversionen wie 16 oder 17 an. Wer das braucht, bindet es vor der Installation ein, siehe den nächsten Abschnitt (mit nano) oder Plan B (per Befehl, ohne Editor). Sonst direkt mit Installation weitermachen.
- Versionsnummer im Paketnamen: Erweiterungen wie pgvector gibt es passend zu jeder PostgreSQL-Hauptversion, deshalb heißt das Paket
postgresql-18-pgvector.
Optional: Offizielles PostgreSQL-Archiv einbinden
Diese Schritte sind nur nötig, wenn du die Pakete direkt vom PostgreSQL-Projekt beziehen willst. Danach geht es wie gewohnt mit dem Abschnitt Installation weiter; apt nimmt dann automatisch die Pakete aus dem neuen Archiv.
1. Paketlisten aktualisieren
Sorgt dafür, dass apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
curl lädt den Signaturschlüssel herunter, ca-certificates enthält die Zertifikate, mit denen die HTTPS-Verbindung zum Archiv geprüft wird.
sudo apt install -y curl ca-certificates
3. Ordner für den Schlüssel anlegen
Legt das Verzeichnis an, in dem der Signaturschlüssel des Archivs abgelegt wird. install -d erzeugt den Ordner samt fehlender Elternordner und stört sich nicht daran, wenn er schon existiert.
sudo install -d /usr/share/postgresql-common/pgdg
4. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich vom PostgreSQL-Projekt stammen und unterwegs nicht verändert wurden. --fail sorgt dafür, dass bei einem Fehler keine kaputte Datei gespeichert wird.
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -1 /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc
5. Codenamen der Ubuntu-Version ermitteln
Das Archiv hat für jede Ubuntu-Version einen eigenen Bereich, der nach dem Codenamen benannt ist. Diesen Namen brauchst du im nächsten Schritt.
grep VERSION_CODENAME /etc/os-release
Prüfen: Bei Ubuntu 26.04 erscheint VERSION_CODENAME=resolute.
6. Paketquelle eintragen
Öffnet eine neue Datei, in der die Adresse des Archivs steht. Alle Dateien mit der Endung .sources in /etc/apt/sources.list.d/ liest apt automatisch als zusätzliche Paketquellen ein. Ubuntu 26.04 verwendet dieses Format auch für seine eigenen Paketquellen (ubuntu.sources).
sudo nano /etc/apt/sources.list.d/pgdg.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X. Der Teil vor -pgdg in der Zeile Suites muss zu dem Namen aus Schritt 5 passen, sonst findet apt im Archiv nichts.
Types: deb
URIs: https://apt.postgresql.org/pub/repos/apt
Suites: resolute-pgdg
Components: main
Architectures: amd64
Signed-By: /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc
Was die Felder bedeuten:
Types: deb– aus dieser Quelle werden fertige Programmpakete geladen, keine Quelltexte.URIs– die Internetadresse des Archivs.Suites– der Bereich des Archivs für deine Ubuntu-Version.Components: main– der Teil des Archivs mit den PostgreSQL-Paketen.Architectures: amd64– nur Pakete für 64-Bit-PCs mit Intel- oder AMD-Prozessor werden geladen.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 4 akzeptiert.
7. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis des neuen Archivs herunter.
sudo apt update
Prüfen: Unter den Versionen taucht eine Zeile mit apt.postgresql.org auf, und die Version beim Installationskandidat enthält pgdg26.04, z. B. 18.6-1.pgdg26.04+2.
apt policy postgresql-18
Weiter geht es mit dem Abschnitt Installation. Möchtest du eine ältere Hauptversion, ersetze dort 18 durch die gewünschte Zahl, z. B. sudo apt install postgresql-17 und sudo apt install postgresql-17-pgvector.
Plan B: Offizielles Archiv per Befehl einbinden
Dieser Weg führt zum selben Ziel wie der vorige Abschnitt, kommt aber ohne Editor aus: Die Paketquelle wird mit einem einzigen Befehl in die Datei /etc/apt/sources.list.d/pgdg.list geschrieben, und der Codename der Ubuntu-Version wird automatisch eingesetzt. Das ist praktisch, wenn das Eintragen mit nano nicht klappt oder wenn du die Schritte in ein Skript übernehmen willst.
Wichtig: Nutze entweder den vorigen Abschnitt oder Plan B, nicht beide. Gibt es schon die Datei /etc/apt/sources.list.d/pgdg.sources, lösche sie vorher mit sudo rm /etc/apt/sources.list.d/pgdg.sources. Sonst meldet apt update, dass dieselbe Quelle mehrfach eingetragen ist.
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
curl holt den Signaturschlüssel aus dem Internet, ca-certificates wird gebraucht, damit die HTTPS-Verbindung zum Archiv als vertrauenswürdig erkannt wird. -y beantwortet die Rückfrage von apt automatisch mit Ja.
sudo apt install -y curl ca-certificates
3. Ordner für den Schlüssel anlegen
Erzeugt das Verzeichnis, in dem der Schlüssel liegen soll. Ist es schon vorhanden, passiert nichts.
sudo install -d /usr/share/postgresql-common/pgdg
4. Signaturschlüssel herunterladen
Speichert den öffentlichen Schlüssel des PostgreSQL-Projekts. apt prüft damit später jedes Paket aus dem Archiv. Schlägt der Download fehl, bricht --fail ab, statt eine Fehlerseite als Schlüssel abzulegen.
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc
Prüfen: Die Ausgabe lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -1 /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc
5. Angaben zur Ubuntu-Version laden
Die Datei /etc/os-release enthält Name, Versionsnummer und Codename des Systems als Variablen. Der Punkt am Anfang liest sie in das aktuelle Terminal ein, sodass der nächste Schritt den Codenamen über $VERSION_CODENAME verwenden kann. Führe Schritt 6 deshalb im selben Terminalfenster aus.
. /etc/os-release
Prüfen: Bei Ubuntu 26.04 erscheint resolute.
echo $VERSION_CODENAME
6. Paketquelle eintragen
Schreibt eine Zeile mit der Adresse des Archivs in die Datei pgdg.list. Dabei setzt die Shell den Codenamen aus Schritt 5 für $VERSION_CODENAME ein. Der Umweg über sudo sh -c "…" ist nötig, weil die Umleitung > sonst mit deinen normalen Rechten ausgeführt würde und die Datei unter /etc nicht angelegt werden dürfte.
sudo sh -c "echo 'deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $VERSION_CODENAME-pgdg main' > /etc/apt/sources.list.d/pgdg.list"
Prüfen: Die Datei enthält eine Zeile, die mit deb [signed-by= beginnt und resolute-pgdg main enthält. Steht dort nur -pgdg main ohne Codenamen, wurde Schritt 5 übersprungen oder in einem anderen Terminal ausgeführt. Dann Schritt 5 und 6 wiederholen.
cat /etc/apt/sources.list.d/pgdg.list
7. Paketlisten neu einlesen
Jetzt lädt apt das Paketverzeichnis des PostgreSQL-Archivs herunter.
sudo apt update
Prüfen: Beim Installationskandidat steht eine Version mit pgdg26.04, z. B. 18.6-1.pgdg26.04+2.
apt policy postgresql-18
Weiter geht es mit dem Abschnitt Installation.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von PostgreSQL aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. PostgreSQL installieren
Installiert den Datenbankserver, die Client-Programme wie psql und richtet einen ersten Datenbank-Cluster namens 18/main ein. Der Dienst wird dabei automatisch gestartet.
sudo apt install postgresql
Prüfen: Die Version des Befehlszeilen-Clients wird angezeigt, z. B. psql (PostgreSQL) 18.6.
psql --version
3. Prüfen, ob der Datenbankdienst läuft
PostgreSQL läuft als Hintergrunddienst (systemd). pg_lsclusters zeigt alle Datenbank-Cluster mit ihrem Zustand.
pg_lsclusters
Prüfen: In der Zeile 18 main 5432 steht in der Spalte Status der Wert online.
Erste Schritte
4. Verbindung zur Datenbank testen
Bei der Installation wird der Verwaltungsbenutzer postgres eingerichtet. Mit ihm testest du die Verbindung.
sudo -u postgres psql -c "SELECT version();"
Prüfen: Die Ausgabe beginnt mit PostgreSQL 18.
5. Eigenen Datenbank-Benutzer anlegen
Erstellt einen PostgreSQL-Benutzer mit dem Namen deines Ubuntu-Benutzers. Danach kannst du ohne sudo mit der Datenbank arbeiten. --superuser gibt ihm volle Rechte, das ist auf einem Entwicklungsrechner praktisch, aber auf einem Server nicht zu empfehlen.
sudo -u postgres createuser --superuser "$USER"
6. Entwicklungsdatenbank anlegen
Erstellt eine erste eigene Datenbank mit dem Namen devdb.
createdb devdb
Prüfen: Die Verbindung klappt, und die Ausgabe zeigt devdb.
psql -d devdb -c "SELECT current_database();"
Interaktiv öffnest du die Datenbank mit psql -d devdb. Mit \q verlässt du die Konsole wieder.
pgvector einrichten
7. pgvector installieren
Installiert die Erweiterung passend zu PostgreSQL 18. Ein Neustart des Datenbankdienstes ist nicht nötig.
sudo apt install postgresql-18-pgvector
8. Erweiterung in der Datenbank einschalten
Erweiterungen werden in PostgreSQL pro Datenbank eingeschaltet. Dieser Befehl macht den Datentyp vector in devdb verfügbar. Er braucht Superuser-Rechte, die dein Benutzer aus Schritt 5 hat.
psql -d devdb -c "CREATE EXTENSION vector;"
Prüfen: Die Tabelle zeigt die Erweiterung vector mit Version 0.8.1.
psql -d devdb -c "\dx vector"
9. Beispieltabelle mit Vektoren anlegen
Legt eine Tabelle an, in der jede Zeile einen Text und einen Vektor mit drei Werten enthält. In echten Anwendungen stammen die Vektoren von einem Embedding-Modell und haben meist mehrere hundert Werte, z. B. vector(768). Zum Ausprobieren reichen drei.
psql -d devdb <<'EOF'
CREATE TABLE notizen (
id bigserial PRIMARY KEY,
text text,
vektor vector(3)
);
INSERT INTO notizen (text, vektor) VALUES
('Apfel', '[1, 0, 0]'),
('Birne', '[0.9, 0.1, 0]'),
('Auto', '[0, 0, 1]');
EOF
Prüfen: Die Ausgabe endet mit INSERT 0 3.
10. Ähnlichkeitssuche ausprobieren
Sucht die zwei Einträge, deren Vektor dem Suchvektor am ähnlichsten ist. Der Operator <=> berechnet den Kosinus-Abstand: Je kleiner der Wert, desto ähnlicher. Weitere Operatoren sind <-> (euklidischer Abstand) und <#> (negatives Skalarprodukt).
psql -d devdb -c "SELECT text, vektor <=> '[1, 0.05, 0]' AS abstand FROM notizen ORDER BY abstand LIMIT 2;"
Prüfen: Es erscheinen Apfel und Birne mit sehr kleinen Abständen. Auto liegt weit entfernt und fehlt deshalb.
11. Index für schnelle Suche anlegen
Ohne Index vergleicht PostgreSQL den Suchvektor mit jeder Zeile. Ein HNSW-Index beschleunigt die Suche bei vielen Einträgen deutlich. vector_cosine_ops passt zum Operator <=> aus dem vorigen Schritt.
psql -d devdb -c "CREATE INDEX ON notizen USING hnsw (vektor vector_cosine_ops);"
Prüfen: Unter Indexes steht ein Eintrag mit hnsw (vektor vector_cosine_ops).
psql -d devdb -c "\d notizen"
Optional: Autostart ausschalten
Auf einem Entwicklungsrechner muss der Datenbankdienst nicht bei jedem Rechnerstart laufen.
Autostart ausschalten:
sudo systemctl disable postgresql
Bei Bedarf von Hand starten und stoppen:
sudo systemctl start postgresql
sudo systemctl stop postgresql
Deinstallieren
1. PostgreSQL-Dienst stoppen
Beendet den laufenden Dienst vor der Deinstallation.
sudo systemctl stop postgresql
2. PostgreSQL und pgvector entfernen
purge entfernt die Pakete samt Konfigurationsdateien. Beim Paket postgresql-18 fragt apt, ob auch die Datenbank-Verzeichnisse gelöscht werden sollen. Wähle Ja, wenn die Daten weg können, sonst Nein.
sudo apt purge postgresql postgresql-18 postgresql-18-pgvector postgresql-client-18 postgresql-common postgresql-client-common
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt Bibliotheken, die nur für PostgreSQL installiert wurden.
sudo apt autoremove
4. Datenbankdateien löschen (optional)
Entfernt verbliebene Datenbank- und Konfigurationsverzeichnisse, falls du in Schritt 2 Nein gewählt hast. Achtung: Alle gespeicherten Daten gehen dabei unwiderruflich verloren.
sudo rm -rf /var/lib/postgresql /etc/postgresql
Prüfen: Der Befehl psql wird nicht mehr gefunden.
psql --version
5. Offizielles PostgreSQL-Archiv entfernen (falls eingebunden)
Nur nötig, wenn du den optionalen Abschnitt oder Plan B zum PostgreSQL-Archiv ausgeführt hast. Der Befehl löscht die Paketquelle (pgdg.sources bzw. bei Plan B pgdg.list) und den Signaturschlüssel. -f sorgt dafür, dass keine Fehlermeldung erscheint, wenn eine der beiden Quelldateien nicht existiert.
sudo rm -f /etc/apt/sources.list.d/pgdg.sources /etc/apt/sources.list.d/pgdg.list /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc
6. Paketlisten aktualisieren
Damit apt das entfernte Archiv vergisst.
sudo apt update
Prüfen: In der Ausgabe kommt apt.postgresql.org nicht mehr vor.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.postgresql.org/docs/
- Lizenz: PostgreSQL steht unter der PostgreSQL License.
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.
MariaDB
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
MariaDB ist ein freier Datenbankserver, der aus MySQL hervorgegangen und weitgehend mit ihm verträglich ist. Er speichert Daten in Tabellen und wird per SQL abgefragt. Viele Webanwendungen wie WordPress, Joomla oder Contao setzen MariaDB oder MySQL voraus. Diese Anleitung richtet den Server ein und zeigt die wichtigsten Handgriffe: Datenbank und Benutzer anlegen, Tabellen abfragen und Sicherungen erstellen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert MariaDB 11.8. Mit dem Paket
mariadb-serverkommen 22 Pakete auf den Rechner. - Nur lokal erreichbar: Der Server lauscht nach der Installation nur auf
127.0.0.1, Port 3306. Andere Rechner im Netz erreichen ihn nicht. - Anmeldung als root ohne Passwort: Der Datenbank-Benutzer
rootmeldet sich über den Unix-Socket an. Wersudodarf, kommt mitsudo mariadbhinein, alle anderen gar nicht. Das früher übliche Skriptmariadb-secure-installationist deshalb nicht nötig: Anonyme Benutzer und eine Testdatenbank legt Ubuntu gar nicht erst an. - Für Programme eigene Benutzer: Anwendungen sollten nie als
rootarbeiten, sondern mit einem eigenen Benutzer, der nur seine Datenbank sieht. - Version: Getestet mit MariaDB 11.8.6 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB installieren
Installiert Server und Kommandozeilenprogramm. Der Dienst startet sofort und künftig bei jedem Hochfahren.
sudo apt install mariadb-server
3. Prüfen, ob der Dienst läuft
systemctl status mariadb
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
4. Prüfen, dass der Server nur lokal lauscht
sudo ss -ltnp | grep 3306
Prüfen: Die Zeile beginnt mit LISTEN und nennt die Adresse 127.0.0.1:3306.
Datenbank und Benutzer anlegen
5. Als root anmelden
sudo mariadb öffnet die Konsole als Datenbank-Administrator. Die Eingabezeile lautet MariaDB [(none)]>.
sudo mariadb
6. Datenbank anlegen
Gib in der Konsole ein und drücke Enter. SQL-Befehle enden mit einem Semikolon. utf8mb4 speichert alle Zeichen, auch Umlaute und Emojis.
CREATE DATABASE laden CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
7. Benutzer anlegen
Ersetze GEHEIMES-PASSWORT durch ein eigenes Passwort. 'laden'@'localhost' bedeutet: Der Benutzer laden darf sich nur vom eigenen Rechner aus anmelden.
CREATE USER 'laden'@'localhost' IDENTIFIED BY 'GEHEIMES-PASSWORT';
8. Rechte vergeben
Der Benutzer bekommt alle Rechte, aber nur an der Datenbank laden.
GRANT ALL PRIVILEGES ON laden.* TO 'laden'@'localhost';
Prüfen: Jeder der drei Befehle antwortet mit Query OK.
9. Konsole verlassen
exit
10. Als neuer Benutzer anmelden
-u nennt den Benutzer, -p fragt nach dem Passwort, das letzte Wort ist die Datenbank.
mariadb -u laden -p laden
Prüfen: Nach dem Passwort lautet die Eingabezeile MariaDB [laden]>. Verlasse die Konsole mit exit.
Mit Tabellen arbeiten
11. Übungsordner anlegen
mkdir ~/mariadb-uebung
12. In den Ordner wechseln
cd ~/mariadb-uebung
13. SQL-Datei anlegen
Die Datei legt zwei Tabellen an, Modelle und Verkäufe, und füllt sie mit Beispieldaten.
nano laden.sql
Füge diesen Inhalt ein (Strg+Umschalt+V):
-- Tabellen für einen kleinen Fahrradladen
CREATE TABLE modell (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(50) NOT NULL UNIQUE,
preis DECIMAL(8,2) NOT NULL,
lager INT NOT NULL DEFAULT 0
);
CREATE TABLE verkauf (
id INT AUTO_INCREMENT PRIMARY KEY,
modell_id INT NOT NULL,
anzahl INT NOT NULL,
datum DATE NOT NULL,
FOREIGN KEY (modell_id) REFERENCES modell(id)
);
INSERT INTO modell (name, preis, lager) VALUES
('Citybike', 699.00, 4),
('Trekkingrad', 899.00, 0),
('Lastenrad', 3490.00, 1);
INSERT INTO verkauf (modell_id, anzahl, datum) VALUES
(1, 2, '2026-09-01'),
(3, 1, '2026-09-02'),
(1, 3, '2026-09-02'),
(2, 1, '2026-09-05'),
(1, 1, '2026-09-08');
AUTO_INCREMENT PRIMARY KEY– eine Nummer, die MariaDB für jede neue Zeile selbst vergibt und die jede Zeile eindeutig kennzeichnet.DECIMAL(8,2)– eine Zahl mit zwei Nachkommastellen, genau gerechnet. Für Geldbeträge besser als Kommazahlen vom TypFLOAT.NOT NULL,UNIQUE,DEFAULT– das Feld muss gefüllt sein, darf nicht doppelt vorkommen bzw. hat einen Vorgabewert.FOREIGN KEY– jeder Verkauf muss auf ein vorhandenes Modell verweisen. Einen Verkauf zu einem Modell, das es nicht gibt, lehnt MariaDB ab.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. SQL-Datei einlesen
< gibt die Datei als Eingabe an MariaDB weiter.
mariadb -u laden -p laden < laden.sql
Prüfen: Nach dem Passwort erscheint keine Meldung. Das bedeutet, alles hat geklappt.
15. Konsole öffnen
mariadb -u laden -p laden
16. Lieferbare Modelle abfragen
SELECT name, preis, lager FROM modell WHERE lager > 0 ORDER BY preis;
Prüfen: Die Tabelle nennt Citybike (699.00, 4) und Lastenrad (3490.00, 1).
17. Umsatz je Modell berechnen
JOIN verbindet die Verkäufe mit den Modellen, GROUP BY fasst die Zeilen je Modell zusammen.
SELECT m.name, SUM(v.anzahl) AS stueck, SUM(v.anzahl * m.preis) AS umsatz
FROM verkauf v JOIN modell m ON m.id = v.modell_id
GROUP BY m.name ORDER BY umsatz DESC;
Prüfen: Die Ausgabe lautet:
+-------------+--------+---------+
| name | stueck | umsatz |
+-------------+--------+---------+
| Citybike | 6 | 4194.00 |
| Lastenrad | 1 | 3490.00 |
| Trekkingrad | 1 | 899.00 |
+-------------+--------+---------+
18. Fremdschlüssel ausprobieren
Ein Verkauf zu einem Modell mit der Nummer 99, das es nicht gibt:
INSERT INTO verkauf (modell_id, anzahl, datum) VALUES (99, 1, '2026-09-10');
Prüfen: MariaDB lehnt ab mit ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails. Verlasse die Konsole danach mit exit.
Passwort in einer Datei hinterlegen (optional)
Damit man das Passwort nicht bei jedem Aufruf eintippen muss, liest MariaDB es aus der Datei ~/.my.cnf.
19. Datei anlegen
nano ~/.my.cnf
Füge diesen Inhalt ein und ersetze GEHEIMES-PASSWORT durch dein Passwort:
[client]
user = laden
password = GEHEIMES-PASSWORT
[mariadb-client]
database = laden
[client]– gilt für alle Programme von MariaDB, auch fürmariadb-dump.[mariadb-client]– gilt nur für die Konsolemariadb. Die Angabedatabasegehört hierher, weilmariadb-dumpsie sonst falsch versteht und eine Warnung ausgibt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
20. Datei vor anderen Benutzern schützen
chmod 600 erlaubt nur dir selbst, die Datei zu lesen.
chmod 600 ~/.my.cnf
Prüfen: mariadb öffnet die Datenbank laden jetzt ohne Nachfrage.
mariadb -e "SELECT CURRENT_USER();"
Sichern und wiederherstellen
21. Sicherung erstellen
mariadb-dump schreibt alle Tabellen samt Inhalt als SQL-Befehle in eine Datei. Ohne ~/.my.cnf kommen -u laden -p dazu.
mariadb-dump laden > sicherung.sql
Prüfen: Die Datei enthält für jede Tabelle einen Befehl INSERT INTO.
grep -c "INSERT INTO" sicherung.sql
Die Ausgabe lautet 2.
22. Sicherung wiederherstellen
Spielt die Sicherung in die Datenbank laden ein. Vorhandene Tabellen mit gleichem Namen werden dabei ersetzt.
mariadb laden < sicherung.sql
Optional: Autostart ausschalten
Wer MariaDB nur ab und zu braucht, kann den Dienst beim Hochfahren weglassen und bei Bedarf mit sudo systemctl start mariadb starten.
sudo systemctl disable --now mariadb
Wie geht es weiter?
- Aus Programmen zugreifen: Für PHP gibt es
php-mysql, für Python das Paketpython3-pymysql, für Java den Treiber MariaDB Connector/J. - Grafische Werkzeuge: DBeaver oder Adminer zeigen Tabellen und Abfragen im Fenster bzw. im Browser.
- Zugriff aus dem Netz: Soll ein anderer Rechner zugreifen, muss in
/etc/mysql/mariadb.conf.d/50-server.cnfdie Zeilebind-addressangepasst und ein Benutzer mit passendem Host angelegt werden. Den Port 3306 sollte man dann mit einer Firewall auf bekannte Rechner beschränken. - Dokumentation: Handbuch und SQL-Referenz unter https://mariadb.com/docs/.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/mariadb-uebung
2. Passwortdatei entfernen (falls angelegt)
rm -f ~/.my.cnf
3. Dienst beenden
sudo systemctl stop mariadb
4. MariaDB entfernen
sudo apt purge mariadb-server mariadb-client
Während des Entfernens erscheint ein blauer Dialog: „Das Verzeichnis /var/lib/mysql mit den MariaDB-Datenbanken soll entfernt werden. … Alle MariaDB-Datenbanken entfernen?“ Voreingestellt ist Nein. Dann bleiben die Datenbanken erhalten, etwa für eine spätere Neuinstallation. Wähle Ja mit den Pfeiltasten und Enter, wenn alle Daten gelöscht werden sollen. Vorher wichtige Daten mit mariadb-dump sichern.
5. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
6. Datenbankdateien nachträglich löschen (optional)
Nur nötig, wenn du im Dialog aus Schritt 4 Nein gewählt hast und die Daten jetzt doch loswerden willst. Achtung: Löscht alle Datenbanken endgültig.
sudo rm -rf /var/lib/mysql
Der Ordner /etc/mysql gehört zum Paket mysql-common, das oft schon vorher installiert war, weil andere Programme es brauchen. Er bleibt deshalb stehen.
Prüfen: Der Befehl mariadb wird nicht mehr gefunden.
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://mariadb.org/documentation/
- Lizenz: MariaDB steht unter der GPL-2.0-only.
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.
MySQL
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
MySQL ist ein weit verbreiteter relationaler Datenbankserver von Oracle, den man per SQL abfragt. Viele Webanwendungen und Frameworks wie WordPress, Laravel oder Ruby on Rails unterstützen ihn direkt. In dieser Anleitung wird der Server installiert, eine eigene Datenbank mit Benutzer eingerichtet, mit Tabellen gearbeitet und eine Sicherung angelegt.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 bringt MySQL 8.4 mit, eine Version mit Langzeitpflege (LTS). Das Paket
mysql-serverinstalliert insgesamt 15 Pakete. - MySQL oder MariaDB: Beide Server teilen sich Port 3306, den Ordner
/var/lib/mysqlund viele Dateinamen. Auf einem Rechner läuft deshalb nur einer von beiden. Ist MariaDB schon installiert, willaptes beim Installieren von MySQL entfernen. Lies in diesem Fall die Liste in Schritt 2 genau und brich mit n ab, wenn du MariaDB behalten willst. - Nur vom eigenen Rechner erreichbar: Nach der Installation nimmt MySQL nur Verbindungen über
127.0.0.1an. Neben dem gewohnten Port 3306 öffnet es zusätzlich Port 33060 für das neuere X-Protokoll (genutzt etwa von MySQL Shell). - root ohne Passwort, aber nur mit sudo: Der Datenbank-Benutzer
rootwird über den Unix-Socket geprüft. Nur wersudoverwenden darf, kommt mitsudo mysqlhinein. Anonyme Benutzer und eine Testdatenbank richtet Ubuntu nicht ein, daher istmysql_secure_installationhier nicht erforderlich. - Zeichensatz: MySQL 8.4 verwendet von Haus aus
utf8mb4. Umlaute und Emojis werden also ohne weitere Einstellung richtig gespeichert. - Version: Getestet mit MySQL 8.4.11 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
So kennt apt die neuesten Paketversionen.
sudo apt update
2. MySQL installieren
Das Paket bringt den Server und das Kommandozeilenprogramm mysql mit. Der Dienst wird gleich gestartet und läuft künftig nach jedem Neustart.
sudo apt install mysql-server
Prüfen: Die Versionsnummer wird angezeigt.
mysql --version
3. Dienst prüfen
systemctl status mysql
Prüfen: Die Ausgabe enthält active (running). Mit q kommst du zurück zur Eingabezeile.
4. Offene Ports prüfen
Zeigt, auf welchen Adressen MySQL Verbindungen annimmt.
sudo ss -ltnp | grep mysqld
Prüfen: Es erscheinen zwei Zeilen mit 127.0.0.1:3306 und 127.0.0.1:33060. Steht dort 0.0.0.0 oder *, wäre der Server aus dem Netz erreichbar.
Datenbank und Benutzer einrichten
5. Als Administrator anmelden
Öffnet die MySQL-Konsole als Benutzer root. Die Eingabezeile wechselt zu mysql>.
sudo mysql
6. Datenbank anlegen
Tippe den Befehl in die Konsole und bestätige mit Enter. Jeder SQL-Befehl wird mit einem Semikolon abgeschlossen. Ein eigener Zeichensatz ist nicht nötig, weil utf8mb4 schon voreingestellt ist.
CREATE DATABASE buecherei;
7. Benutzer anlegen
Setze statt GEHEIMES-PASSWORT ein eigenes Passwort ein. Der Zusatz @'localhost' legt fest, dass sich dieser Benutzer nur vom selben Rechner aus verbinden darf.
CREATE USER 'buecherei'@'localhost' IDENTIFIED BY 'GEHEIMES-PASSWORT';
8. Rechte vergeben
buecherei.* steht für alle Tabellen der Datenbank buecherei. Auf andere Datenbanken hat der Benutzer keinen Zugriff.
GRANT ALL PRIVILEGES ON buecherei.* TO 'buecherei'@'localhost';
Prüfen: MySQL bestätigt jeden der drei Befehle mit Query OK.
9. Konsole beenden
exit
10. Mit dem neuen Benutzer verbinden
-u gibt den Benutzernamen an, -p lässt MySQL nach dem Passwort fragen. Am Ende steht der Name der Datenbank.
mysql -u buecherei -p buecherei
Prüfen: Die Anmeldung gelingt und die Eingabezeile lautet mysql>. Gib zur Kontrolle ein:
SELECT CURRENT_USER(), DATABASE();
Die Antwort nennt buecherei@localhost und buecherei. Beende die Konsole mit exit.
Tabellen anlegen und abfragen
11. Arbeitsordner anlegen
mkdir ~/mysql-uebung
12. In den Ordner wechseln
cd ~/mysql-uebung
13. SQL-Datei schreiben
Die Datei beschreibt eine kleine Bücherei: eine Tabelle mit Büchern und eine mit Ausleihen. Beide werden gleich mit Beispielen gefüllt.
nano buecherei.sql
Füge diesen Inhalt ein (Strg+Umschalt+V):
-- Tabellen für eine kleine Bücherei
CREATE TABLE buch (
id INT AUTO_INCREMENT PRIMARY KEY,
titel VARCHAR(100) NOT NULL,
autor VARCHAR(60) NOT NULL,
jahr SMALLINT NOT NULL,
CHECK (jahr BETWEEN 1450 AND 2100)
);
CREATE TABLE ausleihe (
id INT AUTO_INCREMENT PRIMARY KEY,
buch_id INT NOT NULL,
leser VARCHAR(40) NOT NULL,
von DATE NOT NULL,
bis DATE,
FOREIGN KEY (buch_id) REFERENCES buch(id)
);
INSERT INTO buch (titel, autor, jahr) VALUES
('Der Schimmelreiter', 'Theodor Storm', 1888),
('Effi Briest', 'Theodor Fontane', 1896),
('Die Blechtrommel', 'Günter Grass', 1959),
('Der Process', 'Franz Kafka', 1925);
INSERT INTO ausleihe (buch_id, leser, von, bis) VALUES
(1, 'Anna', '2026-09-01', '2026-09-15'),
(2, 'Ben', '2026-09-03', NULL),
(1, 'Carla','2026-09-16', NULL),
(3, 'Anna', '2026-09-20', '2026-09-28'),
(1, 'Ben', '2026-08-10', '2026-08-24');
Was die einzelnen Angaben bedeuten:
AUTO_INCREMENT PRIMARY KEY– MySQL zählt die Nummer für jede neue Zeile selbst hoch. Über diese Nummer lässt sich jede Zeile eindeutig ansprechen.VARCHAR(100)– Text mit höchstens 100 Zeichen.CHECK (…)– eine Regel für gültige Werte. Ein Buch mit dem Jahr 2300 wird abgewiesen.bis DATEohneNOT NULL– das Feld darf leer bleiben (NULL). Ein leeres Rückgabedatum heißt hier: Das Buch ist noch ausgeliehen.FOREIGN KEY– jede Ausleihe muss zu einem Buch gehören, das es in der Tabellebuchwirklich gibt.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
14. SQL-Datei ausführen
Das Zeichen < leitet den Inhalt der Datei an mysql weiter.
mysql -u buecherei -p buecherei < buecherei.sql
Prüfen: Nach der Passworteingabe kommt keine Ausgabe. Das ist hier das Zeichen für Erfolg; eine Fehlermeldung würde mit ERROR beginnen.
15. Konsole öffnen
mysql -u buecherei -p buecherei
16. Ausgeliehene Bücher anzeigen
JOIN holt zu jeder Ausleihe den Buchtitel dazu. IS NULL findet die Ausleihen ohne Rückgabedatum.
SELECT b.titel, a.leser, a.von
FROM ausleihe a JOIN buch b ON b.id = a.buch_id
WHERE a.bis IS NULL ORDER BY a.von;
Prüfen: Die Ausgabe lautet:
+--------------------+-------+------------+
| titel | leser | von |
+--------------------+-------+------------+
| Effi Briest | Ben | 2026-09-03 |
| Der Schimmelreiter | Carla | 2026-09-16 |
+--------------------+-------+------------+
17. Ausleihen je Buch zählen
LEFT JOIN nimmt auch Bücher mit, die nie ausgeliehen wurden. COUNT zählt die Ausleihen, GROUP BY bildet eine Zeile pro Buch.
SELECT b.titel, COUNT(a.id) AS ausleihen
FROM buch b LEFT JOIN ausleihe a ON a.buch_id = b.id
GROUP BY b.id, b.titel ORDER BY ausleihen DESC, b.titel;
Prüfen: Die Ausgabe lautet:
+--------------------+-----------+
| titel | ausleihen |
+--------------------+-----------+
| Der Schimmelreiter | 3 |
| Die Blechtrommel | 1 |
| Effi Briest | 1 |
| Der Process | 0 |
+--------------------+-----------+
18. Prüfregel testen
Versuche, ein Buch mit einem unmöglichen Erscheinungsjahr einzutragen:
INSERT INTO buch (titel, autor, jahr) VALUES ('Zukunftsroman', 'Niemand', 2300);
Prüfen: MySQL antwortet mit ERROR 3819 (HY000): Check constraint 'buch_chk_1' is violated. und speichert nichts.
19. Fremdschlüssel testen
Versuche, ein Buch mit der Nummer 99 auszuleihen, die es nicht gibt:
INSERT INTO ausleihe (buch_id, leser, von) VALUES (99, 'Dora', '2026-10-01');
Prüfen: Die Antwort beginnt mit ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails. Verlasse die Konsole anschließend mit exit.
Passwort in einer Datei hinterlegen (optional)
Statt das Passwort jedes Mal einzutippen, kann MySQL es aus der Datei ~/.my.cnf im Home-Ordner lesen.
20. Datei anlegen
nano ~/.my.cnf
Füge diesen Inhalt ein und setze statt GEHEIMES-PASSWORT dein Passwort ein:
[client]
user = buecherei
password = GEHEIMES-PASSWORT
[mysql]
database = buecherei
[mysqldump]
no-tablespaces
[client]– Angaben für alle MySQL-Programme, also auch fürmysqldump.[mysql]– Angaben nur für die Konsolemysql. Die Datenbank muss hier stehen: Unter[client]würdemysqldumpmitunknown variable 'database=buecherei'abbrechen.[mysqldump]–no-tablespacesverhindert die Fehlermeldungyou need (at least one of) the PROCESS privilege(s). Dieses Recht hat ein gewöhnlicher Benutzer nicht, und für eine Sicherung einzelner Datenbanken braucht man es auch nicht.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
21. Datei schützen
chmod 600 sorgt dafür, dass nur du die Datei lesen und ändern kannst. Das ist wichtig, weil darin ein Passwort steht.
chmod 600 ~/.my.cnf
Prüfen: Die Konsole verbindet sich jetzt ohne Passwortabfrage.
mysql -e "SELECT CURRENT_USER(), DATABASE();"
Sichern und wiederherstellen
22. Sicherung anlegen
mysqldump schreibt Aufbau und Inhalt aller Tabellen als SQL-Befehle in eine Datei. Wer keine ~/.my.cnf angelegt hat, ergänzt -u buecherei -p --no-tablespaces.
mysqldump buecherei > sicherung.sql
Prüfen: Die Datei enthält für jede der zwei Tabellen einen Befehl INSERT INTO.
grep -c "INSERT INTO" sicherung.sql
Die Ausgabe lautet 2.
23. Sicherung zurückspielen
Liest die Sicherung wieder in die Datenbank buecherei ein. Gleichnamige Tabellen werden dabei gelöscht und neu angelegt.
mysql buecherei < sicherung.sql
Optional: Nicht automatisch starten
Wer MySQL nur gelegentlich braucht, kann den Start beim Hochfahren abschalten. Bei Bedarf startet sudo systemctl start mysql den Dienst wieder.
sudo systemctl disable --now mysql
Wie geht es weiter?
- Zugriff aus Programmen: PHP verbindet sich über
php-mysql, Python zum Beispiel überpython3-pymysqlund Java über den Treiber MySQL Connector/J. - Grafische Oberflächen: Mit DBeaver oder Adminer lassen sich Tabellen ansehen und Abfragen bequem ausführen.
- Zugriff aus dem Netz: Dafür muss
bind-addressin/etc/mysql/mysql.conf.d/mysqld.cnfgeändert und ein Benutzer mit passendem Host angelegt werden. Port 3306 sollte dann per Firewall nur für bekannte Rechner offen sein. - Dokumentation: Das Referenzhandbuch zu MySQL 8.4 findest du unter https://dev.mysql.com/doc/refman/8.4/en/.
Deinstallieren
1. Arbeitsordner löschen
rm -rf ~/mysql-uebung
2. Passwortdatei löschen (falls angelegt)
rm -f ~/.my.cnf
3. Dienst anhalten
sudo systemctl stop mysql
4. MySQL entfernen
sudo apt purge mysql-server mysql-client
Beim Entfernen öffnet sich ein Dialog mit der Frage „Alle MySQL-Datenbanken entfernen?“. Er weist darauf hin, dass dabei /var/lib/mysql, /var/lib/mysql-files und /var/lib/mysql-keyring gelöscht würden. Voreingestellt ist Nein: Die Daten bleiben dann liegen und stehen bei einer erneuten Installation wieder zur Verfügung. Wer alles löschen will, wählt mit den Pfeiltasten Ja und bestätigt mit Enter. Wichtige Daten vorher mit mysqldump sichern.
5. Ü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
6. Datenordner später löschen (optional)
Nur nötig, wenn du in Schritt 4 Nein gewählt hast und die Daten jetzt doch nicht mehr brauchst. Achtung: Alle Datenbanken sind danach unwiderruflich weg.
sudo rm -rf /var/lib/mysql /var/lib/mysql-files /var/lib/mysql-keyring
Der Ordner /etc/mysql bleibt bestehen. Er gehört zum Paket mysql-common, das meist schon vor MySQL installiert war, weil andere Programme es nutzen.
Prüfen: Der Befehl mysql ist nicht mehr vorhanden.
mysql --version
Quellen und Lizenz
- Offizielle Dokumentation: https://dev.mysql.com/doc/
- Lizenz: MySQL steht unter der GPL-2.0-only.
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.
SQLite
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
SQLite ist eine kleine SQL-Datenbank, die ohne Server auskommt: Die ganze Datenbank steckt in einer einzigen Datei. Sie eignet sich für Übungen, Werkzeuge, Desktop-Programme und kleinere Webseiten. Viele Programme bringen SQLite bereits mit, etwa Browser oder Python. Diese Anleitung installiert das Kommandozeilenprogramm sqlite3 und zeigt, wie man damit Datenbanken anlegt, abfragt und sichert.
Vorbemerkungen
- Kein Dienst, kein Passwort: Anders als bei PostgreSQL oder MariaDB läuft im Hintergrund nichts. Wer eine Datenbankdatei lesen und schreiben darf, darf auch die Daten lesen und ändern. Die Rechte regelt also allein das Dateisystem.
- Bibliothek schon vorhanden: Die Bibliothek
libsqlite3-0ist auf Ubuntu fast immer schon installiert, weil viele Programme sie nutzen. Neu kommt nur das Paketsqlite3mit dem Kommandozeilenprogramm dazu. - Zwei Eigenheiten: SQLite prüft Fremdschlüssel nur, wenn man es ausdrücklich einschaltet. Außerdem nimmt es in normalen Tabellen auch Werte des falschen Typs an, etwa Text in einer Zahlenspalte. Beides lässt sich abstellen. Die Anleitung zeigt, wie.
- Version: Getestet mit SQLite 3.46.1 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. SQLite installieren
Installiert das Kommandozeilenprogramm sqlite3.
sudo apt install sqlite3
Prüfen: Die Ausgabe beginnt mit 3.46.1.
sqlite3 --version
Einstellungen für die Konsole
Beim Start liest sqlite3 die Datei ~/.sqliterc und führt die Befehle darin aus. Dort legen wir eine übersichtliche Tabellenanzeige fest und schalten die Prüfung der Fremdschlüssel ein.
3. Einstellungsdatei anlegen
nano ~/.sqliterc
Füge diesen Inhalt ein (Strg+Umschalt+V):
.headers on
.mode box
PRAGMA foreign_keys = ON;
.headers on– zeigt über den Ergebnissen die Spaltennamen..mode box– zeichnet Ergebnisse als Tabelle mit Rahmen. Ohne diese Zeile trenntsqlite3die Spalten nur mit|.PRAGMA foreign_keys = ON;– lässt SQLite prüfen, ob Verweise zwischen Tabellen stimmen. Die Einstellung gilt nur für die laufende Sitzung und muss deshalb bei jedem Start gesetzt werden.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Datenbank anlegen und füllen
4. Übungsordner anlegen
mkdir ~/sqlite-uebung
5. In den Ordner wechseln
cd ~/sqlite-uebung
6. SQL-Datei anlegen
Die Datei beschreibt zwei Tabellen für einen kleinen Fahrradladen, Modelle und Verkäufe, und füllt sie mit Beispieldaten.
nano laden.sql
Füge diesen Inhalt ein:
-- Tabellen für einen kleinen Fahrradladen
CREATE TABLE modell (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL UNIQUE,
preis REAL NOT NULL,
lager INTEGER NOT NULL DEFAULT 0
) STRICT;
CREATE TABLE verkauf (
id INTEGER PRIMARY KEY,
modell_id INTEGER NOT NULL REFERENCES modell(id),
anzahl INTEGER NOT NULL,
datum TEXT NOT NULL
) STRICT;
INSERT INTO modell (name, preis, lager) VALUES
('Citybike', 699.00, 4),
('Trekkingrad', 899.00, 0),
('Lastenrad', 3490.00, 1);
INSERT INTO verkauf (modell_id, anzahl, datum) VALUES
(1, 2, '2026-09-01'),
(3, 1, '2026-09-02'),
(1, 3, '2026-09-02'),
(2, 1, '2026-09-05'),
(1, 1, '2026-09-08');
INTEGER PRIMARY KEY– SQLite vergibt für jede neue Zeile selbst eine fortlaufende Nummer.STRICT– die Tabelle nimmt nur Werte des angegebenen Typs an. Ohne diesen Zusatz würde SQLite zum Beispiel den Text'teuer'als Preis speichern.REFERENCES modell(id)– jeder Verkauf muss auf ein vorhandenes Modell verweisen (Fremdschlüssel).- Datum als
TEXT– SQLite hat keinen eigenen Datumstyp. Daten in der FormJJJJ-MM-TTlassen sich trotzdem richtig sortieren und vergleichen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Datenbank erzeugen
Gibt es die Datei laden.db noch nicht, legt sqlite3 sie an. < reicht die SQL-Datei als Eingabe weiter.
sqlite3 laden.db < laden.sql
Prüfen: Es erscheint keine Meldung, und im Ordner liegt jetzt die Datei laden.db.
ls -l laden.db
Mit der Datenbank arbeiten
8. Konsole öffnen
sqlite3 laden.db
Prüfen: Die Eingabezeile lautet sqlite>.
9. Tabellen anzeigen
Befehle, die mit einem Punkt beginnen, sind Befehle der Konsole selbst und brauchen kein Semikolon.
.tables
Prüfen: Die Ausgabe nennt modell und verkauf.
10. Lieferbare Modelle abfragen
SQL-Befehle enden dagegen mit einem Semikolon.
SELECT name, preis, lager FROM modell WHERE lager > 0 ORDER BY preis;
Prüfen: Die Tabelle nennt Citybike (699.0, 4) und Lastenrad (3490.0, 1).
11. Umsatz je Modell berechnen
JOIN verbindet die Verkäufe mit den Modellen, GROUP BY fasst die Zeilen je Modell zusammen.
SELECT m.name, SUM(v.anzahl) AS stueck, SUM(v.anzahl * m.preis) AS umsatz
FROM verkauf v JOIN modell m ON m.id = v.modell_id
GROUP BY m.name ORDER BY umsatz DESC;
Prüfen: Die Ausgabe lautet:
┌─────────────┬────────┬────────┐
│ name │ stueck │ umsatz │
├─────────────┼────────┼────────┤
│ Citybike │ 6 │ 4194.0 │
│ Lastenrad │ 1 │ 3490.0 │
│ Trekkingrad │ 1 │ 899.0 │
└─────────────┴────────┴────────┘
12. Fremdschlüssel ausprobieren
Ein Verkauf zu einem Modell mit der Nummer 99, das es nicht gibt:
INSERT INTO verkauf (modell_id, anzahl, datum) VALUES (99, 1, '2026-09-10');
Prüfen: SQLite lehnt ab mit FOREIGN KEY constraint failed. Fehlt die Zeile PRAGMA foreign_keys = ON; in ~/.sqliterc, wird der falsche Verkauf ohne Meldung gespeichert.
13. Falschen Typ ausprobieren
Ein Preis aus Buchstaben statt einer Zahl:
INSERT INTO modell (name, preis) VALUES ('Rennrad', 'teuer');
Prüfen: SQLite lehnt ab mit cannot store TEXT value in REAL column modell.preis. Das bewirkt der Zusatz STRICT.
14. Konsole verlassen
.quit
Ohne Konsole abfragen
15. Einen Befehl direkt ausführen
Steht der SQL-Befehl in Anführungszeichen hinter dem Dateinamen, führt sqlite3 nur ihn aus und beendet sich. Das ist praktisch in Skripten.
sqlite3 laden.db "SELECT COUNT(*) AS verkaeufe FROM verkauf;"
Prüfen: Die Ausgabe zeigt die Zahl 5.
16. Tabelle als CSV-Datei ausgeben
-csv schreibt die Spalten durch Kommas getrennt. So lassen sich Daten zum Beispiel in LibreOffice Calc öffnen. > leitet die Ausgabe in eine Datei um.
sqlite3 -csv laden.db "SELECT * FROM modell;" > modelle.csv
Prüfen: Die erste Zeile der Datei enthält die Spaltennamen id,name,preis,lager.
head -2 modelle.csv
Sichern und wiederherstellen
17. Datenbank als Kopie sichern
.backup erstellt eine vollständige Kopie der Datenbank. Anders als ein einfaches cp ist das auch dann sicher, wenn gerade ein anderes Programm in die Datenbank schreibt.
sqlite3 laden.db ".backup sicherung.db"
Prüfen: Die Kopie enthält dieselben Tabellen.
sqlite3 sicherung.db ".tables"
18. Datenbank als SQL-Text sichern
.dump schreibt Tabellen und Inhalte als SQL-Befehle. Diese Form lässt sich mit jedem Texteditor lesen und gut mit Git verwalten.
sqlite3 laden.db ".dump" > sicherung.sql
Prüfen: Die Datei enthält acht Befehle INSERT INTO, einen für jede Zeile.
grep -c "INSERT INTO" sicherung.sql
19. Aus der SQL-Sicherung wiederherstellen
Legt aus der Textsicherung eine neue Datenbankdatei an.
sqlite3 wiederhergestellt.db < sicherung.sql
Prüfen: Die neue Datenbank enthält wieder fünf Verkäufe.
sqlite3 wiederhergestellt.db "SELECT COUNT(*) FROM verkauf;"
Wie geht es weiter?
- Aus Programmen zugreifen: Python bringt das Modul
sqlite3schon mit (import sqlite3), für PHP gibt es das Paketphp-sqlite3. Auch dort mussPRAGMA foreign_keys = ONnach jedem Öffnen gesetzt werden, denn~/.sqlitercgilt nur für die Konsole. - Grafisches Werkzeug: Das Programm „DB Browser for SQLite“ (
sudo apt install sqlitebrowser) zeigt Tabellen im Fenster und lässt sie bearbeiten. - Hilfe in der Konsole:
.helplistet alle Punkt-Befehle auf,man sqlite3zeigt die Optionen des Programms. - Dokumentation: SQL-Referenz und Hinweise zu den Eigenheiten von SQLite unter https://sqlite.org/docs.html.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/sqlite-uebung
2. Einstellungsdatei entfernen
rm -f ~/.sqliterc
3. SQLite entfernen
Entfernt nur das Kommandozeilenprogramm. Die Bibliothek libsqlite3-0 bleibt installiert, weil viele andere Programme sie brauchen.
sudo apt purge sqlite3
Prüfen: Der Befehl sqlite3 wird nicht mehr gefunden.
sqlite3 --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.sqlite.org/docs.html
- Lizenz: SQLite steht unter der Public Domain.
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.
DuckDB
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
DuckDB ist eine Datenbank für Auswertungen, die ohne Server auskommt. Sie läuft als einzelnes Programm, liest CSV-, JSON- und Parquet-Dateien direkt ein und rechnet auch über Millionen Zeilen in kurzer Zeit Summen, Mittelwerte und Kreuztabellen aus. Damit eignet sie sich gut, um Messwerte, Exporte oder Statistiken mit SQL zu untersuchen, ohne vorher eine Datenbank einzurichten.
Vorbemerkungen
- Warum nicht apt: Ubuntu 26.04 enthält kein Paket für DuckDB. Diese Anleitung nimmt deshalb die fertige Programmdatei, die das DuckDB-Projekt auf GitHub veröffentlicht, und legt sie nach
/usr/local/bin. Dort liegen selbst installierte Programme getrennt von den Paketen aus apt. Das Installationsskript von der DuckDB-Website erledigt dasselbe, ist aber nicht nötig. - Kein Dienst: DuckDB startet keinen Hintergrunddienst und öffnet keinen Port. Eine Datenbank ist eine einzelne Datei, ähnlich wie bei SQLite.
- SQLite oder DuckDB: SQLite ist für viele kleine Lese- und Schreibzugriffe gebaut, etwa als Speicher einer Anwendung. DuckDB ist für Auswertungen gebaut, bei denen wenige Abfragen große Datenmengen durchrechnen.
- Version: Getestet mit DuckDB 1.5.6. Steht auf der Release-Seite eine neuere Version, ersetzt du
v1.5.6in den Befehlen durch die neue Nummer.
Installation
1. Paketlisten aktualisieren
So kennt apt die neuesten Paketversionen.
sudo apt update
2. curl und unzip installieren
curl lädt die Datei herunter, unzip packt sie aus. Sind beide schon vorhanden, meldet apt nur, dass sie bereits in der neuesten Version installiert sind.
sudo apt install curl unzip
3. Archiv herunterladen
Lädt die Fassung für Linux auf 64-Bit-Intel/AMD-Prozessoren nach /tmp. -L sorgt dafür, dass curl der Weiterleitung von GitHub zur eigentlichen Datei folgt.
curl -L -o /tmp/duckdb.zip https://github.com/duckdb/duckdb/releases/download/v1.5.6/duckdb_cli-linux-amd64.zip
Prüfen: Die Datei ist rund 21 MB groß.
ls -lh /tmp/duckdb.zip
4. Prüfsumme kontrollieren
Mit der Prüfsumme stellst du fest, ob die Datei vollständig und unverändert angekommen ist.
sha256sum /tmp/duckdb.zip
Prüfen: Bei Version 1.5.6 lautet der Wert 6e89deac1ebbc36eed0291caf8b567b030c7b86ac35998f71854e22b3c5d5e2f. Bei einer neueren Version vergleichst du ihn mit dem Wert sha256:…, den GitHub auf der Release-Seite unter „Assets“ neben duckdb_cli-linux-amd64.zip anzeigt.
5. Programm auspacken
Das Archiv enthält nur die Programmdatei duckdb. -d gibt den Zielordner an.
sudo unzip /tmp/duckdb.zip duckdb -d /usr/local/bin
Prüfen: Die Versionsnummer v1.5.6 erscheint.
duckdb --version
6. Archiv löschen
rm /tmp/duckdb.zip
Eine CSV-Datei auswerten
Als Beispiel dienen Stromzählerstände eines Haushalts: täglicher Verbrauch in Kilowattstunden für das Haus und eine Garage mit Wallbox.
7. Übungsordner anlegen
mkdir ~/duckdb-uebung
8. In den Ordner wechseln
cd ~/duckdb-uebung
9. CSV-Datei anlegen
nano strom.csv
Füge diesen Inhalt ein (Strg+Umschalt+V):
datum,zaehler,kwh
2026-07-01,Haus,9.4
2026-07-01,Garage,2.1
2026-07-02,Haus,8.7
2026-07-02,Garage,0.0
2026-08-01,Haus,7.9
2026-08-01,Garage,3.5
2026-08-02,Haus,8.2
2026-08-02,Garage,1.2
2026-09-01,Haus,10.6
2026-09-01,Garage,2.8
2026-09-02,Haus,11.3
2026-09-02,Garage,0.4
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
10. Datei direkt abfragen
-c führt einen einzelnen SQL-Befehl aus und beendet DuckDB danach. Der Dateiname in einfachen Anführungszeichen wird wie eine Tabelle behandelt; ein Import ist nicht nötig.
duckdb -c "SELECT * FROM 'strom.csv' LIMIT 3;"
Prüfen: Es erscheinen die ersten drei Zeilen. Unter den Spaltennamen steht, welchen Typ DuckDB selbst erkannt hat: date für das Datum, varchar für Text und double für die Kommazahlen.
11. Verbrauch je Monat berechnen
strftime macht aus dem Datum einen Monat wie 2026-07. GROUP BY ALL gruppiert nach allen Spalten, die nicht zusammengerechnet werden, ORDER BY ALL sortiert nach allen Spalten. round(…, 1) rundet auf eine Nachkommastelle, denn Kommazahlen vom Typ double hinterlassen beim Addieren sonst Reste wie 3.1999999999999997.
duckdb -c "SELECT strftime(datum, '%Y-%m') AS monat, zaehler, round(sum(kwh), 1) AS kwh FROM 'strom.csv' GROUP BY ALL ORDER BY ALL;"
Prüfen: Die Ausgabe enthält sechs Zeilen, beginnend mit 2026-07 │ Garage │ 2.1 und 2026-07 │ Haus │ 18.1.
Eine Datenbankdatei verwenden
Für wiederholte Auswertungen lohnt es sich, die Daten in eine Datenbankdatei zu übernehmen. DuckDB legt sie beim ersten Aufruf selbst an.
12. Tabelle aus der CSV-Datei erzeugen
haushalt.duckdb ist der Name der Datenbankdatei. CREATE TABLE … AS SELECT legt eine Tabelle an und füllt sie mit dem Ergebnis der Abfrage.
duckdb haushalt.duckdb -c "CREATE TABLE strom AS SELECT * FROM 'strom.csv';"
Prüfen: Im Ordner liegt jetzt die Datei haushalt.duckdb.
ls -l
13. Konsole öffnen
Ohne -c startet DuckDB eine Konsole. Die Eingabezeile beginnt mit D.
duckdb haushalt.duckdb
14. Tabellen anzeigen
Befehle mit einem Punkt am Anfang steuern die Konsole selbst und brauchen kein Semikolon.
.tables
Prüfen: Ein Kasten zeigt die Tabelle strom mit den Spalten datum, zaehler, kwh und 12 rows.
15. Kreuztabelle erstellen
PIVOT macht aus den Werten der Spalte zaehler eigene Spalten. So stehen Haus und Garage nebeneinander.
PIVOT (SELECT strftime(datum, '%Y-%m') AS monat, zaehler, kwh FROM strom)
ON zaehler USING round(sum(kwh), 1) ORDER BY monat;
Prüfen: Die Ausgabe lautet:
┌─────────┬────────┬────────┐
│ monat │ Garage │ Haus │
│ varchar │ double │ double │
├─────────┼────────┼────────┤
│ 2026-07 │ 2.1 │ 18.1 │
│ 2026-08 │ 4.7 │ 16.1 │
│ 2026-09 │ 3.2 │ 21.9 │
└─────────┴────────┴────────┘
16. Ergebnis als Parquet-Datei speichern
Parquet ist ein kompaktes Dateiformat für Tabellen, das viele Analysewerkzeuge lesen können, etwa Python mit pandas oder Polars. COPY … TO schreibt das Ergebnis einer Abfrage in eine Datei.
COPY (SELECT * FROM strom WHERE zaehler = 'Haus') TO 'haus.parquet' (FORMAT parquet);
17. Konsole verlassen
.quit
18. Parquet-Datei abfragen
Auch Parquet-Dateien lassen sich direkt mit SQL lesen.
duckdb -c "SELECT round(avg(kwh), 2) AS schnitt, max(kwh) AS hoechster FROM 'haus.parquet';"
Prüfen: Die Ausgabe nennt 9.35 als Durchschnitt und 11.3 als höchsten Tagesverbrauch des Hauses.
Aktualisieren
1. Neue Version herunterladen
Ersetze v1.5.6 durch die Nummer der neuen Version.
curl -L -o /tmp/duckdb.zip https://github.com/duckdb/duckdb/releases/download/v1.5.6/duckdb_cli-linux-amd64.zip
2. Prüfsumme kontrollieren
Vergleiche den Wert mit der Angabe auf der Release-Seite.
sha256sum /tmp/duckdb.zip
3. Programm ersetzen
-o überschreibt die vorhandene Datei ohne Rückfrage.
sudo unzip -o /tmp/duckdb.zip duckdb -d /usr/local/bin
Prüfen: duckdb --version zeigt die neue Nummer. Datenbankdateien älterer Versionen kann eine neuere Version in der Regel öffnen. Umgekehrt klappt das nicht immer. Sichere wichtige Datenbanken deshalb vorher, zum Beispiel mit EXPORT DATABASE 'sicherung'; in der Konsole.
4. Archiv löschen
rm /tmp/duckdb.zip
Wie geht es weiter?
- Python: In einer virtuellen Umgebung installiert
pip install duckdbdie Bibliothek. Damit lassen sich SQL-Abfragen und pandas-Tabellen mischen. - Erweiterungen: Für weitere Formate und Quellen, etwa Excel-Dateien, Dateien aus dem Internet oder eine PostgreSQL-Datenbank, lädt DuckDB beim ersten Gebrauch Erweiterungen aus dem Internet nach. Sie landen im Ordner
~/.duckdb. - Dokumentation: Handbuch und SQL-Referenz unter https://duckdb.org/docs/.
Deinstallieren
1. Programm löschen
DuckDB besteht nur aus dieser einen Datei.
sudo rm /usr/local/bin/duckdb
Prüfen: Der Befehl wird nicht mehr gefunden.
duckdb --version
2. Übungsordner löschen
rm -rf ~/duckdb-uebung
3. Erweiterungen und Verlauf löschen (optional)
~/.duckdb enthält nachgeladene Erweiterungen, ~/.duckdb_history die in der Konsole eingegebenen Befehle. Beide gibt es nur, wenn sie entstanden sind; sonst meldet rm nichts.
rm -rf ~/.duckdb ~/.duckdb_history
Quellen und Lizenz
- Offizielle Dokumentation: https://duckdb.org/docs/
- Lizenz: DuckDB steht unter der MIT.
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.
ClickHouse
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ClickHouse ist eine Datenbank für Auswertungen über sehr große Datenmengen. Sie speichert die Werte einer Tabelle spaltenweise und stark gepackt. Deshalb muss sie bei einer Abfrage nur die benötigten Spalten lesen und kann Summen, Mittelwerte oder Zählungen über viele Millionen Zeilen in Sekundenbruchteilen berechnen. Typische Einsätze sind Messwerte, Protokolldaten von Servern und Besucherstatistiken von Websites. Diese Anleitung installiert ClickHouse als Dienst, erzeugt fünf Jahre Wetterdaten mit über zehn Millionen Zeilen und wertet sie mit SQL aus.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für ClickHouse. Der Hersteller betreibt aber ein eigenes apt-Archiv. Nach dem Einbinden installiert und aktualisiert
aptClickHouse wie jedes andere Paket. - LTS oder stable: Das Archiv hat zwei Bereiche.
stablebekommt jeden Monat eine neue Version,ltsnur zweimal im Jahr eine, die dann ein Jahr lang Fehlerbehebungen erhält. Diese Anleitung nimmtlts, weil eine Datenbank selten jede Neuerung sofort braucht. - DuckDB oder ClickHouse: DuckDB läuft ohne Server direkt in einem Programm und ist ideal für Auswertungen am eigenen Rechner. ClickHouse läuft als Dienst, nimmt laufend neue Daten an und bedient viele Benutzer und Programme gleichzeitig.
- Nur lokal erreichbar: ClickHouse lauscht nach der Installation nur auf
127.0.0.1und::1. Die wichtigsten Ports sind 8123 (HTTP) und 9000 (eigenes Protokoll fürclickhouse-client). - Arbeitsspeicher: Der laufende Dienst belegt schon ohne Daten rund 800 MB.
- Version: Getestet mit ClickHouse 26.8.15 (LTS) am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.
sudo apt install wget ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von ClickHouse stammen und unterwegs nicht verändert wurden. Der Hersteller legt denselben Schlüssel für alle Paketarten im Ordner rpm ab, er gilt aber auch für die Pakete für Ubuntu. Mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/clickhouse.asc https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/clickhouse.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/clickhouse.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://packages.clickhouse.com/deb
Suites: lts
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/clickhouse.asc
Suites: lts– der Bereich mit den lange gepflegten Versionen. Wer immer die neueste Version möchte, schreibtstable.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 angenommen.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von ClickHouse herunter.
sudo apt update
Prüfen: Der Installationskandidat ist eine Version wie 26.8.15.10.
apt policy clickhouse-server
Installation
6. ClickHouse installieren
Installiert den Server, das Kommandozeilenprogramm clickhouse-client und das gemeinsame Programm clickhouse-common-static, in dem alle Teile stecken. Der Download ist rund 250 MB groß.
sudo apt install clickhouse-server clickhouse-client
Gegen Ende der Installation erscheint im Terminal die Frage Set up the password for the default user:. Gib ein eigenes, langes Passwort ein und drücke Enter. Die Eingabe ist nicht zu sehen und wird nicht wiederholt, tippe also sorgfältig.
Prüfen: Danach erscheint Password for the default user is saved in file /etc/clickhouse-server/users.d/default-password.xml. In dieser Datei steht nur eine Prüfsumme des Passworts, nicht das Passwort selbst.
7. Version prüfen
clickhouse-client --version
Prüfen: Es erscheint z. B. ClickHouse client version 26.8.15.10 (official build).
Vor dem ersten Start einrichten
Das Paket meldet den Dienst für den Systemstart an, startet ihn aber noch nicht.
8. Absturzberichte abschalten
ClickHouse schickt in der Grundeinstellung nach einem Absturz einen anonymisierten Bericht an die Entwickler. Wer das nicht möchte, legt eine Ergänzungsdatei an. Dateien im Ordner config.d ergänzen die große Hauptdatei config.xml, die bei Updates ersetzt werden kann.
sudo nano /etc/clickhouse-server/config.d/keine-absturzberichte.xml
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<clickhouse>
<send_crash_reports>
<enabled>false</enabled>
</send_crash_reports>
</clickhouse>
9. Dienst starten
sudo systemctl start clickhouse-server
10. Prüfen, ob der Dienst läuft
systemctl status clickhouse-server
Prüfen: In der Ausgabe steht active (running) und weiter unten Merging configuration file '/etc/clickhouse-server/config.d/keine-absturzberichte.xml'. Die Ergänzung aus Schritt 8 wurde also gelesen. Beende die Anzeige mit q.
11. Prüfen, dass ClickHouse nur lokal lauscht
sudo ss -ltnp | grep clickhouse
Prüfen: Alle Zeilen enthalten 127.0.0.1 oder [::1]. Neben 8123 und 9000 erscheinen die Ports 9004 und 9005: Über sie verstehen auch Programme für MySQL und PostgreSQL ClickHouse. Port 9009 dient dem Austausch zwischen mehreren ClickHouse-Servern.
12. Lebenszeichen abfragen
Die Adresse /ping antwortet auch ohne Anmeldung.
curl http://127.0.0.1:8123/ping
Prüfen: Die Antwort lautet Ok.
Anmeldedaten hinterlegen
clickhouse-client fragt sonst bei jedem Aufruf nach dem Passwort. Er liest aber eine Einstellungsdatei im eigenen Home-Ordner, in der das Passwort stehen kann.
13. Ordner anlegen
mkdir -p ~/.clickhouse-client
14. Einstellungsdatei anlegen
nano ~/.clickhouse-client/config.xml
Füge diesen Inhalt ein (Strg+Umschalt+V) und ersetze DEIN-PASSWORT durch das Passwort aus Schritt 6. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
<config>
<user>default</user>
<password>DEIN-PASSWORT</password>
</config>
15. Datei schützen
Nur du darfst die Datei lesen und ändern.
chmod 600 ~/.clickhouse-client/config.xml
16. Anmeldung testen
-q übergibt eine einzelne Abfrage und beendet den Client danach wieder.
clickhouse-client -q "SELECT version()"
Prüfen: Es erscheint die Versionsnummer, z. B. 26.8.15.10. Erscheint Authentication failed, stimmt das Passwort in der Datei nicht.
Wetterdaten erzeugen
Statt Daten herunterzuladen, lässt das Beispiel ClickHouse selbst Messwerte erfinden: für vier Orte jede Minute einen Wert für Temperatur und Regen, fünf Jahre lang. Das ergibt gut 10,5 Millionen Zeilen.
17. Übungsordner anlegen
mkdir -p ~/clickhouse-uebung
18. In den Ordner wechseln
cd ~/clickhouse-uebung
19. SQL-Datei anlegen
nano wetter.sql
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
CREATE DATABASE IF NOT EXISTS uebung;
CREATE TABLE IF NOT EXISTS uebung.wetter
(
zeit DateTime,
station LowCardinality(String),
temperatur Float32,
regen Float32
)
ENGINE = MergeTree
ORDER BY (station, zeit);
INSERT INTO uebung.wetter
SELECT
toDateTime('2021-01-01 00:00:00') + intDiv(number, 4) * 60 AS zeit,
['Ahrensburg', 'Bargteheide', 'Hamburg', 'Lübeck'][number % 4 + 1] AS station,
round(10 - 9 * cos(2 * pi() * toDayOfYear(zeit) / 365)
- 4 * cos(2 * pi() * (toHour(zeit) - 3) / 24)
+ randNormal(0, 1), 1) AS temperatur,
if(rand() % 100 = 0, round(randExponential(7), 1), 0) AS regen
FROM numbers(4 * 60 * 24 * 1826);
Was die Teile bewirken:
LowCardinality(String)– für Spalten mit wenigen verschiedenen Texten. ClickHouse speichert jeden Ortsnamen nur einmal und in der Tabelle nur eine kleine Nummer.ENGINE = MergeTree– die übliche Speicherart von ClickHouse für große Tabellen.ORDER BY (station, zeit)– die Zeilen liegen nach Ort und Zeit sortiert auf der Festplatte. Abfragen, die nach Ort oder Zeitraum filtern, müssen dadurch nur einen kleinen Teil lesen.numbers(…)– liefert die Zahlen 0, 1, 2 … bis zur angegebenen Anzahl. Daraus werden Zeit und Ort berechnet: 4 Orte × 60 Minuten × 24 Stunden × 1826 Tage.temperatur– im Jahresverlauf zwischen etwa 1 °C im Januar und 19 °C im Juli, nachts kühler als nachmittags, dazu etwas Zufall.regen– in etwa jeder hundertsten Minute fällt eine zufällige Regenmenge, im Jahr kommen so gut 700 mm zusammen.
20. SQL-Datei ausführen
--multiquery erlaubt mehrere Befehle hintereinander. < gibt den Inhalt der Datei an den Client weiter.
clickhouse-client --multiquery < wetter.sql
Das dauert nur ein bis zwei Sekunden.
21. Zeilen zählen
clickhouse-client -q "SELECT count() FROM uebung.wetter"
Prüfen: Die Antwort lautet 10517760.
22. Platzbedarf ansehen
Die Tabelle system.parts beschreibt, wie ClickHouse die Daten auf der Festplatte abgelegt hat.
clickhouse-client -q "SELECT formatReadableSize(sum(data_compressed_bytes)) AS gepackt, formatReadableSize(sum(data_uncompressed_bytes)) AS entpackt FROM system.parts WHERE database = 'uebung' AND active"
Prüfen: Es erscheinen zwei Größen, etwa 68 MiB gepackt und 91 MiB entpackt. Die Zufallswerte lassen sich schlecht packen. Echte Messwerte, die sich von Minute zu Minute wenig ändern, schrumpfen meist auf einen Bruchteil.
Auswerten
Ab hier weichen die Zahlen bei dir leicht ab, weil die Messwerte zufällig erzeugt wurden.
23. Kommandozeile öffnen
Ohne -q öffnet clickhouse-client eine Eingabezeile. Ergebnisse erscheinen dort als Tabelle, darunter steht, wie lange die Abfrage gedauert hat.
clickhouse-client
Prüfen: Es erscheint Connected to ClickHouse server version 26.8.15. und darunter die Eingabezeile mit dem Rechnernamen und :). Eine Warnung zu Delay accounting kannst du übergehen. Sie betrifft nur eine Messgröße für Wartezeiten der Festplatte.
Die Abfragen der nächsten Schritte fügst du jeweils komplett ein (Strg+Umschalt+V) und drückst dann Enter.
24. Kennzahlen je Ort berechnen
ClickHouse rechnet hier über alle 10,5 Millionen Zeilen.
SELECT station,
round(avg(temperatur), 1) AS mittel,
min(temperatur) AS tiefster,
max(temperatur) AS hoechster,
round(sum(regen) / 5) AS regen_pro_jahr
FROM uebung.wetter
GROUP BY station
ORDER BY station;
Prüfen: Es erscheinen vier Zeilen mit einem Mittel von etwa 10 °C und rund 730 mm Regen pro Jahr. Unter der Tabelle steht Elapsed: mit einer Zeit von meist unter 0,1 Sekunden.
25. Monatsmittel für einen Ort berechnen
toMonth macht aus jedem Zeitpunkt die Nummer des Monats.
SELECT toMonth(zeit) AS monat,
round(avg(temperatur), 1) AS mittel
FROM uebung.wetter
WHERE station = 'Ahrensburg'
GROUP BY monat
ORDER BY monat;
Prüfen: Das Mittel steigt von etwa 1,4 °C im Januar auf etwa 18,6 °C im Juni und Juli und fällt danach wieder. Unter der Tabelle steht Processed 2.63 million rows: ClickHouse hat nur ein Viertel der Tabelle gelesen. Weil die Zeilen nach Ort sortiert gespeichert sind (ORDER BY in Schritt 19), findet es die Werte für Ahrensburg, ohne die anderen Orte durchzusehen.
26. Sommertage im Jahr 2025 zählen
Ein Sommertag ist ein Tag mit mindestens 25 °C. Die innere Abfrage ermittelt den Höchstwert jedes Tages, die äußere zählt mit countIf nur die Tage, die die Bedingung erfüllen.
SELECT station,
countIf(hoechst >= 25) AS sommertage
FROM
(
SELECT station, toDate(zeit) AS tag, max(temperatur) AS hoechst
FROM uebung.wetter
WHERE toYear(zeit) = 2025
GROUP BY station, tag
)
GROUP BY station
ORDER BY station;
Prüfen: Je Ort erscheinen etwa 40 bis 55 Sommertage.
27. Kommandozeile verlassen
exit
Daten aus einer CSV-Datei laden
28. CSV-Datei anlegen
nano stationen.csv
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
station,kreis,hoehe
Ahrensburg,Stormarn,25
Bargteheide,Stormarn,41
Hamburg,Hamburg,6
Lübeck,Lübeck,13
29. Tabelle für die Stationen anlegen
UInt16 ist eine ganze Zahl ohne Vorzeichen bis 65535, das reicht für die Höhe in Metern.
clickhouse-client -q "CREATE TABLE uebung.stationen (station String, kreis String, hoehe UInt16) ENGINE = MergeTree ORDER BY station"
30. CSV-Datei laden
FORMAT CSVWithNames sagt ClickHouse, dass die Daten als CSV mit einer Kopfzeile kommen.
clickhouse-client -q "INSERT INTO uebung.stationen FORMAT CSVWithNames" < stationen.csv
31. Beide Tabellen verbinden
JOIN verknüpft jede Messung über den Ortsnamen mit den Angaben zur Station.
clickhouse-client -q "SELECT s.kreis, w.station, s.hoehe, round(sum(w.regen) / 5) AS regen_pro_jahr FROM uebung.wetter AS w JOIN uebung.stationen AS s ON w.station = s.station GROUP BY s.kreis, w.station, s.hoehe ORDER BY s.kreis, w.station" --format PrettyCompact
Prüfen: Es erscheinen vier Zeilen. Ahrensburg und Bargteheide stehen beide beim Kreis Stormarn. --format PrettyCompact zeichnet die Tabelle mit Rahmen, ohne die Angabe gibt -q die Werte nur durch Tabulatoren getrennt aus.
Weboberfläche
32. SQL-Seite im Browser öffnen
ClickHouse bringt eine einfache Seite mit, auf der man Abfragen eingeben und als Tabelle ansehen kann. Öffne im Browser:
http://127.0.0.1:8123/play
Trage oben rechts als Benutzer default und das Passwort aus Schritt 6 ein. Gib dann z. B. SELECT * FROM uebung.stationen ein und klicke auf Run.
Prüfen: Unter dem Eingabefeld erscheinen die vier Stationen.
Sichern und wiederherstellen
Eine einfache Sicherung ist der Export einer Tabelle in eine Datei im Format Parquet. Das Format ist verbreitet und gepackt, DuckDB, Python mit pandas und viele andere Programme können es direkt lesen.
33. Tabelle exportieren
clickhouse-client -q "SELECT * FROM uebung.wetter FORMAT Parquet" > wetter.parquet
Prüfen: Die Datei ist rund 54 MB groß.
ls -lh wetter.parquet
34. Tabelle leeren
Nur zum Ausprobieren der Wiederherstellung: TRUNCATE löscht alle Zeilen, die Tabelle selbst bleibt bestehen.
clickhouse-client -q "TRUNCATE TABLE uebung.wetter"
35. Sicherung zurückspielen
clickhouse-client -q "INSERT INTO uebung.wetter FORMAT Parquet" < wetter.parquet
Prüfen: Der Befehl aus Schritt 21 meldet wieder 10517760.
Die Tabellenbeschreibung ist in der Parquet-Datei nicht vollständig enthalten. Für eine neue Datenbank legst du die Tabelle deshalb zuerst wie in Schritt 19 an und spielst dann die Daten ein.
Optional: Autostart ausschalten
Wer ClickHouse nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start clickhouse-server.
sudo systemctl disable --now clickhouse-server
Wie geht es weiter?
- Eigene Benutzer: Für Programme legt man mit
CREATE USEReigene Benutzer an und gibt ihnen mitGRANTnur die nötigen Rechte, statt überalldefaultzu verwenden. - Ohne Server:
clickhouse-local(im Paket enthalten) wertet CSV-, JSON- oder Parquet-Dateien mit derselben SQL-Sprache aus, ohne dass der Dienst laufen muss. - Aus Programmen zugreifen: Es gibt offizielle Bibliotheken für Python (
clickhouse-connect), Go, Java und JavaScript. Alle nutzen Port 8123 oder 9000. - Zugriff aus dem Netz: Dafür wird in einer Datei in
config.ddie Einstellunglisten_hostgeändert. Die Ports sollten dann per Firewall nur für bekannte Rechner offen sein. - Dokumentation: Die SQL-Befehle und Funktionen sind unter https://clickhouse.com/docs/sql-reference beschrieben.
Deinstallieren
1. Übungsordner und Einstellungsdatei löschen
rm -rf ~/clickhouse-uebung ~/.clickhouse-client
2. Dienst anhalten
sudo systemctl stop clickhouse-server
3. ClickHouse entfernen
sudo apt purge clickhouse-server clickhouse-client clickhouse-common-static
4. Übrige Dateien löschen
Die Pakete von ClickHouse räumen beim Entfernen nicht vollständig auf. apt meldet deshalb, dass /etc/clickhouse-server nicht leer ist. Dieser Befehl löscht die Konfiguration, die Datenbanken, die Protokolle, die Einstellung für die Zahl offener Dateien und zwei Verknüpfungen in /usr/bin, die bei der Installation angelegt wurden. Achtung: Alle Daten in ClickHouse sind danach unwiderruflich weg.
sudo rm -rf /etc/clickhouse-server /etc/clickhouse-keeper /var/lib/clickhouse /var/log/clickhouse-server /var/log/clickhouse-keeper /etc/security/limits.d/clickhouse.conf /usr/bin/clickhouse-disks /usr/bin/clickhouse-git-import
5. Systembenutzer entfernen
Die Installation hat für den Dienst den Benutzer clickhouse und eine gleichnamige Gruppe angelegt. Die Gruppe wird mit dem Benutzer entfernt.
sudo deluser clickhouse
6. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/clickhouse.sources /etc/apt/keyrings/clickhouse.asc
7. Paketlisten aktualisieren
Danach kennt apt die Pakete von ClickHouse nicht mehr.
sudo apt update
Prüfen: Der Befehl clickhouse-client wird nicht mehr gefunden.
clickhouse-client --version
Quellen und Lizenz
- Offizielle Dokumentation: https://clickhouse.com/docs/
- Lizenz: ClickHouse steht unter der Apache-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.
InfluxDB
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
InfluxDB ist eine Zeitreihen-Datenbank: Sie ist darauf ausgelegt, sehr viele Messwerte mit Zeitstempel schnell zu speichern und nach Zeiträumen auszuwerten. Typische Daten sind Werte von Temperatur- und Feuchtesensoren, Stromzählern, Wetterstationen oder die Auslastung von Servern. Messwerte werden in einem einfachen Textformat geschrieben, abgefragt wird mit SQL. Diese Anleitung installiert InfluxDB 3 Core, die freie Ausgabe der aktuellen Version 3, und speichert als Beispiel das Raumklima mehrerer Zimmer.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält nur das Paket
influxdbin der veralteten Version 1.6. Diese Anleitung nimmt stattdessen das apt-Archiv des Herstellers InfluxData. Nach dem Einbinden installiert und aktualisiertaptInfluxDB wie jedes andere Paket. - Version 3 statt 2: Im selben Archiv gibt es auch noch
influxdb2. Version 3 ist eine Neuentwicklung mit SQL als Abfragesprache und dem Speicherformat Parquet. Für neue Projekte empfiehlt der Hersteller Version 3. - Nur lokal erreichbar: Ohne Anpassung lauscht InfluxDB 3 auf allen Netzwerkschnittstellen (
0.0.0.0:8181). Schritt 11 beschränkt das vor dem ersten Start auf127.0.0.1. - Telemetrie: In der Grundeinstellung schickt InfluxDB regelmäßig Nutzungsdaten an den Hersteller. Schritt 11 schaltet das ebenfalls ab.
- Zugriff mit Token: Statt Benutzer und Passwort verwendet InfluxDB 3 lange Zufallsschlüssel (Token). Ohne Token ist kein Zugriff möglich.
- Version: Getestet mit InfluxDB 3 Core 3.12.0 am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv, gpg kann den Fingerabdruck des Schlüssels anzeigen. Meist sind alle drei schon vorhanden.
sudo apt install wget ca-certificates gpg
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von InfluxData stammen und unterwegs nicht verändert wurden. Mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/influxdata.asc https://repos.influxdata.com/influxdata-archive.key
4. Fingerabdruck des Schlüssels prüfen
Der Fingerabdruck ist eine Prüfsumme des Schlüssels. Stimmt er mit dem Wert überein, den InfluxData in seiner Installationsanleitung nennt, ist es der richtige Schlüssel.
gpg --show-keys /etc/apt/keyrings/influxdata.asc
Prüfen: Unter pub steht 24C975CBA61A024EE1B631787C3D57159FC2F927 und darunter InfluxData Package Signing Key. Steht dort etwas anderes, lösche die Datei mit sudo rm /etc/apt/keyrings/influxdata.asc und brich hier ab.
5. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/influxdata.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://repos.influxdata.com/debian
Suites: stable
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/influxdata.asc
Das Archiv heißt zwar debian, die Pakete laufen aber genauso unter Ubuntu. Suites: stable ist für alle Systeme gleich.
6. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von InfluxData herunter.
sudo apt update
Prüfen: Der Installationskandidat ist eine Version wie 3.12.0-1.
apt policy influxdb3-core
Installation
7. InfluxDB installieren
Installiert den Server und das Kommandozeilenprogramm influxdb3. Als Empfehlung kommt das Paket influxdata-archive-keyring mit, das den Signaturschlüssel ein zweites Mal ablegt und künftig aktualisiert. Das Paket meldet den Dienst für den Systemstart an, startet ihn aber noch nicht.
sudo apt install influxdb3-core
8. Version prüfen
influxdb3 --version
Prüfen: Es erscheint z. B. influxdb3 InfluxDB 3 Core, 3.12.0, revision ….
Vor dem ersten Start einrichten
9. Konfigurationsdatei öffnen
Die Einstellungen stehen in einer Datei im Format TOML. Fast alle Zeilen darin sind Kommentare mit #, die die möglichen Einstellungen beschreiben.
sudo nano /etc/influxdb3/influxdb3-core.conf
10. An das Ende der Datei springen
Drücke Strg+Ende und dann Enter für eine neue Zeile.
11. Adresse festlegen und Telemetrie abschalten
Füge diese zwei Zeilen ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
http-bind="127.0.0.1:8181"
disable-telemetry-upload=true
http-bind– InfluxDB nimmt Verbindungen nur noch von diesem Rechner an.disable-telemetry-upload– InfluxDB sendet keine Nutzungsdaten mehr an den Hersteller.
12. Dienst starten
sudo systemctl start influxdb3-core
13. Prüfen, ob der Dienst läuft
systemctl status influxdb3-core
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
14. Prüfen, dass InfluxDB nur lokal lauscht
sudo ss -ltnp | grep influxdb3
Prüfen: Es erscheint genau eine Zeile mit 127.0.0.1:8181.
15. Prüfen, dass beide Einstellungen wirken
Ein Hilfsprogramm des Pakets wandelt die Konfigurationsdatei beim Start in Umgebungsvariablen um. Dieser Befehl zeigt die Variablen des laufenden Servers.
sudo cat /proc/$(pgrep -x influxdb3)/environ | tr '\0' '\n' | grep -E 'BIND|TELEMETRY'
Prüfen: Es erscheinen INFLUXDB3_HTTP_BIND_ADDR=127.0.0.1:8181 und INFLUXDB3_DISABLE_TELEMETRY_UPLOAD=true.
Zugangsschlüssel einrichten
16. Admin-Token erzeugen
Das erste Token hat alle Rechte. InfluxDB zeigt es nur ein einziges Mal an.
influxdb3 create token --admin
Prüfen: Es erscheint New token created successfully! und hinter Token: eine lange Zeichenfolge, die mit apiv3_ beginnt. Lass das Terminal offen, du kopierst das Token im nächsten Schritt.
17. Token in einer Datei speichern
nano ~/.influxdb3-token
Markiere das Token im Terminal mit der Maus (von apiv3_ bis zum Zeilenende), kopiere es mit Strg+Umschalt+C und füge es in nano mit Strg+Umschalt+V ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Datei schützen
Nur du darfst die Datei lesen und ändern.
chmod 600 ~/.influxdb3-token
19. Token für jedes Terminal bereitstellen
influxdb3 liest das Token aus der Umgebungsvariablen INFLUXDB3_AUTH_TOKEN. Die Datei ~/.bashrc wird bei jedem neuen Terminal ausgeführt.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge diese Zeile ein (Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X.
export INFLUXDB3_AUTH_TOKEN="$(cat ~/.influxdb3-token)"
Das Token selbst steht so nur in der geschützten Datei aus Schritt 17, nicht in ~/.bashrc.
20. Einstellung im aktuellen Terminal laden
source ~/.bashrc
21. Anmeldung testen
influxdb3 show databases
Prüfen: Es erscheint eine Tabelle mit der Datenbank _internal, die InfluxDB für sich selbst anlegt. Erscheint stattdessen ein Fehler mit 401 oder Unauthorized, stimmt das Token in der Datei nicht.
Messwerte speichern
Das Beispiel speichert stündliche Werte für Temperatur und Luftfeuchte aus zwei Räumen.
22. Datenbank anlegen
influxdb3 create database haus
Prüfen: Es erscheint Database "haus" created successfully.
23. Übungsordner anlegen
mkdir -p ~/influxdb-uebung
24. In den Ordner wechseln
cd ~/influxdb-uebung
25. Datei mit Messwerten anlegen
nano messwerte.lp
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
raumklima,raum=wohnzimmer temperatur=20.5,feuchte=48 1790834400
raumklima,raum=keller temperatur=14.2,feuchte=67 1790834400
raumklima,raum=wohnzimmer temperatur=20.8,feuchte=47 1790838000
raumklima,raum=keller temperatur=14.3,feuchte=66 1790838000
raumklima,raum=wohnzimmer temperatur=21.1,feuchte=46 1790841600
raumklima,raum=keller temperatur=14.4,feuchte=67 1790841600
raumklima,raum=wohnzimmer temperatur=21.4,feuchte=45 1790845200
raumklima,raum=keller temperatur=14.5,feuchte=66 1790845200
raumklima,raum=wohnzimmer temperatur=21.7,feuchte=44 1790848800
raumklima,raum=keller temperatur=14.6,feuchte=67 1790848800
raumklima,raum=wohnzimmer temperatur=22.0,feuchte=43 1790852400
raumklima,raum=keller temperatur=14.7,feuchte=66 1790852400
Jede Zeile ist ein Messpunkt im Line Protocol, dem Schreibformat von InfluxDB. Die Teile sind durch Leerzeichen getrennt:
raumklima,raum=wohnzimmer– der Name der Tabelle, danach durch Komma getrennt Merkmale (Tags), nach denen man später filtert und gruppiert.temperatur=20.5,feuchte=48– die eigentlichen Messwerte (Fields).1790834400– der Zeitpunkt in Sekunden seit dem 1. Januar 1970. Die Zahlen hier stehen für den 1. Oktober 2026 von 6 bis 11 Uhr Weltzeit (UTC), also 8 bis 13 Uhr deutscher Sommerzeit.
Eine Tabelle muss vorher nicht angelegt werden. InfluxDB legt sie beim ersten Schreiben an und ergänzt neue Spalten selbst.
26. Messwerte schreiben
--precision s sagt InfluxDB, dass die Zeitpunkte in Sekunden angegeben sind. Ohne die Angabe erwartet InfluxDB Nanosekunden.
influxdb3 write --database haus --precision s --file messwerte.lp
Prüfen: Die Ausgabe meldet 12 lines.
27. Einen einzelnen Wert ohne Zeitpunkt schreiben
Fehlt der Zeitpunkt, nimmt InfluxDB die aktuelle Uhrzeit. So schicken auch Sensoren ihre Werte.
influxdb3 write --database haus 'raumklima,raum=kueche temperatur=22.4,feuchte=55'
Abfragen
Die Zeitpunkte in den Ergebnissen sind immer in Weltzeit (UTC) angegeben.
28. Die ersten Zeilen ansehen
influxdb3 query --database haus "SELECT * FROM raumklima ORDER BY time LIMIT 4"
Prüfen: Es erscheint eine Tabelle mit den Spalten feuchte, raum, temperatur und time, beginnend mit 2026-10-01T06:00:00.
29. Mittelwerte je Raum berechnen
influxdb3 query --database haus "SELECT raum, round(avg(temperatur), 1) AS mittel, max(feuchte) AS max_feuchte FROM raumklima GROUP BY raum ORDER BY raum"
Prüfen: Es erscheinen drei Räume, darunter keller mit 14.5 und wohnzimmer mit 21.3.
30. Werte in Zeitabschnitten zusammenfassen
date_bin ordnet jeden Zeitpunkt einem Abschnitt fester Länge zu, hier zwei Stunden. Das ist die typische Abfrage für Diagramme über einen längeren Zeitraum.
influxdb3 query --database haus "SELECT date_bin(INTERVAL '2 hours', time) AS zeitraum, raum, round(avg(temperatur), 1) AS mittel FROM raumklima WHERE raum IN ('keller', 'wohnzimmer') GROUP BY zeitraum, raum ORDER BY zeitraum, raum"
Prüfen: Es erscheinen sechs Zeilen für die Abschnitte ab 6, 8 und 10 Uhr, je eine für Keller und Wohnzimmer.
31. Ergebnis als CSV ausgeben
--format csv gibt die Werte durch Kommas getrennt aus, z. B. für eine Tabellenkalkulation. Mit > datei.csv dahinter landet die Ausgabe in einer Datei.
influxdb3 query --database haus --format csv "SELECT raum, round(avg(temperatur), 1) AS mittel FROM raumklima GROUP BY raum ORDER BY raum"
Über HTTP schreiben und lesen
Sensoren, Skripte und Programme sprechen InfluxDB meist direkt über HTTP an. Das Token wird dabei im Kopf der Anfrage mitgeschickt.
32. Ohne Token anfragen
curl -i http://127.0.0.1:8181/health
Prüfen: Die erste Zeile lautet HTTP/1.1 401 Unauthorized.
33. Einen Messwert per HTTP schreiben
--data-binary schickt die Zeile im Line Protocol unverändert mit. -w '%{http_code}\n' zeigt den Antwortcode an.
curl -w '%{http_code}\n' -H "Authorization: Bearer $INFLUXDB3_AUTH_TOKEN" --data-binary 'raumklima,raum=bad temperatur=23.1,feuchte=71' "http://127.0.0.1:8181/api/v3/write_lp?db=haus"
Prüfen: Die Antwort ist 204. Das bedeutet: angenommen, es gibt nichts zurückzumelden.
34. Per HTTP abfragen
-G hängt die Angaben an die Adresse an, --data-urlencode wandelt Leerzeichen und Sonderzeichen passend um. format=jsonl liefert jede Zeile als eigenes JSON-Objekt.
curl -G -H "Authorization: Bearer $INFLUXDB3_AUTH_TOKEN" http://127.0.0.1:8181/api/v3/query_sql --data-urlencode db=haus --data-urlencode "q=SELECT raum, temperatur FROM raumklima WHERE raum IN ('bad', 'kueche')" --data-urlencode format=jsonl
Prüfen: Es erscheinen {"raum":"bad","temperatur":23.1} und {"raum":"kueche","temperatur":22.4}.
Sichern und wiederherstellen
InfluxDB 3 Core legt alle Daten als Dateien unter /var/lib/influxdb3/data ab. Bei angehaltenem Dienst lässt sich der Ordner als Archiv sichern.
35. Dienst anhalten
sudo systemctl stop influxdb3-core
36. Sicherung anlegen
-C /var/lib/influxdb3 wechselt vorher in den Elternordner, damit im Archiv nur data/… steht.
sudo tar -czf /var/backups/influxdb3.tar.gz -C /var/lib/influxdb3 data
Prüfen: Die Datei ist vorhanden.
ls -l /var/backups/influxdb3.tar.gz
37. Dienst wieder starten
sudo systemctl start influxdb3-core
Zum Wiederherstellen hältst du den Dienst an, löschst den Ordner mit sudo rm -r /var/lib/influxdb3/data, packst das Archiv mit sudo tar -xzf /var/backups/influxdb3.tar.gz -C /var/lib/influxdb3 wieder aus und startest den Dienst. Die Sicherung enthält auch die Token. Nach dem Zurückspielen gilt also wieder das Token, das zum Zeitpunkt der Sicherung gültig war. Achtung: Alles, was nach der Sicherung geschrieben wurde, ist danach weg.
Optional: Autostart ausschalten
Wer InfluxDB nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start influxdb3-core.
sudo systemctl disable --now influxdb3-core
Wie geht es weiter?
- Alte Werte automatisch löschen: Mit
influxdb3 create database NAME --retention-period 30dbehält eine Datenbank nur die Werte der letzten 30 Tage. - Token mit wenigen Rechten: InfluxDB 3 Core kennt nur Admin-Token mit allen Rechten. Token, die z. B. nur in eine einzige Datenbank schreiben dürfen, gibt es erst in der kostenpflichtigen Ausgabe Enterprise. Gib das Token deshalb nur an Programme weiter, denen du vertraust.
- Werte sammeln: Das Programm Telegraf aus demselben Archiv (
sudo apt install telegraf) misst Auslastung, Speicher und Netzwerk des Rechners oder liest Werte aus vielen anderen Quellen und schreibt sie in InfluxDB. - Diagramme: Zum Darstellen der Zeitreihen wird meist Grafana verwendet. Es kann InfluxDB 3 über SQL abfragen.
- Dokumentation: https://docs.influxdata.com/influxdb3/core/
Deinstallieren
1. Übungsordner und Token-Datei löschen
rm -rf ~/influxdb-uebung ~/.influxdb3-token
2. Zeile aus ~/.bashrc entfernen
nano ~/.bashrc
Suche mit Strg+W nach INFLUXDB3_AUTH_TOKEN und drücke Enter. Lösche die gefundene Zeile mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
3. Dienst anhalten
sudo systemctl stop influxdb3-core
4. InfluxDB entfernen
purge löscht die Konfiguration und die Protokolle, aber nicht die Daten. apt meldet deshalb, dass /var/lib/influxdb3 nicht leer ist.
sudo apt purge influxdb3-core influxdata-archive-keyring
5. Daten löschen
Achtung: Alle Datenbanken sind danach unwiderruflich weg.
sudo rm -rf /var/lib/influxdb3 /var/log/influxdb3 /etc/influxdb3
6. Systembenutzer entfernen
Die Installation hat für den Dienst den Benutzer influxdb3 und eine gleichnamige Gruppe angelegt. Die Gruppe wird mit dem Benutzer entfernt.
sudo deluser influxdb3
7. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/influxdata.sources /etc/apt/keyrings/influxdata.asc
8. Paketlisten aktualisieren
Danach kennt apt die Pakete von InfluxData nicht mehr.
sudo apt update
9. Sicherung löschen (optional)
sudo rm -f /var/backups/influxdb3.tar.gz
Prüfen: Der Befehl influxdb3 wird nicht mehr gefunden.
influxdb3 --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.influxdata.com/
- Lizenz: InfluxDB steht unter der MIT / InfluxData Community.
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.
Meilisearch
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Meilisearch ist eine Suchmaschine, die man in eigene Websites und Anwendungen einbaut. Man übergibt ihr Datensätze als JSON, etwa Produkte, Artikel oder Bücher, und kann sie danach blitzschnell durchsuchen. Meilisearch verzeiht Tippfehler, liefert schon während des Tippens passende Treffer und kann nach Feldern filtern, sortieren und zählen. Angesprochen wird es über HTTP. Diese Anleitung richtet Meilisearch als Dienst ein und baut einen kleinen Bücherkatalog als Beispiel.
Vorbemerkungen
- Warum nicht apt: Ubuntu 26.04 enthält kein Paket für Meilisearch. Das Archiv, das der Hersteller für apt anbietet, ist nicht signiert und hinkt den Versionen hinterher. Diese Anleitung nimmt deshalb die fertige Programmdatei, die das Projekt auf GitHub veröffentlicht, prüft ihre Prüfsumme und legt sie nach
/usr/local/bin. Den Dienst richtest du selbst ein, so wie es die Herstellerdokumentation für den Betrieb auf einem Server beschreibt. - Nur lokal erreichbar: Mit der Einstellung aus Schritt 11 lauscht Meilisearch nur auf
127.0.0.1, Port 7700. - Mit Hauptschlüssel: Ein Master Key schützt alle Zugriffe. Ohne Schlüssel antwortet Meilisearch nur auf die Abfrage seines Zustands.
- Telemetrie: Ohne Gegenmaßnahme sendet Meilisearch anonyme Nutzungsdaten an den Hersteller. Schritt 11 schaltet das ab.
- Größe: Die Programmdatei ist rund 340 MB groß.
- Version: Getestet mit Meilisearch 1.54.3 am 2. Oktober 2026. Steht auf der Release-Seite eine neuere Version, ersetzt du
v1.54.3in Schritt 3 durch die neue Nummer.
Installation
1. Paketlisten aktualisieren
So kennt apt die neuesten Paketversionen.
sudo apt update
2. curl installieren
curl lädt die Programmdatei herunter und spricht später mit Meilisearch. Ist es schon vorhanden, meldet apt nur, dass es bereits in der neuesten Version installiert ist.
sudo apt install curl
3. Programmdatei herunterladen
Lädt die Fassung für Linux auf 64-Bit-Intel/AMD-Prozessoren nach /tmp. -L sorgt dafür, dass curl der Weiterleitung von GitHub zur eigentlichen Datei folgt.
curl -L -o /tmp/meilisearch https://github.com/meilisearch/meilisearch/releases/download/v1.54.3/meilisearch-linux-amd64
Die Datei meilisearch-enterprise-linux-amd64 auf derselben Seite ist die kostenpflichtige Ausgabe und wird hier nicht gebraucht.
4. Prüfsumme kontrollieren
Mit der Prüfsumme stellst du fest, ob die Datei vollständig und unverändert angekommen ist.
sha256sum /tmp/meilisearch
Prüfen: Bei Version 1.54.3 lautet der Wert 0ece934f9791f0db83e1184f4f505a38eae7d93ff1c47efaa9426cf2b3a12ba7. Bei einer neueren Version vergleichst du ihn mit dem Wert sha256:…, den GitHub auf der Release-Seite unter „Assets“ neben meilisearch-linux-amd64 anzeigt.
5. Programm installieren
install kopiert die Datei nach /usr/local/bin und macht sie mit -m 755 für alle ausführbar. Die Datei gehört danach root, der Dienst kann sie also nicht verändern.
sudo install -m 755 /tmp/meilisearch /usr/local/bin/meilisearch
6. Heruntergeladene Datei löschen
rm /tmp/meilisearch
7. Version prüfen
meilisearch --version
Prüfen: Es erscheint meilisearch 1.54.3.
Dienst einrichten
8. Systembenutzer anlegen
Meilisearch soll nicht mit den Rechten von root oder deinem eigenen Benutzer laufen, sondern als eigener Benutzer ohne Anmeldemöglichkeit.
--systemlegt einen Systembenutzer an.--no-create-homeverhindert, dass Vorlagedateien wie.bashrckopiert werden.--shell /usr/sbin/nologinverhindert eine Anmeldung als dieser Benutzer.
sudo useradd --system --no-create-home --home-dir /var/lib/meilisearch --shell /usr/sbin/nologin meilisearch
9. Datenordner anlegen
install -d legt den Ordner an, -o und -g übergeben ihn dem Benutzer und der Gruppe meilisearch, -m 750 sperrt ihn für alle anderen Benutzer. Die Unterordner für Daten und Sicherungen legt Meilisearch später selbst an.
sudo install -d -o meilisearch -g meilisearch -m 750 /var/lib/meilisearch
10. Hauptschlüssel erzeugen
Der Hauptschlüssel muss mindestens 16 Zeichen lang sein. Dieser Befehl erzeugt eine zufällige Zeichenfolge aus 64 Zeichen:
openssl rand -hex 32
Lass die Ausgabe im Terminal stehen. Du brauchst sie in Schritt 11 und Schritt 17.
11. Konfigurationsdatei anlegen
sudo nano /etc/meilisearch.toml
Füge diesen Inhalt ein (Strg+Umschalt+V) und ersetze HAUPTSCHLUESSEL durch die Zeichenfolge aus Schritt 10. Die Anführungszeichen bleiben stehen. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
env = "production"
master_key = "HAUPTSCHLUESSEL"
http_addr = "127.0.0.1:7700"
no_analytics = true
db_path = "/var/lib/meilisearch/data"
dump_dir = "/var/lib/meilisearch/dumps"
snapshot_dir = "/var/lib/meilisearch/snapshots"
env = "production"– Betrieb mit Schlüsselpflicht und ohne die Vorschau-Weboberfläche für Entwickler.master_key– der Hauptschlüssel mit allen Rechten.http_addr– Meilisearch nimmt Verbindungen nur von diesem Rechner an.no_analytics = true– keine Nutzungsdaten an den Hersteller.db_path,dump_dir,snapshot_dir– wo Meilisearch Daten und Sicherungen ablegt.
12. Konfigurationsdatei schützen
Die Datei enthält den Hauptschlüssel. chown gibt sie der Gruppe meilisearch, chmod 640 erlaubt nur root das Schreiben und der Gruppe das Lesen. Andere Benutzer sehen den Inhalt nicht.
sudo chown root:meilisearch /etc/meilisearch.toml
sudo chmod 640 /etc/meilisearch.toml
13. Dienstdatei anlegen
sudo nano /etc/systemd/system/meilisearch.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Meilisearch
After=network.target
[Service]
Type=simple
User=meilisearch
Group=meilisearch
WorkingDirectory=/var/lib/meilisearch
ExecStart=/usr/local/bin/meilisearch --config-file-path /etc/meilisearch.toml
Restart=on-failure
NoNewPrivileges=true
PrivateTmp=true
ProtectHome=true
ProtectSystem=strict
ReadWritePaths=/var/lib/meilisearch
[Install]
WantedBy=multi-user.target
UserundGroup– der Dienst läuft als Benutzer aus Schritt 8.Restart=on-failure– stürzt Meilisearch ab, startet systemd es neu.- Die Zeilen ab
NoNewPrivilegesschränken den Dienst ein: Er darf sich keine zusätzlichen Rechte verschaffen, sieht die Home-Ordner nicht und darf nur in/var/lib/meilisearchschreiben.
14. systemd die neue Datei mitteilen
sudo systemctl daemon-reload
15. Dienst starten und für den Systemstart anmelden
enable --now erledigt beides auf einmal.
sudo systemctl enable --now meilisearch
16. Prüfen, ob der Dienst läuft
systemctl status meilisearch
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
Prüfen: Die Startmeldung zeigt die wichtigsten Einstellungen.
sudo journalctl -u meilisearch | grep -E 'listening on|Environment|telemetry'
Unter den Zeilen stehen Server listening on: mit "http://127.0.0.1:7700", Environment: mit "production" und Anonymous telemetry: mit "Disabled".
Schlüssel bereitstellen
17. Hauptschlüssel in einer Datei ablegen
Damit der Schlüssel nicht bei jedem Befehl abgetippt werden muss und nicht im Befehlsverlauf landet, kommt er in eine Datei, die nur du lesen darfst.
nano ~/.meilisearch-key
Füge die Zeichenfolge aus Schritt 10 ein (ohne Anführungszeichen), speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Datei schützen
chmod 600 ~/.meilisearch-key
19. Schlüssel für dieses Terminal laden
Die Umgebungsvariable MEILI_KEY gilt nur im aktuellen Terminal. Öffnest du ein neues Terminal, wiederholst du diesen Schritt.
export MEILI_KEY="$(cat ~/.meilisearch-key)"
20. Zugriff ohne Schlüssel testen
Die Adresse /health ist als einzige ohne Schlüssel erreichbar.
curl http://127.0.0.1:7700/health
Prüfen: Die Antwort lautet {"status":"available"}. Fragst du stattdessen http://127.0.0.1:7700/indexes ab, meldet Meilisearch missing_authorization_header.
21. Mitgelieferte Schlüssel anzeigen
Mit dem Hauptschlüssel legt Meilisearch einige Schlüssel mit eingeschränkten Rechten an. Der Kopf Authorization: Bearer … schickt den Schlüssel mit.
curl -H "Authorization: Bearer $MEILI_KEY" http://127.0.0.1:7700/keys
Prüfen: In der Antwort stehen unter anderem Default Search API Key mit "actions":["search"] und Default Admin API Key mit "actions":["*"]. Den Suchschlüssel darf man in eine Website einbauen, denn er erlaubt nur das Suchen. Der Hauptschlüssel gehört nie in eine Website.
Einen Bücherkatalog anlegen
22. Übungsordner anlegen
mkdir -p ~/meilisearch-uebung
23. In den Ordner wechseln
cd ~/meilisearch-uebung
24. Datei mit Büchern anlegen
nano buecher.json
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[
{"id": 1, "titel": "Effi Briest", "autor": "Theodor Fontane", "jahr": 1895, "gattung": "Roman", "inhalt": "Eine junge Frau wird früh mit einem viel älteren Beamten verheiratet und lebt einsam in einer Kleinstadt an der Ostsee."},
{"id": 2, "titel": "Der Schimmelreiter", "autor": "Theodor Storm", "jahr": 1888, "gattung": "Novelle", "inhalt": "Ein ehrgeiziger Deichgraf an der Nordseeküste baut einen neuen Deich und kämpft gegen Sturmflut und Aberglauben."},
{"id": 3, "titel": "Buddenbrooks", "autor": "Thomas Mann", "jahr": 1901, "gattung": "Roman", "inhalt": "Über vier Generationen verliert eine Lübecker Kaufmannsfamilie ihr Vermögen und ihren Zusammenhalt."},
{"id": 4, "titel": "Der Zauberberg", "autor": "Thomas Mann", "jahr": 1924, "gattung": "Roman", "inhalt": "Ein junger Hamburger besucht seinen Vetter in einem Sanatorium in den Schweizer Bergen und bleibt sieben Jahre."},
{"id": 5, "titel": "Emil und die Detektive", "autor": "Erich Kästner", "jahr": 1929, "gattung": "Kinderbuch", "inhalt": "Einem Jungen wird auf der Bahnfahrt nach Berlin Geld gestohlen, und eine Bande von Kindern jagt den Dieb."},
{"id": 6, "titel": "Momo", "autor": "Michael Ende", "jahr": 1973, "gattung": "Kinderbuch", "inhalt": "Ein Mädchen, das gut zuhören kann, stellt sich grauen Herren entgegen, die den Menschen ihre Zeit stehlen."}
]
Jedes Buch ist ein Dokument. id ist die eindeutige Nummer, alle anderen Felder sind frei wählbar.
25. Bücher übertragen
Meilisearch legt den Index buecher beim ersten Übertragen selbst an. primaryKey=id sagt, welches Feld die eindeutige Nummer enthält.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST "http://127.0.0.1:7700/indexes/buecher/documents?primaryKey=id" --data-binary @buecher.json
Prüfen: Die Antwort enthält "status":"enqueued". Meilisearch nimmt den Auftrag also an und arbeitet ihn im Hintergrund ab.
26. Auftrag kontrollieren
/tasks listet die Aufträge, limit=1 zeigt nur den neuesten.
curl -H "Authorization: Bearer $MEILI_KEY" "http://127.0.0.1:7700/tasks?limit=1"
Prüfen: Die Antwort enthält "status":"succeeded" und "indexedDocuments":6.
Suchen
27. Mit Tippfehler suchen
zauberbrg fehlt ein Buchstabe. Meilisearch findet trotzdem das richtige Buch.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "zauberbrg"}'
Prüfen: Unter hits steht Der Zauberberg.
28. Nach einem Wortanfang suchen
Das letzte Suchwort wird auch als Wortanfang gesucht. So kann eine Website schon beim Tippen Treffer zeigen.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "nordsee"}'
Prüfen: Gefunden wird Der Schimmelreiter, weil im Inhalt Nordseeküste steht.
29. Fundstelle hervorheben lassen
attributesToHighlight markiert die gefundenen Wörter mit <em>, attributesToRetrieve beschränkt die Antwort auf den Titel.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "stehlen", "attributesToHighlight": ["inhalt"], "attributesToRetrieve": ["titel"]}'
Prüfen: Gefunden wird nur Momo, im Feld _formatted steht <em>stehlen</em>. „Emil und die Detektive“ fehlt, obwohl dort gestohlen steht: Meilisearch erkennt Tippfehler und Wortanfänge, bildet aber keine Grundformen von Wörtern.
Filtern, sortieren und zählen
30. Filter ohne Einstellung versuchen
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "mann", "filter": "jahr > 1910"}'
Prüfen: Meilisearch meldet Attribute 'jahr' is not filterable. Felder, nach denen gefiltert oder sortiert werden soll, müssen vorher angemeldet werden.
31. Felder zum Filtern und Sortieren anmelden
PATCH ändert nur die genannten Einstellungen des Index.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X PATCH http://127.0.0.1:7700/indexes/buecher/settings -d '{"filterableAttributes": ["gattung", "jahr"], "sortableAttributes": ["jahr"]}'
Prüfen: Nach ein bis zwei Sekunden meldet der Befehl aus Schritt 26 für den neuen Auftrag "type":"settingsUpdate" und "status":"succeeded".
32. Mit Filter suchen
Wiederhole den Befehl aus Schritt 30.
Prüfen: Jetzt erscheint nur Der Zauberberg. Buddenbrooks ist ebenfalls von Thomas Mann, erschien aber 1901.
33. Nach Gattung filtern und sortieren
Eine leere Suche "q": "" liefert alle Dokumente, die zum Filter passen. jahr:desc sortiert absteigend.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "", "filter": "gattung = Kinderbuch", "sort": ["jahr:desc"], "attributesToRetrieve": ["titel", "jahr"]}'
Prüfen: Erst kommt Momo mit 1973, dann Emil und die Detektive mit 1929.
34. Treffer je Gattung zählen
facets zählt, wie oft jeder Wert vorkommt. Websites zeigen damit z. B. „Roman (3)“ neben einem Auswahlkästchen. limit: 0 lässt die Treffer selbst weg.
curl -H "Authorization: Bearer $MEILI_KEY" -H 'Content-Type: application/json' -X POST http://127.0.0.1:7700/indexes/buecher/search -d '{"q": "", "facets": ["gattung"], "limit": 0}'
Prüfen: Unter facetDistribution steht {"Kinderbuch":2,"Novelle":1,"Roman":3}.
35. Ein Dokument löschen
Die Zahl am Ende der Adresse ist die id des Buchs.
curl -H "Authorization: Bearer $MEILI_KEY" -X DELETE http://127.0.0.1:7700/indexes/buecher/documents/6
Prüfen: Die Angabe numberOfDocuments lautet danach 5.
curl -H "Authorization: Bearer $MEILI_KEY" http://127.0.0.1:7700/indexes/buecher/stats
Sichern und wiederherstellen
36. Dump anlegen
Ein Dump ist eine Sicherung aller Indizes, Einstellungen und Schlüssel in einer einzigen Datei. Er lässt sich auch in eine neuere Meilisearch-Version einspielen und ist deshalb die richtige Sicherung vor einem Update.
curl -H "Authorization: Bearer $MEILI_KEY" -X POST http://127.0.0.1:7700/dumps
Prüfen: Nach ein paar Sekunden liegt im Ordner eine Datei mit Datum und Endung .dump, z. B. 20261002-193431469.dump.
sudo ls -l /var/lib/meilisearch/dumps
Zum Einspielen startet man Meilisearch einmalig mit leerem Datenordner und der Option --import-dump und dem Pfad zur Datei. Das Vorgehen beschreibt die Herstellerdokumentation unter „Dumps“.
37. Datenordner sichern
Für eine schnelle Sicherung derselben Version reicht ein Archiv des Datenordners. Dazu muss der Dienst kurz angehalten werden.
sudo systemctl stop meilisearch
sudo tar -czf /var/backups/meilisearch.tar.gz -C /var/lib/meilisearch data
sudo systemctl start meilisearch
Zum Wiederherstellen hältst du den Dienst an, löschst den Ordner mit sudo rm -r /var/lib/meilisearch/data, packst das Archiv mit sudo tar -xzf /var/backups/meilisearch.tar.gz -C /var/lib/meilisearch wieder aus und startest den Dienst. Achtung: Alles, was nach der Sicherung geändert wurde, ist danach weg.
Aktualisieren
- Lege wie in Schritt 36 einen Dump an.
- Wiederhole die Schritte 3 bis 6 mit der neuen Versionsnummer.
- Starte den Dienst mit
sudo systemctl restart meilisearchneu. - Prüfe mit
systemctl status meilisearch, ob er läuft. Lehnt die neue Version die vorhandenen Daten ab, steht im Protokoll (sudo journalctl -u meilisearch) ein Hinweis. Dann spielst du den Dump aus Punkt 1 wie in der Herstellerdokumentation beschrieben ein.
Optional: Autostart ausschalten
Wer Meilisearch nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start meilisearch.
sudo systemctl disable --now meilisearch
Wie geht es weiter?
- Suche in eine Website einbauen: Die JavaScript-Bibliothek instant-meilisearch verbindet Meilisearch mit fertigen Suchfeldern und Trefferlisten. Im Browser wird dabei nur der Suchschlüssel aus Schritt 21 verwendet.
- Aus Programmen zugreifen: Es gibt offizielle Bibliotheken für Python (
meilisearch), PHP, JavaScript, Go, Rust und weitere Sprachen. - Zugriff aus dem Netz: Dann sollte ein nginx mit HTTPS vor Meilisearch stehen, und Meilisearch bleibt auf
127.0.0.1. - Dokumentation: https://www.meilisearch.com/docs
Deinstallieren
1. Übungsordner und Schlüsseldatei löschen
rm -rf ~/meilisearch-uebung ~/.meilisearch-key
2. Dienst anhalten und abmelden
sudo systemctl disable --now meilisearch
3. Dienstdatei löschen
sudo rm /etc/systemd/system/meilisearch.service
4. systemd die Änderung mitteilen
sudo systemctl daemon-reload
5. Programm und Konfiguration löschen
sudo rm /usr/local/bin/meilisearch /etc/meilisearch.toml
6. Daten löschen
Achtung: Alle Indizes und Dumps sind danach unwiderruflich weg.
sudo rm -rf /var/lib/meilisearch
7. Systembenutzer entfernen
sudo userdel meilisearch
8. Sicherung löschen (optional)
sudo rm -f /var/backups/meilisearch.tar.gz
Prüfen: Der Befehl meilisearch wird nicht mehr gefunden.
meilisearch --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.meilisearch.com/docs
- Lizenz: Meilisearch steht unter der MIT.
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.
DBeaver
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
DBeaver ist ein grafisches Programm zum Arbeiten mit Datenbanken. Mit ihm sieht man Tabellen und ihre Inhalte, schreibt SQL-Abfragen mit Hilfe der automatischen Ergänzung, ändert Daten wie in einer Tabellenkalkulation und exportiert Ergebnisse als CSV oder Excel-Datei. Die freie Community Edition versteht fast alle verbreiteten Datenbanken, darunter PostgreSQL, MariaDB, MySQL, SQLite, DuckDB und ClickHouse. So genügt ein Werkzeug für alle Datenbanken in diesem Buch.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für DBeaver. Der Hersteller betreibt aber ein eigenes, signiertes apt-Archiv. Nach dem Einbinden installiert und aktualisiert
aptDBeaver wie jedes andere Paket. Daneben gibt es DBeaver als Snap (dbeaver-ce), diese Anleitung nimmt das apt-Archiv. - Java ist dabei: DBeaver ist in Java geschrieben, bringt aber eine eigene Java-Laufzeit mit. Ein vorhandenes Java aus der Anleitung Java wird weder gebraucht noch verändert.
- Treiber aus dem Internet: Für jede Datenbankart braucht DBeaver einen Treiber. Er lädt ihn beim ersten Verbinden mit dieser Datenbankart aus dem Internet nach.
- Teilweise deutsch: Viele Menüs und Dialoge sind übersetzt, manche erscheinen auf Englisch. Die Anleitung nennt bei Bedarf beide Bezeichnungen.
- Version: Installation getestet mit DBeaver Community 26.2.1 am 2. Oktober 2026. Die Bedienung der Oberfläche ab Schritt 9 ist nicht selbst getestet, sie beruht auf der Dokumentation und den Texten im Programm.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.
sudo apt install wget ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich vom Hersteller stammen und unterwegs nicht verändert wurden. Mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/dbeaver.asc https://dbeaver.io/debs/dbeaver.gpg.key
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/dbeaver.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/dbeaver.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://dbeaver.io/debs/dbeaver-ce
Suites: /
Architectures: amd64
Signed-By: /etc/apt/keyrings/dbeaver.asc
Das Archiv von DBeaver ist ein sogenanntes flaches Archiv: Alle Pakete liegen direkt in einem Ordner, ohne Unterteilung nach Ubuntu-Versionen. Deshalb steht bei Suites nur ein Schrägstrich, und die sonst übliche Zeile Components entfällt.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von DBeaver herunter.
sudo apt update
Prüfen: In der Ausgabe erscheint eine Zeile mit https://dbeaver.io/debs/dbeaver-ce InRelease, und der Installationskandidat ist eine Version wie 26.2.1.
apt policy dbeaver-ce
Installation
6. DBeaver installieren
Das Paket ist rund 130 MB groß und belegt ausgepackt etwa 200 MB. Es hat keine weiteren Abhängigkeiten.
sudo apt install dbeaver-ce
7. Version prüfen
DBeaver legt keinen Befehl im Suchpfad an, sondern installiert sich nach /usr/share/dbeaver-ce. Die Versionsnummer steht in einer kleinen Textdatei.
grep version /usr/share/dbeaver-ce/.eclipseproduct
Prüfen: Es erscheint version=26.2.1 oder eine höhere Nummer.
8. Mitgeliefertes Java prüfen (optional)
/usr/share/dbeaver-ce/jre/bin/java -version
Prüfen: Die erste Zeile nennt openjdk version "25…". Diese Java-Version gehört nur zu DBeaver.
Erste Schritte (nicht getestet)
Das Beispiel legt eine SQLite-Datenbank an. Dafür ist kein Datenbankserver nötig, und es gibt kein Passwort.
9. DBeaver starten
Öffne die Programmübersicht von Ubuntu, tippe dbeaver und klicke auf dbeaver-ce. Alternativ startet dieser Befehl DBeaver aus dem Terminal:
/usr/share/dbeaver-ce/dbeaver &
Das & am Ende gibt das Terminal sofort wieder frei.
10. Datenweitergabe ablehnen
Beim ersten Start fragt ein Dialog, ob DBeaver anonyme Nutzungsstatistiken senden darf (Statistics collection bzw. Data collection). Wähle Do not share data bzw. Do not share anonymous usage statistics und bestätige. Die Einstellung lässt sich später in den Einstellungen unter General → Usage Statistics ändern (englisch Window → Preferences, auf Deutsch je nach Übersetzung Fenster → Einstellungen).
Fragt DBeaver außerdem, ob eine Beispieldatenbank angelegt werden soll, kannst du das ablehnen.
11. Neue Verbindung beginnen
Klicke im Menü Datenbank auf Neue Verbindung (englisch Database → New Database Connection). Alternativ klickst du links oben im Bereich Datenbanknavigator auf das Steckersymbol mit dem Pluszeichen.
12. Datenbankart wählen
Es öffnet sich eine Liste mit Datenbanken. Tippe oben in das Suchfeld SQLite, markiere SQLite und klicke auf Weiter.
13. Datei für die Datenbank angeben
Trage bei Pfad (englisch Path) diese Datei ein und ersetze BENUTZER durch deinen Benutzernamen:
/home/BENUTZER/dbeaver-uebung.db
Den eigenen Benutzernamen zeigt der Befehl whoami im Terminal. Gibt es die Datei noch nicht, legt SQLite sie beim ersten Verbinden an.
14. Treiber herunterladen
Klicke auf Verbindung testen … (Test Connection). Beim ersten Mal meldet DBeaver, dass Treiberdateien fehlen (Datenbanktreiber herunterladen). Bestätige mit Herunterladen (Download).
Prüfen: Nach dem Download meldet DBeaver eine erfolgreiche Verbindung (Connected). Schließe die Meldung und klicke auf Fertigstellen (Finish).
15. SQL-Editor öffnen
Markiere die neue Verbindung im Datenbanknavigator und drücke Strg+]. Alternativ wählst du im Menü SQL-Editor → Neues SQL-Skript.
16. Tabelle anlegen und füllen
Füge diesen Text in den SQL-Editor ein (Strg+V):
CREATE TABLE ausflug (
id INTEGER PRIMARY KEY,
ziel TEXT NOT NULL,
km REAL,
datum TEXT
);
INSERT INTO ausflug (ziel, km, datum) VALUES
('Hamfelder Hof', 6.5, '2026-09-06'),
('Großensee', 12.0, '2026-09-13'),
('Wildpark Schwarze Berge', 48.0, '2026-09-20');
SELECT ziel, km FROM ausflug ORDER BY km DESC;
Führe den ganzen Text als Skript aus: Alt+X.
Prüfen: Unten erscheint ein Ergebnisbereich mit den drei Zielen, das weiteste zuerst.
17. Eine einzelne Abfrage ausführen
Setze den Cursor in die Zeile mit SELECT und drücke Strg+Enter. Damit führt DBeaver nur die Anweisung aus, in der der Cursor steht.
18. Tabelle im Navigator ansehen
Klappe im Datenbanknavigator die Verbindung auf und öffne Tabellen. Ist ausflug noch nicht zu sehen, markiere die Verbindung und drücke F5 zum Aktualisieren. Ein Doppelklick auf ausflug öffnet die Tabelle. Im Reiter Daten (Data) lassen sich Werte direkt ändern. Änderungen werden erst mit Speichern (Save) unten im Fenster in die Datenbank geschrieben.
19. Ergebnis exportieren
Klicke im Ergebnisbereich mit der rechten Maustaste und wähle Daten exportieren … (Export data …). Der Assistent bietet unter anderem CSV, Excel (XLSX), JSON und SQL-Anweisungen an.
Verbindungen zu Datenbankservern
Für Server wie PostgreSQL, MariaDB oder ClickHouse gehst du wie in den Schritten 11 bis 14 vor und gibst statt eines Dateipfads diese Angaben ein:
- Host:
localhost - Port: z. B.
5432für PostgreSQL,3306für MariaDB und MySQL,8123für ClickHouse - Datenbank, Benutzername und Passwort: die Werte, die du in der jeweiligen Anleitung angelegt hast
DBeaver verbindet sich immer über das Netzwerk, auch auf demselben Rechner. Bei PostgreSQL funktioniert die Anmeldung ohne Passwort über den Benutzer postgres deshalb nicht. Lege dort einen Benutzer mit Passwort an, wie es der Abschnitt PostgreSQL-Benutzer mit Passwort anlegen in der Anleitung zu Adminer beschreibt.
Passwörter speichert DBeaver verschlüsselt in deinem Home-Ordner. Wer das nicht möchte, entfernt beim Einrichten der Verbindung den Haken bei Passwort speichern (Save password) und gibt es bei jeder Verbindung neu ein.
Wie geht es weiter?
- Aktualisieren: Neue Versionen kommen mit
sudo apt updateundsudo apt upgradewie bei allen anderen Paketen. - Mehr Speicher: Bei sehr großen Ergebnissen kann DBeaver an seine Speichergrenze von 1 GB stoßen. Sie steht in der Zeile
-Xmx1024min/usr/share/dbeaver-ce/dbeaver.ini. Diese Datei wird bei jedem Update überschrieben. - Dokumentation: https://dbeaver.com/docs/dbeaver/
Deinstallieren
1. DBeaver schließen
Beende DBeaver, falls es noch läuft.
2. DBeaver entfernen
sudo apt purge dbeaver-ce
3. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/dbeaver.sources /etc/apt/keyrings/dbeaver.asc
4. Paketlisten aktualisieren
Danach kennt apt die Pakete von DBeaver nicht mehr.
sudo apt update
5. Eigene Einstellungen löschen (optional)
DBeaver legt Verbindungen, gespeicherte Passwörter, heruntergeladene Treiber und Skripte im Home-Ordner ab. Achtung: Alle Verbindungen und SQL-Skripte in DBeaver sind danach weg.
rm -rf ~/.local/share/DBeaverData
6. Übungsdatenbank löschen (optional)
rm -f ~/dbeaver-uebung.db
Prüfen: Der Programmordner ist verschwunden.
ls /usr/share/dbeaver-ce
ls meldet, dass es den Ordner nicht gibt (Datei oder Verzeichnis nicht gefunden).
Quellen und Lizenz
- Offizielle Dokumentation: https://dbeaver.io/
- Lizenz: DBeaver Community steht unter der Apache-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.
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.
Valkey
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Valkey ist ein sehr schneller Datenspeicher, der seine Daten im Arbeitsspeicher hält und unter einem Schlüssel ablegt. Webanwendungen nutzen ihn vor allem als Zwischenspeicher (Cache), für Anmeldesitzungen, Zähler und Warteschlangen. Valkey ist ein freier Nachfolger von Redis: Es spricht dasselbe Protokoll und versteht dieselben Befehle, deshalb funktionieren Programme und Bibliotheken für Redis auch mit Valkey. Diese Anleitung richtet den Dienst ein, zeigt die wichtigsten Befehle und sichert ihn mit einem Passwort ab.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Valkey 9.0. Mit dem Paket
valkey-serverkommen nur zwei Pakete auf den Rechner: der Server und die Werkzeuge wievalkey-cli. - Warum nicht Redis? Ubuntu bietet auch das Paket
redis-serveran. Als Redis 2024 mit Version 7.4 seine freie Lizenz aufgab, wurde der bis dahin freie Code als Valkey unter dem Dach der Linux Foundation weitergeführt. Seit Version 8 gibt es Redis zwar wieder unter einer freien Lizenz (AGPL), Valkey ist aber als eigenständiges, gemeinschaftlich entwickeltes Projekt geblieben. Für die meisten Zwecke sind beide austauschbar. - Nur lokal erreichbar: Der Dienst lauscht nach der Installation nur auf
127.0.0.1und::1, Port 6379. Andere Rechner im Netz erreichen ihn nicht. - Ohne Passwort: Zunächst darf jeder Benutzer dieses Rechners alle Daten lesen und ändern. Abschnitt „Mit einem Passwort schützen“ ändert das.
- Daten im Arbeitsspeicher: Valkey schreibt den Inhalt in regelmäßigen Abständen und beim Beenden in die Datei
/var/lib/valkey/dump.rdb. Nach einem Absturz können die Änderungen der letzten Minuten fehlen. Für Daten, die auf keinen Fall verloren gehen dürfen, ist eine Datenbank wie PostgreSQL besser geeignet. - Version: Getestet mit Valkey 9.0.4 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Valkey installieren
Installiert den Server und das Kommandozeilenprogramm valkey-cli. Der Dienst startet sofort und künftig bei jedem Hochfahren.
sudo apt install valkey-server
3. Prüfen, ob der Dienst läuft
systemctl status valkey-server
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
4. Prüfen, dass Valkey nur lokal lauscht
sudo ss -ltnp | grep 6379
Prüfen: Es erscheinen zwei Zeilen mit LISTEN, eine mit 127.0.0.1:6379 und eine mit [::1]:6379.
5. Verbindung testen
PING ist ein einfacher Lebenszeichen-Befehl.
valkey-cli ping
Prüfen: Valkey antwortet mit PONG.
Die wichtigsten Befehle
6. Konsole öffnen
valkey-cli
Prüfen: Die Eingabezeile lautet 127.0.0.1:6379>. Die Groß- und Kleinschreibung der Befehle spielt keine Rolle, die der Schlüssel schon.
7. Einen Wert speichern
SET legt unter dem Schlüssel gruss einen Text ab. Enthält der Wert Leerzeichen, gehört er in Anführungszeichen.
SET gruss "Hallo Welt"
Prüfen: Valkey antwortet mit OK.
8. Den Wert lesen
GET gruss
Prüfen: Die Ausgabe lautet "Hallo Welt". Bei einem Schlüssel, den es nicht gibt, erscheint (nil).
9. Einen Wert mit Ablaufzeit speichern
EX 60 lässt den Eintrag nach 60 Sekunden von selbst verschwinden. So arbeiten Zwischenspeicher und Anmeldesitzungen: Alte Einträge räumen sich selbst weg.
SET sitzung:42 angemeldet EX 60
Der Doppelpunkt im Schlüssel hat für Valkey keine Bedeutung. Er ist nur eine übliche Art, Schlüssel zu ordnen, ähnlich wie Ordner.
10. Restlaufzeit abfragen
TTL sitzung:42
Prüfen: Die Ausgabe nennt die verbleibenden Sekunden, zum Beispiel (integer) 54. Ist der Schlüssel abgelaufen, erscheint (integer) -2.
11. Einen Zähler erhöhen
INCR zählt den Wert um eins hoch und legt den Schlüssel an, wenn es ihn noch nicht gibt. Das geschieht in einem Schritt. Greifen zwei Programme gleichzeitig zu, geht deshalb kein Besuch verloren.
INCR besucher
Prüfen: Beim ersten Aufruf lautet die Ausgabe (integer) 1, beim nächsten (integer) 2.
12. Mehrere Felder unter einem Schlüssel speichern
Ein Hash fasst zusammengehörige Felder zusammen, ähnlich wie eine Tabellenzeile.
HSET modell:1 name Citybike preis 699 lager 4
Prüfen: Die Ausgabe (integer) 3 nennt die Zahl der neu angelegten Felder.
13. Alle Felder lesen
HGETALL modell:1
Prüfen: Die Ausgabe zeigt abwechselnd Feldname und Wert:
1) "name"
2) "Citybike"
3) "preis"
4) "699"
5) "lager"
6) "4"
14. Eine Warteschlange füllen
RPUSH hängt Einträge hinten an eine Liste an.
RPUSH aufgaben "Kette schmieren" "Licht testen"
15. Den ersten Eintrag abholen
LPOP nimmt den vordersten Eintrag heraus. So kann ein Programm Aufträge in die Liste stellen und ein anderes sie der Reihe nach abarbeiten.
LPOP aufgaben
Prüfen: Die Ausgabe lautet "Kette schmieren". Mit LRANGE aufgaben 0 -1 siehst du, was noch in der Liste steht.
16. Vorhandene Schlüssel auflisten
SCAN 0
Prüfen: Unter 2) stehen die Schlüssel, die du angelegt hast. sitzung:42 fehlt, wenn die 60 Sekunden um sind. SCAN liefert bei vielen Schlüsseln nur einen Teil und unter 1) eine Zahl zum Weiterblättern. Der ältere Befehl KEYS * zeigt alles auf einmal, blockiert dabei aber den Server und ist für große Datenbestände ungeeignet.
17. Einen Schlüssel löschen
DEL gruss
Prüfen: Die Ausgabe (integer) 1 zeigt, dass ein Schlüssel gelöscht wurde.
18. Konsole verlassen
quit
Umlaute: In der Konsole erscheint ein gespeichertes „ö“ als
\xc3\xb6. Das ist nur eine Frage der Anzeige, die Daten sind richtig gespeichert. Mitvalkey-cli --rawwerden Umlaute normal angezeigt.
Mit einem Passwort schützen
Ohne Passwort kann jedes Programm auf diesem Rechner die Daten lesen und löschen. Ein Passwort verhindert das.
19. Konfigurationsdatei öffnen
Die Datei gehört dem Benutzer valkey und lässt sich nur mit sudo bearbeiten.
sudo nano /etc/valkey/valkey.conf
20. Passwort eintragen
Die Datei ist sehr lang. Suche mit Strg+W nach # requirepass und drücke Enter. Füge unter der gefundenen Zeile # requirepass foobared eine neue Zeile ein und ersetze GEHEIMES-PASSWORT durch ein eigenes, langes Passwort:
requirepass GEHEIMES-PASSWORT
Valkey prüft Passwörter sehr schnell. Ein Angreifer kann deshalb viele Passwörter in kurzer Zeit durchprobieren. Wähle also ein langes Passwort, zum Beispiel aus openssl rand -base64 32.
21. Speichergrenze festlegen (empfohlen)
Ohne Grenze wächst Valkey, bis der Arbeitsspeicher voll ist. Suche mit Strg+W nach # maxmemory <bytes>. Füge darunter diese Zeile ein:
maxmemory 256mb
Suche dann nach # maxmemory-policy noeviction und füge darunter ein:
maxmemory-policy allkeys-lru
maxmemory 256mb– Valkey belegt höchstens 256 Megabyte für Daten.allkeys-lru– ist die Grenze erreicht, löscht Valkey die Schlüssel, die am längsten nicht benutzt wurden. Das passt für einen Zwischenspeicher. Werden in Valkey Daten abgelegt, die nicht verloren gehen dürfen, die Zeile weglassen: Dann lehnt Valkey beim Erreichen der Grenze neue Schreibbefehle mit einer Fehlermeldung ab.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
22. Dienst neu starten
Valkey liest die Konfiguration nur beim Start.
sudo systemctl restart valkey-server
23. Prüfen, dass das Passwort verlangt wird
valkey-cli ping
Prüfen: Statt PONG erscheint jetzt NOAUTH Authentication required.
24. Mit Passwort anmelden
--askpass fragt das Passwort ab, ohne es anzuzeigen. Anders als bei -a PASSWORT landet es so nicht im Befehlsverlauf der Shell.
valkey-cli --askpass
Prüfen: In der Konsole antwortet PING mit PONG und CONFIG GET maxmemory mit 268435456 (256 MB in Byte). Verlasse die Konsole mit quit.
In einer bereits geöffneten Konsole meldet man sich alternativ mit AUTH GEHEIMES-PASSWORT an.
Aus Python zugreifen
25. Python-Bibliothek installieren
Die Bibliothek heißt redis, funktioniert aber genauso mit Valkey.
sudo apt install python3-redis
26. Übungsordner anlegen
mkdir ~/valkey-uebung
27. In den Ordner wechseln
cd ~/valkey-uebung
28. Programm anlegen
Das Programm zählt bei jedem Aufruf einen Besuch hoch und speichert einen Text für fünf Minuten.
nano zaehler.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import getpass
import redis
passwort = getpass.getpass("Valkey-Passwort: ")
db = redis.Redis(host="localhost", port=6379, password=passwort, decode_responses=True)
anzahl = db.incr("besuche")
db.set("letzter_gruss", "Schön, dass du da bist!", ex=300)
print("Besuch Nummer", anzahl)
print(db.get("letzter_gruss"))
decode_responses=True– liefert Texte als Python-Zeichenketten statt als Bytes. Umlaute erscheinen dadurch richtig.ex=300– entsprichtEX 300in der Konsole: Der Eintrag verschwindet nach fünf Minuten.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
29. Programm ausführen
python3 zaehler.py
Prüfen: Nach dem Passwort erscheinen Besuch Nummer 1 und Schön, dass du da bist!. Bei jedem weiteren Aufruf steigt die Nummer um eins.
Sichern
30. Sofort auf die Festplatte schreiben
Valkey speichert von selbst in Abständen. BGSAVE stößt das Speichern sofort an, zum Beispiel vor einer Sicherung. Gib das Passwort ein, wenn danach gefragt wird.
valkey-cli --askpass BGSAVE
Prüfen: Die Antwort lautet Background saving started.
31. Sicherungsdatei kopieren
Die Datei dump.rdb enthält den gesamten Datenbestand. Eine Kopie davon ist die Sicherung.
sudo cp /var/lib/valkey/dump.rdb ~/valkey-sicherung.rdb
Zum Wiederherstellen den Dienst mit sudo systemctl stop valkey-server anhalten, die Kopie zurück nach /var/lib/valkey/dump.rdb legen, mit sudo chown valkey:valkey /var/lib/valkey/dump.rdb dem Benutzer valkey übergeben und den Dienst wieder starten.
Optional: Autostart ausschalten
Wer Valkey nur ab und zu braucht, kann den Dienst beim Hochfahren weglassen und bei Bedarf mit sudo systemctl start valkey-server starten.
sudo systemctl disable --now valkey-server
Wie geht es weiter?
- Aus PHP zugreifen: Das Paket
php-redisbringt die Erweiterung für PHP mit. Viele PHP-Anwendungen können darüber Sitzungen und Zwischenergebnisse in Valkey ablegen. - Mehrere Benutzer: Statt eines gemeinsamen Passworts lassen sich mit
ACL SETUSEReigene Benutzer anlegen, die nur bestimmte Befehle und Schlüssel verwenden dürfen. - Mehr Schutz vor Datenverlust: Mit
appendonly yesin/etc/valkey/valkey.confschreibt Valkey jede Änderung zusätzlich in ein Protokoll. Nach einem Absturz fehlt dann höchstens die letzte Sekunde. - Dokumentation: Alle Befehle mit Erklärung unter https://valkey.io/commands/.
Deinstallieren
1. Übungsordner und Sicherung entfernen
rm -rf ~/valkey-uebung ~/valkey-sicherung.rdb
2. Python-Bibliothek entfernen (falls installiert)
sudo apt purge python3-redis
3. Valkey entfernen
Achtung: purge löscht neben der Konfiguration in /etc/valkey auch die gespeicherten Daten in /var/lib/valkey und das Protokoll in /var/log/valkey, und zwar ohne Nachfrage. Wer die Daten noch braucht, kopiert vorher die Datei dump.rdb wie in Schritt 31 an einen anderen Ort, aber nicht in einen der Ordner aus Schritt 1, die dort gelöscht werden.
sudo apt purge valkey-server valkey-tools
Prüfen: Der Befehl valkey-cli wird nicht mehr gefunden.
valkey-cli --version
Quellen und Lizenz
- Offizielle Dokumentation: https://valkey.io/docs/
- Lizenz: Valkey steht unter der BSD-3-Clause.
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.
Memcached
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Memcached ist ein Zwischenspeicher (Cache) im Arbeitsspeicher. Programme legen dort Ergebnisse ab, deren Berechnung oder Abfrage lange dauert, und holen sie beim nächsten Mal in Sekundenbruchteilen wieder heraus. Webanwendungen wie MediaWiki, Drupal oder WordPress entlasten so ihre Datenbank. Diese Anleitung installiert den Dienst, zeigt die Grundbefehle und nutzt den Cache aus einem kleinen Python-Programm.
Vorbemerkungen
- Nur ein Cache, keine Datenbank: Memcached speichert nichts auf der Festplatte. Nach einem Neustart des Dienstes ist alles weg, und wenn der Speicher voll ist, wirft Memcached die am längsten nicht genutzten Einträge hinaus. Ablegen sollte man dort deshalb nur Daten, die sich jederzeit neu erzeugen lassen.
- Unterschied zu Valkey: Valkey kann Daten auf die Festplatte schreiben und kennt Listen, Mengen und Warteschlangen. Memcached kennt nur Schlüssel mit einem Wert, ist dafür sehr einfach und braucht kaum Einstellungen.
- Keine Anmeldung: Wer den Port erreicht, kann alles lesen und löschen. Ubuntu lässt Memcached deshalb nur auf
127.0.0.1und::1lauschen, also nur auf dem eigenen Rechner. Das sollte man ohne Firewall nicht ändern. - Pakete:
memcachedist der Dienst,libmemcached-toolsbringt kleine Befehle zum Ausprobieren mit (memcstat,memccp,memccatund weitere). Zusammen kommen 6 Pakete auf den Rechner. - Version: Getestet mit Memcached 1.6.40 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
So kennt apt die neuesten Paketversionen.
sudo apt update
2. Memcached und Werkzeuge installieren
Der Dienst startet sofort nach der Installation und künftig bei jedem Hochfahren.
sudo apt install memcached libmemcached-tools
Prüfen: Die Versionsnummer wird ausgegeben.
memcached --version
3. Dienst prüfen
systemctl status memcached
Prüfen: In der Ausgabe steht active (running). Mit q kommst du zurück.
4. Offene Ports prüfen
sudo ss -ltnp | grep memcached
Prüfen: Es erscheinen zwei Zeilen mit 127.0.0.1:11211 und [::1]:11211. 11211 ist der Standardport von Memcached.
5. Kennzahlen abrufen
memcstat fragt den laufenden Dienst nach seinen Zahlen. --servers=localhost gibt an, mit welchem Memcached es sprechen soll.
memcstat --servers=localhost
Prüfen: Die Liste beginnt mit Server: localhost (11211). Weiter unten zeigt limit_maxbytes: 67108864, dass der Cache höchstens 64 MB belegt, und curr_items: 0, dass er noch leer ist.
Mit den Werkzeugen ausprobieren
6. Übungsordner anlegen
mkdir ~/memcached-uebung
7. In den Ordner wechseln
cd ~/memcached-uebung
8. Kleine Textdatei anlegen
nano gruss.txt
Schreibe eine Zeile hinein, zum Beispiel:
Hallo aus dem Zwischenspeicher
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
9. Datei in den Cache legen
memccp speichert den Inhalt der Datei. Als Schlüssel dient der Dateiname, hier also gruss.txt.
memccp --servers=localhost gruss.txt
10. Eintrag wieder auslesen
memccat --servers=localhost gruss.txt
Prüfen: Der Satz aus der Datei erscheint.
11. Eintrag mit Ablaufzeit speichern
--expire=10 legt fest, dass Memcached den Eintrag nach 10 Sekunden vergisst. Der vorige Eintrag mit gleichem Schlüssel wird dabei ersetzt.
memccp --servers=localhost --expire=10 gruss.txt
12. Nach Ablauf erneut lesen
Warte gut 10 Sekunden und frage dann noch einmal ab.
memccat --servers=localhost gruss.txt
Prüfen: Diesmal kommt keine Ausgabe, denn der Eintrag ist abgelaufen.
Direkt mit dem Dienst sprechen
Memcached versteht einfache Textbefehle. Mit nc (Netcat, auf Ubuntu vorinstalliert) lassen sie sich von Hand eintippen. So sieht man, was Programme im Hintergrund tun.
13. Verbindung öffnen
-C sorgt dafür, dass jede Zeile so abgeschlossen wird, wie Memcached es erwartet (Wagenrücklauf und Zeilenvorschub). Ohne diese Angabe meldet Memcached bad data chunk. Es erscheint keine Eingabeaufforderung; tippe einfach los.
nc -C localhost 11211
14. Wert speichern
Ein set-Befehl besteht aus zwei Zeilen. Die erste nennt Schlüssel, eine Kennzahl für Programme (hier 0), die Lebensdauer in Sekunden (300) und die Länge des Werts in Bytes. Die zweite Zeile ist der Wert selbst. Ahrensburg hat 10 Zeichen.
set stadt 0 300 10
Ahrensburg
Prüfen: Memcached antwortet mit STORED. Stimmt die Länge nicht, kommt CLIENT_ERROR bad data chunk.
15. Wert lesen
get stadt
Prüfen: Die Antwort lautet:
VALUE stadt 0 10
Ahrensburg
END
16. Zähler hochzählen
Zuerst einen Zähler mit dem Wert 0 anlegen (Länge 1), dann mit incr erhöhen. incr gibt sofort den neuen Stand zurück.
set besucher 0 0 1
0
incr besucher 1
incr besucher 5
Prüfen: Nach STORED erscheinen 1 und 6. Eine Lebensdauer von 0 bedeutet: Der Eintrag läuft nie ab.
17. Eintrag löschen
delete stadt
Prüfen: Die Antwort lautet DELETED. Ein folgendes get stadt liefert nur noch END.
18. Verbindung beenden
quit
Memcached trennt dann die Verbindung. Kehrt die Eingabezeile nicht von selbst zurück, beende nc mit Strg+C.
Aus Python nutzen
Das folgende Beispiel zeigt den typischen Ablauf: zuerst im Cache nachsehen, nur bei einem Fehlschlag die langsame Abfrage ausführen und das Ergebnis für später ablegen.
19. Python-Bibliothek installieren
pymemcache ist eine Bibliothek, mit der Python-Programme Memcached ansprechen.
sudo apt install python3-pymemcache
20. Programm anlegen
nano wetter.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import time
from pymemcache.client.base import Client
cache = Client(("localhost", 11211))
def langsame_abfrage(stadt):
"""Tut so, als würde ein entfernter Dienst zwei Sekunden brauchen."""
time.sleep(2)
return f"Sonnig in {stadt}"
def wetter(stadt):
schluessel = "wetter:" + stadt.lower()
treffer = cache.get(schluessel)
if treffer is not None:
return treffer.decode(), "aus dem Cache"
ergebnis = langsame_abfrage(stadt)
cache.set(schluessel, ergebnis, expire=60)
return ergebnis, "neu abgefragt"
for runde in (1, 2):
start = time.perf_counter()
text, herkunft = wetter("Ahrensburg")
dauer = time.perf_counter() - start
print(f"Runde {runde}: {text} ({herkunft}, {dauer:.2f} s)")
"wetter:" + stadt.lower()– ein Schlüssel mit Vorsilbe. So kommen sich Einträge verschiedener Programmteile nicht in die Quere.cache.get(…)– liefert den gespeicherten Wert als Bytes oderNone, wenn es keinen Eintrag gibt..decode()macht daraus wieder Text.expire=60– das Ergebnis bleibt eine Minute gültig. Danach wird neu abgefragt, damit keine veralteten Daten ausgeliefert werden.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
21. Programm ausführen
python3 wetter.py
Prüfen: Die erste Runde dauert etwa 2 Sekunden und meldet neu abgefragt, die zweite kommt in Sekundenbruchteilen aus dem Cache. Startest du das Programm innerhalb einer Minute erneut, kommen beide Runden aus dem Cache.
Einstellungen anpassen
Die Einstellungen stehen in /etc/memcached.conf. Als Beispiel wird der Speicher von 64 auf 256 MB vergrößert.
22. Einstellungsdatei öffnen
sudo nano /etc/memcached.conf
23. Speichergröße ändern
Suche mit Strg+W nach -m 64 und ändere die Zeile in:
-m 256
Weitere Zeilen in dieser Datei:
-p 11211– der Port.-l 127.0.0.1und-l ::1– die Adressen, auf denen Memcached lauscht.# -c 1024– die Höchstzahl gleichzeitiger Verbindungen. Die Raute davor bedeutet, dass der Vorgabewert 1024 gilt.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
24. Dienst neu starten
Die neue Einstellung gilt erst nach einem Neustart. Dabei wird der Cache geleert.
sudo systemctl restart memcached
Prüfen: Der Wert lautet jetzt 268435456 (256 MB in Bytes).
memcstat --servers=localhost | grep limit_maxbytes
25. Cache leeren (bei Bedarf)
memcflush macht alle Einträge ungültig, ohne den Dienst neu zu starten. Das ist praktisch, wenn eine Anwendung veraltete Daten anzeigt.
memcflush --servers=localhost
Optional: Nicht automatisch starten
Wer Memcached nur gelegentlich braucht, schaltet den Start beim Hochfahren ab. Mit sudo systemctl start memcached läuft der Dienst bei Bedarf wieder.
sudo systemctl disable --now memcached
Wie geht es weiter?
- PHP-Anwendungen: Das Paket
php-memcachedbringt die Erweiterung für PHP mit. MediaWiki nutzt sie zum Beispiel über die Einstellung$wgMainCacheType = CACHE_MEMCACHED;inLocalSettings.php, Drupal über das Modul „Memcache API and Integration“. - Andere Sprachen: Für fast jede Sprache gibt es Bibliotheken, etwa für Java, Go oder Node.js.
- Dokumentation: Projektseite und Wiki unter https://memcached.org/ und https://github.com/memcached/memcached/wiki.
Deinstallieren
1. Übungsordner löschen
rm -rf ~/memcached-uebung
2. Python-Bibliothek entfernen (falls installiert)
sudo apt purge python3-pymemcache
3. Memcached und Werkzeuge entfernen
purge löscht auch /etc/memcached.conf samt deinen Änderungen.
sudo apt purge memcached libmemcached-tools
4. Übrige Abhängigkeiten entfernen
apt zeigt vorher an, welche Pakete gelöscht werden, und fragt nach. Ist eines dabei, das du noch brauchst, brich mit n ab.
sudo apt autoremove --purge
Prüfen: Der Befehl memcached wird nicht mehr gefunden.
memcached --version
Quellen und Lizenz
- Offizielle Dokumentation: https://memcached.org/
- Lizenz: Memcached steht unter der Revised BSD License.
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.
Neo4j
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neo4j ist eine Graphdatenbank: Sie speichert Dinge als Knoten und die Beziehungen zwischen ihnen als eigene Verbindungen mit Richtung und Eigenschaften. Das passt gut zu Daten, bei denen vor allem die Zusammenhänge zählen, etwa Verkehrsnetze, Stammbäume, Abhängigkeiten zwischen Programmteilen oder Wissensnetze. Abgefragt wird Neo4j mit der Sprache Cypher, in der man Muster aus Knoten und Pfeilen fast wie eine Skizze hinschreibt. Diese Anleitung installiert die freie Community Edition, sichert sie ab und baut ein kleines Bahnnetz als Beispiel.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für Neo4j. Neo4j betreibt aber ein eigenes apt-Archiv. Nach dem Einbinden installiert und aktualisiert
aptNeo4j wie jedes andere Paket. - Community Edition: Das Paket
neo4jist die freie Ausgabe unter der Lizenz GPLv3. Das Paketneo4j-enterpriseaus demselben Archiv ist kostenpflichtig und wird hier nicht gebraucht. - Java: Neo4j ist in Java geschrieben und läuft nur mit Java 21 oder 25. Das Paket zieht Java 21 automatisch mit. Ist auf dem Rechner eine neuere Java-Version als Standard eingestellt (z. B. Java 26 aus der Anleitung Java), würde Neo4j mit dieser starten. Schritt 13 legt deshalb fest, dass der Dienst immer Java 21 nimmt.
- Nur lokal erreichbar: Neo4j lauscht nach der Installation nur auf
127.0.0.1. Port 7687 ist für Programme und die Kommandozeile (Protokoll Bolt), Port 7474 für die Weboberfläche Neo4j Browser. - Datenübertragung abschalten: Neo4j schickt in der Grundeinstellung anonyme Nutzungsdaten an den Hersteller und meldet sich per Rundruf im lokalen Netz. Schritt 11 schaltet beides vor dem ersten Start ab.
- Version: Getestet mit Neo4j 2026.09.0 am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.
sudo apt install wget ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Neo4j stammen und unterwegs nicht verändert wurden. Der Ordner /etc/apt/keyrings ist unter Ubuntu für selbst hinzugefügte Schlüssel gedacht. Der Schlüssel liegt als Text vor, mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/neo4j.asc https://debian.neo4j.com/neotechnology.gpg.key
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/neo4j.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/neo4j.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://debian.neo4j.com
Suites: stable
Components: latest
Architectures: amd64
Signed-By: /etc/apt/keyrings/neo4j.asc
Suites: stable– Das Archiv von Neo4j ist nicht nach Ubuntu-Versionen aufgeteilt, alle Systeme nutzen denselben Bereich.Components: latest– Immer die neueste Neo4j-Version. Wer bei der älteren Reihe 5 bleiben muss, schreibt hier5.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 angenommen.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von Neo4j herunter.
sudo apt update
Prüfen: In der Ausgabe erscheint eine Zeile mit https://debian.neo4j.com stable InRelease, und der Installationskandidat ist eine Version wie 1:2026.09.0.
apt policy neo4j
Installation
6. Neo4j installieren
Installiert den Server, die Kommandozeile cypher-shell und Java 21. Das Paket meldet den Dienst für den Systemstart an, startet ihn aber noch nicht. So bleibt Zeit, ihn vorher einzurichten.
sudo apt install neo4j
7. Version prüfen
neo4j --version
Prüfen: Es erscheint die Versionsnummer, z. B. 2026.09.0. Steht darüber eine Warnung zu einer nicht unterstützten Java-Version, ist das an dieser Stelle harmlos. Für den Dienst wird das in Schritt 13 gelöst.
Vor dem ersten Start einrichten
8. Konfigurationsdatei öffnen
Die Einstellungen von Neo4j stehen in /etc/neo4j/neo4j.conf.
sudo nano /etc/neo4j/neo4j.conf
9. An das Ende der Datei springen
Drücke Strg+Ende. Der Cursor steht dann unter dem letzten Abschnitt „Other Neo4j system properties“.
10. Leerzeile einfügen
Drücke Enter, damit die neuen Zeilen vom bisherigen Text abgesetzt sind.
11. Datenübertragung abschalten
Füge diese drei Zeilen ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
dbms.usage_report.enabled=false
dbms.fleet_manager.enabled=false
server.fleet_discovery.enabled=false
dbms.usage_report.enabled=false– Neo4j schickt keine anonymen Nutzungsdaten mehr an den Hersteller.dbms.fleet_manager.enabled=false– Schaltet die Anbindung an die Überwachung im Cloud-Dienst von Neo4j ab.server.fleet_discovery.enabled=false– Neo4j sendet keine Rundrufe mehr ins lokale Netz, mit denen sich Server gegenseitig finden.
12. Ordner für die Dienst-Ergänzung anlegen
Die Einstellung für Java gehört in eine Ergänzungsdatei (Drop-in) zum Dienst. So bleibt die Dienstdatei aus dem Paket unverändert und wird bei einem Update nicht überschrieben.
sudo mkdir -p /etc/systemd/system/neo4j.service.d
13. Java 21 für den Dienst festlegen
sudo nano /etc/systemd/system/neo4j.service.d/override.conf
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Service]
Environment=JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
JAVA_HOME zeigt auf das Java 21 aus Schritt 6. Das Startskript von Neo4j nimmt dann dieses Java, egal welche Version der Befehl java gerade startet.
14. systemd die Änderung mitteilen
systemd liest Dienstdateien nur beim Start oder auf Anweisung neu ein.
sudo systemctl daemon-reload
15. Dienst starten
sudo systemctl start neo4j
16. Prüfen, ob der Dienst läuft
Der Start dauert einige Sekunden.
systemctl status neo4j
Prüfen: In der Ausgabe steht active (running), und weiter unten erscheinen nach kurzer Zeit die Zeilen Bolt enabled on localhost:7687 und Started.. Beende die Anzeige mit q.
17. Prüfen, dass Neo4j nur lokal lauscht
sudo ss -ltnp | grep java
Prüfen: Es erscheinen zwei Zeilen mit 127.0.0.1:7474 und 127.0.0.1:7687 (davor kann [::ffff: stehen). Steht dort 0.0.0.0 oder *, wäre Neo4j aus dem Netz erreichbar.
18. Prüfen, welches Java läuft
sudo journalctl -u neo4j | grep -i "unsupported"
Prüfen: Der Befehl gibt nichts aus. Erscheint eine Warnung zu einer nicht unterstützten Java-Version, stimmt der Pfad in Schritt 13 nicht oder Schritt 14 wurde ausgelassen.
Erste Anmeldung
19. Kommandozeile öffnen
Neo4j legt den Benutzer neo4j mit dem Passwort neo4j an. Dieses Passwort gilt nur für die erste Anmeldung und muss sofort geändert werden.
cypher-shell -u neo4j
Bei password: gibst du neo4j ein. Die Eingabe ist nicht zu sehen.
20. Neues Passwort festlegen
Es erscheint Password change required. Gib bei new password: ein eigenes Passwort mit mindestens 8 Zeichen ein und wiederhole es bei confirm password:.
Prüfen: Es erscheint Connected to Neo4j … as user neo4j. und darunter eine Eingabezeile.
Steht ganz oben You are using an unsupported version of the Java runtime, ist eine neuere Java-Version als Standard eingestellt. cypher-shell funktioniert trotzdem, die Meldung kann man übergehen.
21. Kommandozeile verlassen
:exit
Ein kleines Bahnnetz anlegen
Das Beispiel legt einige Bahnhöfe zwischen Hamburg und Lübeck als Knoten an. Die Fahrten zwischen ihnen werden Beziehungen mit der Fahrzeit in Minuten.
Ein paar Begriffe aus Cypher:
(a:Ort {name: 'Ahrensburg'})– ein Knoten mit dem Etikett (Label)Ortund der Eigenschaftname. Der Buchstabeaist ein Platzhalter, über den man den Knoten in derselben Anweisung wieder ansprechen kann.-[:FAEHRT_NACH {minuten: 6}]->– eine Beziehung vom TypFAEHRT_NACHmit Richtung und einer Eigenschaft.CREATElegt an,MATCHsucht nach einem Muster,RETURNgibt das Ergebnis aus.
22. Übungsordner anlegen
mkdir -p ~/neo4j-uebung
23. In den Ordner wechseln
cd ~/neo4j-uebung
24. Datei mit dem Beispielnetz anlegen
nano bahn.cypher
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
CREATE CONSTRAINT ort_name IF NOT EXISTS
FOR (o:Ort) REQUIRE o.name IS UNIQUE;
CREATE (ahr:Ort {name: 'Ahrensburg'}),
(barg:Ort {name: 'Bargteheide'}),
(bad:Ort {name: 'Bad Oldesloe'}),
(hh:Ort {name: 'Hamburg Hbf'}),
(wand:Ort {name: 'Hamburg-Wandsbek'}),
(hl:Ort {name: 'Lübeck Hbf'}),
(hh)-[:FAEHRT_NACH {minuten: 9}]->(wand),
(wand)-[:FAEHRT_NACH {minuten: 10}]->(ahr),
(ahr)-[:FAEHRT_NACH {minuten: 6}]->(barg),
(barg)-[:FAEHRT_NACH {minuten: 8}]->(bad),
(bad)-[:FAEHRT_NACH {minuten: 15}]->(hl),
(hh)-[:FAEHRT_NACH {minuten: 40}]->(hl);
- Der erste Befehl sorgt dafür, dass jeder Ortsname nur einmal vorkommen darf. Gleichzeitig legt Neo4j dafür einen Index an, über den Orte schnell gefunden werden.
- Der zweite Befehl legt sechs Orte und sechs Verbindungen in einem Rutsch an. Die Fahrzeiten sind ausgedachte Beispielwerte.
25. Datei ausführen
-f liest die Befehle aus der Datei. Danach fragt cypher-shell nach dem Passwort aus Schritt 20.
cypher-shell -u neo4j -f bahn.cypher
Prüfen: Es erscheint keine Fehlermeldung. Bei einem zweiten Aufruf meldet Neo4j dagegen einen Fehler mit property uniqueness constraint violated, weil es Ahrensburg schon gibt. Die Regel aus dem ersten Befehl wirkt also.
Abfragen
26. Kommandozeile öffnen
cypher-shell -u neo4j
Jede Anweisung endet mit einem Semikolon. Erst dann führt cypher-shell sie aus.
27. Alle Orte anzeigen
MATCH (o:Ort) RETURN o.name ORDER BY o.name;
Prüfen: Es erscheinen sechs Orte in alphabetischer Reihenfolge.
28. Alle Verbindungen anzeigen
Das Muster beschreibt zwei Orte, zwischen denen ein Pfeil vom Typ FAEHRT_NACH liegt.
MATCH (a:Ort)-[f:FAEHRT_NACH]->(b:Ort)
RETURN a.name AS von, b.name AS nach, f.minuten AS minuten;
Prüfen: Die Tabelle hat sechs Zeilen, darunter "Ahrensburg" | "Bargteheide" | 6.
29. Erreichbare Orte finden
*1..3 bedeutet: ein bis drei Verbindungen hintereinander. So findet die Abfrage alle Orte, die von Ahrensburg aus mit höchstens drei Fahrten erreichbar sind.
MATCH (:Ort {name: 'Ahrensburg'})-[:FAEHRT_NACH*1..3]->(ziel)
RETURN DISTINCT ziel.name AS erreichbar;
Prüfen: Es erscheinen Bargteheide, Bad Oldesloe und Lübeck Hbf. Hamburg fehlt, weil die Pfeile nur in eine Richtung zeigen.
30. Alle Wege mit Fahrzeit vergleichen
->+ steht für eine oder beliebig viele Verbindungen. reduce addiert die Minuten aller Abschnitte eines Weges.
MATCH p = (:Ort {name: 'Hamburg Hbf'})-[:FAEHRT_NACH]->+(:Ort {name: 'Lübeck Hbf'})
RETURN [o IN nodes(p) | o.name] AS weg,
reduce(summe = 0, f IN relationships(p) | summe + f.minuten) AS minuten
ORDER BY minuten;
Prüfen: Es erscheinen zwei Wege: die direkte Verbindung mit 40 Minuten und der Weg über Wandsbek, Ahrensburg, Bargteheide und Bad Oldesloe mit 48 Minuten.
31. Einem Ort eine Eigenschaft hinzufügen
SET ändert oder ergänzt Eigenschaften. Neue Eigenschaften müssen vorher nirgends angemeldet werden.
MATCH (o:Ort {name: 'Bad Oldesloe'}) SET o.kreisstadt = true RETURN o;
Prüfen: Die Ausgabe zeigt (:Ort {kreisstadt: TRUE, name: "Bad Oldesloe"}).
32. Einen Ort samt Verbindungen löschen
Ein Knoten mit Beziehungen lässt sich nur zusammen mit diesen löschen. Das erledigt DETACH DELETE.
MATCH (o:Ort {name: 'Hamburg-Wandsbek'}) DETACH DELETE o;
33. Knoten zählen
MATCH (n) RETURN count(n) AS knoten;
Prüfen: Das Ergebnis ist 5.
34. Kommandozeile verlassen
:exit
Weboberfläche Neo4j Browser
35. Browser öffnen
Neo4j bringt eine Weboberfläche mit, die Ergebnisse auch als Grafik mit Kreisen und Pfeilen zeigt. Öffne im Browser diese Adresse:
http://localhost:7474/browser/
Es erscheint das Fenster „Connect to instance“. Die Adresse neo4j://localhost:7687 und der Benutzer neo4j sind schon eingetragen. Gib bei „Password“ das Passwort aus Schritt 20 ein und klicke auf Connect.
Prüfen: Gib oben in die Eingabezeile MATCH (o:Ort)-[f]->(z) RETURN o, f, z ein und starte die Abfrage mit Enter oder dem Startknopf daneben. Das Bahnnetz erscheint als Grafik.
Sichern und wiederherstellen
Die Community Edition kann eine Datenbank nur sichern, während der Dienst angehalten ist. Die Sicherung ist eine einzelne Datei.
36. Dienst anhalten
sudo systemctl stop neo4j
37. Ordner für Sicherungen anlegen
Die Sicherung schreibt der Benutzer neo4j, deshalb gehört ihm auch der Ordner.
sudo install -d -o neo4j -g neo4j /var/backups/neo4j
38. Sicherung anlegen
neo4j-admin ist das Verwaltungsprogramm. database dump neo4j sichert die Datenbank mit dem Namen neo4j, in der die Beispieldaten liegen. sudo -u neo4j führt den Befehl als Benutzer neo4j aus, damit die Dateirechte stimmen. JAVA_HOME sorgt wie in Schritt 13 für Java 21.
sudo -u neo4j JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 neo4j-admin database dump neo4j --to-path=/var/backups/neo4j
Prüfen: Die letzte Zeile lautet Dump completed successfully, und im Ordner liegt die Datei neo4j.dump.
ls -l /var/backups/neo4j
39. Dienst wieder starten
sudo systemctl start neo4j
Zum Wiederherstellen hältst du den Dienst an und spielst die Datei mit load zurück. --overwrite-destination=true ersetzt dabei den aktuellen Inhalt der Datenbank vollständig:
sudo -u neo4j JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 neo4j-admin database load neo4j --from-path=/var/backups/neo4j --overwrite-destination=true
Danach den Dienst wieder starten.
Optional: Autostart ausschalten
Neo4j belegt mit Java schnell ein bis zwei Gigabyte Arbeitsspeicher. Wer es nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start neo4j.
sudo systemctl disable --now neo4j
Wie geht es weiter?
- Arbeitsspeicher begrenzen: In
/etc/neo4j/neo4j.conflassen sich mitserver.memory.heap.max_sizeundserver.memory.pagecache.sizefeste Grenzen setzen. Ohne diese Angaben richtet sich Neo4j nach dem vorhandenen Arbeitsspeicher. - Aus Programmen zugreifen: Neo4j bietet offizielle Treiber für Python, Java, JavaScript, Go und .NET. In Python installiert man den Treiber in einer virtuellen Umgebung mit
pip install neo4j. - Schlüssel läuft ab: Der Signaturschlüssel von Neo4j ist bis Ende 2026 gültig. Meldet
sudo apt updatespäter einen abgelaufenen Schlüssel (EXPKEYSIG), lädst du ihn mit Schritt 3 neu herunter. - Andere Art von Graph: Für Wissensnetze nach dem Standard RDF mit der Abfragesprache SPARQL gibt es Apache Jena Fuseki.
- Dokumentation: Das Handbuch zu Cypher steht unter https://neo4j.com/docs/cypher-manual/current/.
Deinstallieren
1. Übungsordner und Befehlsverlauf löschen
~/.neo4j enthält den Verlauf der Befehle, die du in cypher-shell eingegeben hast.
rm -rf ~/neo4j-uebung ~/.neo4j
2. Dienst anhalten
sudo systemctl stop neo4j
3. Neo4j entfernen
Achtung: purge löscht ohne Nachfrage alle Datenbanken in /var/lib/neo4j und die Protokolle in /var/log/neo4j. Sicherungen in /var/backups/neo4j bleiben erhalten.
sudo apt purge neo4j cypher-shell
4. Übrige Abhängigkeiten entfernen
Entfernt Java 21 und die übrigen Pakete, die nur für Neo4j installiert wurden. apt listet sie auf und fragt vor dem Löschen nach. Ist ein Paket dabei, das du noch brauchst, brich mit n ab.
sudo apt autoremove --purge
5. Dienst-Ergänzung löschen
sudo rm -r /etc/systemd/system/neo4j.service.d
6. systemd die Änderung mitteilen
sudo systemctl daemon-reload
7. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/neo4j.sources /etc/apt/keyrings/neo4j.asc
8. Paketlisten aktualisieren
Danach kennt apt die Pakete von Neo4j nicht mehr.
sudo apt update
9. Sicherungen löschen (optional)
Achtung: Danach lassen sich die Daten nicht mehr wiederherstellen.
sudo rm -r /var/backups/neo4j
Prüfen: Der Befehl neo4j wird nicht mehr gefunden.
neo4j --version
Quellen und Lizenz
- Offizielle Dokumentation: https://neo4j.com/docs/
- Lizenz: Neo4j steht unter der GPL-3.0 (Community Edition).
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.
CouchDB
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Apache CouchDB ist eine Dokumentdatenbank: Statt Tabellen mit festen Spalten speichert sie einzelne Dokumente im JSON-Format, die jeweils eigene Felder haben dürfen. Angesprochen wird CouchDB ausschließlich über HTTP, also mit denselben Mitteln wie eine Webseite. Dadurch reichen curl oder ein Browser zum Arbeiten. Eine besondere Stärke ist der Abgleich (Replikation) zwischen mehreren CouchDB-Servern oder mit Apps, die offline arbeiten und ihre Änderungen später zurückspielen.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für CouchDB. Das Apache-CouchDB-Projekt betreibt aber ein eigenes apt-Archiv mit Paketen für Ubuntu 26.04. Nach dem Einbinden installiert und aktualisiert
aptCouchDB wie jedes andere Paket. - Warum nicht MongoDB: MongoDB ist die bekanntere Dokumentdatenbank, bietet aber (Stand Oktober 2026) noch keinen Server für Ubuntu 26.04 an.
- Nur lokal erreichbar: Mit den Antworten aus Schritt 7 lauscht CouchDB nur auf
127.0.0.1, Port 5984. Andere Rechner im Netz erreichen den Dienst nicht. - Mit Passwort: Bei der Installation wird der Verwalter
adminmit einem Passwort angelegt. Ohne Anmeldung darf man danach nur die Begrüßung des Servers abrufen. - Version: Getestet mit CouchDB 3.5.2 am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, curl brauchst du später für die Arbeit mit CouchDB, ca-certificates enthält die Zertifikate für verschlüsselte Verbindungen. Meist sind alle drei schon vorhanden.
sudo apt install wget curl ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von der Apache Software Foundation stammen und unterwegs nicht verändert wurden. Der Schlüssel liegt als Text vor, mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/couchdb.asc https://couchdb.apache.org/repo/keys.asc
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/couchdb.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/couchdb.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://apache.jfrog.io/artifactory/couchdb-deb
Suites: resolute
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/couchdb.asc
URIs– Das Archiv liegt bei einem Dienstleister der Apache Software Foundation.Suites: resolute– der Bereich für Ubuntu 26.04. Den Codenamen deines Systems zeigtgrep VERSION_CODENAME /etc/os-release.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 angenommen.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von CouchDB herunter.
sudo apt update
Prüfen: Der Installationskandidat ist eine Version wie 3.5.2.1~resolute.
apt policy couchdb
Installation
6. Ein zufälliges Cookie erzeugen
CouchDB fragt bei der Installation nach einem Cookie. Das ist ein gemeinsames Geheimnis, mit dem sich mehrere CouchDB-Server eines Verbunds gegenseitig ausweisen. Auch ein einzelner Server braucht einen Wert. Dieser Befehl erzeugt eine zufällige Zeichenfolge aus 32 Zeichen:
openssl rand -hex 16
Lass die Ausgabe im Terminal stehen. Du kopierst sie im nächsten Schritt.
7. CouchDB installieren
Installiert CouchDB und eine JavaScript-Bibliothek, mit der CouchDB eigene Auswertungen ausführt.
sudo apt install couchdb
Während der Installation erscheinen nacheinander fünf Fragen auf Englisch. Mit Tab springst du auf
- General type of CouchDB configuration – Wähle
standalone. Damit läuft CouchDB als einzelner Server.clusteredist für einen Verbund aus mehreren Servern gedacht. - CouchDB Erlang magic cookie – Füge die Zeichenfolge aus Schritt 6 ein (Strg+Umschalt+V).
- CouchDB interface bind address – Lass
127.0.0.1stehen. So ist CouchDB nur von diesem Rechner aus erreichbar. - Password for the CouchDB "admin" user – Gib ein eigenes, langes Passwort ein. Die Eingabe ist nicht zu sehen.
- Repeat password – Gib dasselbe Passwort noch einmal ein.
Danach startet der Dienst sofort und künftig bei jedem Hochfahren.
8. Prüfen, ob der Dienst läuft
systemctl status couchdb
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
9. Prüfen, dass CouchDB nur lokal lauscht
sudo ss -ltnp | grep -E 'beam|epmd'
Prüfen: Alle Zeilen enthalten 127.0.0.1 oder [::1]. Neben Port 5984 erscheinen Port 4369 und ein zufälliger hoher Port. Diese gehören zur Laufzeitumgebung Erlang, in der CouchDB geschrieben ist, und dienen der Verbindung zwischen Servern eines Verbunds.
10. Begrüßung abrufen
Diese Adresse ist auch ohne Anmeldung erreichbar.
curl http://127.0.0.1:5984/
Prüfen: Die Antwort beginnt mit {"couchdb":"Welcome","version":"3.5.2".
Anmeldedaten hinterlegen
Jeder weitere Aufruf braucht Benutzer und Passwort. Damit das Passwort nicht bei jedem Befehl auf dem Bildschirm und im Befehlsverlauf landet, legst du es in einer Datei ab, die nur du lesen darfst.
11. Datei anlegen
nano ~/.couchdb-netrc
Füge diesen Inhalt ein (Strg+Umschalt+V) und ersetze DEIN-PASSWORT durch das Passwort aus Schritt 7. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
machine 127.0.0.1
login admin
password DEIN-PASSWORT
Das Format heißt netrc. curl sucht darin nach der Zeile machine mit der aufgerufenen Adresse und meldet sich mit login und password an.
12. Datei schützen
Nur du darfst die Datei lesen und ändern.
chmod 600 ~/.couchdb-netrc
13. Anmeldung testen
--netrc-file nennt curl die Datei mit den Anmeldedaten. _all_dbs listet alle Datenbanken auf.
curl --netrc-file ~/.couchdb-netrc http://127.0.0.1:5984/_all_dbs
Prüfen: Die Antwort lautet ["_replicator","_users"]. Diese beiden Datenbanken legt CouchDB für sich selbst an. Ohne --netrc-file antwortet CouchDB mit You are not a server admin.
Eine Gartendatenbank anlegen
Das Beispiel verwaltet die Pflanzen eines kleinen Gartens. Jede Pflanze ist ein Dokument mit Name, Art, Beet und dem Monat der Aussaat.
14. Übungsordner anlegen
mkdir -p ~/couchdb-uebung
15. In den Ordner wechseln
cd ~/couchdb-uebung
16. Datenbank anlegen
In CouchDB legt ein PUT auf eine neue Adresse etwas an. Hier entsteht die Datenbank garten.
curl --netrc-file ~/.couchdb-netrc -X PUT http://127.0.0.1:5984/garten
Prüfen: Die Antwort lautet {"ok":true}. Ein zweiter Aufruf liefert den Fehler file_exists.
17. Datei mit den Pflanzen anlegen
nano garten.json
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
{"docs": [
{"_id": "tomate", "name": "Tomate", "art": "Gemüse", "beet": "Süd", "aussaat": 3},
{"_id": "zucchini", "name": "Zucchini", "art": "Gemüse", "beet": "Süd", "aussaat": 4},
{"_id": "moehre", "name": "Möhre", "art": "Gemüse", "beet": "Nord", "aussaat": 4},
{"_id": "basilikum", "name": "Basilikum", "art": "Kräuter", "beet": "Süd", "aussaat": 4},
{"_id": "petersilie", "name": "Petersilie", "art": "Kräuter", "beet": "Nord", "aussaat": 3}
]}
_id ist die eindeutige Kennung eines Dokuments. Fehlt sie, vergibt CouchDB selbst eine lange Zufallskennung. Alle anderen Felder sind frei wählbar.
18. Alle Pflanzen auf einmal speichern
_bulk_docs nimmt mehrere Dokumente in einem Aufruf an. -d @garten.json schickt den Inhalt der Datei mit, Content-Type sagt CouchDB, dass es sich um JSON handelt.
curl --netrc-file ~/.couchdb-netrc -X POST http://127.0.0.1:5984/garten/_bulk_docs -H 'Content-Type: application/json' -d @garten.json
Prüfen: Die Antwort enthält fünfmal "ok":true, jeweils mit id und rev.
19. Ein Dokument lesen
Jedes Dokument hat eine eigene Adresse aus Datenbank und Kennung.
curl --netrc-file ~/.couchdb-netrc http://127.0.0.1:5984/garten/tomate
Prüfen: Die Antwort enthält die Felder aus Schritt 17 und zusätzlich _rev, z. B. "_rev":"1-bf55…". Das ist die Revision: Die Zahl vor dem Bindestrich zählt die Änderungen, der Rest ist eine Prüfsumme.
20. Ändern ohne Revision versuchen
Die Tomate soll schon im Februar (Monat 2) ausgesät werden. Ein PUT auf die Adresse des Dokuments ersetzt es vollständig.
curl --netrc-file ~/.couchdb-netrc -X PUT http://127.0.0.1:5984/garten/tomate -H 'Content-Type: application/json' -d '{"name": "Tomate", "art": "Gemüse", "beet": "Süd", "aussaat": 2}'
Prüfen: CouchDB lehnt mit Document update conflict ab. Wer ein Dokument ändern will, muss angeben, welche Revision er geändert hat. So kann niemand versehentlich die Änderung eines anderen überschreiben, die zwischen Lesen und Schreiben gespeichert wurde.
21. Ändern mit Revision
Ersetze REVISION durch den Wert von _rev aus Schritt 19, z. B. 1-bf5583091cf9b529c7ed1ae4dd02a367.
curl --netrc-file ~/.couchdb-netrc -X PUT http://127.0.0.1:5984/garten/tomate -H 'Content-Type: application/json' -d '{"_rev": "REVISION", "name": "Tomate", "art": "Gemüse", "beet": "Süd", "aussaat": 2}'
Prüfen: Die Antwort enthält "ok":true und eine neue Revision, die mit 2- beginnt.
Abfragen
22. Nach einem Feld suchen
_find sucht mit der Abfragesprache Mango. Im selector steht, welche Werte ein Dokument haben muss, fields wählt die Felder der Antwort aus.
curl --netrc-file ~/.couchdb-netrc -X POST http://127.0.0.1:5984/garten/_find -H 'Content-Type: application/json' -d '{"selector": {"art": "Kräuter"}, "fields": ["name", "beet"]}'
Prüfen: Es erscheinen Basilikum und Petersilie. Darunter steht der Hinweis No matching index found: CouchDB musste alle Dokumente durchsehen. Bei fünf Pflanzen ist das egal, bei Millionen Dokumenten nicht.
23. Sortiert suchen
$lt bedeutet „kleiner als“. Gesucht sind alle Pflanzen, die vor April ausgesät werden, sortiert nach Monat.
curl --netrc-file ~/.couchdb-netrc -X POST http://127.0.0.1:5984/garten/_find -H 'Content-Type: application/json' -d '{"selector": {"aussaat": {"$lt": 4}}, "fields": ["name", "aussaat"], "sort": [{"aussaat": "asc"}]}'
Prüfen: CouchDB antwortet mit dem Fehler no_usable_index. Zum Sortieren braucht CouchDB einen Index über das Feld.
24. Index anlegen
Der Index ordnet die Dokumente nach dem Feld aussaat.
curl --netrc-file ~/.couchdb-netrc -X POST http://127.0.0.1:5984/garten/_index -H 'Content-Type: application/json' -d '{"index": {"fields": ["aussaat"]}, "name": "nach-aussaat"}'
Prüfen: Die Antwort enthält "result":"created". Wiederhole jetzt den Befehl aus Schritt 23: Es erscheinen die Tomate mit Monat 2 und die Petersilie mit Monat 3.
25. Datei für eine Auswertung anlegen
Für Auswertungen wie „wie viele Pflanzen stehen in jedem Beet?“ nutzt CouchDB Views. Ein View besteht aus einer kleinen JavaScript-Funktion, die CouchDB für jedes Dokument ausführt. Views werden in einem besonderen Dokument gespeichert, dem Design-Dokument.
nano auswertung.json
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
{
"views": {
"nach_beet": {
"map": "function (doc) { if (doc.beet) { emit(doc.beet, doc.name); } }",
"reduce": "_count"
}
}
}
map– Die Funktion gibt für jedes Dokument mit einem Beet ein Paar aus: das Beet als Schlüssel und den Namen als Wert.reduce–_countist eine eingebaute Funktion, die die Paare je Schlüssel zählt.
26. Design-Dokument speichern
Design-Dokumente beginnen immer mit _design/.
curl --netrc-file ~/.couchdb-netrc -X PUT http://127.0.0.1:5984/garten/_design/auswertung -H 'Content-Type: application/json' -d @auswertung.json
Prüfen: Die Antwort enthält "ok":true.
27. Pflanzen je Beet zählen
group=true fasst die Ergebnisse je Schlüssel zusammen. Die Adresse steht in Anführungszeichen, weil die Shell das Zeichen ? sonst selbst auswerten würde.
curl --netrc-file ~/.couchdb-netrc "http://127.0.0.1:5984/garten/_design/auswertung/_view/nach_beet?group=true"
Prüfen: Die Antwort lautet {"key":"Nord","value":2} und {"key":"Süd","value":3}.
28. Pflanzen eines Beets auflisten
reduce=false schaltet das Zählen ab und zeigt die einzelnen Paare. -G hängt die Angaben an die Adresse an, --data-urlencode wandelt dabei das ü und die Anführungszeichen in eine für Adressen erlaubte Form um.
curl --netrc-file ~/.couchdb-netrc -G http://127.0.0.1:5984/garten/_design/auswertung/_view/nach_beet --data-urlencode 'key="Süd"' -d reduce=false
Prüfen: Es erscheinen Basilikum, Tomate und Zucchini.
29. Revision der Zucchini abfragen
Auch zum Löschen braucht CouchDB die aktuelle Revision.
curl --netrc-file ~/.couchdb-netrc http://127.0.0.1:5984/garten/zucchini
30. Dokument löschen
Ersetze REVISION durch den Wert von _rev aus Schritt 29.
curl --netrc-file ~/.couchdb-netrc -X DELETE "http://127.0.0.1:5984/garten/zucchini?rev=REVISION"
Prüfen: Rufst du Schritt 29 noch einmal auf, antwortet CouchDB mit {"error":"not_found","reason":"deleted"}. CouchDB merkt sich gelöschte Dokumente, damit die Löschung bei einer Replikation auch auf anderen Servern ankommt.
Weboberfläche Fauxton
31. Fauxton öffnen
CouchDB bringt die Weboberfläche Fauxton mit. Dort lassen sich Datenbanken, Dokumente und Views ansehen und bearbeiten. Öffne im Browser diese Adresse:
http://127.0.0.1:5984/_utils/
Melde dich bei „Log In to CouchDB“ mit dem Benutzer admin und dem Passwort aus Schritt 7 an.
Prüfen: In der Liste der Datenbanken erscheint garten. Ein Klick darauf zeigt die gespeicherten Pflanzen.
Sichern und wiederherstellen
CouchDB speichert alle Datenbanken als Dateien in /var/lib/couchdb. Bei angehaltenem Dienst lässt sich der Ordner einfach als Archiv sichern.
32. Dienst anhalten
sudo systemctl stop couchdb
33. Sicherung anlegen
tar packt den Ordner in eine Archivdatei. -C /var/lib wechselt vorher in den Elternordner, damit im Archiv nur couchdb/… steht und nicht der ganze Pfad.
sudo tar -czf /var/backups/couchdb.tar.gz -C /var/lib couchdb
Prüfen: Die Datei ist vorhanden.
ls -l /var/backups/couchdb.tar.gz
34. Dienst wieder starten
sudo systemctl start couchdb
Zum Wiederherstellen hältst du den Dienst an, löschst den Ordner mit sudo rm -r /var/lib/couchdb, packst das Archiv mit sudo tar -xzf /var/backups/couchdb.tar.gz -C /var/lib wieder aus und startest den Dienst. tar stellt dabei auch den Besitzer couchdb der Dateien wieder her. Achtung: Alles, was nach der Sicherung gespeichert wurde, ist danach weg.
Optional: Autostart ausschalten
Wer CouchDB nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start couchdb.
sudo systemctl disable --now couchdb
Wie geht es weiter?
- Eigene Benutzer: Für Anwendungen sollte man nicht den Verwalter
adminverwenden, sondern eigene Benutzer in der Datenbank_usersanlegen und ihnen in den Einstellungen einer Datenbank (Permissions in Fauxton) Rechte geben. - Replikation: Mit
_replicateoder in Fauxton unter „Replication“ gleicht CouchDB Datenbanken zwischen Servern ab, einmalig oder dauerhaft. Die JavaScript-Bibliothek PouchDB nutzt dasselbe Verfahren, damit Web-Apps offline arbeiten können. - Zugriff aus dem Netz: Dann sollte ein nginx mit HTTPS vor CouchDB stehen, und CouchDB bleibt auf
127.0.0.1. - Volltextsuche: Das Zusatzpaket
couchdb-nouveauaus demselben Archiv ergänzt eine Volltextsuche. Es braucht Java 21. - Dokumentation: Das Handbuch steht unter https://docs.couchdb.org/en/stable/.
Deinstallieren
1. Übungsordner und Anmeldedatei löschen
rm -rf ~/couchdb-uebung ~/.couchdb-netrc
2. CouchDB entfernen
sudo apt purge couchdb
Beim Entfernen fragt ein Dialog „Remove all CouchDB databases?“. Voreingestellt ist /var/lib/couchdb bleiben liegen und stehen bei einer neuen Installation wieder zur Verfügung. Wer alles löschen will, wählt mit Tab couchdb und seine Gruppe entfernt. Die Konfiguration in /opt/couchdb/etc und die Protokolle löscht purge in jedem Fall.
3. Übrige Abhängigkeiten entfernen
Entfernt die JavaScript-Bibliothek, die nur für CouchDB installiert wurde. 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
4. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/couchdb.sources /etc/apt/keyrings/couchdb.asc
5. Paketlisten aktualisieren
Danach kennt apt die Pakete von CouchDB nicht mehr.
sudo apt update
6. Sicherung löschen (optional)
Achtung: Danach lassen sich die Daten nicht mehr wiederherstellen.
sudo rm /var/backups/couchdb.tar.gz
Prüfen: Der Dienst ist unbekannt.
systemctl status couchdb
Die Ausgabe lautet Unit couchdb.service could not be found.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.couchdb.org/
- Lizenz: Apache CouchDB steht unter der Apache-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.
Grafana
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Grafana zeigt Messwerte und andere Daten als Diagramme, Anzeigen und Tabellen in übersichtlichen Dashboards im Browser. Es speichert die Daten nicht selbst, sondern fragt sie bei Datenquellen ab, etwa bei InfluxDB, PostgreSQL, MySQL oder ClickHouse. So lassen sich z. B. Raumtemperaturen, Stromverbrauch oder die Auslastung eines Servers über Stunden und Monate verfolgen. Diese Anleitung installiert Grafana als Dienst, schaltet die Datenübertragung an den Hersteller ab und baut mit eingebauten Testdaten ein erstes Dashboard.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für Grafana. Der Hersteller Grafana Labs betreibt aber ein eigenes, signiertes apt-Archiv. Nach dem Einbinden installiert und aktualisiert
aptGrafana wie jedes andere Paket. - Nur lokal erreichbar: Ohne Anpassung lauscht Grafana auf allen Netzwerkschnittstellen. Schritt 9 beschränkt das vor dem ersten Start auf
127.0.0.1. - Datenübertragung: In der Grundeinstellung meldet Grafana Nutzungsdaten an den Hersteller, sucht nach Updates und lädt Neuigkeiten. Schritt 9 schaltet das ab.
- Port 3000: Grafana verwendet Port 3000. Läuft auf dem Rechner schon ein anderes Programm auf diesem Port, z. B. Martin, nimmst du in Schritt 9 eine andere Zahl wie
3001und ersetzt3000in den folgenden Schritten entsprechend. - Englische Oberfläche: Grafana startet auf Englisch. Die Anleitung nennt deshalb die englischen Bezeichnungen. Eine teilweise deutsche Oberfläche lässt sich später im Profil einstellen.
- Größe: Der Download ist rund 380 MB groß, ausgepackt belegt Grafana etwa 1,3 GB. Im Betrieb braucht es rund 350 MB Arbeitsspeicher.
- Version: Getestet mit Grafana 13.2.3 (Open-Source-Ausgabe) am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.
sudo apt install wget ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Grafana Labs stammen und unterwegs nicht verändert wurden. Mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg.key
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/grafana.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/grafana.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://apt.grafana.com
Suites: stable
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/grafana.asc
Suites: stable enthält die fertigen Versionen. Das Archiv ist für alle Ubuntu- und Debian-Versionen gleich.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von Grafana herunter.
sudo apt update
Prüfen: Der Installationskandidat ist eine Version wie 13.2.3.
apt policy grafana
Installation
6. Grafana installieren
Das Paket grafana ist die freie Open-Source-Ausgabe. Es legt den Dienst grafana-server an, startet ihn aber noch nicht.
sudo apt install grafana
Prüfen: Am Ende der Ausgabe steht ### NOT starting on installation.
7. Version prüfen
grafana --version
Prüfen: Es erscheint grafana version 13.2.3 oder eine höhere Nummer.
Vor dem ersten Start einrichten
Die Einstellungen von Grafana stehen in der sehr langen Datei /etc/grafana/grafana.ini. Jede Einstellung lässt sich aber auch über eine Umgebungsvariable der Form GF_ABSCHNITT_NAME setzen. Diese Anleitung legt die Variablen in einer Ergänzungsdatei (Drop-in) zum Dienst ab. So bleibt grafana.ini unverändert, und bei Updates gibt es keine Rückfragen zu geänderten Konfigurationsdateien.
8. Ordner für die Dienst-Ergänzung anlegen
sudo mkdir -p /etc/systemd/system/grafana-server.service.d
9. Ergänzungsdatei anlegen
sudo nano /etc/systemd/system/grafana-server.service.d/override.conf
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Service]
Environment=GF_SERVER_HTTP_ADDR=127.0.0.1
Environment=GF_SERVER_HTTP_PORT=3000
Environment=GF_ANALYTICS_REPORTING_ENABLED=false
Environment=GF_ANALYTICS_CHECK_FOR_UPDATES=false
Environment=GF_ANALYTICS_CHECK_FOR_PLUGIN_UPDATES=false
Environment=GF_NEWS_NEWS_FEED_ENABLED=false
GF_SERVER_HTTP_ADDR– Grafana nimmt Verbindungen nur von diesem Rechner an.GF_SERVER_HTTP_PORT– der Port der Weboberfläche.GF_ANALYTICS_REPORTING_ENABLED– keine Nutzungsdaten an den Hersteller.GF_ANALYTICS_CHECK_FOR_UPDATESund…_PLUGIN_UPDATES– keine Abfrage nach neuen Versionen. Updates kommen überapt.GF_NEWS_NEWS_FEED_ENABLED– keine Neuigkeiten von grafana.com auf der Startseite.
10. Testdaten-Quelle anlegen
Grafana bringt eine Datenquelle mit, die zufällige Messkurven erzeugt. Damit lässt sich ein Dashboard ausprobieren, ohne eine Datenbank anzuschließen. Dateien im Ordner provisioning/datasources legt Grafana beim Start als Datenquellen an.
sudo nano /etc/grafana/provisioning/datasources/testdaten.yaml
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
apiVersion: 1
datasources:
- name: Testdaten
type: grafana-testdata-datasource
isDefault: true
name– der Name, unter dem die Quelle in Grafana erscheint.type– die eingebaute Quelle für Testdaten.isDefault: true– neue Diagramme verwenden diese Quelle, solange keine andere gewählt wird.
Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben.
11. systemd die Änderung mitteilen
sudo systemctl daemon-reload
12. Dienst starten und für den Systemstart anmelden
enable --now erledigt beides auf einmal.
sudo systemctl enable --now grafana-server
13. Prüfen, ob der Dienst läuft
Der erste Start dauert einige Sekunden, weil Grafana seine Datenbank anlegt.
systemctl status grafana-server
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
14. Prüfen, dass die Einstellungen wirken
Grafana schreibt beim Start jede übernommene Umgebungsvariable ins Protokoll.
sudo journalctl -u grafana-server | grep "Config overridden from Environment"
Prüfen: Für jede der sechs Variablen aus Schritt 9 erscheint eine Zeile. Nach mehreren Starts stehen die Zeilen entsprechend öfter da.
15. Prüfen, dass Grafana nur lokal lauscht
sudo ss -ltnp | grep grafana
Prüfen: Es erscheint eine Zeile mit 127.0.0.1:3000.
16. Zustand abfragen
curl http://127.0.0.1:3000/api/health
Prüfen: Die Antwort enthält "database": "ok" und die Versionsnummer.
Erste Anmeldung
17. Grafana im Browser öffnen
http://127.0.0.1:3000/
18. Mit dem Startpasswort anmelden
Grafana legt den Verwalter admin mit dem Passwort admin an. Gib bei Email or username admin und bei Password admin ein und klicke auf Log in.
19. Eigenes Passwort festlegen
Es erscheint Update your password. Gib bei New password und Confirm new password ein eigenes, langes Passwort ein und klicke auf Submit. Den Knopf Skip nicht verwenden, sonst bleibt das unsichere Passwort admin bestehen.
Prüfen: Es erscheint die Startseite mit Welcome to Grafana.
Ein erstes Dashboard
20. Neues Dashboard anlegen
Klicke links auf Dashboards und dann oben rechts auf New und im aufklappenden Menü auf New dashboard.
Prüfen: In der Mitte steht New dashboard, rechts ist der Bereich Add geöffnet.
21. Panel hinzufügen
Ein Panel ist ein einzelnes Diagramm oder eine Anzeige im Dashboard. Klicke rechts unter Panel auf das Feld mit der Kurve und dem Pluszeichen (Drag or click to add a panel).
Prüfen: Links erscheint ein leeres Panel New panel mit dem Knopf Configure visualization.
22. Panel einrichten
Klicke auf Configure visualization.
Prüfen: Der Editor öffnet sich. Oben ist sofort eine Kurve zu sehen. Darunter steht bei Data source die Quelle Testdaten und bei Scenario Random Walk, eine zufällig auf und ab laufende Messreihe.
23. Darstellung ausprobieren
Rechts stehen unter Suggestions Vorschläge für die Darstellung, z. B. Time series (Kurve), Stat (große Zahl mit dem letzten Wert) und Gauge (Zeigerinstrument). Ein Klick auf einen Vorschlag übernimmt ihn.
24. Dashboard speichern
Klicke oben rechts auf Save. Ersetze im Feld Title den Text New dashboard durch Erstes Dashboard und klicke auf Save.
25. Zum Dashboard zurückkehren
Klicke oben rechts auf Back. Das Dashboard zeigt jetzt das Panel. Oben rechts lässt sich mit Last 6 hours der Zeitraum ändern.
Prüfen: Unter Dashboards steht in der Liste Erstes Dashboard.
26. Oberfläche auf Deutsch stellen (optional)
Klicke oben rechts auf das runde Benutzersymbol und dann auf Profile. Wähle unter Preferences bei Language Deutsch und klicke auf Save preferences. Menüs und viele Dialoge erscheinen danach auf Deutsch, einige Bereiche bleiben englisch.
Sichern und wiederherstellen
Grafana speichert Benutzer, Dashboards und Datenquellen in der SQLite-Datei /var/lib/grafana/grafana.db.
27. Dienst anhalten
sudo systemctl stop grafana-server
28. Datenbank kopieren
-a erhält Besitzer und Rechte der Datei.
sudo cp -a /var/lib/grafana/grafana.db /var/backups/grafana.db
29. Dienst wieder starten
sudo systemctl start grafana-server
Zum Wiederherstellen hältst du den Dienst an, kopierst die Datei mit sudo cp -a /var/backups/grafana.db /var/lib/grafana/grafana.db zurück und startest den Dienst. Achtung: Alles, was nach der Sicherung geändert wurde, ist danach weg.
Einzelne Dashboards lassen sich außerdem als JSON-Datei sichern: In der schmalen Leiste rechts im Dashboard das Symbol Export (Pfeil nach unten) und dann Export as code wählen. Eingelesen wird die Datei über Dashboards → New → Import dashboard.
Optional: Autostart ausschalten
Wer Grafana nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start grafana-server.
sudo systemctl disable --now grafana-server
Wie geht es weiter?
- Echte Daten anschließen: Unter Connections → Add new connection stehen Datenquellen wie InfluxDB, PostgreSQL, MySQL und Prometheus zur Auswahl. Für InfluxDB 3 wählst du InfluxDB mit der Abfragesprache SQL und gibst das Token aus der InfluxDB-Anleitung an.
- Passwort vergessen:
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password NEUES-PASSWORTsetzt das Passwort vonadminneu. Das Passwort steht danach im Befehlsverlauf, ändere es deshalb gleich im Profil. - Zugriff aus dem Netz: Dann sollte ein nginx mit HTTPS vor Grafana stehen, und Grafana bleibt auf
127.0.0.1. - Dokumentation: https://grafana.com/docs/grafana/latest/
Deinstallieren
1. Dienst anhalten und abmelden
sudo systemctl disable --now grafana-server
2. Grafana entfernen
apt meldet dabei, dass /etc/grafana nicht leer ist. Diese Reste löscht Schritt 5.
sudo apt purge grafana
3. Dienst-Ergänzung löschen
sudo rm -r /etc/systemd/system/grafana-server.service.d
4. systemd die Änderung mitteilen
sudo systemctl daemon-reload
5. Übrige Dateien löschen
Das Paket räumt beim Entfernen nicht vollständig auf. Dieser Befehl löscht die Konfiguration samt Testdaten-Quelle, die Datenbank mit allen Dashboards und Benutzern sowie die Protokolle. Achtung: Alle Dashboards sind danach unwiderruflich weg.
sudo rm -rf /etc/grafana /var/lib/grafana /var/log/grafana
6. Systembenutzer entfernen
Die Installation hat den Benutzer grafana und eine gleichnamige Gruppe angelegt.
sudo deluser grafana
7. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/grafana.sources /etc/apt/keyrings/grafana.asc
8. Paketlisten aktualisieren
Danach kennt apt die Pakete von Grafana nicht mehr.
sudo apt update
9. Sicherung löschen (optional)
sudo rm -f /var/backups/grafana.db
Prüfen: Der Befehl grafana wird nicht mehr gefunden.
grafana --version
Quellen und Lizenz
- Offizielle Dokumentation: https://grafana.com/docs/grafana/latest/
- Lizenz: Grafana steht unter der AGPL-3.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.
Prometheus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Prometheus sammelt laufend Messwerte von Rechnern und Programmen und legt sie als Zeitreihen ab: etwa freien Arbeitsspeicher, Prozessorlast, Plattenplatz oder die Zahl der Anfragen an einen Webserver. Es fragt die Werte in festen Abständen selbst ab, wertet sie mit der Abfragesprache PromQL aus und meldet mit Regeln, wenn etwas aus dem Ruder läuft. Zusammen mit Grafana entstehen daraus übersichtliche Dashboards. Diese Anleitung installiert Prometheus und den Node Exporter, der die Werte des eigenen Rechners liefert, beschränkt beide auf den eigenen Rechner und richtet eine erste Alarmregel ein.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Prometheus 2.53 und den Node Exporter 1.10 direkt in den eigenen Paketquellen. Prometheus 2.53 ist die letzte Ausgabe der Reihe 2 mit langer Pflege. Die neuere Reihe 3 gibt es nur direkt beim Projekt.
- Ohne Zusatzwerkzeuge: Der Node Exporter empfiehlt ein Paket mit weiteren Messskripten, das Werkzeuge für Festplattenzustand (SMART), NVMe und Server-Fernwartung (IPMI) mitbringt. Schritt 2 lässt diese Empfehlungen mit
--no-install-recommendsweg. Statt 30 werden so 14 Pakete installiert. - Sofort erreichbar: Beide Dienste starten direkt nach der Installation und lauschen zunächst auf allen Netzwerkschnittstellen, Prometheus auf Port 9090, der Node Exporter auf Port 9100. Die Schritte 4 bis 9 beschränken sie auf
127.0.0.1. Erledige diese Schritte daher gleich nach der Installation. - Ohne Anmeldung: Prometheus und der Node Exporter haben keine Benutzerverwaltung. Jeder, der den Port erreicht, sieht alle Messwerte. Auch deshalb bleiben sie auf
127.0.0.1. - Klassische Weboberfläche: Das Ubuntu-Paket enthält nicht die aktuelle Weboberfläche des Projekts, sondern nur die ältere, einfachere unter
/classic/. Für Diagramme ist ohnehin Grafana üblich. - Version: Getestet mit Prometheus 2.53.5 und Node Exporter 1.10.2 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Prometheus und Node Exporter installieren
promtool, ein Prüfwerkzeug für die Konfiguration, kommt automatisch mit.
sudo apt install --no-install-recommends prometheus prometheus-node-exporter
3. Version prüfen
prometheus --version
Prüfen: Die erste Zeile beginnt mit prometheus, version 2.53.5.
Auf den eigenen Rechner beschränken
Beide Dienste lesen ihre Startoptionen aus einer Datei in /etc/default. Dort steht jeweils eine leere Zeile ARGS="".
4. Startoptionen des Node Exporters öffnen
sudo nano /etc/default/prometheus-node-exporter
5. Adresse des Node Exporters festlegen
Suche mit Strg+W nach ARGS= und drücke Enter. Ersetze die gefundene Zeile ARGS="" durch diese Zeile:
ARGS="--web.listen-address=127.0.0.1:9100"
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Startoptionen von Prometheus öffnen
sudo nano /etc/default/prometheus
7. Adresse von Prometheus festlegen
Suche mit Strg+W nach ARGS= und drücke Enter. Ersetze die gefundene Zeile ARGS="" durch diese Zeile:
ARGS="--web.listen-address=127.0.0.1:9090"
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Beide Dienste neu starten
Die Dienste lesen die Startoptionen nur beim Start.
sudo systemctl restart prometheus-node-exporter prometheus
9. Prüfen, dass beide nur lokal lauschen
sudo ss -ltnp | grep prometheus
Prüfen: Es erscheinen zwei Zeilen mit 127.0.0.1:9090 und 127.0.0.1:9100. Steht dort noch *:9090 oder *:9100, ist die Zeile in Schritt 5 oder 7 nicht richtig gespeichert.
10. Messwerte des Node Exporters ansehen
Der Node Exporter liefert seine Werte als einfachen Text unter /metrics, mehrere hundert Zeilen. grep zeigt nur die Zeile mit dem freien Arbeitsspeicher.
curl -s http://127.0.0.1:9100/metrics | grep '^node_memory_MemAvailable_bytes'
Prüfen: Es erscheint eine Zeile mit node_memory_MemAvailable_bytes und dem freien Arbeitsspeicher in Byte, geschrieben in Exponentialschreibweise, z. B. 1.2555706368e+10 für rund 12,5 Milliarden Byte.
11. Abfrageziele prüfen
Die mitgelieferte Konfiguration /etc/prometheus/prometheus.yml lässt Prometheus alle 15 Sekunden sich selbst (job="prometheus") und den Node Exporter (job="node") abfragen. Die Kennzahl up ist 1, wenn die letzte Abfrage geklappt hat.
curl -s http://127.0.0.1:9090/api/v1/query --data-urlencode 'query=up'
Prüfen: Die Antwort enthält zweimal "1", einmal bei "job":"prometheus" und einmal bei "job":"node". Steht direkt nach dem Neustart noch nichts da, warte 30 Sekunden und wiederhole den Befehl.
Abfragen in der Weboberfläche
12. Weboberfläche öffnen
http://127.0.0.1:9090/classic/graph
Prüfen: Oben steht Prometheus mit den Menüpunkten Alerts, Graph, Status und Help, darunter ein Eingabefeld und der Knopf Execute.
Die Startseite http://127.0.0.1:9090/ erklärt nur, dass die neue Oberfläche im Ubuntu-Paket fehlt, und verweist mit Use classic web UI auf diese Seite.
13. Freien Arbeitsspeicher in Prozent abfragen
Gib in das Eingabefeld diese Abfrage ein und klicke auf Execute:
round(node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes * 100)
Prüfen: Im Reiter Console erscheint eine Zeile mit job="node" und einer Zahl, dem freien Arbeitsspeicher in Prozent. Der Reiter Graph zeigt den Verlauf.
14. Weitere Abfragen ausprobieren
Ersetze den Inhalt des Eingabefelds jeweils durch eine dieser Zeilen und klicke auf Execute:
- Prozessorauslastung in Prozent über die letzte Minute:
round(100 - avg(rate(node_cpu_seconds_total{mode="idle"}[1m])) * 100) - Freier Platz auf der Systempartition in Gigabyte:
round(node_filesystem_avail_bytes{mountpoint="/"} / 1e9) - Empfangene Byte pro Sekunde je Netzwerkkarte:
round(rate(node_network_receive_bytes_total{device!="lo"}[1m])) - Zahl der Prozessorkerne:
count(node_cpu_seconds_total{mode="idle"})
Was die Bausteine bedeuten:
{mode="idle"}wählt nur die Werte mit diesem Merkmal aus,!=schließt Werte aus.[1m]nimmt die Werte der letzten Minute.rate(…)rechnet aus einem stetig steigenden Zähler die Zunahme pro Sekunde aus.
Prüfen: Jede Abfrage liefert mindestens eine Zeile mit einer Zahl.
Eine Alarmregel einrichten
15. Regeldatei anlegen
sudo nano /etc/prometheus/regeln.yml
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
groups:
- name: rechner
rules:
- alert: ExporterNichtErreichbar
expr: up == 0
for: 1m
annotations:
summary: "{{ $labels.job }} ist seit einer Minute nicht erreichbar"
- alert: WenigPlatzAufSystemplatte
expr: node_filesystem_avail_bytes{mountpoint="/"} / node_filesystem_size_bytes{mountpoint="/"} * 100 < 10
for: 5m
annotations:
summary: "Auf / sind weniger als 10 % frei"
expr– die Bedingung als PromQL-Abfrage. Liefert sie ein Ergebnis, ist die Regel verletzt.for– so lange muss die Bedingung ununterbrochen gelten, bevor der Alarm auslöst. Kurze Ausreißer lösen so keinen Alarm aus.summary– ein Text, der beim Alarm angezeigt wird.{{ $labels.job }}setzt den Namen des betroffenen Ziels ein.
Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben.
16. Regeldatei prüfen
promtool check rules /etc/prometheus/regeln.yml
Prüfen: Die Ausgabe endet mit SUCCESS: 2 rules found.
17. Konfiguration öffnen
sudo nano /etc/prometheus/prometheus.yml
18. Regeldatei eintragen
Suche mit Strg+W nach first_rules und drücke Enter. Ersetze die gefundene Zeile # - "first_rules.yml" durch diese Zeile (mit zwei Leerzeichen am Anfang):
- "regeln.yml"
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Der Pfad ist relativ zum Ordner /etc/prometheus.
19. Gesamte Konfiguration prüfen
promtool prüft dabei auch die eingetragene Regeldatei.
promtool check config /etc/prometheus/prometheus.yml
Prüfen: Es erscheinen SUCCESS: 1 rule files found und SUCCESS: 2 rules found.
20. Konfiguration neu laden
reload liest die Konfiguration neu ein, ohne Prometheus zu beenden. Die gesammelten Werte bleiben erhalten.
sudo systemctl reload prometheus
Prüfen: Unter http://127.0.0.1:9090/classic/alerts stehen die beiden Regeln mit dem Zustand Inactive.
21. Alarm auslösen
Zum Ausprobieren hältst du den Node Exporter an.
sudo systemctl stop prometheus-node-exporter
Prüfen: Lade die Seite mit den Alarmen nach etwa einer halben Minute neu. ExporterNichtErreichbar steht jetzt unter Pending: Die Bedingung gilt, die Minute aus for ist aber noch nicht vorbei. Nach rund zwei Minuten wechselt der Alarm zu Firing.
22. Node Exporter wieder starten
sudo systemctl start prometheus-node-exporter
Prüfen: Nach etwa einer halben Minute steht der Alarm wieder unter Inactive.
Prometheus zeigt Alarme nur an. Um bei einem Alarm eine E-Mail oder Nachricht zu verschicken, braucht es zusätzlich den Alertmanager.
In Grafana anzeigen
Ist Grafana installiert, wählst du dort unter Connections → Add new connection die Quelle Prometheus und trägst bei Prometheus server URL http://127.0.0.1:9090 ein. Danach stehen alle Abfragen aus Schritt 14 für Dashboards zur Verfügung.
Optional: Autostart ausschalten
Wer Prometheus nur ab und zu braucht, nimmt beide Dienste aus dem Systemstart heraus und startet sie bei Bedarf mit sudo systemctl start prometheus-node-exporter prometheus.
sudo systemctl disable --now prometheus prometheus-node-exporter
Wie geht es weiter?
- Aufbewahrungsdauer: Prometheus behält die Messwerte 15 Tage und speichert sie in
/var/lib/prometheus/metrics2. Mit--storage.tsdb.retention.time=90dzusätzlich in der ZeileARGSaus Schritt 7 bleiben sie 90 Tage. - Weitere Ziele: Für viele Programme gibt es eigene Exporter als Ubuntu-Paket, etwa
prometheus-postgres-exporterfür PostgreSQL oderprometheus-nginx-exporterfür nginx. Sie werden als weiterer Eintrag unterscrape_configsinprometheus.ymleingetragen. - Neue Weboberfläche: Das Skript
/usr/share/prometheus/install-ui.shlädt die aktuelle Oberfläche des Projekts von GitHub nach. Sie wird dann aber nicht überaptaktualisiert. - Dokumentation: Einführung in PromQL unter https://prometheus.io/docs/prometheus/latest/querying/basics/. Die Seiten beschreiben die neueste Version, Grundlagen und Abfragesprache gelten aber auch für 2.53.
Deinstallieren
1. Prometheus und Node Exporter entfernen
purge löscht auch die gesammelten Messwerte in /var/lib/prometheus. apt meldet dabei, dass /etc/prometheus nicht leer ist, weil dort noch die Regeldatei liegt.
sudo apt purge prometheus prometheus-node-exporter promtool
2. Übrige Abhängigkeiten entfernen
Entfernt die Bibliotheken für die Weboberfläche, die nur für Prometheus installiert wurden. 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
3. Übrige Dateien löschen
Die Regeldatei aus Schritt 15 gehört zu keinem Paket und bleibt deshalb liegen.
sudo rm -rf /etc/prometheus /var/lib/prometheus
4. Systembenutzer entfernen
Die Installation hat den Benutzer prometheus und eine gleichnamige Gruppe angelegt.
sudo deluser prometheus
Prüfen: Der Befehl prometheus wird nicht mehr gefunden.
prometheus --version
Quellen und Lizenz
- Offizielle Dokumentation: https://prometheus.io/docs/introduction/overview/
- Lizenz: Prometheus steht unter der Apache-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.
Alertmanager
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Der Alertmanager verschickt die Alarme, die Prometheus erkennt. Prometheus selbst zeigt einen ausgelösten Alarm nur auf einer Webseite an. Der Alertmanager nimmt ihn entgegen, fasst zusammengehörige Alarme zu einer Nachricht zusammen, schickt sie per E-Mail oder an einen anderen Dienst und meldet sich erneut, wenn die Störung vorbei ist. Während Wartungsarbeiten lassen sich Alarme gezielt stummschalten.
Vorbemerkungen
- Voraussetzung: Prometheus und der Node Exporter sind nach der Prometheus-Anleitung installiert, einschließlich der Regeldatei aus den Schritten 15 bis 20. Ohne Regeln gibt es nichts zu verschicken.
- Installation über apt: Ubuntu 26.04 liefert den Alertmanager 0.28.1 als einzelnes Paket
prometheus-alertmanager. Es enthält auch das Befehlszeilenwerkzeugamtool. - Keine Weboberfläche: Das Ubuntu-Paket bringt die Weboberfläche des Projekts nicht mit. Unter
http://127.0.0.1:9093/steht nur ein Hinweis darauf. Diese Anleitung bedient den Alertmanager deshalb mitamtool. - Sofort erreichbar: Der Dienst startet direkt nach der Installation und lauscht auf allen Netzwerkschnittstellen, auf Port 9093 für Alarme und auf Port 9094 für den Verbund mehrerer Alertmanager. Eine Anmeldung gibt es nicht. Die Schritte 4 bis 6 beschränken ihn auf
127.0.0.1und schalten den Verbund ab. Erledige sie gleich nach der Installation. - E-Mail über den eigenen Rechner: Das Beispiel verschickt die Nachrichten über ein Mailprogramm auf demselben Rechner (Postfix, Port 25) an einen lokalen Benutzer. Postfix muss dafür installiert sein. Es war auf dem Testrechner schon vorhanden und ist nicht Teil dieser Anleitung. Den Versand über einen Anbieter im Internet beschreibt der Abschnitt „Wie geht es weiter?“, dieser Weg ist nicht selbst getestet.
- Version: Getestet mit Alertmanager 0.28.1 und Prometheus 2.53.5 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Alertmanager installieren
sudo apt install prometheus-alertmanager
3. Version prüfen
prometheus-alertmanager --version
Prüfen: Die erste Zeile beginnt mit alertmanager, version 0.28.1.
Auf den eigenen Rechner beschränken
4. Startoptionen öffnen
sudo nano /etc/default/prometheus-alertmanager
5. Adresse festlegen
Suche mit Strg+W nach ARGS= und drücke Enter. Ersetze die gefundene Zeile ARGS="" durch diese Zeile:
ARGS="--web.listen-address=127.0.0.1:9093 --cluster.listen-address="
Die erste Option bindet den Alertmanager an den eigenen Rechner. Die zweite bleibt absichtlich ohne Wert: Das schaltet den Verbund und damit Port 9094 ab. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Dienst neu starten und prüfen
sudo systemctl restart prometheus-alertmanager
sudo ss -ltnp | grep prometheus-aler
Prüfen: Es erscheint genau eine Zeile mit 127.0.0.1:9093. Port 9094 taucht nicht mehr auf.
Empfänger einrichten
Die mitgelieferte Datei /etc/prometheus/alertmanager.yml ist ein umfangreiches Beispiel mit erfundenen Adressen. Du ersetzt sie durch eine kurze eigene Fassung.
7. Beispieldatei sichern
So kannst du später nachlesen, welche Möglichkeiten das Beispiel zeigt.
sudo cp /etc/prometheus/alertmanager.yml /etc/prometheus/alertmanager.yml.beispiel
8. Konfiguration öffnen
sudo nano /etc/prometheus/alertmanager.yml
9. Eigene Konfiguration eintragen
Lösche den gesamten Inhalt: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge dann diesen Inhalt ein (Strg+Umschalt+V) und ersetze thorsten durch deinen Benutzernamen:
global:
smtp_smarthost: 'localhost:25'
smtp_from: 'alertmanager@localhost'
smtp_require_tls: false
route:
receiver: mail
group_by: ['alertname']
group_wait: 30s
group_interval: 5m
repeat_interval: 4h
receivers:
- name: mail
email_configs:
- to: 'thorsten@localhost'
send_resolved: true
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben.
Was die Einträge bedeuten:
smtp_smarthost– der Mailserver, der die Nachricht annimmt, hier Postfix auf dem eigenen Rechner.smtp_require_tls: false– für die Verbindung innerhalb des Rechners ist keine Verschlüsselung nötig.receiver: mail– alle Alarme gehen an den Empfänger mit diesem Namen, der unterreceiversbeschrieben ist.group_by– Alarme mit demselben Namen kommen gemeinsam in eine Nachricht.group_wait– so lange wartet der Alertmanager nach dem ersten Alarm, ob weitere dazukommen.group_interval– frühestens nach dieser Zeit folgt eine weitere Nachricht zur selben Gruppe, etwa die Entwarnung.repeat_interval– besteht ein Alarm weiter, wird er in diesem Abstand wiederholt.send_resolved: true– auch das Ende einer Störung wird gemeldet.
10. Konfiguration prüfen
amtool check-config /etc/prometheus/alertmanager.yml
Prüfen: Die Ausgabe enthält SUCCESS und darunter 1 receivers.
11. Dienst neu starten
sudo systemctl restart prometheus-alertmanager
Prüfen: Die Ausgabe lautet active.
systemctl is-active prometheus-alertmanager
12. Verbindung von Prometheus prüfen
Die Konfiguration von Prometheus enthält ab Werk schon einen Eintrag für einen Alertmanager auf localhost:9093. Dort ist nichts zu ändern.
curl -s http://127.0.0.1:9090/api/v1/alertmanagers
Prüfen: Unter activeAlertmanagers steht http://localhost:9093/api/v2/alerts. Ist die Liste noch leer, warte einige Sekunden und wiederhole den Befehl.
Alarm auslösen
13. Node Exporter anhalten
Damit greift die Regel ExporterNichtErreichbar aus der Prometheus-Anleitung.
sudo systemctl stop prometheus-node-exporter
14. Alarm im Alertmanager ansehen
Es dauert rund anderthalb Minuten, bis Prometheus den Alarm auslöst und weitergibt.
amtool alert
Prüfen: Zunächst erscheint nur die Kopfzeile. Danach steht darunter der Alarm:
Alertname Starts At Summary State
ExporterNichtErreichbar 2026-10-04 03:43:12 UTC node ist seit einer Minute nicht erreichbar active
Die Uhrzeit ist in Weltzeit (UTC) angegeben. amtool alert -o extended zeigt zusätzlich alle Merkmale des Alarms.
15. E-Mail ansehen
Etwa eine halbe Minute nach dem Alarm, der Wartezeit aus group_wait, liegt die Nachricht im lokalen Postfach.
grep '^Subject:' /var/mail/thorsten
Prüfen: Es erscheint eine Zeile wie Subject: [FIRING:1] ExporterNichtErreichbar (localhost:9100 node example). Die Nachricht selbst ist als HTML gestaltet. less /var/mail/thorsten zeigt den Rohtext.
16. Node Exporter wieder starten
sudo systemctl start prometheus-node-exporter
Prüfen: Nach einigen Minuten folgt die Entwarnung. Im Test dauerte es knapp fünf Minuten, das entspricht group_interval.
grep '^Subject:' /var/mail/thorsten
Die neue Zeile beginnt mit Subject: [RESOLVED].
Alarme stummschalten
Bei geplanten Arbeiten soll der Alertmanager nicht jede erwartete Störung melden. Eine Stummschaltung (Silence) unterdrückt die Nachrichten für eine bestimmte Zeit. Der Alarm selbst bleibt bestehen.
17. Stummschaltung anlegen
Dieser Befehl unterdrückt eine Stunde lang alle Alarme mit dem Namen ExporterNichtErreichbar. Ein Kommentar ist Pflicht.
amtool silence add alertname=ExporterNichtErreichbar --duration=1h --comment="Wartung am Node Exporter"
Prüfen: Die Ausgabe ist die Kennung der Stummschaltung, eine lange Folge aus Ziffern und Buchstaben.
18. Stummschaltungen anzeigen
amtool silence query
Prüfen: Die Liste nennt Kennung, Bedingung, Ende, Urheber und Kommentar.
Ein stummgeschalteter Alarm fehlt in der Ausgabe von amtool alert. Mit dieser Option erscheint er wieder, mit dem Zustand suppressed:
amtool alert query --silenced
19. Stummschaltung vorzeitig beenden
Ersetze KENNUNG durch die Kennung aus Schritt 17 oder 18.
amtool silence expire KENNUNG
Prüfen: amtool silence query zeigt nur noch die Kopfzeile.
Versand testen, ohne etwas anzuhalten
20. Testalarm von Hand erzeugen
amtool kann selbst einen Alarm einliefern. So prüfst du Empfänger und Zustellung, ohne einen Dienst zu stoppen. Die doppelten Anführungszeichen innerhalb der einfachen sind nötig, weil der Text Leerzeichen enthält.
amtool alert add Testalarm --annotation='summary="Nur ein Test"'
Prüfen: amtool alert zeigt den Alarm sofort, nach etwa einer halben Minute liegt eine E-Mail mit [FIRING:1] Testalarm im Postfach. Der Testalarm läuft nach fünf Minuten von selbst ab.
21. Weg eines Alarms nachvollziehen
Bei mehreren Empfängern zeigt dieser Befehl, an wen ein Alarm mit bestimmten Merkmalen ginge:
amtool config routes test alertname=Testalarm
Prüfen: Die Ausgabe ist der Name des Empfängers, hier mail.
Wie geht es weiter?
- E-Mail über einen Anbieter (nicht selbst getestet): Für den Versand an eine Adresse im Internet trägst du unter
globalden Server deines Anbieters ein, z. B.smtp_smarthost: 'smtp.example.org:587', dazusmtp_auth_usernameundsmtp_auth_password, und lässtsmtp_require_tlsweg. Weil dann ein Passwort in der Datei steht, sollte sie nur fürrootund die Gruppeprometheuslesbar sein:sudo chown root:prometheus /etc/prometheus/alertmanager.ymlundsudo chmod 640 /etc/prometheus/alertmanager.yml. - Andere Wege: Statt
email_configsgibt es unter anderemwebhook_configsfür einen beliebigen Webdienst sowie fertige Anbindungen an Slack, Telegram, Discord und Microsoft Teams. Beispiele stehen in der gesicherten Datei aus Schritt 7. - Alarme nach Dringlichkeit verteilen: Regeln in Prometheus können ein Merkmal wie
severity: criticaltragen. Unterroutelassen sich dann mitroutesundmatchersverschiedene Empfänger zuordnen. - Nur die Erreichbarkeit von Websites: Wer keinen Prometheus betreibt und nur wissen will, ob eine Website antwortet, kommt mit Uptime Kuma schneller ans Ziel.
- Dokumentation: https://prometheus.io/docs/alerting/latest/configuration/ sowie
amtool --help
Deinstallieren
1. Alertmanager entfernen
purge löscht auch /etc/prometheus/alertmanager.yml und die gespeicherten Stummschaltungen in /var/lib/prometheus/alertmanager. Prometheus bleibt installiert und zeigt Alarme weiter auf seiner Webseite an.
sudo apt purge prometheus-alertmanager
2. Gesicherte Beispieldatei löschen
Die Kopie aus Schritt 7 gehört zu keinem Paket.
sudo rm -f /etc/prometheus/alertmanager.yml.beispiel
Prüfen: Der Befehl wird nicht mehr gefunden.
prometheus-alertmanager --version
Wie du Prometheus selbst entfernst, steht am Ende der Prometheus-Anleitung.
Quellen und Lizenz
- Offizielle Dokumentation: https://prometheus.io/docs/alerting/latest/alertmanager/
- Lizenz: Alertmanager steht unter der Apache-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.
GoAccess
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GoAccess wertet die Zugriffsprotokolle eines Webservers aus und zeigt, wie viele Besucher eine Website hat, welche Seiten am häufigsten aufgerufen werden, welche Adressen nicht gefunden wurden, woher die Besucher kommen und welche Browser und Suchmaschinen-Roboter dabei sind. Die Ergebnisse erscheinen direkt im Terminal oder als HTML-Seite, auf Wunsch auch fortlaufend aktualisiert. GoAccess braucht keinen Dienst, keine Datenbank und kein Skript in der Website, denn es liest nur die Protokolle, die nginx ohnehin schreibt.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert GoAccess 1.9.4. Das Paket hat keine weiteren Abhängigkeiten, die nicht schon vorhanden sind.
- Voraussetzung: nginx ist installiert und schreibt sein Protokoll nach
/var/log/nginx/access.log, wie in der Anleitung nginx beschrieben. Für Apache funktioniert GoAccess genauso, das Protokoll heißt dort/var/log/apache2/access.log. - Leserechte: Die Protokolle gehören der Gruppe
adm. Der Benutzer, der bei der Installation von Ubuntu angelegt wurde, ist Mitglied dieser Gruppe und kann sie ohnesudolesen. - Datenschutz: Protokolle und Berichte enthalten die IP-Adressen der Besucher, also personenbezogene Daten. Berichte gehören daher nicht ungeschützt ins Internet. Schritt 14 zeigt, wie GoAccess die Adressen kürzt.
- Version: Getestet mit GoAccess 1.9.4 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. GoAccess installieren
sudo apt install goaccess
3. Version prüfen
goaccess --version
Prüfen: Die erste Zeile lautet GoAccess - 1.9.4.
4. Leserecht prüfen
id -nG | grep -w adm
Prüfen: Die Ausgabe enthält adm. Gibt der Befehl nichts aus, stellst du in den folgenden Befehlen sudo voran.
Einrichten
5. Protokollformat festlegen
GoAccess muss wissen, wie die Zeilen im Protokoll aufgebaut sind. nginx und Apache schreiben in der Grundeinstellung das verbreitete Format Combined. Damit du es nicht bei jedem Aufruf angeben musst, legst du es in einer Einstellungsdatei in deinem Home-Ordner fest.
nano ~/.goaccessrc
Füge diese Zeile ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
log-format COMBINED
6. Testaufrufe erzeugen (optional)
Ist das Protokoll noch leer, erzeugen diese drei Aufrufe einige Einträge: zwei vorhandene Seiten und eine Adresse, die es nicht gibt.
curl -s -o /dev/null http://localhost/
curl -s -o /dev/null http://localhost/
curl -s -o /dev/null http://localhost/gibtsnicht
Prüfen: Die letzten Zeilen des Protokolls zeigen die Aufrufe, die letzte mit dem Statuscode 404.
tail -n 3 /var/log/nginx/access.log
Auswertung im Terminal
7. GoAccess starten
goaccess /var/log/nginx/access.log
Prüfen: Das Terminal zeigt oben eine Übersicht mit Anfragen gesamt, Eindeutige Besucher und Nicht gefunden, darunter Bereiche wie Eindeutige Besucher pro Tag und Angefragte Dateien. Die Oberfläche richtet sich nach der Sprache des Systems.
8. Durch die Bereiche blättern
- Tab springt zum nächsten Bereich, Umschalt+Tab zum vorherigen.
- Enter klappt den gewählten Bereich auf und zeigt alle Einträge.
- F1 oder h zeigt die Hilfe mit allen Tasten.
9. GoAccess beenden
Drücke q. Ist ein Bereich aufgeklappt, schließt q zuerst diesen, ein weiteres q beendet GoAccess.
Bericht als HTML-Seite
10. Ordner für Berichte anlegen
mkdir -p ~/goaccess-berichte
11. Bericht erzeugen
-o schreibt das Ergebnis in eine Datei, statt es im Terminal anzuzeigen. An der Endung .html erkennt GoAccess, dass eine Webseite entstehen soll.
goaccess /var/log/nginx/access.log -o ~/goaccess-berichte/bericht.html
Prüfen: Die Ausgabe endet mit Cleaning up resources... und die Datei ist rund 700 KB groß.
ls -lh ~/goaccess-berichte
12. Bericht im Browser öffnen
xdg-open ~/goaccess-berichte/bericht.html
Prüfen: Der Browser zeigt die Übersicht Analysierte Anfragen gesamt mit Zahlen und Diagrammen. Die Seite enthält alles in einer Datei und braucht keine Internetverbindung.
13. Auch ältere Protokolle auswerten
nginx beginnt jeden Tag ein neues Protokoll. Die älteren heißen access.log.1, access.log.2.gz und so weiter, die meisten davon gepackt. zcat -f gibt alle Dateien hintereinander aus und packt die gepackten dabei aus. Das - am Ende sagt GoAccess, dass es die Daten über die Pipe erhält.
zcat -f /var/log/nginx/access.log* | goaccess -o ~/goaccess-berichte/alle.html -
Prüfen: Oben im Bericht reicht der Zeitraum unter Analysierte Anfragen gesamt jetzt mehrere Tage zurück.
14. IP-Adressen kürzen
--anonymize-ip setzt den letzten Teil jeder Adresse auf null, aus 203.0.113.57 wird so 203.0.113.0. Besucher lassen sich dann nicht mehr einzeln zuordnen, die Statistik bleibt aber aussagekräftig.
goaccess /var/log/nginx/access.log --anonymize-ip -o ~/goaccess-berichte/anonym.html
Prüfen: Im Bereich Besucher-Hostnamen und -IPs enden alle IPv4-Adressen auf .0.
15. Bericht als CSV oder JSON
Mit der Endung .csv oder .json schreibt GoAccess dieselben Zahlen für Tabellenkalkulationen oder eigene Programme.
goaccess /var/log/nginx/access.log -o ~/goaccess-berichte/bericht.json
Bericht, der sich selbst aktualisiert
GoAccess kann den HTML-Bericht laufend aktualisieren. Dazu startet es einen kleinen Server, der neue Zahlen über eine WebSocket-Verbindung an die geöffnete Seite schickt.
16. Live-Bericht starten
--real-time-htmlhält GoAccess am Laufen und schickt jede neue Protokollzeile an den Browser.--addr=127.0.0.1lässt den Server nur Verbindungen von diesem Rechner annehmen. Ohne diese Angabe wäre er aus dem ganzen Netz erreichbar.
goaccess /var/log/nginx/access.log -o ~/goaccess-berichte/live.html --real-time-html --addr=127.0.0.1
Lass dieses Terminal offen.
17. Live-Bericht öffnen
Öffne ein zweites Terminal und darin den Bericht:
xdg-open ~/goaccess-berichte/live.html
Prüfen: Rufe im zweiten Terminal ein paarmal curl -s -o /dev/null http://localhost/ auf. Nach wenigen Sekunden steigt die Zahl bei Anfragen gesamt im Browser, ohne dass du die Seite neu lädst.
18. Live-Bericht beenden
Wechsle in das erste Terminal und drücke Strg+C. Die Seite im Browser zeigt danach den letzten Stand.
Wie geht es weiter?
- Roboter ausblenden:
--ignore-crawlerslässt Suchmaschinen und andere Roboter aus der Statistik weg. - Mehrere Websites: Schreibt nginx mehrere Websites in dasselbe Protokoll, unterscheidet GoAccess sie nur, wenn der Name der Website im Protokoll steht. Einfacher ist ein eigenes Protokoll je Website mit
access_logim jeweiligenserver-Block. - Herkunftsländer: Mit einer GeoIP-Datenbank im Format MaxMind DB (z. B. der kostenlosen GeoLite2 Country nach Registrierung bei MaxMind) zeigt GoAccess auch Länder an. Die Datei wird mit
--geoip-database=PFADangegeben. - Dokumentation:
man goaccessoder https://goaccess.io/man
Deinstallieren
1. Berichte und Einstellungsdatei löschen
rm -rf ~/goaccess-berichte ~/.goaccessrc
2. GoAccess entfernen
sudo apt purge goaccess
Prüfen: Der Befehl goaccess wird nicht mehr gefunden.
goaccess --version
Quellen und Lizenz
- Offizielle Dokumentation: https://goaccess.io/documentation
- Lizenz: GoAccess steht unter der MIT.
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.
Monit
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Monit behält Dienste, Prozesse, Dateisysteme und die Auslastung des Rechners im Auge. Fällt ein Dienst wie nginx aus, startet Monit ihn von selbst neu; wird der Speicherplatz knapp oder der Rechner überlastet, meldet es das im Protokoll, auf einer kleinen Weboberfläche oder per E-Mail. Monit ist ein einzelnes, sparsames Programm ohne Datenbank und ergänzt Prometheus und Grafana: Diese sammeln Messwerte für Diagramme, Monit greift dagegen sofort ein.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Monit 5.35.2. Das Paket bringt keine weiteren Abhängigkeiten mit.
- Aufbau der Einstellungen: Die Hauptdatei
/etc/monit/monitrcbleibt unverändert. Eigene Prüfungen kommen als einzelne Dateien in den Ordner/etc/monit/conf.d/, den Monit automatisch einliest. So bleibt die Hauptdatei bei Updates unberührt. - Prüfabstand: Monit prüft in der Grundeinstellung alle 120 Sekunden. Bis ein ausgefallener Dienst neu startet, können also bis zu zwei Minuten vergehen.
- Voraussetzung für Teil 3: nginx ist installiert, wie in der Anleitung nginx beschrieben. Die übrigen Teile funktionieren auch ohne nginx.
- Version: Getestet mit Monit 5.35.2 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Monit installieren
Das Paket richtet Monit als Systemdienst ein und startet es sofort.
sudo apt install monit
3. Version prüfen
monit --version
Prüfen: Die erste Zeile lautet This is Monit version 5.35.2.
4. Dienst prüfen
systemctl is-active monit
Prüfen: Die Ausgabe lautet active.
Teil 1: Weboberfläche und Befehl monit status
Die Befehle monit status und monit summary fragen den laufenden Monit-Dienst über seine eingebaute Weboberfläche ab. Solange diese ausgeschaltet ist (so ist es nach der Installation), funktionieren sie nicht. Deshalb schaltest du die Oberfläche zuerst ein, aber nur für diesen Rechner und mit Passwort.
5. Einstellungsdatei für die Weboberfläche anlegen
sudo nano /etc/monit/conf.d/weboberflaeche
Füge diesen Inhalt ein (Strg+Umschalt+V), ersetze GeheimesPasswort durch ein eigenes Passwort, speichere mit Strg+O und Enter und beende nano mit Strg+X:
set httpd port 2812
use address 127.0.0.1
allow 127.0.0.1
allow admin:GeheimesPasswort
Was die Zeilen bedeuten:
set httpd port 2812schaltet die Weboberfläche auf Port 2812 ein.use address 127.0.0.1lässt Monit nur auf diesem Rechner lauschen, aus dem Netz ist die Oberfläche nicht erreichbar.allow 127.0.0.1erlaubt Verbindungen von diesem Rechner.allow admin:…legt Benutzername und Passwort für die Anmeldung fest.
Hinweis: Monit lässt nur Verbindungen über IPv4 zu, weil die Oberfläche auf
127.0.0.1lauscht. Im Browser deshalb immer127.0.0.1eingeben, nichtlocalhost: Firefox und Chrome versuchen beilocalhostzuerst die IPv6-Adresse::1.
6. Datei vor anderen Benutzern schützen
Die Datei enthält das Passwort im Klartext. Mit chmod 600 darf nur noch root sie lesen.
sudo chmod 600 /etc/monit/conf.d/weboberflaeche
7. Einstellungen prüfen
monit -t liest alle Einstellungsdateien und meldet Tippfehler, ohne etwas zu verändern.
sudo monit -t
Prüfen: Die Ausgabe lautet Control file syntax OK. Andernfalls nennt Monit Datei und Zeile des Fehlers.
8. Monit neu laden
Monit liest die Einstellungen neu ein, ohne dass die Überwachung unterbrochen wird.
sudo systemctl reload monit
9. Status abfragen
sudo monit summary
Prüfen: Die Tabelle zeigt eine Zeile mit dem Namen deines Rechners, dem Status OK und dem Typ System. Ohne sudo meldet Monit Permission denied, weil es dann die Einstellungen nicht lesen darf.
10. Weboberfläche öffnen
xdg-open http://127.0.0.1:2812
Melde dich mit dem Benutzer admin und deinem Passwort aus Schritt 5 an.
Prüfen: Die Seite trägt die Überschrift Monit Service Manager und zeigt unter System Auslastung (Load), Prozessor (CPU) und Arbeitsspeicher (Memory). Die Oberfläche gibt es nur auf Englisch.
Teil 2: Rechner und Speicherplatz überwachen
11. Datei für die Systemprüfungen anlegen
sudo nano /etc/monit/conf.d/system
Füge diesen Inhalt ein, speichere und beende nano:
check system $HOST
if loadavg (5min) > 4 then alert
if memory usage > 90% then alert
if cpu usage > 95% for 10 cycles then alert
check filesystem wurzel with path /
if space usage > 90% then alert
Was die Zeilen bedeuten:
check system $HOSTprüft den Rechner selbst.$HOSTsetzt Monit durch den Rechnernamen.loadavg (5min) > 4schlägt an, wenn im Mittel der letzten fünf Minuten mehr als vier Prozesse gleichzeitig auf Rechenzeit warten. Ein guter Wert ist etwa die Zahl der Prozessorkerne (nproczeigt sie).memory usage > 90%meldet knappen Arbeitsspeicher.for 10 cyclesverlangt, dass die Prozessorlast zehn Prüfungen hintereinander über 95 % liegt. Kurze Spitzen lösen so keine Meldung aus.check filesystem wurzel with path /überwacht die Partition, auf der Ubuntu liegt.wurzelist ein frei gewählter Name.then alertschreibt eine Meldung ins Protokoll/var/log/monit.logund verschickt eine E-Mail, falls ein Mailserver eingestellt ist (siehe „Wie geht es weiter?“).
12. Einstellungen prüfen und neu laden
sudo monit -t
sudo systemctl reload monit
13. Speicherplatz anzeigen
monit status mit einem Namen zeigt alle Messwerte dieser einen Prüfung.
sudo monit status wurzel
Prüfen: Unter der Überschrift Filesystem 'wurzel' stehen status OK und Zeilen wie space free total.
Teil 3: nginx bei Ausfall neu starten
14. Datei für nginx anlegen
sudo nano /etc/monit/conf.d/nginx
Füge diesen Inhalt ein, speichere und beende nano:
check process nginx with pidfile /run/nginx.pid
start program = "/usr/bin/systemctl start nginx"
stop program = "/usr/bin/systemctl stop nginx"
if failed host 127.0.0.1 port 80 protocol http then restart
if 3 restarts within 5 cycles then unmonitor
Was die Zeilen bedeuten:
with pidfile /run/nginx.pidsagt Monit, woran es den laufenden nginx-Prozess erkennt. In dieser Datei steht seine Prozessnummer.start programundstop programlegen fest, wie Monit nginx startet und stoppt. Monit nutzt dafür denselben Weg wie du, nämlich systemd.if failed … protocol http then restartruft bei jeder Prüfung die Startseite ab. Antwortet nginx nicht, startet Monit es neu. Ein Prozess, der zwar läuft, aber hängt, fällt so ebenfalls auf.if 3 restarts within 5 cycles then unmonitorverhindert eine Endlosschleife: Scheitert der Neustart dreimal kurz hintereinander, etwa wegen eines Fehlers in der nginx-Konfiguration, hört Monit auf und meldet das.
Hinweis: Unter
/etc/monit/conf-available/liefert das Paket fertige Vorlagen, auch eine für nginx. Sie stammt aus älteren Ubuntu-Versionen und startet Dienste überservice. Die eigene Datei oben ist kürzer und nutzt systemd direkt.
15. Einstellungen prüfen und neu laden
sudo monit -t
sudo systemctl reload monit
Prüfen: In der Übersicht steht nginx mit dem Status OK und dem Typ Process.
sudo monit summary
16. Ausfall ausprobieren
Halte nginx an, als wäre es abgestürzt:
sudo systemctl stop nginx
17. Neustart abwarten
Warte bis zu zwei Minuten (ein Prüfabstand) und frage dann den Zustand ab:
systemctl is-active nginx
Prüfen: Die Ausgabe lautet wieder active. Das Protokoll zeigt, was Monit getan hat:
sudo grep nginx /var/log/monit.log
Die letzten Zeilen lauten 'nginx' process is not running, 'nginx' trying to restart und 'nginx' start: '/usr/bin/systemctl start nginx'.
Teil 4: Überwachung steuern
18. Überwachung eines Dienstes pausieren
Willst du nginx absichtlich länger anhalten, etwa für Wartungsarbeiten, sagst du es vorher Monit. Sonst startet Monit den Dienst beim nächsten Durchgang wieder.
sudo monit unmonitor nginx
Prüfen: sudo monit summary zeigt bei nginx den Status Not monitored.
19. Überwachung fortsetzen
sudo monit monitor nginx
Prüfen: sudo monit summary zeigt bei nginx wieder OK.
20. Dienst über Monit neu starten
Startest du einen Dienst über Monit neu, weiß Monit Bescheid und meldet den kurzen Ausfall nicht als Fehler.
sudo monit restart nginx
In der Weboberfläche gibt es dafür auf der Seite eines Dienstes (Klick auf seinen Namen) die Schaltflächen Start service, Stop service, Restart service und Disable monitoring.
Wie geht es weiter?
- E-Mail-Benachrichtigung: Mit
set mailserverundset alertin einer weiteren Datei unter/etc/monit/conf.d/verschickt Monit Meldungen per E-Mail. Dafür braucht der Rechner Zugang zu einem Mailserver, etwa dem eines E-Mail-Anbieters. - Weitere Dienste: Nach dem Muster aus Schritt 14 lassen sich auch PostgreSQL, MariaDB oder Valkey überwachen. Die Prozessnummer findet Monit dann mit
check process NAME matching PROGRAMMNAME, falls der Dienst keine PID-Datei schreibt. - Prüfabstand ändern: Der Abstand steht in
/etc/monit/monitrcin der Zeileset daemon 120. - Dokumentation:
man monitoder https://mmonit.com/monit/documentation/
Deinstallieren
1. Monit entfernen
purge entfernt Monit samt Protokoll und Statusdateien. Der überwachte Dienst nginx bleibt unverändert installiert.
sudo apt purge monit
2. Eigene Einstellungsdateien löschen
Die Dateien aus den Schritten 5, 11 und 14 gehören nicht zum Paket. apt lässt sie deshalb mit dem Ordner /etc/monit liegen.
sudo rm -rf /etc/monit
Prüfen: Der Befehl monit wird nicht mehr gefunden.
monit --version
Quellen und Lizenz
- Offizielle Dokumentation: https://mmonit.com/monit/documentation/
- Lizenz: Monit steht unter der AGPL-3.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.
Glances
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Glances zeigt auf einer einzigen Seite, wie es dem Rechner gerade geht: Prozessor, Arbeitsspeicher, Auslastung, Netzwerk, Festplatten, Temperaturen und die Prozesse, die am meisten Rechenzeit brauchen. Es läuft im Terminal, liefert die Werte auf Wunsch über eine Programmierschnittstelle (API) oder als CSV-Datei und hat eine Weboberfläche für den Browser. Für den schnellen Blick ist Glances damit eine Ergänzung zu Monit, Prometheus und Grafana.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Glances 4.3.3. Mit
--no-install-recommendskommen 17 Pakete auf den Rechner. Ohne diese Option wären es über 50, darunter Bibliotheken für Diagramme und Mathematik, die Glances nur für Sonderfunktionen braucht. - Weboberfläche fehlt im Ubuntu-Paket: Ubuntu liefert Glances ohne die fertig gebauten Dateien der Weboberfläche aus. Der Befehl
glances -wbricht deshalb mit der MeldungDirectory '…/static/public' does not existab. Die API funktioniert trotzdem (Teil 3). Wer die Weboberfläche haben möchte, installiert sie zusätzlich überpipx(Teil 5). - Dienst: Das Paket richtet einen Dienst
glancesein und startet ihn sofort. Er liefert die Messwerte auf Port 61209 an andere Glances-Programme (Teil 2) und ist nur von diesem Rechner aus erreichbar. - Temperaturen: Die Temperaturen von Prozessor und SSD liest Glances direkt aus dem System. Das Paket
lm-sensorsist dafür nicht nötig. - Version: Getestet mit Glances 4.3.3 (apt) und 4.5.7 (pipx) am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Glances installieren
--no-install-recommends lässt die nur empfohlenen Zusatzpakete weg.
sudo apt install --no-install-recommends glances
3. Version prüfen
glances --version
Prüfen: Die erste Zeile lautet Glances version: 4.3.3.
4. Dienst prüfen
systemctl is-active glances
Prüfen: Die Ausgabe lautet active.
Teil 1: Glances im Terminal
5. Glances starten
glances
Prüfen: Oben stehen Rechnername, Ubuntu-Version und Laufzeit, darunter Kästen für CPU, MEM, SWAP und LOAD. Links folgen Netzwerk, Festplatten, Dateisysteme und Temperaturen (SENSORS), rechts die Liste der Prozesse. Die Anzeige wird alle zwei Sekunden erneuert und ist nur auf Englisch verfügbar.
6. Anzeige mit Tasten steuern
Glances reagiert auf einzelne Tasten, ohne dass du Enter drücken musst:
- c sortiert die Prozesse nach Prozessorlast, m nach Arbeitsspeicher, a wieder automatisch.
- 1 zeigt jeden Prozessorkern einzeln an und mit einem zweiten Druck wieder alle zusammen.
- s blendet die Temperaturen aus und wieder ein, z die Prozessliste.
- h zeigt alle Tasten, ein weiteres h schließt die Hilfe.
Farben: Grün heißt in Ordnung, Blau »beobachten«, Violett »Warnung« und Rot »kritisch«.
7. Glances beenden
Drücke q.
Teil 2: Werte vom Dienst abrufen
Der Dienst aus Schritt 4 misst die Werte im Hintergrund. Ein zweites Glances-Programm kann sich als Client mit ihm verbinden und zeigt dann dessen Werte. Das ist vor allem nützlich, wenn der Dienst auf einem anderen Rechner läuft.
8. Mit dem Dienst verbinden
glances -c 127.0.0.1
Prüfen: Die Anzeige sieht aus wie in Schritt 5. Zusätzlich steht dort Connected to mit dem Rechnernamen. Mit q beendest du sie.
9. Dienst abschalten (optional)
Brauchst du den Client-Modus nicht, kannst du den Dienst ausschalten. Glances im Terminal funktioniert auch ohne ihn.
sudo systemctl disable --now glances
Prüfen: Die Ausgabe lautet inactive.
systemctl is-active glances
Teil 3: Werte über die API abfragen
Mit -w startet Glances einen kleinen Webserver. --disable-webui schaltet dabei die Weboberfläche ab, die im Ubuntu-Paket fehlt, und lässt nur die API laufen. Sie liefert alle Messwerte im Format JSON, etwa für eigene Skripte.
10. API starten
-B 127.0.0.1 lässt den Webserver nur Verbindungen von diesem Rechner annehmen. Ohne diese Angabe wäre er aus dem ganzen Netz erreichbar, und zwar ohne Passwort.
glances -w --disable-webui -B 127.0.0.1
Prüfen: Die letzte Zeile lautet Uvicorn running on http://127.0.0.1:61208 (Press CTRL+C to quit). Lass dieses Terminal offen.
11. Prozessorlast abfragen
Öffne ein zweites Terminal. Die Adresse besteht aus /api/4/, dem Namen eines Bereichs (cpu) und dem gewünschten Wert (total).
curl http://127.0.0.1:61208/api/4/cpu/total
Prüfen: Die Antwort sieht aus wie {"total":19.2}, also die Prozessorlast in Prozent.
12. Liste aller Bereiche anzeigen
curl http://127.0.0.1:61208/api/4/pluginslist
Prüfen: Die Liste enthält unter anderem "cpu", "mem", "load", "fs" und "sensors". Jeden dieser Namen kannst du in Schritt 11 statt cpu einsetzen. Ohne Wertnamen, also etwa /api/4/mem, liefert Glances alle Werte des Bereichs.
13. API beenden
Wechsle in das erste Terminal und drücke Strg+C.
Teil 4: Werte in eine CSV-Datei schreiben
14. Messwerte aufzeichnen
Glances schreibt bei jeder Messung eine Zeile in die Datei. --stop-after 30 beendet die Aufzeichnung nach 30 Messungen, also nach etwa einer Minute. --quiet lässt die Anzeige im Terminal weg.
glances --export csv --export-csv-file ~/glances.csv --stop-after 30 --quiet
Prüfen: Die erste Zeile der Datei enthält die Spaltennamen wie timestamp, cpu.total und mem.percent. Die Datei lässt sich in LibreOffice Calc öffnen.
head -c 300 ~/glances.csv
Teil 5: Weboberfläche über pipx
Die vollständige Weboberfläche gibt es in der Version von https://pypi.org. pipx installiert sie in eine eigene virtuelle Umgebung, getrennt von Ubuntus Python, wie es die Anleitung Python für Kommandozeilenprogramme empfiehlt. Mit dem Zusatz --suffix=-web heißt der Befehl glances-web. So kommt er dem glances aus dem Ubuntu-Paket nicht in die Quere.
15. pipx installieren
sudo apt install pipx
Prüfen: Die Versionsnummer erscheint, z. B. 1.8.0.
pipx --version
16. Glances mit Weboberfläche installieren
[web] sorgt dafür, dass pipx auch die Bibliotheken für den Webserver mitinstalliert. Die Anführungszeichen braucht die Shell wegen der eckigen Klammern.
pipx install 'glances[web]' --suffix=-web
Prüfen: Die Ausgabe endet mit These apps are now globally available und - glances-web.
Meldet das Terminal später glances-web: Kommando nicht gefunden, fehlt ~/.local/bin im Suchpfad. pipx ensurepath trägt den Ordner ein. Danach ein neues Terminal öffnen.
17. Weboberfläche starten
glances-web -w -B 127.0.0.1
Prüfen: Die letzte Zeile lautet Uvicorn running on http://127.0.0.1:61208 (Press CTRL+C to quit). Lass dieses Terminal offen.
18. Weboberfläche im Browser öffnen
Öffne ein zweites Terminal:
xdg-open http://127.0.0.1:61208
Prüfen: Der Browser zeigt dieselben Bereiche wie das Terminal in Schritt 5 und erneuert sie laufend. Ein Klick auf eine Spaltenüberschrift der Prozessliste sortiert nach dieser Spalte. Die API aus Teil 3 steht unter derselben Adresse ebenfalls bereit.
19. Weboberfläche beenden
Wechsle in das erste Terminal und drücke Strg+C.
Wie geht es weiter?
- Anderen Rechner beobachten: Läuft auf einem Server der Dienst aus Teil 2, kann er mit
-B 0.0.0.0für das Netz geöffnet werden. Dann gehören ein Passwort (--password) und eine Firewall-Regel dazu, die nur die eigenen Rechner zulässt. - Nach Prometheus exportieren: Mit
--export prometheusstellt Glances seine Werte für Prometheus bereit. Dafür braucht es zusätzlich das Paketpython3-prometheus-client. Für einen Rechner allein ist der Node Exporter aus der Prometheus-Anleitung aber die übliche Wahl. - Grenzwerte ändern: Ab welchen Werten Glances eine Farbe wechselt, steht in
/etc/glances/glances.conf. - Dokumentation:
man glancesoder https://glances.readthedocs.io
Deinstallieren
1. Weboberfläche entfernen (falls installiert)
pipx uninstall glances-web
2. pipx entfernen (falls installiert und nicht mehr gebraucht)
sudo apt purge pipx
3. Glances entfernen
purge hält auch den Dienst an und löscht ihn.
sudo apt purge glances
4. Übrige Abhängigkeiten entfernen
Entfernt die Bibliotheken, die nur für Glances und pipx installiert wurden. 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
5. Übrige Dateien löschen
Glances legt beim Start ein Protokoll in deinem Home-Ordner an. Die CSV-Datei stammt aus Schritt 14.
rm -rf ~/.local/share/glances ~/glances.csv
Prüfen: Der Befehl glances wird nicht mehr gefunden.
glances --version
Quellen und Lizenz
- Offizielle Dokumentation: https://glances.readthedocs.io/
- Lizenz: Glances steht unter der LGPL-3.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.
htop und btop
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
htop und btop zeigen im Terminal, welche Programme gerade wie viel Prozessorzeit und Arbeitsspeicher brauchen, und erlauben es, ein hängendes Programm direkt aus der Liste heraus zu beenden. htop ist schlicht, schnell und auf fast jedem Server zu finden. btop ist bunter, zeigt zusätzlich Verlaufskurven für Prozessor, Netzwerk und Festplatten und kann auch die Grafikkarte überwachen. Beide ersetzen den alten Befehl top. Für Werte im Browser oder über eine API eignet sich dagegen Glances.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert htop 3.4.1 und btop 1.4.6. Beide Pakete sind klein und ziehen keine weiteren Pakete nach. Du kannst auch nur eines der beiden installieren.
- Sprache: Beide Programme gibt es nur auf Englisch.
- Funktionstasten: Manche Terminals belegen F1 oder F10 selbst. Für alle Aktionen gibt es deshalb auch eine Buchstabentaste, die die Anleitung jeweils mit angibt.
- Einstellungen: Beide speichern Änderungen an der Anzeige automatisch in deinem Home-Ordner, htop in
~/.config/htop/htoprc, btop in~/.config/btop/btop.conf. - Version: Getestet mit htop 3.4.1 und btop 1.4.6 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. htop und btop installieren
sudo apt install htop btop
3. Versionen prüfen
htop --version
Prüfen: Die Ausgabe lautet htop 3.4.1.
btop --version
Prüfen: Die erste Zeile lautet btop version: 1.4.6.
Teil 1: htop
4. htop starten
htop
Prüfen: Oben steht für jeden Prozessorkern ein Balken, darunter Balken für Arbeitsspeicher (Mem) und Auslagerungsspeicher (Swp). Rechts daneben stehen die Zahl der Prozesse (Tasks), die Auslastung (Load average) und die Laufzeit (Uptime). Den Rest füllt die Prozessliste. Ganz unten zeigt eine Leiste die Funktionstasten von F1Help bis F10Quit.
5. Farben der Balken verstehen
Die Balken sind in Farben unterteilt. Beim Prozessor steht Grün für normale Programme, Rot für Arbeit des Systemkerns und Blau für Programme mit niedriger Priorität. Beim Arbeitsspeicher steht Grün für den Speicher, den Programme wirklich belegen. Blau und Gelb zeigen Zwischenspeicher, den Linux bei Bedarf sofort wieder freigibt. Ein voller Balken mit viel Gelb ist also kein Grund zur Sorge.
6. Prozessliste sortieren
Drücke F6 (oder >), wähle mit den Pfeiltasten eine Spalte, etwa PERCENT_MEM für den Arbeitsspeicher, und bestätige mit Enter.
Schneller geht es mit diesen Tasten:
- P (groß) sortiert nach Prozessorlast.
- M (groß) sortiert nach Arbeitsspeicher.
- T (groß) sortiert nach der bisher verbrauchten Rechenzeit.
7. Programm suchen
Drücke F3 (oder /) und tippe einen Teil des Namens, z. B. nginx. htop springt zum ersten Treffer, F3 springt zum nächsten. Esc beendet die Suche.
Soll die Liste nur noch passende Prozesse zeigen, nimm stattdessen F4 (oder \). Ein leerer Filter mit Enter zeigt wieder alle.
8. Baumansicht einschalten
F5 (oder t) zeigt, welches Programm welches andere gestartet hat. Ein zweiter Druck schaltet wieder auf die Liste um.
9. Programm beenden
Wähle den Prozess mit den Pfeiltasten aus und drücke F9 (oder k). Links erscheint eine Liste von Signalen. Vorausgewählt ist 15 SIGTERM: Es bittet das Programm, sich ordentlich zu beenden. Bestätige mit Enter. Nur wenn ein Programm darauf nicht reagiert, wähle 9 SIGKILL, das es sofort abbricht.
Hinweis: Ohne
sudokannst du nur deine eigenen Programme beenden. Für Systemdienste istsudo systemctl stop DIENSTder bessere Weg als ein Signal aus htop, sonst startet systemd den Dienst unter Umständen gleich wieder.
10. Anzeige einrichten
F2 (oder S, groß) öffnet die Einstellungen. Links wählst du einen Bereich, etwa Meters für die Balken oben oder Columns für die Spalten der Prozessliste, und änderst ihn mit den Tasten, die die untere Leiste anzeigt. F10 oder Esc schließt die Einstellungen.
11. htop beenden
Drücke q (oder F10). Dabei schreibt htop deine Einstellungen nach ~/.config/htop/htoprc.
Teil 2: btop
12. btop starten
btop
Prüfen: Das Fenster ist in vier Kästen geteilt: cpu oben mit einer Verlaufskurve und einem Balken je Kern, darunter links mem mit Arbeitsspeicher und disks mit den Dateisystemen, darunter net mit dem Netzverkehr und rechts proc mit der Prozessliste.
13. Kästen ein- und ausblenden
Die Zifferntasten schalten die Kästen um:
- 1 Prozessor, 2 Arbeitsspeicher, 3 Netzwerk, 4 Prozesse.
- 5 blendet einen Kasten für die Grafikkarte ein. Bei NVIDIA-Karten klappt das, sobald der proprietäre Treiber installiert ist. Auf dem Testrechner erschien so die GeForce GTX 1660 mit Auslastung, Grafikspeicher und Temperatur.
- d blendet die Dateisysteme im Arbeitsspeicher-Kasten aus und wieder ein.
btop merkt sich die Auswahl für den nächsten Start.
14. Prozessliste sortieren
Mit ← und → wechselst du die Spalte, nach der sortiert wird. Rechts oben im Kasten proc steht, welche gerade gilt, z. B. cpu lazy. r dreht die Reihenfolge um.
15. Prozesse filtern
Drücke f (oder /) und tippe einen Teil des Namens. Die Liste zeigt sofort nur noch passende Prozesse. Enter behält den Filter, Esc verwirft ihn.
16. Baumansicht einschalten
e zeigt, welches Programm welches andere gestartet hat. Ein zweiter Druck schaltet zurück.
17. Einzelnen Prozess genauer ansehen
Wähle einen Prozess mit ↑ und ↓ aus und drücke Enter. Über der Liste erscheinen Befehlszeile, Laufzeit, Speicherverbrauch und Lese- und Schreibmenge dieses Prozesses. Ein weiteres Enter schließt die Ansicht.
18. Programm beenden
Wähle den Prozess aus und drücke t. btop fragt nach, ob es das Signal SIGTERM senden soll. Bestätige mit Enter. k sendet stattdessen SIGKILL, s öffnet eine Liste aller Signale.
19. Farbschema wechseln
Esc (oder m) öffnet das Menü, darin führt Options zu den Einstellungen. Unter Color theme wählst du mit ← und → eines der über 30 mitgelieferten Farbschemata, etwa adwaita für helle Terminals. Esc schließt das Menü wieder. Die Einstellungen öffnen sich auch direkt mit o.
20. btop beenden
Drücke q.
Wie geht es weiter?
- Prozesse anderer Benutzer beenden: Mit
sudo htopodersudo btopgilt das für alle Prozesse. Dann ist Vorsicht geboten, denn ein Signal an einen falschen Prozess kann das System stören. - Aktualisierungsrate:
htop -d 10erneuert die Anzeige jede Sekunde (Angabe in Zehntelsekunden, Vorgabe 1,5 Sekunden). In btop steht die Rate unter Options bei Update ms. - Nur einen Benutzer zeigen:
htop -u www-datazeigt nur die Prozesse des Webservers. - Dokumentation:
man htopundbtop --help, ausführlich unter https://htop.dev und https://github.com/aristocratos/btop
Deinstallieren
1. htop und btop entfernen
sudo apt purge htop btop
2. Eigene Einstellungen löschen
Die Einstellungsdateien liegen in deinem Home-Ordner und gehören zu keinem Paket.
rm -rf ~/.config/htop ~/.config/btop
Prüfen: Beide Befehle werden nicht mehr gefunden.
htop --version
btop --version
Quellen und Lizenz
- Offizielle Dokumentation: https://htop.dev/
- Lizenz: htop und btop steht unter der GPL-2.0 / Apache-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.
Zabbix
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zabbix überwacht Rechner, Dienste und Netzwerkgeräte rund um die Uhr, speichert die Messwerte in einer Datenbank und meldet Probleme, sobald ein Grenzwert überschritten ist oder ein Gerät nicht mehr antwortet. Anders als Prometheus bringt es eine vollständige Weboberfläche mit, in der Hosts, Vorlagen, Alarme und Diagramme per Mausklick eingerichtet werden, und es liefert über 350 fertige Vorlagen für Linux, Windows, Datenbanken, Webserver und vieles mehr. Diese Anleitung installiert den Zabbix-Server mit PostgreSQL als Datenbank, den Agenten für den eigenen Rechner und die Weboberfläche hinter nginx, alles nur lokal erreichbar.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Zabbix 7.0 in der Paketquelle universe. Die Reihe 7.0 ist eine Ausgabe mit langer Pflege (LTS). Neuere Zwischenstände und die Reihe 7.4 gibt es nur im eigenen apt-Archiv des Herstellers, das diese Anleitung nicht verwendet.
- Voraussetzungen: nginx und PostgreSQL müssen bereits installiert sein und laufen. PHP-FPM, das die Weboberfläche ausführt, installiert Schritt 2 gleich mit.
- Drei Bestandteile: Der Server fragt die Werte ab, legt sie in der Datenbank ab und prüft die Regeln. Der Agent 2 läuft auf jedem überwachten Rechner und liefert dessen Werte, hier die des eigenen Rechners. Die Weboberfläche ist eine PHP-Anwendung zum Anzeigen und Einrichten.
- Sofort gestartet: Server und Agent laufen direkt nach der Installation. Der Server findet seine Datenbank aber noch nicht und schreibt bis Schritt 8 alle zehn Sekunden eine Fehlermeldung in sein Protokoll. Das ist erwartet.
- Nur lokal: Ohne Anpassung lauscht der Server auf Port 10051 und der Agent auf Port 10050 an allen Netzwerkschnittstellen. Die Schritte 7 und 10 beschränken beide auf
127.0.0.1. Die Weboberfläche erreichst du unterhttp://127.0.0.1:8081. - Sprache: Die Oberfläche startet auf Englisch und wird in Schritt 22 auf Deutsch umgestellt. Die mitgelieferten Vorlagen, Auslöser und manche Meldungen bleiben englisch.
- Größe: Auf einem Rechner mit nginx, PHP-FPM und PostgreSQL kommen 12 Pakete hinzu. Die leere Datenbank belegt rund 65 MB. Der Server startet rund 50 Hilfsprozesse und braucht im Betrieb einige hundert MB Arbeitsspeicher.
- Version: Getestet mit Zabbix 7.0.22 und PostgreSQL 18 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Zabbix installieren
Der Befehl installiert den Server für PostgreSQL, die Weboberfläche, den Agenten 2 sowie PHP-FPM mit der PostgreSQL-Anbindung für PHP. --no-install-recommends verhindert, dass apt zusätzlich den Webserver Apache mitbringt.
sudo apt install --no-install-recommends zabbix-server-pgsql zabbix-frontend-php zabbix-agent2 php-fpm php-pgsql
3. Versionen prüfen
zabbix_server --version
Prüfen: Die erste Zeile lautet zabbix_server (Zabbix) 7.0.22.
zabbix_agent2 --version
Prüfen: Die erste Zeile lautet zabbix_agent2 (Zabbix) 7.0.22.
Datenbank anlegen
4. Datenbankbenutzer anlegen
Legt in PostgreSQL den Benutzer zabbix an. Der Befehl fragt zweimal nach einem Passwort für diesen Benutzer. Merke es dir, die Weboberfläche braucht es in Schritt 12.
sudo -u postgres createuser --pwprompt zabbix
5. Datenbank anlegen
Legt die leere Datenbank zabbix an und macht den gleichnamigen Benutzer zu ihrem Eigentümer.
sudo -u postgres createdb -O zabbix zabbix
6. Tabellen und Grunddaten einspielen
Das Paket bringt drei gepackte SQL-Dateien mit: den Aufbau der Tabellen, die Symbolbilder und die Grunddaten mit allen Vorlagen und dem Host „Zabbix server“. Der Befehl entpackt sie nacheinander und spielt sie über psql ein. psql fragt dabei nach dem Passwort aus Schritt 4. Das Einspielen dauert einige Sekunden.
zcat /usr/share/zabbix-server-pgsql/{schema,images,data}.sql.gz | psql -q -h localhost -U zabbix zabbix
Prüfen: Die Abfrage der Benutzer liefert nach erneuter Passworteingabe die beiden Einträge guest und Admin.
psql -h localhost -U zabbix -c "SELECT username FROM users;" zabbix
Server einrichten
7. Eigene Server-Einstellungen anlegen
Statt die lange Hauptdatei zu ändern, legst du eine kleine Ergänzungsdatei an. Der Server liest alle Dateien mit der Endung .conf in diesem Ordner zusätzlich ein.
sudo nano /etc/zabbix/zabbix_server.conf.d/lokal.conf
Trage diese drei Zeilen ein:
DBHost=
ListenIP=127.0.0.1
AllowSoftwareUpdateCheck=0
Was die Zeilen bewirken:
DBHost=ohne Wert lässt den Server über den lokalen Socket statt über das Netzwerk mit PostgreSQL sprechen. PostgreSQL erkennt dabei den Systembenutzerzabbixund lässt ihn ohne Passwort an die gleichnamige Datenbank. So steht kein Passwort in der Datei.ListenIP=127.0.0.1lässt den Server nur Verbindungen vom eigenen Rechner annehmen.AllowSoftwareUpdateCheck=0verhindert, dass Zabbix regelmäßig bei zabbix.com nach neuen Versionen fragt. Aktualisiert wird ohnehin überapt.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
8. Server neu starten
Erst jetzt verbindet sich der Server mit der Datenbank.
sudo systemctl restart zabbix-server
9. Prüfen, ob der Server läuft
sudo grep "database version" /var/log/zabbix-server/zabbix_server.log
Prüfen: Es erscheint eine Zeile mit current database version (mandatory/optional): 07000000/.... Der Server hat die Datenbank also gefunden.
ss -ltn | grep 10051
Prüfen: Die Zeile enthält 127.0.0.1:10051.
Agent einrichten
10. Eigene Agent-Einstellungen anlegen
Auch der Agent liest zusätzliche Dateien aus einem eigenen Ordner. Der Rest seiner Einstellungen passt schon: Er nimmt Anfragen vom Server unter 127.0.0.1 an und meldet sich unter dem Namen „Zabbix server“, den der vorbereitete Host in der Datenbank trägt.
sudo nano /etc/zabbix/zabbix_agent2.d/lokal.conf
Trage diese Zeile ein, speichere und schließe nano:
ListenIP=127.0.0.1
11. Agent neu starten
sudo systemctl restart zabbix-agent2
Prüfen: Die Zeile enthält 127.0.0.1:10050.
ss -ltn | grep 10050
Weboberfläche einrichten
12. Zugangsdaten für die Weboberfläche anlegen
Die Weboberfläche läuft unter dem Benutzer www-data und meldet sich deshalb mit Passwort bei PostgreSQL an. Ubuntu erwartet ihre Einstellungen unter /etc/zabbix/zabbix.conf.php. Fehlt die Datei, startet stattdessen ein Einrichtungsassistent, der sie aber mangels Schreibrechten nicht selbst speichern kann.
sudo nano /etc/zabbix/zabbix.conf.php
Trage Folgendes ein und ersetze DEIN-PASSWORT durch das Passwort aus Schritt 4. Hinter $ZBX_SERVER_NAME steht der Name, der später oben links in der Oberfläche erscheint.
<?php
$DB['TYPE'] = 'POSTGRESQL';
$DB['SERVER'] = 'localhost';
$DB['PORT'] = '0';
$DB['DATABASE'] = 'zabbix';
$DB['USER'] = 'zabbix';
$DB['PASSWORD'] = 'DEIN-PASSWORT';
$DB['SCHEMA'] = '';
$ZBX_SERVER_NAME = 'Mein Rechner';
$IMAGE_FORMAT_DEFAULT = IMAGE_FORMAT_PNG;
PORT mit dem Wert 0 steht für den Standardport von PostgreSQL. Speichere und schließe nano.
13. Datei der Gruppe www-data zuordnen
Die Datei enthält ein Passwort. Sie soll deshalb root gehören und nur für die Gruppe www-data lesbar sein, unter der PHP-FPM läuft.
sudo chown root:www-data /etc/zabbix/zabbix.conf.php
14. Leserechte einschränken
Entzieht allen anderen Benutzern das Leserecht.
sudo chmod 640 /etc/zabbix/zabbix.conf.php
15. nginx-Seite für Zabbix anlegen
Die Weboberfläche bekommt eine eigene Seite in nginx, die nur unter 127.0.0.1 auf Port 8081 lauscht. So bleibt die bestehende Standardseite unverändert.
sudo nano /etc/nginx/sites-available/zabbix
Trage Folgendes ein:
server {
listen 127.0.0.1:8081;
server_name localhost;
root /usr/share/zabbix;
index index.php;
location ~ ^/(conf|app|include|local|locale|vendor)/ {
deny all;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param PHP_VALUE "post_max_size=16M
max_execution_time=300
max_input_time=300";
}
}
Was die Blöcke bewirken:
rootzeigt auf den Ordner, in den das Paket die Weboberfläche installiert hat.- Der erste
location-Block sperrt die internen Ordner der Anwendung für den Browser. Er muss vor dem PHP-Block stehen, weil nginx bei solchen Mustern den ersten Treffer nimmt. - Der zweite
location-Block reicht PHP-Dateien an PHP-FPM weiter.PHP_VALUEsetzt nur für Zabbix die Grenzwerte, die die Oberfläche verlangt, ohne die allgemeinephp.inizu ändern.
Speichere und schließe nano.
16. Seite einschalten
nginx liest nur Seiten, die in sites-enabled verlinkt sind.
sudo ln -s /etc/nginx/sites-available/zabbix /etc/nginx/sites-enabled/zabbix
17. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Bei einem Fehler nennt nginx Datei und Zeile. Korrigiere sie mit nano, bevor du weitermachst.
18. nginx neu laden
sudo systemctl reload nginx
19. Weboberfläche abfragen
curl -s http://127.0.0.1:8081/ | grep "<title>"
Prüfen: Die Ausgabe enthält <title>Mein Rechner: Zabbix</title>.
Erste Anmeldung
20. Weboberfläche öffnen
xdg-open http://127.0.0.1:8081
21. Mit dem Startkonto anmelden
Gib bei Username Admin und bei Password zabbix ein und klicke auf Sign in. Groß- und Kleinschreibung zählen.
Es erscheint das Dashboard Global view. Oben steht unter Umständen eine rote Meldung Locale for language "en_US" is not found on the web server. Sie kommt auf deutsch eingerichteten Systemen ohne englisches Sprachpaket vor und verschwindet mit dem nächsten Schritt.
22. Sprache und Zeitzone einstellen
Öffne links Administration → General → GUI. Wähle bei Default language den Eintrag German (de_DE) und bei Default time zone den Eintrag Europe/Berlin. Klicke unten auf Update.
Prüfen: Oben erscheint Konfiguration geändert, und die Oberfläche ist nun deutsch. Die Einstellung gilt für alle Benutzer, die in ihrem Profil nichts anderes gewählt haben.
23. Eigenes Kennwort festlegen
Das Startkennwort zabbix ist allgemein bekannt. Öffne links unten Benutzereinstellungen → Profil und klicke auf Kennwort ändern. Trage bei Aktuelles Passwort zabbix ein, bei Kennwort und Kennwort (nochmal) dein neues Kennwort, und klicke auf Ändern.
Eine englische Rückfrage weist darauf hin, dass alle laufenden Sitzungen beendet werden. Bestätige mit OK. Zabbix meldet dich ab.
Prüfen: Die Anmeldung mit Admin und dem neuen Kennwort klappt.
Werte ansehen
24. Host prüfen
Öffne Überwachung → Hosts. Dort steht der Host Zabbix server mit der Schnittstelle 127.0.0.1:10050.
Prüfen: In der Spalte Verfügbarkeit leuchtet ZBX grün. Der Server erreicht den Agenten also. Ist das Feld grau, warte eine Minute und lade die Seite neu.
25. Aktuelle Werte ansehen
Klicke in derselben Zeile auf Aktuelle Daten. Die Liste zeigt rund 130 Werte des Rechners, z. B. CPU utilization, Available memory oder den freien Platz der Dateisysteme, jeweils mit Zeitpunkt der letzten Abfrage. Ein Klick auf Diagramm am Zeilenende zeigt den Verlauf.
26. Systemzustand von Zabbix ansehen
Öffne Berichte → Systeminformation.
Prüfen: In der Zeile Zabbix-Server läuft steht Ja mit 127.0.0.1:10051.
27. Alarm ausprobieren
Halte den Agenten an, damit Zabbix ein Problem meldet.
sudo systemctl stop zabbix-agent2
Öffne nach etwa vier Minuten Überwachung → Probleme.
Prüfen: Es erscheint das Problem Linux: Zabbix agent is not available (for 3m) für den Host Zabbix server.
28. Agent wieder starten
sudo systemctl start zabbix-agent2
Prüfen: Nach ein bis zwei Minuten wechselt das Problem auf den Status ERLEDIGT und verschwindet kurz darauf aus der Liste.
Wie geht es weiter?
- Benachrichtigungen per E-Mail: Unter Alarme → Medientypen trägst du beim Typ Email deinen Mailserver ein. Danach hinterlegst du im eigenen Profil unter Medien die Empfängeradresse und schaltest unter Alarme → Aktionen → Auslöseraktionen die vorbereitete Aktion ein.
- Weitere Rechner überwachen: Auf dem anderen Rechner
zabbix-agent2installieren und in einer ErgänzungsdateiServer=undServerActive=auf die Adresse des Zabbix-Servers setzen. Dann darf der Server nicht mehr nur auf127.0.0.1lauschen, und die Firewall muss die Ports 10050 und 10051 zwischen beiden Rechnern freigeben. Im Browser legst du den Rechner unter Datenerfassung → Hosts → Neuer Host an und verbindest ihn mit der Vorlage Linux by Zabbix agent. - Fertige Vorlagen: Unter Datenerfassung → Vorlagen gibt es Vorlagen etwa für PostgreSQL, nginx, MySQL oder Webseiten-Prüfungen. Die zugehörigen Hinweise liegen unter
/usr/share/doc/zabbix-frontend-php/templates. - Darstellung in Grafana: Mit dem Zabbix-Plugin für Grafana lassen sich die Werte dort in eigenen Dashboards zeigen.
- Sicherung: Alle Einstellungen und Messwerte stecken in der Datenbank.
sudo -u postgres pg_dump -Fc zabbix > zabbix.dumpsichert sie, siehe PostgreSQL. - Dokumentation: https://www.zabbix.com/documentation/7.0/de/manual sowie die Hinweise unter
/usr/share/doc/zabbix-server-pgsql/README.Debian
Deinstallieren
1. nginx-Seite löschen
sudo rm /etc/nginx/sites-enabled/zabbix /etc/nginx/sites-available/zabbix
2. nginx neu laden
sudo systemctl reload nginx
3. Zabbix entfernen
Entfernt Server, Weboberfläche und Agent samt ihren Einstellungen, der Datei /etc/zabbix/zabbix.conf.php und den Protokollen. Die Dienste werden dabei angehalten. apt meldet, dass zwei Ordner unter /etc/zabbix nicht leer sind. Sie enthalten die eigenen Dateien aus den Schritten 7 und 10 und werden in Schritt 7 gelöscht.
sudo apt purge zabbix-server-pgsql zabbix-frontend-php zabbix-agent2
4. Mitinstallierte Pakete entfernen
Entfernt die Pakete, die Zabbix nachgezogen hat: das Ping-Werkzeug fping, die PHP-Erweiterung bcmath und einige Bibliotheken. PHP-FPM und die PostgreSQL-Anbindung für PHP bleiben erhalten, weil sie oft auch von anderen Anwendungen genutzt werden. Prüfe vor dem Bestätigen die Liste, die apt anzeigt: Steht dort ein Paket, das du für etwas anderes brauchst, brich mit n ab und lass es im Befehl weg.
sudo apt purge fping php-bcmath php8.5-bcmath libopenipmi0t64 libevent-core-2.1-7t64 libevent-extra-2.1-7t64 libevent-pthreads-2.1-7t64
Hinweis:
sudo apt autoremove --purgewürde diese Pakete ebenfalls finden, entfernt aber auch alles andere, was auf dem Rechner gerade als „nicht mehr benötigt“ gilt. Sieh dir deshalb die Liste genau an, falls du diesen Weg nimmst.
5. Datenbank löschen
Achtung: Damit sind alle Einstellungen und Messwerte von Zabbix unwiderruflich gelöscht.
sudo -u postgres dropdb zabbix
6. Datenbankbenutzer löschen
sudo -u postgres dropuser zabbix
7. Übrige Dateien löschen
Löscht den Ordner mit den beiden eigenen Ergänzungsdateien aus den Schritten 7 und 10, den das Paket zurücklässt.
sudo rm -rf /etc/zabbix
8. Systembenutzer entfernen
Die Installation hat den Benutzer zabbix angelegt, unter dem Server und Agent liefen.
sudo deluser zabbix
Prüfen: Der Befehl wird nicht mehr gefunden.
zabbix_server --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.zabbix.com/documentation/current
- Lizenz: Zabbix steht unter der GPL-2.0 / AGPL-3.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.
Cockpit
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Cockpit ist eine Verwaltungsoberfläche für Linux-Rechner im Browser. Sie zeigt Prozessor-, Speicher-, Platten- und Netzauslastung live an, durchsucht die Systemprotokolle, startet und stoppt Dienste, spielt Updates ein, verwaltet Benutzerkonten und Festplatten und öffnet bei Bedarf ein Terminal, alles ohne zusätzliche Software auf dem eigenen Rechner. Cockpit läuft nur, solange jemand angemeldet ist, und arbeitet direkt mit den Werkzeugen des Systems. Was du dort änderst, ist also dasselbe, als hättest du es im Terminal getan. Für dauerhafte Überwachung mit Alarmen eignet sich dagegen Zabbix oder Prometheus.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Cockpit 360 in den eigenen Paketquellen. Zusammen mit den empfohlenen Modulen für Speicher, Netzwerk und Updates kommen 8 kleine Pakete hinzu. Die Dienste dahinter (udisks2, NetworkManager, PackageKit) sind auf einem Ubuntu-Desktop bereits vorhanden.
- Anmeldung mit dem eigenen Konto: Cockpit hat keine eigenen Benutzer. Du meldest dich mit deinem normalen Ubuntu-Benutzernamen und -Passwort an. Die direkte Anmeldung als
rootist gesperrt. Wer zur Gruppesudogehört, kann in der Oberfläche den administrativen Zugang einschalten. - Sofort erreichbar: Cockpit lauscht direkt nach der Installation auf Port 9090 an allen Netzwerkschnittstellen. Damit könnte jeder im Netz die Anmeldeseite erreichen. Die Schritte 4 bis 8 beschränken das auf
127.0.0.1. Erledige sie daher gleich nach der Installation. - Port 9090: Auch Prometheus verwendet Port 9090. Läuft es auf dem Rechner, nimmst du in Schritt 5 eine andere Zahl wie
9091und ersetzt9090in den folgenden Schritten entsprechend. - Kein Verlauf: Cockpit zeigt die Auslastung nur live. Für den Verlauf über Stunden und Tage bräuchte es das Paket
cockpit-pcp, das es für Ubuntu 26.04 nicht gibt. - Sprache: Die Oberfläche richtet sich nach der Sprache des Browsers und erscheint auf einem deutschen System deutsch.
- Version: Installation, Beschränkung auf
127.0.0.1und Anmeldeseite getestet mit Cockpit 360 am 2. Oktober 2026. Die Bedienung nach der Anmeldung ab Schritt 12 ist nicht selbst durchgeklickt. Die Menünamen stammen aus den deutschen Sprachdateien des Pakets.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Cockpit installieren
Installiert Cockpit samt den empfohlenen Modulen für Speicher, Netzwerk und Software-Updates.
sudo apt install cockpit
3. Version prüfen
cockpit-bridge --version
Prüfen: Die erste Zeile lautet Version: 360.
Nur lokal erreichbar machen
Cockpit wird von systemd über einen sogenannten Socket gestartet: systemd hält den Port offen und startet Cockpit erst, wenn sich jemand verbindet. Die Adresse, auf der gelauscht wird, steht deshalb in der Socket-Einheit cockpit.socket. Eine kleine Ergänzungsdatei ändert sie, ohne die Datei des Pakets anzufassen.
4. Ordner für die Ergänzung anlegen
sudo mkdir -p /etc/systemd/system/cockpit.socket.d
5. Ergänzungsdatei anlegen
sudo nano /etc/systemd/system/cockpit.socket.d/lokal.conf
Trage Folgendes ein:
[Socket]
ListenStream=
ListenStream=127.0.0.1:9090
Die erste Zeile ListenStream= ohne Wert löscht die Vorgabe des Pakets (Port 9090 an allen Schnittstellen). Die zweite legt die neue Adresse fest. Ohne die leere Zeile würde Cockpit zusätzlich auf beiden Adressen lauschen.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
6. systemd die Änderung mitteilen
sudo systemctl daemon-reload
7. Socket neu starten
Erst damit übernimmt systemd die neue Adresse.
sudo systemctl restart cockpit.socket
8. Prüfen, dass Cockpit nur lokal lauscht
ss -ltn | grep 9090
Prüfen: Es erscheint genau eine Zeile, und sie enthält 127.0.0.1:9090. Steht dort *:9090, stimmt die Ergänzungsdatei nicht.
Erste Anmeldung
9. Cockpit im Browser öffnen
Bei Verbindungen vom eigenen Rechner erlaubt Cockpit einfaches http. Von anderen Rechnern aus würde es auf https umleiten.
xdg-open http://127.0.0.1:9090
Prüfen: Die Anmeldeseite zeigt den Namen des Rechners, darunter „Melden Sie sich mit dem Server-Benutzerkonto an.“ und die Felder Benutzername und Passwort.
10. Anmelden
Gib deinen Ubuntu-Benutzernamen und dein Passwort ein und klicke auf Anmelden.
11. Administrativen Zugang einschalten
Nach der Anmeldung läuft Cockpit mit den Rechten deines Benutzers. Oben steht dann Eingeschränkter Zugang, und manche Bereiche lassen sich nur ansehen. Gehörst du zur Gruppe sudo, klicke auf Eingeschränkter Zugang und dann auf Authentifiziere. Nach Eingabe deines Passworts steht dort Administrativer Zugang, und Cockpit darf so viel wie sudo im Terminal.
Hinweis: Mit administrativem Zugang wirken Klicks auf Neustart, Stoppen oder Alle Aktualisierungen installieren sofort und ohne weitere Rückfrage auf das System. Schalte den Zugang über denselben Knopf wieder ab, wenn du nur nachsehen willst.
Rundgang
12. Überblick ansehen
Die Seite Überblick ist in vier Kästen geteilt:
- Meldungen zeigt, ob Updates anstehen oder Dienste ausgefallen sind.
- Nutzung zeigt die aktuelle Auslastung von CPU und Speicher. Ein Klick auf Metriken und Verlauf ansehen öffnet eine genauere Ansicht mit Last, Festplatten-E/A, Netzwerk und den Diensten, die gerade am meisten Rechenzeit und Speicher brauchen.
- Systeminformationen nennt Hardware, Betriebssystem und Laufzeit.
- Konfiguration zeigt Rechnername, Systemzeit und weitere Grundeinstellungen.
13. Protokolle durchsuchen
Öffne links Protokolle. Cockpit zeigt die Einträge des systemd-Journals, die neuesten zuerst. Über Priorität schränkst du auf wichtige Meldungen ein, z. B. Fehler und höher. Ein Klick auf eine Zeile zeigt alle Angaben zu diesem Eintrag.
Im Terminal entspricht das ungefähr diesem Befehl:
journalctl -p err -b
14. Dienste ansehen
Öffne links Dienste. Die Liste zeigt alle systemd-Dienste mit ihrem Zustand, etwa Läuft oder Läuft nicht. Oben wechselst du zu Ziele, Sockets und Timer. Ein Klick auf einen Dienst zeigt seine letzten Protokollzeilen. Mit administrativem Zugang stehen dort auch Neustarten und Stoppen zur Verfügung.
15. Updates prüfen
Öffne links Aktualisierungen. Cockpit fragt über PackageKit dieselben Paketquellen ab wie apt und listet anstehende Updates, Sicherheitsupdates werden eigens markiert. Alle Aktualisierungen installieren spielt sie ein. Danach schlägt Cockpit gegebenenfalls vor, betroffene Dienste neu starten oder den Rechner neu zu starten.
16. Weitere Bereiche
- Speicher zeigt Festplatten, Partitionen und Dateisysteme samt Belegung und kann neue Laufwerke einrichten.
- Netzwerk zeigt die Schnittstellen mit ihrem Datenverkehr und verwaltet die Verbindungen von NetworkManager.
- Konten legt Benutzer an, setzt Passwörter mit Passwort setzen und sperrt Konten mit Konto sperren.
- Terminal öffnet eine Shell als dein Benutzer direkt im Browser.
17. Abmelden
Klicke oben rechts auf deinen Benutzernamen und dann auf Abmelden. Ohne angemeldete Sitzung beendet sich Cockpit nach kurzer Zeit von selbst und belegt keinen Arbeitsspeicher mehr. Nur systemd hält den Port weiter offen.
Wie geht es weiter?
- Dateien verwalten: Das Zusatzmodul
cockpit-filesbringt einen einfachen Dateimanager in die Oberfläche:sudo apt install cockpit-files. Danach erscheint links der Eintrag Dateien. - Virtuelle Maschinen:
cockpit-machinesverwaltet virtuelle Maschinen mit KVM und libvirt. Es zieht diese Virtualisierungspakete mit. - Von anderen Rechnern aus: Statt den Port im Netz freizugeben, kannst du von einem anderen Rechner aus einen SSH-Tunnel aufbauen:
ssh -L 9090:127.0.0.1:9090 BENUTZER@RECHNERund dann dorthttp://127.0.0.1:9090öffnen. - Dokumentation: https://cockpit-project.org/documentation.html sowie
man cockpit.confundman cockpit-ws
Deinstallieren
1. Socket anhalten
sudo systemctl stop cockpit.socket cockpit.service
2. Cockpit entfernen
Entfernt Cockpit und die mitinstallierten Module samt Einstellungen. libpwquality-tools ist ein Hilfspaket für Passwortprüfungen, das nur Cockpit nachgezogen hat. apt meldet, dass der Ordner /etc/cockpit/ws-certs.d nicht leer ist. Darin liegt das selbst erzeugte Zertifikat für https. Den Ordner löscht Schritt 3.
sudo apt purge cockpit cockpit-bridge cockpit-ws cockpit-system cockpit-networkmanager cockpit-packagekit cockpit-storaged libpwquality-tools
3. Übrige Dateien löschen
Löscht das Zertifikat und die eigene Ergänzungsdatei aus Schritt 5.
sudo rm -r /etc/cockpit /etc/systemd/system/cockpit.socket.d
4. systemd die Änderung mitteilen
sudo systemctl daemon-reload
Prüfen: Port 9090 ist frei, der Befehl gibt nichts aus.
ss -ltn | grep 9090
Quellen und Lizenz
- Offizielle Dokumentation: https://cockpit-project.org/documentation/
- Lizenz: Cockpit steht unter der LGPL-2.1.
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.
vnStat
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
vnStat zählt dauerhaft mit, wie viele Daten über jede Netzwerkschnittstelle empfangen und gesendet werden, und hält das in Fünf-Minuten-, Stunden-, Tages-, Monats- und Jahressummen fest. So siehst du jederzeit, wie viel Verkehr der Rechner heute, in diesem Monat oder seit der Installation verursacht hat, etwa bei einem Tarif mit Volumengrenze oder um einen auffälligen Upload zu entdecken. vnStat liest dafür nur die Zähler, die der Linux-Kernel ohnehin führt, und belastet den Rechner praktisch nicht.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert vnStat 2.13. Das Paket
vnstatierzeugt aus denselben Daten PNG-Grafiken und ist optional. - Dienst: Ein kleiner Hintergrunddienst liest die Zähler alle paar Sekunden und schreibt sie alle 5 Minuten in eine SQLite-Datenbank unter
/var/lib/vnstat. Erste Zahlen erscheinen deshalb erst nach einigen Minuten. - Ab jetzt: vnStat zählt nur, was nach der Installation passiert. Ältere Daten gibt es nicht.
- Kein Netzwerkzugriff: vnStat öffnet keinen Port und sendet nichts. Es zeigt nur Mengen, nicht welche Programme oder Gegenstellen den Verkehr verursacht haben.
- Englische Ausgabe: Die Tabellen sind englisch beschriftet (rx = empfangen, tx = gesendet, total = Summe).
- Version: Getestet mit vnStat 2.13 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. vnStat installieren
Installiert vnStat und das Grafikwerkzeug vnstati. Der Dienst startet sofort und legt für jede gefundene Netzwerkschnittstelle einen Eintrag in seiner Datenbank an.
sudo apt install vnstat vnstati
3. Version prüfen
vnstat --version
Prüfen: Die Ausgabe beginnt mit vnStat 2.13.
4. Prüfen, ob der Dienst läuft
systemctl is-active vnstat
Prüfen: Die Ausgabe lautet active.
Schnittstellen festlegen
5. Überwachte Schnittstellen ansehen
vnstat --iflist
Die Ausgabe nennt alle Schnittstellen, die der Kernel kennt, z. B. Available interfaces: enp3s0 (1000 Mbit) wlp0s20f3. Namen mit en… sind Netzwerkkabel, wl… steht für WLAN. Die Zahl in Klammern ist die erkannte Geschwindigkeit.
vnstat
Prüfen: Für jede Schnittstelle erscheint eine Zeile. Kurz nach der Installation steht dort noch No data.
6. Unbenutzte Schnittstelle entfernen (optional)
Nutzt der Rechner nur das Kabel, kann die WLAN-Schnittstelle aus der Datenbank. Ersetze wlp0s20f3 durch den Namen aus Schritt 5. --force bestätigt das Löschen der bisher gezählten Daten dieser Schnittstelle.
sudo vnstat --remove -i wlp0s20f3 --force
Prüfen: Die Ausgabe lautet Interface "wlp0s20f3" removed from database. Wird die Schnittstelle später doch gebraucht, nimmt sudo vnstat --add -i wlp0s20f3 sie wieder auf.
Verkehr ansehen
7. Aktuelle Übertragungsrate messen
Dieser Befehl misst fünf Sekunden lang und braucht keine gespeicherten Daten. Ersetze enp3s0 durch deine Schnittstelle.
vnstat -tr 5 -i enp3s0
Prüfen: Es erscheinen zwei Zeilen mit rx und tx, jeweils in kbit/s oder Mbit/s und Paketen pro Sekunde.
8. Live mitverfolgen
Zeigt die Rate fortlaufend an, bis du mit Strg+C abbrichst.
vnstat -l -i enp3s0
9. Übersicht anzeigen
Nach den ersten 5 Minuten hat der Dienst Daten gespeichert.
vnstat
Prüfen: Oben steht Database updated: mit der Uhrzeit der letzten Speicherung, darunter die Summe seit der Installation sowie je eine kleine Tabelle monthly und daily. Die Zeile estimated rechnet den bisherigen Verbrauch auf den ganzen Tag oder Monat hoch. Direkt nach der Installation ist diese Hochrechnung noch unbrauchbar und wird mit der Zeit genauer.
10. Andere Zeiträume anzeigen
Jeder Schalter zeigt eine eigene Tabelle:
| Befehl | Zeigt |
|---|---|
vnstat -5 | Fünf-Minuten-Abschnitte |
vnstat -h | Stunden |
vnstat -d | Tage |
vnstat -m | Monate |
vnstat -y | Jahre |
vnstat -t | die Tage mit dem meisten Verkehr |
Zum Beispiel die Tagesübersicht:
vnstat -d
Mit -i enp3s0 beschränkst du jede Ausgabe auf eine Schnittstelle.
Grafiken erzeugen
11. Zusammenfassung als Bild speichern
vnstati nimmt dieselben Schalter wie vnstat. -s erzeugt eine Zusammenfassung mit Kreisdiagrammen für heute und den laufenden Monat, -o legt die Ausgabedatei fest.
vnstati -s -i enp3s0 -o ~/vnstat-uebersicht.png
12. Bild ansehen
xdg-open ~/vnstat-uebersicht.png
Prüfen: Das Bild zeigt den Namen der Schnittstelle, die Mengen für today und den Monat sowie rechts all time. Weitere Bilder liefern z. B. vnstati -h für Stunden oder vnstati -d für Tage.
Einstellungen anpassen
13. Einstellungsdatei öffnen
Alle Einstellungen stehen in /etc/vnstat.conf. Zeilen, die mit ; beginnen, sind auskommentiert und zeigen den Standardwert.
sudo nano /etc/vnstat.conf
14. Monatswechsel und Einheiten ändern
Zwei Einstellungen sind besonders nützlich. Suche die Zeilen mit Strg+W, entferne das ; am Anfang und ändere den Wert:
MonthRotate 15lässt den Abrechnungsmonat am 15. statt am 1. beginnen, passend zum Stichtag eines Mobilfunk- oder Internettarifs. Das gilt für alle ab dann gezählten Daten.UnitMode 2zeigt Mengen in Dezimal-Einheiten (kB, MB, GB) wie die meisten Anbieter. Standard ist0mit binären Einheiten (KiB, MiB, GiB), die rund 5 bis 7 Prozent kleinere Zahlen ergeben.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
15. Dienst neu starten
Damit der Dienst die geänderten Einstellungen übernimmt.
sudo systemctl restart vnstat
Prüfen: vnstat -m zeigt die Mengen nun z. B. in MB statt MiB.
vnstat -m
Wie geht es weiter?
- Weiterverarbeiten:
vnstat --jsongibt alle Daten maschinenlesbar aus,vnstat --onelineeine einzige Zeile mit durch;getrennten Werten, gut für eigene Skripte. - Grafiken im Browser: Ein Cron-Job kann mit
vnstatiregelmäßig Bilder in einen Ordner schreiben, den nginx ausliefert. - Welche Programme senden? vnStat sieht nur Mengen. Für die Aufteilung nach Programmen eignen sich
nethogsoderiftop(beide über apt), für einen Gesamtüberblick über den Rechner Glances oder btop. - Dokumentation:
man vnstat,man vnstati,man vnstat.confund https://humdi.net/vnstat/
Deinstallieren
1. vnStat entfernen
Entfernt beide Programme, die Einstellungsdatei, die Datenbank mit allen gezählten Daten und den Systembenutzer vnstat. Achtung: Die Verkehrsstatistik ist danach unwiderruflich gelöscht.
sudo apt purge vnstat vnstati
2. Erzeugte Bilder löschen (optional)
rm -f ~/vnstat-uebersicht.png
Prüfen: Der Befehl wird nicht mehr gefunden.
vnstat --version
Quellen und Lizenz
- Offizielle Dokumentation: https://humdi.net/vnstat/
- Lizenz: vnStat steht unter der 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.
Munin
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Munin zeichnet alle fünf Minuten Dutzende Messwerte eines Rechners auf, etwa Prozessorlast, Arbeitsspeicher, Plattenbelegung, Netzverkehr oder die Zahl der Prozesse, und macht daraus fertige Verlaufsgrafiken für Tag, Woche, Monat und Jahr. Die Grafiken liegen als einfache Webseiten vor, die ein Webserver wie nginx ausliefert. Munin ist damit schnell eingerichtet und eignet sich gut, um im Nachhinein zu sehen, wann und wie sich ein Rechner verändert hat. Für Live-Werte eignet sich dagegen Cockpit oder btop, für eine umfangreiche Überwachung mit Benachrichtigungen Zabbix.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Munin 2.0.76. Mit
--no-install-recommendskommen 20 Pakete hinzu, mit den Empfehlungen wären es über 80, darunter viele zusätzliche Messskripte, die für einen einzelnen Rechner nicht nötig sind. - Zwei Teile: Der Node (
munin-node) liefert die Messwerte des Rechners. Der Master (munin) holt sie per Cron-Job alle fünf Minuten ab, speichert sie in RRD-Dateien unter/var/lib/muninund erzeugt daraus Grafiken und HTML-Seiten unter/var/cache/munin/www. - Voraussetzung: nginx muss installiert sein. Es liefert die fertigen Seiten unter
http://127.0.0.1:8082aus. - Nur lokal: Der Node nimmt zwar nur Anfragen von
127.0.0.1an, lauscht aber zunächst auf Port 4949 an allen Schnittstellen. Schritt 5 beschränkt ihn ganz auf den eigenen Rechner. - Englische Oberfläche: Seiten und Grafiktitel sind englisch, nur die Wochentage an den Achsen erscheinen deutsch.
- Plugins: Jede Grafik stammt von einem kleinen Messskript (Plugin). Bei der Installation prüft Munin, welche Plugins auf dem Rechner sinnvoll sind, und schaltet etwa 30 davon ein.
- Version: Getestet mit Munin 2.0.76 am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Munin installieren
Installiert Master und Node. Der Node startet sofort, der Cron-Job des Masters läuft ab jetzt alle fünf Minuten.
sudo apt install --no-install-recommends munin munin-node
3. Prüfen, ob der Node läuft
systemctl is-active munin-node
Prüfen: Die Ausgabe lautet active.
4. Einen Messwert direkt abfragen
munin-run führt ein einzelnes Plugin aus und zeigt, was es an den Master liefern würde, hier die Systemlast.
sudo munin-run load
Prüfen: Die Ausgabe lautet z. B. load.value 0.32.
Node einrichten
5. Node auf den eigenen Rechner beschränken
sudo nano /etc/munin/munin-node.conf
Suche mit Strg+W die Zeile
host *
und ändere sie in
host 127.0.0.1
Damit lauscht der Node nur noch auf der lokalen Adresse. Die Zeilen allow ^127\.0\.0\.1$ und allow ^::1$ darüber legen fest, wer Werte abholen darf. Sie bleiben unverändert. Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
6. Node neu starten
sudo systemctl restart munin-node
Prüfen: Die Zeile enthält 127.0.0.1:4949.
ss -ltn | grep 4949
Master einrichten
7. Rechner einen Namen geben
Ab Werk führt Munin den Rechner als localhost.localdomain in der Gruppe localdomain. Ein eigener Name macht die Seiten übersichtlicher.
sudo nano /etc/munin/munin.conf
Suche ganz unten den Block
[localhost.localdomain]
address 127.0.0.1
use_node_name yes
und ändere die erste Zeile z. B. in
[Zuhause;meinrechner]
Vor dem Semikolon steht die Gruppe, dahinter der Name des Rechners. Leerzeichen sind nicht erlaubt. address bleibt 127.0.0.1, denn dort läuft der Node. Speichere und schließe nano.
8. Daten unter dem alten Namen löschen
Hat der Cron-Job seit der Installation schon gelaufen, liegen Daten unter dem alten Namen vor. Sie würden sonst als Reste liegen bleiben.
sudo rm -rf /var/lib/munin/localdomain /var/cache/munin/www/localdomain /var/lib/munin/state-localdomain-localhost.localdomain.storable
9. Ersten Durchlauf von Hand starten
Statt bis zu fünf Minuten auf den Cron-Job zu warten, startest du ihn einmal selbst. Er muss als Benutzer munin laufen, dem die Daten gehören. Der Durchlauf dauert etwa zehn Sekunden.
sudo -u munin munin-cron
Prüfen: Im Ordner der Webseiten liegt nun ein Unterordner mit dem Gruppennamen, z. B. Zuhause, neben vielen HTML-Dateien.
ls /var/cache/munin/www
Webseiten ausliefern
10. nginx-Seite für Munin anlegen
Die Seiten sind fertiges HTML mit PNG-Grafiken. nginx muss sie nur ausliefern, PHP oder Ähnliches ist nicht nötig.
sudo nano /etc/nginx/sites-available/munin
Trage Folgendes ein:
server {
listen 127.0.0.1:8082;
server_name localhost;
root /var/cache/munin/www;
index index.html;
}
Speichere und schließe nano.
11. Seite einschalten
sudo ln -s /etc/nginx/sites-available/munin /etc/nginx/sites-enabled/munin
12. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
13. nginx neu laden
sudo systemctl reload nginx
14. Seiten im Browser öffnen
xdg-open http://127.0.0.1:8082
Prüfen: Die Übersichtsseite zeigt links Problems mit Critical (0), Warning (0) und Unknown (0), darunter die Gruppe und die Kategorien wie disk, network, processes und system. Rechts steht deine Gruppe mit dem Rechnernamen.
Grafiken ansehen
15. Rechner öffnen
Klicke auf den Rechnernamen, z. B. meinrechner. Die Seite zeigt alle Grafiken nach Kategorien geordnet, jeweils für den Tag und die Woche. Ein Klick auf eine Grafik öffnet sie zusätzlich für Monat und Jahr.
Kurz nach der Installation zeigen die Grafiken nur einen kurzen Strich am rechten Rand. Mit jedem Durchlauf alle fünf Minuten wächst die Linie, nach einigen Stunden ergibt sich ein aussagekräftiger Verlauf. Unter jeder Grafik stehen der aktuelle Wert (Cur) sowie Minimum, Durchschnitt und Maximum des Zeitraums.
16. Kategorien vergleichen
Die Links d w m y neben einer Kategorie in der linken Spalte zeigen eine Grafik aller Rechner für Tag, Woche, Monat oder Jahr. Bei nur einem Rechner ist das eine schnelle Möglichkeit, z. B. alle Netzwerkgrafiken der letzten Woche untereinander zu sehen.
Plugins verwalten (optional)
17. Vorschläge ansehen
munin-node-configure prüft alle mitgelieferten Plugins. Die Spalte Used zeigt, ob ein Plugin eingeschaltet ist, Suggestions, ob es auf diesem Rechner funktionieren würde.
sudo munin-node-configure --suggest
Bei Plugins mit no steht in eckigen Klammern der Grund, z. B. dass ein Dienst nicht läuft.
18. Unnötiges Plugin abschalten
Eingeschaltete Plugins sind Verknüpfungen in /etc/munin/plugins. Nutzt der Rechner z. B. kein WLAN, entfernst du die beiden Grafiken der WLAN-Schnittstelle. Ersetze wlp0s20f3 durch den Namen aus ls /etc/munin/plugins.
sudo rm /etc/munin/plugins/if_wlp0s20f3 /etc/munin/plugins/if_err_wlp0s20f3
19. Node neu starten
Der Node liest die Plugins nur beim Start ein.
sudo systemctl restart munin-node
Prüfen: Die beiden Plugins tauchen nicht mehr auf.
ls /etc/munin/plugins
Wie geht es weiter?
- nginx überwachen: Die Plugins
nginx_requestundnginx_statuszeigen Anfragen und Verbindungen von nginx. Sie brauchen in nginx eine lokale Statusseite mitstub_statusunterhttp://localhost/nginx_status. - Weitere Rechner: Auf dem anderen Rechner nur
munin-nodeinstallieren, dort in/etc/munin/munin-node.confdie Adresse des Munin-Masters mit einer weiterenallow-Zeile erlauben und Port 4949 in der Firewall nur für diesen Master öffnen. Im Master bekommt jeder Rechner inmunin.confeinen eigenen Block mit seineraddress. - Grenzwerte: In
munin.conflassen sich für einzelne Wertewarning- undcritical-Grenzen setzen. Überschreitungen erscheinen links unter Problems. - Dokumentation: https://guide.munin-monitoring.org sowie
/usr/share/doc/munin/README.Debian.gz
Deinstallieren
1. nginx-Seite löschen
sudo rm /etc/nginx/sites-enabled/munin /etc/nginx/sites-available/munin
2. nginx neu laden
sudo systemctl reload nginx
3. Munin entfernen
Entfernt Master, Node und die mitinstallierten Pakete, darunter rrdtool und einige Perl-Bibliotheken. Prüfe vor dem Bestätigen die Liste, die apt anzeigt: Steht dort ein Paket, das du für etwas anderes brauchst, brich mit n ab und lass es im Befehl weg.
sudo apt purge munin munin-node munin-common munin-plugins-core rrdtool librrds-perl librrd8t64 libdbi1t64 liblog-log4perl-perl libhtml-template-perl libcgi-pm-perl libfile-copy-recursive-perl libio-socket-inet6-perl libsocket6-perl liblist-moreutils-perl liblist-moreutils-xs-perl libexporter-tiny-perl libnet-server-perl libnet-cidr-perl libio-multiplex-perl
apt meldet dabei, dass mehrere Ordner nicht leer sind. Sie enthalten die gesammelten Daten und werden im nächsten Schritt gelöscht.
4. Übrige Dateien löschen
Löscht Einstellungen, Messdaten, Webseiten und Protokolle. Achtung: Alle aufgezeichneten Verläufe sind danach unwiderruflich weg.
sudo rm -rf /etc/munin /var/lib/munin /var/cache/munin /var/log/munin /run/munin
5. Systembenutzer entfernen
Die Installation hat den Benutzer munin und eine gleichnamige Gruppe angelegt.
sudo deluser munin
Prüfen: Port 4949 ist frei, der Befehl gibt nichts aus.
ss -ltn | grep 4949
Quellen und Lizenz
- Offizielle Dokumentation: https://munin.readthedocs.io/
- Lizenz: Munin steht unter der 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.
Uptime Kuma
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Uptime Kuma prüft in festen Abständen, ob Websites, Server und Dienste erreichbar sind, und meldet sich, sobald etwas ausfällt oder ein TLS-Zertifikat bald abläuft. Es beherrscht unter anderem Abfragen per HTTP(S) mit Suche nach einem Schlüsselwort, Ping, offene TCP-Ports und DNS-Einträge. Die Ergebnisse zeigt es als übersichtliches Dashboard mit Verfügbarkeit und Antwortzeiten und auf Wunsch als öffentliche Statusseite. Benachrichtigungen verschickt es über mehr als 90 Wege, etwa E-Mail, Telegram, Matrix oder ntfy. Während Zabbix oder Munin vor allem das Innere eines Rechners beobachten, schaut Uptime Kuma von außen auf die Dienste.
Hinweis: nicht selbst getestet. Diese Anleitung beruht auf der offiziellen Dokumentation von Uptime Kuma (README und Wiki, Stand 2. Oktober 2026). Selbst geprüft wurden nur das Herunterladen des Quellcodes von Version 2.5.5 und die Installation der Abhängigkeiten mit
npm ci(Schritte 7 und 8) mit Node.js 22.22 und npm 9.2 aus Ubuntu. Das Herunterladen der vorgebauten Oberfläche, der Start des Dienstes und die Bedienung im Browser wurden für dieses Buch nicht ausprobiert. Die Menünamen stammen aus der deutschen Sprachdatei des Programms. Befehle und Ausgaben können daher von der Beschreibung abweichen.
Vorbemerkungen
- Kein apt-Paket: Ubuntu 26.04 enthält Uptime Kuma nicht. Das Projekt bietet außer Docker nur die Installation aus dem Quellcode mit Node.js an. Node.js, npm und git kommen dabei aus den Ubuntu-Paketquellen. Uptime Kuma 2.5.5 braucht Node.js ab Version 20.4, Ubuntu liefert 22.22.
- Eigener Systembenutzer: Uptime Kuma läuft unter einem eigenen Benutzer
uptime-kumaohne Anmeldemöglichkeit. Programm und Daten liegen unter/opt/uptime-kuma, die Daten im Unterordnerdatain einer SQLite-Datenbank. - Nur lokal: Ohne Einstellung lauscht Uptime Kuma auf Port 3001 an allen Netzwerkschnittstellen. Der systemd-Dienst in Schritt 10 beschränkt das auf
127.0.0.1. - Eigenes Konto: Uptime Kuma hat eine eigene Benutzerverwaltung. Beim ersten Aufruf legst du das Administrator-Konto an. Bis dahin könnte jeder, der die Seite erreicht, das Konto anlegen. Auch deshalb bleibt sie auf
127.0.0.1. - Größe: Auf einem Rechner ohne npm zieht
npmaus Ubuntu viele kleinenode-*-Pakete nach (je nach Rechner über 100). Uptime Kuma selbst installiert rund 650 npm-Pakete in seinen eigenen Ordner. - Version: Uptime Kuma 2.5.5 vom 16. September 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js, npm und git installieren
sudo apt install nodejs npm git
Prüfen: Die Ausgabe beginnt mit v22.
/usr/bin/node --version
Hinweis: Die Anleitung ruft
nodeundnpmübersudoauf. Dabei gelten immer die Programme aus Ubuntu unter/usr/bin, auch wenn du für deinen Benutzer mitnvmeine andere Node.js-Version eingerichtet hast.
3. Systembenutzer anlegen
Legt den Benutzer uptime-kuma ohne Passwort und ohne Anmelde-Shell an. --system macht ihn zu einem Dienstkonto, --home-dir legt /opt/uptime-kuma als sein Heimatverzeichnis fest.
sudo useradd --system --home-dir /opt/uptime-kuma --shell /usr/sbin/nologin uptime-kuma
4. Programmordner anlegen
sudo mkdir /opt/uptime-kuma
5. Ordner dem Systembenutzer übergeben
So laufen alle weiteren Schritte unter uptime-kuma statt unter root. Die Installationsskripte der npm-Pakete bekommen dadurch keine Administratorrechte.
sudo chown uptime-kuma:uptime-kuma /opt/uptime-kuma
6. In den Programmordner wechseln
cd /opt/uptime-kuma
7. Quellcode herunterladen
Lädt genau die Version 2.5.5 von GitHub in den leeren Ordner. --depth 1 lässt die ältere Versionsgeschichte weg. -u uptime-kuma -H führt den Befehl als Systembenutzer mit dessen Heimatverzeichnis aus.
sudo -u uptime-kuma -H git clone --branch 2.5.5 --depth 1 https://github.com/louislam/uptime-kuma.git /opt/uptime-kuma
Prüfen: Die Datei package.json ist vorhanden.
ls /opt/uptime-kuma/package.json
8. Abhängigkeiten installieren
Installiert die npm-Pakete, die der Server braucht, in den Unterordner node_modules. --omit dev lässt Entwicklerwerkzeuge weg, --no-audit die Sicherheitsabfrage bei npm. Das dauert etwa eine halbe Minute.
sudo -u uptime-kuma -H npm ci --omit dev --no-audit
Prüfen: Die letzte Zeile meldet etwa added 652 packages.
9. Vorgebaute Oberfläche herunterladen
Die Weboberfläche wird nicht auf dem eigenen Rechner gebaut. Dieses Skript lädt sie als fertiges Archiv von der Release-Seite auf GitHub und packt sie in den Ordner dist aus.
sudo -u uptime-kuma -H npm run download-dist
Prüfen: Im Ordner dist liegt eine Datei index.html.
ls /opt/uptime-kuma/dist/index.html
Als Dienst einrichten
10. systemd-Dienst anlegen
Das Projekt empfiehlt den Prozessverwalter pm2. Mit systemd geht es ohne weiteres Werkzeug, und der Dienst startet beim Hochfahren mit.
sudo nano /etc/systemd/system/uptime-kuma.service
Trage Folgendes ein:
[Unit]
Description=Uptime Kuma
Documentation=https://github.com/louislam/uptime-kuma
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=uptime-kuma
WorkingDirectory=/opt/uptime-kuma
Environment=UPTIME_KUMA_HOST=127.0.0.1
Environment=UPTIME_KUMA_PORT=3001
ExecStart=/usr/bin/node server/server.js
Restart=on-failure
[Install]
WantedBy=multi-user.target
Was die Zeilen bewirken:
UserundWorkingDirectorylassen den Server alsuptime-kumaim Programmordner laufen. Die Daten landen dadurch in/opt/uptime-kuma/data.UPTIME_KUMA_HOST=127.0.0.1beschränkt den Server auf den eigenen Rechner,UPTIME_KUMA_PORTlegt den Port fest.ExecStartstartet den Server direkt mit dem Node.js aus Ubuntu.Restart=on-failurestartet ihn nach einem Absturz neu.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
11. systemd die neue Datei mitteilen
sudo systemctl daemon-reload
12. Dienst starten und für den Systemstart anmelden
sudo systemctl enable --now uptime-kuma
13. Prüfen, ob der Dienst läuft
systemctl status uptime-kuma
Prüfen: In der Zeile Active steht active (running). Mit q verlässt du die Anzeige. Beim ersten Start legt Uptime Kuma seine Datenbank an. Die Meldungen dazu zeigt journalctl -u uptime-kuma.
14. Prüfen, dass Uptime Kuma nur lokal lauscht
ss -ltn | grep 3001
Prüfen: Die Zeile enthält 127.0.0.1:3001.
Erste Einrichtung
15. Uptime Kuma im Browser öffnen
xdg-open http://127.0.0.1:3001
16. Datenbank wählen
Beim ersten Aufruf fragt Uptime Kuma „Welche Datenbank möchtest du verwenden?“. Stelle oben bei Sprache auf Deutsch um, wähle SQLite und klicke auf Weiter. SQLite ist eine einfache Datenbankdatei und reicht für einige hundert Monitore. Das Einrichten kann einen Moment dauern.
17. Administrator-Konto anlegen
Unter Erstelle dein Administrator-Konto trägst du Benutzername, Passwort und Passwort wiederholen ein und klickst auf Erstellen. Danach öffnet sich das Dashboard.
Ersten Monitor anlegen
18. Monitor hinzufügen
Klicke oben links auf Neuen Monitor hinzufügen.
19. Monitor einrichten
- Monitortyp: HTTP(s) für eine Website.
- Anzeigename: ein Name für die Liste, z. B.
Meine Website. - URL: die vollständige Adresse, z. B.
https://example.org. - Heartbeat-Intervall: wie oft geprüft wird, Vorgabe 60 Sekunden.
- Wiederholungen: wie oft eine fehlgeschlagene Prüfung wiederholt wird, bevor der Monitor als Offline gilt.
Klicke unten auf Speichern.
Prüfen: Der Monitor erscheint links in der Liste. Nach der ersten Prüfung zeigt er Online und einen grünen Balken. Rechts stehen Antwortzeit, Verfügbarkeit und bei HTTPS das Ablaufdatum des Zertifikats (Zert.-Ablauf).
20. Ausfall ausprobieren
Lege zum Test einen zweiten Monitor vom Typ HTTP(s) mit einer Adresse an, die es nicht gibt, z. B. http://127.0.0.1:9.
Prüfen: Der Monitor wechselt nach den eingestellten Wiederholungen auf Offline mit rotem Balken. Lösche ihn danach über Löschen.
Benachrichtigung einrichten (optional)
21. Benachrichtigung anlegen
Öffne oben rechts über das Profilbild die Einstellungen und dort Benachrichtigungen. Klicke auf Benachrichtigung einrichten, wähle den Benachrichtigungstyp, z. B. E-Mail (SMTP), Telegram oder ntfy, und trage die Zugangsdaten ein. Testen schickt eine Probenachricht.
Setzt du ein Häkchen bei Standardmäßig aktiviert, gilt die Benachrichtigung für alle neuen Monitore. Auf alle bestehenden Monitore anwenden schaltet sie für die schon angelegten ein. Klicke auf Speichern.
Aktualisieren
22. Dienst anhalten
sudo systemctl stop uptime-kuma
23. Neue Version holen
Ersetze 2.5.5 durch die neue Versionsnummer von der Release-Seite https://github.com/louislam/uptime-kuma/releases. Die Befehle laufen im Programmordner.
cd /opt/uptime-kuma
sudo -u uptime-kuma -H git fetch --depth 1 origin tag 2.5.5
sudo -u uptime-kuma -H git checkout --force 2.5.5
24. Abhängigkeiten und Oberfläche erneuern
sudo -u uptime-kuma -H npm install --omit dev --no-audit
sudo -u uptime-kuma -H npm run download-dist
25. Dienst wieder starten
sudo systemctl start uptime-kuma
Tipp: Sichere vor jedem Update den Ordner
/opt/uptime-kuma/data, z. B. mitsudo cp -a /opt/uptime-kuma/data /var/backups/uptime-kuma-data. Er enthält alle Monitore, Einstellungen und den Verlauf.
Wie geht es weiter?
- Passwort vergessen: Im Programmordner setzt
sudo -u uptime-kuma -H npm run reset-passworddas Passwort des Administrator-Kontos zurück. - Statusseite: Unter Statusseiten → Neue Statusseite fasst du Monitore auf einer öffentlichen Seite zusammen. Dafür muss Uptime Kuma über nginx mit eigener Domain erreichbar sein. nginx muss dabei WebSockets durchreichen, Hinweise stehen im Wiki unter „Reverse Proxy“.
- Update-Prüfung: Unter Einstellungen → Über lässt sich Auf GitHub nach Updates suchen abschalten.
- Andere Prüfarten: Neben HTTP(s) gibt es u. a. Ping, TCP Port, DNS, HTTP(s) - Schlüsselwort (sucht einen Text in der Seite) und Datenbankprüfungen.
- Dokumentation: https://github.com/louislam/uptime-kuma/wiki
Deinstallieren
1. Dienst anhalten und abmelden
sudo systemctl disable --now uptime-kuma
2. Dienstdatei löschen
sudo rm /etc/systemd/system/uptime-kuma.service
3. systemd die Änderung mitteilen
sudo systemctl daemon-reload
4. Programm und Daten löschen
Achtung: Damit sind alle Monitore, Einstellungen und der gesamte Verlauf unwiderruflich gelöscht.
sudo rm -rf /opt/uptime-kuma
5. Systembenutzer entfernen
sudo deluser uptime-kuma
6. Node.js und npm entfernen (optional)
Nur wenn kein anderes Programm sie braucht. git bleibt in der Regel installiert, weil es oft auch anderweitig genutzt wird.
sudo apt purge nodejs npm
sudo apt autoremove --purge
Prüfen: Port 3001 ist frei, der Befehl gibt nichts aus.
ss -ltn | grep 3001
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/louislam/uptime-kuma
- Lizenz: Uptime Kuma steht unter der MIT.
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.
sysstat (sar, iostat, mpstat, pidstat)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
sysstat ist eine Sammlung kleiner Messwerkzeuge für das Terminal. Sein wichtigster Teil zeichnet im Hintergrund alle zehn Minuten Prozessorlast, Arbeitsspeicher, Plattenzugriffe, Netzverkehr und vieles mehr auf. Mit dem Befehl sar lässt sich so auch im Nachhinein klären, was der Rechner gestern um 3 Uhr nachts gemacht hat. Dazu kommen iostat, mpstat und pidstat für Momentaufnahmen von Platten, einzelnen Prozessorkernen und Prozessen. Anders als Munin braucht sysstat keinen Webserver, und anders als htop oder btop merkt es sich den Verlauf.
Vorbemerkungen
- Meist schon vorhanden: sysstat gehört bei Ubuntu 26.04 zur Grundinstallation und zeichnet bereits auf. Schritt 1 prüft das. Fehlt es, installieren es die Schritte 2 und 3.
- Aufbewahrung: Ab Werk werden die Messwerte 7 Tage aufgehoben. Schritt 21 verlängert das.
- Ausgabe: Die Spaltenköpfe sind englisch. Zahlen und Datum erscheinen auf einem deutschen System im deutschen Format, mit Komma als Dezimalzeichen und der Zeile Durchschnitt: am Ende.
- Kein Netzwerkzugriff: sysstat öffnet keinen Port. Die Daten liegen als Binärdateien unter
/var/log/sysstat. - Version: Getestet mit sysstat 12.7.7 am 2. Oktober 2026.
Installation prüfen
1. Prüfen, ob sysstat installiert ist
sar -V
Prüfen: Die Ausgabe beginnt mit sysstat Version 12.7.7. Dann ist sysstat vorhanden und du machst mit Schritt 4 weiter. Meldet die Shell Befehl 'sar' nicht gefunden, folgen die Schritte 2 und 3.
2. Paketlisten aktualisieren
Nur nötig, wenn sysstat fehlt.
sudo apt update
3. sysstat installieren
sudo apt install sysstat
4. Prüfen, ob die Aufzeichnung läuft
Die Messung erledigt ein systemd-Timer, der alle zehn Minuten den Sammeldienst startet.
systemctl list-timers sysstat-collect.timer
Prüfen: In der Spalte NEXT steht der nächste Zeitpunkt, z. B. 23:20:00, also die nächste volle Zehnerminute.
Meldet der Befehl 0 timers listed, ist die Aufzeichnung abgeschaltet. Dann schaltest du die Timer ein:
sudo systemctl enable --now sysstat-collect.timer sysstat-summary.timer sysstat-rotate.timer
Zusätzlich muss in /etc/default/sysstat die Zeile ENABLED="true" stehen, sonst bricht der Sammeldienst bei jedem Lauf gleich wieder ab:
grep ENABLED /etc/default/sysstat
Steht dort ENABLED="false", öffne die Datei mit sudo nano /etc/default/sysstat und ändere den Wert in "true".
5. Vorhandene Messdaten ansehen
ls /var/log/sysstat
Für jeden Tag gibt es eine Datei saTT, wobei TT der Tag im Monat ist, z. B. sa02 für den 2. Die Dateien sarTT enthalten eine nächtliche Zusammenfassung als Text.
Verlauf abfragen mit sar
6. Prozessorlast des heutigen Tages
Ohne weitere Angaben zeigt sar die Prozessorauslastung seit Mitternacht in Zehn-Minuten-Schritten.
sar
Prüfen: Jede Zeile beginnt mit einer Uhrzeit. Die wichtigsten Spalten sind %user (Programme), %system (Systemkern), %iowait (Warten auf Platten) und %idle (Leerlauf). Die letzte Zeile Durchschnitt: fasst den Tag zusammen. Kurz nach der Installation erscheinen noch keine Zeilen, weil der erste Messpunkt fehlt.
7. Zeitraum eingrenzen
-s und -e legen Beginn und Ende fest. Dieser Befehl zeigt nur die Werte zwischen 8 und 12 Uhr.
sar -s 08:00:00 -e 12:00:00
8. Einen früheren Tag abfragen
-f liest eine bestimmte Tagesdatei. Ersetze 01 durch den gewünschten Tag des Monats. Es stehen so viele Tage zur Verfügung, wie die Aufbewahrung erlaubt.
sar -f /var/log/sysstat/sa01
9. Andere Messwerte wählen
Ein Schalter wählt, was sar zeigt. Er lässt sich mit -s, -e und -f kombinieren.
| Befehl | Zeigt |
|---|---|
sar -r | Arbeitsspeicher, z. B. %memused und kbavail (frei verfügbar) |
sar -S | Auslagerungsspeicher (Swap) |
sar -q | Warteschlange und Systemlast (ldavg-1, ldavg-5, ldavg-15) |
sar -d | Zugriffe je Laufwerk |
sar -b | Lese- und Schreibvorgänge insgesamt |
sar -n DEV | Netzverkehr je Schnittstelle |
sar -P ALL | Auslastung je Prozessorkern |
sar -A | alles auf einmal |
Zum Beispiel der Arbeitsspeicher:
sar -r
10. Auf ein Gerät beschränken
Bei vielen Laufwerken oder Schnittstellen wird die Ausgabe lang. --dev= und --iface= beschränken sie auf eines. Die Namen zeigen lsblk -d und ip -br link.
sar -d --dev=nvme0n1
sar -n DEV --iface=enp3s0
11. Live messen
Mit zwei Zahlen dahinter misst sar sofort statt aus der Datei zu lesen: hier dreimal im Abstand von einer Sekunde.
sar -u 1 3
Momentaufnahmen
12. Plattenauslastung mit iostat
-x zeigt erweiterte Werte, -z blendet untätige Geräte aus. 1 2 misst zweimal im Abstand von einer Sekunde. Der erste Block zeigt die Durchschnitte seit dem Systemstart, erst der zweite die aktuelle Sekunde.
iostat -xz 1 2
Wichtig sind r/s und w/s (Lese- und Schreibvorgänge je Sekunde), r_await und w_await (Wartezeit in Millisekunden) und %util (Auslastung des Geräts).
13. Prozessorkerne mit mpstat
Zeigt jeden Kern einzeln. So fällt auf, wenn ein Programm nur einen Kern voll auslastet, während die Gesamtlast niedrig wirkt.
mpstat -P ALL 1 1
14. Prozesse mit pidstat
Listet die Prozesse, die in der gemessenen Sekunde Rechenzeit gebraucht haben, mit Benutzer-ID, Prozessnummer und Programmname.
pidstat 1 1
Mit -r zeigt pidstat stattdessen den Speicherverbrauch, mit -d die Plattenzugriffe je Prozess.
Grafiken erzeugen
15. Prozessorlast als Grafik speichern
sadf -g wandelt die Messdaten in eine SVG-Grafik um. Hinter -- stehen dieselben Schalter wie bei sar. -T beschriftet die Zeitachse mit der Ortszeit statt mit UTC.
sadf -g -T -- -u > ~/sar-cpu.svg
16. Grafik ansehen
xdg-open ~/sar-cpu.svg
Prüfen: Es öffnet sich ein dunkles Diagramm CPU utilization [all] mit farbigen Balken für %user, %system und die übrigen Werte über den Tag. Rechts stehen jeweils Minimum und Maximum.
17. Weitere Grafiken
Für den Arbeitsspeicher:
sadf -g -T -- -r > ~/sar-speicher.svg
Für einen früheren Tag stellst du die Datei ans Ende, z. B. sadf -g -T /var/log/sysstat/sa01 -- -u > ~/sar-cpu-01.svg.
Einstellungen anpassen
18. Ordner für die Timer-Ergänzung anlegen
Das Messintervall steht im systemd-Timer. Eine Ergänzungsdatei ändert es, ohne die Datei des Pakets anzufassen.
sudo mkdir -p /etc/systemd/system/sysstat-collect.timer.d
19. Messintervall ändern
sudo nano /etc/systemd/system/sysstat-collect.timer.d/intervall.conf
Trage Folgendes ein, um alle fünf Minuten zu messen:
[Timer]
OnCalendar=
OnCalendar=*:00/05
Die leere Zeile OnCalendar= löscht die Vorgabe von zehn Minuten, sonst würden beide Zeitpläne gelten. *:00/05 bedeutet: jede Stunde ab Minute 0 alle 5 Minuten. Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
20. systemd die Änderung mitteilen
sudo systemctl daemon-reload
Prüfen: In der Spalte NEXT steht jetzt die nächste volle Fünferminute.
systemctl list-timers sysstat-collect.timer
21. Aufbewahrungsdauer verlängern
sudo nano /etc/sysstat/sysstat
Ändere die Zeile HISTORY=7 z. B. in
HISTORY=28
Damit bleiben die Daten 28 Tage erhalten. Höher solltest du ohne weitere Anpassung nicht gehen: Die Tagesdateien heißen nur nach dem Tag im Monat und würden nach einem Monat überschrieben. Speichere und schließe nano. Die Änderung gilt ab der nächsten nächtlichen Aufräumrunde, ein Neustart ist nicht nötig.
Wie geht es weiter?
- Daten weiterverarbeiten:
sadf -d -- -ugibt die Werte mit Semikolon getrennt aus, gut für eine Tabellenkalkulation.sadf -j -- -uliefert JSON. - Auf einen Blick: Die Spalte %iowait in
sarund %util iniostatzeigen, ob ein langsamer Rechner auf seine Platte wartet. Hohe Werte bei ldavg-1 insar -qim Verhältnis zur Zahl der Kerne deuten auf zu viel gleichzeitige Arbeit hin. - Dauerhafte Überwachung mit Alarmen: dafür eignet sich Zabbix oder Prometheus.
- Dokumentation:
man sar,man iostat,man mpstat,man pidstat,man sadfund https://sysstat.github.io
Deinstallieren
sysstat gehört zur Grundinstallation von Ubuntu, andere Pakete hängen aber nicht davon ab. Oft reicht es, nur die Aufzeichnung abzuschalten.
1. Aufzeichnung abschalten (Variante A)
Hält die drei Timer an und verhindert, dass sie beim nächsten Start wieder laufen. Die Befehle iostat, mpstat, pidstat und sar mit Live-Messung bleiben nutzbar.
sudo systemctl disable --now sysstat-collect.timer sysstat-summary.timer sysstat-rotate.timer
2. sysstat ganz entfernen (Variante B)
sudo apt purge sysstat
3. Eigene Timer-Ergänzung löschen
Nur nötig, wenn du Schritt 19 ausgeführt hast.
sudo rm -r /etc/systemd/system/sysstat-collect.timer.d
4. systemd die Änderung mitteilen
sudo systemctl daemon-reload
5. Messdaten und Grafiken löschen (optional)
sudo rm -rf /var/log/sysstat
rm -f ~/sar-*.svg
Prüfen: Nach Variante B wird der Befehl nicht mehr gefunden.
sar -V
Quellen und Lizenz
- Offizielle Dokumentation: https://sysstat.github.io/
- Lizenz: sysstat steht unter der 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.
smartmontools
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
smartmontools liest die Selbstdiagnose (SMART) von Festplatten und SSDs aus. Daran lässt sich ablesen, wie gesund ein Laufwerk ist: wie viel seiner Lebensdauer verbraucht ist, wie warm es wird, ob es Lesefehler gab oder Sektoren ersetzen musste. Das Programm smartctl zeigt diese Werte an und startet Selbsttests. Der Dienst smartd behält die Laufwerke im Hintergrund im Auge und warnt, wenn sich ein Wert verschlechtert, oft lange bevor ein Laufwerk ausfällt.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert smartmontools 7.5. Es ist ein einzelnes Paket ohne weitere Abhängigkeiten.
- Administratorrechte: Fast alle Befehle brauchen
sudo, weil sie direkt mit den Laufwerken sprechen. - Laufwerksnamen: NVMe-SSDs heißen
/dev/nvme0,/dev/nvme1usw., SATA- und USB-Laufwerke/dev/sda,/dev/sdbusw. Die Beispiele verwenden/dev/nvme0. Ersetze den Namen durch deinen aus Schritt 4. - USB-Geräte: Kartenleser und viele USB-Gehäuse reichen SMART nicht oder nur mit Zusatzangaben durch. Für sie liefert
smartctloft nur eine Fehlermeldung. - Benachrichtigungen:
smartdschreibt Warnungen immer ins Systemprotokoll. Per E-Mail verschickt es sie nur, wenn auf dem Rechner ein Mailprogramm eingerichtet ist (siehe Wie geht es weiter?). - Version: Getestet mit smartmontools 7.5 an einer NVMe-SSD am 2. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. smartmontools installieren
Installiert smartctl und den Dienst smartd, der sofort startet und alle erkannten Laufwerke überwacht.
sudo apt install smartmontools
3. Version prüfen
smartctl --version
Prüfen: Die erste Zeile beginnt mit smartctl 7.5.
Laufwerke prüfen
4. Laufwerke suchen
sudo smartctl --scan
Prüfen: Für jedes Laufwerk erscheint eine Zeile, z. B. /dev/nvme0 -d nvme # /dev/nvme0, NVMe device oder /dev/sda -d sat # /dev/sda [SAT], ATA device.
5. Angaben zum Laufwerk anzeigen
-i zeigt Modell, Seriennummer, Firmware und Größe.
sudo smartctl -i /dev/nvme0
Prüfen: Unter START OF INFORMATION SECTION stehen Model Number und Total NVM Capacity. Bei SATA-Laufwerken heißen die Zeilen Device Model und User Capacity, und die Zeile SMART support is sollte Enabled zeigen.
6. Gesamturteil abfragen
-H fragt das Urteil ab, das das Laufwerk über sich selbst fällt.
sudo smartctl -H /dev/nvme0
Prüfen: Die Zeile lautet SMART overall-health self-assessment test result: PASSED. Steht dort FAILED, solltest du die Daten sofort sichern und das Laufwerk ersetzen.
Hinweis:
PASSEDheißt nur, dass das Laufwerk seine eigenen Grenzwerte noch nicht überschritten hat. Aussagekräftiger sind die Einzelwerte aus dem nächsten Schritt.
7. Einzelwerte anzeigen
sudo smartctl -A /dev/nvme0
Bei einer NVMe-SSD sind diese Zeilen am wichtigsten:
- Critical Warning: sollte
0x00sein. Jeder andere Wert ist ein Alarm. - Temperature: aktuelle Temperatur. Dauerhaft über 70 °C ist zu viel.
- Available Spare: verbleibende Ersatzzellen, neu
100%. Fällt der Wert unter Available Spare Threshold, ist das Ende nahe. - Percentage Used: geschätzter Verbrauch der Lebensdauer. Bei
100%hat die SSD ihre vom Hersteller zugesagte Schreibmenge erreicht. - Data Units Written: bisher geschriebene Datenmenge, in Klammern z. B.
[55,2 TB]. - Power On Hours: Betriebsstunden.
- Unsafe Shutdowns: wie oft der Strom ohne ordentliches Herunterfahren weg war.
- Media and Data Integrity Errors: sollte
0sein.
Bei einer SATA-Festplatte oder -SSD erscheint stattdessen eine Tabelle. Hier sind vor allem die Spalte RAW_VALUE der Zeilen Reallocated_Sector_Ct (ersetzte Sektoren), Current_Pending_Sector (Sektoren, die sich nicht lesen ließen) und Offline_Uncorrectable wichtig. Alle drei sollten 0 sein. Steigen sie, kündigt sich ein Ausfall an.
8. Alles auf einmal anzeigen
-x zeigt sämtliche Angaben, Werte, Fehler- und Selbsttest-Protokolle in einer langen Ausgabe.
sudo smartctl -x /dev/nvme0 | less
Mit q verlässt du die Anzeige.
Selbsttest
9. Kurzen Selbsttest starten
Der Test läuft im Laufwerk selbst und liest nur. Du kannst den Rechner währenddessen normal weiterbenutzen. Ein kurzer Test dauert ein bis zwei Minuten.
sudo smartctl -t short /dev/nvme0
Prüfen: Die Ausgabe meldet Self-test has begun. Bei SATA-Laufwerken steht dort zusätzlich, wann der Test voraussichtlich fertig ist.
10. Ergebnis abfragen
Warte etwa zwei Minuten.
sudo smartctl -l selftest /dev/nvme0
Prüfen: Oben steht No self-test in progress, darunter eine Zeile mit Short und Completed without error. Läuft der Test noch, zeigt die erste Zeile den Fortschritt in Prozent.
Ein gründlicherer Test liest das ganze Laufwerk: sudo smartctl -t long /dev/nvme0. Er kann je nach Größe von einigen Minuten bis zu vielen Stunden dauern.
Überwachung mit smartd einrichten
11. Prüfen, ob smartd läuft
systemctl is-active smartmontools
Prüfen: Die Ausgabe lautet active.
12. Überwachte Laufwerke ansehen
journalctl -u smartmontools -b
Prüfen: Eine Zeile wie Monitoring 0 ATA/SATA, 0 SCSI/SAS and 1 NVMe devices nennt die überwachten Laufwerke. Laufwerke ohne SMART, etwa ein leerer Kartenleser, erscheinen mit einer Fehlerzeile und werden übergangen.
13. Einstellungsdatei öffnen
Ab Werk prüft smartd alle 30 Minuten den Zustand aller Laufwerke und meldet Verschlechterungen. Mit einer Zeile mehr lässt du zusätzlich die Temperatur überwachen und regelmäßig Selbsttests laufen.
sudo nano /etc/smartd.conf
14. Überwachungszeile anpassen
Suche mit Strg+W die einzige Zeile, die nicht mit # beginnt:
DEVICESCAN -d removable -n standby -m root -M exec /usr/share/smartmontools/smartd-runner
Ändere sie in:
DEVICESCAN -d removable -n standby -W 4,55,65 -s (S/../.././03|L/../../7/04) -m root -M exec /usr/share/smartmontools/smartd-runner
Was die Angaben bedeuten:
DEVICESCANüberwacht alle gefundenen Laufwerke,-d removableduldet, dass Wechsellaufwerke fehlen.-n standbyweckt schlafende Festplatten für die Prüfung nicht auf.-W 4,55,65protokolliert Temperaturänderungen ab 4 Grad, vermerkt ab 55 °C einen Hinweis im Protokoll und meldet ab 65 °C eine kritische Warnung, die auch an-mverschickt wird.-s (S/../.././03|L/../../7/04)startet jeden Tag um 3 Uhr einen kurzen Selbsttest (S) und jeden Sonntag um 4 Uhr einen langen (L). Die Felder stehen für Monat, Tag, Wochentag (1 = Montag, 7 = Sonntag) und Stunde. Ist der Rechner zu dieser Zeit aus, holtsmartdden Test nicht nach.-m rootschickt Warnungen an den Benutzerroot,-M exec …legt das Programm fest, das sie verschickt.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
15. smartd neu starten
sudo systemctl restart smartmontools
Prüfen: Das Protokoll enthält eine Zeile wie initial Temperature is 42 Celsius. Daran erkennst du, dass die Temperaturüberwachung aktiv ist.
journalctl -u smartmontools -n 20
16. Warnungen später nachlesen
Alles, was smartd feststellt, steht im Systemprotokoll. Dieser Befehl zeigt nur Warnungen und Fehler:
journalctl -u smartmontools -p warning
Wie geht es weiter?
- Warnungen per E-Mail:
smartdübergibt Warnungen an das Programmmail. Ist auf dem Rechner ein Mailserver wie Postfix eingerichtet, landen sie im Postfach vonroot. Mit einer zusätzlichen Angabe-M testin der Zeile aus Schritt 14 verschicktsmartdbei jedem Start eine Probenachricht. Im Protokoll steht dannTest of /usr/share/smartmontools/smartd-runner to root: successful. Entferne-M testdanach wieder. - Grafische Oberfläche:
sudo apt install gsmartcontrolzeigt dieselben Werte in einem Fenster an. - USB-Gehäuse: Viele Gehäuse geben SMART mit der Angabe
-d satweiter, z. B.sudo smartctl -a -d sat /dev/sdb. - Langfristige Aufzeichnung: Zabbix bringt Vorlagen für SMART-Werte mit, sodass sich ihr Verlauf über Monate verfolgen lässt.
- Dokumentation:
man smartctl,man smartd,man smartd.confund https://www.smartmontools.org
Deinstallieren
1. smartmontools entfernen
Entfernt smartctl und den Dienst smartd samt Einstellungsdatei und gespeichertem Zustand.
sudo apt purge smartmontools
Prüfen: Der Befehl wird nicht mehr gefunden.
smartctl --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.smartmontools.org/
- Lizenz: smartmontools steht unter der GPL-2.0-or-later.
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.
lnav
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
lnav (Logfile Navigator) ist ein Betrachter für Protokolldateien im Terminal. Er erkennt gängige Formate wie Syslog, das systemd-Journal oder die Zugriffsprotokolle von nginx selbstständig, färbt Fehler rot und Warnungen gelb ein und mischt mehrere Dateien nach Uhrzeit zu einer gemeinsamen Ansicht. Mit einem Tastendruck springst du zum nächsten Fehler, blendest Zeilen per Filter aus oder zeigst ein Balkendiagramm, wann wie viele Meldungen auftraten. Wer mehr wissen will, fragt die Protokolle sogar mit SQL ab, etwa welche Adressen am häufigsten auf die Website zugreifen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert lnav 0.13.2. Es ist ein einzelnes Paket ohne weitere Abhängigkeiten.
- Leserechte: Die meisten Dateien unter
/var/loggehören der Gruppeadm. Der erste Benutzer, der bei der Installation von Ubuntu angelegt wurde, gehört dieser Gruppe an und kann sie ohnesudolesen. Ob das bei dir so ist, zeigtid -nG. Fehltadmin der Liste, brauchst dusudo lnav. - Nur lesen: lnav verändert die Protokolle nicht. Es merkt sich Filter und die zuletzt angesehene Stelle in
~/.config/lnav. - Englische Oberfläche: Hilfe, Statuszeilen und Befehle sind englisch.
- Version: Getestet mit lnav 0.13.2 am 3. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. lnav installieren
sudo apt install lnav
3. Version prüfen
lnav -V
Prüfen: Die Ausgabe lautet lnav 0.13.2.
Protokolle ansehen
4. Systemprotokoll öffnen
Ohne Angabe öffnet lnav das Systemprotokoll /var/log/syslog.
lnav
Prüfen: Das Terminal zeigt die Meldungen mit Datum und Uhrzeit, Fehler rot, Warnungen gelb. Die Ansicht steht am Ende, also bei den neuesten Meldungen, und neue Zeilen erscheinen laufend. Oben stehen Uhrzeit und Statuszeile, unten Hinweise zur Bedienung.
5. Durch die Meldungen bewegen
| Taste | Wirkung |
|---|---|
| ↑ ↓ | eine Zeile hoch oder runter |
| Bild↑ Bild↓ | eine Seite hoch oder runter |
| g / G | zum Anfang / zum Ende |
| E / e | zum vorigen / nächsten Fehler |
| W / w | zur vorigen / nächsten Warnung |
| D / d | 24 Stunden zurück / vor |
| ← | zeigt am Zeilenanfang, aus welcher Datei die Meldung stammt |
Drücke zum Ausprobieren E: lnav springt zur letzten Fehlermeldung über der aktuellen Stelle. Steht die Ansicht am Ende und du drückst e, meldet die untere Zeile, dass es danach keinen Fehler mehr gibt.
6. Text suchen
Drücke /, tippe einen Suchbegriff wie nginx und bestätige mit Enter. Schon während des Tippens werden Treffer hervorgehoben. n springt zum nächsten, N zum vorigen Treffer. Der Suchbegriff ist ein regulärer Ausdruck, fail|error findet also beide Wörter.
7. Meldungen über die Zeit anzeigen
Drücke i. lnav zeigt ein Balkendiagramm mit der Zahl der Meldungen je Zeitabschnitt, aufgeteilt in normale Meldungen, Fehler und Warnungen. So fällt auf, wann sich Fehler gehäuft haben. z und Z zoomen hinein und hinaus. Ein weiterer Druck auf i führt zurück zu den Meldungen.
8. Hilfe aufrufen
? öffnet die eingebaute Hilfe mit allen Tasten und Befehlen. q schließt sie wieder.
9. lnav beenden
Drücke q. In einer Unteransicht wie dem Balkendiagramm führt q zuerst zurück zu den Meldungen, ein weiteres q beendet lnav.
Mehrere Protokolle zusammen
10. Dateien gemeinsam öffnen
Gibst du mehrere Dateien an, sortiert lnav ihre Meldungen nach der Uhrzeit ineinander. So siehst du zum Beispiel, was im Systemprotokoll geschah, kurz bevor sich jemand per sudo angemeldet hat.
lnav /var/log/syslog /var/log/auth.log
Mit ← blendest du am linken Rand ein, aus welcher Datei jede Zeile stammt. Auch Ordner lassen sich angeben, z. B. lnav /var/log/nginx. Gepackte ältere Dateien wie access.log.2.gz liest lnav ebenfalls.
11. systemd-Journal ansehen
Viele Dienste schreiben nur ins systemd-Journal. journalctl gibt es im JSON-Format aus, und lnav liest es über eine Pipe. Dieser Befehl zeigt alle Meldungen seit dem letzten Systemstart:
journalctl -b -o json | lnav
Auf einen Dienst beschränkt, z. B. nginx:
journalctl -u nginx -o json | lnav
Filtern
12. Nur passende Zeilen zeigen
Befehle beginnen in lnav mit einem Doppelpunkt. Tippe in der laufenden Ansicht:
:filter-in sudo
und bestätige mit Enter. Nun erscheinen nur noch Zeilen, die sudo enthalten. Die Statuszeile nennt, wie viele Zeilen ausgeblendet sind.
13. Zeilen ausblenden
Umgekehrt blendet :filter-out passende Zeilen aus, etwa die vielen Meldungen eines gesprächigen Programms:
:filter-out google-chrome
Mehrere Filter wirken gleichzeitig.
14. Nur Fehler zeigen
:set-min-log-level error
Damit erscheinen nur noch Meldungen der Stufe Fehler und schlimmer. :set-min-log-level warning lässt auch Warnungen durch.
15. Filter verwalten
Tab öffnet unten die Liste der Filter. Mit ↑ und ↓ wählst du einen aus, Leertaste schaltet ihn aus und ein, D löscht ihn. Tab oder q führt zurück zu den Meldungen. lnav merkt sich die Filter für das nächste Öffnen derselben Dateien.
Mit SQL auswerten
16. SQL-Abfrage stellen
Abfragen beginnen mit einem Semikolon. Jedes erkannte Format ist eine Tabelle, das Systemprotokoll heißt syslog_log. Diese Abfrage zählt die Meldungen je Stufe:
;SELECT log_level, count(*) AS anzahl FROM syslog_log GROUP BY log_level
Nach Enter erscheint das Ergebnis als Tabelle, z. B. mit den Zeilen info, warning und error. q führt zurück zu den Meldungen, v wieder zum Ergebnis.
17. Zugriffe auf nginx auswerten
Die Zugriffsprotokolle von nginx und Apache erscheinen als Tabelle access_log mit Spalten wie c_ip (Adresse des Besuchers), cs_uri_stem (aufgerufene Seite) und sc_status (Antwortcode). Weil die Datei nur für die Gruppe adm lesbar ist, gilt dasselbe wie bei Syslog.
lnav /var/log/nginx/access.log
;SELECT c_ip, count(*) AS anzahl FROM access_log GROUP BY c_ip ORDER BY anzahl DESC LIMIT 10
Das Ergebnis listet die zehn Adressen mit den meisten Zugriffen.
18. Ohne Oberfläche auswerten
Mit -n läuft lnav ohne Bildschirmoberfläche und gibt das Ergebnis direkt aus. Das eignet sich für Skripte. -c übergibt den Befehl.
lnav -n -c ';SELECT log_level, count(*) AS anzahl FROM syslog_log GROUP BY log_level' /var/log/syslog
Prüfen: Es erscheint eine kleine Tabelle mit den Spalten log_level und anzahl.
Genauso funktionieren Filter. Dieser Befehl gibt nur die Fehlermeldungen aus:
lnav -n -c ':set-min-log-level error' /var/log/syslog
Wie geht es weiter?
- Weitere Formate:
lnav -i extrainstalliert zusätzliche Formatbeschreibungen aus dem Projekt, eigene Formate lassen sich als JSON-Datei hinzufügen. - Entfernte Rechner: lnav öffnet Protokolle auch über SSH, z. B.
lnav benutzer@server:/var/log/syslog. Auf dem anderen Rechner muss dafür nichts installiert sein. - Webzugriffe als Bericht: Für eine Übersicht über die Besucher einer Website eignet sich GoAccess.
- Dokumentation: https://docs.lnav.org sowie die Hilfe mit ? in lnav
Deinstallieren
1. lnav entfernen
sudo apt purge lnav
2. Eigene Einstellungen löschen
lnav legt Einstellungen, gespeicherte Filter und den Verlauf in deinem Home-Ordner ab. Diese Dateien gehören zu keinem Paket.
rm -rf ~/.config/lnav
Prüfen: Der Befehl wird nicht mehr gefunden.
lnav -V
Quellen und Lizenz
- Offizielle Dokumentation: https://lnav.org/documentation
- Lizenz: lnav steht unter der BSD-2-Clause.
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.
atop
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
atop zeigt im Terminal, wie stark Prozessor, Arbeitsspeicher, Festplatten und Netzwerk ausgelastet sind und welche Prozesse dafür verantwortlich sind. Die Besonderheit: Ein Hintergrunddienst schreibt diese Werte laufend in eine Datei. So lässt sich auch im Nachhinein nachsehen, was auf dem Rechner los war, zum Beispiel heute Nacht um drei, als die Website langsam wurde. Programme wie htop zeigen dagegen nur den jetzigen Augenblick.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert atop 2.12.1 als einzelnes Paket ohne weitere Abhängigkeiten.
- Dienste starten sofort: Nach der Installation laufen zwei Dienste.
atopschreibt alle zehn Minuten einen Messpunkt nach/var/log/atop,atopacctmerkt sich auch Prozesse, die zwischen zwei Messpunkten gestartet und wieder beendet wurden. - Platzbedarf: Je Tag entsteht eine Datei
atop_JJJJMMTT, aufbewahrt werden 28 Tage. Auf dem Testrechner (Desktop mit rund 460 Prozessen) belegte ein Messpunkt etwa 100 kB, das ergibt bei zehn Minuten Abstand ungefähr 15 MB am Tag. - Mit oder ohne
sudo: Ohnesudoläuft atop in einer eingeschränkten Ansicht. Die Zugriffe auf die Festplatte je Prozess fehlen dann. Die Aufzeichnungen des Dienstes sind vollständig und für alle Benutzer lesbar. - Netzwerk je Prozess: Dafür wäre das Kernelmodul netatop nötig, das Ubuntu nicht als Paket anbietet. Die Auslastung der Netzwerkkarten insgesamt zeigt atop auch ohne.
- Englische Oberfläche: Anzeige und Hilfe sind englisch.
- Version: Getestet mit atop 2.12.1 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. atop installieren
sudo apt install atop
3. Version prüfen
atop -V
Prüfen: Die Ausgabe beginnt mit Version: 2.12.1.
4. Dienste prüfen
systemctl is-active atop atopacct atop-rotate.timer
Prüfen: Es erscheint dreimal active. Der Timer atop-rotate.timer startet den Dienst jede Nacht um Mitternacht neu, damit eine neue Tagesdatei beginnt.
Aktuelle Auslastung ansehen
5. atop starten
sudo atop
Prüfen: Oben stehen Rechnername, Datum und Uhrzeit. Darunter folgen Zeilen für das ganze System, darunter die Liste der Prozesse. Die erste Anzeige enthält die Summen seit dem Systemstart, nach zehn Sekunden folgt der erste echte Messabschnitt. Ab dann zeigt jede Anzeige, was in den letzten zehn Sekunden geschah.
6. Die Zeilen im oberen Teil lesen
| Zeile | Inhalt |
|---|---|
PRC | Zahl der Prozesse, verbrauchte Rechenzeit |
CPU | Auslastung aller Prozessorkerne zusammen, bei sechs Kernen sind 600 % das Maximum |
cpu | Auslastung je Kern |
CPL | Lastdurchschnitt (avg1, avg5, avg15) |
MEM | Arbeitsspeicher: gesamt, frei, verfügbar, Zwischenspeicher |
SWP | Auslagerungsspeicher |
PAG | Auslagerungsvorgänge, oomkill zählt wegen Speichermangel beendete Prozesse |
DSK | je Festplatte: Anteil der Zeit, in der sie beschäftigt war, Lese- und Schreibzugriffe |
NET | Pakete und Durchsatz je Netzwerkkarte |
Ist eine Ressource fast oder ganz ausgeschöpft, färbt atop die betreffende Zeile ein. Beim Prozessor, bei Festplatten und beim Arbeitsspeicher gilt eine Auslastung ab 90 % als kritisch und erscheint rot.
7. Ansicht der Prozessliste wechseln
Jede Ansicht hat eine eigene Taste. Groß- und Kleinschreibung sind zu beachten.
| Taste | Wirkung |
|---|---|
| g | allgemeine Ansicht (Standard) |
| m | Speicherverbrauch je Prozess |
| d | Festplattenzugriffe je Prozess (nur mit sudo) |
| c | vollständige Befehlszeile je Prozess |
| u | Verbrauch je Benutzer zusammengefasst |
| p | Verbrauch je Programmname zusammengefasst |
| C / M / D | nach Prozessor, Speicher oder Festplatte sortieren |
| a | auch untätige Prozesse zeigen (Umschalter) |
| Strg+F / Strg+B | in der Prozessliste vor- und zurückblättern |
8. Nach einem Programm filtern
Drücke P, tippe einen Namen wie nginx und bestätige mit Enter. Die Liste zeigt nur noch Prozesse mit diesem Namen. Der Name ist ein regulärer Ausdruck. P und danach nur Enter hebt den Filter wieder auf. Mit U filterst du genauso nach einem Benutzer.
9. Messabstand ändern und anhalten
Drücke i, tippe eine Zahl in Sekunden, z. B. 5, und bestätige mit Enter. z hält die Anzeige an, in der obersten Zeile steht dann PAUSED. Ein weiteres z lässt sie weiterlaufen.
Der Abstand lässt sich auch gleich beim Aufruf angeben:
sudo atop 5
10. Balkendiagramm zeigen
B schaltet auf eine Ansicht mit Balken für Prozessor, Speicher, Festplatten und Netzwerk um. Sie zeigt nur das System als Ganzes, keine Prozesse. Ein weiteres B führt zurück zur Textansicht.
11. Hilfe aufrufen und beenden
? öffnet die Übersicht aller Tasten, q schließt sie. In der normalen Ansicht beendet q atop.
In die Vergangenheit schauen
12. Aufzeichnung von heute öffnen
Die Option -r liest die Datei des Dienstes, statt live zu messen.
atop -r
Prüfen: Die Anzeige sieht aus wie in Schritt 5, läuft aber nicht von selbst weiter. Die Uhrzeit in der obersten Zeile ist die des ersten Messpunkts von heute.
Direkt nach der Installation gibt es erst einen Messpunkt. Warte mindestens zehn Minuten, bevor du die nächsten Schritte ausprobierst.
13. Durch die Zeit blättern
| Taste | Wirkung |
|---|---|
| t | zum nächsten Messpunkt |
| T | zum vorigen Messpunkt |
| b | zu einer Uhrzeit springen, Eingabe als hhmm, z. B. 0300 |
| r | zurück zum Anfang der Datei |
Alle Tasten aus den Schritten 7 und 8 gelten auch hier. Du kannst also zu einer Uhrzeit springen und mit m nachsehen, welcher Prozess gerade am meisten Speicher belegt hat.
14. Bei einer Uhrzeit einsteigen
-b legt fest, bei welcher Uhrzeit die Anzeige beginnt.
atop -r -b 03:00
15. Einen anderen Tag öffnen
Für gestern genügt y, für vorgestern yy.
atop -r y
Jeden anderen Tag öffnest du über den Dateinamen. Welche Tage vorhanden sind, zeigt ls /var/log/atop.
atop -r /var/log/atop/atop_20261004
Gibt es die Datei für den Tag nicht, meldet atop No such file or directory.
Berichte mit atopsar
atopsar gehört zum selben Paket. Es gibt die aufgezeichneten Werte als Tabelle mit einer Zeile je Messpunkt aus. Das ist übersichtlicher, wenn du einen ganzen Tag überblicken willst.
16. Prozessorauslastung über den Tag
atopsar -c
Prüfen: Es erscheint eine Tabelle mit den Spalten %usr, %sys, %wait und %idle, je Messpunkt eine Zeile all und darunter die einzelnen Kerne.
17. Weitere Berichte
| Befehl | Bericht |
|---|---|
atopsar -m | Arbeitsspeicher und Auslagerungsspeicher |
atopsar -d | Festplatten |
atopsar -i | Netzwerkkarten |
atopsar -p | Lastdurchschnitt und Zahl der Prozesse |
atopsar -O | die drei Prozesse mit der meisten Rechenzeit je Messpunkt |
atopsar -G | die drei Prozesse mit dem meisten Speicher je Messpunkt |
atopsar -A | alle Berichte hintereinander |
18. Zeitraum und Tag eingrenzen
-b und -e begrenzen den Zeitraum, -r wählt wie bei atop den Tag.
atopsar -O -r y -b 02:00 -e 04:00
Dieser Befehl zeigt für gestern zwischen zwei und vier Uhr, welche drei Prozesse jeweils am meisten Rechenzeit gebraucht haben.
Aufzeichnung anpassen
19. Messabstand und Aufbewahrung ändern
Die Einstellungen des Dienstes stehen in /etc/default/atop.
sudo nano /etc/default/atop
Die Datei enthält diese Zeilen:
LOGOPTS=""
LOGINTERVAL=600
LOGGENERATIONS=28
LOGPATH=/var/log/atop
LOGINTERVAL ist der Abstand der Messpunkte in Sekunden, LOGGENERATIONS die Zahl der Tage, nach denen alte Dateien gelöscht werden. Für eine genauere Aufzeichnung setzt du zum Beispiel LOGINTERVAL=60. Die Dateien werden dadurch zehnmal so groß. Speichere mit Strg+O, Enter und beende nano mit Strg+X.
20. Dienst neu starten
Erst nach einem Neustart gilt die Änderung.
sudo systemctl restart atop
Prüfen: Der laufende Prozess trägt den neuen Abstand am Ende der Befehlszeile.
pgrep -x -a atop
Die Ausgabe lautet dann z. B. /usr/bin/atop -w /var/log/atop/atop_20261004 60.
21. Eigene Aufzeichnung für einen Test anlegen
Unabhängig vom Dienst kannst du eine kurze Aufzeichnung in eine eigene Datei schreiben, etwa während eines Lasttests. Dieser Befehl misst 30-mal im Abstand von zwei Sekunden und endet dann von selbst:
atop -w ~/lasttest.raw 2 30
Ansehen und auswerten lässt sich die Datei wie die des Dienstes:
atop -r ~/lasttest.raw
atopsar -c -r ~/lasttest.raw
Wie geht es weiter?
- Voreinstellungen: In
~/.atoprclassen sich Standardwerte wie der Messabstand oder die Startansicht festlegen. Die Möglichkeiten beschreibtman atoprc. - Für Skripte:
atop -P CPU,MEM 10gibt die Werte in einer Form aus, die sich leicht weiterverarbeiten lässt,atop -J CPU,MEM 10als JSON. - Tagesberichte als Zahlenreihen: Eine ähnliche Auswertung ohne Prozessliste, dafür mit sehr kleinen Dateien, bietet sysstat.
- Diagramme im Browser: Für Verläufe über Wochen eignen sich Munin oder Prometheus mit Grafana.
- Dokumentation: https://www.atoptool.nl sowie
man atopundman atopsar
Deinstallieren
1. atop entfernen
purge beendet die Dienste und löscht auch /etc/default/atop sowie den Ordner /var/log/atop mit allen Aufzeichnungen.
sudo apt purge atop
2. Eigene Dateien löschen
Nur nötig, wenn du in Schritt 21 eine eigene Aufzeichnung angelegt hast.
rm -f ~/lasttest.raw
Prüfen: Der Befehl wird nicht mehr gefunden.
atop -V
Quellen und Lizenz
- Offizielle Dokumentation: https://www.atoptool.nl/
- Lizenz: atop steht unter der 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.
ncdu
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ncdu (NCurses Disk Usage) zeigt im Terminal, welche Ordner und Dateien wie viel Platz auf der Festplatte belegen. Es durchsucht einen Ordner einmal, sortiert den Inhalt nach Größe und lässt dich mit den Pfeiltasten hineinblättern. So findest du in wenigen Sekunden heraus, was eine volle Festplatte füllt. Überflüssige Dateien lassen sich direkt aus ncdu löschen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert ncdu 1.22 als einzelnes Paket ohne weitere Abhängigkeiten. Es läuft kein Dienst.
- Mit oder ohne
sudo: Deinen eigenen Home-Ordner kannst du ohnesudountersuchen. Für Ordner wie/varoder das ganze System brauchst dusudo, sonst fehlen alle Ordner, die du nicht lesen darfst. - Löschen ist endgültig: Was du in ncdu löschst, landet nicht im Papierkorb. Mit
sudokann ncdu auch Dateien des Systems löschen. Für einen gefahrlosen Blick gibt es die Option-r(Schritt 11). - Momentaufnahme: ncdu zeigt den Stand zum Zeitpunkt des Durchsuchens. Änderungen danach erscheinen erst, wenn du neu einlesen lässt.
- Englische Oberfläche: Anzeige und Hilfe sind englisch. Zahlen erscheinen mit deutschem Komma.
- Version: Getestet mit ncdu 1.22 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. ncdu installieren
sudo apt install ncdu
3. Version prüfen
ncdu -V
Prüfen: Die Ausgabe lautet ncdu 1.22.
Einen Ordner untersuchen
4. Home-Ordner durchsuchen
Ohne Angabe untersucht ncdu den Ordner, in dem du gerade stehst. Mit einem Pfad dahinter den angegebenen Ordner.
ncdu ~
Prüfen: Zuerst erscheint ein Fenster Scanning... mit der Zahl der gefundenen Dateien. Danach folgt die Liste, der größte Eintrag steht oben:
--- /home/thorsten ---
35,0 MiB [###########] /gross
3,0 MiB [ ] /cache
2,0 MiB [ ] /.versteckt
1,0 MiB [ ] datei.txt
Total disk usage: 41,0 MiB Apparent size: 41,0 MiB Items: 9
Ordner beginnen mit einem Schrägstrich. Der Balken zeigt die Größe im Verhältnis zum größten Eintrag der Liste. Die unterste Zeile nennt den gesamten Platzbedarf und die Zahl der Dateien und Ordner.
5. Durch die Ordner blättern
| Taste | Wirkung |
|---|---|
| ↑ ↓ | Eintrag wählen |
| → oder Enter | in den gewählten Ordner wechseln |
| ← | zurück in den übergeordneten Ordner |
| i | Einzelheiten zum gewählten Eintrag ein- und ausblenden |
| ? | Hilfe mit allen Tasten, q schließt sie |
| q | ncdu beenden |
Gehe so vor: Öffne den obersten, also größten Ordner, dort wieder den größten und so weiter. Nach wenigen Schritten stehst du vor den Dateien, die den Platz belegen.
6. Anzeige umschalten
| Taste | Wirkung |
|---|---|
| g | wechselt zwischen Balken, Prozentwert, beidem und keinem |
| c | zeigt je Ordner die Zahl der enthaltenen Einträge |
| s | nach Größe sortieren, nochmals drücken kehrt die Reihenfolge um |
| n | nach Namen sortieren |
| C | nach Zahl der Einträge sortieren |
| e | versteckte Einträge (Name beginnt mit einem Punkt) aus- und einblenden |
| a | wechselt zwischen belegtem Platz und der eigentlichen Dateigröße |
| r | den aktuellen Ordner neu einlesen |
Ausgeblendete Einträge zählen in den Summen weiter mit.
7. Zeichen vor den Einträgen deuten
Manche Zeilen beginnen mit einem Kennzeichen:
| Zeichen | Bedeutung |
|---|---|
! | Ordner konnte nicht gelesen werden, meist fehlen die Rechte |
. | ein Unterordner konnte nicht gelesen werden, die Größe ist deshalb zu klein |
< | durch --exclude ausgeschlossen |
> | liegt auf einem anderen Dateisystem und wurde wegen -x ausgelassen |
@ | weder Datei noch Ordner, z. B. eine symbolische Verknüpfung |
H | harte Verknüpfung, deren Inhalt schon an anderer Stelle gezählt wurde |
e | leerer Ordner |
Siehst du viele ! und ., starte ncdu mit sudo.
Das ganze System untersuchen
8. Wurzelordner durchsuchen
Die Option -x bleibt auf dem Dateisystem des angegebenen Ordners. Ohne sie würde ncdu auch eingehängte Laufwerke, Netzwerkfreigaben und Ordner wie /proc mitzählen.
sudo ncdu -x /
Auf dem Testrechner dauerte das rund 25 Sekunden. Ein laufendes Durchsuchen brichst du mit q ab.
Prüfen: Die Liste zeigt Ordner wie /usr, /var und /home mit ihrer Größe. Häufige Platzfresser auf einem Server sind /var/log, /var/lib (Datenbanken) und /var/cache.
9. Ordner ausschließen
--exclude lässt alles aus, was auf das Muster passt. Die Option darf mehrfach vorkommen.
ncdu --exclude node_modules --exclude '*.iso' ~
Ausgeschlossene Einträge stehen mit < und der Größe 0 in der Liste.
10. Änderungsdatum anzeigen
Mit -e merkt sich ncdu zusätzlich das Änderungsdatum, --show-mtime blendet es als Spalte ein. Bei Ordnern ist es das Datum der jüngsten Datei darin. So erkennst du große Ordner, die seit Jahren niemand angefasst hat.
ncdu -e --show-mtime ~
In dieser Betriebsart sortiert M nach dem Datum, m blendet die Spalte aus und ein.
Aufräumen
11. Nur ansehen, ohne löschen zu können
Mit -r ist das Löschen abgeschaltet. Das ist die sichere Wahl für sudo.
sudo ncdu -r -x /
Drückst du darin d, meldet ncdu nur Deletion feature disabled.
12. Datei oder Ordner löschen
Starte ncdu ohne -r, wähle den Eintrag und drücke d. Es erscheint eine Rückfrage mit den Antworten yes, no und don't ask me again. Vorgewählt ist no, ein bloßes Enter löscht also nichts. Zum Löschen gehst du mit ← auf yes und bestätigst mit Enter.
Ein Ordner wird mitsamt seinem ganzen Inhalt gelöscht. Lies deshalb den Namen in der Rückfrage genau. Die Antwort don't ask me again solltest du meiden, danach löscht jedes d ohne Rückfrage.
Prüfen: Der Eintrag verschwindet aus der Liste, die Summe in der untersten Zeile sinkt.
Ergebnis speichern
Bei großen Dateisystemen oder auf einem Server lohnt es sich, das Durchsuchen vom Ansehen zu trennen.
13. Ergebnis in eine Datei schreiben
-o schreibt das Ergebnis in eine Datei, statt die Liste zu zeigen. -0 unterdrückt dabei die Fortschrittsanzeige, was für Skripte und Cronjobs nötig ist.
sudo ncdu -0 -x -o ~/belegung.json /
Prüfen: Die Datei ist angelegt. Auf dem Testrechner war sie rund 44 MB groß.
ls -lh ~/belegung.json
14. Gespeichertes Ergebnis ansehen
-f liest die Datei ein. Das geht ohne sudo und auch auf einem anderen Rechner, auf den du die Datei kopiert hast.
ncdu -f ~/belegung.json
Prüfen: Rechts oben steht [imported]. Löschen und neu einlesen sind in dieser Ansicht nicht möglich.
Voreinstellungen
15. Konfigurationsdatei anlegen
Optionen, die du immer verwenden willst, trägst du in ~/.config/ncdu/config ein. Zuerst den Ordner anlegen:
mkdir -p ~/.config/ncdu
Dann die Datei öffnen:
nano ~/.config/ncdu/config
Je Zeile steht eine Option, genau wie auf der Befehlszeile. Ein Beispiel:
--show-percent
--exclude node_modules
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
Prüfen: Beim nächsten Start von ncdu steht neben dem Balken der Prozentwert, und Ordner namens node_modules sind mit < ausgeschlossen.
Beachte: sudo ncdu läuft als Benutzer root und liest diese Datei nicht. Für alle Benutzer gilt stattdessen /etc/ncdu.conf.
Wie geht es weiter?
- Größen in Zehnerpotenzen:
--sirechnet mit 1000 statt 1024 und zeigt MB und GB, wie es Festplattenhersteller tun. - Überblick über alle Laufwerke:
df -hzeigt, wie voll jedes eingehängte Dateisystem ist. Das ist der erste Schritt, um zu entscheiden, wo du mit ncdu suchst. - Zustand der Festplatte: Ob ein Laufwerk gesund ist, prüfen die smartmontools.
- Protokolle: Füllt
/var/logdie Festplatte, zeigt lnav, welches Programm so viel schreibt. - Dokumentation: https://dev.yorhel.nl/ncdu sowie
man ncdu
Deinstallieren
1. ncdu entfernen
sudo apt purge ncdu
2. Eigene Dateien löschen
Nur nötig, wenn du die Schritte 13 und 15 ausgeführt hast. Diese Dateien gehören zu keinem Paket.
rm -rf ~/.config/ncdu ~/belegung.json
Prüfen: Der Befehl wird nicht mehr gefunden.
ncdu -V
Quellen und Lizenz
- Offizielle Dokumentation: https://dev.yorhel.nl/ncdu
- Lizenz: ncdu steht unter der MIT.
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.
iotop
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
iotop zeigt im Terminal, welche Prozesse gerade wie viel von der Festplatte lesen und darauf schreiben. Es ist das Gegenstück zu htop für den Datenträger: Rattert die Festplatte, reagiert der Rechner zäh oder wächst ein Ordner ohne erkennbaren Grund, siehst du hier in Sekunden den Verursacher. Diese Anleitung verwendet iotop-c, eine in C geschriebene Neufassung des älteren, in Python geschriebenen iotop.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 bietet zwei Pakete an:
iotop-c(Version 1.31, wird weiter gepflegt) und das ältereiotop(Version 0.6). Diese Anleitung nimmtiotop-c. Es ist ein einzelnes Paket ohne weitere Abhängigkeiten, ein Dienst läuft nicht. - Zwei Namen, ein Programm: Das Paket legt den Befehl
iotop-can und richtet zusätzlichiotopals Verweis darauf ein. Beide Namen starten dasselbe Programm. - Nur mit
sudo: Der Kernel gibt diese Zahlen nur anrootheraus. Ohnesudobricht iotop mit einem Hinweis ab. - Spalte IO braucht eine Kerneleinstellung: Die Spalten
SWAPINundIO(Wartezeit auf den Datenträger) bleiben bei 0, solange die Einstellungkernel.task_delayacctausgeschaltet ist. Das ist bei Ubuntu der Normalfall. Lese- und Schreibmenge funktionieren auch so. Wie du die Einstellung einschaltest, steht ab Schritt 12. - Englische Oberfläche: Anzeige und Hilfe sind englisch. Zahlen erscheinen mit deutschem Komma.
- Version: Getestet mit iotop-c 1.31 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. iotop-c installieren
sudo apt install iotop-c
3. Version prüfen
iotop --version
Prüfen: Die Ausgabe lautet iotop 1.31.
Zugriffe live ansehen
4. iotop starten
Die Option -o zeigt nur Prozesse, die gerade wirklich lesen oder schreiben. -P fasst die Threads eines Programms zu einer Zeile zusammen. Ohne beide Optionen ist die Liste sehr lang und besteht fast nur aus Nullen.
sudo iotop -o -P
Prüfen: Oben stehen zwei Zeilen mit den Summen, darunter die Liste. Sie aktualisiert sich jede Sekunde. Auf einem ruhigen Rechner tauchen nur ab und zu Einträge wie systemd-journald auf.
5. Die Anzeige lesen
| Spalte | Inhalt |
|---|---|
PID (ohne -P: TID) | Nummer des Prozesses oder Threads |
PRIO | Priorität beim Zugriff auf den Datenträger, z. B. be/4 |
USER | Benutzer, dem der Prozess gehört |
DISK READ | gelesene Menge je Sekunde |
DISK WRITE | geschriebene Menge je Sekunde |
SWAPIN | Anteil der Zeit, in der der Prozess auf ausgelagerten Speicher wartete |
IO | Anteil der Zeit, in der der Prozess auf den Datenträger wartete |
GRAPH | kleiner Verlauf der letzten Sekunden |
COMMAND | Name des Programms |
In einem schmalen Fenster lässt iotop Spalten weg. Mach das Terminal breiter, wenn SWAPIN und IO fehlen.
Die beiden Kopfzeilen unterscheiden sich so: Total ist die Menge, die die Programme beim Kernel angefordert haben. Current ist die Menge, die tatsächlich zwischen Kernel und Datenträger floss. Weil Linux Schreibvorgänge zwischenspeichert und später gebündelt ausführt, weichen die beiden Werte oft voneinander ab.
6. Mit Tasten bedienen
| Taste | Wirkung |
|---|---|
| ← → | Spalte wählen, nach der sortiert wird |
| r | Reihenfolge umkehren |
| o | nur aktive Prozesse zeigen oder alle |
| p | zwischen Prozessen und einzelnen Threads wechseln |
| a | statt der Menge je Sekunde die Summe seit dem Start von iotop zeigen |
| c | vollständige Befehlszeile zeigen |
| f | nach Benutzer- oder Prozessnummer filtern |
| ↑ ↓ | in der Liste blättern |
| h | Hilfe mit allen Tasten ein- und ausblenden |
| q | iotop beenden |
Die Taste a schaltet der Reihe nach drei Darstellungen durch. Die erste ist die Summe seit dem Start, erkennbar daran, dass in den Spalten kein /s mehr steht. Nach dem dritten Druck bist du wieder bei der Menge je Sekunde.
7. Wirkung ausprobieren
Öffne ein zweites Terminal und erzeuge dort Schreiblast. Dieser Befehl schreibt eine 2 GB große Datei aus Nullen in deinen Home-Ordner:
dd if=/dev/zero of=~/iotop-test.tmp bs=1M count=2000 oflag=dsync
Prüfen: Im ersten Terminal steht dd oben in der Liste, mit einer hohen Zahl unter DISK WRITE. Auf dem Testrechner mit SSD waren es rund 520 M/s.
Lösche die Testdatei danach wieder:
rm ~/iotop-test.tmp
Gezielt beobachten
8. Summe statt Rate zeigen
Ein Programm, das nur gelegentlich schreibt, erscheint in der Liste immer nur kurz. Mit -a zeigt iotop die Summe seit dem Start. Lässt du das einige Minuten laufen, steht oben, wer in dieser Zeit insgesamt am meisten geschrieben hat.
sudo iotop -o -P -a
9. Nur einen Benutzer oder Prozess zeigen
-u beschränkt die Liste auf einen Benutzer, hier den des Webservers:
sudo iotop -o -P -u www-data
-p beschränkt sie auf eine Prozessnummer. pgrep liefert die Nummer zum Namen, im Beispiel die des ältesten nginx-Prozesses:
sudo iotop -p $(pgrep -o nginx)
10. Befehlszeile und anderes Intervall
-c zeigt die ganze Befehlszeile statt nur des Programmnamens. So unterscheidest du mehrere Prozesse desselben Programms. -d legt den Abstand zwischen zwei Messungen in Sekunden fest.
sudo iotop -o -P -c -d 5
Ausgabe für Protokolle und Skripte
11. Stapelmodus nutzen
Mit -b schreibt iotop fortlaufend Text, statt den Bildschirm zu übernehmen. -n begrenzt die Zahl der Messungen, -t setzt die Uhrzeit dazu, -qq lässt die Spaltenüberschriften weg. Dieser Befehl misst eine Minute lang alle fünf Sekunden und schreibt das Ergebnis in eine Datei:
sudo iotop -b -o -P -t -qq -d 5 -n 12 > ~/iotop.log
Prüfen: Die Datei enthält je Messung zwei Summenzeilen mit Datum und Uhrzeit, darunter die aktiven Prozesse.
less ~/iotop.log
Für eine dauerhafte Aufzeichnung, in der sich auch nachts um drei nachschlagen lässt, eignet sich atop besser.
Wartezeit auf den Datenträger anzeigen
Die Spalte IO beantwortet eine andere Frage als die Schreibmenge: Sie zeigt, welcher Prozess ausgebremst wird, weil er auf den Datenträger warten muss. Dafür muss der Kernel die Wartezeiten erfassen.
12. Erfassung vorübergehend einschalten
Diese Einstellung gilt bis zum nächsten Neustart.
sudo sysctl kernel.task_delayacct=1
Prüfen: Die Ausgabe lautet kernel.task_delayacct = 1. Der Wert gilt für Prozesse, die danach gestartet werden. Wiederholst du Schritt 7, steht bei dd in der Spalte IO nun ein Prozentwert, auf dem Testrechner rund 37 %.
Die Erfassung kostet etwas Rechenzeit, deshalb ist sie ab Werk aus. Zum Ausschalten:
sudo sysctl kernel.task_delayacct=0
13. Erfassung dauerhaft einschalten
Nur nötig, wenn du die Spalte regelmäßig brauchst. Lege eine eigene Datei für die Einstellung an:
sudo nano /etc/sysctl.d/90-delayacct.conf
Trage diese Zeile ein:
kernel.task_delayacct = 1
Speichere mit Strg+O, Enter und beende nano mit Strg+X. Dann die Einstellungen neu laden:
sudo sysctl --system
Prüfen: Der Wert ist 1.
cat /proc/sys/kernel/task_delayacct
Wie geht es weiter?
- Priorität ändern: Die Taste i in iotop ändert die Priorität eines Prozesses beim Zugriff auf den Datenträger. Dasselbe leistet der Befehl
ionice, etwa um eine Datensicherung im Hintergrund zu bremsen. - Auslastung je Laufwerk: Wie stark ein Datenträger als Ganzes beschäftigt ist, zeigt
iostataus sysstat. - Wer belegt den Platz? Welche Ordner die Festplatte füllen, zeigt ncdu.
- Dokumentation:
man iotop-csowie https://github.com/Tomas-M/iotop
Deinstallieren
1. iotop-c entfernen
Damit verschwindet auch der Verweis iotop.
sudo apt purge iotop-c
2. Kerneleinstellung zurücknehmen
Nur nötig, wenn du Schritt 13 ausgeführt hast.
sudo rm /etc/sysctl.d/90-delayacct.conf
sudo sysctl kernel.task_delayacct=0
3. Eigene Dateien löschen
Nur nötig, wenn die Dateien aus den Schritten 7 und 11 noch vorhanden sind.
rm -f ~/iotop.log ~/iotop-test.tmp
Prüfen: Der Befehl wird nicht mehr gefunden.
iotop --version
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/Tomas-M/iotop
- Lizenz: iotop steht unter der GPL-2.0-or-later.
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.
NetHogs
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
NetHogs zeigt im Terminal, welches Programm gerade wie viel über das Netzwerk sendet und empfängt. Andere Werkzeuge schlüsseln den Verkehr nach Netzwerkkarte oder Gegenstelle auf, NetHogs ordnet ihn dem Prozess zu. Ist die Leitung unerwartet ausgelastet, siehst du so sofort, ob gerade ein Update lädt, eine Datensicherung läuft oder ein Programm etwas hochlädt, von dem du nichts wusstest.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert NetHogs 0.8.8 als einzelnes Paket ohne weitere Abhängigkeiten. Ein Dienst läuft nicht.
- Nur mit
sudo: NetHogs liest die Pakete direkt an der Netzwerkkarte mit. Das darf nurroot. Ohnesudobricht es mitError opening handler for deviceab. - Nur der Augenblick: NetHogs zählt ab dem Start und speichert nichts. Für Verbrauchszahlen über Tage und Monate eignet sich vnStat.
- Was gezählt wird: Ab Werk erfasst NetHogs TCP-Verbindungen. Die Zeile
unknown TCPsammelt Verkehr, den es keinem Prozess zuordnen konnte, etwa von Verbindungen, die schon wieder geschlossen sind. - Englische Oberfläche: Die Anzeige ist englisch, Zahlen erscheinen mit Punkt als Dezimaltrenner.
- Version: Getestet mit NetHogs 0.8.8 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. NetHogs installieren
sudo apt install nethogs
3. Version prüfen
nethogs -V
Prüfen: Die Ausgabe lautet version 0.8.8-1.
Netzwerkverkehr live ansehen
4. NetHogs starten
Ohne weitere Angabe beobachtet NetHogs alle aktiven Netzwerkkarten außer der internen Schnittstelle lo.
sudo nethogs
Prüfen: Es erscheint eine Liste, die sich jede Sekunde erneuert. Das Programm mit dem meisten empfangenen Verkehr steht oben, die letzte Zeile TOTAL nennt die Summe:
NetHogs version 0.8.8-1
PID USER PROGRAM DEV SENT RECEIVED
78677 thorst.. curl enp3s0 2.004 1569.653 kB/s
5900 thorst.. /opt/google/chrome/chr.. enp3s0 0.047 0.047 kB/s
? root unknown TCP 0.000 0.000 kB/s
TOTAL 2.051 1569.700 kB/s
Auf einem ruhigen Rechner ist die Liste fast leer. Ein Programm taucht erst auf, wenn es nach dem Start von NetHogs etwas überträgt.
5. Die Spalten lesen
| Spalte | Inhalt |
|---|---|
PID | Nummer des Prozesses |
USER | Benutzer, dem der Prozess gehört |
PROGRAM | Pfad des Programms |
DEV | Netzwerkkarte, über die der Verkehr läuft |
SENT | gesendete Menge, ab Werk in kB je Sekunde |
RECEIVED | empfangene Menge |
6. Mit Tasten bedienen
| Taste | Wirkung |
|---|---|
| m | Einheit wechseln (siehe unten) |
| s | nach gesendeter Menge sortieren |
| r | nach empfangener Menge sortieren (Standard) |
| l | vollständige Befehlszeile statt nur des Programms zeigen |
| b | nur den Programmnamen ohne Pfad zeigen |
| q | NetHogs beenden |
Die Taste m schaltet der Reihe nach durch: kB je Sekunde, Summe in kB, Summe in Bytes, Summe in MB, MB je Sekunde und GB je Sekunde. Die Einheit steht rechts neben den Zahlen. Die Summen zählen ab dem Start von NetHogs. Lässt du es einige Minuten laufen, siehst du, wer in dieser Zeit insgesamt am meisten übertragen hat.
7. Wirkung ausprobieren
Öffne ein zweites Terminal und lade dort eine größere Datei, ohne sie zu speichern. Dieser Befehl holt eine rund 38 MB große Dateiliste vom Ubuntu-Server und begrenzt das Tempo auf 2 MB je Sekunde, damit der Vorgang lange genug dauert:
curl --limit-rate 2M -o /dev/null http://de.archive.ubuntu.com/ubuntu/ls-lR.gz
Prüfen: Im ersten Terminal steht curl oben in der Liste, mit einem hohen Wert unter RECEIVED und einem kleinen unter SENT.
Gezielt beobachten
8. Nur eine Netzwerkkarte beobachten
Die Namen der Netzwerkkarten zeigt dieser Befehl. UP bedeutet, dass die Karte verbunden ist.
ip -br link
Den Namen hängst du an den Aufruf an, im Beispiel enp3s0. Mehrere Namen hintereinander sind erlaubt.
sudo nethogs enp3s0
Nennst du eine Karte ohne Verbindung, meldet NetHogs No devices to monitor.
9. Auch interne Verbindungen zeigen
Verkehr zwischen Programmen auf demselben Rechner läuft über die Schnittstelle lo, zum Beispiel von nginx zu einem Dienst dahinter. Mit -a beobachtet NetHogs auch sie.
sudo nethogs -a
10. Summen statt Rate und anderes Intervall
-v legt die Einheit schon beim Start fest: 0 kB je Sekunde, 1 Summe in kB, 2 Summe in Bytes, 3 Summe in MB, 4 MB je Sekunde. -d bestimmt den Abstand der Aktualisierung in Sekunden.
sudo nethogs -v 3 -d 5
11. Auch UDP erfassen
Mit -C zählt NetHogs zusätzlich UDP-Pakete. Darüber laufen zum Beispiel DNS-Abfragen, viele Videokonferenzen und das von modernen Browsern genutzte Protokoll QUIC.
sudo nethogs -C
Ausgabe für Protokolle und Skripte
12. Textmodus nutzen
Mit -t schreibt NetHogs fortlaufend Text, statt den Bildschirm zu übernehmen. -c begrenzt die Zahl der Durchläufe. Dieser Befehl misst eine Minute lang alle fünf Sekunden und schreibt in eine Datei:
sudo nethogs -t -d 5 -c 12 > ~/nethogs.log
Prüfen: Die Datei enthält je Durchlauf einen Block, der mit Refreshing: beginnt.
less ~/nethogs.log
Jede Zeile darin besteht aus Programm, Prozessnummer und Benutzernummer, getrennt durch Schrägstriche, gefolgt von gesendeter und empfangener Menge in kB je Sekunde:
Refreshing:
curl/78623/1000 0.244922 623.658
unknown TCP/0/0 0 0
Wie geht es weiter?
- Verbrauch über Tage und Monate: vnStat zeichnet auf, wie viel jede Netzwerkkarte übertragen hat.
- Alles auf einen Blick: Glances und btop zeigen Netzwerk, Prozessor und Speicher zusammen, allerdings ohne Aufteilung nach Prozess.
- Festplatte statt Netzwerk: Dieselbe Frage für den Datenträger beantwortet iotop.
- Dokumentation:
man nethogssowie https://github.com/raboof/nethogs
Deinstallieren
1. NetHogs entfernen
sudo apt purge nethogs
2. Eigene Dateien löschen
Nur nötig, wenn du Schritt 12 ausgeführt hast.
rm -f ~/nethogs.log
Prüfen: Der Befehl wird nicht mehr gefunden.
nethogs -V
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/raboof/nethogs
- Lizenz: NetHogs steht unter der GPL-2.0-or-later.
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.
iftop
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
iftop zeigt im Terminal, mit welchen Gegenstellen der Rechner gerade Daten austauscht und wie viel über jede dieser Verbindungen fließt. Die Liste ist nach Durchsatz sortiert und erneuert sich laufend. So erkennst du, wohin eine ausgelastete Leitung ihre Bandbreite verliert: an einen einzelnen Besucher, der die Website abgrast, an einen Server für Updates oder an eine Adresse, die du nicht kennst.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert iftop 1.0pre4 als einzelnes Paket ohne weitere Abhängigkeiten. Ein Dienst läuft nicht.
- Nur mit
sudo: iftop liest die Pakete direkt an der Netzwerkkarte mit. Das darf nurroot. Ohnesudobricht es mitYou don't have permission to perform this captureab. - Gegenstellen, nicht Programme: iftop weiß nicht, welcher Prozess eine Verbindung geöffnet hat. Diese Frage beantwortet NetHogs. Beide ergänzen sich.
- Bit statt Byte: Die Raten stehen ab Werk in Bit je Sekunde (
Kb,Mb), wie bei Angaben von Internetanbietern. 8 Mb entsprechen 1 MB je Sekunde. Die Option-Bschaltet auf Byte um. - Nur der Augenblick: iftop zählt ab dem Start und speichert nichts. Für Verbrauchszahlen über Tage und Monate eignet sich vnStat.
- Englische Oberfläche: Anzeige und Hilfe sind englisch, Zahlen erscheinen mit deutschem Komma.
- Version: Getestet mit iftop 1.0pre4 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. iftop installieren
sudo apt install iftop
3. Installation prüfen
iftop hat keine eigene Option für die Version. Sie steht am Ende der Hilfe.
iftop -h
Prüfen: Die vorletzte Zeile lautet iftop, version 1.0pre4.
Verbindungen live ansehen
4. iftop starten
Ohne weitere Angabe wählt iftop die erste Netzwerkkarte, die nach außen führt.
sudo iftop
Prüfen: Oben steht eine Skala, darunter je Verbindung ein Zeilenpaar, unten drei Summenzeilen. Die Anzeige erneuert sich laufend.
192.168.178.20 => 141.30.62.25 33,0Kb 48,1Kb 48,1Kb
<= 9,81Mb 9,35Mb 9,35Mb
TX: cum: 50,7KB peak: 141Kb rates: 35,1Kb 50,7Kb 50,7Kb
RX: 9,36MB 13,1Mb 9,81Mb 9,36Mb 9,36Mb
TOTAL: 9,41MB 13,2Mb 9,84Mb 9,41Mb 9,41Mb
5. Die Anzeige lesen
Links steht der eigene Rechner, rechts die Gegenstelle. Die Zeile mit => ist der gesendete, die mit <= der empfangene Verkehr. Die drei Zahlenspalten sind Durchschnitte über die letzten 2, 10 und 40 Sekunden. Sortiert ist nach der mittleren Spalte. Ein heller Balken hinter jeder Zeile zeigt die Rate im Verhältnis zur Skala am oberen Rand.
In den Summenzeilen steht TX für gesendet, RX für empfangen. cum ist die Menge seit dem Start in Byte, peak der höchste bisher gemessene Wert, rates wieder die drei Durchschnitte.
6. Mit Tasten bedienen
| Taste | Wirkung |
|---|---|
| n | Rechnernamen oder IP-Adressen zeigen |
| p | Ports mit anzeigen |
| N | Ports als Nummer oder als Dienstname (http, https) zeigen |
| t | Darstellung wechseln: zwei Zeilen je Verbindung, eine Zeile, nur gesendet, nur empfangen |
| T | zusätzliche Spalte mit der Summe je Verbindung seit dem Start |
| 1 2 3 | nach der ersten, zweiten oder dritten Zahlenspalte sortieren |
| j k | in der Liste nach unten und oben blättern |
| P | Anzeige anhalten und fortsetzen |
| h | Hilfe mit allen Tasten ein- und ausblenden |
| q | iftop beenden |
Nach jedem Tastendruck steht links oben kurz, was umgeschaltet wurde, z. B. DNS resolution off oder Port display ON.
7. Wirkung ausprobieren
Öffne ein zweites Terminal und lade dort eine größere Datei, ohne sie zu speichern. Dieser Befehl holt eine rund 38 MB große Dateiliste vom Ubuntu-Server und begrenzt das Tempo auf 2 MB je Sekunde, damit der Vorgang lange genug dauert:
curl --limit-rate 2M -o /dev/null http://de.archive.ubuntu.com/ubuntu/ls-lR.gz
Prüfen: Im ersten Terminal rückt die Verbindung zum Ubuntu-Server an die erste Stelle, mit einem hohen Wert in der Zeile <=. Drückst du p, steht hinter der Gegenstelle :http.
Gezielt beobachten
8. Ohne Namensauflösung und mit Ports starten
iftop fragt zu jeder Adresse den Namen ab. Das erzeugt selbst Verkehr und verzögert die Anzeige. -n zeigt stattdessen die IP-Adressen, -P blendet die Ports von Anfang an ein, -B rechnet in Byte.
sudo iftop -n -P -B
9. Eine bestimmte Netzwerkkarte wählen
Die Namen der Netzwerkkarten zeigt dieser Befehl:
ip -br link
Den Namen übergibst du mit -i, im Beispiel enp3s0:
sudo iftop -i enp3s0
10. Nur bestimmten Verkehr zählen
-f nimmt einen Filter in derselben Schreibweise wie tcpdump. Dieser Befehl zählt nur Webverkehr auf den Ports 80 und 443:
sudo iftop -n -f 'port 80 or port 443'
Weitere nützliche Filter:
| Filter | Wirkung |
|---|---|
port 22 | nur SSH |
host 192.168.178.1 | nur Verkehr mit dieser Adresse |
not port 53 | alles außer DNS-Abfragen |
Im laufenden Programm änderst du den Filter mit der Taste f.
Ausgabe für Protokolle und Skripte
11. Textmodus nutzen
Mit -t schreibt iftop Text, statt den Bildschirm zu übernehmen. -s beendet es nach der angegebenen Zahl von Sekunden und gibt dann eine einzige Übersicht aus, -L begrenzt die Zahl der Verbindungen. Dieser Befehl misst zehn Sekunden und schreibt die zehn stärksten Verbindungen in eine Datei:
sudo iftop -t -n -s 10 -L 10 > ~/iftop.log
Prüfen: Die Datei enthält eine Tabelle mit den Spalten last 2s, last 10s, last 40s und cumulative, darunter die Summen.
less ~/iftop.log
Wie geht es weiter?
- Welches Programm ist es? Hast du eine auffällige Verbindung gefunden, zeigt NetHogs den Prozess dazu.
- Verbrauch über Tage und Monate: vnStat zeichnet auf, wie viel jede Netzwerkkarte übertragen hat.
- Besucher der Website: Wer wie oft welche Seite aufgerufen hat, steht im Zugriffsprotokoll des Webservers. GoAccess wertet es aus.
- Dokumentation:
man iftopsowie https://pdw.ex-parrot.com/iftop/
Deinstallieren
1. iftop entfernen
sudo apt purge iftop
2. Eigene Dateien löschen
Nur nötig, wenn du Schritt 11 ausgeführt hast.
rm -f ~/iftop.log
Prüfen: Der Befehl wird nicht mehr gefunden.
iftop -h
Quellen und Lizenz
- Offizielle Dokumentation: http://www.ex-parrot.com/pdw/iftop/
- Lizenz: iftop steht unter der GPL-2.0-or-later.
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.
Logwatch
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Logwatch liest einmal am Tag die Protokolle des Rechners und fasst sie zu einem kurzen Bericht zusammen: welche Pakete installiert wurden, wer sich angemeldet hat, welche Befehle mit sudo liefen, welche Fehler der Kernel gemeldet hat, wie viele Zugriffe der Webserver hatte und wie voll die Festplatten sind. Den Bericht verschickt es per E-Mail oder zeigt ihn im Terminal. So musst du nicht jeden Tag selbst durch die Protokolle blättern und bemerkst trotzdem, wenn etwas Ungewöhnliches passiert.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Logwatch 7.12. Mitinstalliert wird das empfohlene Paket
libdate-manip-perl, das frei wählbare Zeiträume wie „die letzten sieben Tage“ ermöglicht. - Mailprogramm als Abhängigkeit: Logwatch verlangt ein Programm zum Versenden von E-Mails. Ist noch keines vorhanden, installiert
aptPostfix mit und fragt nach der Art der Einrichtung. Dieser Teil ist nicht selbst getestet, weil Postfix auf dem Testrechner schon vorhanden war. Für Berichte, die auf dem Rechner bleiben, genügt die Auswahl Nur lokal (Local only). - Kein Dienst: Logwatch läuft nicht dauernd. Das Paket legt die Datei
/etc/cron.daily/00logwatchan, die den Bericht einmal täglich erzeugt und anrootschickt. - Mit
sudo: Viele Protokolle darf nurrootlesen. Ohnesudostartet Logwatch zwar, der Bericht bleibt aber weitgehend leer. - Englische Berichte: Überschriften und Texte der Berichte sind englisch.
- Version: Getestet mit Logwatch 7.12 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Logwatch installieren
sudo apt install logwatch
Erscheint dabei ein Dialog zur Einrichtung von Postfix, wähle Nur lokal und bestätige den vorgeschlagenen Namen des Rechners.
3. Version prüfen
logwatch --version
Prüfen: Die Ausgabe lautet Logwatch 7.12 (released 01/22/25).
Bericht im Terminal ansehen
4. Bericht für heute erzeugen
Ohne weitere Angabe wertet Logwatch den gestrigen Tag aus. --range today nimmt stattdessen den heutigen, so siehst du gleich etwas zur eben erfolgten Installation.
sudo logwatch --range today
Prüfen: Nach ein bis zwei Sekunden erscheint der Bericht. Er beginnt mit einem Kopf, der Zeitraum und Detailstufe nennt. Darunter folgt je Thema ein Abschnitt zwischen Begin und End:
--------------------- dpkg status changes Begin ------------------------
Installed:
libdate-manip-perl:all 6.98-1
logwatch:all 7.12-3ubuntu2
---------------------- dpkg status changes End -------------------------
Abschnitte erscheinen nur für Themen, zu denen es im Zeitraum Einträge gab.
5. Die wichtigsten Abschnitte
| Abschnitt | Inhalt |
|---|---|
dpkg status changes | installierte, aktualisierte und entfernte Pakete |
Kernel | Fehlermeldungen des Kernels, etwa von Treibern oder Datenträgern |
pam_unix | geöffnete Sitzungen, fehlgeschlagene Anmeldungen |
SSHD | Anmeldungen und abgewiesene Versuche über SSH |
Sudo (secure-log) | welcher Benutzer welche Befehle mit sudo ausgeführt hat |
Cron | ausgeführte Cronjobs |
httpd | Zugriffe auf den Webserver, übertragene Menge, Fehlerseiten |
Postfix | zugestellte und abgewiesene E-Mails |
Disk Space | Belegung der Dateisysteme |
Der Abschnitt httpd wertet auch die Protokolle von nginx aus.
6. Detailstufe wählen
--detail kennt die Stufen low, med und high. Die Voreinstellung ist low. Höhere Stufen zeigen zusätzliche Abschnitte und mehr Einzelheiten.
sudo logwatch --range today --detail high
Weil der Bericht dann lang wird, hilft ein Blätterprogramm:
sudo logwatch --range today --detail high | less
7. Zeitraum wählen
Mehrere Wörter gehören in Anführungszeichen. Dieser Befehl fasst die letzten sieben Tage zusammen:
sudo logwatch --range 'between -7 days and today'
Weitere Möglichkeiten sind yesterday, today und all. Bei längeren Zeiträumen liegen ältere Einträge oft schon in gepackten Dateien wie syslog.2.gz. Die Option --archives bezieht sie mit ein. Alle Schreibweisen zeigt:
logwatch --range help
8. Nur ein Thema auswerten
--service beschränkt den Bericht auf ein Thema. Die Option darf mehrfach vorkommen. Dieser Befehl zeigt nur, welche Befehle in der letzten Woche mit sudo liefen:
sudo logwatch --service sudo --range 'between -7 days and today'
Die Namen aller Themen sind die Dateinamen in diesem Ordner:
ls /usr/share/logwatch/scripts/services
Gebräuchlich sind sshd, sudo, http, kernel, dpkg, postfix und fail2ban.
Bericht speichern oder verschicken
9. Bericht als HTML-Datei speichern
--output file schreibt in eine Datei, --format html erzeugt eine Seite für den Browser.
sudo logwatch --range today --format html --output file --filename /root/bericht.html
Prüfen: Die Datei ist angelegt. Sie gehört root und ist nur für root lesbar, weil der Bericht vertrauliche Angaben enthalten kann.
sudo ls -l /root/bericht.html
10. Bericht per E-Mail an einen lokalen Benutzer schicken
--mailto verschickt den Bericht, statt ihn anzuzeigen. Ersetze thorsten durch deinen Benutzernamen.
sudo logwatch --range today --mailto thorsten
Prüfen: Die E-Mail liegt nach wenigen Sekunden im lokalen Postfach. Der Betreff lautet Logwatch for <Rechnername> (Linux).
less /var/mail/thorsten
Eine Adresse außerhalb des Rechners, z. B. name@example.org, funktioniert nur, wenn Postfix E-Mails ins Internet zustellen darf. Bei der Einrichtung Nur lokal ist das nicht der Fall.
Täglichen Bericht einrichten
Den täglichen Lauf gibt es bereits. Du legst nur noch fest, wohin der Bericht geht und wie ausführlich er ist.
11. Eigene Einstellungen anlegen
Die Voreinstellungen stehen in /usr/share/logwatch/default.conf/logwatch.conf. Diese Datei wird bei Updates überschrieben. Eigene Werte gehören in eine neue Datei unter /etc/logwatch/conf, sie haben Vorrang.
sudo nano /etc/logwatch/conf/logwatch.conf
Trage ein, was du ändern willst. Ein Beispiel:
MailTo = thorsten
Detail = Med
Range = yesterday
MailTo ist der Empfänger, Detail die Stufe aus Schritt 6, Range der Zeitraum aus Schritt 7. Speichere mit Strg+O, Enter und beende nano mit Strg+X.
12. Themen ausschließen
Ein Thema, das dich nicht interessiert, schaltest du in derselben Datei mit einem Minus vor dem Namen ab. Die erste Zeile wählt zunächst alle Themen, die zweite nimmt eines wieder heraus:
Service = All
Service = "-pam_unix"
13. Täglichen Lauf von Hand auslösen
Dieser Befehl ist derselbe, den der Cronjob jede Nacht ausführt. So prüfst du deine Einstellungen, ohne bis morgen zu warten.
sudo logwatch --output mail
Prüfen: Im Postfach des Empfängers aus Schritt 11 liegt eine neue E-Mail.
less /var/mail/thorsten
14. Zeitpunkt des täglichen Laufs
Die Skripte in /etc/cron.daily startet Ubuntu einmal täglich am frühen Morgen. Läuft der Rechner zu dieser Zeit nicht, holt er den Lauf nach dem Einschalten nach. Der Bericht behandelt dann den Vortag.
Wie geht es weiter?
- Protokolle selbst durchsehen: Fällt im Bericht etwas auf, zeigt lnav die zugehörigen Meldungen im Zusammenhang.
- Webzugriffe genauer: Eine ausführliche Auswertung der Besucher liefert GoAccess.
- Sofort statt täglich: Logwatch berichtet im Nachhinein. Wer bei einem Ausfall sofort benachrichtigt werden will, nimmt Monit oder Uptime Kuma.
- Dokumentation:
man logwatchsowie die ausführlich kommentierte Datei/usr/share/logwatch/default.conf/logwatch.conf
Deinstallieren
1. Logwatch entfernen
purge löscht auch den täglichen Cronjob und den Ordner /etc/logwatch mit deinen Einstellungen.
sudo apt purge logwatch libdate-manip-perl
Postfix bleibt installiert. Wie man es entfernt, hängt davon ab, ob andere Programme es brauchen.
2. Eigene Dateien löschen
Nur nötig, wenn du Schritt 9 ausgeführt hast.
sudo rm -f /root/bericht.html
Prüfen: Der Befehl wird nicht mehr gefunden.
logwatch --version
Quellen und Lizenz
- Offizielle Dokumentation: https://sourceforge.net/projects/logwatch/
- Lizenz: Logwatch steht unter der MIT.
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.
OpenSSH-Server
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mit SSH (Secure Shell) bedienst du einen entfernten Rechner im Terminal, als säßest du davor. Die Verbindung ist verschlüsselt. Der OpenSSH-Server nimmt solche Verbindungen entgegen und ist der übliche Weg, einen Server ohne Bildschirm zu verwalten, Dateien dorthin zu kopieren oder mit Git zu arbeiten. Diese Anleitung installiert den Server, richtet die Anmeldung mit Schlüssel statt Passwort ein und schaltet danach die unsicheren Wege ab.
Vorbemerkungen
- Zwei Rechner: In dieser Anleitung ist der Server der Rechner, auf den du zugreifen willst, und der Arbeitsplatz der Rechner, an dem du sitzt. Über jedem Abschnitt steht, wo die Befehle auszuführen sind. Das Programm
sshfür den Arbeitsplatz ist bei Ubuntu schon installiert. - Installation über apt: Ubuntu 26.04 liefert OpenSSH 10.2. Das Paket
openssh-serverzieht drei kleine Pakete nach. - Sofort erreichbar: Nach der Installation nimmt der Server auf Port 22 auf allen Netzwerkschnittstellen Verbindungen an. Jeder Benutzer des Rechners kann sich dann mit seinem Passwort anmelden. Auf einem Server im Internet beginnen fremde Anmeldeversuche binnen Minuten. Richte deshalb die Schritte 6 bis 13 zügig ein.
- Start bei Bedarf: Ubuntu startet den eigentlichen Dienst erst bei der ersten Verbindung. Dauerhaft aktiv ist nur
ssh.socket, das auf dem Port lauscht. Für Port und Adresse hat das Folgen, siehe Schritt 15. - Eigene Einstellungen in eigener Datei: Die Datei
/etc/ssh/sshd_configbleibt unverändert. Eigene Werte kommen in eine Datei im Ordner/etc/ssh/sshd_config.d. Gilt eine Einstellung mehrfach, gewinnt die zuerst gelesene, und dieser Ordner wird vor dem Rest gelesen. - Nicht aussperren: Schalte die Anmeldung mit Passwort erst ab, wenn die Anmeldung mit Schlüssel nachweislich funktioniert. Lass dabei eine bestehende Verbindung offen, bis du in einem zweiten Fenster eine neue aufgebaut hast.
- Version: Getestet mit OpenSSH 10.2p1 am 4. Oktober 2026. Geprüft sind Installation, Einstellungen, Syntaxprüfung, Portwechsel und das Erzeugen eines Schlüssels. Nicht selbst getestet sind das Übertragen des Schlüssels mit
ssh-copy-idund die Anmeldung selbst (Schritte 8 bis 10), weil dafür auf dem Testrechner ein Zugang hätte hinterlegt werden müssen. Diese Schritte folgen der Dokumentation.
Installation
Auf dem Server.
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. OpenSSH-Server installieren
sudo apt install openssh-server
3. Version prüfen
sshd -V
Prüfen: Die Ausgabe beginnt mit OpenSSH_10.2p1.
4. Prüfen, dass der Server lauscht
sudo ss -ltnp | grep ':22 '
Prüfen: Es erscheint mindestens eine Zeile mit Port 22. Als Programm steht dort systemd, das den Port stellvertretend offen hält.
systemctl is-active ssh.socket
Die Ausgabe lautet active.
5. Adresse des Servers ermitteln
hostname -I
Prüfen: Die erste Adresse der Ausgabe, z. B. 192.168.178.20, brauchst du gleich am Arbeitsplatz. In den Beispielen steht dafür SERVER, für deinen Benutzernamen auf dem Server benutzer.
Schlüssel erzeugen und übertragen
Am Arbeitsplatz.
Ein Schlüssel besteht aus zwei Dateien. Der private Teil bleibt auf dem Arbeitsplatz und wird nie weitergegeben. Der öffentliche Teil kommt auf den Server. Anmelden kann sich nur, wer den privaten Teil besitzt.
6. Schlüsselpaar erzeugen
Ed25519 ist das heute übliche Verfahren. Der Text hinter -C ist ein frei wählbarer Vermerk, an dem du den Schlüssel später wiedererkennst.
ssh-keygen -t ed25519 -C "thorsten@arbeitsplatz"
Bestätige den vorgeschlagenen Speicherort mit Enter. Danach fragt das Programm zweimal nach einer Passphrase. Sie schützt den privaten Schlüssel, falls jemand die Datei in die Hände bekommt. Vergib eine.
Hast du schon ein Schlüsselpaar, überspringe diesen Schritt. Ein vorhandenes würde sonst überschrieben, das Programm fragt vorher nach.
7. Schlüssel ansehen
ls -l ~/.ssh/id_ed25519 ~/.ssh/id_ed25519.pub
Prüfen: Es gibt zwei Dateien. id_ed25519 ist der private Teil und nur für dich lesbar (-rw-------), id_ed25519.pub der öffentliche.
8. Öffentlichen Schlüssel auf den Server übertragen
ssh-copy-id benutzer@SERVER
Bei der ersten Verbindung zeigt ssh den Fingerabdruck des Servers und fragt, ob du ihm vertraust. Vergleiche ihn mit der Ausgabe aus Schritt 11 und antworte mit yes. Danach gibst du einmalig das Passwort deines Benutzers auf dem Server ein.
ssh-copy-id hängt den öffentlichen Schlüssel auf dem Server an die Datei ~/.ssh/authorized_keys an.
9. Mit Schlüssel anmelden
ssh benutzer@SERVER
Prüfen: Statt des Passworts für den Server wird die Passphrase des Schlüssels abgefragt. Danach zeigt die Eingabezeile den Namen des Servers.
10. Verbindung beenden
exit
Server absichern
Auf dem Server. Lass dazu eine SSH-Verbindung offen oder arbeite direkt am Gerät.
11. Fingerabdruck des Servers anzeigen
Mit diesem Wert vergleichst du die Angabe, die ssh bei der ersten Verbindung zeigt. Stimmen beide überein, sprichst du wirklich mit deinem Server.
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
Prüfen: Die Ausgabe enthält eine Zeichenfolge, die mit SHA256: beginnt.
12. Datei für eigene Einstellungen anlegen
sudo nano /etc/ssh/sshd_config.d/10-absicherung.conf
Füge diesen Inhalt ein und ersetze benutzer durch deinen Benutzernamen:
PermitRootLogin no
PasswordAuthentication no
MaxAuthTries 3
X11Forwarding no
AllowUsers benutzer
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
PermitRootLogin no– der Benutzerrootdarf sich gar nicht anmelden. Verwaltet wird über einen gewöhnlichen Benutzer mitsudo.PasswordAuthentication no– Anmeldung nur noch mit Schlüssel. Das Durchprobieren von Passwörtern läuft damit ins Leere.MaxAuthTries 3– nach drei Fehlversuchen trennt der Server die Verbindung. Ab Werk sind es sechs.X11Forwarding no– schaltet das Weiterleiten grafischer Programme ab, das auf einem Server selten gebraucht wird.AllowUsers– nur die genannten Benutzer dürfen sich anmelden. Mehrere Namen trennst du mit Leerzeichen.
13. Einstellungen prüfen und anwenden
sshd -t prüft alle Dateien auf Fehler, ohne etwas zu ändern. Mach das vor jedem Neustart: Ein Tippfehler würde verhindern, dass der Dienst wieder startet.
sudo sshd -t
Prüfen: Es erscheint keine Ausgabe. Bei einem Fehler nennt der Befehl Datei und Zeile, z. B. line 1: Bad configuration option: PermitRootLogn.
sudo systemctl restart ssh
14. Wirksame Einstellungen ansehen
sshd -T gibt aus, was nach dem Zusammenführen aller Dateien tatsächlich gilt.
sudo sshd -T | grep -E '^(permitrootlogin|passwordauthentication|maxauthtries|allowusers) '
Prüfen: Die Ausgabe lautet:
maxauthtries 3
permitrootlogin no
passwordauthentication no
allowusers benutzer
Öffne jetzt am Arbeitsplatz ein zweites Terminal und melde dich neu an (Schritt 9). Erst wenn das klappt, schließt du die alte Verbindung.
Ein Anmeldeversuch ohne Schlüssel endet nun mit Permission denied (publickey).
15. Optional: Anderen Port verwenden
Ein anderer Port macht den Server nicht sicherer, hält aber die Protokolle frei von den vielen automatischen Versuchen auf Port 22. Lege eine weitere Datei an:
sudo nano /etc/ssh/sshd_config.d/20-port.conf
Port 2222
Weil bei Ubuntu ssh.socket den Port offen hält, genügt ein Neustart des Dienstes hier nicht. Die folgenden beiden Befehle lassen systemd die Einstellung neu einlesen und den Port wechseln:
sudo systemctl daemon-reload
sudo systemctl restart ssh.socket
Prüfen: Es lauscht nur noch der neue Port.
sudo ss -ltn | grep -E ':(22|2222) '
Dasselbe gilt, wenn du mit ListenAddress festlegst, auf welcher Adresse der Server lauscht. Am Arbeitsplatz gibst du den Port mit ssh -p 2222 benutzer@SERVER an.
Bequemer verbinden
Am Arbeitsplatz.
16. Kurznamen für den Server anlegen
nano ~/.ssh/config
Host meinserver
HostName SERVER
User benutzer
Port 22
Speichere mit Strg+O, Enter und beende nano mit Strg+X. Ersetze SERVER durch Adresse oder Namen des Servers.
Prüfen: Die Anmeldung gelingt jetzt mit dem Kurznamen.
ssh meinserver
17. Dateien kopieren
scp kopiert über dieselbe Verbindung. Der Doppelpunkt trennt den Server vom Pfad dort.
scp datei.txt meinserver:/home/benutzer/
Für ganze Ordner eignet sich rsync -av ordner/ meinserver:ordner/. Es überträgt bei einer Wiederholung nur, was sich geändert hat.
Wie geht es weiter?
- Firewall: Gib den Port in UFW frei, bevor du die Firewall einschaltest:
sudo ufw allow sshodersudo ufw allow 2222/tcp. - Fehlversuche sperren: Fail2ban sperrt Adressen, die sich wiederholt vergeblich anmelden. Das Jail für SSH ist dort schon eingeschaltet.
- Passphrase nur einmal eingeben:
ssh-agenthält den entsperrten Schlüssel für die Dauer der Sitzung bereit,ssh-addübergibt ihn. Nicht selbst getestet. - Git über SSH: Wie ein Server Repositories über SSH anbietet, zeigt Git und cgit.
- Dokumentation:
man sshd_config,man ssh_configsowie https://www.openssh.com/manual.html
Deinstallieren
Auf dem Server. Danach ist der Rechner über SSH nicht mehr erreichbar. Arbeite dafür direkt am Gerät oder stelle sicher, dass du einen anderen Zugang hast.
1. OpenSSH-Server entfernen
purge löscht auch /etc/ssh/sshd_config und die Schlüssel des Servers (ssh_host_*). apt meldet dabei, dass /etc/ssh/sshd_config.d nicht leer ist, weil dort noch die eigenen Dateien liegen. Das Programm ssh zum Verbinden mit anderen Rechnern bleibt erhalten.
sudo apt purge openssh-server openssh-sftp-server ncurses-term ssh-import-id
2. Eigene Einstellungen löschen
sudo rm -rf /etc/ssh/sshd_config.d
3. Hinterlegte Schlüssel entfernen
Die Datei mit den zugelassenen öffentlichen Schlüsseln liegt im Home-Ordner und gehört zu keinem Paket.
rm -f ~/.ssh/authorized_keys
Prüfen: Port 22 ist geschlossen, der Befehl gibt nichts aus.
sudo ss -ltn | grep ':22 '
Quellen und Lizenz
- Offizielle Dokumentation: https://www.openssh.com/manual.html
- Lizenz: OpenSSH steht unter der BSD-Lizenz.
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.
UFW
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
UFW (Uncomplicated Firewall) ist die Firewall, die Ubuntu mitbringt. Sie legt fest, welche Verbindungen von außen den Rechner erreichen dürfen, und übersetzt kurze Befehle wie ufw allow 80/tcp in die umfangreichen Regeln des Kernels. Der übliche Aufbau ist einfach: Alles Eingehende ist verboten, nur ausdrücklich freigegebene Ports sind offen. Auf einem Server im Internet gehört das zur Grundausstattung.
Vorbemerkungen
- Schon installiert: Ubuntu 26.04 bringt UFW 0.36.2 mit, die Firewall ist aber ausgeschaltet. Schritt 2 stellt nur sicher, dass das Paket vorhanden ist.
- Erst SSH freigeben, dann einschalten: Wer einen Server über SSH verwaltet und die Firewall einschaltet, ohne SSH vorher zu erlauben, sperrt sich aus. Die Reihenfolge der Schritte 5 bis 8 ist deshalb wichtig. Regeln lassen sich anlegen, solange die Firewall noch aus ist.
- Ausgehend bleibt alles erlaubt: Der Rechner selbst kann weiter Updates laden und Webseiten aufrufen. Auch Verbindungen innerhalb des Rechners (
127.0.0.1) sind nicht betroffen. Dienste, die nach den Anleitungen dieses Buchs nur auf127.0.0.1lauschen, brauchen keine Freigabe. - Hinter einem Router: Ein Rechner im Heimnetz ist durch den Router schon vor Zugriffen aus dem Internet geschützt. UFW regelt dann zusätzlich, was andere Geräte im selben Netz erreichen dürfen.
- IPv4 und IPv6: UFW legt jede Regel für beide Protokolle an. In den Listen erscheint sie deshalb doppelt, einmal mit dem Zusatz
(v6). - Deutsche Ausgaben: Die Meldungen von
ufwsind übersetzt. Die Beispiele zeigen sie so, wie sie auf einem deutsch eingestellten System erscheinen. - Version: Getestet mit UFW 0.36.2 am 4. Oktober 2026 auf einem Rechner ohne SSH-Server. Die Regeln sind angelegt und geprüft, ein Zugriff von einem zweiten Rechner aus ist nicht getestet.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. UFW installieren
Ist das Paket schon vorhanden, meldet apt das und ändert nichts.
sudo apt install ufw
3. Version prüfen
ufw version
Prüfen: Die erste Zeile lautet ufw 0.36.2.
4. Zustand ansehen
sudo ufw status
Prüfen: Auf einem frischen System lautet die Ausgabe Status: Inaktiv.
Grundregeln festlegen
5. Eingehend alles verbieten
Das ist bereits die Voreinstellung. Der Befehl stellt sie sicher, falls sie einmal geändert wurde.
sudo ufw default deny incoming
6. Ausgehend alles erlauben
sudo ufw default allow outgoing
7. SSH freigeben
Nur nötig, wenn du den Rechner über SSH verwaltest. Dann aber unbedingt vor Schritt 8.
sudo ufw allow ssh
Prüfen: Die Ausgabe lautet Regeln aktualisiert und Regeln aktualisiert (v6). Der Name ssh steht für Port 22. Läuft dein SSH-Server auf einem anderen Port, gib ihn als Zahl an, z. B. sudo ufw allow 2222/tcp.
Welche Regeln schon vorgemerkt sind, zeigt dieser Befehl auch bei ausgeschalteter Firewall:
sudo ufw show added
8. Firewall einschalten
sudo ufw enable
Bei einer Verbindung über SSH fragt UFW nach, ob bestehende Verbindungen gestört werden dürfen. Bestätige mit y und Enter.
Prüfen: Die Ausgabe lautet Die Firewall ist beim System-Start aktiv und aktiviert. Sie bleibt also auch nach einem Neustart eingeschaltet.
Öffne bei einem Server jetzt ein zweites Terminal und melde dich darin neu per SSH an, bevor du das erste schließt. Klappt das nicht, kannst du im ersten Fenster noch sudo ufw disable eingeben.
9. Regeln ausführlich anzeigen
sudo ufw status verbose
Prüfen: Die Ausgabe nennt den Zustand, die Voreinstellungen und darunter die Regeln:
Status: Aktiv
Protokollierung: on (low)
Voreinstellung: deny (eingehend), allow (abgehend), disabled (gesendet)
Neue Profile: skip
Zu Aktion Von
-- ------ ---
22/tcp ALLOW IN Anywhere
22/tcp (v6) ALLOW IN Anywhere (v6)
Dienste freigeben
10. Einen Port freigeben
Ohne Angabe eines Protokolls gilt die Freigabe für TCP und UDP. Meist ist nur TCP gemeint, deshalb gehört /tcp dazu.
sudo ufw allow 8080/tcp
11. Einen Dienst über sein Profil freigeben
Viele Pakete bringen ein Profil mit, das ihre Ports unter einem Namen zusammenfasst. Die vorhandenen Profile zeigt:
sudo ufw app list
Mit nginx stehen dort unter anderem Nginx HTTP (Port 80), Nginx HTTPS (Port 443) und Nginx Full (beide). Was ein Profil öffnet, zeigt sudo ufw app info 'Nginx Full'. Die Freigabe:
sudo ufw allow 'Nginx Full'
Prüfen: In sudo ufw status steht die Zeile 80,443/tcp (Nginx Full) mit ALLOW IN.
12. Nur für ein bestimmtes Netz freigeben
Eine Datenbank soll nicht für die ganze Welt offen sein. Diese Regel erlaubt den Zugriff auf PostgreSQL (Port 5432) nur aus dem Heimnetz 192.168.178.0/24:
sudo ufw allow from 192.168.178.0/24 to any port 5432 proto tcp
Für einen einzelnen Rechner gibst du statt des Netzes dessen Adresse an, z. B. from 192.168.178.30.
13. Eine Adresse aussperren
sudo ufw deny from 192.0.2.1
Die Adresse 192.0.2.1 ist für Beispiele reserviert. UFW prüft die Regeln von oben nach unten, die erste passende gilt. Eine Sperre wirkt deshalb nur, wenn sie vor der Freigabe steht, die sie einschränken soll. Mit sudo ufw insert 1 deny from 192.0.2.1 setzt du sie an die erste Stelle. Wer Adressen nach Fehlversuchen selbsttätig sperren lassen will, nimmt Fail2ban.
14. Anmeldeversuche begrenzen
limit erlaubt einen Port, sperrt aber eine Adresse vorübergehend, wenn sie in 30 Sekunden sechs oder mehr Verbindungen aufbaut. Das bremst das Durchprobieren von Passwörtern.
sudo ufw limit ssh
Prüfen: Die Regel für Port 22 trägt in sudo ufw status jetzt LIMIT IN statt ALLOW IN. Sie ersetzt die Regel aus Schritt 7.
Regeln ändern und löschen
15. Regeln mit Nummern anzeigen
sudo ufw status numbered
Prüfen: Jede Regel trägt vorn eine Nummer:
Zu Aktion Von
-- ------ ---
[ 1] 22/tcp LIMIT IN Anywhere
[ 2] Nginx Full ALLOW IN Anywhere
[ 3] 8080/tcp ALLOW IN Anywhere
[ 4] 5432/tcp ALLOW IN 192.168.178.0/24
[ 5] Anywhere DENY IN 192.0.2.1
[ 6] 22/tcp (v6) LIMIT IN Anywhere (v6)
[ 7] Nginx Full (v6) ALLOW IN Anywhere (v6)
[ 8] 8080/tcp (v6) ALLOW IN Anywhere (v6)
16. Eine Regel löschen
Am sichersten löschst du eine Regel, indem du sie mit delete davor wiederholst. Das entfernt die Fassungen für IPv4 und IPv6 zugleich.
sudo ufw delete allow 8080/tcp
Die Sperre aus Schritt 13 entfernst du genauso:
sudo ufw delete deny from 192.0.2.1
Das Löschen über die Nummer, z. B. sudo ufw delete 3, entfernt nur diese eine Zeile. Die zugehörige Regel mit (v6) bleibt stehen und muss eigens gelöscht werden. Nach jedem Löschen rücken die Nummern nach, sieh sie dir also vor dem nächsten Löschen neu an.
17. Offene Ports mit den Regeln vergleichen
Dieser Befehl listet alle Ports, auf denen ein Programm von außen erreichbar lauscht, und nennt darunter die Regel, die den Port freigibt. Ports ohne Regel sind durch die Firewall geschützt.
sudo ufw show listening
Protokoll und Wartung
18. Abgewiesene Verbindungen ansehen
UFW schreibt abgewiesene Verbindungen ins Systemprotokoll, gekennzeichnet mit [UFW BLOCK].
sudo journalctl -k --grep 'UFW BLOCK'
Auf einem Server im Internet sammeln sich dort schnell viele Einträge von Programmen, die das Netz nach offenen Ports absuchen. Das ist normal. Wie viel protokolliert wird, regelt sudo ufw logging mit den Stufen off, low (Standard), medium und high.
19. Firewall vorübergehend ausschalten
Zur Fehlersuche, wenn unklar ist, ob die Firewall eine Verbindung verhindert. Die Regeln bleiben gespeichert.
sudo ufw disable
Wieder einschalten mit sudo ufw enable.
20. Alle Regeln verwerfen
reset schaltet die Firewall aus und löscht alle eigenen Regeln. Die bisherigen Dateien bleiben als Sicherung mit Datum im Namen in /etc/ufw liegen. Der Befehl fragt vorher nach.
sudo ufw reset
Wie geht es weiter?
- Vorher ansehen:
sudo ufw --dry-run allow 9999/tcpzeigt die Regeln, die ein Befehl erzeugen würde, ohne etwas zu ändern. - Server absichern: Wie die Firewall mit HTTPS und automatischen Updates zusammenspielt, zeigt nginx auf dem Produktionsserver.
- Angreifer selbsttätig sperren: Fail2ban wertet die Protokolle aus und sperrt Adressen nach wiederholten Fehlversuchen. Es arbeitet neben UFW und braucht keine Anpassung.
- Dokumentation:
man ufwsowie https://help.ubuntu.com/community/UFW
Deinstallieren
UFW gehört zur Grundausstattung von Ubuntu. Andere Pakete wie nginx und Postfix legen ihre Profile dort ab. Statt das Paket zu entfernen, schaltest du die Firewall aus und verwirfst die Regeln.
1. Firewall ausschalten und Regeln löschen
sudo ufw reset
Bestätige die Rückfrage mit y und Enter.
Prüfen: Die Firewall ist aus.
sudo ufw status
Die Ausgabe lautet Status: Inaktiv.
2. Sicherungen der alten Regeln löschen
reset hat die bisherigen Regeldateien mit Datum im Namen aufbewahrt. Dieser Befehl zeigt sie:
ls /etc/ufw/*.rules.*
Brauchst du sie nicht mehr, lösche sie:
sudo rm /etc/ufw/*.rules.*
3. Optional: Paket entfernen
Nur wenn du UFW wirklich nicht mehr auf dem System haben willst.
sudo apt purge ufw
Quellen und Lizenz
- Offizielle Dokumentation: https://help.ubuntu.com/community/UFW
- Lizenz: UFW steht unter der GPL-3.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.
Fail2ban
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Fail2ban schützt Dienste, die aus dem Internet erreichbar sind, vor dem massenhaften Durchprobieren von Passwörtern. Es liest die Protokolle mit, zählt fehlgeschlagene Anmeldungen je Absenderadresse und sperrt eine Adresse für eine Weile in der Firewall, sobald sie zu oft danebenlag. Am bekanntesten ist der Einsatz für SSH. Fertige Regeln gibt es aber auch für nginx, Mailserver und viele andere Programme.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Fail2ban 1.1.0. Mitinstalliert wird das empfohlene Paket
whois. - Sinnvoll auf Servern: Fail2ban hilft nur bei Diensten, die von außen erreichbar sind. Auf einem Rechner hinter einem Router ohne Portfreigabe gibt es nichts zu sperren.
- SSH ist sofort geschützt: Der Dienst startet direkt nach der Installation mit einer aktiven Regel für SSH. Sie liest das systemd-Journal und funktioniert ohne weitere Einrichtung. Ist kein SSH-Server installiert, läuft sie einfach leer mit.
- Sperren über nftables: Fail2ban legt für seine Sperren eine eigene Tabelle
f2b-tablein der Firewall des Kernels an. Es verträgt sich mitufw, brauchtufwaber nicht. - Begriff Jail: Eine Regel heißt bei Fail2ban Jail. Ein Jail verbindet einen Filter (woran erkenne ich einen Fehlversuch?), ein Protokoll (wo suche ich?) und eine Aktion (was sperre ich?).
- Kein Ersatz für gute Passwörter: Fail2ban bremst Angreifer, die von einer Adresse aus viele Versuche machen. Gegen verteilte Angriffe von tausenden Adressen hilft es wenig. Für SSH bleibt die Anmeldung mit Schlüssel statt Passwort der wichtigere Schutz.
- Version: Getestet mit Fail2ban 1.1.0 am 4. Oktober 2026. Auf dem Testrechner lief kein SSH-Server. Die Sperre für SSH ist deshalb von Hand ausgelöst, das selbstständige Sperren mit einem Jail für nginx und nachgestellten Protokollzeilen geprüft.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Fail2ban installieren
sudo apt install fail2ban
3. Version und Dienst prüfen
fail2ban-client --version
systemctl is-active fail2ban
Prüfen: Die Ausgaben lauten Fail2Ban v1.1.0 und active.
4. Aktive Jails anzeigen
fail2ban-client spricht mit dem laufenden Dienst und braucht dafür sudo.
sudo fail2ban-client status
Prüfen: Die Ausgabe nennt ein Jail:
Status
|- Number of jail: 1
`- Jail list: sshd
Eigene Einstellungen
Die Voreinstellungen stehen in /etc/fail2ban/jail.conf. Diese Datei wird bei Updates überschrieben und bleibt unverändert. Eigene Werte gehören in die Datei /etc/fail2ban/jail.local. Sie hat Vorrang und muss nur enthalten, was vom Standard abweicht.
5. Datei für eigene Einstellungen anlegen
sudo nano /etc/fail2ban/jail.local
6. Grundwerte eintragen
Füge diesen Inhalt ein (Strg+Umschalt+V):
[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
ignoreip = 127.0.0.1/8 ::1 192.168.178.0/24
[sshd]
enabled = true
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Was die Einträge bedeuten:
[DEFAULT]– Werte für alle Jails, sofern ein Jail nichts anderes festlegt.bantime– Dauer der Sperre. Ab Werk sind es zehn Minuten, hier eine Stunde.findtimeundmaxretry– wer innerhalb von zehn Minuten fünfmal scheitert, wird gesperrt.ignoreip– Adressen, die nie selbsttätig gesperrt werden. Trage hier dein Heimnetz oder die feste Adresse ein, von der aus du den Server verwaltest, damit du dich nicht selbst aussperrst.192.168.178.0/24ist das übliche Netz einer Fritzbox. Passe den Wert an oder lass ihn weg.[sshd]mitenabled = true– schaltet das Jail für SSH ein. Es ist schon aktiv, der Eintrag macht das nur sichtbar.
7. Konfiguration prüfen
sudo fail2ban-client -t
Prüfen: Die Ausgabe lautet OK: configuration test is successful.
8. Dienst neu starten
sudo systemctl restart fail2ban
Prüfen: Die Sperrdauer des Jails beträgt jetzt 3600 Sekunden.
sudo fail2ban-client get sshd bantime
Sperren ansehen und aufheben
9. Zustand eines Jails anzeigen
sudo fail2ban-client status sshd
Prüfen: Die Ausgabe zeigt oben die gezählten Fehlversuche, unten die Sperren:
Status for the jail: sshd
|- Filter
| |- Currently failed: 0
| |- Total failed: 0
| `- Journal matches: _SYSTEMD_UNIT=ssh.service + _COMM=sshd
`- Actions
|- Currently banned: 0
|- Total banned: 0
`- Banned IP list:
Auf einem Server mit offenem SSH-Port stehen hier meist schon nach wenigen Stunden die ersten Adressen.
10. Eine Adresse von Hand sperren
Zum Ausprobieren eignet sich 192.0.2.1. Diese Adresse ist für Beispiele reserviert und gehört niemandem.
sudo fail2ban-client set sshd banip 192.0.2.1
Prüfen: Die Ausgabe ist 1. sudo fail2ban-client status sshd nennt die Adresse unter Banned IP list.
Eine Sperre von Hand gilt auch für Adressen aus ignoreip. Die Ausnahme schützt nur vor dem selbsttätigen Sperren.
11. Die Sperre in der Firewall ansehen
sudo nft list table inet f2b-table
Prüfen: Die Tabelle enthält eine Liste mit der gesperrten Adresse und eine Regel, die Verbindungen dieser Adressen zum SSH-Port 22 abweist:
table inet f2b-table {
set addr-set-sshd {
type ipv4_addr
elements = { 192.0.2.1 }
}
chain f2b-chain {
type filter hook input priority filter - 1; policy accept;
tcp dport 22 ip saddr @addr-set-sshd reject with icmp port-unreachable
}
}
Gesperrt ist also nur der betroffene Dienst. Andere Ports erreicht die Adresse weiterhin.
12. Alle Sperren auf einen Blick
sudo fail2ban-client banned
Prüfen: Es erscheint je Jail eine Liste der gesperrten Adressen.
13. Eine Sperre aufheben
Das brauchst du, wenn du dich selbst oder einen Kollegen ausgesperrt hast.
sudo fail2ban-client set sshd unbanip 192.0.2.1
Prüfen: Die Ausgabe ist 1, die Adresse fehlt in sudo fail2ban-client status sshd.
Ist nicht bekannt, in welchem Jail die Adresse steckt, hebt dieser Befehl die Sperre überall auf:
sudo fail2ban-client unban 192.0.2.1
14. Das Protokoll von Fail2ban lesen
Jeder erkannte Fehlversuch (Found), jede Sperre (Ban) und jede Freigabe (Unban) steht in /var/log/fail2ban.log.
sudo grep -E 'Found|Ban' /var/log/fail2ban.log
Weitere Jails einschalten
Die Datei jail.conf enthält viele vorbereitete Jails, die ausgeschaltet sind. Du schaltest ein Jail ein, indem du seinen Namen mit enabled = true in jail.local aufnimmst. Schalte nur Jails für Programme ein, die installiert sind: Findet ein Jail sein Protokoll nicht, startet Fail2ban nicht.
15. Jails für nginx und Wiederholungstäter ergänzen
sudo nano /etc/fail2ban/jail.local
Hänge diese Zeilen ans Ende an:
[nginx-http-auth]
enabled = true
[nginx-botsearch]
enabled = true
[recidive]
enabled = true
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
nginx-http-auth– sperrt nach falschen Passwörtern an Seiten, die nginx mit Benutzername und Passwort schützt.nginx-botsearch– sperrt Programme, die reihenweise nach nicht vorhandenen Adressen wie/phpmyadminoder/wp-login.phpsuchen.recidive– liest das Protokoll von Fail2ban selbst. Wer innerhalb eines Tages mehrfach gesperrt wurde, wird für eine Woche auf allen Ports gesperrt.
16. Prüfen und neu laden
sudo fail2ban-client -t
sudo systemctl restart fail2ban
Prüfen: Die Liste nennt jetzt vier Jails.
sudo fail2ban-client status
`- Jail list: nginx-botsearch, nginx-http-auth, recidive, sshd
17. Einen Filter an einem Protokoll ausprobieren
fail2ban-regex wendet einen Filter auf eine Datei an, ohne etwas zu sperren. So siehst du, ob ein Filter die Zeilen deines Protokolls überhaupt erkennt.
sudo fail2ban-regex /var/log/nginx/error.log nginx-http-auth
Prüfen: Die Zeile Lines: am Ende nennt, wie viele Zeilen gelesen und wie viele als Fehlversuch erkannt wurden (matched). Auf einem Server ohne geschützte Seiten ist die Zahl 0.
Wie geht es weiter?
- Wachsende Sperrdauer: Mit
bantime.increment = trueunter[DEFAULT]verlängert sich die Sperre bei jeder Wiederholung derselben Adresse. - Alle vorbereiteten Jails: Die Namen stehen in eckigen Klammern in
/etc/fail2ban/jail.conf, die zugehörigen Filter liegen in/etc/fail2ban/filter.d. Es gibt unter anderem Jails für Postfix, Dovecot und Apache. - Benachrichtigung per E-Mail: Mit
action = %(action_mw)sunter[DEFAULT]und einer Adresse indestemailschickt Fail2ban bei jeder Sperre eine Nachricht. Dafür muss ein Mailprogramm wie Postfix eingerichtet sein. Nicht selbst getestet. - Tägliche Zusammenfassung: Logwatch hat einen eigenen Abschnitt für Fail2ban und listet die Sperren des Vortags.
- Dokumentation:
man fail2ban-clientundman jail.confsowie https://github.com/fail2ban/fail2ban/wiki
Deinstallieren
1. Fail2ban entfernen
purge beendet den Dienst, hebt alle Sperren auf und entfernt die Tabelle f2b-table aus der Firewall. apt meldet dabei, dass /etc/fail2ban nicht leer ist, weil dort noch die eigene Datei liegt.
sudo apt purge fail2ban whois
2. Eigene Einstellungen löschen
Die Datei jail.local gehört zu keinem Paket und bleibt deshalb liegen.
sudo rm -rf /etc/fail2ban
Prüfen: Der Befehl wird nicht mehr gefunden.
fail2ban-client --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.fail2ban.org/
- Lizenz: Fail2ban steht unter der GPL-2.0-or-later.
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.
unattended-upgrades
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
unattended-upgrades spielt Sicherheitsupdates von selbst ein, ohne dass jemand apt upgrade eintippen muss. Einmal am Tag holt es die Paketlisten, installiert alle Aktualisierungen aus den Sicherheitsquellen von Ubuntu und schreibt auf, was es getan hat. Auf einem Server, an dem man sich nicht täglich anmeldet, ist das der wichtigste einzelne Schutz: Bekannte Lücken bleiben so nur Stunden statt Wochen offen.
Vorbemerkungen
- Schon installiert und aktiv: Ubuntu 26.04 bringt unattended-upgrades 2.12 mit und schaltet es bei der Installation ein. Diese Anleitung zeigt, wie du das prüfst, was genau geschieht und wie du es anpasst.
- Nur Sicherheitsupdates: Ab Werk installiert es Pakete aus der Quelle
-security. Gewöhnliche Fehlerkorrekturen aus-updatesund Pakete aus fremden Quellen (z. B. PostgreSQL oder Google Chrome von den Herstellern) bleiben liegen, bis du selbstsudo apt upgradeausführst. Auf dem Testrechner warteten deshalb 37 Aktualisierungen, obwohl der Dienst lief. - Kein selbsttätiger Neustart: Ein neuer Kernel wird installiert, aber erst nach einem Neustart benutzt. Den Neustart löst unattended-upgrades ab Werk nicht aus. Schritt 11 zeigt, wie du das änderst.
- Eigene Einstellungen in eigener Datei: Die mitgelieferte Datei
50unattended-upgradeswird bei Paketupdates ersetzt. Eigene Werte kommen deshalb in eine zweite Datei mit höherer Nummer, die später gelesen wird und Vorrang hat. - Version: Getestet mit unattended-upgrades 2.12 am 4. Oktober 2026. Geprüft sind die Einstellungen und Probeläufe. Ein selbsttätiger Neustart und der Mailversand sind nicht ausgelöst worden.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. unattended-upgrades installieren
Ist das Paket schon vorhanden, meldet apt das und ändert nichts.
sudo apt install unattended-upgrades
3. Prüfen, ob es eingeschaltet ist
cat /etc/apt/apt.conf.d/20auto-upgrades
Prüfen: Die Datei enthält zwei Zeilen mit dem Wert "1":
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";
Die erste Zeile holt täglich die Paketlisten, die zweite installiert täglich die Updates. Die Zahl ist der Abstand in Tagen, "0" schaltet ab.
4. Bei Bedarf einschalten
Nur nötig, wenn die Datei fehlt oder dort "0" steht.
sudo dpkg-reconfigure -plow unattended-upgrades
Beantworte die Frage, ob stabile Updates automatisch heruntergeladen und installiert werden sollen, mit Ja.
Verstehen, was geschieht
5. Zeitpunkte ansehen
Zwei Timer von systemd steuern den Ablauf. apt-daily.timer holt die Paketlisten, apt-daily-upgrade.timer installiert.
systemctl list-timers 'apt-daily*'
Prüfen: Es erscheinen zwei Zeilen. Die Spalte NEXT nennt den nächsten Lauf, LAST den letzten. Die Installation beginnt morgens ab 6 Uhr mit einer zufälligen Verzögerung von bis zu einer Stunde. War der Rechner zu dieser Zeit aus, wird der Lauf nach dem Einschalten nachgeholt.
6. Erlaubte Quellen ansehen
apt-config dump | grep '^Unattended-Upgrade'
Prüfen: Unter Allowed-Origins stehen vier Einträge. Entscheidend ist ${distro_id}:${distro_codename}-security, die Sicherheitsquelle von Ubuntu. Der Eintrag ohne Zusatz ist die Grundausstattung der Version. Er ist nötig, weil ein Sicherheitsupdate gelegentlich ein weiteres Paket von dort braucht. Die beiden Einträge mit ESM gelten nur mit einem Abonnement von Ubuntu Pro.
apt-config dump zeigt immer die tatsächlich wirksamen Werte aus allen Dateien zusammen. Damit prüfst du später auch deine eigenen Einstellungen.
7. Probelauf starten
--dry-run rechnet alles durch, installiert aber nichts. -v zeigt, was geschehen würde.
sudo unattended-upgrade --dry-run -v
Prüfen: Die Ausgabe nennt zuerst die erlaubten Quellen. Gibt es nichts zu tun, folgt die Meldung, dass keine Pakete für eine automatische Aktualisierung gefunden wurden. Andernfalls erscheint eine Zeile Pakete, welche aktualisiert werden: mit den Namen.
Der Befehl heißt unattended-upgrade ohne s am Ende, das Paket und die Dateien dagegen unattended-upgrades.
8. Protokoll lesen
sudo less /var/log/unattended-upgrades/unattended-upgrades.log
Prüfen: Je Lauf steht dort ein Block mit Datum, der Liste der aktualisierten Pakete und am Ende Alle Systemaktualisierungen installiert. Auch Fehler stehen hier, etwa wenn ein Download fehlschlug. Mit Umschalt+G springst du ans Ende, q beendet less.
Was dpkg bei der Installation im Einzelnen ausgegeben hat, steht daneben in unattended-upgrades-dpkg.log.
9. Prüfen, ob ein Neustart aussteht
Verlangt ein Update einen Neustart, legt das System eine Markierungsdatei an.
cat /var/run/reboot-required
Prüfen: Meldet cat, dass die Datei nicht existiert, ist kein Neustart nötig. Andernfalls steht dort *** System restart required ***. Welche Pakete ihn verlangen, zeigt cat /var/run/reboot-required.pkgs.
Anpassen
10. Datei für eigene Einstellungen anlegen
sudo nano /etc/apt/apt.conf.d/52unattended-upgrades-local
Die Schritte 11 bis 14 zeigen, was du dort eintragen kannst. Nimm nur die Blöcke, die du brauchst. Jede Zeile endet mit einem Semikolon. Speichere am Ende mit Strg+O und Enter und beende nano mit Strg+X.
11. Selbsttätig neu starten
Mit diesen Zeilen startet der Rechner um 4 Uhr nachts neu, wenn ein Update das verlangt. Für einen Server, der nachts kaum genutzt wird, ist das sinnvoll. Auf einem Arbeitsplatzrechner eher nicht.
Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-Time "04:00";
12. Auch gewöhnliche Updates einspielen
Dieser Block nimmt die Quelle -updates dazu. Listen wie Allowed-Origins werden ergänzt, nicht ersetzt. Die vier Einträge aus Schritt 6 bleiben also bestehen.
Unattended-Upgrade::Allowed-Origins {
"${distro_id}:${distro_codename}-updates";
};
Damit bleibt das System ohne dein Zutun vollständig aktuell. Der Preis: Auch Updates, die keine Sicherheitslücke schließen, kommen ungeprüft auf den Rechner.
13. Einzelne Pakete ausnehmen
Pakete, die du lieber von Hand aktualisierst, etwa eine Datenbank. Der Eintrag ist ein Muster für den Anfang des Namens: postgresql- trifft postgresql-18 und alle ähnlich benannten Pakete.
Unattended-Upgrade::Package-Blacklist {
"postgresql-";
};
14. Bericht per E-Mail und Aufräumen
Die ersten beiden Zeilen schicken eine E-Mail, sobald etwas installiert wurde oder ein Fehler auftrat. Dafür muss ein Mailprogramm wie Postfix eingerichtet sein. Die dritte Zeile entfernt nach jedem Lauf Pakete, die niemand mehr braucht, so wie apt autoremove.
Unattended-Upgrade::Mail "thorsten";
Unattended-Upgrade::MailReport "on-change";
Unattended-Upgrade::Remove-Unused-Dependencies "true";
Ersetze thorsten durch deinen Benutzernamen oder eine E-Mail-Adresse.
15. Einstellungen prüfen
apt-config dump | grep '^Unattended-Upgrade'
Prüfen: Deine Werte stehen in der Liste, zusätzlich zu den vier Quellen aus Schritt 6. Meldet der Befehl stattdessen einen Syntaxfehler mit Dateiname und Zeile, fehlt dort meist ein Semikolon oder eine Klammer.
Wiederhole danach den Probelauf aus Schritt 7. Mit dem Block aus Schritt 12 listet er nun auch die gewöhnlichen Updates auf. Ein Neustart des Dienstes ist nicht nötig, die Einstellungen werden bei jedem Lauf neu gelesen.
16. Sofort ausführen
Statt bis zum nächsten Morgen zu warten, kannst du den Lauf von Hand starten. Ohne --dry-run werden die Updates wirklich installiert.
sudo unattended-upgrade -v
Wie geht es weiter?
- Alle Optionen: Die Datei
/etc/apt/apt.conf.d/50unattended-upgradesenthält jede Einstellung als auskommentierte Zeile mit Erklärung. Lies dort nach und übernimm, was du brauchst, in deine eigene Datei. - Was sich geändert hat: Logwatch listet in seinem täglichen Bericht alle installierten und aktualisierten Pakete.
- Fremde Quellen: Pakete aus Quellen der Hersteller lassen sich ebenfalls aufnehmen. Die nötigen Angaben
o=(Herkunft) unda=(Archiv) zeigtapt-cache policy. Nicht selbst getestet. - Rundum abgesichert: Zusammen mit UFW und Fail2ban ergibt sich die übliche Grundsicherung eines Servers, wie sie nginx auf dem Produktionsserver im Zusammenhang zeigt.
- Dokumentation:
man unattended-upgradesowie https://help.ubuntu.com/community/AutomaticSecurityUpdates
Deinstallieren
unattended-upgrades gehört zur Grundausstattung von Ubuntu. Statt das Paket zu entfernen, nimmst du die eigenen Einstellungen zurück oder schaltest es ab.
1. Eigene Einstellungen löschen
Danach gelten wieder die Werte ab Werk.
sudo rm /etc/apt/apt.conf.d/52unattended-upgrades-local
2. Optional: Automatische Updates abschalten
sudo dpkg-reconfigure -plow unattended-upgrades
Beantworte die Frage mit Nein.
Prüfen: In der Datei steht jetzt bei Unattended-Upgrade der Wert "0".
cat /etc/apt/apt.conf.d/20auto-upgrades
Ab jetzt musst du Sicherheitsupdates wieder selbst mit sudo apt update und sudo apt upgrade einspielen.
3. Optional: Paket entfernen
Nur wenn du es wirklich nicht mehr auf dem System haben willst.
sudo apt purge unattended-upgrades
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/mvo5/unattended-upgrades
- Lizenz: unattended-upgrades steht unter der GPL-2.0-or-later.
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.
Lynis
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Lynis prüft, wie gut ein Linux-System abgesichert ist. Es geht in wenigen Minuten rund 270 Punkte durch: Startvorgang, Benutzerkonten, Dateirechte, Firewall, Webserver, Datenbanken, Kernel-Einstellungen und vieles mehr. Am Ende stehen eine Liste mit Warnungen und Vorschlägen und eine Kennzahl, mit der sich der Fortschritt verfolgen lässt. Lynis ändert dabei nichts am System. Es zeigt nur, wo du selbst nachbessern kannst.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Lynis 3.1.6. Das empfohlene Zusatzpaket
menuist ein altes Menüsystem, das niemand braucht. Schritt 2 lässt es mit--no-install-recommendsweg. - Täglicher Lauf ab Werk: Das Paket schaltet einen Timer ein, der Lynis jede Nacht kurz nach Mitternacht unbemerkt laufen lässt und das Ergebnis in
/var/logablegt. Wer nur gelegentlich von Hand prüfen will, schaltet ihn in Schritt 4 ab. - Mit
sudo: Ohnesudoläuft Lynis in einer eingeschränkten Betriebsart, überspringt viele Prüfungen und legt seine Dateien im Home-Ordner ab. - Vorschläge, keine Vorschriften: Viele Hinweise zielen auf Server mit hohen Anforderungen. Auf einem Arbeitsplatzrechner sind manche übertrieben, etwa ein Passwort für den Bootloader. Lies jeden Vorschlag und entscheide selbst.
- Hinweis auf veraltete Version: Lynis meldet am Anfang und am Ende, es sei älter als sechs Monate. Das bezieht sich auf die Fassung im Ubuntu-Paket und ist kein Fehler.
- Sprache: Überschriften und Statusangaben sind deutsch, Warnungen und Vorschläge englisch.
- Version: Getestet mit Lynis 3.1.6 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Lynis installieren
sudo apt install --no-install-recommends lynis
3. Version prüfen
lynis show version
Prüfen: Die Ausgabe lautet 3.1.6.
4. Optional: Täglichen Lauf abschalten
sudo systemctl disable --now lynis.timer
Prüfen: Der Timer ist nicht mehr aktiv.
systemctl is-active lynis.timer
Die Ausgabe lautet inactive.
System prüfen
5. Prüflauf starten
--quick sorgt dafür, dass der Lauf ohne Pausen zwischen den Abschnitten durchläuft.
sudo lynis audit system --quick
Der Lauf dauerte auf dem Testrechner zwei Minuten. Die Ausgabe ist rund 900 Zeilen lang, scrolle im Terminal zurück oder leite sie in ein Blätterprogramm:
sudo lynis audit system --quick | less -R
Prüfen: Zuerst erscheint ein Kopf mit Version, Betriebssystem und Rechnername. Danach folgen die Abschnitte, jeder mit [+] eingeleitet, z. B. [+] Systemstart und Dienste, [+] Benutzer, Gruppen und Authentifizierung oder [+] Software: Webserver.
6. Die Prüfzeilen lesen
Jede Zeile nennt einen Prüfpunkt und rechts in eckigen Klammern das Ergebnis. Die Farbe zeigt die Bewertung:
| Farbe | Bedeutung |
|---|---|
| Grün | in Ordnung oder vorhanden |
| Gelb | Vorschlag, hier lässt sich etwas verbessern |
| Rot | Warnung, das solltest du dir ansehen |
| Weiß | reine Information, etwa NICHT GEFUNDEN für ein nicht installiertes Programm |
7. Das Ergebnis lesen
Am Ende steht der Abschnitt Lynis 3.1.6 Results mit zwei Listen. Warnings sind die dringenden Punkte, Suggestions die Vorschläge. Im Test waren es 5 Warnungen und 46 Vorschläge. Ein Eintrag sieht so aus:
* Install fail2ban to automatically ban hosts that commit multiple authentication errors. [DEB-0880]
- Related resources
* Website: https://cisofy.com/lynis/controls/DEB-0880/
Das Kürzel in eckigen Klammern ist die Kennung des Prüfpunkts. Unter der genannten Adresse erklärt das Projekt, was geprüft wird und wie man es behebt.
Ganz unten folgt die Zusammenfassung:
Hardening index : 62 [############ ]
Tests performed : 269
Der Hardening index ist eine Kennzahl von 0 bis 100. Sie ist kein Zeugnis. Nützlich ist sie zum Vergleich, wenn du nach Änderungen erneut prüfst. Der Testrechner, ein Arbeitsplatzrechner mit vielen installierten Diensten, kam auf 62.
8. Einzelheiten zu einem Prüfpunkt ansehen
Dieser Befehl zeigt, was Lynis beim letzten Lauf zu einem Prüfpunkt festgestellt hat, hier zum Begrüßungstext des Mailservers:
sudo lynis show details MAIL-8818
Prüfen: Es erscheinen einige Zeilen mit Uhrzeit: was geprüft wurde, das Ergebnis und der Vorschlag. Bleibt die Ausgabe leer, kam der Prüfpunkt im letzten Lauf nicht vor.
Ergebnisse weiterverwenden
Jeder Lauf schreibt zwei Dateien und überschreibt dabei die des vorigen Laufs.
9. Warnungen und Vorschläge aus dem Bericht holen
/var/log/lynis-report.dat enthält das Ergebnis in einer Form, die sich leicht auswerten lässt, je Zeile ein Wert.
sudo grep -E '^(warning|suggestion)\[\]=' /var/log/lynis-report.dat
Prüfen: Jede Zeile beginnt mit warning[]= oder suggestion[]=, gefolgt von Kennung und Text, getrennt durch senkrechte Striche.
Die Kennzahl allein liefert:
sudo grep '^hardening_index=' /var/log/lynis-report.dat
10. Das ausführliche Protokoll durchsuchen
/var/log/lynis.log hält jeden einzelnen Schritt fest. Hier findest du, warum Lynis zu einem Ergebnis kam.
sudo grep 'Warning:' /var/log/lynis.log
11. Kennzahl über die Zeit festhalten
Weil der Bericht bei jedem Lauf überschrieben wird, hängst du das Ergebnis mit Datum an eine eigene Datei an:
echo "$(date +%F) $(sudo grep '^hardening_index=' /var/log/lynis-report.dat)" >> ~/lynis-verlauf.txt
Prüfen: Die Datei enthält eine Zeile wie 2026-10-04 hardening_index=62.
cat ~/lynis-verlauf.txt
Gezielt prüfen und anpassen
12. Nur einzelne Prüfpunkte ausführen
Nach einer Änderung musst du nicht den ganzen Lauf wiederholen. --tests nimmt eine oder mehrere Kennungen in Anführungszeichen.
sudo lynis audit system --quick --tests "MAIL-8818 DEB-0880"
Prüfen: Die Zusammenfassung nennt bei Tests performed die Zahl der ausgeführten Prüfpunkte. Die Kennzahl ist bei einem solchen Teillauf ohne Aussage, und der Bericht aus Schritt 9 enthält danach nur noch diesen Teillauf.
Ganze Themen wählst du mit --tests-from-group, z. B. --tests-from-group "firewalls ssh". Die Namen aller Gruppen zeigt lynis show groups.
13. Prüfpunkte dauerhaft überspringen
Vorschläge, die du bewusst nicht umsetzt, sollen nicht bei jedem Lauf wieder erscheinen. Eigene Einstellungen kommen in die Datei custom.prf. Sie ergänzt die mitgelieferte default.prf, die bei Updates überschrieben wird.
sudo nano /etc/lynis/custom.prf
Je Zeile ein Prüfpunkt, hier das Passwort für den Bootloader und ein Vorschlag für ein Zusatzpaket:
skip-test=BOOT-5122
skip-test=DEB-0810
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
Prüfen: Lynis kennt jetzt zwei Profile.
sudo lynis show profiles
Die Ausgabe nennt /etc/lynis/default.prf und /etc/lynis/custom.prf. Beim nächsten Lauf fehlen die beiden Prüfpunkte in der Liste der Vorschläge.
14. Typische Vorschläge einordnen
Einige Hinweise tauchen auf fast jedem Ubuntu auf:
| Kennung | Vorschlag | Einordnung |
|---|---|---|
DEB-0880 | Fail2ban installieren | sinnvoll auf Servern, siehe Fail2ban |
BOOT-5122 | Passwort für den Bootloader GRUB | nur nötig, wenn Fremde an den Rechner kommen |
PKGS-7392 | angreifbare Pakete gefunden | Updates einspielen: sudo apt update und sudo apt upgrade |
MAIL-8818 | Mailserver nennt Programm und System im Begrüßungstext | geringe Bedeutung bei einem Mailserver, der nur lokal zustellt |
DEB-0810, DEB-0811 | Zusatzpakete, die vor Updates Hinweise anzeigen | Geschmackssache |
Wie geht es weiter?
- Lücken schließen: Die drei wirksamsten Maßnahmen beschreiben unattended-upgrades, UFW und Fail2ban. Prüfe danach erneut und vergleiche die Kennzahl.
- Alle Einstellungen:
/etc/lynis/default.prfenthält jede Option mit Erklärung.sudo lynis show settingszeigt die wirksamen Werte. - Neuere Fassung: Das Projekt bietet unter https://packages.cisofy.com eine eigene Paketquelle mit der jeweils aktuellen Version an. Nicht selbst getestet.
- Dokumentation:
man lynissowie https://cisofy.com/documentation/lynis/
Deinstallieren
1. Lynis entfernen
purge schaltet auch den Timer ab und löscht /etc/lynis samt eigener custom.prf sowie Bericht und Protokoll in /var/log.
sudo apt purge lynis
2. Eigene Dateien löschen
Nur nötig, wenn du Schritt 11 ausgeführt hast.
rm -f ~/lynis-verlauf.txt
Prüfen: Der Befehl wird nicht mehr gefunden.
lynis show version
Quellen und Lizenz
- Offizielle Dokumentation: https://cisofy.com/lynis/
- Lizenz: Lynis steht unter der GPL-3.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.
ClamAV
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ClamAV ist ein freier Virenscanner. Er durchsucht Dateien und Ordner nach bekannter Schadsoftware und holt sich die nötigen Erkennungsmuster mehrmals täglich selbst aus dem Internet. Unter Linux dient er vor allem dazu, Dateien zu prüfen, die an andere weitergegeben werden: hochgeladene Dateien einer Website, E-Mail-Anhänge, Freigaben für Windows-Rechner oder ein USB-Stick unbekannter Herkunft.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert ClamAV 1.5.4. Das Paket
clamavbringt den Scannerclamscanund den Dienstclamav-freshclamfür die Erkennungsmuster mit. Zusammen sind es vier Pakete. - Download beim ersten Start: Direkt nach der Installation lädt der Dienst die Erkennungsmuster, rund 110 MB. Vorher kann
clamscannicht arbeiten. - Prüfen auf Anforderung:
clamscanläuft nur, wenn du es startest. Einen Wächter, der jede geöffnete Datei sofort prüft wie unter Windows üblich, richtet diese Anleitung nicht ein. - Langsamer Start, optionaler Dienst:
clamscanlädt bei jedem Aufruf alle Muster neu. Das dauerte auf dem Testrechner neun Sekunden, auch für eine einzige Datei. Wer oft prüft, installiert zusätzlich den Dienstclamav-daemon, der die Muster im Arbeitsspeicher hält (ab Schritt 14). Er belegt dafür dauerhaft rund 1 GB. - Grenzen: ClamAV erkennt, was in seinen Mustern steht. Es ersetzt weder Updates noch eine Firewall, siehe unattended-upgrades und UFW.
- Englische Ausgaben: Die Meldungen der Programme sind englisch.
- Version: Getestet mit ClamAV 1.5.4 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. ClamAV installieren
sudo apt install clamav
3. Version prüfen
clamscan --version
Prüfen: Die Ausgabe beginnt mit ClamAV 1.5.4.
4. Dienst für die Erkennungsmuster einschalten
Der Dienst startet bei der Installation von selbst. Im Test war er aber nicht für den Systemstart vorgemerkt. Dieser Befehl stellt beides sicher:
sudo systemctl enable --now clamav-freshclam
Prüfen: Die Ausgaben lauten enabled und active.
systemctl is-enabled clamav-freshclam
systemctl is-active clamav-freshclam
5. Warten, bis die Muster geladen sind
ls -lh /var/lib/clamav
Prüfen: Der Ordner enthält die drei Dateien main.cvd (rund 85 MB), daily.cvd (rund 22 MB) und bytecode.cvd. Fehlt eine, warte eine Minute und wiederhole den Befehl. Den Fortschritt zeigt das Protokoll:
sudo tail /var/log/clamav/freshclam.log
Zu jeder Datei steht dort eine Zeile mit updated und der Zahl der Muster. Die Zeile ERROR: NotifyClamd: Can't find or parse configuration file am Ende ist ohne Bedeutung: Der Dienst versucht, den Scandienst aus Schritt 14 zu benachrichtigen, der noch nicht installiert ist.
Erkennung ausprobieren
Zum Testen gibt es die EICAR-Testdatei. Sie enthält eine festgelegte, harmlose Zeichenfolge, die jeder Virenscanner absichtlich als Fund meldet.
6. Testordner mit Testdatei anlegen
mkdir ~/clamtest
Der zweite Befehl schreibt die Zeichenfolge in eine Datei. Kopiere ihn vollständig, die Zeichen müssen genau stimmen.
printf '%s' 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > ~/clamtest/eicar.txt
7. Eine Datei prüfen
clamscan ~/clamtest/eicar.txt
Prüfen: Nach einigen Sekunden meldet ClamAV den Fund, darunter folgt eine Zusammenfassung:
/home/thorsten/clamtest/eicar.txt: Eicar-Test-Signature FOUND
----------- SCAN SUMMARY -----------
Known viruses: 3628118
Engine version: 1.5.4
Scanned directories: 0
Scanned files: 1
Infected files: 1
Eine unauffällige Datei endet mit OK statt FOUND, und Infected files ist 0.
Ordner prüfen
8. Einen Ordner mit allen Unterordnern prüfen
-r nimmt die Unterordner mit. -i zeigt nur Funde. Ohne -i erscheint für jede Datei eine Zeile.
clamscan -r -i ~/clamtest
Prüfen: Es erscheint nur die Zeile mit FOUND und die Zusammenfassung. ClamAV schaut auch in gepackte Dateien wie ZIP-Archive hinein.
9. Den Home-Ordner prüfen
Der Ordner .cache enthält viele kleine Dateien ohne bleibenden Wert und wird ausgelassen. Das Muster trifft jeden Ordner, dessen Pfad auf /.cache endet.
clamscan -r -i --exclude-dir='/\.cache$' ~
Das dauert je nach Datenmenge von Minuten bis zu Stunden. Strg+C bricht ab.
10. Ergebnis in eine Datei schreiben
--log hält Funde und Zusammenfassung zusätzlich in einer Datei fest.
clamscan -r -i --log="$HOME/clamscan.log" ~/clamtest
11. Rückgabewert für Skripte nutzen
clamscan meldet über seinen Rückgabewert, wie die Prüfung ausging: 0 heißt kein Fund, 1 heißt mindestens ein Fund, 2 heißt, es ist ein Fehler aufgetreten.
clamscan -r -i ~/clamtest; echo "Rückgabewert: $?"
Prüfen: Die letzte Zeile lautet Rückgabewert: 1.
Mit Funden umgehen
ClamAV löscht von sich aus nichts. Ein Fund kann auch ein Fehlalarm sein. Verschiebe verdächtige Dateien deshalb zuerst und lösche sie erst, wenn du sicher bist.
12. Funde in einen Quarantäne-Ordner verschieben
mkdir ~/quarantaene
clamscan -r -i --move="$HOME/quarantaene" ~/clamtest
Prüfen: Unter dem Fund steht eine Zeile mit moved to. Die Testdatei liegt jetzt im neuen Ordner.
ls ~/quarantaene
Die Option --remove löscht Funde stattdessen sofort. Verwende sie nur, wenn ein Fehlalarm keinen Schaden anrichten kann.
13. Muster von Hand aktualisieren
Der Dienst aus Schritt 4 sieht 24-mal am Tag nach neuen Mustern. Von Hand ist das selten nötig. Weil der laufende Dienst das Protokoll gesperrt hält, muss er dafür kurz angehalten werden.
sudo systemctl stop clamav-freshclam
sudo freshclam
sudo systemctl start clamav-freshclam
Prüfen: freshclam meldet je Datei updated oder is up-to-date.
Optional: Scandienst für schnelle Prüfungen
14. Scandienst installieren
sudo apt install clamav-daemon
Das Paket bringt den Dienst clamd und das Programm clamdscan mit. Der Dienst lauscht nur auf einer lokalen Socket-Datei, nicht im Netzwerk.
15. Warten, bis der Dienst bereit ist
Das Laden der Muster dauert rund eine halbe Minute.
systemctl is-active clamav-daemon
Prüfen: Die Ausgabe lautet active.
16. Über den Dienst prüfen
clamdscan reicht die Dateien an den laufenden Dienst weiter. --fdpass ist dabei nötig: Der Dienst läuft als Benutzer clamav und darf deine Dateien nicht selbst lesen. Mit der Option öffnet clamdscan sie unter deinem Namen und übergibt sie. Ohne sie meldet der Dienst Permission denied.
clamdscan --fdpass -i ~/quarantaene
Prüfen: Der Fund erscheint sofort. Im Test dauerte die Prüfung weniger als eine Hundertstelsekunde statt neun Sekunden.
Für große Ordner verteilt --multiscan die Arbeit auf mehrere Prozessorkerne:
clamdscan --fdpass -i --multiscan ~
Die Prüfung selbst findet im Dienst statt. Die meisten Scan-Optionen von clamscan wirken bei clamdscan deshalb nicht. Ausnahmen (ExcludePath) und Grenzen wie die größte geprüfte Datei (25 MB ab Werk) stehen in /etc/clamav/clamd.conf.
Regelmäßig prüfen
17. Wöchentliche Prüfung einrichten
Skripte im Ordner /etc/cron.weekly führt Ubuntu einmal in der Woche als root aus. Der Dateiname darf keinen Punkt enthalten.
sudo nano /etc/cron.weekly/clamscan-home
Füge diesen Inhalt ein:
#!/bin/sh
clamscan -r -i --exclude-dir='/\.cache$' --log=/var/log/clamav/wochenscan.log /home
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
18. Skript ausführbar machen
Ohne dieses Recht überspringt Ubuntu die Datei.
sudo chmod +x /etc/cron.weekly/clamscan-home
Prüfen: Nach dem ersten Lauf stehen Funde und Zusammenfassung im Protokoll. Jeder Lauf hängt einen neuen Abschnitt an.
sudo less /var/log/clamav/wochenscan.log
Wie geht es weiter?
- Grafische Oberfläche: Das Paket
clamtkbietet ein Fenster zum Auswählen von Ordnern und zum Ansehen der Funde. Nicht selbst getestet. - Hochgeladene Dateien prüfen: Viele Webanwendungen können Uploads an den Scandienst übergeben, WordPress und Nextcloud etwa über Erweiterungen.
- Bericht per E-Mail: Logwatch hat eigene Abschnitte für ClamAV und nimmt Funde in den täglichen Bericht auf.
- Dokumentation: https://docs.clamav.net sowie
man clamscanundman clamdscan
Deinstallieren
1. ClamAV entfernen
Die Liste nennt alle Pakete aus den Schritten 2 und 14. Nicht installierte überspringt apt mit einem Hinweis.
sudo apt purge clamav clamav-base clamav-freshclam libclamav12 clamav-daemon clamdscan
apt meldet dabei, dass /etc/clamav und /var/lib/clamav nicht leer sind. Den Benutzer clamav entfernt purge selbst.
2. Übrige Ordner und eigene Dateien löschen
sudo rm -rf /etc/clamav /var/lib/clamav /var/log/clamav /etc/cron.weekly/clamscan-home
rm -rf ~/clamtest ~/quarantaene ~/clamscan.log
Prüfen: Der Befehl wird nicht mehr gefunden.
clamscan --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.clamav.net/
- Lizenz: ClamAV steht unter der 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.
rkhunter
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
rkhunter (Rootkit Hunter) sucht nach Rootkits. Das sind Schadprogramme, die sich nach einem Einbruch tief im System einnisten und ihre Spuren verwischen, etwa indem sie Befehle wie ls oder ps gegen gefälschte Fassungen tauschen. rkhunter sucht nach den Dateien bekannter Rootkits, merkt sich den Zustand wichtiger Systembefehle und meldet, wenn sich daran etwas ändert. Dazu kommen Prüfungen auf versteckte Dateien, auffällige Einträge in /dev und verdächtige Benutzerkonten.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert rkhunter 1.4.6. Als Abhängigkeit kommt
net-toolsmit. Die empfohlenen Pakete würden 16 weitere Pakete nachziehen, darunter Ruby. Schritt 2 lässt sie mit--no-install-recommendsweg. - Fehlalarme sind normal: rkhunter meldet alles, was ungewöhnlich aussieht. Auf dem Testrechner endeten beim ersten Lauf drei Prüfzeilen mit einer Warnung, alle harmlos. Eine Warnung heißt deshalb: nachsehen, nicht: der Rechner ist befallen. Ab Schritt 8 trägst du geprüfte Stellen als Ausnahmen ein.
- Nach Updates neu einlesen: rkhunter vergleicht die Systembefehle mit einem gespeicherten Stand. Tauscht ein Update einen Befehl aus, sieht das für rkhunter wie eine Manipulation aus. Nach Updates liest du den Stand deshalb neu ein (Schritt 12).
- Grenzen: rkhunter läuft auf dem System, das es prüft. Ein Rootkit, das schon aktiv ist, kann auch rkhunter täuschen. Ein Lauf ohne Warnungen ist ein gutes Zeichen, aber kein Beweis.
- Kein Nachladen aus dem Internet: Im Ubuntu-Paket ist das Herunterladen neuer Datendateien abgeschaltet.
sudo rkhunter --updateendet mitUpdate failed,--versioncheckmitDownload failed. Das ist so gewollt. Neue Fassungen kommen überapt. - Englische Ausgaben: Alle Meldungen sind englisch.
- Version: Getestet mit rkhunter 1.4.6 am 4. Oktober 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. rkhunter installieren
sudo apt install --no-install-recommends rkhunter
Je nach Einstellung des Systems stellt das Paket dabei bis zu drei Fragen zu automatischen Läufen. Beantworte sie mit Nein. Die Schritte 14 bis 16 zeigen, wie du die Automatik später gezielt einschaltest.
Am Ende der Installation liest das Paket den Zustand der Systembefehle zum ersten Mal ein. Im Test lautete die Zeile dazu File created: searched for 183 files, found 179.
3. Version prüfen
rkhunter --version
Prüfen: Die erste Zeile lautet Rootkit Hunter 1.4.6.
4. Konfiguration prüfen
Der Befehl sucht in den Einstellungen nach Fehlern.
sudo rkhunter --config-check
Prüfen: Der Befehl gibt nichts aus. Dann ist alles in Ordnung.
System prüfen
5. Prüflauf starten
--sk (kurz für --skip-keypress) verhindert, dass rkhunter nach jedem Abschnitt auf die Eingabetaste wartet.
sudo rkhunter --check --sk
Der Lauf dauerte auf dem Testrechner knapp drei Minuten und gab rund 350 Zeilen aus.
Prüfen: Die Ausgabe ist in vier Teile gegliedert:
| Abschnitt | Was geprüft wird |
|---|---|
Checking system commands... | Systembefehle: Vergleich mit dem gespeicherten Stand |
Checking for rootkits... | Dateien und Ordner bekannter Rootkits, weitere Schadsoftware |
Checking the network... | Netzwerkschnittstellen und Ports |
Checking the local host... | Systemstart, Benutzerkonten, Konfiguration, Dateisystem |
Rechts steht in eckigen Klammern das Ergebnis. Grün (OK, Not found, None found) ist unauffällig, rot (Warning) solltest du dir ansehen.
6. Die Zusammenfassung lesen
Am Ende steht die Zusammenfassung. Im Test sah sie so aus:
File properties checks...
Files checked: 179
Suspect files: 1
Rootkit checks...
Rootkits checked : 477
Possible rootkits: 0
Entscheidend ist die Zeile Possible rootkits. Steht dort 0, hat rkhunter keine Datei eines bekannten Rootkits gefunden. Suspect files zählt Systembefehle, die vom gespeicherten Stand abweichen oder sonst auffallen.
7. Warnungen im Protokoll nachlesen
Der Bildschirm zeigt nur, dass es eine Warnung gab. Den Grund nennt das Protokoll. Es gehört root, daher mit sudo.
sudo grep -A5 'Warning:' /var/log/rkhunter.log
Im Test standen dort unter anderem diese Meldungen:
| Meldung | Ursache |
|---|---|
The command '/usr/bin/lwp-request' has been replaced by a script | Das Programm ist von Haus aus ein Perl-Skript aus dem Paket libwww-perl. |
Suspicious file types found in /dev: /dev/shm/PostgreSQL.… | PostgreSQL legt dort gemeinsam genutzten Speicher ab. |
Hidden directory found: /etc/.java | Der Ordner stammt von Java. |
Hidden file found: /etc/.updated | Die Datei legt systemd an. |
Ob eine Datei zu einem Paket gehört, zeigt dpkg -S:
dpkg -S /usr/bin/lwp-request
Die Ausgabe nennt das Paket, hier libwww-perl. Dateien, die erst im Betrieb entstehen, kennt dpkg nicht. Dort hilft ein Blick auf Inhalt und Datum.
Fehlalarme abstellen
Eigene Einstellungen kommen in die Datei /etc/rkhunter.conf.local. Sie ergänzt die mitgelieferte /etc/rkhunter.conf und bleibt bei Updates des Pakets unberührt.
8. Ausnahmen eintragen
Trage nur Stellen ein, die du vorher geprüft hast.
sudo nano /etc/rkhunter.conf.local
Für die Meldungen aus Schritt 7 sieht der Inhalt so aus:
SCRIPTWHITELIST=/usr/bin/lwp-request
ALLOWDEVFILE=/dev/shm/PostgreSQL.*
ALLOWHIDDENDIR=/etc/.java
ALLOWHIDDENFILE=/etc/.updated
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
| Option | Wirkung |
|---|---|
SCRIPTWHITELIST | Dieser Befehl darf ein Skript sein. |
ALLOWDEVFILE | Diese Datei in /dev ist erlaubt. Der Stern steht für beliebige Zeichen. |
ALLOWHIDDENDIR | Dieser versteckte Ordner ist erlaubt. |
ALLOWHIDDENFILE | Diese versteckte Datei ist erlaubt. |
Jede Option darf mehrfach vorkommen, je Zeile ein Pfad.
9. Konfiguration erneut prüfen
Ein Tippfehler im Namen einer Option fällt hier auf.
sudo rkhunter --config-check
Prüfen: Keine Ausgabe.
10. Nur die betroffene Prüfung wiederholen
--enable beschränkt den Lauf auf einzelne Prüfungen. filesystem umfasst /dev und die versteckten Dateien und ist nach wenigen Sekunden fertig.
sudo rkhunter --check --sk --enable filesystem
Prüfen: Beide Zeilen enden auf [ None found ], und am Ende steht No warnings were found while checking the system.
Die Namen aller Prüfungen zeigt sudo rkhunter --list tests.
11. Vollständigen Lauf nur mit Warnungen
--rwo (kurz für --report-warnings-only) unterdrückt alles außer den Warnungen.
sudo rkhunter --check --sk --rwo
Prüfen: Der Befehl gibt nach knapp drei Minuten nichts aus. Der Rückgabewert ist dann 0, bei Warnungen 1:
echo $?
Nach Updates
12. Stand der Systembefehle neu einlesen
Nach sudo apt upgrade oder der Installation neuer Programme meldet rkhunter geänderte Befehle. Wenn du weißt, dass die Änderung von dir stammt, übernimmst du den neuen Zustand:
sudo rkhunter --propupd
Prüfen: Die Ausgabe lautet File updated: searched for 183 files, found 179. Die Zahlen hängen davon ab, welche Programme installiert sind.
Führe den Befehl nicht aus, um eine Warnung loszuwerden, deren Ursache du nicht kennst. Damit würdest du eine mögliche Manipulation als gültig abspeichern.
13. So sieht eine erkannte Änderung aus
Im Test wurde eine überwachte Datei nach dem Einlesen verändert. Der nächste Lauf meldete:
Warning: The file properties have changed:
File: /usr/local/bin/rkh-probe
Current hash: 2357a071…
Stored hash : aee1dd71…
Current size: 36 Stored size: 21
rkhunter nennt die Datei und stellt den jetzigen und den gespeicherten Wert für Prüfsumme, Größe und Änderungszeit gegenüber. Stammt die Änderung von einem Update, passt die Änderungszeit zum Zeitpunkt des Updates. Den findest du in /var/log/apt/history.log.
Nur die Systembefehle prüft:
sudo rkhunter --check --sk --rwo --enable properties
Dieser Teillauf dauerte im Test eine Minute.
Automatisch prüfen
Das Paket bringt Skripte für einen täglichen Lauf mit. Sie sind nach der Installation abgeschaltet. Die Schalter stehen in /etc/default/rkhunter.
14. Voraussetzung prüfen
Der tägliche Lauf verschickt Warnungen als E-Mail und braucht dafür ein Programm sendmail, wie es ein Mailserver (z. B. Postfix) mitbringt.
ls /usr/sbin/sendmail
Prüfen: Der Pfad wird ausgegeben. Meldet ls einen Fehler, fehlt ein Mailserver. Bleib dann beim Lauf von Hand.
15. Täglichen Lauf einschalten
sudo nano /etc/default/rkhunter
Ändere die Zeile CRON_DAILY_RUN="" in:
CRON_DAILY_RUN="true"
Speichere mit Strg+O, Enter und beende nano mit Strg+X.
Die weiteren Zeilen der Datei:
| Zeile | Bedeutung |
|---|---|
REPORT_EMAIL="root" | Empfänger der Warnungen. root ist das lokale Postfach des Systems. |
CRON_DB_UPDATE="" | Wöchentliches Nachladen der Datendateien. Leer lassen, es funktioniert im Ubuntu-Paket nicht (siehe Vorbemerkungen). |
APT_AUTOGEN="false" | Mit "true" liest rkhunter nach jedem Lauf von apt den Stand der Systembefehle selbst neu ein. |
NICE="0" | Priorität des Laufs. 19 bremst andere Programme am wenigsten. |
RUN_CHECK_ON_BATTERY="false" | Im Akkubetrieb nicht prüfen. Die Erkennung braucht das Paket powermgmt-base. |
APT_AUTOGEN="true" erspart Schritt 12. Der Preis: Wurde ein Befehl vor dem nächsten apt-Lauf manipuliert, speichert rkhunter auch das als gültig ab. Auf einem Rechner mit unattended-upgrades ist die Einstellung trotzdem verbreitet, weil sonst jedes automatische Update eine Warnung auslöst. Diese Einstellung wurde nicht selbst getestet.
16. Täglichen Lauf von Hand auslösen
Das Skript liegt in /etc/cron.daily und läuft sonst einmal am Tag von selbst. So probierst du es sofort aus:
sudo /etc/cron.daily/rkhunter
Prüfen: Nach knapp drei Minuten endet der Befehl ohne Ausgabe. Gab es Warnungen, liegt eine E-Mail mit dem Betreff [rkhunter] <Rechnername> - Daily report im Postfach von root:
sudo cat /var/mail/root
Gab es keine Warnungen, verschickt das Skript nichts, und die Datei fehlt möglicherweise.
Wie geht es weiter?
- Alle Optionen:
/etc/rkhunter.conferklärt jede Einstellung in ausführlichen Kommentaren. Eigene Werte gehören in/etc/rkhunter.conf.local. - Abgeschaltete Prüfungen: Das Ubuntu-Paket lässt einige Prüfungen aus, darunter die Suche nach versteckten Prozessen und Ports. Sie stehen in der Zeile
DISABLE_TESTSin/etc/rkhunter.conf. Für die Suche nach versteckten Prozessen und Ports braucht rkhunter das Paketunhide. Nicht selbst getestet. - Protokoll:
/var/log/rkhunter.logenthält den letzten Lauf von Hand, der vorige liegt in/var/log/rkhunter.log.old. Der tägliche Lauf hängt seine Einträge an. - Verwandte Werkzeuge: Lynis bewertet, wie gut das System abgesichert ist. ClamAV prüft Dateien auf bekannte Schadsoftware.
- Dokumentation:
man rkhuntersowie https://rkhunter.sourceforge.net
Deinstallieren
1. rkhunter entfernen
purge löscht auch /etc/rkhunter.conf, /etc/default/rkhunter und den gespeicherten Stand in /var/lib/rkhunter.
sudo apt purge rkhunter
2. Eigene Einstellungen und Protokolle löschen
Diese Dateien lässt purge liegen.
sudo rm -f /etc/rkhunter.conf.local /var/log/rkhunter.log /var/log/rkhunter.log.old
3. Optional: net-tools entfernen
Das Paket kam als Abhängigkeit mit und enthält ältere Netzwerkbefehle wie ifconfig und netstat. Entferne es nur, wenn du diese Befehle nicht anderweitig brauchst.
sudo apt purge net-tools
Prüfen: Der Befehl wird nicht mehr gefunden.
rkhunter --version
Quellen und Lizenz
- Offizielle Dokumentation: https://rkhunter.sourceforge.net/
- Lizenz: rkhunter steht unter der 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.
Emacs
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GNU Emacs ist ein sehr vielseitiger Texteditor. Er lässt sich mit der Sprache Emacs Lisp fast beliebig erweitern und wird zum Programmieren, für Notizen (Org-Modus) und viele andere Aufgaben genutzt.
Installation
Ubuntu bietet Emacs in mehreren Varianten an. Diese Anleitung verwendet emacs-pgtk, weil sie direkt mit Wayland zusammenarbeitet, dem Grafiksystem von Ubuntu. Schriften werden dadurch scharf dargestellt, auch bei Bildschirmskalierung. Wer nur im Terminal arbeitet (z. B. auf einem Server), nimmt stattdessen emacs-nox.
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Emacs aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Emacs installieren
Installiert Emacs mit grafischer Oberfläche aus den offiziellen Ubuntu-Paketquellen. Die gemeinsam genutzten Dateien (z. B. Hilfe und Erweiterungen) werden automatisch mitinstalliert.
sudo apt install emacs-pgtk
Prüfen: Die erste Zeile der Ausgabe nennt die Version, z. B. GNU Emacs 30.2.
emacs --version | head -n 1
3. Emacs starten
Öffnet Emacs in einem eigenen Fenster. Alternativ findest du Emacs im Anwendungsmenü.
emacs &
Prüfen: Es öffnet sich ein Fenster mit der Begrüßungsseite von Emacs.
Soll Emacs direkt im Terminal laufen statt in einem eigenen Fenster, startest du es mit -nw:
emacs -nw
Erste Schritte
4. Die eingebaute Übung durcharbeiten
Emacs bringt eine Übung zum Mitmachen auf Deutsch mit. Sie erklärt die Grundbefehle und dauert etwa 30 Minuten. Nach dem Start fragt Emacs unten nach der Sprache: German eingeben und Enter drücken.
emacs -nw --eval '(call-interactively (quote help-with-tutorial-spec-language))'
Innerhalb von Emacs erreichst du die Übung jederzeit mit Strg+H, dann T (in der Sprache deines Systems).
5. Datei öffnen
Öffnet eine Datei zum Bearbeiten. Gibt es die Datei noch nicht, legt Emacs sie beim Speichern an.
emacs test.txt &
6. Die wichtigsten Tastenkürzel kennenlernen
Emacs verwendet eigene Tastenkürzel. In der Emacs-Hilfe steht C- für Strg und M- für Alt. C-x C-s bedeutet: Strg+X drücken, loslassen, dann Strg+S.
| Tasten | Wirkung |
|---|---|
C-x C-f | Datei öffnen |
C-x C-s | Datei speichern |
C-x C-c | Emacs beenden (fragt bei Änderungen, ob gespeichert werden soll) |
C-g | Aktuellen Befehl abbrechen |
C-/ | Letzte Änderung rückgängig machen |
C-s | Text suchen, erneut C-s für den nächsten Treffer |
M-% | Suchen und ersetzen |
C-k | Rest der Zeile ausschneiden |
C-y | Ausgeschnittenen Text einfügen |
C-h t | Übung öffnen |
Tipp: Im Menü Options → Use CUA Keys (Cut/Paste with C-x/C-c/C-v) schaltest du die gewohnten Kürzel zum Ausschneiden, Kopieren und Einfügen ein. Mit Options → Save Options bleibt die Einstellung erhalten.
7. Systemdateien bearbeiten
Dateien unter /etc gehören root. Mit sudoedit bearbeitest du eine Kopie mit deinen normalen Rechten, beim Beenden wird sie zurückgeschrieben. Die Datei /etc/hosts dient hier nur als Beispiel.
SUDO_EDITOR="emacs -nw" sudoedit /etc/hosts
Optional: Emacs einrichten
8. Ordner für die Einstellungen anlegen
Emacs liest seine Einstellungen aus ~/.config/emacs. Der Ordner existiert anfangs nicht.
mkdir -p ~/.config/emacs
9. Einstellungsdatei anlegen
Die Datei init.el wird in Emacs Lisp geschrieben. Die Einstellungen blenden die Begrüßungsseite aus, zeigen Zeilennummern an und fügen statt eines Tabulators vier Leerzeichen ein.
nano ~/.config/emacs/init.el
Hast du die Datei schon mit eigenen Einstellungen, lösche deren alten Inhalt zuerst oder ergänze nur die fehlenden Zeilen. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
(setq inhibit-startup-screen t)
(global-display-line-numbers-mode 1)
(setq-default indent-tabs-mode nil)
(setq-default tab-width 4)
Prüfen: Beim nächsten Start von Emacs erscheint keine Begrüßungsseite, und links stehen die Zeilennummern.
emacs ~/.config/emacs/init.el &
10. Emacs als Standard-Editor festlegen
Programme wie crontab -e oder git commit lesen den gewünschten Editor aus der Umgebungsvariablen EDITOR. Dazu kommt Emacs (im Terminal-Modus) in die Datei ~/.bashrc, die bei jedem neuen Terminal gelesen wird.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
export EDITOR="emacs -nw"
Prüfen: Ein neues Terminal öffnen. Die Ausgabe lautet emacs -nw.
echo "$EDITOR"
Deinstallieren
1. Eintrag als Standard-Editor entfernen
Löscht die Zeile aus Schritt 10 wieder aus ~/.bashrc, falls du sie angelegt hast.
nano ~/.bashrc
Suche mit Strg+W nach EDITOR und drücke Enter. Lösche die Zeile export EDITOR="emacs -nw" mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
2. Eigene Einstellungen entfernen
Löscht die Einstellungen und alle darin installierten Erweiterungen. Die älteren Orte ~/.emacs und ~/.emacs.d werden gleich mit entfernt, falls vorhanden. Achtung: Deine Einstellungen gehen dabei verloren.
rm -rf ~/.config/emacs ~/.emacs.d ~/.emacs
3. Emacs entfernen
purge entfernt auch die Konfigurationsdateien des Pakets.
sudo apt purge emacs-pgtk
4. Nicht mehr benötigte Pakete entfernen
Entfernt die gemeinsam genutzten Emacs-Pakete (z. B. emacs-common), die nur für Emacs installiert wurden. --purge löscht dabei auch deren Konfigurationsdateien unter /etc/emacs.
sudo apt autoremove --purge
Prüfen: Der Befehl wird nicht mehr gefunden.
emacs --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.gnu.org/software/emacs/documentation.html
- Lizenz: GNU Emacs steht unter der GPL-3.0-or-later.
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.
GNU nano
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GNU nano ist ein kleiner Texteditor für das Terminal. Er eignet sich gut, um schnell Konfigurationsdateien zu bearbeiten, auch auf Servern ohne grafische Oberfläche.
Installation
Unter Ubuntu ist nano meistens schon vorinstalliert. Die folgenden Schritte schaden aber nicht: Ist nano bereits vorhanden, meldet apt das nur.
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von nano aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. nano installieren
Installiert nano aus den offiziellen Ubuntu-Paketquellen. Die Dateien für die Syntaxhervorhebung (z. B. für Shell, Python, HTML) sind im Paket enthalten.
sudo apt install nano
Prüfen: Die Versionsnummer wird angezeigt.
nano --version
Erste Schritte
3. Datei öffnen
Öffnet eine Datei zum Bearbeiten. Gibt es die Datei noch nicht, legt nano sie beim Speichern an.
nano test.txt
Prüfen: Oben steht der Dateiname, unten eine Leiste mit den wichtigsten Tastenkürzeln.
4. Die wichtigsten Tastenkürzel kennenlernen
In der unteren Leiste steht ^ für die Taste Strg und M- für die Taste Alt.
| Tasten | Wirkung |
|---|---|
| Strg+O, dann Enter | Datei speichern |
| Strg+X | nano beenden (fragt bei Änderungen, ob gespeichert werden soll) |
| Strg+W | Text suchen |
| Strg+\ | Suchen und ersetzen |
| Strg+K | Aktuelle Zeile ausschneiden |
| Strg+U | Ausgeschnittenen Text einfügen |
| Alt+U | Letzte Änderung rückgängig machen |
| Strg+_ | Zu einer bestimmten Zeilennummer springen |
| Strg+G | Hilfe anzeigen |
5. Systemdateien bearbeiten
Dateien unter /etc gehören root. Damit du sie speichern kannst, startest du nano mit sudo. Die Datei /etc/hosts dient hier nur als Beispiel.
sudo nano /etc/hosts
Prüfen: Unten erscheint beim Speichern keine Meldung wie „Keine Berechtigung“.
Optional: nano einrichten
6. Eigene Einstellungsdatei anlegen
Die Datei ~/.nanorc gilt nur für deinen Benutzer. Die Einstellungen zeigen Zeilennummern an, rücken neue Zeilen automatisch ein und fügen statt eines Tabulators vier Leerzeichen ein.
nano ~/.nanorc
Hast du die Datei schon mit eigenen Einstellungen, lösche deren alten Inhalt zuerst oder ergänze nur die fehlenden Zeilen. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
set linenumbers
set autoindent
set tabsize 4
set tabstospaces
Prüfen: Beim nächsten Start von nano stehen links die Zeilennummern.
nano ~/.nanorc
7. nano als Standard-Editor festlegen
Programme wie crontab -e oder git commit öffnen den eingestellten Standard-Editor. Mit diesem Befehl wählst du aus einer Liste den Editor aus, der systemweit verwendet wird. Gib die Nummer ein, die vor /bin/nano steht.
sudo update-alternatives --config editor
Prüfen: Die Ausgabe zeigt als Link /bin/nano.
update-alternatives --query editor | grep Value
Deinstallieren
1. Eigene Einstellungen entfernen
Löscht die persönliche Einstellungsdatei, falls du sie in Schritt 6 angelegt hast.
rm -f ~/.nanorc
2. nano entfernen
purge entfernt auch die systemweite Einstellungsdatei /etc/nanorc. Hinweis: Ist nano dein Standard-Editor, stellt Ubuntu automatisch auf einen anderen installierten Editor um.
sudo apt purge nano
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für nano installiert wurden.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
nano --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.nano-editor.org/docs.php
- Lizenz: GNU nano steht unter der GPL-3.0-or-later.
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.
Vim
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Vim ist ein sehr leistungsfähiger Texteditor für das Terminal. Er wird komplett über die Tastatur bedient und eignet sich besonders zum Programmieren und für längere Arbeit an Textdateien.
Installation
Ubuntu bringt meist nur vim-tiny mit, eine stark abgespeckte Variante ohne Syntaxhervorhebung. Das Paket vim enthält die vollständige Version.
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Vim aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Vim installieren
Installiert die vollständige Terminal-Version von Vim aus den offiziellen Ubuntu-Paketquellen.
sudo apt install vim
Prüfen: Die erste Zeile der Ausgabe nennt die Version, z. B. VIM - Vi IMproved 9.1.
vim --version | head -n 1
3. Optional: Version mit Zwischenablage installieren
Die normale Terminal-Version kann nicht auf die Zwischenablage des Desktops zugreifen. Wenn du Text zwischen Vim und anderen Programmen kopieren willst, installierst du stattdessen vim-gtk3. Das Paket bringt zusätzlich die grafische Oberfläche gvim mit.
sudo apt install vim-gtk3
Prüfen: In der Ausgabe steht +clipboard (mit Pluszeichen).
vim --version | grep -o '[+-]clipboard'
Erste Schritte
4. Die eingebaute Übung durcharbeiten
vimtutor öffnet eine Übungsdatei, in der du die Grundlagen direkt ausprobierst. Das dauert etwa 30 Minuten und ist der beste Einstieg, weil Vim anders funktioniert als die meisten Editoren.
vimtutor de
5. Datei öffnen
Öffnet eine Datei zum Bearbeiten. Gibt es die Datei noch nicht, legt Vim sie beim Speichern an.
vim test.txt
Prüfen: Unten links steht der Dateiname.
6. Die Modi verstehen
Vim startet im Normalmodus. Dort lösen Tasten Befehle aus, statt Text zu schreiben. Zum Tippen wechselst du in den Einfügemodus.
| Tasten | Wirkung |
|---|---|
| i | In den Einfügemodus wechseln (unten steht -- EINFÜGEN --) |
| Esc | Zurück in den Normalmodus |
:w + Enter | Datei speichern |
:q + Enter | Vim beenden |
:wq + Enter | Speichern und beenden |
:q! + Enter | Beenden, ohne zu speichern |
| u | Letzte Änderung rückgängig machen |
| dd | Aktuelle Zeile ausschneiden |
| p | Ausgeschnittenen Text einfügen |
/wort + Enter | Nach „wort“ suchen, mit n zum nächsten Treffer |
:help + Enter | Hilfe anzeigen |
Die Befehle mit Doppelpunkt funktionieren nur im Normalmodus. Drücke im Zweifel vorher Esc.
7. Systemdateien bearbeiten
Dateien unter /etc gehören root. Mit sudoedit bearbeitest du eine Kopie mit deinen normalen Rechten, beim Beenden wird sie zurückgeschrieben. Das ist sicherer, als Vim komplett mit sudo zu starten. Die Datei /etc/hosts dient hier nur als Beispiel.
SUDO_EDITOR=vim sudoedit /etc/hosts
Optional: Vim einrichten
8. Eigene Einstellungsdatei anlegen
Die Datei ~/.vimrc gilt nur für deinen Benutzer. Die Einstellungen schalten Syntaxhervorhebung und Zeilennummern ein, rücken automatisch ein und fügen statt eines Tabulators vier Leerzeichen ein.
nano ~/.vimrc
Hast du die Datei schon mit eigenen Einstellungen, lösche deren alten Inhalt zuerst oder ergänze nur die fehlenden Zeilen. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
syntax on
filetype plugin indent on
set number
set autoindent
set tabstop=4
set shiftwidth=4
set expandtab
Prüfen: Beim nächsten Start von Vim stehen links die Zeilennummern.
vim ~/.vimrc
9. Vim als Standard-Editor festlegen
Programme wie crontab -e oder git commit öffnen den eingestellten Standard-Editor. Mit diesem Befehl wählst du aus einer Liste den Editor aus, der systemweit verwendet wird. Gib die Nummer ein, die vor /usr/bin/vim.basic steht (bzw. /usr/bin/vim.gtk3, wenn du Schritt 3 ausgeführt hast).
sudo update-alternatives --config editor
Prüfen: Die Ausgabe zeigt als Link den gewählten Vim.
update-alternatives --query editor | grep Value
Deinstallieren
1. Eigene Einstellungen entfernen
Löscht die persönliche Einstellungsdatei und den Ordner für Erweiterungen, falls vorhanden. Achtung: Selbst installierte Plugins in ~/.vim gehen verloren.
rm -rf ~/.vimrc ~/.vim
2. Vim entfernen
Entfernt die vollständige Version und, falls installiert, die Version mit Zwischenablage. vim-tiny bleibt erhalten, weil Ubuntu es als einfachen Editor mitbringt. Ist Vim dein Standard-Editor, stellt Ubuntu automatisch auf einen anderen installierten Editor um.
sudo apt purge vim vim-gtk3
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für Vim installiert wurden, z. B. vim-runtime.
sudo apt autoremove
Prüfen: Es wird nur noch die kleine Version gefunden, vim.basic fehlt.
ls /usr/bin/vim*
Quellen und Lizenz
- Offizielle Dokumentation: https://www.vim.org/docs.php
- Lizenz: Vim steht unter der Vim Charityware License (GPL-kompatibel).
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.
Neovim
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neovim ist eine Weiterentwicklung von Vim. Es wird genauso über die Tastatur bedient, lässt sich aber mit der Programmiersprache Lua einrichten und bringt moderne Funktionen für das Programmieren mit, etwa Unterstützung für Language Server (Autovervollständigung, Fehleranzeige).
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Neovim aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Neovim installieren
Installiert Neovim aus den offiziellen Ubuntu-Paketquellen. Der Befehl zum Starten heißt nvim.
sudo apt install neovim
Prüfen: Die erste Zeile der Ausgabe nennt die Version, z. B. NVIM v0.11.6.
nvim --version | head -n 1
3. Werkzeug für die Zwischenablage installieren
Neovim greift nicht selbst auf die Zwischenablage des Desktops zu, sondern nutzt dafür ein Hilfsprogramm. Ubuntu verwendet Wayland, deshalb wird wl-clipboard gebraucht. Ohne das Paket kannst du keinen Text zwischen Neovim und anderen Programmen austauschen.
sudo apt install wl-clipboard
4. Einrichtung überprüfen
Neovim hat eine eingebaute Selbstprüfung. Sie zeigt, ob alles Nötige vorhanden ist.
nvim +checkhealth
Prüfen: Im Abschnitt vim.provider steht unter „Clipboard“ ein OK mit wl-copy. Warnungen zu Python, Ruby, Node.js oder Perl kannst du ignorieren, diese Erweiterungen werden nur von manchen Plugins gebraucht. Mit :qa + Enter verlässt du die Anzeige.
Erste Schritte
5. Die eingebaute Übung durcharbeiten
Neovim bringt eine Übung zum Mitmachen mit. Sie ist nur auf Englisch verfügbar. Wer die deutsche Fassung möchte, kann stattdessen vimtutor de aus der Vim-Anleitung nutzen, die Grundbefehle sind gleich.
nvim +Tutor
6. Datei öffnen
Öffnet eine Datei zum Bearbeiten. Gibt es die Datei noch nicht, legt Neovim sie beim Speichern an.
nvim test.txt
7. Die wichtigsten Befehle kennenlernen
Wie Vim startet Neovim im Normalmodus, in dem Tasten Befehle auslösen. Zum Tippen wechselst du in den Einfügemodus.
| Tasten | Wirkung |
|---|---|
| i | In den Einfügemodus wechseln (unten steht -- EINFÜGEN --) |
| Esc | Zurück in den Normalmodus |
:w + Enter | Datei speichern |
:q + Enter | Neovim beenden |
:wq + Enter | Speichern und beenden |
:q! + Enter | Beenden, ohne zu speichern |
| u | Letzte Änderung rückgängig machen |
| dd | Aktuelle Zeile ausschneiden |
| p | Ausgeschnittenen Text einfügen |
"+y | Markierten Text in die Zwischenablage des Desktops kopieren |
"+p | Text aus der Zwischenablage des Desktops einfügen |
/wort + Enter | Nach „wort“ suchen, mit n zum nächsten Treffer |
:help + Enter | Hilfe anzeigen |
8. Systemdateien bearbeiten
Dateien unter /etc gehören root. Mit sudoedit bearbeitest du eine Kopie mit deinen normalen Rechten, beim Beenden wird sie zurückgeschrieben. So bleiben auch deine eigenen Neovim-Einstellungen aktiv. Die Datei /etc/hosts dient hier nur als Beispiel.
SUDO_EDITOR=nvim sudoedit /etc/hosts
Optional: Neovim einrichten
Neovim hat bereits sinnvolle Grundeinstellungen, etwa Syntaxhervorhebung und automatisches Einrücken. Eine eigene Einstellungsdatei brauchst du nur für persönliche Anpassungen.
9. Ordner für die Einstellungen anlegen
Neovim liest seine Einstellungen aus ~/.config/nvim. Der Ordner existiert anfangs nicht.
mkdir -p ~/.config/nvim
10. Einstellungsdatei anlegen
Die Datei init.lua wird in Lua geschrieben. Die Einstellungen zeigen Zeilennummern an, fügen statt eines Tabulators vier Leerzeichen ein und verbinden die normalen Kopierbefehle direkt mit der Zwischenablage des Desktops (dann ist "+ nicht mehr nötig).
nano ~/.config/nvim/init.lua
Hast du die Datei schon mit eigenen Einstellungen, lösche deren alten Inhalt zuerst oder ergänze nur die fehlenden Zeilen. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
vim.opt.number = true
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4
vim.opt.expandtab = true
vim.opt.clipboard = "unnamedplus"
Prüfen: Beim nächsten Start von Neovim stehen links die Zeilennummern.
nvim ~/.config/nvim/init.lua
11. Neovim als Standard-Editor festlegen
Programme wie crontab -e oder git commit öffnen den eingestellten Standard-Editor. Mit diesem Befehl wählst du aus einer Liste den Editor aus, der systemweit verwendet wird. Gib die Nummer ein, die vor /usr/bin/nvim steht.
sudo update-alternatives --config editor
Prüfen: Die Ausgabe zeigt als Link /usr/bin/nvim.
update-alternatives --query editor | grep Value
Deinstallieren
1. Eigene Einstellungen und Daten entfernen
Neovim legt Dateien an vier Stellen ab: Einstellungen, Plugins, Verlauf bzw. Sicherungsdateien und Zwischenspeicher. Achtung: Deine Einstellungen und selbst installierten Plugins gehen dabei verloren.
rm -rf ~/.config/nvim ~/.local/share/nvim ~/.local/state/nvim ~/.cache/nvim
2. Neovim entfernen
Entfernt Neovim und das Hilfsprogramm für die Zwischenablage. Lass wl-clipboard weg, wenn andere Programme es noch brauchen. Ist Neovim dein Standard-Editor, stellt Ubuntu automatisch auf einen anderen installierten Editor um.
sudo apt purge neovim wl-clipboard
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für Neovim installiert wurden, z. B. neovim-runtime.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
nvim --version
Quellen und Lizenz
- Offizielle Dokumentation: https://neovim.io/doc/
- Lizenz: Neovim steht unter der Apache-2.0 / Vim-Lizenz.
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.
Terminals und Entwicklungsumgebungen im Browser
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Übersicht hilft bei der Auswahl eines Browserterminals, eines Editors oder eines gemeinsamen Notebook-Servers.
Stand: 14. November 2026. Zielsystem der lokalen Anleitungen: Ubuntu 26.04 LTS, amd64. Die Kapitel installieren keine Software auf dem Arbeitsrechner, sondern beschreiben die Schritte für deine spätere Einrichtung.
| Werkzeug | Wo läuft die Arbeit? | Einrichtung unter diesen Vorgaben |
|---|---|---|
| xterm.js mit node-pty | Shell auf deinem Ubuntu-Rechner | Eigenes lokales Beispielprogramm |
| ttyd | Shell auf deinem Ubuntu-Rechner | Direkt mit apt |
| code-server | Editor und Terminal auf deinem Ubuntu-Rechner | Offizielles DEB-Paket |
| GitHub Codespaces | Bei GitHub | Browserzugang; Container beim Anbieter |
| The Littlest JupyterHub | Eigener Ubuntu-Server | Direktinstallation auf einem separaten System |
| Zero to JupyterHub | Kubernetes-Cluster | Benötigt Container und entfällt daher lokal |
| vscode.dev | Editor im Browser | Ohne lokale Installation, ohne eigene Shell |
Auswahl in drei Schritten
-
Entscheide, ob du nur Dateien bearbeiten oder auch Programme ausführen möchtest. Für Dateibearbeitung genügt vscode.dev; ein Terminal braucht zusätzlich eine Ausführungsumgebung.
-
Entscheide, ob die Ausführung auf deinem Rechner oder bei einem Anbieter stattfinden soll. Für einen unkomplizierten lokalen Terminalzugang eignet sich ttyd; code-server ergänzt einen vollständigen Editor. xterm.js ist für eigene Anwendungen gedacht.
-
Plane bei mehreren Personen getrennte Konten und ausreichend Rechenleistung. TLJH ist für kleinere Gruppen gedacht; rund 100 Personen sind ein Orientierungswert, keine Zusage für gleichzeitige rechenintensive Sitzungen.
Kostenlose Software verursacht gegebenenfalls Hardware-, Betriebs- und Administrationskosten. Kostenlose Webdienste unterliegen eigenen Nutzungsbedingungen. Lizenzangaben und offizielle Quellen stehen in den Einzelkapiteln.
Prüfung und Entfernen
-
Prüfe im ausgewählten Einzelkapitel den vorgesehenen Funktionstest. Ein sichtbarer Editor allein belegt noch keine funktionierende Shell.
-
Verwende zum Entfernen die dortigen Schritte. Bei Cloud-Diensten müssen gespeicherte Umgebungen beim Anbieter gelöscht werden; ein geschlossener Browser-Tab reicht dafür nicht aus.
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.
ttyd
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ttyd stellt eine Shell über eine Webseite bereit.
Das Projekt steht unter MIT. Ubuntu 26.04 führt ttyd in Universe. Hier läuft es ausschließlich lokal und mit den Rechten deines normalen Benutzerkontos. Jede Person mit Zugriff auf diese Sitzung kann dessen Dateien und Programme verwenden.
Einrichten
-
Aktualisiere die Paketlisten, damit apt die verfügbaren Versionen kennt.
sudo apt update -
Prüfe, ob ein Installationskandidat vorhanden ist.
apt policy ttydFalls kein Kandidat erscheint, aktiviere zuerst in „Anwendungen & Aktualisierungen“ die Paketquelle Universe und wiederhole Schritt 1.
-
Installiere das Ubuntu-Paket.
sudo apt install ttyd -
Prüfe die Programmversion.
ttyd --version -
Starte ein beschreibbares Browserterminal. Die Bindung an die Loopback-Adresse verhindert direkte Netzwerkzugriffe; die Origin-Prüfung erschwert Zugriffe aus fremden Webseiten. Starte diesen Befehl ohne sudo.
ttyd -i 127.0.0.1 -p 7681 -O -W bashDie Optionen sind in der Projektbeschreibung erläutert. Ohne
-Wbleibt das Terminal bei dieser Version schreibgeschützt. -
Öffne die lokale Adresse im Browser desselben Rechners.
http://127.0.0.1:7681
Prüfen
-
Führe im Browserterminal diesen Befehl aus. Die Ausgabe sollte deinen Ubuntu-Benutzernamen zeigen.
whoami -
Beende ttyd mit Strg+C im ursprünglichen Terminal. Die Browserverbindung soll abbrechen.
Deinstallieren
-
Beende einen noch laufenden ttyd-Prozess mit Strg+C im Startterminal.
-
Entferne das Paket. Dateien, die du über die Shell angelegt hast, bleiben erhalten.
sudo apt remove ttyd -
Prüfe den Paketstatus. Eine Meldung über ein nicht installiertes Paket oder ein Status ohne „installed“ ist nach dem Entfernen zu erwarten.
dpkg-query -W -f='${Status}\n' ttyd
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.
code-server
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
code-server bietet einen auf VS Code basierenden Editor samt Terminal im Browser.
Der Quellcode steht unter MIT. Die Anleitung verwendet das offizielle amd64-DEB und bindet den Dienst lokal. Erweiterungen haben eigene Lizenzen; das Erweiterungsangebot entspricht nicht vollständig dem Microsoft Marketplace.
Einrichten
-
Aktualisiere die Paketlisten für die Paketinstallation.
sudo apt update -
Öffne die offiziellen Veröffentlichungen im Browser. Wähle eine stabile Veröffentlichung, um eine Vorabversion zu vermeiden.
-
Lade deren Datei
code-server_<VERSION>_amd64.debin deinen Downloadordner. Verwende das DEB für amd64, nicht das ARM-Paket. -
Installiere genau diese Datei mit apt. Das Sternchen
*passt automatisch auf die heruntergeladene Versionsnummer; passe den Ordner an, falls dein Browser anders speichert.sudo apt install "$HOME/Downloads/code-server_"*"_amd64.deb"Dieser Weg folgt der Herstelleranleitung, verwendet aber apt zur Auflösung der Paketabhängigkeiten. Das einzelne DEB richtet keine automatische Versorgung mit künftigen Hersteller-Releases ein; installiere Aktualisierungen auf demselben Weg.
-
Prüfe die installierte Version.
code-server --version -
Starte den Editor zunächst im Vordergrund. Der erste Start erzeugt auch die Konfiguration.
code-server --bind-addr 127.0.0.1:8080 -
Lies in einem zweiten Terminal das erzeugte Anmeldepasswort ab. Gib den Inhalt nicht weiter.
cat ~/.config/code-server/config.yamlDie Konfiguration sollte
auth: passwordenthalten. Für den lokalen Einstieg bleibtcert: falsemöglich; die Verbindung verlässt dabei den Rechner nicht. Öffentliche Bereitstellung braucht zusätzlich HTTPS und Zugangsschutz, siehe sicherer Zugriff. -
Öffne die Adresse im Browser und melde dich mit dem angezeigten Passwort an.
http://127.0.0.1:8080
Prüfen
-
Öffne im Editor über Terminal → Neues Terminal eine Shell.
-
Prüfe dort, welches Konto die Befehle ausführt.
whoami -
Beende den Vordergrundprozess im ursprünglichen Terminal mit Strg+C.
Optional dauerhaft starten
-
Aktiviere nach dem erfolgreichen Test den Systemdienst für dein Benutzerkonto. Die erzeugte Konfiguration muss weiterhin an
127.0.0.1:8080binden und Passwortauthentifizierung nutzen.sudo systemctl enable --now "code-server@$USER" -
Prüfe den Dienstzustand. Erwartet wird „active“.
systemctl is-active "code-server@$USER"
Deinstallieren
-
Deaktiviere den Dienst, sofern du ihn eingerichtet hast.
sudo systemctl disable --now "code-server@$USER" -
Beende einen noch laufenden Vordergrundprozess mit Strg+C.
-
Entferne das Paket.
sudo apt remove code-server -
Entferne bei Bedarf nach einer Sicherung die benutzerspezifischen Einstellungen und Erweiterungen. Eigene Projekte außerhalb dieser Ordner bleiben erhalten.
rm -rf -- ~/.config/code-server ~/.local/share/code-server
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.
GitHub Codespaces
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GitHub Codespaces stellt eine entfernte Entwicklungsumgebung mit Editor und Terminal bereit.
Auf Ubuntu wird dafür kein Server installiert. Die Umgebung läuft bei GitHub und verwendet dort Development Container. Wenn deine Container-Vorgabe auch entfernte Dienste ausschließt, überspringe dieses Angebot.
Persönliche GitHub-Free-Konten enthalten laut Abrechnungsdokumentation monatlich 120 Kernstunden und 15 GB-Monate Speicher. Zwei Kerne verbrauchen somit das Zeitkontingent nach etwa 60 Laufzeitstunden. Nach Verbrauch ist weitere Nutzung kostenpflichtig, sofern Zahlungsart und Budget dies erlauben; ohne Zahlungsart wird sie gesperrt. Organisationskonten haben andere Regeln. Stand: 14. November 2026; prüfe vor dem Anlegen die aktuellen Angaben in deinem Konto.
Einrichten
-
Melde dich im Browser bei GitHub an. Du brauchst ein eigenes Konto, weil Umgebung und Abrechnung einem Konto zugeordnet werden.
-
Prüfe in deinen Kontoeinstellungen den Bereich Billing and licensing und die Codespaces-Budgets. Richte eine Ausgabensperre ein, falls du keine kostenpflichtige Nutzung möchtest; eine reine Benachrichtigung ist keine Sperre.
-
Öffne ein Repository, auf das du Zugriff hast. Für den Einstieg eignet sich ein kleines eigenes Lernprojekt.
-
Öffne Code → Codespaces → Create codespace für den gewünschten Branch. Verwende eine kleine Maschine, um das Freikontingent zu schonen.
-
Warte, bis der Webeditor und das Terminal bereitstehen. Pakete werden in dieser entfernten Umgebung installiert, nicht auf deinem Ubuntu-Rechner.
Prüfen
-
Führe im Codespaces-Terminal den folgenden Befehl aus. Die Ausgabe beschreibt die entfernte Linux-Umgebung.
cat /etc/os-release -
Prüfe auf der Codespaces-Seite, ob deine Umgebung als laufend erscheint.
-
Stoppe die Umgebung dort über deren Menü, sobald du sie nicht mehr verwendest. Das Schließen des Tabs garantiert keinen sofortigen Stopp; gespeicherte Umgebungen belegen weiter Speicher.
Entfernen
-
Sichere Änderungen durch Commit und Push oder durch einen Download. Ungesicherte Dateien gehen beim Löschen verloren.
-
Lösche den Codespace auf der Codespaces-Seite über sein Menü. Dadurch wird die entfernte Umgebung entfernt.
-
Prüfe, dass sie aus der Liste verschwunden ist. Bereits entstandener Verbrauch wird dadurch nicht rückwirkend aufgehoben; weitere Codespaces und Prebuilds sind getrennt zu prüfen.
Eine lokale Deinstallation ist bei reinem Browserzugang nicht erforderlich.
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.
vscode.dev
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
vscode.dev ist ein kostenlos nutzbarer Browsereditor für lokale Dateien und entfernte Repositorys.
Eine lokale Serverinstallation entfällt. Die reine Weboberfläche hat keine eigene Betriebssystem-Shell und ersetzt daher keine Ausführungsumgebung. Remote-Verbindungen sind zusätzliche Betriebsarten. Einzelne Web-Erweiterungen können Vorschauen oder Ausführung im Browser ermöglichen. Details erläutert Visual Studio Code for the Web; für den Dienst gelten die Microsoft-Nutzungsbedingungen.
Verwenden
-
Öffne die Adresse in einem aktuellen Browser auf Ubuntu.
https://vscode.dev -
Wähle Datei → Datei öffnen und öffne eine lokale Übungsdatei. Ein Konto ist für diesen lokalen Einstieg nicht nötig.
-
Erlaube dem Browser den Zugriff auf diese Datei. Nur so kann der Editor ihren Inhalt lesen und gegebenenfalls zurückschreiben.
-
Ändere eine Zeile und speichere über Datei → Speichern. Falls dein Browser keinen direkten Schreibzugriff unterstützt, lade die Datei herunter und wähle bewusst den Zielpfad. Ordnerzugriff hängt ebenfalls vom Browser ab.
Prüfen
-
Öffne die gespeicherte beziehungsweise heruntergeladene Datei mit einem lokalen Editor. Die geänderte Zeile muss dort sichtbar sein.
-
Prüfe vor der Auswahl einer Erweiterung, ob sie als Web-Erweiterung nutzbar ist. Eine für Desktop-VS-Code entwickelte Erweiterung muss hier nicht funktionieren.
Entfernen
-
Sichere noch offene Änderungen als Dateien. Nicht gespeicherte Editorinhalte sind keine Datensicherung.
-
Entferne gegebenenfalls die installierte Web-App über das App-Menü deines Browsers. Das betrifft nur eine zuvor als App eingerichtete Verknüpfung.
-
Lösche bei Bedarf die Websitedaten von
vscode.devin den Browsereinstellungen. Dabei gehen dort gespeicherte Einstellungen verloren; gesicherte lokale Dateien bleiben bestehen. -
Prüfe im Browser die Liste installierter Web-Apps. Bei Nutzung als gewöhnlicher Tab ist keine Ubuntu-Deinstallation nötig.
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.
Zero to JupyterHub
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zero to JupyterHub beschreibt den Betrieb von JupyterHub in einem Kubernetes-Cluster.
Mit der Vorgabe, Programme ohne Container direkt auf Ubuntu zu installieren, ist dieser Weg nicht vereinbar. Der offizielle Aufbau verwendet Kubernetes, Helm und Container-Images. Eine Installation ohne Docker-Kommando bedeutet hier nicht, dass keine Container verwendet werden.
Die JupyterHub-Komponenten sind freie Software; Cluster, Speicher, Netzwerk und Administration verursachen dennoch Kosten. Die jeweiligen Projektlizenzen und die Lizenzen verwendeter Images sind getrennt zu beachten.
Vorgehen auf diesem Ubuntu-Rechner
-
Entscheide, ob die containerfreie Vorgabe weiter gilt. Unter dieser Vorgabe gibt es für Zero to JupyterHub keinen passenden lokalen Installationsbefehl.
-
Verwende für einen einzelnen dedizierten Server stattdessen das Kapitel The Littlest JupyterHub. Dieser Aufbau kommt ohne Kubernetes aus.
-
Ziehe bei ausdrücklich gewünschtem Kubernetes-Betrieb die offizielle Anleitung heran. Dafür sind vorab Clusterzugang, Speicherkonzept, Domain, TLS, Anmeldung und Ressourcenplanung festzulegen; allein die Installation von Helm erzeugt noch keinen JupyterHub.
Prüfen
-
Prüfe die gewählte Architektur: Ein Helm-Release mit Hub- und Notebook-Pods ist ein Containerbetrieb und erfüllt die lokale Vorgabe nicht.
-
Prüfe bei der TLJH-Alternative die Anmeldung und Notebook-Ausführung anhand des dortigen Kapitels.
Entfernen
-
Für dieses Kapitel ist keine Deinstallation erforderlich, da es keine Installation veranlasst.
-
Falls bereits ein unabhängig eingerichteter Cluster besteht, sichere dessen Benutzerdaten vor jedem Rückbau. Ein Helm-Uninstall allein entfernt nicht verlässlich alle Volumes, Datenträger oder kostenpflichtigen Cloud-Ressourcen; der Rückbau muss zum konkreten Cluster passen.
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.
The Littlest JupyterHub
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
The Littlest JupyterHub (TLJH) stellt mehreren Personen eigene Jupyter-Notebook-Sitzungen auf einem Server bereit.
TLJH ist freie Software unter BSD-3-Clause. Ein einzelner Server trägt alle Sitzungen; „bis etwa 100 Personen“ ist ein Planungsrahmen und hängt von gleichzeitiger Nutzung, RAM, CPU und Aufgaben ab. Für hundert rechenintensive Sitzungen genügt kein kleiner Standardrechner.
Die Systemanforderungen nennen aktuelle Ubuntu-/Debian-LTS-Systeme und amd64. Ubuntu 26.04 LTS passt zu diesem Rahmen; ein vollständiger Installationstest auf diesem System wurde für dieses Kapitel nicht durchgeführt.
Voraussetzungen
-
Stelle einen eigenen, frischen Ubuntu-26.04-Server mit sudo-Zugang bereit. Die Projektanleitung rät vom persönlichen Arbeitsplatzrechner ab. TLJH verändert unter anderem Konten und Systemdienste.
-
Erstelle vorab ein vollständiges Systemabbild oder einen Snapshot, den du wiederherstellen kannst. Dieser Wiederherstellungspunkt ist auch der vollständige Deinstallationsweg dieser Anleitung.
-
Begrenze eingehende Verbindungen zunächst mit der vorhandenen Router- oder Anbieter-Firewall auf deinen SSH-Zugang. Die Webports dürfen während der Einrichtung noch nicht öffentlich erreichbar sein, weil der Installer zunächst einen Webzugang ohne TLS bereitstellt.
-
Verbinde dich per SSH mit dem Server. Ersetze Benutzer und Adresse durch deine tatsächlichen Angaben. Die folgenden Installationsbefehle laufen dort.
ssh BENUTZER@SERVER
Installieren
-
Aktualisiere die Paketlisten.
sudo apt update -
Installiere die Werkzeuge für den Python-basierten Installer.
sudo apt install python3 python3-dev python3-venv git curl ca-certificates -
Lade den offiziellen Installer als Datei herunter, damit du ihn vor der Ausführung ansehen kannst.
curl --fail --location --output tljh-bootstrap.py https://tljh.jupyter.org/bootstrap.py -
Prüfe die heruntergeladene Datei vor der Ausführung mit Administratorrechten.
less tljh-bootstrap.py -
Installiere TLJH mit dem vorgesehenen Hub-Administratornamen. Ersetze
kursadminbei Bedarf durch deinen gewünschten neuen Hub-Namen. Die Installation benötigt Internetzugang und kann mehrere Minuten dauern.sudo python3 tljh-bootstrap.py --admin kursadmin -
Beschränke den HTTP-Zugang für den ersten Test auf die Loopback-Adresse des Servers.
sudo /opt/tljh/hub/bin/tljh-config set http.address 127.0.0.1 -
Lade die Proxy-Konfiguration neu, damit die Bindung wirksam wird.
sudo /opt/tljh/hub/bin/tljh-config reload proxyGrundlage ist die Adresskonfiguration. Die externe Firewall bleibt zunächst geschlossen.
-
Öffne auf deinem Ubuntu-Arbeitsrechner ein zweites Terminal und starte einen SSH-Tunnel. Er leitet den lokalen Port 8000 verschlüsselt zum Webzugang auf dem Server weiter.
ssh -N -L 127.0.0.1:8000:127.0.0.1:80 BENUTZER@SERVER -
Öffne auf dem Arbeitsrechner die weitergeleitete Adresse.
http://127.0.0.1:8000 -
Melde dich mit dem beim Installer angegebenen Hub-Namen an. Beim üblichen FirstUseAuthenticator legst du bei der ersten Anmeldung ein neues starkes Passwort fest. Wähle es selbst, bevor andere Personen Zugriff erhalten; siehe Anmeldung bei der ersten Nutzung.
Prüfen
-
Prüfe auf dem Server beide Kerndienste. Beide sollen „active“ melden.
systemctl is-active jupyterhub traefik -
Erstelle in JupyterLab ein Python-Notebook. Dadurch testest du auch den Start einer Benutzersitzung.
-
Führe in einer Notebook-Zelle das eigene Beispiel aus. Erwartet wird 42.
sum([12, 14, 16]) -
Füge weitere Personen gezielt über die Hub-Administration hinzu. Vermeide für einen Kurs eine unkontrolliert offene Registrierung.
HTTPS für gemeinsamen Zugriff
Für den öffentlichen Gruppenbetrieb brauchst du einen Domainnamen mit passendem DNS-Eintrag und erreichbare Ports 80 und 443. Bei einem ausschließlich internen Server sind stattdessen passende interne Zertifikate nötig. Die folgenden Schritte verwenden Let's Encrypt über TLJH. Führe die Befehle auf dem Server aus; ersetze die Beispieldaten vorher.
-
Aktiviere HTTPS in der Konfiguration.
sudo /opt/tljh/hub/bin/tljh-config set https.enabled true -
Hinterlege deine echte Kontaktadresse für Zertifikatsmeldungen.
sudo /opt/tljh/hub/bin/tljh-config set https.letsencrypt.email admin@example.org -
Trage deine tatsächlich auf diesen Server zeigende Domain ein.
sudo /opt/tljh/hub/bin/tljh-config add-item https.letsencrypt.domains hub.example.org -
Hebe die HTTP-Beschränkung auf Loopback auf, damit auch die Zertifikatsprüfung den vorgesehenen Endpunkt erreichen kann.
sudo /opt/tljh/hub/bin/tljh-config unset http.address -
Lade den Proxy mit den neuen Einstellungen neu.
sudo /opt/tljh/hub/bin/tljh-config reload proxy -
Erlaube in deiner vorhandenen Netzwerk-Firewall die eingehenden Ports 80 und 443 zum Server. Das ist für Erreichbarkeit und Zertifikatsausstellung nötig.
-
Öffne deine echte HTTPS-Adresse und prüfe das gültige Zertifikat vor einer Anmeldung. Bei Zertifikatsfehlern keine Zugangsdaten eingeben.
https://hub.example.org
Deinstallieren
TLJH wird nicht als einzelnes apt-Paket verwaltet. Der Installer legt Umgebungen unter /opt/tljh, Dienste, Benutzergruppen und weitere Systemdateien an; das Installer-Verzeichnis der Änderungen beschreibt diese Eingriffe. Nur den Ordner zu löschen wäre unvollständig.
-
Sichere alle seit der Installation entstandenen benötigten Notebooks und Daten außerhalb des Servers. Eine Wiederherstellung verwirft spätere Änderungen am ganzen System.
-
Stelle den vor der Installation erstellten Snapshot beziehungsweise das Systemabbild über deine Serververwaltung wieder her. Auf einem ausschließlich für TLJH eingerichteten Server ist alternativ eine frische Ubuntu-Installation möglich.
-
Prüfe nach der Wiederherstellung, dass die TLJH-Dienste fehlen. Erwartet wird eine Meldung über nicht vorhandene Units.
systemctl status jupyterhub.service traefik.service -
Entferne nicht mehr benötigte DNS- und Firewall-Einträge in den jeweiligen Verwaltungsoberflächen.
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.
xterm.js mit node-pty
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
xterm.js zeichnet ein Terminal im Browser; node-pty verbindet es mit einer echten Shell auf dem Ubuntu-Rechner.
Beide Bibliotheken sind freie Software unter MIT: xterm.js und node-pty. Sie ergeben erst mit eigenem Verbindungscode eine Anwendung. Das folgende selbst geschriebene Beispiel ist ein lokaler Versuch mit einer festen Größe von 80 Spalten und 24 Zeilen.
Die Shell besitzt sämtliche Rechte deines Benutzerkontos. Starte das Beispiel ohne sudo. Loopback-Bindung, ein zufälliger Sitzungsschlüssel und die Prüfung des Browser-Ursprungs begrenzen den Zugang. Es ist kein Mehrbenutzerdienst und keine Sandbox. Für einen Kurs mit fremdem Code braucht es eine andere Betriebsarchitektur; beachte die Sicherheitshinweise.
Einrichten
-
Aktualisiere die Paketlisten.
sudo apt update -
Installiere Node.js, npm und die Werkzeuge für native Erweiterungen.
sudo apt install nodejs npm build-essential python3 nano -
Prüfe die Node-Version. Verwende eine von node-pty unterstützte Node-LTS-Version; bei Ubuntu 26.04 ist Node 22 vorgesehen. Eine ungewöhnlich alte oder manuell installierte Version muss vorher korrigiert werden.
node --version -
Lege einen neuen Projektordner an. Der Name darf noch nicht für ein anderes Projekt verwendet werden.
mkdir ~/browserterminal-lokal -
Wechsle in den Projektordner.
cd ~/browserterminal-lokal -
Erzeuge die npm-Projektbeschreibung.
npm init -y -
Installiere die Bibliotheken im Benutzerprojekt. xterm.js empfiehlt npm; node-pty enthält native Bestandteile. Bewahre die entstehende package-lock.json auf, um die aufgelösten Versionen festzuhalten.
npm install --save-exact @xterm/xterm node-pty ws -
Öffne die neue Serverdatei und füge den folgenden eigenen Code ein. Speichere mit Strg+O, Enter und beende nano mit Strg+X.
nano server.cjs'use strict'; const http = require('node:http'); const fs = require('node:fs'); const path = require('node:path'); const { randomBytes } = require('node:crypto'); const { WebSocketServer, WebSocket } = require('ws'); const pty = require('node-pty'); const origin = 'http://127.0.0.1:8090'; const token = randomBytes(32).toString('hex'); const assets = new Map([ ['/', ['index.html', 'text/html; charset=utf-8']], ['/xterm.js', ['node_modules/@xterm/xterm/lib/xterm.js', 'text/javascript']], ['/xterm.css', ['node_modules/@xterm/xterm/css/xterm.css', 'text/css']] ]); const server = http.createServer((req, res) => { const asset = assets.get(req.url); if (req.headers.host !== '127.0.0.1:8090' || !asset || req.method !== 'GET') { res.writeHead(404).end(); return; } res.setHeader('Content-Type', asset[1]); res.setHeader('Cache-Control', 'no-store'); res.setHeader('X-Frame-Options', 'DENY'); fs.createReadStream(path.join(__dirname, asset[0])) .on('error', () => res.destroy()) .pipe(res); }); const sockets = new WebSocketServer({ noServer: true, maxPayload: 16384 }); server.on('upgrade', (req, socket, head) => { const url = new URL(req.url, origin); if (req.headers.host !== '127.0.0.1:8090' || req.headers.origin !== origin || url.pathname !== '/shell' || url.searchParams.get('token') !== token) { socket.destroy(); return; } sockets.handleUpgrade(req, socket, head, ws => { sockets.emit('connection', ws); }); }); sockets.on('connection', ws => { let shell; try { shell = pty.spawn('/bin/bash', ['--noprofile', '--norc'], { name: 'xterm-256color', cols: 80, rows: 24, cwd: process.env.HOME, env: process.env }); } catch { ws.close(1011, 'Shellstart fehlgeschlagen'); return; } shell.onData(data => { if (ws.readyState === WebSocket.OPEN) ws.send(data); }); ws.on('message', (data, binary) => { if (!binary) shell.write(data.toString()); }); const cleanup = () => { try { shell.kill(); } catch {} }; ws.on('close', cleanup); ws.on('error', cleanup); shell.onExit(() => ws.close()); }); server.listen(8090, '127.0.0.1', () => { console.log(origin + '/#' + token); }); -
Öffne die neue Browserdatei und füge den folgenden Inhalt ein. Speichere die Datei anschließend in nano.
nano index.html<!doctype html> <html lang="de"> <meta charset="utf-8"> <title>Lokales Übungsterminal</title> <link rel="stylesheet" href="/xterm.css"> <style>body { background: #181818; color: white; } #status { margin: 1em; }</style> <p id="status">Verbindung wird aufgebaut …</p> <div id="terminal"></div> <script src="/xterm.js"></script> <script> const token = location.hash.slice(1); history.replaceState(null, '', '/'); const term = new Terminal({ cols: 80, rows: 24 }); term.open(document.getElementById('terminal')); const status = document.getElementById('status'); const ws = new WebSocket('ws://' + location.host + '/shell?token=' + encodeURIComponent(token)); ws.onopen = () => { status.textContent = 'Verbunden'; term.focus(); }; ws.onmessage = event => term.write(event.data); ws.onclose = () => { status.textContent = 'Verbindung beendet'; }; ws.onerror = () => { status.textContent = 'Verbindungsfehler'; }; term.onData(data => { if (ws.readyState === WebSocket.OPEN) ws.send(data); }); </script> </html> -
Starte das Programm im Vordergrund. Port 8090 muss frei sein.
node server.cjs -
Öffne die im Terminal ausgegebene vollständige Adresse im Browser desselben Rechners. Der Teil hinter dem Rautezeichen ist der zufällige Zugangsschlüssel. Teile diesen Link nicht; ein Neustart erzeugt einen neuen Schlüssel. Nach dem Laden entfernt die Seite ihn aus der Adresszeile.
Prüfen
-
Gib im Browserterminal den folgenden Befehl ein. Er muss deinen normalen Benutzernamen ausgeben.
whoami -
Prüfe in einem zweiten Ubuntu-Terminal die Abhängigkeiten, damit ihre installierten Versionen dokumentiert sind.
npm --prefix ~/browserterminal-lokal ls --depth=0 -
Beende den Server mit Strg+C im Startterminal. Die Browserseite soll anschließend „Verbindung beendet“ anzeigen. Ein Neuladen ohne neuen vollständigen Link erhält keine Shell.
Deinstallieren
-
Beende den Server mit Strg+C, falls er noch läuft.
-
Sichere eigene Dateien aus dem Projektordner. In einer Shell gestartete Hintergrundprogramme sind gegebenenfalls gesondert zu beenden.
-
Lösche das Beispielprojekt einschließlich seiner lokalen npm-Pakete.
rm -rf -- ~/browserterminal-lokal -
Prüfe, ob der Projektordner entfernt wurde. Bei Erfolg bleibt die Ausgabe leer und der Rückgabestatus ist null.
test ! -e ~/browserterminal-lokal
Node.js und Build-Werkzeuge bleiben für andere Projekte installiert.
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.
Visual Studio Code
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Visual Studio Code (kurz VS Code) ist ein kostenloser Code-Editor von Microsoft mit grafischer Oberfläche. Er unterstützt viele Programmiersprachen und lässt sich über Erweiterungen an fast jede Aufgabe anpassen, etwa Git, Debugging oder Markdown-Vorschau.
Installation
VS Code ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung bindet deshalb das offizielle Paketarchiv von Microsoft ein. Der Vorteil: VS Code wird danach wie jedes andere Paket mit apt verwaltet und bei sudo apt upgrade automatisch aktualisiert. Eine Alternative über Snap steht weiter unten.
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme für die nächsten Schritte kennt.
sudo apt update
2. Hilfsprogramm installieren
wget lädt Dateien aus dem Internet herunter. Es ist meist schon vorhanden, dann meldet apt das nur.
sudo apt install wget
3. Schlüssel von Microsoft einrichten
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Microsoft stammen und nicht verändert wurden. wget speichert ihn mit -O direkt im Ordner für Paketschlüssel. apt liest die Textform mit der Endung .asc ohne Umwandlung.
sudo wget -O /usr/share/keyrings/microsoft.asc https://packages.microsoft.com/keys/microsoft.asc
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /usr/share/keyrings/microsoft.asc
4. Paketarchiv von Microsoft eintragen
Legt eine Datei an, die apt mitteilt, wo die VS-Code-Pakete liegen und mit welchem Schlüssel sie geprüft werden.
sudo nano /etc/apt/sources.list.d/vscode.sources
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64
Signed-By: /usr/share/keyrings/microsoft.asc
5. Paketlisten erneut aktualisieren
Jetzt liest apt auch das neue Paketarchiv ein.
sudo apt update
Prüfen: In der Ausgabe erscheint eine Zeile mit packages.microsoft.com/repos/code, ohne Fehlermeldung.
6. VS Code installieren
Installiert VS Code. Der Befehl zum Starten im Terminal heißt code.
sudo apt install code
Prüfen: Die erste Zeile der Ausgabe ist die Versionsnummer, z. B. 1.139.0.
code --version
Erste Schritte
7. VS Code starten
Öffnet VS Code. Alternativ findest du das Programm im Anwendungsmenü unter „Visual Studio Code“.
code
8. Deutsche Oberfläche einrichten
VS Code ist zunächst auf Englisch. Dieser Befehl installiert das offizielle deutsche Sprachpaket als Erweiterung.
code --install-extension MS-CEINTL.vscode-language-pack-de
Danach in VS Code Strg+Umschalt+P drücken, Configure Display Language eingeben, Deutsch auswählen und VS Code neu starten.
Prüfen: Die Menüs heißen jetzt „Datei“, „Bearbeiten“ usw.
9. Projektordner öffnen
VS Code arbeitet am besten mit ganzen Ordnern. Wechsle im Terminal in deinen Projektordner und öffne ihn mit code . (der Punkt steht für den aktuellen Ordner). Hier als Beispiel dieser Ordner mit den Anleitungen:
cd ~/Installieren
code .
Beim ersten Öffnen eines Ordners fragt VS Code, ob du den Autoren vertraust. Nur bei eigenen oder bekannten Projekten mit „Ja“ antworten, sonst können Erweiterungen dort Code ausführen.
10. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| Strg+Umschalt+P | Befehlspalette: jeden Befehl über seinen Namen suchen |
| Strg+P | Datei im Projekt schnell öffnen |
| Strg+S | Datei speichern |
| Strg+F | In der Datei suchen |
| Strg+H | In der Datei ersetzen |
| Strg+Umschalt+F | Im ganzen Projekt suchen |
| Strg+Ö | Terminal ein- und ausblenden |
| Strg+B | Seitenleiste ein- und ausblenden |
| Strg+Umschalt+X | Erweiterungen anzeigen und installieren |
Optional: VS Code für Git verwenden
11. VS Code als Editor für Git festlegen
Git öffnet für Commit-Nachrichten einen Editor. Mit dieser Einstellung ist das VS Code. --wait sorgt dafür, dass Git wartet, bis du den Tab mit der Nachricht schließt.
git config --global core.editor "code --wait"
Prüfen: Die Ausgabe lautet code --wait.
git config --global core.editor
Aktualisieren
VS Code wird zusammen mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Alternative: Installation über Snap
Statt über das Paketarchiv von Microsoft lässt sich VS Code auch als Snap installieren. Snaps aktualisieren sich selbstständig im Hintergrund. --classic ist nötig, weil ein Code-Editor auf alle Dateien und Programme zugreifen muss. Nutze nur einen der beiden Wege, nicht beide gleichzeitig.
sudo snap install code --classic
Prüfen:
code --version
Deinstallieren der Snap-Version:
sudo snap remove code
Deinstallieren
1. Git-Einstellung zurücksetzen
Entfernt VS Code als Git-Editor, falls du Schritt 11 ausgeführt hast. Git nutzt danach wieder den Standard-Editor des Systems.
git config --global --unset core.editor
2. VS Code entfernen
Entfernt das Programm.
sudo apt purge code
3. Paketarchiv und Schlüssel entfernen
Ohne diese Dateien sucht apt nicht mehr bei Microsoft nach Updates. microsoft.gpg stammt aus einer älteren Fassung dieser Anleitung. -f sorgt dafür, dass rm fehlende Dateien einfach überspringt.
sudo rm -f /etc/apt/sources.list.d/vscode.sources /usr/share/keyrings/microsoft.asc /usr/share/keyrings/microsoft.gpg
4. Paketlisten aktualisieren
Damit apt das entfernte Paketarchiv auch aus seinen Listen streicht.
sudo apt update
5. Eigene Einstellungen und Erweiterungen entfernen
VS Code speichert Einstellungen in ~/.config/Code und Erweiterungen in ~/.vscode. Achtung: Deine Einstellungen und alle installierten Erweiterungen gehen dabei verloren.
rm -rf ~/.config/Code ~/.vscode
Prüfen: Der Befehl wird nicht mehr gefunden.
code --version
Quellen und Lizenz
- Offizielle Dokumentation: https://code.visualstudio.com/docs
- Lizenz: Visual Studio Code steht unter der Microsoft Software License (Binär) / MIT (Quellcode).
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.
VSCodium
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
VSCodium ist ein Code-Editor, der aus demselben offenen Quellcode gebaut wird wie Visual Studio Code, aber ohne die Zusätze von Microsoft. Er sieht aus und funktioniert wie VS Code, sendet aber keine Nutzungsdaten (Telemetrie) an Microsoft und steht vollständig unter der freien MIT-Lizenz.
Vorbemerkungen
- Unterschied zu VS Code: Microsoft baut VS Code aus dem offenen Quellcode und fügt eigene Teile hinzu: Telemetrie, das Logo und die Anbindung an den eigenen Marktplatz für Erweiterungen. VSCodium lässt diese Teile weg. Einstellungen, Tastenkürzel und Bedienung sind gleich.
- Erweiterungen aus Open VSX: Den Marktplatz von Microsoft dürfen laut dessen Nutzungsbedingungen nur Microsoft-Produkte verwenden. VSCodium holt Erweiterungen deshalb von https://open-vsx.org, einem offenen Verzeichnis der Eclipse Foundation. Die meisten verbreiteten Erweiterungen gibt es dort auch. Einige Erweiterungen von Microsoft fehlen, z. B. Remote-SSH, Live Share und Pylance.
- Installation über das Paketarchiv: VSCodium ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung bindet das Paketarchiv ein, das auf https://vscodium.com für Debian und Ubuntu genannt wird. VSCodium wird danach mit
aptverwaltet und aktualisiert. Den Snapcodiumgibt es auch, er hinkt aber mehrere Monate hinterher (September 2026: Snap 1.105, Paketarchiv 1.135). - Neben VS Code: VSCodium verwendet eigene Ordner für Einstellungen und Erweiterungen und den Befehl
codium. Es lässt sich deshalb gleichzeitig mit VS Code installieren. - Version: Getestet mit VSCodium 1.135.06055 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme für die nächsten Schritte kennt.
sudo apt update
2. Hilfsprogramm installieren
wget lädt Dateien aus dem Internet herunter. Es ist meist schon vorhanden, dann meldet apt das nur.
sudo apt install wget
3. Schlüssel des Paketarchivs einrichten
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich aus dem VSCodium-Archiv stammen und nicht verändert wurden. wget speichert ihn mit -O direkt im Ordner für Paketschlüssel. Der Schlüssel liegt als Text vor, apt liest ihn mit der Endung .asc ohne Umwandlung.
sudo wget -O /usr/share/keyrings/vscodium.asc https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /usr/share/keyrings/vscodium.asc
4. Paketarchiv eintragen
Legt eine Datei an, die apt mitteilt, wo die VSCodium-Pakete liegen und mit welchem Schlüssel sie geprüft werden.
sudo nano /etc/apt/sources.list.d/vscodium.sources
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://download.vscodium.com/debs
Suites: vscodium
Components: main
Architectures: amd64
Signed-By: /usr/share/keyrings/vscodium.asc
5. Paketlisten erneut aktualisieren
Jetzt liest apt auch das neue Paketarchiv ein.
sudo apt update
Prüfen: In der Ausgabe erscheinen Zeilen mit https://download.vscodium.com/debs vscodium, ohne Fehlermeldung.
6. VSCodium installieren
Installiert VSCodium. Der Befehl zum Starten im Terminal heißt codium.
sudo apt install codium
Prüfen: Die erste Zeile der Ausgabe ist die Versionsnummer, z. B. 1.135.06055. Die ersten drei Stellen entsprechen der Version von VS Code, auf der VSCodium beruht.
codium --version
Erste Schritte
7. VSCodium starten
Öffnet VSCodium. Alternativ findest du das Programm im Anwendungsmenü unter „VSCodium“.
codium
8. Deutsches Sprachpaket installieren
VSCodium ist zunächst auf Englisch. Das deutsche Sprachpaket von Microsoft steht auch in Open VSX und lässt sich deshalb genauso installieren wie in VS Code.
codium --install-extension MS-CEINTL.vscode-language-pack-de
Prüfen: Die Ausgabe endet mit Extension 'ms-ceintl.vscode-language-pack-de' v… was successfully installed. Eine vorangehende Meldung DeprecationWarning kannst du übergehen.
9. Oberfläche auf Deutsch umstellen
Drücke in VSCodium Strg+Umschalt+P, gib Configure Display Language ein, wähle Deutsch aus und starte VSCodium neu.
Prüfen: Die Menüs heißen jetzt „Datei“, „Bearbeiten“ usw.
10. Projektordner öffnen
VSCodium arbeitet am besten mit ganzen Ordnern. Wechsle im Terminal in deinen Projektordner und öffne ihn mit codium . (der Punkt steht für den aktuellen Ordner). Hier als Beispiel dieser Ordner mit den Anleitungen:
cd ~/Installieren
codium .
Beim ersten Öffnen eines Ordners fragt VSCodium, ob du den Autoren vertraust. Antworte nur bei eigenen oder bekannten Projekten mit „Ja“, sonst können Erweiterungen dort Code ausführen.
11. Erweiterungen suchen
Drücke Strg+Umschalt+X. Die Seitenleiste zeigt die Erweiterungen aus Open VSX. Gib z. B. python ein und installiere eine Erweiterung mit Installieren. Den Namen einer Erweiterung (z. B. ms-python.python) kann man auch wie in Schritt 8 mit codium --install-extension angeben.
Prüfen: Die Liste aller installierten Erweiterungen enthält das Sprachpaket aus Schritt 8.
codium --list-extensions
Alle Tastenkürzel sind dieselben wie in VS Code. Eine Tabelle der wichtigsten steht in der Anleitung Visual Studio Code.
Optional: VSCodium für Git verwenden
12. VSCodium als Editor für Git festlegen
Git öffnet für Commit-Nachrichten einen Editor. Mit dieser Einstellung ist das VSCodium. --wait sorgt dafür, dass Git wartet, bis du den Tab mit der Nachricht schließt.
git config --global core.editor "codium --wait"
Prüfen: Die Ausgabe lautet codium --wait.
git config --global core.editor
Aktualisieren
VSCodium wird zusammen mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Deinstallieren
1. Git-Einstellung zurücksetzen
Entfernt VSCodium als Git-Editor, falls du Schritt 12 ausgeführt hast. Git nutzt danach wieder den Standard-Editor des Systems.
git config --global --unset core.editor
2. VSCodium entfernen
Entfernt das Programm.
sudo apt purge codium
3. Paketarchiv und Schlüssel entfernen
Ohne diese Dateien sucht apt nicht mehr im VSCodium-Archiv nach Updates.
sudo rm /etc/apt/sources.list.d/vscodium.sources /usr/share/keyrings/vscodium.asc
4. Paketlisten aktualisieren
Damit apt das entfernte Paketarchiv auch aus seinen Listen streicht.
sudo apt update
5. Eigene Einstellungen und Erweiterungen entfernen
VSCodium speichert Einstellungen in ~/.config/VSCodium und Erweiterungen in ~/.vscode-oss. Achtung: Deine Einstellungen und alle installierten Erweiterungen gehen dabei verloren. Die Ordner von VS Code (~/.config/Code und ~/.vscode) bleiben unberührt.
rm -rf ~/.config/VSCodium ~/.vscode-oss
Prüfen: Der Befehl wird nicht mehr gefunden.
codium --version
Quellen und Lizenz
- Offizielle Dokumentation: https://vscodium.com/
- Lizenz: VSCodium steht unter der MIT.
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.
Sublime Text
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Sublime Text ist ein schneller Code-Editor mit grafischer Oberfläche. Er startet in Sekundenbruchteilen, bleibt auch bei sehr großen Dateien flüssig und ist bekannt für Mehrfach-Cursor, die Befehlspalette und das schnelle Springen zu Dateien und Funktionen. Über Package Control lassen sich tausende Erweiterungen nachinstallieren.
Vorbemerkungen
- Lizenz: Sublime Text ist kein freies Programm. Man darf es kostenlos herunterladen und ausprobieren, für die dauerhafte Nutzung verlangt der Hersteller aber den Kauf einer Lizenz. Eine persönliche Lizenz kostet einmalig 99 US-Dollar und enthält drei Jahre Updates (Stand September 2026). Ohne Lizenz zeigt Sublime Text von Zeit zu Zeit einen Hinweis zum Kauf und in der Titelleiste
(UNREGISTERED). - Installation über das Paketarchiv: Sublime Text ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung bindet das offizielle Paketarchiv des Herstellers Sublime HQ ein. Sublime Text wird danach mit
aptverwaltet und aktualisiert. Es gibt auch einen Snapsublime-text, der aber nicht vom Hersteller stammt, sondern von der Community „Snapcrafters“. - Nur Englisch: Die Oberfläche von Sublime Text gibt es nur auf Englisch. Ein offizielles Sprachpaket gibt es nicht.
- Version: Getestet mit Sublime Text Build 4215 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme für die nächsten Schritte kennt.
sudo apt update
2. Hilfsprogramm installieren
wget lädt Dateien aus dem Internet herunter. Es ist meist schon vorhanden, dann meldet apt das nur.
sudo apt install wget
3. Schlüssel des Herstellers einrichten
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Sublime HQ stammen und nicht verändert wurden. Der Ordner /etc/apt/keyrings ist unter Ubuntu für Schlüssel gedacht, die man selbst hinzufügt. Der Schlüssel liegt als Text vor, apt liest ihn mit der Endung .asc ohne Umwandlung.
sudo wget -O /etc/apt/keyrings/sublimehq-pub.asc https://download.sublimetext.com/sublimehq-pub.gpg
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/sublimehq-pub.asc
4. Paketarchiv eintragen
Legt eine Datei an, die apt mitteilt, wo die Pakete liegen und mit welchem Schlüssel sie geprüft werden.
sudo nano /etc/apt/sources.list.d/sublime-text.sources
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://download.sublimetext.com/
Suites: apt/stable/
Signed-By: /etc/apt/keyrings/sublimehq-pub.asc
apt/stable/ ist der Kanal für fertige Versionen. Der Hersteller bietet zusätzlich einen Kanal apt/dev/ mit Vorabversionen an, der aber nur mit gekaufter Lizenz funktioniert. Die Zeile Components fehlt hier absichtlich: Das Archiv ist einfach aufgebaut und hat keine Unterteilung wie main.
5. Paketlisten erneut aktualisieren
Jetzt liest apt auch das neue Paketarchiv ein.
sudo apt update
Prüfen: In der Ausgabe erscheinen Zeilen mit https://download.sublimetext.com apt/stable/, ohne Fehlermeldung.
6. Sublime Text installieren
Installiert Sublime Text. Der Befehl zum Starten im Terminal heißt subl.
sudo apt install sublime-text
Prüfen: Die Ausgabe lautet Sublime Text Build 4215 oder nennt eine höhere Nummer.
subl --version
Erste Schritte
7. Sublime Text starten
Öffnet Sublime Text. Alternativ findest du das Programm im Anwendungsmenü unter „Sublime Text“.
subl
8. Projektordner öffnen
subl . öffnet den aktuellen Ordner. Die Seitenleiste links zeigt dann alle Dateien des Ordners. Hier als Beispiel dieser Ordner mit den Anleitungen:
cd ~/Installieren
subl .
Mit subl datei.md:12 öffnet Sublime Text eine Datei direkt in Zeile 12.
9. Package Control installieren
Package Control ist der Paketmanager für Erweiterungen. Er ist nicht vorinstalliert.
- Drücke Strg+Umschalt+P. Die Befehlspalette öffnet sich.
- Gib
Install Package Controlein und drücke Enter.
Prüfen: Nach einigen Sekunden meldet ein Fenster, dass Package Control installiert wurde. Im Menü Preferences gibt es jetzt den Eintrag Package Control.
10. Erweiterung installieren
- Drücke Strg+Umschalt+P.
- Gib
Package Control: Install Packageein und drücke Enter. - Gib den Namen einer Erweiterung ein, z. B.
MarkdownPreviewoderGitGutter, und drücke Enter.
Prüfen: Unten in der Statusleiste steht kurz, dass das Paket installiert wurde. Über Package Control: List Packages in der Befehlspalette siehst du alle installierten Erweiterungen.
11. Einstellungen ändern
Öffne Preferences → Settings. Links stehen die Voreinstellungen, rechts deine eigenen. Trage Änderungen nur rechts ein, z. B.:
{
"font_size": 12,
"tab_size": 4,
"translate_tabs_to_spaces": true
}
Sublime Text übernimmt die Einstellungen beim Speichern mit Strg+S sofort, ohne Neustart.
12. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| Strg+Umschalt+P | Befehlspalette: jeden Befehl über seinen Namen suchen |
| Strg+P | Datei im Projekt schnell öffnen |
| Strg+R | Zu einer Funktion oder Überschrift in der Datei springen |
| Strg+D | Nächstes Vorkommen des markierten Worts zusätzlich markieren (Mehrfach-Cursor) |
| Strg+Klick | Weiteren Cursor an die geklickte Stelle setzen |
| Strg+F | In der Datei suchen |
| Strg+Umschalt+F | Im ganzen Projekt suchen |
| Strg+K, Strg+B | Seitenleiste ein- und ausblenden |
Optional: Sublime Text für Git verwenden
13. Sublime Text als Editor für Git festlegen
Git öffnet für Commit-Nachrichten einen Editor. Mit dieser Einstellung ist das Sublime Text. -w (wait) sorgt dafür, dass Git wartet, bis du den Tab mit der Nachricht schließt.
git config --global core.editor "subl -w"
Prüfen: Die Ausgabe lautet subl -w.
git config --global core.editor
Lizenz eintragen
Hast du eine Lizenz gekauft, öffne Help → Enter License, füge den Lizenzschlüssel aus der E-Mail ein und klicke auf Use License. Der Hinweis (UNREGISTERED) in der Titelleiste verschwindet danach.
Aktualisieren
Sublime Text wird zusammen mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Deinstallieren
1. Git-Einstellung zurücksetzen
Entfernt Sublime Text als Git-Editor, falls du Schritt 13 ausgeführt hast. Git nutzt danach wieder den Standard-Editor des Systems.
git config --global --unset core.editor
2. Sublime Text entfernen
Entfernt das Programm.
sudo apt purge sublime-text
3. Paketarchiv und Schlüssel entfernen
Ohne diese Dateien sucht apt nicht mehr bei Sublime HQ nach Updates.
sudo rm /etc/apt/sources.list.d/sublime-text.sources /etc/apt/keyrings/sublimehq-pub.asc
4. Paketlisten aktualisieren
Damit apt das entfernte Paketarchiv auch aus seinen Listen streicht.
sudo apt update
5. Eigene Einstellungen und Erweiterungen entfernen
Sublime Text speichert Einstellungen, Erweiterungen und die Lizenz in ~/.config/sublime-text und den Zwischenspeicher in ~/.cache/sublime-text. Achtung: Deine Einstellungen, alle Erweiterungen und der eingetragene Lizenzschlüssel gehen dabei verloren.
rm -rf ~/.config/sublime-text ~/.cache/sublime-text
Prüfen: Der Befehl wird nicht mehr gefunden.
subl --version
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.
Kate
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Kate ist der Code-Editor des KDE-Projekts. Er ist freie Software, läuft auch unter GNOME und bringt viele Werkzeuge schon mit: Syntaxhervorhebung für mehrere hundert Sprachen, eine Projektansicht, Suche in Dateien, Git-Anzeige, ein eingebautes Terminal und einen LSP-Client, der mit Sprachservern Code-Vervollständigung und Fehleranzeige für viele Programmiersprachen liefert.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Kate 25.12.3 im Paket
kate. Es gibt auch einen Snap von KDE, der mit Version 25.08 aber älter ist. - KDE-Bibliotheken: Unter der Standardoberfläche GNOME installiert
aptrund 230 Pakete mit, vor allem Qt- und KDE-Bibliotheken, zusammen etwa 370 MB. Darauf zu verzichten (--no-install-recommends) spart nur wenig und lässt wichtige Teile weg: die Anbindung an Wayland, die deutschen Übersetzungen von Qt und die Darstellung von SVG-Symbolen. Diese Anleitung installiert Kate deshalb vollständig. - Deutsche Oberfläche: Kate übernimmt die Sprache des Systems. Unter einem deutschen Ubuntu sind Menüs und Einstellungen sofort auf Deutsch.
- Version: Getestet mit Kate 25.12.3 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Kate installieren
Installiert Kate samt der nötigen KDE-Bibliotheken. Lies die Liste der Pakete und bestätige mit J.
sudo apt install kate
Prüfen: Die letzte Zeile lautet kate 25.12.3. Eine Zeile QThreadStorage: entry 0 destroyed … davor ist nur ein Hinweis von Qt und kann übergangen werden.
kate --version
Erste Schritte
3. Kate starten
Öffnet Kate. Alternativ findest du das Programm im Anwendungsmenü unter „Kate“.
kate
Beim ersten Start zeigt Kate eine Willkommensseite mit den zuletzt geöffneten Dateien und Ordnern.
4. Datei aus dem Terminal öffnen
kate mit Dateinamen öffnet die Dateien in Kate. Läuft Kate schon, öffnen sie sich als neue Tabs im vorhandenen Fenster. Hier als Beispiel eine Anleitung aus diesem Buch:
kate ~/Installieren/src/kate.md
Mit kate -l 12 datei.md springt Kate direkt in Zeile 12.
5. Projektordner öffnen
Wähle Datei → Ordner öffnen … und dann z. B. den Ordner Installieren. Links erscheint die Projektansicht mit allen Dateien des Ordners. Ist der Ordner ein Git-Repository, zeigt Kate dort auch geänderte Dateien an, und in der Statusleiste steht der aktuelle Branch.
6. Eingebautes Terminal einrichten
Das Terminal-Panel von Kate braucht einen Baustein aus dem Terminalprogramm Konsole. Er ist nur vorgeschlagen und wird nicht automatisch installiert.
sudo apt install konsole-kpart
Starte Kate danach neu und drücke F4. Unten öffnet sich ein Terminal im Ordner der aktuellen Datei. F4 blendet es wieder aus.
7. Sprachserver für Python installieren
Der LSP-Client von Kate spricht mit Sprachservern, die eine Programmiersprache verstehen. Für Python kennt Kate den Server pylsp schon, er muss nur installiert sein.
sudo apt install python3-pylsp
Prüfen: Die Ausgabe nennt die Version, z. B. pylsp v1.14.0.
pylsp --version
Öffne danach in Kate eine Python-Datei. Kate startet den Sprachserver selbst. Beim Tippen erscheinen Vorschläge, Fehler werden unterstrichen, und Strg+Klick auf einen Namen springt zu seiner Definition. Passiert nichts, prüfe unter Einstellungen → Kate einrichten … → Module, ob LSP-Client eingeschaltet ist. Für andere Sprachen gibt es passende Pakete, z. B. clangd für C und C++ oder gopls für Go.
8. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| Strg+Alt+I | Befehlsleiste: jeden Befehl über seinen Namen suchen |
| Strg+Alt+O | Schnellöffnen: Datei aus dem Projekt oder den offenen Dateien suchen |
| Strg+G | Zu einer Zeile springen |
| Strg+F | In der Datei suchen |
| Strg+Alt+F | In Dateien suchen (ganzer Projektordner) |
| Alt+Klick | Weiteren Cursor an die geklickte Stelle setzen |
| F4 | Terminal ein- und ausblenden (nach Schritt 6) |
Unter Einstellungen → Kurzbefehle festlegen … lassen sich alle Tastenkürzel ansehen und ändern.
Optional: Kate für Git verwenden
9. Kate als Editor für Git festlegen
Git öffnet für Commit-Nachrichten einen Editor. Mit dieser Einstellung ist das Kate. -b (block) sorgt dafür, dass Git wartet, bis du die Datei in Kate schließt.
git config --global core.editor "kate -b"
Prüfen: Die Ausgabe lautet kate -b.
git config --global core.editor
Aktualisieren
Kate wird zusammen mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Deinstallieren
1. Git-Einstellung zurücksetzen
Entfernt Kate als Git-Editor, falls du Schritt 9 ausgeführt hast. Git nutzt danach wieder den Standard-Editor des Systems.
git config --global --unset core.editor
2. Kate und Zusatzpakete entfernen
Entfernt Kate und, falls installiert, das Terminal-Panel und den Python-Sprachserver aus Schritt 6 und 7. Nicht installierte Pakete meldet apt nur.
sudo apt purge kate konsole-kpart python3-pylsp
3. Nicht mehr benötigte Pakete entfernen
Entfernt die KDE- und Qt-Bibliotheken, die nur für Kate mitinstalliert wurden. Der Befehl entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
4. Eigene Einstellungen entfernen
Kate verteilt seine Dateien auf mehrere Orte: Einstellungen in ~/.config/katerc, ~/.config/katevirc, ~/.config/kate-externaltoolspluginrc und im Ordner ~/.config/kate, Sitzungen in ~/.local/share/kate den Fensterzustand in ~/.local/state/katestaterc und die Einstellung zur freiwilligen Rückmeldung an KDE in ~/.local/state/UserFeedback.org.kde.kate. Achtung: Deine Einstellungen und gespeicherten Sitzungen gehen dabei verloren.
rm -rf ~/.config/katerc ~/.config/katevirc ~/.config/kate-externaltoolspluginrc ~/.config/kate ~/.local/share/kate ~/.local/state/katestaterc ~/.local/state/UserFeedback.org.kde.kate
Prüfen: Der Befehl wird nicht mehr gefunden.
kate --version
Quellen und Lizenz
- Offizielle Dokumentation: https://kate-editor.org/
- Lizenz: Kate steht unter der LGPL-2.0-or-later.
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.
Geany
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Geany ist ein kleiner, schneller Code-Editor mit Funktionen einer Entwicklungsumgebung. Er startet sofort, braucht wenig Speicher und kann Programme mit einem Tastendruck übersetzen und ausführen. Geany ist freie Software, verwendet dieselbe Grafikbibliothek (GTK) wie der Ubuntu-Desktop und fügt sich deshalb gut in die Oberfläche ein.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Geany 2.1. Die Installation ist klein: Außer Geany kommt nur das Paket
geany-commonmit Symbolen, Übersetzungen und Sprachdefinitionen dazu. - Deutsche Oberfläche: Geany übernimmt die Sprache des Systems. Unter einem deutschen Ubuntu sind die Menüs sofort auf Deutsch.
- Plugins einzeln: Erweiterungen wie Git-Anzeige, Markdown-Vorschau oder ein LSP-Client stecken in eigenen Paketen
geany-plugin-…. Das Sammelpaketgeany-pluginswürde über 50 Pakete auf einmal installieren. Diese Anleitung installiert nur einzelne. - Version: Getestet mit Geany 2.1 (GTK 3.24) unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Geany installieren
sudo apt install geany
Prüfen: Die Ausgabe beginnt mit geany 2.1.
geany --version
Erste Schritte
3. Geany starten
Öffnet Geany. Alternativ findest du das Programm im Anwendungsmenü unter „Geany“.
geany
Das Fenster hat drei Bereiche: links die Seitenleiste mit der Symbolliste (Funktionen, Überschriften) und den offenen Dateien, in der Mitte den Editor und unten das Meldungsfenster mit den Reitern „Status“, „Compiler“, „Meldungen“, „Notizen“ und „Terminal“.
4. Datei aus dem Terminal öffnen
geany mit Dateinamen öffnet die Dateien in Geany. Läuft Geany schon, öffnen sie sich als neue Tabs im vorhandenen Fenster.
geany ~/Installieren/src/geany.md
Mit geany -l 12 datei.md springt Geany direkt in Zeile 12.
5. Eingebautes Terminal für Programme verwenden
Geany startet Programme zum Ausprobieren standardmäßig in einem eigenen Terminalfenster. Bequemer ist das eingebaute Terminal im Reiter „Terminal“ unten.
- Öffne Bearbeiten → Einstellungen.
- Wähle links Terminal.
- Setze den Haken bei Führe Programme in der VTE aus und klicke auf OK.
Ein Programm übersetzen und ausführen
6. Compiler installieren (für das Beispiel)
Das Beispiel ist ein kleines C-Programm. Geany ruft zum Übersetzen den Compiler gcc auf. Ist er schon vorhanden, etwa aus der C-Anleitung, meldet apt das nur.
sudo apt install build-essential
7. Beispieldatei anlegen
Wähle Datei → Neu, füge diesen Inhalt ein und speichere die Datei mit Strg+S als hallo.c in deinem Home-Ordner. Die Endung .c sagt Geany, dass es sich um C handelt. Erst danach färbt Geany den Code ein und kennt die passenden Befehle zum Übersetzen.
#include <stdio.h>
int main(void)
{
printf("Hallo aus Geany!\n");
return 0;
}
Prüfen: In der Symbolliste links erscheint unter „Funktionen“ der Eintrag main.
8. Programm erstellen
Drücke F9 (Erstellen → Erstellen). Geany führt dafür gcc -Wall -o "hallo" "hallo.c" aus und legt die Programmdatei hallo neben hallo.c ab.
Prüfen: Unten im Reiter „Compiler“ steht am Ende Kompilierung erfolgreich beendet. Bei Fehlern zeigt Geany sie dort mit Zeilennummer an, ein Doppelklick springt zur Stelle im Code.
9. Programm ausführen
Drücke F5 (Erstellen → Ausführen).
Prüfen: Im Reiter „Terminal“ erscheint Hallo aus Geany!.
Die Befehle hinter F8 (Kompilieren), F9 (Erstellen) und F5 (Ausführen) legt Geany je Sprache fest. Unter Erstellen → Kommandos zum Erstellen konfigurieren lassen sie sich ändern. Die Platzhalter %f und %e stehen dort für den Dateinamen mit und ohne Endung.
10. Python-Befehl anpassen (bei Bedarf)
Für Python-Dateien führt F5 ab Werk den Befehl python "%f" aus. Unter Ubuntu heißt der Befehl aber python3. Ein python gibt es nur, wenn das Paket python-is-python3 installiert ist. Öffne deshalb eine Python-Datei, wähle Erstellen → Kommandos zum Erstellen konfigurieren und ändere im unteren Bereich beim Eintrag Ausführen den Befehl in:
python3 "%f"
Plugins
11. Nützliche Plugins installieren
Drei einzelne Plugins als Beispiel:
geany-plugin-git-changebar– zeigt am Rand, welche Zeilen seit dem letzten Git-Commit geändert wurdengeany-plugin-markdown– zeigt eine Vorschau von Markdown-Dateiengeany-plugin-lsp– verbindet Geany mit Sprachservern für Vervollständigung und Fehleranzeige, z. B.python3-pylspfür Python oderclangdfür C
sudo apt install geany-plugin-git-changebar geany-plugin-markdown geany-plugin-lsp
12. Plugins einschalten
Installierte Plugins sind zunächst aus. Öffne in Geany Werkzeuge → Plugin-Verwaltung, setze bei den gewünschten Plugins den Haken und klicke auf OK. Über die Schaltfläche Einstellungen in der Plugin-Verwaltung lassen sich die Plugins einrichten.
Die wichtigsten Tastenkürzel
| Tasten | Wirkung |
|---|---|
| F8 | Aktuelle Datei kompilieren |
| F9 | Programm erstellen |
| F5 | Programm ausführen |
| Strg+F | In der Datei suchen |
| Strg+H | Ersetzen |
| Strg+L | Zu einer Zeile springen |
| Strg+E | Zeile oder Auswahl aus- oder einkommentieren |
| Strg+Leertaste | Wortvervollständigung anzeigen |
Unter Bearbeiten → Einstellungen → Tastenkürzel lassen sich alle Tastenkürzel ansehen und ändern.
Aktualisieren
Geany wird zusammen mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Deinstallieren
1. Beispiel entfernen
Löscht die Beispieldatei und das daraus erstellte Programm, falls du Schritt 7 bis 9 ausgeführt hast.
rm -f ~/hallo.c ~/hallo
2. Geany und Plugins entfernen
Entfernt Geany und die Plugins aus Schritt 11. Nicht installierte Pakete meldet apt nur.
sudo apt purge geany geany-plugin-git-changebar geany-plugin-markdown geany-plugin-lsp
3. Nicht mehr benötigte Pakete entfernen
Entfernt geany-common und die Bibliotheken der Plugins. Der Befehl entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
4. Eigene Einstellungen entfernen
Geany speichert Einstellungen, Sitzung und eigene Befehle zum Erstellen im Ordner ~/.config/geany. Achtung: Deine Einstellungen gehen dabei verloren.
rm -rf ~/.config/geany
Prüfen: Der Befehl wird nicht mehr gefunden.
geany --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.geany.org/documentation/
- Lizenz: Geany steht unter der GPL-2.0-or-later.
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.
Zed
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zed ist ein junger, sehr schneller Code-Editor, geschrieben in Rust von den Entwicklern, die früher den Editor Atom gebaut haben. Er zeichnet seine Oberfläche direkt mit der Grafikkarte, bringt Sprachserver (LSP) für viele Sprachen, ein Terminal und Git-Anzeige schon mit und hat eingebaute Funktionen für Zusammenarbeit in Echtzeit und für KI-Assistenten.
Vorbemerkungen
- Keine Pakete von Ubuntu: Zed gibt es weder in den Ubuntu-Paketquellen noch als Snap, und der Hersteller betreibt kein Paketarchiv. Diese Anleitung verwendet deshalb das offizielle Installationsskript von https://zed.dev. Es lädt ein Archiv herunter und entpackt es in den eigenen Home-Ordner.
sudoist dafür nicht nötig. - Wohin Zed installiert wird: Das Programm liegt danach in
~/.local/zed.app(rund 330 MB). Dazu kommen der Befehl~/.local/bin/zedals Verknüpfung und ein Eintrag im Anwendungsmenü. Ubuntu nimmt~/.local/binbeim Anmelden selbst in den Suchpfad auf, wenn der Ordner existiert. - Updates: Zed aktualisiert sich selbst. Eine neue Version lädt es im Hintergrund und bietet den Neustart an. Über
apt upgradewird Zed nicht aktualisiert. - Grafikkarte: Zed braucht eine Grafikkarte mit Vulkan-Unterstützung. Das ist bei aktuellen Rechnern mit Intel-, AMD- oder NVIDIA-Grafik der Normalfall. In virtuellen Maschinen ohne Grafikbeschleunigung startet Zed unter Umständen nicht.
- Nur Englisch: Die Oberfläche von Zed gibt es nur auf Englisch.
- Telemetrie: Zed sendet ab Werk Fehlerberichte und anonyme Nutzungsdaten an den Hersteller. Schritt 8 zeigt, wie man das abschaltet.
- Version: Getestet mit Zed 1.21.0 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. curl installieren
curl lädt das Installationsskript und danach Zed selbst herunter. Ist es schon vorhanden, meldet apt das nur.
sudo apt install curl
3. Installationsskript herunterladen
Speichert das Skript zuerst als Datei. So kannst du vor dem Ausführen nachsehen, was es tut, statt es ungesehen aus dem Internet zu starten.
curl -fsSL -o ~/zed-install.sh https://zed.dev/install.sh
4. Skript ansehen (optional)
Zeigt das Skript seitenweise an. Mit den Pfeiltasten blätterst du, mit Q beendest du die Anzeige. Der Teil linux() lädt das Archiv von cloud.zed.dev, entpackt es nach ~/.local, legt die Verknüpfung ~/.local/bin/zed an und kopiert den Menüeintrag nach ~/.local/share/applications.
less ~/zed-install.sh
5. Skript ausführen
Lädt Zed (rund 125 MB) herunter und installiert es für deinen Benutzer.
sh ~/zed-install.sh
Prüfen: Die letzte Zeile lautet Zed has been installed. Run with 'zed'. Steht dort stattdessen To run Zed from your terminal, you must add ~/.local/bin to your PATH, gab es den Ordner ~/.local/bin vorher noch nicht. Melde dich dann einmal ab und wieder an, danach findet die Shell den Befehl.
6. Skript löschen
Das Skript wird nicht mehr gebraucht.
rm ~/zed-install.sh
Prüfen: Die Ausgabe beginnt mit Zed 1.21.0 oder nennt eine neuere Version.
zed --version
Erste Schritte
7. Projektordner öffnen
zed mit einem Ordner öffnet ihn als Projekt. Links erscheint die Dateiliste. Beim ersten Start fragt Zed nach Farbschema, Tastenbelegung (z. B. wie in VS Code oder mit Vim-Modus) und ob du dich anmelden möchtest. Für den Editor selbst ist keine Anmeldung nötig, nur für Zusammenarbeit und die KI-Dienste von Zed. Hier als Beispiel dieser Ordner mit den Anleitungen:
zed ~/Installieren
Mit zed datei.md:12 öffnet Zed eine Datei direkt in Zeile 12. Alternativ startest du Zed über das Anwendungsmenü unter „Zed“.
8. Telemetrie abschalten
Einstellungen stehen in Zed in der Datei ~/.config/zed/settings.json. Drücke in Zed Strg+, und wähle, falls Zed eine Oberfläche mit Schaltern zeigt, oben Edit in settings.json. Ergänze zwischen den äußeren geschweiften Klammern:
"telemetry": {
"diagnostics": false,
"metrics": false
},
diagnostics sind Absturz- und Fehlerberichte, metrics anonyme Nutzungsdaten. Speichere mit Strg+S. Zed übernimmt Einstellungen sofort, ohne Neustart. Fehler in der Datei, etwa ein fehlendes Komma, zeigt Zed unten in der Statusleiste an.
9. Die wichtigsten Tastenkürzel kennenlernen
In der Voreinstellung verwendet Zed dieselben Tastenkürzel wie VS Code:
| Tasten | Wirkung |
|---|---|
| Strg+Umschalt+P | Befehlspalette: jeden Befehl über seinen Namen suchen |
| Strg+P | Datei im Projekt schnell öffnen |
| Strg+, | Einstellungen öffnen |
| Strg+F | In der Datei suchen |
| Strg+Umschalt+F | Im ganzen Projekt suchen |
| Strg+Umschalt+X | Erweiterungen anzeigen und installieren |
Das Terminal öffnest du über die Befehlspalette mit terminal panel: toggle. Dort steht auch das Tastenkürzel, das Zed für deine Tastatur verwendet.
10. Sprachunterstützung
Öffnest du eine Datei in einer Sprache wie Python, Rust, Go oder TypeScript, lädt Zed den passenden Sprachserver meist selbst herunter und zeigt danach Vervollständigung und Fehler an. Für weitere Sprachen und Farbschemata gibt es Erweiterungen, die du über Strg+Umschalt+X suchst und installierst. Sprachserver und Erweiterungen landen in ~/.local/share/zed.
Optional: Zed für Git verwenden
11. Zed als Editor für Git festlegen
Git öffnet für Commit-Nachrichten einen Editor. Mit dieser Einstellung ist das Zed. --wait sorgt dafür, dass Git wartet, bis du den Tab mit der Nachricht schließt.
git config --global core.editor "zed --wait"
Prüfen: Die Ausgabe lautet zed --wait.
git config --global core.editor
Deinstallieren
1. Git-Einstellung zurücksetzen
Entfernt Zed als Git-Editor, falls du Schritt 11 ausgeführt hast. Git nutzt danach wieder den Standard-Editor des Systems.
git config --global --unset core.editor
2. Zed entfernen
Zed bringt eine eigene Deinstallation mit. Sie entfernt ~/.local/zed.app, die Verknüpfung ~/.local/bin/zed und den Menüeintrag. Danach fragt sie Do you want to keep your Zed preferences? [Y/n]. Enter behält deine Einstellungen, n und Enter löscht auch ~/.config/zed und ~/.local/share/zed samt Erweiterungen und Sprachservern.
zed --uninstall
Prüfen: Die Ausgabe endet mit Zed has been uninstalled. Die Shell meldet danach, dass der Befehl zed nicht gefunden wurde.
zed --version
Quellen und Lizenz
- Offizielle Dokumentation: https://zed.dev/docs
- Lizenz: Zed steht unter der GPL-3.0 / Apache-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.
Monaco Editor
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Monaco Editor ist eine unter MIT lizenzierte JavaScript-Komponente zum Bearbeiten von Quellcode im Browser.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Node.js kommt über apt, die JavaScript-Pakete werden im eigenen Projekt ohne sudo installiert. Verwende einen noch nicht vorhandenen Projektordner.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketstände.
sudo apt update
2. Werkzeuge installieren
Node.js führt die Werkzeuge aus; npm verwaltet die Projektpakete. Python stellt später die lokale Vorschau bereit.
sudo apt install nodejs npm python3
3. Node.js prüfen
Verwende Node.js 22.12 oder neuer innerhalb einer unterstützten LTS-Version. Ubuntu 26.04 liefert Node.js 22.22.1. Bei einer älteren Ausgabe hier anhalten und die aktive Node.js-Installation prüfen.
node --version
4. Projektordner anlegen
Trennt die Beispieldateien von anderen Projekten.
mkdir ~/monaco-demo
5. Projektordner öffnen
Die folgenden relativen Dateipfade beziehen sich auf diesen Ordner.
cd ~/monaco-demo
6. npm-Projekt initialisieren
Erzeugt package.json als Verzeichnis der Projektabhängigkeiten.
npm init -y
Monaco unterstützt laut Hersteller keine Mobilbrowser. Das Beispiel verwendet einen Desktopbrowser. Der Editor bearbeitet Quellcode; zum Ausführen wäre ein getrennt eingerichteter Dienst wie Judge0 nötig.
7. Vite installieren
Vite verarbeitet JavaScript-Module und baut die fertige Browseranwendung.
npm install --save-dev vite
8. Editor installieren
Lädt die geprüfte Editorversion 0.57.0 in dieses Projekt. Die Importpfade unten passen zu dieser Version.
npm install monaco-editor@0.57.0
9. HTML-Seite anlegen
Legt ein beschriftetes Element für den Editor und den Einstiegspunkt an.
cat > index.html <<'EOF'
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Monaco Editor lokal</title>
</head>
<body>
<h1>Mein Quelltext</h1>
<div id="editor" aria-label="Quelltexteditor"></div>
<script type="module" src="/main.js"></script>
</body>
</html>
EOF
10. Editor einrichten
Bindet Monaco mit JavaScript-Färbung und dem allgemeinen Editor-Worker ein. Umfangreiche Sprachdienste wie TypeScript-Diagnosen sind in diesem kleinen Beispiel nicht eingerichtet.
cat > main.js <<'EOF'
import * as monaco from 'monaco-editor/editor/editor.api.js';
import 'monaco-editor/basic-languages/monaco.contribution.js';
import EditorWorker from 'monaco-editor/editor/editor.worker.js?worker';
self.MonacoEnvironment = {
getWorker() { return new EditorWorker(); }
};
const container = document.querySelector('#editor');
container.style.height = '65vh';
monaco.editor.create(container, {
value: '// Hier kannst du JavaScript schreiben.\nconst gruss = "Hallo Ubuntu";\n',
language: 'javascript',
automaticLayout: true,
minimap: { enabled: false }
});
EOF
11. Entwicklungsvorschau starten
Öffne http://127.0.0.1:5173. Prüfe Texteingabe, Syntaxfarben und Rückgängig mit Strg + Z. Die Browserkonsole soll keine Ladefehler zeigen. Beende Vite danach mit Strg + C.
npx vite --host 127.0.0.1 --port 5173 --strictPort
12. Browseranwendung bauen
Erzeugt den Ordner dist. Ein erfolgreicher Bau bestätigt, dass die Module aufgelöst werden können.
npx vite build
13. Fertige Anwendung prüfen
Öffne http://127.0.0.1:4173 und wiederhole die Eingabeprüfung. Lade die Seite über HTTP, damit auch Monacos Worker funktionieren. Strg + C beendet die Vorschau.
npx vite preview --host 127.0.0.1 --port 4173 --strictPort
Installation prüfen
1. Paketstände anzeigen
Zeigt die tatsächlich installierten Versionen. Bewahre package-lock.json auf; mit npm ci lässt sich derselbe Paketstand erneut installieren.
npm ls monaco-editor vite
Deinstallieren
Beende zuerst eine laufende Vorschau mit Strg + C. Node.js und npm bleiben für andere Projekte verfügbar.
1. Beispielprojekt entfernen
Löscht das gesamte Beispiel einschließlich eigener Änderungen. Sichere benötigte Dateien vorher.
rm -rf -- ~/monaco-demo
2. Entfernung prüfen
Bei erfolgreicher Entfernung erscheint die Bestätigung.
test ! -e ~/monaco-demo && echo 'Projekt entfernt'
Quellen und Lizenz
Monaco-Projekt und MIT-Lizenz, Einbindung als ES-Modul und Vite. Die Konfiguration beschränkt sich bewusst auf den allgemeinen Worker. Bei Weitergabe die mitgelieferten Lizenzhinweise erhalten.
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.
CodeMirror 6
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
CodeMirror 6 ist eine unter MIT lizenzierte JavaScript-Komponente zum Bearbeiten von Quellcode im Browser.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Node.js kommt über apt, die JavaScript-Pakete werden im eigenen Projekt ohne sudo installiert. Verwende einen noch nicht vorhandenen Projektordner.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketstände.
sudo apt update
2. Werkzeuge installieren
Node.js führt die Werkzeuge aus; npm verwaltet die Projektpakete. Python stellt später die lokale Vorschau bereit.
sudo apt install nodejs npm python3
3. Node.js prüfen
Verwende Node.js 22.12 oder neuer innerhalb einer unterstützten LTS-Version. Ubuntu 26.04 liefert Node.js 22.22.1. Bei einer älteren Ausgabe hier anhalten und die aktive Node.js-Installation prüfen.
node --version
4. Projektordner anlegen
Trennt die Beispieldateien von anderen Projekten.
mkdir ~/codemirror-demo
5. Projektordner öffnen
Die folgenden relativen Dateipfade beziehen sich auf diesen Ordner.
cd ~/codemirror-demo
6. npm-Projekt initialisieren
Erzeugt package.json als Verzeichnis der Projektabhängigkeiten.
npm init -y
CodeMirror 6 lässt sich auch für mobile Oberflächen einsetzen. Prüfe dabei die Bildschirmtastatur und Touch-Bedienung auf deinen Zielgeräten. Das Beispiel bearbeitet JavaScript, führt es aber nicht aus.
7. Vite installieren
Vite verarbeitet JavaScript-Module und baut die fertige Browseranwendung.
npm install --save-dev vite
8. Editor installieren
Lädt die Editorbibliothek in dieses Projekt.
npm install codemirror @codemirror/lang-javascript
9. HTML-Seite anlegen
Legt ein beschriftetes Element für den Editor und den Einstiegspunkt an.
cat > index.html <<'EOF'
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>CodeMirror 6 lokal</title>
</head>
<body>
<h1>Mein Quelltext</h1>
<div id="editor" aria-label="Quelltexteditor"></div>
<script type="module" src="/main.js"></script>
</body>
</html>
EOF
10. Editor einrichten
Aktiviert Zeilennummern, übliche Editorbefehle und die JavaScript-Sprachunterstützung.
cat > main.js <<'EOF'
import { EditorView, basicSetup } from 'codemirror';
import { javascript } from '@codemirror/lang-javascript';
new EditorView({
parent: document.querySelector('#editor'),
doc: '// Bearbeite diesen Quelltext.\nconst meldung = "Ubuntu bereit";\n',
extensions: [
basicSetup,
javascript(),
EditorView.theme({ '&': { height: '65vh', border: '1px solid #888' } })
]
});
EOF
11. Entwicklungsvorschau starten
Öffne http://127.0.0.1:5173. Prüfe Texteingabe, Syntaxfarben und Rückgängig mit Strg + Z. Die Browserkonsole soll keine Ladefehler zeigen. Beende Vite danach mit Strg + C.
npx vite --host 127.0.0.1 --port 5173 --strictPort
12. Browseranwendung bauen
Erzeugt den Ordner dist. Ein erfolgreicher Bau bestätigt, dass die Module aufgelöst werden können.
npx vite build
13. Fertige Anwendung prüfen
Öffne http://127.0.0.1:4173 und wiederhole die Eingabeprüfung. Lade die Seite über HTTP, damit auch Monacos Worker funktionieren. Strg + C beendet die Vorschau.
npx vite preview --host 127.0.0.1 --port 4173 --strictPort
Installation prüfen
1. Paketstände anzeigen
Zeigt die tatsächlich installierten Versionen. Bewahre package-lock.json auf; mit npm ci lässt sich derselbe Paketstand erneut installieren.
npm ls codemirror @codemirror/lang-javascript vite
Deinstallieren
Beende zuerst eine laufende Vorschau mit Strg + C. Node.js und npm bleiben für andere Projekte verfügbar.
1. Beispielprojekt entfernen
Löscht das gesamte Beispiel einschließlich eigener Änderungen. Sichere benötigte Dateien vorher.
rm -rf -- ~/codemirror-demo
2. Entfernung prüfen
Bei erfolgreicher Entfernung erscheint die Bestätigung.
test ! -e ~/codemirror-demo && echo 'Projekt entfernt'
Quellen und Lizenz
CodeMirror-Systemübersicht, Referenz und Vite. Die CodeMirror-Pakete stehen unter MIT. Bei Weitergabe die mitgelieferten Lizenzhinweise erhalten.
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.
IntelliJ IDEA
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
IntelliJ IDEA ist eine Entwicklungsumgebung (IDE) von JetBrains, vor allem für Java und Kotlin. Sie bietet intelligente Codevervollständigung, Refactoring, einen Debugger und eingebaute Unterstützung für Maven, Gradle und Git.
Vorbemerkungen
- Eine Version für alle: IntelliJ IDEA gibt es seit Version 2025.3 nur noch als ein gemeinsames Produkt. Die frühere „Community Edition“ ist darin aufgegangen: Ihr Funktionsumfang bleibt kostenlos, auch für kommerzielle Projekte. Weitere Funktionen (früher „Ultimate“) erfordern ein Abo, das 30 Tage kostenlos getestet werden kann.
- Kein apt-Paket: In den Ubuntu-Paketquellen gibt es Pakete wie
libintellij-platform-api-java. Das sind nur Programmbibliotheken aus der IntelliJ-Plattform, auf der alle JetBrains-IDEs aufbauen, nicht die IDE selbst. Diese Anleitung installiert IntelliJ IDEA deshalb als Snap. Das Snap wird von JetBrains selbst veröffentlicht. - Speicherplatz: Das Snap ist knapp 2 GB groß.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des Java-Entwicklungspakets im nächsten Schritt kennt.
sudo apt update
2. Java-Entwicklungspaket (JDK) installieren
IntelliJ IDEA bringt für sich selbst eine eigene Java-Laufzeit mit. Um eigene Java-Programme zu übersetzen und auszuführen, brauchst du aber ein JDK. default-jdk installiert die aktuelle Java-Version mit Langzeitunterstützung aus den Ubuntu-Paketquellen (derzeit Java 25).
sudo apt install default-jdk
Prüfen: Die Ausgabe nennt die Java-Version, z. B. javac 25.
javac -version
3. IntelliJ IDEA installieren
Installiert IntelliJ IDEA als Snap. --classic ist nötig, weil eine IDE uneingeschränkt auf deine Dateien, das JDK und andere Programme zugreifen muss.
sudo snap install intellij-idea --classic
Prüfen: Die Ausgabe zeigt Name, Version (z. B. 2026.2.3) und als Herausgeber jetbrains.
snap list intellij-idea
Erste Schritte
4. IntelliJ IDEA starten
Öffne das Anwendungsmenü und starte IntelliJ IDEA. Beim ersten Start fragt das Programm nach den Nutzungsbedingungen und ob anonyme Nutzungsdaten gesendet werden dürfen. Das Senden kannst du ablehnen.
Prüfen: Es erscheint der Willkommensbildschirm mit den Schaltflächen New Project und Open.
5. Kostenlose Nutzung wählen
Wenn IntelliJ IDEA nach einer Lizenz fragt, wähle die kostenlose Nutzung (nicht die Testversion des Abos). Damit stehen alle Grundfunktionen dauerhaft zur Verfügung. Das Abo kannst du später jederzeit über Help → Register freischalten.
6. Deutsche Oberfläche einrichten
Die Oberfläche ist zunächst auf Englisch. Öffne im Willkommensbildschirm Customize → Language (oder in einem Projekt File → Settings → Appearance & Behavior → System Settings → Language and Region), wähle Deutsch und starte IntelliJ IDEA neu. Fehlt Deutsch in der Liste, installiere zuerst unter Plugins das Sprachpaket „German Language Pack“.
7. Erstes Projekt anlegen
Klicke auf New Project. Wähle als Sprache Java und als Build-System Maven oder Gradle. Unter JDK sollte das in Schritt 2 installierte JDK erscheinen (Pfad /usr/lib/jvm/...). Mit Create wird das Projekt angelegt.
Prüfen: Öffne die Datei Main.java und klicke auf den grünen Pfeil neben main. Unten im Ausführungsfenster erscheint die Ausgabe des Programms.
8. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| 2 × Umschalt | Überall suchen: Dateien, Klassen, Aktionen, Einstellungen |
| Strg+Umschalt+A | Aktion über ihren Namen suchen |
| Alt+Enter | Lösungsvorschläge für die markierte Stelle anzeigen |
| Strg+Leertaste | Codevervollständigung |
| Umschalt+F10 | Programm ausführen |
| Umschalt+F9 | Programm im Debugger ausführen |
| Strg+Alt+L | Code formatieren |
| Umschalt+F6 | Umbenennen (überall im Projekt) |
| Alt+F12 | Terminal ein- und ausblenden |
Hinweis: Strg+Alt+L sperrt unter Ubuntu eventuell den Bildschirm, bevor IntelliJ IDEA die Tasten erhält. In diesem Fall formatierst du den Code über Code → Reformat Code.
Optional: Mehr Dateien überwachen
9. Grenze für Dateiüberwachung erhöhen
IntelliJ IDEA lässt sich vom System melden, wenn sich Dateien im Projekt ändern. Bei großen Projekten reicht die Voreinstellung von Ubuntu dafür nicht aus, dann erscheint ein Hinweis „External file changes sync might be slow“. Nur in diesem Fall ist der Schritt nötig. Die Datei unter /etc/sysctl.d hebt die Grenze dauerhaft an.
sudo nano /etc/sysctl.d/60-jetbrains.conf
Die Datei ist neu und leer. Füge diese Zeile ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
fs.inotify.max_user_watches = 524288
10. Neue Grenze sofort übernehmen
Lädt die Einstellungen neu, damit du nicht neu starten musst. Danach IntelliJ IDEA neu starten.
sudo sysctl --system
Prüfen: Die Ausgabe lautet 524288.
cat /proc/sys/fs/inotify/max_user_watches
Aktualisieren
Snaps aktualisieren sich automatisch im Hintergrund. Sofort aktualisieren kannst du mit:
sudo snap refresh intellij-idea
Deinstallieren
1. IntelliJ IDEA entfernen
Entfernt das Snap. --purge verhindert, dass Snap vorher eine Sicherungskopie der Snap-Daten anlegt.
sudo snap remove --purge intellij-idea
2. Einstellungen, Plugins und Zwischenspeicher entfernen
IntelliJ IDEA speichert seine Daten in Ordnern, deren Name mit IntelliJIdea beginnt, gefolgt von der Version. Ordner anderer JetBrains-Programme (z. B. der Toolbox) bleiben erhalten. Achtung: Deine IDE-Einstellungen und installierten Plugins gehen verloren. Deine Projekte selbst werden nicht gelöscht.
rm -rf ~/.config/JetBrains/IntelliJIdea* ~/.cache/JetBrains/IntelliJIdea* ~/.local/share/JetBrains/IntelliJIdea*
3. Einstellung zur Dateiüberwachung entfernen
Nur nötig, wenn du Schritt 9 ausgeführt hast. Die höhere Grenze gilt dann ab dem nächsten Neustart nicht mehr.
sudo rm /etc/sysctl.d/60-jetbrains.conf
4. Optional: JDK entfernen
Nur ausführen, wenn kein anderes Programm Java braucht.
sudo apt purge default-jdk
sudo apt autoremove
Prüfen: Die Ausgabe meldet, dass kein Snap namens intellij-idea installiert ist.
snap list intellij-idea
Quellen und Lizenz
- Offizielle Dokumentation: https://www.jetbrains.com/idea/documentation/
- Lizenz: IntelliJ IDEA steht unter der Apache-2.0 (Community Edition).
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.
Eclipse IDE
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Eclipse ist eine kostenlose, quelloffene Entwicklungsumgebung (IDE), die vor allem für Java genutzt wird. Über Erweiterungen (Plugins) lässt sie sich auch für viele andere Sprachen und Aufgaben einsetzen, etwa C/C++, PHP oder Webentwicklung.
Vorbemerkungen
- Kein apt-Paket: Eclipse ist in den aktuellen Ubuntu-Paketquellen nicht enthalten. Diese Anleitung installiert Eclipse deshalb als Snap. Das Snap wird von der Eclipse Foundation selbst veröffentlicht und enthält die Variante „Eclipse IDE for Java Developers“.
- Versionsnamen: Eclipse erscheint viermal im Jahr. Die Versionen heißen nach Jahr und Monat, z. B.
2026-09.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des Java-Entwicklungspakets im nächsten Schritt kennt.
sudo apt update
2. Java-Entwicklungspaket (JDK) installieren
Eclipse braucht ein JDK, um deine Java-Programme zu übersetzen und auszuführen. default-jdk installiert die aktuelle Java-Version mit Langzeitunterstützung aus den Ubuntu-Paketquellen (derzeit Java 25). Ist es schon vorhanden (z. B. aus der IntelliJ-IDEA-Anleitung), meldet apt das nur.
sudo apt install default-jdk
Prüfen: Die Ausgabe nennt die Java-Version, z. B. javac 25.
javac -version
3. Eclipse installieren
Installiert Eclipse als Snap. --classic ist nötig, weil eine IDE uneingeschränkt auf deine Dateien, das JDK und andere Programme zugreifen muss.
sudo snap install eclipse --classic
Prüfen: Die Ausgabe zeigt Name, Version (z. B. 2026-09) und als Herausgeber eclipsefoundation.
snap list eclipse
Erste Schritte
4. Eclipse starten
Startet Eclipse. Alternativ findest du das Programm im Anwendungsmenü unter „Eclipse“.
eclipse &
5. Arbeitsbereich (Workspace) festlegen
Beim Start fragt Eclipse nach einem Ordner für den Workspace. Darin liegen deine Projekte und die Einstellungen, die nur für diesen Arbeitsbereich gelten. Der Vorschlag ~/eclipse-workspace ist in Ordnung. Setze einen Haken bei Use this as the default and do not ask again, wenn die Frage nicht bei jedem Start erscheinen soll, und klicke auf Launch.
Prüfen: Es erscheint die Willkommensseite von Eclipse. Sie lässt sich über das × auf ihrem Reiter schließen.
6. JDK in Eclipse auswählen
Damit Eclipse das in Schritt 2 installierte JDK verwendet. Öffne Window → Preferences → Java → Installed JREs. Klicke auf Search…, wähle den Ordner /usr/lib/jvm und bestätige. Setze anschließend den Haken beim gefundenen Eintrag (z. B. java-25-openjdk-amd64) und klicke auf Apply and Close.
7. Erstes Projekt anlegen
Wähle File → New → Java Project, gib einen Projektnamen ein (z. B. Hallo) und klicke auf Finish. Lege danach mit einem Rechtsklick auf den Ordner src → New → Class eine Klasse Main an und setze dabei den Haken bei public static void main(String[] args). Schreibe in die main-Methode:
System.out.println("Hallo Eclipse");
Prüfen: Mit Strg+F11 startest du das Programm. Unten im Fenster Console erscheint Hallo Eclipse.
8. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| Strg+3 | Schnellzugriff: Befehle, Ansichten und Einstellungen über ihren Namen suchen |
| Strg+Leertaste | Codevervollständigung |
| Strg+1 | Lösungsvorschläge für die markierte Stelle anzeigen |
| Strg+Umschalt+R | Datei im Workspace schnell öffnen |
| Strg+Umschalt+T | Java-Klasse schnell öffnen |
| Strg+Umschalt+F | Code formatieren |
| Strg+Umschalt+O | Imports aufräumen |
| Alt+Umschalt+R | Umbenennen (überall im Projekt) |
| Strg+F11 | Programm ausführen |
| F11 | Programm im Debugger ausführen |
Optional: Deutsche Oberfläche
Eclipse selbst ist nur auf Englisch. Deutsche Übersetzungen liefert das Projekt Eclipse Babel als Erweiterung. Die Übersetzung ist allerdings nicht vollständig, einige Menüs und Meldungen bleiben englisch.
9. Sprachpaket installieren
Öffne Help → Install New Software…. Trage bei Work with die folgende Adresse ein und drücke Enter:
https://download.eclipse.org/technology/babel/update-site/latest/
Klappe in der Liste den Eintrag Babel Language Packs in German auf, setze den Haken bei Babel Language Pack for eclipse in German und klicke auf Next, dann Finish. Eclipse fragt nach dem Vertrauen in die Quelle und die Lizenz: beides bestätigen. Zum Schluss Eclipse neu starten.
Prüfen: Das Menü File heißt jetzt Datei.
Aktualisieren
Snaps aktualisieren sich automatisch im Hintergrund. Sofort aktualisieren kannst du mit:
sudo snap refresh eclipse
Deinstallieren
1. Eclipse entfernen
Entfernt das Snap. --purge verhindert, dass Snap vorher eine Sicherungskopie der Snap-Daten anlegt.
sudo snap remove --purge eclipse
2. Einstellungen und installierte Erweiterungen entfernen
Eclipse speichert programmweite Einstellungen und nachinstallierte Erweiterungen (z. B. das Sprachpaket) in ~/.eclipse und ~/snap/eclipse.
rm -rf ~/.eclipse ~/snap/eclipse
3. Optional: Workspace entfernen
Achtung: Der Workspace enthält deine Projekte. Nur löschen, wenn du sie nicht mehr brauchst oder vorher gesichert hast.
rm -rf ~/eclipse-workspace
4. Optional: JDK entfernen
Nur ausführen, wenn kein anderes Programm (z. B. IntelliJ IDEA) Java braucht.
sudo apt purge default-jdk
sudo apt autoremove
Prüfen: Die Ausgabe meldet, dass kein Snap namens eclipse installiert ist.
snap list eclipse
Quellen und Lizenz
- Offizielle Dokumentation: https://www.eclipse.org/ide/
- Lizenz: Eclipse IDE steht unter der EPL-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.
Microsoft Visual Studio
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Microsoft Visual Studio ist eine umfangreiche Entwicklungsumgebung von Microsoft, vor allem für C#, .NET und C++. Diese Seite erklärt, warum sie unter Ubuntu nicht installiert werden kann, und richtet stattdessen eine gleichwertige Arbeitsumgebung für C# und .NET ein.
Vorbemerkungen
- Nur für Windows: Visual Studio (2022 und neuer) gibt es ausschließlich für Windows. Die Mac-Version hat Microsoft im August 2024 eingestellt, eine Linux-Version gab es nie. Auch mit Wine lässt sich Visual Studio nicht sinnvoll betreiben.
- Nicht verwechseln: Visual Studio Code ist ein anderes, deutlich schlankeres Programm. Es läuft unter Ubuntu und ist die von Microsoft empfohlene Lösung für .NET-Entwicklung unter Linux.
- Der Ersatz: Diese Anleitung installiert das .NET SDK aus den Ubuntu-Paketquellen und die Erweiterung C# Dev Kit für VS Code. Damit stehen Projektverwaltung, Codevervollständigung, Debugger und Testausführung ähnlich wie in Visual Studio zur Verfügung.
- Lizenz des C# Dev Kit: Für Privatpersonen, Ausbildung und Open-Source-Projekte kostenlos. Für die Arbeit in Unternehmen gelten dieselben Bedingungen wie bei Visual Studio Community, größere Firmen brauchen also ein Visual-Studio-Abo.
- Voraussetzung: VS Code ist installiert, siehe Anleitung Visual Studio Code.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des .NET SDK aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. .NET SDK installieren
Das SDK enthält den C#-Compiler, die Laufzeitumgebung und den Befehl dotnet, mit dem Projekte angelegt, gebaut und gestartet werden. Ubuntu stellt die aktuelle Version mit Langzeitunterstützung (.NET 10) selbst bereit, ein Paketarchiv von Microsoft ist nicht nötig.
sudo apt install dotnet-sdk-10.0
Prüfen: Die Ausgabe ist eine Versionsnummer, die mit 10.0 beginnt.
dotnet --version
3. C# Dev Kit in VS Code installieren
Installiert die Erweiterung, die VS Code um die Visual-Studio-ähnlichen Funktionen für C# ergänzt. Die benötigte Grunderweiterung C# wird automatisch mitinstalliert.
code --install-extension ms-dotnettools.csdevkit
Prüfen: In der Liste erscheinen ms-dotnettools.csdevkit und ms-dotnettools.csharp.
code --list-extensions | grep ms-dotnettools
Erste Schritte
4. Testprojekt anlegen
Legt im Home-Verzeichnis ein kleines Konsolenprogramm im Ordner HalloDotnet an. Beim ersten Aufruf von dotnet erscheint einmalig ein Begrüßungstext.
dotnet new console -o ~/HalloDotnet
5. Testprojekt ausführen
Übersetzt das Programm und startet es. So siehst du, dass das SDK funktioniert.
dotnet run --project ~/HalloDotnet
Prüfen: Die Ausgabe lautet Hello, World!.
6. Projekt in VS Code öffnen
Öffnet den Projektordner in VS Code. Das C# Dev Kit erkennt das Projekt automatisch.
code ~/HalloDotnet
Beim ersten Öffnen fragt VS Code, ob du den Autoren des Ordners vertraust: mit „Ja“ bestätigen. Das C# Dev Kit bittet eventuell um eine Anmeldung mit einem Microsoft-Konto. Für die private Nutzung ist das nicht nötig, die Meldung kann geschlossen werden.
Prüfen: Links in der Seitenleiste erscheint der Bereich Projektmappen-Explorer (bzw. Solution Explorer) mit dem Projekt HalloDotnet.
7. Programm im Debugger starten
Öffne die Datei Program.cs, klicke links neben die Zeilennummer der Zeile mit Console.WriteLine, um einen Haltepunkt (roter Punkt) zu setzen, und drücke F5. Wählt VS Code nach einem Debugger, nimm C#.
Prüfen: Das Programm hält am Haltepunkt an, die Zeile ist gelb hinterlegt. Mit F5 läuft es weiter.
8. Die wichtigsten Tastenkürzel für C# kennenlernen
| Tasten | Wirkung |
|---|---|
| F5 | Programm im Debugger starten bzw. fortsetzen |
| Strg+F5 | Programm ohne Debugger starten |
| F9 | Haltepunkt setzen oder entfernen |
| F10 / F11 | Im Debugger: nächste Zeile / in Methode hineinspringen |
| F12 | Zur Definition springen |
| Strg+. | Lösungsvorschläge für die markierte Stelle anzeigen |
| F2 | Umbenennen (überall im Projekt) |
| Strg+Umschalt+B | Projekt bauen |
Weitere Alternativen
- JetBrains Rider: Eine vollwertige .NET-IDE, die Visual Studio in Aufbau und Umfang am nächsten kommt. Für nicht-kommerzielle Nutzung kostenlos, als Snap
riderverfügbar. - Windows in einer virtuellen Maschine: Wer zwingend Visual Studio selbst braucht (z. B. für Windows-Forms-Designer oder C++ mit MSVC), kann Windows in einer virtuellen Maschine (z. B. mit GNOME Boxes oder VirtualBox) installieren. Dafür ist eine Windows-Lizenz nötig.
Aktualisieren
Das .NET SDK wird mit den anderen Paketen aktualisiert:
sudo apt update
sudo apt upgrade
Erweiterungen in VS Code aktualisieren sich automatisch.
Deinstallieren
1. C#-Erweiterungen entfernen
Entfernt das C# Dev Kit aus VS Code.
code --uninstall-extension ms-dotnettools.csdevkit
Entfernt die Grunderweiterung C#, die mitinstalliert wurde.
code --uninstall-extension ms-dotnettools.csharp
2. Hilfserweiterung entfernen
Das C# Dev Kit hat zusätzlich eine Hilfserweiterung installiert, die .NET-Laufzeiten für VS Code verwaltet.
code --uninstall-extension ms-dotnettools.vscode-dotnet-runtime
Prüfen: Die Ausgabe ist leer.
code --list-extensions | grep ms-dotnettools
3. .NET SDK entfernen
purge entfernt auch die Konfigurationsdateien des Pakets.
sudo apt purge dotnet-sdk-10.0
4. Nicht mehr benötigte Pakete entfernen
Entfernt Laufzeitumgebung und weitere Pakete, die nur für das SDK installiert wurden.
sudo apt autoremove
5. Zwischenspeicher und Testprojekt entfernen
~/.dotnet enthält Einstellungen des dotnet-Befehls, ~/.nuget heruntergeladene Programmbibliotheken. Achtung: Der letzte Ordner ist das Testprojekt aus Schritt 4, prüfe vorher, dass du nichts Eigenes darin gespeichert hast.
rm -rf ~/.dotnet ~/.nuget ~/HalloDotnet
Prüfen: Der Befehl wird nicht mehr gefunden.
dotnet --version
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.
Dokumentation und Browsereditoren
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Übersicht führt zu den Installationsanleitungen für Dokumentationsgeneratoren, Browsereditoren und einen Dienst zur Programmausführung auf Ubuntu 26.04 LTS (amd64).
Passende Anleitung öffnen
-
Wähle einen Generator für deine Dokumentation. Jeder Link führt zu einer eigenen Anleitung mit Installation, Vorschau, Prüfung und Entfernung.
Werkzeug Zweck Anleitung mdBook Markdown als Buch mit Kapitelstruktur mdBook Astro mit Starlight Dokumentationswebsite mit fertiger Oberfläche Starlight Eigener Generator mit marked Kleiner eigener Bauablauf für eine HTML-Seite marked Docusaurus Dokumentation mit React-Komponenten Docusaurus VitePress Dokumentation auf Basis von Vue und Vite VitePress Hugo Statische Website mit separat gewähltem Theme Hugo -
Wähle bei Bedarf einen Browsereditor. Die Beispiele richten eigenständige lokale Demo-Projekte ein. Die Einbindung in den gewählten Generator ist ein weiterer Entwicklungsschritt.
Editor Einsatz Anleitung Monaco Quelltexteditor für Desktopbrowser; Mobilbrowser werden nicht unterstützt Monaco CodeMirror 6 Erweiterbarer Editor; Bedienung auch auf Zielmobilgeräten prüfen CodeMirror 6 -
Lies für die Ausführung von Quellcode das Kapitel Judge0. Es dokumentiert die fehlende belegte native Installation für Ubuntu 26.04. Der offizielle Weg verwendet Docker und erfüllt damit die Vorgabe dieses Buchs nicht. Ein Editor allein führt keinen Code aus.
Die Programme werden direkt auf dem Rechner beziehungsweise als npm-Pakete im Benutzerprojekt eingerichtet. Die lokalen Vorschauen sind zum Prüfen vorgesehen. Eine öffentliche Bereitstellung und die Kopplung von Editor, Dokumentation und Ausführungsdienst sind in diesen Einzelanleitungen nicht eingerichtet.
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.
mdBook
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mit mdBook wird aus einer Sammlung von Markdown-Dateien eine Website im Buchformat, mit Kapitelverzeichnis am Rand und Volltextsuche. Auf dem Entwicklungsrechner dient es dazu, Anleitungen und technische Dokumentationen als strukturierte, durchsuchbare HTML-Webseite lokal zu bauen und im Browser zu testen.
Installation (bevorzugt über apt)
Unter Ubuntu 26.04 ist mdBook direkt in den offiziellen Paketquellen enthalten.
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketdaten aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. mdBook installieren
Installiert das mdbook-Paket auf deinem System.
sudo apt install mdbook
Prüfen: Die Versionsnummer von mdBook wird angezeigt.
mdbook --version
Alternative: Installation über Rust (Cargo)
Falls du die aktuelle veröffentlichte Version benötigst oder mdBook im Benutzerverzeichnis (~/.cargo/bin) verwalten möchtest, kannst du die Installation über den Rust-Paketmanager Cargo durchführen.
3. Cargo installieren (falls nicht vorhanden)
Installiert den Rust-Paketmanager Cargo aus den Ubuntu-Paketquellen.
sudo apt install cargo
4. mdBook über Cargo installieren
Lädt den Quellcode von crates.io herunter, kompiliert mdBook und legt die ausführbare Datei unter ~/.cargo/bin/mdbook ab.
cargo install mdbook --locked
Prüfen: Die Version der Cargo-Installation wird angezeigt.
~/.cargo/bin/mdbook --version
Verwendung und Test
5. Neues Buchprojekt initialisieren
Erstellt einen neuen Ordner mein-buch mit der grundlegenden Konfiguration (book.toml) und der Inhaltsstruktur (src/SUMMARY.md).
mdbook init mein-buch --title "Mein Handbuch" --ignore=none
Prüfen: Der Ordner mein-buch mit book.toml und src/ wurde angelegt.
ls -la mein-buch
6. Buch bauen
Erzeugt aus den Markdown-Dateien eine statische HTML-Webseite im Verzeichnis mein-buch/book/.
mdbook build mein-buch
Prüfen: Die generierte Einstiegsseite mein-buch/book/index.html existiert.
ls -lh mein-buch/book/index.html
7. Lokalen Entwicklungsserver starten
Startet einen Webserver auf http://localhost:3000, der Änderungen an Markdown-Dateien automatisch erkennt und die Seite im Browser live neu lädt.
mdbook serve mein-buch --open
Prüfen: Im Terminal läuft der Webserver und im Browser öffnet sich das Buch. Zum Beenden drückst du im Terminal Strg + C.
Deinstallieren
Wenn über apt installiert:
1. mdBook-Paket entfernen
purge entfernt das Programm vollständig aus dem System.
sudo apt purge mdbook
2. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt eventuell verbliebene Paketabhängigkeiten.
sudo apt autoremove
Wenn über Cargo installiert:
Entfernt die Binärdatei aus ~/.cargo/bin/:
cargo uninstall mdbook
Prüfen: Der Befehl wird nicht mehr im System gefunden.
mdbook --version
Quellen und Lizenz
mdBook installieren und Ubuntu-Paket. mdBook steht unter MPL-2.0. Bei paralleler Cargo- und apt-Installation kann nach dem Entfernen einer Variante die andere weiterhin gefunden werden.
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.
Eigener Generator mit marked
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mit marked lässt sich ein kleiner Generator bauen, der eine Markdown-Datei in eine vollständige HTML-Seite umwandelt. Marked steht unter der MIT-Lizenz.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Node.js kommt über apt, die JavaScript-Pakete werden im eigenen Projekt ohne sudo installiert. Verwende einen noch nicht vorhandenen Projektordner.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketstände.
sudo apt update
2. Werkzeuge installieren
Node.js führt die Werkzeuge aus; npm verwaltet die Projektpakete. Python stellt später die lokale Vorschau bereit.
sudo apt install nodejs npm python3
3. Node.js prüfen
Verwende Node.js 22.12 oder neuer innerhalb einer unterstützten LTS-Version. Ubuntu 26.04 liefert Node.js 22.22.1. Bei einer älteren Ausgabe hier anhalten und die aktive Node.js-Installation prüfen.
node --version
4. Projektordner anlegen
Trennt die Beispieldateien von anderen Projekten.
mkdir ~/marked-doku
5. Projektordner öffnen
Die folgenden relativen Dateipfade beziehen sich auf diesen Ordner.
cd ~/marked-doku
6. npm-Projekt initialisieren
Erzeugt package.json als Verzeichnis der Projektabhängigkeiten.
npm init -y
7. Bibliotheken installieren
Marked übersetzt Markdown; sanitize-html filtert das erzeugte HTML, da marked selbst keine Bereinigung durchführt.
npm install marked sanitize-html
8. Markdown-Datei schreiben
Legt den Inhalt der Beispielseite an.
cat > start.md <<'EOF'
# Mein Ubuntu-Handbuch
Diese Seite entsteht mit meinem eigenen Generator.
- Pakete einrichten
- Ergebnis kontrollieren
EOF
9. Generator schreiben
Das eigene Skript liest start.md, bereinigt das HTML und schreibt dist/index.html. Es verarbeitet genau eine Seite; Navigation, Suche und weitere Seiten müssten ergänzt werden.
cat > build.mjs <<'EOF'
import { readFile, mkdir, writeFile } from 'node:fs/promises';
import { marked } from 'marked';
import sanitizeHtml from 'sanitize-html';
const markdown = await readFile('start.md', 'utf8');
const body = sanitizeHtml(await marked.parse(markdown));
const page = `<!doctype html>
<html lang="de">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Ubuntu-Handbuch</title>
<main>${body}</main>
</html>`;
await mkdir('dist', { recursive: true });
await writeFile('dist/index.html', page, 'utf8');
console.log('Erstellt: dist/index.html');
EOF
10. Seite erzeugen
Führt den Generator aus. Erwartet wird die Meldung Erstellt: dist/index.html.
node build.mjs
11. Vorschau starten
Öffne http://127.0.0.1:8000 im Browser. Die Seite soll die Überschrift und zwei Listeneinträge zeigen. Mit Strg + C endet die Vorschau.
python3 -m http.server 8000 --bind 127.0.0.1 --directory dist
Installation prüfen
1. Paketstände anzeigen
Zeigt die tatsächlich installierten Versionen. Bewahre package-lock.json auf; mit npm ci lässt sich derselbe Paketstand erneut installieren.
npm ls marked sanitize-html
Deinstallieren
Beende zuerst eine laufende Vorschau mit Strg + C. Node.js und npm bleiben für andere Projekte verfügbar.
1. Beispielprojekt entfernen
Löscht das gesamte Beispiel einschließlich eigener Änderungen. Sichere benötigte Dateien vorher.
rm -rf -- ~/marked-doku
2. Entfernung prüfen
Bei erfolgreicher Entfernung erscheint die Bestätigung.
test ! -e ~/marked-doku && echo 'Projekt entfernt'
Quellen und Lizenz
Technische Grundlage: Marked-Dokumentation und sanitize-html. Beide Bibliotheken stehen unter MIT. Der Generator oben wurde für diese Anleitung geschrieben; eine Lizenz für den Eigenbau legst du als Rechteinhaber selbst fest. Die MIT-Lizenz von marked gilt nicht automatisch für deinen gesamten Generator. Bei Weitergabe der Bibliotheken ihre Lizenz- und Copyright-Hinweise beilegen.
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.
Antora
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Antora ist ein statischer Webseitengenerator für umfangreiche Software- und Systemdokumentationen auf Basis von AsciiDoc. Auf dem Entwicklungsrechner dient es dazu, strukturierte Dokumentationen aus einem oder mehreren Git-Repositories lokal zu einer durchsuchbaren Webseite zusammenzuführen und zu testen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketdaten aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js, npm und Git installieren
Antora basiert auf Node.js und setzt Git voraus, um Dokumentationsinhalte aus Repositories einzulesen.
sudo apt install -y nodejs npm git
Prüfen: Die installierte Version von Node.js wird angezeigt.
node -v
3. Antora CLI und Site Generator installieren
Installiert das Antora-Befehlszeilenwerkzeug (@antora/cli) und den Webseitengenerator (@antora/site-generator) global über den Node-Paketmanager npm.
sudo npm install -g @antora/cli @antora/site-generator
(Hinweis: Falls du Node.js über nvm im Benutzerverzeichnis verwendest, führe den Befehl ohne sudo aus).
Prüfen: Die installierten Versionsnummern von Antora werden angezeigt.
antora -v
Beispiel-Dokumentation erstellen und testen
4. Projektverzeichnis anlegen
Erstellt die von Antora erwartete Standard-Ordnerstruktur für ein Modul.
mkdir -p ~/antora-demo/docs/modules/ROOT/pages
5. Komponenten-Konfiguration anlegen
Definiert den Namen, die Versionsbezeichnung und den Titel der Dokumentationskomponente in docs/antora.yml.
nano ~/antora-demo/docs/antora.yml
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
name: handbuch
title: Entwickler-Handbuch
version: '1.0'
start_page: index.adoc
nav:
- modules/ROOT/nav.adoc
6. Navigationsdatei anlegen
Erstellt die Navigation für die linke Seitenleiste in docs/modules/ROOT/nav.adoc.
nano ~/antora-demo/docs/modules/ROOT/nav.adoc
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
* xref:index.adoc[Startseite]
7. Startseite in AsciiDoc verfassen
Erstellt den eigentlichen Inhalt der Einstiegsseite in docs/modules/ROOT/pages/index.adoc.
nano ~/antora-demo/docs/modules/ROOT/pages/index.adoc
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
= Willkommen im Entwickler-Handbuch
Dies ist eine lokale Dokumentationsseite, die mit Antora und AsciiDoc erstellt wurde.
== Erste Schritte
* Dokumentation im AsciiDoc-Format schreiben
* Änderungen mit Git versionieren
* Mit Antora zur fertigen Webseite bauen
8. Playbook-Konfiguration anlegen
Das Playbook antora-playbook.yml steuert den Bauprozess, bindet Inhaltsquellen ein und legt das Standard-Design fest.
nano ~/antora-demo/antora-playbook.yml
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
site:
title: Mein Dokumentationsportal
start_page: handbuch::index.adoc
content:
sources:
- url: .
branches: HEAD
start_path: docs
ui:
bundle:
url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
snapshot: true
9. Git-Repository initialisieren
Antora liest Dokumentationsstände standardmäßig aus Git-Zweigen (Branches).
git -C ~/antora-demo init
10. Dokumentationsdateien zum Git-Index hinzufügen
Nimmt alle erstellten Konfigurations- und Inhaltsdateien in die Versionsverwaltung auf.
git -C ~/antora-demo add .
11. Git-Commit erstellen
Erstellt den ersten Revisionsstand im Repository.
git -C ~/antora-demo commit -m "Initiale Dokumentation"
12. Dokumentationsseite bauen
Startet die Generierung der statischen HTML-Webseite über Antora. Die Ausgabe landet standardmäßig in build/site/.
antora ~/antora-demo/antora-playbook.yml
Prüfen: Die Startdatei build/site/index.html wurde erfolgreich erzeugt.
ls -lh ~/antora-demo/build/site/index.html
13. Dokumentation im Browser ansehen
Öffnet die generierte Dokumentationsseite direkt in deinem Standard-Webbrowser.
xdg-open ~/antora-demo/build/site/index.html
Deinstallieren
1. Antora-Pakete entfernen
Deinstalliert Antora CLI und den Site Generator aus npm.
sudo npm uninstall -g @antora/cli @antora/site-generator
2. Node.js und npm entfernen (optional)
Falls Node.js und npm über apt installiert wurden und nicht mehr benötigt werden.
sudo apt purge nodejs npm
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt verbliebene Hilfspakete aus dem System.
sudo apt autoremove
4. Testprojekt löschen (optional)
Entfernt das erstellte Testverzeichnis.
rm -rf ~/antora-demo
Prüfen: Der Befehl antora ist nicht mehr vorhanden.
antora -v
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.antora.org/
- Lizenz: Antora steht unter der MPL-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.
Asciidoctor
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Asciidoctor wandelt Texte im Format AsciiDoc in HTML-Seiten und PDF-Dateien um. AsciiDoc ähnelt Markdown, kennt aber von Haus aus Inhaltsverzeichnisse, Hinweiskästen, nummerierte Tabellen, Querverweise und das Einbinden anderer Dateien. Es eignet sich deshalb gut für längere technische Dokumente.
Vorbemerkungen
- Paket aus Ubuntu: Asciidoctor und die PDF-Erweiterung sind in den Ubuntu-Paketquellen enthalten und werden mit
aptinstalliert. Ruby kommt dabei automatisch mit. - Einzelne Dokumente: Asciidoctor wandelt jeweils eine Datei um. Für eine ganze Dokumentations-Website aus vielen Dateien und mehreren Git-Repositorys gibt es Antora, das intern ebenfalls Asciidoctor verwendet.
- Version: Getestet mit Asciidoctor 2.0.26 und Asciidoctor PDF 2.3.19 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Asciidoctor installieren
Installiert den Befehl asciidoctor, der AsciiDoc in HTML umwandelt, zusammen mit Ruby.
sudo apt install asciidoctor
Prüfen: Die erste Zeile beginnt mit Asciidoctor 2.0.26 (oder einer neueren Nummer).
asciidoctor --version
3. PDF-Erweiterung installieren (optional)
Installiert den Befehl asciidoctor-pdf. Er erzeugt PDF-Dateien direkt, ohne LaTeX und ohne Browser. Wer nur HTML braucht, lässt diesen Schritt weg.
sudo apt install asciidoctor-pdf
Prüfen: Die Ausgabe beginnt mit Asciidoctor PDF 2.3.19.
asciidoctor-pdf --version
Ein Dokument schreiben
4. Arbeitsordner anlegen
Ein eigener Ordner hält das Dokument und die erzeugten Dateien zusammen.
mkdir ~/meinasciidoc
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinasciidoc
6. Dokument anlegen
AsciiDoc-Dateien enden auf .adoc.
nano dokument.adoc
Füge diesen Inhalt ein (Strg+Umschalt+V):
= Mein erstes Dokument
Dein Name
:lang: de
:toc:
:toc-title: Inhalt
:tip-caption: Tipp
:note-caption: Hinweis
:warning-caption: Warnung
:table-caption: Tabelle
:last-update-label: Zuletzt aktualisiert
:webfonts!:
Dieses Dokument wurde mit *Asciidoctor* erstellt.
== Ein Hinweis
TIP: AsciiDoc kennt Hinweise für Tipps, Anmerkungen und Warnungen.
== Eine Tabelle
.Werkzeuge
|===
|Werkzeug |Eingabeformat
|Asciidoctor
|AsciiDoc
|mdBook
|Markdown
|===
== Eine Liste
. Datei schreiben
. Mit `asciidoctor` umwandeln
. Im Browser ansehen
Was die Zeilen bedeuten:
= …in der ersten Zeile ist der Titel, die Zeile darunter der Name des Autors.- Die Zeilen mit Doppelpunkten sind Attribute, also Einstellungen für das ganze Dokument. Sie müssen direkt unter dem Titel stehen, ohne Leerzeile dazwischen.
:lang: deschreibt die Sprache ins HTML.:toc:erzeugt ein Inhaltsverzeichnis.- Die Attribute mit
-captionund-titlebzw.-labelersetzen die englischen Beschriftungen, z. B. „Table of Contents“ oder „Last updated“, durch deutsche. :webfonts!:schaltet das Laden von Schriften bei Google Fonts ab. Sonst würde jeder Besucher der Seite eine Anfrage an Google schicken. Der Browser nimmt dann seine eigenen Schriften.
== …ist eine Überschrift der zweiten Ebene.TIP:am Zeilenanfang macht einen Hinweiskasten. Es gibt auchNOTE:,IMPORTANT:,CAUTION:undWARNING:.|===beginnt und beendet eine Tabelle,.Werkzeugedavor ist ihre Beschriftung..am Zeilenanfang ergibt eine nummerierte Liste.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. In HTML umwandeln
Erzeugt die Datei dokument.html im selben Ordner. Die Gestaltung (CSS) steht mit in der Datei, sie braucht also keine weiteren Dateien.
asciidoctor dokument.adoc
Prüfen: Der Befehl gibt nichts aus, wenn alles in Ordnung ist. Warnungen beginnen mit asciidoctor: WARNING und nennen die Zeile, z. B. bei einer nicht geschlossenen Tabelle.
ls
Neben dokument.adoc liegt jetzt dokument.html.
8. Ergebnis ansehen
Öffnet die HTML-Datei im Standardbrowser.
xdg-open dokument.html
Prüfen: Oben stehen der Titel, dein Name und das Inhaltsverzeichnis „Inhalt“. Darunter folgen ein Kasten „TIPP“, die Tabelle mit der Beschriftung „Tabelle 1. Werkzeuge“ und die nummerierte Liste. Ganz unten steht „Zuletzt aktualisiert“ mit Datum und Uhrzeit.
Nach jeder Änderung an dokument.adoc führst du Schritt 7 erneut aus und lädst die Seite im Browser neu (F5).
9. In PDF umwandeln (optional)
Nur möglich, wenn Schritt 3 ausgeführt wurde. Erzeugt die Datei dokument.pdf mit Inhaltsverzeichnis und Seitenzahlen.
asciidoctor-pdf dokument.adoc
Prüfen: Die Datei öffnet sich im PDF-Betrachter.
xdg-open dokument.pdf
Die HTML-Datei kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
Asciidoctor kommt aus den Ubuntu-Paketquellen und wird mit den normalen Systemupdates aktualisiert.
sudo apt update && sudo apt upgrade
Deinstallieren
1. Asciidoctor entfernen
purge entfernt die Programme samt ihrer Systemdateien. Hast du Schritt 3 ausgelassen, meldet apt für asciidoctor-pdf nur, dass das Paket nicht installiert ist.
sudo apt purge asciidoctor asciidoctor-pdf
2. Nicht mehr benötigte Pakete entfernen
Entfernt Ruby und die Bibliotheken, die mit Asciidoctor installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.
sudo apt autoremove --purge
Prüfen: Die Ausgabe enthält Kommando nicht gefunden.
asciidoctor --version
3. Arbeitsordner löschen (optional)
Achtung: Damit ist auch dein Dokument gelöscht. Wer es behalten will, kopiert vorher dokument.adoc.
rm -r ~/meinasciidoc
Quellen und Lizenz
- Offizielle Dokumentation: https://asciidoctor.org/docs/
- Lizenz: Asciidoctor steht unter der MIT.
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.
Sphinx
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Sphinx ist ein Werkzeug, mit dem man aus einfachen Textdateien eine Dokumentation als Webseite, PDF oder E-Book erzeugt. Es wird vor allem für Software-Dokumentation eingesetzt, etwa die von Python selbst, und kann Dokumentation direkt aus Python-Quellcode übernehmen.
Vorbemerkungen
- Textformate: Sphinx verwendet standardmäßig reStructuredText (Dateiendung
.rst). Mit der Erweiterung MyST lassen sich Seiten auch in Markdown (.md) schreiben. Diese Anleitung richtet beides ein. - Installation über apt: Sphinx und die hier genutzten Erweiterungen sind in den Ubuntu-Paketquellen enthalten. Eine Installation mit
pipist nicht nötig.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Sphinx aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Sphinx installieren
Installiert Sphinx mit den Befehlen sphinx-quickstart (neues Projekt anlegen) und sphinx-build (Dokumentation bauen).
sudo apt install python3-sphinx
Prüfen: Die Ausgabe nennt die Version, z. B. sphinx-build 8.2.3.
sphinx-build --version
3. Zusatzpakete installieren
Diese drei Pakete sind optional, werden aber im weiteren Verlauf verwendet:
python3-sphinx-rtd-theme– ein verbreitetes, übersichtliches Aussehen mit Navigationsleiste („Read the Docs“-Design)python3-myst-parser– erlaubt Seiten in Markdownpython3-sphinx-autobuild– baut die Dokumentation bei jeder Änderung neu und zeigt sie sofort im Browser an
sudo apt install python3-sphinx-rtd-theme python3-myst-parser python3-sphinx-autobuild
Prüfen: Der Befehl zeigt seine Version an.
sphinx-autobuild --version
Erstes Projekt
4. Projektordner anlegen
Ein eigener Ordner für die Dokumentation. Hier als Beispiel ~/sphinx-test.
mkdir ~/sphinx-test
5. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/sphinx-test
6. Projekt anlegen
sphinx-quickstart erzeugt das Grundgerüst. Ohne Zusatzangaben stellt es Fragen im Terminal. Mit den folgenden Angaben läuft es ohne Rückfragen durch:
--septrennt Quelltexte (Ordnersource) und fertige Ausgabe (Ordnerbuild)-pName des Projekts,-aName des Autors-l destellt die Sprache auf Deutsch, damit Texte wie „Suche“ oder „Inhalt“ deutsch erscheinen
sphinx-quickstart --quiet --sep -p "Meine Dokumentation" -a "Dein Name" -l de
Prüfen: Im Ordner source liegen die Dateien conf.py (Einstellungen) und index.rst (Startseite).
ls source
7. Dokumentation zum ersten Mal bauen
Erzeugt aus den Quelltexten in source eine Webseite im Ordner build/html.
sphinx-build -M html source build
Prüfen: Die Ausgabe endet mit The HTML pages are in build/html.. Die Startseite öffnest du mit:
xdg-open build/html/index.html
sphinx-quickstart legt außerdem ein Makefile an. Ist das Paket make installiert, bewirkt make html dasselbe wie der Befehl oben.
Optional: Design und Markdown einrichten
8. Read-the-Docs-Design einschalten
Ersetzt in conf.py das Standard-Design alabaster durch das in Schritt 3 installierte Design.
nano source/conf.py
Suche mit Strg+W nach html_theme und drücke Enter. Die Zeile lautet html_theme = 'alabaster'. Ändere die gefundene Zeile so, dass sie lautet:
html_theme = 'sphinx_rtd_theme'
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe lautet html_theme = 'sphinx_rtd_theme'.
grep '^html_theme' source/conf.py
9. Markdown-Unterstützung einschalten
Trägt die Erweiterung MyST in die (anfangs leere) Liste extensions in conf.py ein. Danach erkennt Sphinx neben .rst- auch .md-Dateien.
nano source/conf.py
Suche mit Strg+W nach extensions und drücke Enter. Die Zeile lautet extensions = []. Ändere die gefundene Zeile so, dass sie lautet:
extensions = ['myst_parser']
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe lautet extensions = ['myst_parser'].
grep '^extensions' source/conf.py
10. Eine Seite in Markdown anlegen
Legt eine neue Seite erste-seite.md an. Die Überschrift mit # wird zum Seitentitel.
nano source/erste-seite.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Erste Seite
Diese Seite ist in **Markdown** geschrieben.
## Ein Codebeispiel
```python
print("Hallo Sphinx")
```
11. Seite ins Inhaltsverzeichnis aufnehmen
Sphinx zeigt nur Seiten an, die in einem Inhaltsverzeichnis (toctree) stehen. Öffne die Startseite in einem Editor:
nano source/index.rst
Suche den Block, der mit .. toctree:: beginnt. Füge nach den Zeilen, die mit : beginnen (die Beschriftung Contents: darfst du auch in Inhalt: ändern), eine Leerzeile und dann den Seitennamen ohne Dateiendung ein. Er muss genauso weit eingerückt sein wie die Zeilen darüber (drei Leerzeichen):
.. toctree::
:maxdepth: 2
:caption: Contents:
erste-seite
Speichern mit Strg+O, Enter, beenden mit Strg+X.
12. Mit automatischer Vorschau arbeiten
sphinx-autobuild baut die Dokumentation und startet einen kleinen Webserver. Bei jeder gespeicherten Änderung wird neu gebaut und der Browser lädt die Seite von selbst neu.
sphinx-autobuild source build/html
Prüfen: Öffne http://127.0.0.1:8000 im Browser. Die Seite hat die Navigationsleiste des Read-the-Docs-Designs, und links steht der Eintrag „Erste Seite“. Mit Strg+C im Terminal beendest du die Vorschau.
Deinstallieren
1. Testprojekt entfernen
Löscht den Beispielordner aus Schritt 4. Achtung: Alles in ~/sphinx-test geht verloren.
rm -rf ~/sphinx-test
2. Sphinx und Zusatzpakete entfernen
purge entfernt auch die Konfigurationsdateien der Pakete.
sudo apt purge python3-sphinx python3-sphinx-rtd-theme python3-myst-parser python3-sphinx-autobuild
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für Sphinx installiert wurden, z. B. python3-docutils und das Design alabaster.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
sphinx-build --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.sphinx-doc.org/
- Lizenz: Sphinx steht unter der BSD-2-Clause.
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.
MkDocs
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
MkDocs erzeugt aus Markdown-Dateien eine statische Dokumentations-Webseite mit Navigation und Suche. Zusammen mit dem Design Material for MkDocs entsteht daraus eine moderne Seite mit hellem und dunklem Modus, Hinweiskästen und Kopier-Schaltflächen für Codebeispiele.
Vorbemerkungen
- Installation über apt: MkDocs und Material for MkDocs sind beide in den Ubuntu-Paketquellen enthalten. Eine Installation mit
pipist nicht nötig. - Einstellungen im YAML-Format: Alle Einstellungen stehen in einer Datei
mkdocs.yml. In YAML zählt die Einrückung: Sie wird immer mit Leerzeichen gemacht, nie mit Tabulatoren. - Weiterentwicklung: Das Team hinter Material for MkDocs arbeitet inzwischen an einem Nachfolger namens Zensical. Material for MkDocs wird weiterhin gepflegt, bekommt aber vor allem Fehlerkorrekturen und keine großen neuen Funktionen mehr.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von MkDocs und Material for MkDocs aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. MkDocs installieren
Installiert den Befehl mkdocs, mit dem Projekte angelegt, in einer Vorschau angezeigt und gebaut werden.
sudo apt install mkdocs
Prüfen: Die Ausgabe beginnt mit mkdocs, version 1.6.1.
mkdocs --version
3. Material for MkDocs installieren
Installiert das Design. Die nötigen Markdown-Erweiterungen (Paket python3-pymdownx) werden automatisch mitinstalliert.
sudo apt install mkdocs-material
Prüfen: Die Ausgabe zeigt Status: install ok installed.
dpkg -s mkdocs-material | grep Status
Erstes Projekt
4. Projekt anlegen
mkdocs new legt einen Ordner mit einer Einstellungsdatei mkdocs.yml und einem Unterordner docs an. In docs liegen die Markdown-Seiten, zu Beginn nur die Startseite index.md.
mkdocs new ~/mkdocs-test
5. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/mkdocs-test
Prüfen: Es werden docs und mkdocs.yml angezeigt.
ls
6. Vorschau starten
mkdocs serve baut die Seite und startet einen kleinen Webserver. Bei jeder gespeicherten Änderung wird neu gebaut und der Browser lädt die Seite von selbst neu. Das Terminal bleibt dabei belegt, öffne für die nächsten Schritte ein zweites Terminal (ebenfalls im Ordner ~/mkdocs-test).
mkdocs serve
Prüfen: Im Terminal steht Serving on http://127.0.0.1:8000/. Öffne http://127.0.0.1:8000 im Browser: Es erscheint die Startseite im einfachen Standard-Design von MkDocs.
Material for MkDocs einrichten
7. Einstellungsdatei für Material schreiben
Ersetzt den Inhalt von mkdocs.yml. Die Einstellungen bewirken Folgendes:
theme: name: material– schaltet das Material-Design einlanguage: de– deutsche Beschriftungen, z. B. „Suche“palette– zwei Farbschemata (hell und dunkel) mit Umschalter oben rechtsfeatures– schnelleres Laden der Seiten, Suchvorschläge und eine Kopier-Schaltfläche an Codeblöckenmarkdown_extensions– Hinweiskästen, aufklappbare Abschnitte und Syntaxhervorhebungnav– legt Reihenfolge und Titel der Seiten in der Navigation fest
nano mkdocs.yml
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
site_name: Meine Dokumentation
theme:
name: material
language: de
palette:
- scheme: default
toggle:
icon: material/brightness-7
name: Dunkles Design einschalten
- scheme: slate
toggle:
icon: material/brightness-4
name: Helles Design einschalten
features:
- navigation.instant
- search.suggest
- content.code.copy
markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.highlight
- pymdownx.superfences
nav:
- Start: index.md
- Erste Seite: erste-seite.md
Prüfen: Das Terminal mit mkdocs serve zeigt eine Warnung, dass erste-seite.md fehlt. Das ist richtig, die Seite folgt im nächsten Schritt.
8. Eine neue Seite anlegen
Legt die Seite erste-seite.md im Ordner docs an. Sie zeigt zwei typische Material-Funktionen: einen Hinweiskasten (!!! note) und einen Codeblock mit Kopier-Schaltfläche.
nano docs/erste-seite.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Erste Seite
Diese Seite nutzt Funktionen von Material for MkDocs.
!!! note "Hinweis"
Das ist ein hervorgehobener Hinweiskasten.
```python
print("Hallo MkDocs")
```
Prüfen: Im Browser unter http://127.0.0.1:8000 hat die Seite jetzt das Material-Design. In der Navigation steht „Erste Seite“ mit einem blauen Hinweiskasten, und oben rechts gibt es den Umschalter für hell und dunkel.
9. Vorschau beenden
Beendet den Webserver aus Schritt 6. Wechsle dazu in dessen Terminal und drücke Strg+C.
10. Fertige Webseite bauen
Erzeugt die fertige Webseite im Ordner site. Diesen Ordner kannst du auf einen beliebigen Webserver hochladen, z. B. nach /var/www/... auf einem Server mit nginx. --strict bricht bei Fehlern wie fehlenden Seiten ab, statt nur zu warnen.
mkdocs build --strict
Prüfen: Die Ausgabe endet mit Documentation built in …, und im Ordner site liegt eine index.html.
ls site/index.html
Deinstallieren
1. Testprojekt entfernen
Löscht den Beispielordner aus Schritt 4. Achtung: Alles in ~/mkdocs-test geht verloren.
rm -rf ~/mkdocs-test
2. MkDocs und Material entfernen
purge entfernt auch die Konfigurationsdateien der Pakete.
sudo apt purge mkdocs mkdocs-material
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für MkDocs installiert wurden, z. B. python3-pymdownx und mkdocs-material-extensions.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
mkdocs --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.mkdocs.org/
- Lizenz: MkDocs steht unter der BSD-2-Clause.
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.
Zensical
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zensical ist ein Generator für statische Websites, der aus Markdown-Dateien eine fertige Dokumentations-Website mit Suche, Navigation und hellem und dunklem Design baut. Er stammt von den Entwicklern von Material for MkDocs, ist teilweise in Rust geschrieben und baut deshalb sehr schnell. Vorhandene MkDocs-Projekte kann er direkt übernehmen.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für Zensical. Es wird als Python-Programm mit
pipxinstalliert, wie es die Anleitung Python für Kommandozeilenprogramme empfiehlt.pipxlegt dafür automatisch eine eigene virtuelle Umgebung an, sodass Zensical nichts an der Python-Installation von Ubuntu ändert. - Version: Getestet mit Zensical 0.0.65 und Python 3.14 unter Ubuntu 26.04. Zensical ist noch jung: Einstellungen und Befehle können sich zwischen Versionen ändern.
- Verhältnis zu MkDocs: Zensical liest seine Einstellungen aus
zensical.toml, versteht aber auch diemkdocs.ymleines vorhandenen MkDocs-Projekts.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von pipx kennt.
sudo apt update
2. pipx installieren
pipx installiert Python-Programme jeweils in eine eigene virtuelle Umgebung und macht ihren Befehl trotzdem überall verfügbar.
sudo apt install pipx
Prüfen: Die Versionsnummer erscheint, z. B. 1.8.0.
pipx --version
3. Zensical installieren
Lädt Zensical von https://pypi.org und legt den Befehl zensical in ~/.local/bin ab.
pipx install zensical
Prüfen: Die Versionsnummer erscheint, z. B. 0.0.65.
zensical --version
Meldet das Terminal zensical: Kommando nicht gefunden, fehlt ~/.local/bin im Suchpfad. pipx ensurepath trägt den Ordner ein. Danach ein neues Terminal öffnen.
Erstes Projekt
4. Projekt anlegen
Legt den Ordner ~/zensical-test mit einer Beispielseite, einer Einstellungsdatei und einer Vorlage für die automatische Veröffentlichung auf GitHub Pages an.
zensical new ~/zensical-test
5. In den Projektordner wechseln
Alle weiteren Befehle arbeiten im Projektordner.
cd ~/zensical-test
Prüfen: Der Ordner enthält zensical.toml und den Ordner docs mit index.md und markdown.md. Der versteckte Ordner .github enthält die Vorlage für GitHub Pages.
ls -A
6. Einstellungsdatei schreiben
Die mitgelieferte zensical.toml ist englisch und enthält viele Beispiele. Diese Fassung ist kürzer und stellt die Oberfläche auf Deutsch um.
nano zensical.toml
Lösche den bisherigen Inhalt: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles aus. Füge dann diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[project]
site_name = "Meine Dokumentation"
site_url = "http://localhost:8000/"
nav = [
{ "Start" = "index.md" },
{ "Erste Seite" = "erste-seite.md" },
]
[project.theme]
language = "de"
features = [
"content.code.copy",
"navigation.footer",
"search.highlight",
]
[[project.theme.palette]]
media = "(prefers-color-scheme: light)"
scheme = "default"
toggle.icon = "lucide/moon"
toggle.name = "Dunkles Design"
[[project.theme.palette]]
media = "(prefers-color-scheme: dark)"
scheme = "slate"
toggle.icon = "lucide/sun"
toggle.name = "Helles Design"
Was die Einträge bedeuten:
site_name– der Name der Website, er steht oben links und im Titel jeder Seite.site_url– die spätere Adresse der Website. Zensical braucht sie z. B. für die Sitemap.nav– die Navigation: links der angezeigte Name, rechts die Datei im Ordnerdocs.language = "de"– Suche, Schaltflächen und Hinweise erscheinen auf Deutsch.features– Zusatzfunktionen.content.code.copysetzt eine Kopier-Schaltfläche an jeden Codeblock,navigation.footerzeigt unten Links zur vorigen und nächsten Seite,search.highlighthebt Suchbegriffe hervor.[[project.theme.palette]]– ein helles und ein dunkles Design. Welches zuerst gilt, richtet sich nach der Einstellung des Betriebssystems. Über das Symbol oben rechts lässt sich umschalten.
7. Nicht mehr benötigte Beispielseite löschen
Die Datei markdown.md steht nicht mehr in der Navigation. Zensical würde sie trotzdem mit ausgeben.
rm docs/markdown.md
8. Eine neue Seite anlegen
Legt die Seite an, die in nav als „Erste Seite“ eingetragen ist.
nano docs/erste-seite.md
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Erste Seite
Das ist meine **erste Seite** mit Zensical.
```bash
zensical build
```
9. Vorschau starten
Baut die Website und stellt sie unter http://localhost:8000 bereit. Speicherst du eine Datei im Ordner docs, baut Zensical die Seite neu. Nach dem Neuladen im Browser ist die Änderung zu sehen.
zensical serve
Prüfen: Im Terminal steht Serving /home/…/zensical-test/site on http://localhost:8000. Im Browser zeigt http://localhost:8000/erste-seite/ die neue Seite. Über dem Codeblock erscheint beim Darüberfahren die Schaltfläche In Zwischenablage kopieren.
10. Vorschau beenden
Drücke im Terminal Strg+C. Die Vorschau hört auf, der Ordner bleibt unverändert.
11. Fertige Website bauen
Erzeugt die fertige Website im Ordner site. Diesen Ordner kann man auf jeden Webserver kopieren, z. B. nach nginx, oder mit gh-pages veröffentlichen. --strict bricht bei Warnungen ab, etwa bei Links auf Seiten, die es nicht gibt.
zensical build --strict
Prüfen: Die Ausgabe endet mit Build finished in …, und die Startseite ist vorhanden.
ls site/index.html
Vorhandenes MkDocs-Projekt bauen (optional)
12. MkDocs-Projekt mit Zensical bauen
Wechsle in ein Projekt, das eine mkdocs.yml hat, z. B. aus der Anleitung MkDocs. -f sagt Zensical, welche Einstellungsdatei es lesen soll. Das Ergebnis landet wie bei MkDocs im Ordner site.
zensical build -f mkdocs.yml
Prüfen: Die Ausgabe endet mit Build finished in …. Zensical unterstützt noch nicht alle Erweiterungen von MkDocs. Meldet es Probleme, hilft die Seite https://zensical.org/docs/compatibility/mkdocs/.
Aktualisieren
1. Neue Version installieren
pipx aktualisiert Zensical in seiner eigenen Umgebung.
pipx upgrade zensical
Prüfen: zensical --version zeigt die neue Versionsnummer.
Deinstallieren
1. Testprojekt entfernen
Löscht den Beispielordner samt gebauter Website.
rm -rf ~/zensical-test
2. Zensical entfernen
Entfernt Zensical samt seiner virtuellen Umgebung.
pipx uninstall zensical
Prüfen: Der Befehl zensical wird nicht mehr gefunden.
zensical --version
3. pipx entfernen (optional)
Nur ausführen, wenn du keine anderen Programme mit pipx installiert hast. pipx list zeigt, welche es gibt.
sudo apt purge pipx
sudo apt autoremove
Quellen und Lizenz
- Offizielle Dokumentation: https://zensical.org/
- Lizenz: Zensical steht unter der MIT.
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.
Docusaurus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docusaurus ist ein Werkzeug von Meta, mit dem man Dokumentations-Webseiten aus Markdown-Dateien erstellt. Es bringt Seitennavigation, Versionierung, mehrsprachige Seiten und auf Wunsch einen Blog mit. Eine Suche muss zusätzlich eingerichtet werden. Die Seiten basieren auf React und lassen sich deshalb mit eigenen Komponenten erweitern.
Vorbemerkungen
- Kein apt-Paket: Docusaurus ist nicht in den Ubuntu-Paketquellen enthalten. Es wird nicht systemweit installiert, sondern pro Projekt über
npm, den Paketmanager von Node.js. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Node.js-Version: Docusaurus 3 braucht Node.js 20 oder neuer. Ubuntu 26.04 liefert Node.js 22, das passt.
- Speicherplatz: Jedes Docusaurus-Projekt lädt seine Abhängigkeiten in einen eigenen Ordner
node_modules. Er ist etwa 350 MB groß.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Docusaurus aus, npm lädt Docusaurus und seine Abhängigkeiten herunter. Das Paket npm bringt auch den Befehl npx mit, der im nächsten Schritt gebraucht wird. Ist beides schon vorhanden (z. B. aus der Antora-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v20, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v20 ist.
Erstes Projekt
3. Projekt anlegen
npx create-docusaurus lädt das Einrichtungsprogramm von Docusaurus herunter und erzeugt damit ein neues Projekt im Ordner ~/meine-doku. Die Angaben bedeuten:
classic– die Standardvorlage mit Dokumentation, Blog und Startseite--javascript– das Projekt verwendet JavaScript statt TypeScript (sonst wird nachgefragt)--package-manager npm– die Abhängigkeiten werden mit npm installiert
Der Vorgang dauert je nach Internetverbindung ein bis zwei Minuten. Fragt npx, ob create-docusaurus installiert werden soll, mit y bestätigen.
npx create-docusaurus@latest ~/meine-doku classic --javascript --package-manager npm
Prüfen: Die Ausgabe enthält [SUCCESS] Created.
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meine-doku
Prüfen: Unter anderem werden die Ordner docs (Dokumentationsseiten), blog und src sowie die Einstellungsdatei docusaurus.config.js angezeigt.
ls
5. Vorschau starten
Startet einen Entwicklungsserver. Bei jeder gespeicherten Änderung aktualisiert sich die Seite im Browser von selbst. Das Terminal bleibt dabei belegt, öffne für die nächsten Schritte ein zweites Terminal (ebenfalls im Ordner ~/meine-doku).
npm start
Prüfen: Im Terminal steht Docusaurus website is running at: http://localhost:3000/. Der Browser öffnet sich meist von selbst, sonst http://localhost:3000 aufrufen. Es erscheint die Beispielseite „My Site“.
Projekt anpassen
6. Titel ändern
Ersetzt den Beispieltitel „My Site“ in der Einstellungsdatei durch einen eigenen. Er erscheint im Browser-Tab und oben links in der Navigationsleiste.
nano docusaurus.config.js
title: 'My Site', steht zweimal in der Datei: oben als Titel der Webseite und weiter unten beim Abschnitt navbar als Titel in der Navigationsleiste. Suche mit Strg+W nach title: 'My Site' und drücke Enter. Ersetze My Site durch Meine Dokumentation. Springe dann mit Alt+W zur zweiten Fundstelle und ändere sie genauso. Beide Zeilen lauten danach (mit unterschiedlicher Einrückung):
title: 'Meine Dokumentation',
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: In der Vorschau steht oben links „Meine Dokumentation“.
7. Sprache auf Deutsch stellen
Stellt die Sprache der Webseite von Englisch auf Deutsch um. Dadurch erscheinen fest eingebaute Beschriftungen wie „Weiter“ oder „Zurück“ auf Deutsch. Die Beispieltexte der Vorlage bleiben englisch, sie werden durch deine eigenen Seiten ersetzt.
nano docusaurus.config.js
Suche mit Strg+W nach defaultLocale und drücke Enter. Ändere in dieser und der Zeile darunter jeweils 'en' in 'de', sodass beide Zeilen so lauten:
defaultLocale: 'de',
locales: ['de'],
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe zeigt defaultLocale: 'de' und locales: ['de'].
grep -E "defaultLocale|locales:" docusaurus.config.js
Die Spracheinstellung wird erst nach einem Neustart der Vorschau wirksam: Im Terminal mit npm start Strg+C drücken und npm start erneut ausführen.
8. Eine eigene Seite anlegen
Legt die Seite erste-seite.md im Ordner docs an. Der Block zwischen den ----Zeilen enthält Angaben für Docusaurus: sidebar_position: 2 setzt die Seite an die zweite Stelle der Seitenleiste. Der Kasten mit :::tip ist ein Hinweiskasten, eine Besonderheit von Docusaurus.
nano docs/erste-seite.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
sidebar_position: 2
---
# Erste Seite
Diese Seite ist in **Markdown** geschrieben.
:::tip Tipp
Änderungen erscheinen sofort im Browser, solange `npm start` läuft.
:::
Prüfen: In der Vorschau unter Tutorial erscheint in der linken Seitenleiste „Erste Seite“ mit einem grünen Hinweiskasten.
9. Vorschau beenden
Beendet den Entwicklungsserver aus Schritt 5. Wechsle dazu in dessen Terminal und drücke Strg+C.
10. Fertige Webseite bauen
Erzeugt die fertige, optimierte Webseite im Ordner build. Diesen Ordner kannst du auf einen beliebigen Webserver hochladen, z. B. auf einen Server mit nginx. Findet Docusaurus dabei defekte Links, bricht der Vorgang mit einer Fehlermeldung ab.
npm run build
Prüfen: Die Ausgabe enthält [SUCCESS] Generated static files in "build".
11. Fertige Webseite ansehen
Startet einen einfachen Webserver für den Ordner build. So siehst du die Seite genauso, wie sie später veröffentlicht wird.
npm run serve
Prüfen: http://localhost:3000 zeigt die fertige Seite. Mit Strg+C beendest du den Webserver.
Aktualisieren
Docusaurus wird pro Projekt aktualisiert. Im Projektordner zeigt dieser Befehl, ob neuere Versionen der Docusaurus-Pakete verfügbar sind:
npm outdated
Die Pakete, die mit @docusaurus/ beginnen, sollten immer alle dieselbe Version haben. Hinweise zum Umstieg auf eine neue Hauptversion stehen in den Versionshinweisen von Docusaurus.
Deinstallieren
1. Projekt entfernen
Löscht das Beispielprojekt samt node_modules. Achtung: Alles in ~/meine-doku geht verloren.
rm -rf ~/meine-doku
2. Zwischengespeichertes Einrichtungsprogramm entfernen
npx hat create-docusaurus in einem Zwischenspeicher abgelegt. Dieser Befehl leert ihn. Andere Projekte sind davon nicht betroffen, npx lädt benötigte Programme beim nächsten Aufruf einfach neu.
rm -rf ~/.npm/_npx
3. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/meine-doku
Quellen
Offizielle Installation. Docusaurus steht unter MIT.
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.
VitePress
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
VitePress erzeugt aus Markdown-Dateien eine schnelle, statische Dokumentations-Webseite. Es basiert auf Vite und Vue, bringt ein fertiges Design mit Seitenleiste, Suche und dunklem Modus mit und aktualisiert die Vorschau beim Schreiben ohne Verzögerung.
Vorbemerkungen
- Kein apt-Paket: VitePress ist nicht in den Ubuntu-Paketquellen enthalten. Es wird nicht systemweit installiert, sondern pro Projekt über
npm, den Paketmanager von Node.js. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Version: Diese Anleitung verwendet die stabile Version VitePress 1 (derzeit 1.6). An Version 2 wird noch gearbeitet.
- Node.js-Version: VitePress 1 braucht Node.js 18 oder neuer. Ubuntu 26.04 liefert Node.js 22, das passt.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt VitePress aus, npm lädt VitePress herunter. Das Paket npm bringt auch den Befehl npx mit. Ist beides schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v18, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v18 ist.
Erstes Projekt
3. Projektordner anlegen
Ein eigener Ordner für die Dokumentation. Hier als Beispiel ~/meine-vitepress.
mkdir ~/meine-vitepress
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meine-vitepress
5. VitePress im Projekt installieren
Lädt VitePress in den Ordner node_modules und legt die Datei package.json an, in der npm festhält, welche Pakete das Projekt braucht. -D markiert VitePress als Entwicklungswerkzeug: Es wird zum Bauen gebraucht, ist aber nicht Teil der fertigen Webseite.
npm add -D vitepress@1
Prüfen: Die Ausgabe zeigt die installierte Version, z. B. vitepress@1.6.4.
npm ls vitepress
6. Grundgerüst mit dem Assistenten anlegen
Der Assistent legt Einstellungsdatei, Startseite und zwei Beispielseiten an. Er stellt sechs Fragen, die du mit den Pfeiltasten und Enter beantwortest. Du kannst überall den Vorschlag mit Enter übernehmen, Titel und Beschreibung werden in Schritt 8 ohnehin ersetzt:
| Frage | Antwort | Bedeutung |
|---|---|---|
| Where should VitePress initialize the config? | ./ | Die Seiten liegen direkt im Projektordner |
| Site title | beliebig | Titel der Webseite |
| Site description | beliebig | Kurzbeschreibung für Suchmaschinen |
| Theme | Default Theme | Das fertige VitePress-Design |
| Use TypeScript for config and theme files? | Yes | Die Einstellungsdatei heißt dann config.mts |
| Add VitePress npm scripts to package.json? | Yes | Legt Kurzbefehle wie npm run docs:dev an |
npx vitepress init
Prüfen: Der Assistent endet mit Done! Now run npm run docs:dev and start writing. Im Ordner liegen jetzt index.md, zwei Beispielseiten und der versteckte Ordner .vitepress mit der Datei config.mts.
ls -a . .vitepress
7. Vorschau starten
Startet einen Entwicklungsserver. Jede gespeicherte Änderung erscheint sofort im Browser. Das Terminal bleibt dabei belegt, öffne für die nächsten Schritte ein zweites Terminal (ebenfalls im Ordner ~/meine-vitepress).
npm run docs:dev
Prüfen: Im Terminal steht Local: http://localhost:5173/. Öffne http://localhost:5173 im Browser: Es erscheint die Beispiel-Startseite „My Awesome Project“.
Projekt anpassen
8. Einstellungen auf Deutsch schreiben
Ersetzt die Einstellungsdatei. Die Angaben bewirken Folgendes:
lang,title,description– Sprache, Titel und Beschreibung der Webseitenav– Links in der Kopfleistesidebar– Aufbau der Seitenleistesearch– eingebaute Suche, die ohne externen Dienst funktioniert- die restlichen Angaben – deutsche Beschriftungen für fest eingebaute Texte wie „Nächste Seite“
nano .vitepress/config.mts
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import { defineConfig } from 'vitepress'
export default defineConfig({
lang: 'de-DE',
title: 'Meine Dokumentation',
description: 'Eine Dokumentation mit VitePress',
themeConfig: {
nav: [
{ text: 'Start', link: '/' },
{ text: 'Erste Seite', link: '/erste-seite' }
],
sidebar: [
{
text: 'Anleitung',
items: [
{ text: 'Erste Seite', link: '/erste-seite' }
]
}
],
search: { provider: 'local' },
outline: { label: 'Auf dieser Seite' },
docFooter: { prev: 'Vorherige Seite', next: 'Nächste Seite' },
darkModeSwitchLabel: 'Design',
sidebarMenuLabel: 'Menü',
returnToTopLabel: 'Nach oben'
}
})
Die Vorschau lädt die geänderten Einstellungen von selbst neu.
9. Startseite ersetzen
Die Startseite besteht nur aus Angaben zwischen den ----Zeilen. layout: home erzeugt daraus eine Titelseite mit großer Überschrift und einer Schaltfläche.
nano index.md
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
layout: home
hero:
name: Meine Dokumentation
tagline: Erstellt mit VitePress
actions:
- theme: brand
text: Los geht's
link: /erste-seite
---
10. Eine eigene Seite anlegen
Legt die Seite erste-seite.md an. Der Kasten mit ::: tip ist ein Hinweiskasten, eine Besonderheit von VitePress.
nano erste-seite.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Erste Seite
Diese Seite ist in **Markdown** geschrieben.
::: tip Tipp
Änderungen erscheinen sofort im Browser, solange `npm run docs:dev` läuft.
:::
## Ein Codebeispiel
```js
console.log('Hallo VitePress')
```
Prüfen: In der Vorschau führt die Schaltfläche „Los geht's“ zur neuen Seite. Sie hat einen grünen Hinweiskasten, und rechts steht „Auf dieser Seite“.
11. Beispielseiten entfernen
Die zwei Beispielseiten des Assistenten werden nicht mehr gebraucht und sind in den neuen Einstellungen auch nicht mehr verlinkt.
rm api-examples.md markdown-examples.md
12. Vorschau beenden
Beendet den Entwicklungsserver aus Schritt 7. Wechsle dazu in dessen Terminal und drücke Strg+C.
13. Fertige Webseite bauen
Erzeugt die fertige Webseite im Ordner .vitepress/dist. Diesen Ordner kannst du auf einen beliebigen Webserver hochladen, z. B. auf einen Server mit nginx. Findet VitePress dabei Links auf Seiten, die es nicht gibt, bricht der Vorgang mit einer Fehlermeldung ab.
npm run docs:build
Prüfen: Die Ausgabe endet mit build complete in ….
14. Fertige Webseite ansehen
Startet einen einfachen Webserver für den fertigen Ordner. So siehst du die Seite genauso, wie sie später veröffentlicht wird.
npm run docs:preview
Prüfen: http://localhost:4173 zeigt die fertige Seite. Mit Strg+C beendest du den Webserver.
Aktualisieren
VitePress wird pro Projekt aktualisiert. Im Projektordner holt dieser Befehl die neueste Version innerhalb von VitePress 1:
npm update vitepress
Prüfen:
npm ls vitepress
Deinstallieren
1. Projekt entfernen
Löscht das Beispielprojekt samt node_modules. Achtung: Alles in ~/meine-vitepress geht verloren.
rm -rf ~/meine-vitepress
2. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora oder Docusaurus).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/meine-vitepress
Quellen
Offizieller Einstieg. Diese Anleitung legt VitePress ausdrücklich auf Hauptversion 1 fest.
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.
Astro Starlight
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Starlight macht aus Astro, einem Werkzeug zum Bauen von Webseiten, ein fertiges System für Dokumentationen. Aus Markdown-Dateien entsteht damit eine schnelle, statische Webseite mit Seitenleiste, eingebauter Suche, hellem und dunklem Modus sowie Unterstützung für mehrere Sprachen.
Vorbemerkungen
- Kein apt-Paket: Astro und Starlight sind nicht in den Ubuntu-Paketquellen enthalten. Sie werden nicht systemweit installiert, sondern pro Projekt über
npm, den Paketmanager von Node.js. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Node.js-Version: Astro 7 braucht Node.js 22.12 oder neuer. Ubuntu 26.04 liefert Node.js 22.22, das passt.
- Projektversionen: Das Einrichtungsprogramm wählt die aktuellen Pakete. Bewahre
package-lock.jsonauf, um deren genaue Versionen zu dokumentieren.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Astro aus, npm lädt Astro und Starlight herunter. Ist beides schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v22.12, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v22.12 ist.
Erstes Projekt
3. Projekt anlegen
npm create astro lädt das Einrichtungsprogramm von Astro herunter und erzeugt damit ein neues Projekt im Ordner ~/meine-starlight. Die Angaben nach -- bedeuten:
--template starlight– verwendet die Starlight-Vorlage statt einer leeren Astro-Seite--install– installiert die benötigten Pakete gleich mit--no-git– legt kein Git-Repository an (das kannst du später jederzeit mitgit initnachholen)--yes– beantwortet alle weiteren Fragen mit dem Vorschlag
Der Vorgang dauert je nach Internetverbindung etwa eine Minute.
npm create --yes astro@latest -- ~/meine-starlight --template starlight --install --no-git --yes
Prüfen: Die Ausgabe enthält Project initialized!.
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meine-starlight
Prüfen: Unter anderem werden die Einstellungsdatei astro.config.mjs und der Ordner src angezeigt. Die Seiten der Dokumentation liegen in src/content/docs.
ls
5. Vorschau starten
Startet einen Entwicklungsserver. Jede gespeicherte Änderung erscheint sofort im Browser. Das Terminal bleibt dabei belegt, öffne für die nächsten Schritte ein zweites Terminal (ebenfalls im Ordner ~/meine-starlight).
npm run dev
Prüfen: Im Terminal steht Local http://localhost:4321/. Öffne http://localhost:4321 im Browser: Es erscheint die englische Beispielseite „Welcome to Starlight“.
Projekt anpassen
6. Einstellungen auf Deutsch schreiben
Ersetzt die Einstellungsdatei. Die Angaben bewirken Folgendes:
title– Titel der Webseite, erscheint oben linksdefaultLocaleundlocales– die Seite ist einsprachig auf Deutsch. Dadurch erscheinen fest eingebaute Beschriftungen wie „Suchen“ oder „Auf dieser Seite“ auf Deutsch.sidebar– die Seitenleiste enthält eine Gruppe „Anleitungen“, die automatisch alle Seiten aus dem Ordneranleitungenauflistet
nano astro.config.mjs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
export default defineConfig({
integrations: [
starlight({
title: 'Meine Dokumentation',
defaultLocale: 'root',
locales: {
root: { label: 'Deutsch', lang: 'de' },
},
sidebar: [
{
label: 'Anleitungen',
items: [{ autogenerate: { directory: 'anleitungen' } }],
},
],
}),
],
});
In der Vorschau ist die Seitenleiste jetzt leer, weil es den Ordner anleitungen noch nicht gibt. Das ändert sich in den nächsten Schritten.
7. Beispielseiten entfernen
Die Vorlage enthält zwei Beispielordner, die in den neuen Einstellungen nicht mehr vorkommen.
rm -r src/content/docs/guides src/content/docs/reference
8. Ordner für die eigenen Seiten anlegen
In diesem Ordner sucht die Seitenleiste nach Seiten (siehe Schritt 6).
mkdir src/content/docs/anleitungen
9. Eine eigene Seite anlegen
Legt die Seite erste-seite.md an. Jede Seite beginnt mit Angaben zwischen ----Zeilen: title ist Pflicht und wird zur Überschrift der Seite, description erscheint in Suchmaschinen. Der Kasten mit :::tip ist ein Hinweiskasten, eine Besonderheit von Starlight.
nano src/content/docs/anleitungen/erste-seite.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
title: Erste Seite
description: Eine erste Seite mit Starlight
---
Diese Seite ist in **Markdown** geschrieben. Den Titel oben setzt Starlight aus der Angabe `title`.
:::tip[Tipp]
Änderungen erscheinen sofort im Browser, solange `npm run dev` läuft.
:::
## Ein Codebeispiel
```js
console.log('Hallo Starlight');
```
10. Startseite ersetzen
Die Startseite der Vorlage ist englisch und verlinkt auf die gelöschten Beispielseiten. template: splash erzeugt eine Titelseite ohne Seitenleiste mit großer Überschrift und einer Schaltfläche.
nano src/content/docs/index.mdx
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
title: Meine Dokumentation
description: Startseite der Dokumentation
template: splash
hero:
tagline: Erstellt mit Astro Starlight
actions:
- text: Los geht's
link: /anleitungen/erste-seite/
icon: right-arrow
---
Prüfen: Lade http://localhost:4321 im Browser neu. Die Schaltfläche „Los geht's“ führt zur neuen Seite. Links steht die Gruppe „Anleitungen“, rechts „Auf dieser Seite“, und oben gibt es ein Suchfeld „Suchen“.
11. Vorschau beenden
Beendet den Entwicklungsserver aus Schritt 5. Wechsle dazu in dessen Terminal und drücke Strg+C.
12. Fertige Webseite bauen
Erzeugt die fertige Webseite im Ordner dist, einschließlich des Suchindex. Diesen Ordner kannst du auf einen beliebigen Webserver hochladen, z. B. auf einen Server mit nginx.
npm run build
Prüfen: Die Ausgabe endet mit [build] Complete!. Die Warnung, dass für die Sitemap die Einstellung site fehlt, kannst du hier ignorieren. Vor einer echten Veröffentlichung trägst du in astro.config.mjs vor integrations die spätere Adresse ein, z. B. site: 'https://docs.example.org',.
13. Fertige Webseite ansehen
Startet einen einfachen Webserver für den Ordner dist. So siehst du die Seite genauso, wie sie später veröffentlicht wird. Anders als in der Vorschau funktioniert hier auch die Suche.
npm run preview
Prüfen: http://localhost:4321 zeigt die fertige Seite. Die Suche oben findet die „Erste Seite“. Mit Strg+C beendest du den Webserver.
Aktualisieren
Astro und Starlight werden pro Projekt aktualisiert. Im Projektordner bringt dieser Befehl Astro, Starlight und passende Erweiterungen gemeinsam auf den neuesten Stand. Er zeigt vorher an, was sich ändert, und fragt nach.
npx @astrojs/upgrade
Weil Starlight noch unter Version 1 ist, lohnt vor größeren Sprüngen ein Blick in die Versionshinweise von Starlight.
Deinstallieren
1. Projekt entfernen
Löscht das Beispielprojekt samt node_modules. Achtung: Alles in ~/meine-starlight geht verloren.
rm -rf ~/meine-starlight
2. Zwischengespeichertes Einrichtungsprogramm entfernen
npm create und npx haben Programme in einem Zwischenspeicher abgelegt. Dieser Befehl leert ihn. Andere Projekte sind davon nicht betroffen, die Programme werden beim nächsten Aufruf einfach neu geladen.
rm -rf ~/.npm/_npx
3. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora, Docusaurus oder VitePress).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/meine-starlight
Quellen
Starlight einrichten und Astro installieren. Astro und Starlight stehen unter MIT.
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.
Hugo
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Hugo ist ein sehr schneller Generator für statische Webseiten. Nach dem Prinzip „Docs as Code“ liegt die Dokumentation als Markdown im Git-Repository, wird wie Quellcode versioniert und geprüft und von Hugo zu einer Webseite mit Navigation und Suche gebaut.
Vorbemerkungen
- Docs as Code: Die Texte werden mit denselben Werkzeugen gepflegt wie Programmcode: Texteditor, Git, Commits und Prüfungen vor dem Einchecken. Hugo übernimmt dabei zwei Aufgaben: Es baut die Webseite und es bricht den Bau ab, wenn z. B. ein interner Link ins Leere zeigt.
- Installation über apt: Ubuntu liefert Hugo in der Variante „extended“ aus (Version 0.154). Diese Variante kann auch SCSS verarbeiten, was viele Designs voraussetzen.
- Design (Theme): Hugo bringt kein fertiges Design mit. Diese Anleitung verwendet Hugo Book, ein schlichtes Design für Dokumentationen mit Seitenleiste, Suche und „Bearbeiten“-Link. Die neuesten Versionen von Hugo Book verlangen Hugo 0.158 oder neuer. Deshalb wird hier die Version
v13fest eingestellt, die mit der Hugo-Version aus Ubuntu funktioniert.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketversionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Hugo und Git installieren
Installiert den Befehl hugo und Git. Git wird für die Versionsverwaltung der Texte und zum Einbinden des Designs gebraucht.
sudo apt install hugo git
Prüfen: Die Ausgabe beginnt mit hugo v0.154.5+extended. Wichtig ist das Wort extended.
hugo version
Dokumentationsprojekt anlegen
3. Neues Projekt erzeugen
Legt den Ordner ~/hugo-docs mit der Grundstruktur eines Hugo-Projekts an. --format yaml sorgt dafür, dass die Einstellungsdatei hugo.yaml heißt und im YAML-Format geschrieben ist.
hugo new site ~/hugo-docs --format yaml
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/hugo-docs
Prüfen: Es werden unter anderem content, themes und hugo.yaml angezeigt.
ls
5. Git-Repository anlegen
Macht den Ordner zu einem Git-Repository mit dem Hauptzweig main. Ab jetzt wird jede Änderung an der Dokumentation nachvollziehbar gespeichert.
git init -b main
6. Erzeugte Dateien von Git ausschließen
Die fertige Webseite (public/) und Zwischenergebnisse entstehen bei jedem Bau neu. Sie gehören deshalb nicht ins Repository, nur die Quelltexte.
nano .gitignore
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
public/
resources/_gen/
.hugo_build.lock
7. Design als Git-Submodul einbinden
Lädt Hugo Book in den Ordner themes/hugo-book. Als Submodul merkt sich das Repository nur, welche Version des Designs verwendet wird, statt alle Dateien selbst zu speichern.
git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
8. Passende Design-Version einstellen
Stellt das Design auf die Version v13, die zu Hugo 0.154 passt (siehe Vorbemerkungen).
git -C themes/hugo-book checkout v13
Git meldet dabei einen „losgelösten HEAD“ (detached HEAD). Das ist hier gewollt: Das Design soll auf genau dieser Version stehen bleiben.
Prüfen: Die Ausgabe zeigt v13.
git -C themes/hugo-book describe --tags
9. Einstellungsdatei schreiben
Ersetzt den Inhalt von hugo.yaml. Die Einstellungen bewirken Folgendes:
languageCodeunddefaultContentLanguage– die Seite ist deutschsprachigtheme– verwendet das Design aus Schritt 7enableGitInfo– übernimmt das Datum der letzten Änderung jeder Seite aus der Git-HistorieBookSection– der Ordnercontent/docserscheint als Navigation in der SeitenleisteBookRepoundBookEditLink– jede Seite bekommt einen Link, der direkt zur Datei im Online-Repository führt; die Adresse später durch die eigene ersetzen
nano hugo.yaml
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
baseURL: https://example.org/
languageCode: de
defaultContentLanguage: de
title: Meine Dokumentation
theme: hugo-book
enableGitInfo: true
params:
BookSection: docs
BookRepo: https://github.com/beispiel/hugo-docs
BookEditLink: '{{ .Site.Params.BookRepo }}/edit/main/{{ .Path }}'
10. Grundgerüst einchecken
Speichert den bisherigen Stand als ersten Commit. Das ist schon jetzt nötig: Wegen enableGitInfo liest Hugo die Git-Historie und bricht ab, solange das Repository noch gar keinen Commit hat.
git add .
git commit -m "Hugo-Projekt mit Design Hugo Book angelegt"
Prüfen: git log --oneline zeigt den Commit an.
git log --oneline
Inhalte schreiben
11. Startseite anlegen
Die Datei content/_index.md wird zur Startseite. Der Link darin verwendet relref: Hugo sucht die Zielseite beim Bauen und meldet einen Fehler, falls es sie nicht gibt.
nano content/_index.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
title: Start
---
# Willkommen
Hier beginnt die Dokumentation. Weiter geht es mit der
[Installation]({{< relref "docs/installation" >}}).
12. Erste Dokumentationsseite erzeugen
hugo new content legt die Datei content/docs/installation.md mit einem vorbereiteten Kopfbereich an. Das Design liefert dafür eine eigene Vorlage mit allen Einstellungen, die eine Seite haben kann.
hugo new content docs/installation.md
Prüfen: Der Kopfbereich zwischen den beiden --- enthält title: "Installation".
cat content/docs/installation.md
13. Text der Seite ergänzen
Hängt einen Hinweiskasten und einen Codeblock an. Der Hinweiskasten nutzt die Markdown-Schreibweise > [!NOTE], die auch GitHub und GitLab darstellen.
nano content/docs/installation.md
Springe mit Strg+Ende ans Ende der Datei und füge diesen Text an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Installation
> [!NOTE]
> Diese Seite liegt im Git-Repository und wird wie Code geprüft.
```bash
echo "Hallo Hugo"
```
14. Vorschau starten
hugo server baut die Seite im Arbeitsspeicher und startet einen kleinen Webserver. Jede gespeicherte Änderung erscheint sofort im Browser. Das Terminal bleibt belegt, öffne für die nächsten Schritte ein zweites Terminal (ebenfalls im Ordner ~/hugo-docs).
hugo server
Prüfen: Im Terminal steht Web Server is available at http://localhost:1313/. Unter http://localhost:1313 erscheint die Startseite, links die Navigation mit „Installation“ und darüber ein Suchfeld.
15. Vorschau beenden
Beendet den Webserver aus Schritt 14. Wechsle dazu in dessen Terminal und drücke Strg+C.
Prüfen wie Code
16. Automatische Prüfung vor jedem Commit einrichten
Ein Git-Hook ist ein Skript, das Git bei bestimmten Aktionen selbst startet. Dieser Hook baut die Seite vor jedem Commit testweise im Arbeitsspeicher. --panicOnWarning wertet schon Warnungen als Fehler. Scheitert der Bau, z. B. wegen eines Links auf eine nicht vorhandene Seite, bricht Git den Commit ab.
nano .git/hooks/pre-commit
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
#!/bin/sh
# Vor jedem Commit die Seite testweise bauen
hugo build --panicOnWarning --renderToMemory --logLevel error
17. Hook ausführbar machen
Git startet nur Hooks, die als ausführbar markiert sind.
chmod +x .git/hooks/pre-commit
18. Inhalte einchecken
Merkt die neuen Seiten für den Commit vor und speichert sie. Dabei läuft der Hook aus Schritt 16 zum ersten Mal.
git add .
git commit -m "Startseite und Installationsseite ergänzt"
Prüfen: Der Commit wird angelegt, und git log --oneline zeigt jetzt zwei Commits.
git log --oneline
Gegenprobe (optional): Ändere in content/_index.md das Linkziel docs/installation in docs/fehlt und versuche erneut einen Commit. Hugo meldet REF_NOT_FOUND, und der Commit wird nicht angelegt. Danach die Änderung wieder rückgängig machen.
19. Fertige Webseite bauen
Erzeugt die fertige Webseite im Ordner public. --minify verkleinert HTML, CSS und JavaScript. Den Ordner public kannst du auf einen beliebigen Webserver hochladen, z. B. nach /var/www/... auf einem Server mit nginx.
hugo build --minify --panicOnWarning
Prüfen: Die Ausgabe endet mit Total in … ms ohne ERROR, und die Seite liegt als HTML-Datei vor.
ls public/docs/installation/index.html
Projekt auf einem anderen Rechner weiterbearbeiten
Wird das Repository später geklont, muss das Design (Submodul) mitgeladen werden. Dafür gibt es die Option --recurse-submodules (ersetze die Beispiel-URL durch die Adresse deines Repositorys):
git clone --recurse-submodules https://github.com/BENUTZER/MEINE-DOKU.git
Deinstallieren
1. Testprojekt entfernen
Löscht den Beispielordner aus Schritt 3. Achtung: Alles in ~/hugo-docs geht verloren, auch die Git-Historie.
rm -rf ~/hugo-docs
2. Hugo entfernen
purge entfernt auch die Konfigurationsdateien des Pakets. Git bleibt installiert, weil es meist auch für andere Zwecke gebraucht wird.
sudo apt purge hugo
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für Hugo installiert wurden, z. B. libsass1.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
hugo version
Quellen und Lizenz
Hugo unter Linux installieren. Hugo steht unter Apache-2.0; das verwendete Theme hat eine eigene Lizenz.
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.
Jekyll
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Jekyll ist ein Generator für statische Websites: Aus Markdown-Dateien, Vorlagen und einer Einstellungsdatei baut er fertige HTML-Seiten, die jeder Webserver ohne Datenbank und ohne Programmiersprache ausliefern kann. Jekyll steckt auch hinter GitHub Pages und eignet sich für Blogs, Projektseiten und Dokumentationen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 enthält Jekyll in der aktuellen Version 4.4.1. Die Anleitung installiert Jekyll deshalb vollständig über
apt. Das Standard-Designminimaund die Plugins für den Feed und für Suchmaschinen-Angaben kommen als empfohlene Pakete automatisch mit. Ruby-Pakete aus dem Internet (Gems) sind für die Beispielseite nicht nötig. - Version: Getestet mit Jekyll 4.4.1, Ruby aus Ubuntu 26.04 und dem Design minima 2.5.1.
- Port: Die Vorschau läuft auf Port 4000, nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Jekyll kennt.
sudo apt update
2. Jekyll installieren
Installiert Jekyll mit Ruby, dem Design minima und den Plugins jekyll-feed und jekyll-seo-tag (zusammen etwa 60 Pakete).
sudo apt install jekyll
Prüfen: Die Ausgabe lautet jekyll 4.4.1.
jekyll --version
Eine Website anlegen
3. Neue Website erzeugen
Legt den Ordner ~/meineseite mit einer Beispielseite an: Startseite, Seite „About“, ein Beispielbeitrag und die Einstellungsdatei _config.yml. Jekyll ruft dabei bundle install auf. Bundler prüft, ob alle benötigten Ruby-Pakete vorhanden sind, und findet sie in den apt-Paketen aus Schritt 2.
jekyll new ~/meineseite
Prüfen: Die Ausgabe endet mit New jekyll site installed in …/meineseite. Die Zeile davor lautet Bundle complete!.
4. In den Ordner der Website wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meineseite
5. Einstellungen anpassen
In _config.yml stehen Titel, Beschreibung, Sprache und Design der Website. Die Beispieldatei enthält englische Platzhalter.
nano _config.yml
Ersetze den gesamten Inhalt: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K löscht alles Markierte. Füge dann diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
title: Meine Wissensseite
description: Notizen und Anleitungen, gebaut mit Jekyll.
lang: de
baseurl: ""
url: ""
theme: minima
plugins:
- jekyll-feed
titleunddescriptionerscheinen im Kopf der Seiten und im Feed.lang: dekennzeichnet die Seiten als deutsch. Das hilft Screenreadern und Suchmaschinen.theme: minimaist das Design,jekyll-feederzeugt die Dateifeed.xmlfür Feed-Reader.
Jekyll liest _config.yml nur beim Start. Nach Änderungen an dieser Datei musst du die Vorschau aus Schritt 7 neu starten.
6. Einen Beitrag schreiben
Beiträge liegen im Ordner _posts. Der Dateiname muss mit dem Datum im Format JJJJ-MM-TT beginnen. Verwende das heutige Datum, denn Beiträge mit einem Datum in der Zukunft lässt Jekyll beim Bauen weg.
nano _posts/2026-09-26-erster-beitrag.md
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
layout: post
title: "Mein erster Beitrag"
---
Diese Seite wurde mit **Jekyll** gebaut.
- Beiträge liegen im Ordner `_posts`.
- Der Dateiname beginnt mit dem Datum.
Der Block zwischen den beiden ----Zeilen heißt Front Matter. Er sagt Jekyll, welche Vorlage (layout) und welchen Titel die Seite bekommt. Darunter folgt normales Markdown.
7. Vorschau starten
Baut die Website und startet einen kleinen Webserver. Jekyll beobachtet den Ordner und baut die Seiten bei jeder gespeicherten Änderung neu.
jekyll serve
Prüfen: Die Ausgabe enthält Server address: http://127.0.0.1:4000/. Öffne http://localhost:4000 im Browser. Oben steht „Meine Wissensseite“, darunter ist „Mein erster Beitrag“ aufgelistet.
Beende die Vorschau mit Strg+C.
8. Website für die Veröffentlichung bauen
Erzeugt die fertige Website im Ordner _site, ohne einen Server zu starten.
jekyll build
Prüfen: Der Ordner _site enthält unter anderem index.html und feed.xml.
ls _site
Den Inhalt von _site kann jeder Webserver ausliefern. Wie das mit nginx geht, zeigt Statische Website mit nginx. Kopiere dafür den Inhalt von _site in den dort verwendeten Ordner /var/www/start.de/html.
Aktualisieren
Jekyll, das Design und die Plugins werden mit den normalen Systemaktualisierungen erneuert:
sudo apt update && sudo apt upgrade
Deinstallieren
1. Jekyll entfernen
purge entfernt das Programm samt seiner Systemdateien.
sudo apt purge jekyll
2. Nicht mehr benötigte Pakete entfernen
Entfernt Ruby, das Design und die Plugins, die mit Jekyll installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.
sudo apt autoremove --purge
3. Beispielseite löschen
Achtung: Damit sind auch deine Beiträge weg. Wer sie behalten will, kopiert vorher den Ordner ~/meineseite/_posts.
rm -r ~/meineseite
Prüfen: Der Befehl jekyll wird nicht mehr gefunden.
jekyll --version
Quellen und Lizenz
- Offizielle Dokumentation: https://jekyllrb.com/docs/
- Lizenz: Jekyll steht unter der MIT.
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.
Pelican
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Pelican ist ein Generator für statische Websites in Python. Er baut aus Beiträgen in Markdown oder reStructuredText einen fertigen Blog mit Kategorien, Schlagwörtern, Archiv und Feeds. Die Ausgabe ist reines HTML, das jeder Webserver ohne Datenbank ausliefern kann.
Vorbemerkungen
- Warum nicht die Version aus apt: Ubuntu 26.04 enthält Pelican 4.11.0. Dem Paket fehlt aber das Standard-Design
notmyidea. Es enthält nur das Designsimple, und das ist reines HTML ohne Gestaltung. Diese Anleitung installiert Pelican deshalb mitpipin eine virtuelle Umgebung (venv), einen eigenen Ordner nur für dieses Projekt, siehe Python. So bekommst du die aktuelle Version mit beiden Designs. - Version: Getestet mit Pelican 4.12.0 und Python 3.14 aus Ubuntu 26.04.
- Port: Die Vorschau läuft auf Port 8000, nur vom eigenen Rechner aus erreichbar. Läuft dort schon ein anderes Programm, z. B. aus der Django-Anleitung, hängst du an den Befehl in Schritt 11
--port 8001an.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von python3-venv kennt.
sudo apt update
2. Werkzeug für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Python selbst ist unter Ubuntu schon installiert.
sudo apt install python3-venv
3. Projektordner anlegen
In diesem Ordner liegen später die virtuelle Umgebung, die Einstellungen und alle Beiträge des Blogs.
mkdir ~/meinblog
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinblog
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an.
python3 -m venv .venv
6. Virtuelle Umgebung einschalten
Danach verwenden pip und pelican in diesem Terminal die Programme aus .venv. In einem neuen Terminal wiederholst du die Schritte 4 und 6.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. Pelican installieren
[markdown] installiert zusätzlich die Bibliothek, mit der Pelican Markdown-Dateien liest. Ohne sie versteht Pelican nur reStructuredText.
pip install "pelican[markdown]"
Prüfen: Die Ausgabe lautet 4.12.0 (oder eine neuere Nummer).
pelican --version
Einen Blog anlegen
8. Grundgerüst erzeugen
Der Assistent fragt einige Angaben ab und legt daraus die Einstellungsdatei pelicanconf.py, den leeren Ordner content für die Beiträge und Hilfsdateien an.
pelican-quickstart
Beantworte die Fragen so:
| Frage | Eingabe |
|---|---|
Where do you want to create your new web site? | Enter (aktueller Ordner) |
What will be the title of this web site? | Mein Blog |
Who will be the author of this web site? | dein Name |
What will be the default language of this web site? | de |
Do you want to specify a URL prefix? | n |
Do you want to enable article pagination? | Enter (ja) |
How many articles per page do you want? | Enter (10) |
What is your time zone? | Europe/Berlin |
Do you want to generate a tasks.py/Makefile …? | Enter (ja) |
alle Fragen Do you want to upload your website using …? | Enter (nein) |
Prüfen: Die Ausgabe endet mit Done. Your new project is available at …/meinblog.
9. Einen Beitrag schreiben
Beiträge sind Markdown-Dateien im Ordner content. Den Dateinamen kannst du frei wählen.
nano content/erster-beitrag.md
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Title: Mein erster Beitrag
Date: 2026-09-26 10:00
Category: Allgemeines
Tags: pelican, blog
Diese Seite wurde mit **Pelican** gebaut.
Die Zeilen oben bis zur ersten Leerzeile sind Metadaten: Titel, Datum, Kategorie und Schlagwörter. Aus Title erzeugt Pelican auch den Dateinamen der fertigen Seite (mein-erster-beitrag.html). Darunter folgt normales Markdown.
10. Website bauen
Liest alle Dateien aus content und schreibt die fertige Website in den Ordner output.
pelican content
Prüfen: Die Ausgabe beginnt mit Done: Processed 1 article. Im Ordner output liegen index.html, mein-erster-beitrag.html und der Ordner theme mit den Stylesheets.
ls output
11. Vorschau starten
--listen startet einen kleinen Webserver für den Ordner output. --autoreload baut die Website bei jeder gespeicherten Änderung in content oder pelicanconf.py neu.
pelican --autoreload --listen
Prüfen: Die Ausgabe enthält Serving site at: http://127.0.0.1:8000. Öffne http://localhost:8000 im Browser. Oben steht „Mein Blog“, darunter der Beitrag mit Kategorie und Schlagwörtern.
Beende die Vorschau mit Strg+C.
12. Beispiel-Links entfernen (optional)
Das Design zeigt unten die Blöcke „links“ und „social“ mit Beispieleinträgen aus pelicanconf.py.
nano pelicanconf.py
Suche mit Strg+W nach LINKS =. Ersetze die Einträge in den eckigen Klammern durch eigene Links oder lösche die Zeilen mit den Einträgen (Strg+K löscht eine Zeile), sodass nur LINKS = [ und die schließende ] übrig bleiben. Mache dasselbe bei SOCIAL =. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Den Inhalt von output kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. In den Projektordner wechseln
cd ~/meinblog
2. Virtuelle Umgebung einschalten
source .venv/bin/activate
3. Neue Version installieren
Einstellungen und Beiträge bleiben erhalten.
pip install --upgrade "pelican[markdown]"
Prüfen: pelican --version zeigt die neue Versionsnummer.
Deinstallieren
1. Virtuelle Umgebung ausschalten
Falls sie im aktuellen Terminal noch eingeschaltet ist.
deactivate
2. Projektordner löschen
Entfernt Pelican, die Einstellungen und alle Beiträge. Achtung: Wer die Beiträge behalten will, kopiert vorher den Ordner ~/meinblog/content.
rm -r ~/meinblog
python3-venv bleibt installiert, weil andere Anleitungen es ebenfalls verwenden.
Prüfen: Der Ordner ist verschwunden.
ls ~/meinblog
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.getpelican.com/
- Lizenz: Pelican steht unter der AGPL-3.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.
Zola
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zola ist ein Generator für statische Websites, der als ein einziges Programm ohne weitere Abhängigkeiten auskommt. Er wandelt Markdown-Dateien mit Hilfe von Vorlagen in fertiges HTML um und bringt Vorschau-Server, Sass-Übersetzung, Syntaxhervorhebung und Suchindex gleich mit.
Vorbemerkungen
- Warum nicht apt oder Snap: Ubuntu 26.04 enthält kein Paket
zola. Im Snap Store gibt es Zola nur im Testkanaledge, nicht als stabile Version. Diese Anleitung verwendet deshalb die fertige Programmdatei, die das Zola-Projekt auf GitHub veröffentlicht. Sie wird nach/usr/local/binkopiert. Dort liegen selbst installierte Programme, getrennt von den Paketen aus apt. - Version: Getestet mit Zola 0.23.6. Steht auf der Release-Seite eine neuere Version, ersetzt du
0.23.6in den Befehlen durch die neue Nummer. - Design: Zola bringt kein fertiges Design mit. Ohne Vorlagen zeigt die Website nur eine Willkommensseite. In dieser Anleitung legst du drei kleine Vorlagen selbst an. Fertige Designs findest du unter https://www.getzola.org/themes/.
- Port: Die Vorschau läuft auf Port 1111, nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketversionen kennt.
sudo apt update
2. curl installieren
Mit curl lädst du die Programmdatei herunter. Meist ist es schon installiert. Dann meldet apt nur, dass es bereits die neueste Version ist.
sudo apt install curl
3. Archiv herunterladen
Lädt die Linux-Version für 64-Bit-Intel/AMD-Prozessoren nach /tmp. -L folgt der Weiterleitung von GitHub zum eigentlichen Download.
curl -L -o /tmp/zola.tar.gz https://github.com/getzola/zola/releases/download/v0.23.6/zola-v0.23.6-x86_64-unknown-linux-gnu.tar.gz
Prüfen: Die Datei ist rund 16 MB groß.
ls -lh /tmp/zola.tar.gz
4. Prüfsumme kontrollieren
Die Prüfsumme zeigt, ob die Datei vollständig und unverändert angekommen ist.
sha256sum /tmp/zola.tar.gz
Prüfen: Bei Version 0.23.6 lautet die Ausgabe 8f5132b3522412d04e395e0b25f6d68613ad272a873e54a2b3ebf664873024a4. Bei einer neueren Version vergleichst du mit dem Wert, den GitHub auf der Release-Seite unter „Assets“ neben der Datei zola-v…-x86_64-unknown-linux-gnu.tar.gz anzeigt (sha256:…).
5. Programm auspacken
Das Archiv enthält neben dem Programm zola noch Lizenztexte und Hilfedateien. Der Name zola am Ende sorgt dafür, dass nur das Programm nach /usr/local/bin ausgepackt wird.
sudo tar -xzf /tmp/zola.tar.gz -C /usr/local/bin zola
Prüfen: Die Ausgabe lautet zola 0.23.6.
zola --version
6. Archiv löschen
Das heruntergeladene Archiv wird nicht mehr gebraucht.
rm /tmp/zola.tar.gz
Eine Website anlegen
7. Grundgerüst erzeugen
Legt den Ordner ~/meineseite mit der Einstellungsdatei zola.toml und den leeren Ordnern content (Texte), templates (Vorlagen), static (Bilder und andere Dateien), sass und themes an.
zola init ~/meineseite
Der Assistent stellt drei Fragen. Drücke jedes Mal Enter, um den Vorschlag zu übernehmen:
| Frage | Eingabe |
|---|---|
What is the URL of your site? | Enter (https://example.com, später änderbar) |
Do you want to enable Sass compilation? | Enter (ja) |
Do you want to build a search index of the content? | Enter (nein) |
Prüfen: Die Ausgabe enthält Done! Your site was created in …/meineseite.
8. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meineseite
9. Titel und Sprache einstellen
In zola.toml stehen die Einstellungen der Website.
nano zola.toml
Gehe in die Zeile base_url = "https://example.com" und drücke am Zeilenende Enter. Füge dort diese zwei Zeilen ein (Strg+Umschalt+V):
title = "Meine Website"
default_language = "de"
Die Zeilen müssen oberhalb von [markdown] stehen. Alles unter einer Zeile in eckigen Klammern gehört zu diesem Abschnitt. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Grundvorlage anlegen
Zola verwendet die Vorlagensprache Tera. In base.html steht das Gerüst, das alle Seiten gemeinsam haben: Kopfbereich, einfache Gestaltung und der Titel der Website als Überschrift. {% block content %} ist der Platz, den die anderen Vorlagen füllen.
nano templates/base.html
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="{{ lang }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{% block title %}{{ config.title }}{% endblock %}</title>
<style>
body { max-width: 42rem; margin: 2rem auto; padding: 0 1rem; font-family: sans-serif; line-height: 1.6; }
header a { color: inherit; text-decoration: none; }
.datum { color: #666; font-size: 0.9rem; }
</style>
</head>
<body>
<header><h1><a href="{{ get_url(path='/') }}">{{ config.title }}</a></h1></header>
<main>{% block content %}{% endblock %}</main>
</body>
</html>
11. Vorlage für die Startseite anlegen
Die Startseite zeigt den Begrüßungstext und darunter eine Liste aller Beiträge mit Datum.
nano templates/index.html
Füge diesen Inhalt ein, speichere und beende nano:
{% extends "base.html" %}
{% block content %}
{{ section.content | safe }}
<ul>
{% for page in section.pages %}
<li><a href="{{ page.permalink }}">{{ page.title }}</a> <span class="datum">{{ page.date | date(format="%d.%m.%Y") }}</span></li>
{% endfor %}
</ul>
{% endblock %}
extends "base.html"– übernimmt das Gerüst aus Schritt 10.section.pages– alle Beiträge im Ordnercontent.| safe– gibt das aus Markdown erzeugte HTML unverändert aus, statt die spitzen Klammern zu maskieren.
12. Vorlage für einzelne Beiträge anlegen
Zeigt Titel, Datum und Text eines Beitrags.
nano templates/page.html
Füge diesen Inhalt ein, speichere und beende nano:
{% extends "base.html" %}
{% block title %}{{ page.title }} – {{ config.title }}{% endblock %}
{% block content %}
<h2>{{ page.title }}</h2>
<p class="datum">{{ page.date | date(format="%d.%m.%Y") }}</p>
{{ page.content | safe }}
{% endblock %}
13. Text der Startseite anlegen
Die Datei _index.md (mit Unterstrich) gehört zur Startseite. Der Bereich zwischen den +++-Zeilen enthält Einstellungen im TOML-Format. sort_by = "date" sortiert die Beiträge nach Datum, die neuesten zuerst.
nano content/_index.md
Füge diesen Inhalt ein, speichere und beende nano:
+++
sort_by = "date"
+++
Willkommen auf meiner Website.
14. Einen Beitrag schreiben
Jede andere Markdown-Datei in content ist ein Beitrag. Aus dem Dateinamen wird die Adresse, hier /erster-beitrag/.
nano content/erster-beitrag.md
Füge diesen Inhalt ein, speichere und beende nano:
+++
title = "Mein erster Beitrag"
date = 2026-09-26
+++
Diese Seite wurde mit **Zola** gebaut.
15. Vorschau starten
zola serve baut die Website und startet einen kleinen Webserver. Jede gespeicherte Änderung an Texten, Vorlagen oder zola.toml baut die Seite sofort neu und lädt sie im Browser automatisch neu.
zola serve
Prüfen: Die Ausgabe enthält Creating 1 pages und Web server is available at http://127.0.0.1:1111. Öffne http://localhost:1111 im Browser. Oben steht „Meine Website“, darunter der Begrüßungstext und der Beitrag mit Datum.
Beende die Vorschau mit Strg+C. Ist Port 1111 schon belegt, startest du die Vorschau mit zola serve --port 1112.
16. Website für die Veröffentlichung bauen
Trage vorher in zola.toml bei base_url die echte Adresse deiner Website ein, sonst zeigen die Links auf example.com. Der Befehl schreibt die fertige Website in den Ordner public.
zola build
Prüfen: Im Ordner public liegen index.html, 404.html, sitemap.xml und der Ordner erster-beitrag.
ls public
Den Inhalt von public kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. Neue Version herunterladen
Ersetze 0.23.6 an beiden Stellen durch die neue Versionsnummer.
curl -L -o /tmp/zola.tar.gz https://github.com/getzola/zola/releases/download/v0.23.6/zola-v0.23.6-x86_64-unknown-linux-gnu.tar.gz
2. Prüfsumme kontrollieren
Vergleiche die Ausgabe mit dem Wert auf der Release-Seite, wie in Schritt 4 der Installation.
sha256sum /tmp/zola.tar.gz
3. Programm ersetzen
Überschreibt die alte Programmdatei. Deine Websites bleiben unverändert.
sudo tar -xzf /tmp/zola.tar.gz -C /usr/local/bin zola
Prüfen: zola --version zeigt die neue Versionsnummer. Lies vor dem Aktualisieren die Änderungsliste auf der Release-Seite. Neue Versionen ändern gelegentlich Einstellungen, die dann in zola.toml angepasst werden müssen.
4. Archiv löschen
rm /tmp/zola.tar.gz
Deinstallieren
1. Programm löschen
Zola besteht nur aus dieser einen Datei.
sudo rm /usr/local/bin/zola
Prüfen: Die Ausgabe meldet, dass der Befehl bzw. die Datei nicht gefunden wurde.
zola --version
2. Website löschen (optional)
Entfernt Einstellungen, Vorlagen, Texte und die gebaute Website. Achtung: Wer die Texte behalten will, kopiert vorher den Ordner ~/meineseite/content.
rm -r ~/meineseite
curl bleibt installiert, weil andere Programme und Anleitungen es ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.getzola.org/documentation/
- Lizenz: Zola steht unter der MIT.
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.
Eleventy
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Eleventy (kurz 11ty) ist ein Generator für statische Websites auf Basis von Node.js. Er macht aus Markdown-, HTML- und Vorlagendateien fertige HTML-Seiten, schreibt kein bestimmtes Design oder Framework vor und liefert standardmäßig kein JavaScript an den Browser aus.
Vorbemerkungen
- Kein apt-Paket: Eleventy ist nicht in den Ubuntu-Paketquellen enthalten. Es wird nicht systemweit installiert, sondern pro Projekt über
npm, den Paketmanager von Node.js. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Version: Getestet mit Eleventy 3.1.6 und Node.js 22 aus Ubuntu 26.04. Eleventy 3 braucht Node.js 18 oder neuer.
- Design: Eleventy bringt kein Design mit. In dieser Anleitung legst du eine kleine Vorlage selbst an. Fertige Vorlagen für ganze Websites heißen bei Eleventy „Starter Projects“ und sind unter https://www.11ty.dev/docs/starter/ aufgelistet.
- Port: Die Vorschau läuft auf Port 8080. Ist er belegt, z. B. durch den Apache aus der Tileserver-Anleitung, weicht Eleventy von selbst auf den nächsten freien Port aus (8081, 8082 …).
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Eleventy aus, npm lädt es herunter. Das Paket npm bringt auch den Befehl npx mit, der Programme aus dem Projektordner startet. Ist beides schon vorhanden (z. B. aus der VitePress-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v18, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v18 ist.
Eine Website anlegen
3. Projektordner anlegen
In diesem Ordner liegen später Eleventy, die Vorlage und alle Texte.
mkdir ~/mein-eleventy
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/mein-eleventy
5. Projektdatei anlegen
Legt package.json an. Darin hält npm fest, welche Pakete das Projekt braucht. -y übernimmt alle Vorgaben, ohne nachzufragen.
npm init -y
6. Eleventy im Projekt installieren
Lädt Eleventy in den Ordner node_modules und trägt es in package.json ein. -D markiert es als Entwicklungswerkzeug: Es wird zum Bauen gebraucht, ist aber nicht Teil der fertigen Website.
npm install -D @11ty/eleventy
Prüfen: Die Ausgabe lautet 3.1.6 (oder eine neuere Nummer).
npx @11ty/eleventy --version
7. Ordner für Vorlagen anlegen
Eleventy sucht Vorlagen (Layouts) im Ordner _includes. Ordner und Dateien, deren Name mit _ beginnt, werden nicht als eigene Seiten ausgegeben.
mkdir _includes
8. Vorlage anlegen
Die Vorlage ist in Nunjucks geschrieben, einer von mehreren Vorlagensprachen, die Eleventy versteht. Sie enthält das Gerüst, das alle Seiten gemeinsam haben. An der Stelle {{ content | safe }} setzt Eleventy den Inhalt der jeweiligen Seite ein, {{ title }} wird durch deren Titel ersetzt.
nano _includes/basis.njk
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ title }}</title>
<style>
body { max-width: 42rem; margin: 2rem auto; padding: 0 1rem; font-family: sans-serif; line-height: 1.6; }
header a { color: inherit; text-decoration: none; }
.datum { color: #666; font-size: 0.9rem; }
</style>
</head>
<body>
<header><h1><a href="/">Meine Website</a></h1></header>
<main>
{{ content | safe }}
</main>
</body>
</html>
9. Ordner für Beiträge anlegen
Eleventy übernimmt die Ordnerstruktur in die Adressen. Ein Beitrag in beitraege ist später unter /beitraege/…/ erreichbar.
mkdir beitraege
10. Einen Beitrag schreiben
nano beitraege/erster-beitrag.md
Füge diesen Inhalt ein, speichere und beende nano:
---
layout: basis.njk
title: Mein erster Beitrag
date: 2026-09-26
tags: beitrag
---
Diese Seite wurde mit **Eleventy** gebaut.
Der Bereich zwischen den ----Zeilen heißt Front Matter und enthält Angaben zur Seite:
layout– die Vorlage aus Schritt 8.titleunddate– Titel und Datum des Beitrags.tags: beitrag– nimmt die Seite in die Sammlungbeitragauf. Über diese Sammlung listet die Startseite alle Beiträge auf.
11. Startseite anlegen
Die Startseite ist ebenfalls eine Nunjucks-Datei. Sie geht die Sammlung beitrag durch und gibt zu jedem Beitrag Link und Datum aus. reverse dreht die Reihenfolge um, damit der neueste Beitrag oben steht.
nano index.njk
Füge diesen Inhalt ein, speichere und beende nano:
---
layout: basis.njk
title: Meine Website
---
<p>Willkommen auf meiner Website.</p>
<ul>
{%- for beitrag in collections.beitrag | reverse %}
<li><a href="{{ beitrag.url }}">{{ beitrag.data.title }}</a> <span class="datum">{{ beitrag.date.toLocaleDateString("de-DE") }}</span></li>
{%- endfor %}
</ul>
12. Website bauen
Eleventy liest alle passenden Dateien im Projektordner und schreibt die fertige Website in den Ordner _site. Den Ordner node_modules lässt es dabei von selbst aus.
npx @11ty/eleventy
Prüfen: Die Ausgabe endet mit Wrote 2 files. In _site liegen index.html und beitraege/erster-beitrag/index.html.
find _site -type f
13. Vorschau starten
--serve baut die Website, startet einen kleinen Webserver und baut bei jeder gespeicherten Änderung neu. Der Browser lädt die Seite dann automatisch neu.
npx @11ty/eleventy --serve
Prüfen: Die Ausgabe endet mit Server at http://localhost:8080/ (oder einem anderen Port, siehe Vorbemerkungen). Öffne diese Adresse im Browser. Oben steht „Meine Website“, darunter der Begrüßungstext und der Beitrag mit Datum.
Beende die Vorschau mit Strg+C.
Den Inhalt von _site kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. In den Projektordner wechseln
cd ~/mein-eleventy
2. Neue Version installieren
@latest holt die neueste Version, auch wenn sich die erste Stelle der Versionsnummer ändert. Vorlage und Texte bleiben erhalten. Lies vor einem Sprung auf eine neue Hauptversion die Hinweise unter https://www.11ty.dev/blog/.
npm install -D @11ty/eleventy@latest
Prüfen: npx @11ty/eleventy --version zeigt die neue Versionsnummer.
Deinstallieren
1. Projektordner löschen
Eleventy steckt nur im Ordner node_modules des Projekts. Mit dem Projektordner verschwinden Eleventy, Vorlage, Texte und die gebaute Website. Achtung: Wer die Texte behalten will, kopiert vorher die Markdown-Dateien.
rm -r ~/mein-eleventy
Prüfen: Der Ordner ist verschwunden.
ls ~/mein-eleventy
2. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf, damit spätere Installationen schneller gehen. Dieser Befehl leert den Speicher und betrifft alle Node.js-Projekte, die dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js und npm bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.11ty.dev/docs/
- Lizenz: Eleventy steht unter der MIT.
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.
Nikola
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Nikola ist ein Generator für statische Websites und Blogs in Python. Er bringt ein fertiges Design, Archiv, Kategorien, Schlagwörter, RSS-Feed, Bildergalerien und deutsche Beschriftungen mit und baut bei Änderungen nur die Seiten neu, die sich wirklich geändert haben.
Vorbemerkungen
- Kein apt-Paket: Nikola ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung installiert es deshalb mit
pipin eine virtuelle Umgebung (venv), einen eigenen Ordner nur für dieses Projekt, siehe Python. Das System-Python bleibt so unverändert. - Version: Getestet mit Nikola 8.3.3 und Python 3.14 aus Ubuntu 26.04.
- Keine automatische Vorschau: Der Befehl
nikola auto, der die Website bei jeder Änderung neu baut, bricht in Version 8.3.3 unter Python 3.14 mit einem Fehler ab. Diese Anleitung verwendet deshalbnikola buildzum Bauen undnikola servefür die Vorschau. - Port: Die Vorschau läuft auf Port 8000, nur vom eigenen Rechner aus erreichbar. Läuft dort schon ein anderes Programm, z. B. aus der Pelican-Anleitung, hängst du an den Befehl in Schritt 12
--port 8001an.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von python3-venv kennt.
sudo apt update
2. Werkzeug für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Python selbst ist unter Ubuntu schon installiert.
sudo apt install python3-venv
3. Projektordner anlegen
In diesem Ordner liegen später die virtuelle Umgebung, die Einstellungen und alle Beiträge.
mkdir ~/meinnikola
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinnikola
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an.
python3 -m venv .venv
6. Virtuelle Umgebung einschalten
Danach verwenden pip und nikola in diesem Terminal die Programme aus .venv. In einem neuen Terminal wiederholst du die Schritte 4 und 6.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. Nikola installieren
Installiert Nikola mit allem, was es für Markdown, das Standard-Design und die Vorschau braucht.
pip install Nikola
Prüfen: Die Ausgabe lautet Nikola v8.3.3 (oder eine neuere Nummer).
nikola version
Eine Website anlegen
8. Grundgerüst erzeugen
Der Punkt steht für den aktuellen Ordner. Der Assistent fragt einige Angaben ab, schreibt sie in die Einstellungsdatei conf.py und legt die Ordner posts (Blogbeiträge), pages (feste Seiten wie „Über mich“), images, galleries, files und listings an.
nikola init .
Beantworte die Fragen so:
| Frage | Eingabe |
|---|---|
Site title | Meine Website |
Site author | dein Name |
Site author's e-mail | deine E-Mail-Adresse (erscheint im RSS-Feed) |
Site description | ein kurzer Satz über die Website |
Site URL | Enter (https://example.com/, später in conf.py änderbar) |
Enable pretty URLs …? | Enter (ja, Adressen wie /posts/titel/) |
Language(s) to use | de |
Time zone | Enter (Nikola schlägt die Zeitzone des Rechners vor, z. B. Europe/Berlin) |
Use this time zone? | Enter (ja) |
Comment system | Enter (keine Kommentare) |
Prüfen: Die Ausgabe endet mit That's it, Nikola is now configured.
9. Einen Beitrag anlegen
new_post legt im Ordner posts eine neue Datei mit allen Metadaten und dem aktuellen Datum an. -f markdown wählt Markdown als Format, -t setzt den Titel. Aus dem Titel bildet Nikola den Dateinamen und die Adresse.
nikola new_post -f markdown -t "Mein erster Beitrag"
Prüfen: Die Datei posts/mein-erster-beitrag.md ist vorhanden.
ls posts
10. Beitrag schreiben
nano posts/mein-erster-beitrag.md
Oben in der Datei steht ein Kommentarblock (<!-- bis -->) mit den Metadaten. Gehe in die Zeile .. tags: und schreibe dahinter nikola, blog. Ersetze ganz unten den Platzhaltertext Schreibe hier deinen Eintrag hin. durch deinen Text, zum Beispiel:
Diese Seite wurde mit **Nikola** gebaut.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Website bauen
Liest Beiträge und Seiten und schreibt die fertige Website in den Ordner output. Beim ersten Mal kopiert Nikola auch das Design dorthin, jedes weitere Mal baut es nur die geänderten Seiten neu.
nikola build
Prüfen: Im Ordner output liegen unter anderem index.html, archive.html, rss.xml und der Ordner posts.
ls output
12. Vorschau starten
Startet einen kleinen Webserver für den Ordner output. Ohne -a 127.0.0.1 wäre die Vorschau im ganzen Netzwerk erreichbar.
nikola serve -a 127.0.0.1
Prüfen: Die Ausgabe enthält Serving on http://127.0.0.1:8000/. Öffne http://localhost:8000 im Browser. Oben steht „Meine Website“, darunter der Beitrag mit Datum und Schlagwörtern.
Beende die Vorschau mit Strg+C. Nach jeder Änderung an Beiträgen oder conf.py rufst du nikola build erneut auf und lädst die Seite im Browser neu.
13. Website für die Veröffentlichung vorbereiten
In conf.py stehen alle Einstellungen, gut kommentiert.
nano conf.py
Suche mit Strg+W nach SITE_URL = und ersetze https://example.com/ durch die echte Adresse deiner Website, sonst zeigen RSS-Feed und Sitemap auf example.com. Speichere mit Strg+O und Enter, beende nano mit Strg+X und baue die Website mit nikola build neu.
Den Inhalt von output kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. In den Projektordner wechseln
cd ~/meinnikola
2. Virtuelle Umgebung einschalten
source .venv/bin/activate
3. Neue Version installieren
Einstellungen und Beiträge bleiben erhalten.
pip install --upgrade Nikola
Prüfen: nikola version zeigt die neue Versionsnummer. Danach mit nikola build neu bauen.
Deinstallieren
1. Virtuelle Umgebung ausschalten
Falls sie im aktuellen Terminal noch eingeschaltet ist.
deactivate
2. Projektordner löschen
Entfernt Nikola, die Einstellungen, alle Beiträge und die gebaute Website. Achtung: Wer die Beiträge behalten will, kopiert vorher die Ordner ~/meinnikola/posts und ~/meinnikola/pages.
rm -r ~/meinnikola
Prüfen: Der Ordner ist verschwunden.
ls ~/meinnikola
python3-venv bleibt installiert, weil andere Anleitungen es ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://getnikola.com/documentation.html
- Lizenz: Nikola steht unter der MIT.
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.
Hexo
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Hexo ist ein Blog-Generator auf Basis von Node.js. Er macht aus Beiträgen in Markdown einen fertigen statischen Blog mit Archiv, Schlagwörtern und Kategorien und bringt dafür das Design „landscape“ gleich mit.
Vorbemerkungen
- Kein apt-Paket: Hexo ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt über
npm, den Paketmanager von Node.js, installiert. Aus den Ubuntu-Paketquellen kommen nur Node.js, npm und Git. - Ohne globale Installation: Viele Anleitungen installieren das Hilfsprogramm
hexo-climitsudo npm install -gsystemweit. Das ist nicht nötig. Hier wird es mitnpxnur einmal zum Anlegen des Projekts geladen, danach steckt Hexo im Projektordner. - Version: Getestet mit Hexo 8.1.2 und hexo-cli 4.3.2 unter Node.js 22 aus Ubuntu 26.04. Hexo 8 braucht Node.js 20.19 oder neuer.
- Port: Die Vorschau läuft auf Port 4000, nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js, npm und Git kennt.
sudo apt update
2. Node.js, npm und Git installieren
Node.js führt Hexo aus, npm lädt es herunter und bringt den Befehl npx mit. Git braucht Hexo, um die Projektvorlage herunterzuladen. Ist alles schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm git
Prüfen: Die Ausgabe ist eine Versionsnummer ab v20.19, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v20.19 ist.
Einen Blog anlegen
3. Projekt erzeugen
npx lädt hexo-cli vorübergehend herunter und führt es aus. init legt den Ordner ~/meinhexo an, lädt die offizielle Projektvorlage hinein und installiert Hexo samt Design in den Unterordner node_modules. Das dauert etwa eine Minute.
npx hexo-cli init ~/meinhexo
Die Frage Need to install the following packages: hexo-cli … Ok to proceed? (y) beantwortest du mit Enter.
Prüfen: Die Ausgabe endet mit INFO Start blogging with Hexo!. Hinweise von npm auf eine neuere npm-Version kannst du ignorieren.
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt. npx hexo startet dann immer das Hexo aus diesem Projekt.
cd ~/meinhexo
Prüfen: Die Ausgabe beginnt mit hexo: 8.1.2 (oder einer neueren Nummer).
npx hexo version
5. Titel, Sprache und Zeitzone einstellen
In _config.yml stehen die Einstellungen des Blogs im YAML-Format.
nano _config.yml
Ändere im Abschnitt # Site oben in der Datei diese vier Zeilen. Wichtig: Nach dem Doppelpunkt steht immer ein Leerzeichen.
title: Meine Website
author: Dein Name
language: de
timezone: Europe/Berlin
language: de– das Design beschriftet Menüs und Links auf Deutsch, z. B. „Archiv“.timezone– bestimmt, zu welcher Uhrzeit ein Beitrag als veröffentlicht gilt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Beispielbeitrag löschen
Die Vorlage enthält einen englischen Beitrag „Hello World“, der nicht gebraucht wird.
rm source/_posts/hello-world.md
7. Einen Beitrag anlegen
Legt im Ordner source/_posts eine neue Markdown-Datei mit Titel und aktuellem Datum an. Den Dateinamen bildet Hexo aus dem Titel.
npx hexo new "Mein erster Beitrag"
Prüfen: Die Ausgabe endet mit Created: …/source/_posts/Mein-erster-Beitrag.md.
8. Beitrag schreiben
nano source/_posts/Mein-erster-Beitrag.md
Oben zwischen den ----Zeilen stehen die Angaben zum Beitrag (Front Matter). Ergänze die Zeile tags: zu tags: [hexo, blog]. Schreibe unter die zweite ----Zeile deinen Text, zum Beispiel:
Diese Seite wurde mit **Hexo** gebaut.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Vorschau starten
server startet einen kleinen Webserver und baut jede gespeicherte Änderung an Beiträgen sofort ein. -i 127.0.0.1 beschränkt ihn auf den eigenen Rechner, sonst wäre er im ganzen Netzwerk erreichbar.
npx hexo server -i 127.0.0.1
Prüfen: Die Ausgabe enthält Hexo is running at http://127.0.0.1:4000/. Öffne http://localhost:4000 im Browser. Oben steht „Meine Website“, darunter der Beitrag mit Datum und Schlagwörtern.
Beende die Vorschau mit Strg+C. Ist Port 4000 schon belegt, hängst du -p 4001 an den Befehl an.
10. Website bauen
Schreibt die fertige Website in den Ordner public. Trage vorher in _config.yml bei url: die echte Adresse deines Blogs ein, sonst zeigen einige Links auf example.com.
npx hexo generate
Prüfen: Die Ausgabe endet mit files generated in …. Im Ordner public liegen unter anderem index.html, archives und tags.
ls public
Den Inhalt von public kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Werden gelöschte Beiträge oder geänderte Einstellungen einmal nicht übernommen, löscht npx hexo clean den Ordner public und den Zwischenspeicher. Danach baust du neu.
Aktualisieren
1. In den Projektordner wechseln
cd ~/meinhexo
2. Veraltete Pakete anzeigen
Listet Hexo und seine Erweiterungen auf, für die es neuere Versionen gibt.
npm outdated
3. Pakete aktualisieren
Aktualisiert alle Pakete innerhalb ihrer Hauptversion. Beiträge und Einstellungen bleiben erhalten. Für einen Sprung auf eine neue Hauptversion (z. B. Hexo 9) lies vorher die Hinweise unter https://github.com/hexojs/hexo/releases und installiere sie gezielt mit npm install hexo@latest.
npm update
Prüfen: npx hexo version zeigt die neue Versionsnummer.
Deinstallieren
1. Projektordner löschen
Hexo steckt nur im Ordner node_modules des Projekts. Mit dem Projektordner verschwinden Hexo, Design, Einstellungen, Beiträge und die gebaute Website. Achtung: Wer die Beiträge behalten will, kopiert vorher den Ordner ~/meinhexo/source/_posts.
rm -r ~/meinhexo
Prüfen: Der Ordner ist verschwunden.
ls ~/meinhexo
2. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete, auch das vorübergehend geladene hexo-cli, in ~/.npm auf. Dieser Befehl leert den Speicher und betrifft alle Node.js-Projekte, die dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js, npm und Git bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://hexo.io/docs/
- Lizenz: Hexo steht unter der MIT.
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.
Publii
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Publii ist ein Desktop-Programm, mit dem man statische Websites und Blogs in einem Fenster schreibt und gestaltet, ohne Befehle oder Vorlagendateien. Es erzeugt fertiges HTML, zeigt eine Vorschau im Browser und kann die Website auf einen Server hochladen oder in einen Ordner schreiben.
Vorbemerkungen
- Kein apt- oder Snap-Paket: Publii ist weder in den Ubuntu-Paketquellen noch im Snap Store enthalten. Die Anleitung verwendet die offizielle
.deb-Datei von https://getpublii.com/download/. - Version: Getestet mit Publii 0.47.9 unter Ubuntu 26.04.
- Sprache: Die Oberfläche gibt es nur auf Englisch (und Polnisch). Die Menünamen stehen deshalb hier auf Englisch. Die Website selbst kann trotzdem auf Deutsch eingestellt werden (Schritt 7).
- Speicherort: Publii legt alle Websites, Designs und Sicherungen im Ordner
~/Dokumente/Publiiab. Die Programmeinstellungen liegen in~/.config/Publii.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Bibliotheken kennt, die Publii braucht.
sudo apt update
2. Publii herunterladen
Lädt das Paket (etwa 135 MB) in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://getpublii.com/download/. Bei einer neueren Version ersetzt du 0.47.9 im Befehl.
wget -O /tmp/publii.deb https://cdn.getpublii.com/Publii-0.47.9.deb
Prüfen: Die Datei ist rund 135 MB groß.
ls -lh /tmp/publii.deb
3. Publii installieren
Der Pfad mit / am Anfang sagt apt, dass es eine lokale Datei installieren soll. Fehlende Bibliotheken holt apt dabei aus den Ubuntu-Paketquellen. Das Paket legt das Programm nach /opt/Publii, den Befehl Publii nach /usr/bin, einen Eintrag ins Startmenü und ein AppArmor-Profil nach /etc/apparmor.d/Publii. Ohne dieses Profil würde Ubuntu die Sicherheits-Sandbox des Programms blockieren.
sudo apt install /tmp/publii.deb
Prüfen: Die Zeile beginnt mit ii und enthält 0.47.9.
dpkg -l publii
4. Heruntergeladene Datei löschen
Das Paket ist installiert, die Datei wird nicht mehr gebraucht.
rm /tmp/publii.deb
Erste Schritte
5. Publii starten
Starte Publii über das Startmenü (Suchbegriff „Publii“) oder im Terminal. Der Befehl beginnt mit einem großen P.
Publii
Prüfen: Das Fenster öffnet sich mit der Schaltfläche Create your first website. Meldungen im Terminal wie vaInitialize failed oder DeprecationWarning sind nur Hinweise und stören nicht.
6. Website anlegen
Klicke auf Create your first website. Trage unter Website name z. B. Meine Website und unter Author name deinen Namen ein. Lass das Design Simple ausgewählt und klicke auf Create website.
Links erscheint jetzt die Seitenleiste mit Posts (Beiträge), Tags (Schlagwörter), Authors, Menus, Theme (Design), Settings (Einstellungen), Server und Tools & Plugins.
7. Sprache der Website einstellen
Öffne links Settings. Wähle im Bereich Basic settings im Feld Language die Sprache Deutsch und klicke oben auf Save Settings. Diese Einstellung bestimmt die Sprache, in der das Design Datumsangaben und feste Beschriftungen ausgibt, und die Sprachangabe im HTML der Website.
8. Einen Beitrag schreiben
Öffne links Posts und klicke auf Add new post. Publii fragt, mit welchem Editor du schreiben möchtest:
- WYSIWYG editor – wie in einem Textverarbeitungsprogramm.
- Block editor – der Text besteht aus Blöcken (Absatz, Überschrift, Bild …).
- Markdown editor – für alle, die Markdown gewohnt sind.
Wähle einen Editor, gib oben einen Titel ein, z. B. Mein erster Beitrag, und schreibe darunter einen Text. Klicke dann auf Publish post.
Prüfen: Der Beitrag steht in der Liste unter Posts. Beiträge, die nur gespeichert, aber nicht veröffentlicht sind, führt Publii als Drafts (Entwürfe).
9. Vorschau ansehen
Klicke links unten auf Preview your changes. Publii baut die Website und öffnet sie im Standardbrowser.
Prüfen: Der Browser zeigt die Website mit dem Titel „Meine Website“ und deinem Beitrag.
10. Website in einen Ordner ausgeben
Um die fertigen HTML-Dateien selbst auf einen Webserver zu kopieren, stellst du Publii auf „manuelle Ausgabe“ um. Öffne links Server und wähle als Übertragungsart Manual deployment. Stelle Output type auf Non-compressed catalog und wähle unter Output directory einen leeren Ordner, z. B. ~/meine-website. Trage bei Website URL die spätere echte Adresse ein und klicke auf Save Settings.
Klicke danach links unten auf Sync your website. Publii schreibt die komplette Website in den gewählten Ordner. Den Inhalt kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben. Unter Server kann Publii die Website stattdessen auch direkt hochladen, z. B. per SFTP oder FTP, zu GitHub Pages, GitLab Pages, Netlify oder Google Cloud.
Aktualisieren
Publii aktualisiert sich nicht selbst, weil es aus einer .deb-Datei ohne Paketquelle stammt. Zum Aktualisieren wiederholst du die Schritte 2 bis 4 mit der neuen Versionsnummer. apt ersetzt dabei die alte Version. Websites und Einstellungen in ~/Dokumente/Publii bleiben erhalten.
Prüfen: dpkg -l publii zeigt die neue Versionsnummer.
Deinstallieren
1. Publii beenden
Schließe das Publii-Fenster, damit keine Dateien mehr geöffnet sind.
2. Paket entfernen
Entfernt das Programm, den Startmenü-Eintrag, das AppArmor-Profil und den Befehl Publii.
sudo apt purge publii
Prüfen: Die Ausgabe meldet, dass kein Paket publii gefunden wurde.
dpkg -l publii
3. Programmeinstellungen löschen
Entfernt Zwischenspeicher und Fenstereinstellungen von Publii. Deine Websites sind davon nicht betroffen.
rm -r ~/.config/Publii
4. Websites löschen (optional)
Entfernt alle mit Publii angelegten Websites samt Beiträgen, Bildern und Sicherungen. Achtung: Das lässt sich nicht rückgängig machen. Wer die Websites behalten will, überspringt diesen Schritt oder kopiert den Ordner vorher.
rm -r ~/Dokumente/Publii
5. Nicht mehr benötigte Bibliotheken entfernen
Entfernt Pakete, die nur für Publii mitinstalliert wurden. Lies vor dem Bestätigen die Liste: Es sollten nur Bibliotheken darin stehen, keine Programme, die du selbst nutzt.
sudo apt autoremove
Quellen und Lizenz
- Offizielle Dokumentation: https://getpublii.com/docs/
- Lizenz: Publii steht unter der GPL-3.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.
Docsify
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docsify macht aus einem Ordner mit Markdown-Dateien eine Dokumentations-Website mit Seitenleiste und Suche. Es erzeugt dabei keine HTML-Dateien: Eine einzige index.html lädt die Markdown-Dateien erst im Browser und stellt sie dort dar.
Vorbemerkungen
- Kein apt-Paket: Docsify ist nicht in den Ubuntu-Paketquellen enthalten. Das Hilfsprogramm
docsify-cliwird übernpm, den Paketmanager von Node.js, geladen. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Ohne globale Installation:
docsify-cliwird nicht mitsudo npm install -gsystemweit installiert, sondern bei Bedarf mitnpxgestartet. Es wird nur zum Anlegen des Projekts und für die Vorschau gebraucht. - Kein Bauschritt: Anders als bei mdBook oder Hugo gibt es keinen Befehl, der die Website baut. Der Projektordner ist schon die fertige Website.
- Internet nötig: Die
index.htmllädt Docsify selbst, das Design und die Suche vom Dienst jsDelivr (cdn.jsdelivr.net). Beim Aufruf der Website überträgt der Browser dabei die IP-Adresse des Besuchers an jsDelivr. Wer das vermeiden will, muss die Dateien selbst auf dem Server ablegen. Das zeigt diese Anleitung nicht. - Version: Getestet mit Docsify 5.0.0 und docsify-cli 5.0.0 unter Node.js 22 aus Ubuntu 26.04. Beide brauchen Node.js 20.11 oder neuer.
- Port: Die Vorschau soll hier auf Port 3001 laufen. Der voreingestellte Port 3000 ist oft schon belegt, z. B. durch Martin.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt docsify-cli aus, npm lädt es herunter und bringt den Befehl npx mit. Sind beide schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v20.11, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v20.11 ist.
Eine Dokumentation anlegen
3. Projekt erzeugen
npx lädt docsify-cli vorübergehend herunter und führt es aus. init legt den Ordner ~/meindocsify/docs an und schreibt drei Dateien hinein: index.html (die Seite, die Docsify startet), README.md (die Startseite) und .nojekyll (verhindert, dass GitHub Pages Dateien mit _ am Anfang weglässt).
npx docsify-cli init ~/meindocsify/docs
Die Frage Need to install the following packages: docsify-cli … Ok to proceed? (y) beantwortest du mit Enter.
Prüfen: Die Ausgabe enthält Initialization succeeded!.
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meindocsify
Prüfen: Die Ausgabe zeigt index.html und README.md.
ls docs
5. Docsify einstellen
In index.html stehen die Einstellungen im Block window.$docsify. Hier werden der Name der Website, die deutsche Sprache, die Seitenleiste und die Suche eingerichtet.
nano docs/index.html
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein (Strg+Umschalt+V):
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Meine Dokumentation</title>
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@5/dist/themes/core.min.css">
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@5/dist/themes/addons/vue.min.css">
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
name: 'Meine Dokumentation',
loadSidebar: true,
subMaxLevel: 2,
search: {
placeholder: 'Suchen …',
noData: 'Keine Treffer'
}
}
</script>
<script src="//cdn.jsdelivr.net/npm/docsify@5"></script>
<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/plugins/search.min.js"></script>
</body>
</html>
name– steht oben in der Seitenleiste.loadSidebar: true– Docsify baut die Seitenleiste aus der Datei_sidebar.md(Schritt 8).subMaxLevel: 2– unter der geöffneten Seite zeigt die Seitenleiste zusätzlich deren Zwischenüberschriften (##).search– deutsche Texte für das Suchfeld. Die letzte<script>-Zeile lädt die Suche dazu.docsify@5– lädt immer die neueste Version 5.x.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Startseite schreiben
README.md ist die Seite, die beim Aufruf der Website erscheint.
nano docs/README.md
Ersetze den englischen Beispieltext wie in Schritt 5 durch:
# Willkommen
Diese Dokumentation wurde mit **Docsify** erstellt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Eine zweite Seite anlegen
Jede weitere Markdown-Datei im Ordner docs wird eine eigene Seite.
nano docs/installation.md
Füge diesen Inhalt ein:
# Installation
## Voraussetzungen
Ein Rechner mit Ubuntu.
## Schritte
Erst installieren, dann starten.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Seitenleiste anlegen
Ohne diese Datei zeigt die Seitenleiste nur die Überschriften der aktuellen Seite. Jede Zeile ist ein Link auf eine Seite. / steht für die Startseite.
nano docs/_sidebar.md
Füge diesen Inhalt ein:
- [Startseite](/)
- [Installation](installation.md)
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Vorschau starten
serve startet einen kleinen Webserver für den Ordner docs. -p 3001 wählt Port 3001. Der Server lädt die Seite im Browser neu, sobald du eine Datei speicherst.
npx docsify-cli serve docs -p 3001
Prüfen: Die Ausgabe enthält Listening at http://localhost:3001. Öffne http://localhost:3001 im Browser. Links stehen das Suchfeld „Suchen …“, „Meine Dokumentation“ und die beiden Seiten. Nach einem Klick auf „Installation“ erscheinen darunter „Voraussetzungen“ und „Schritte“.
Die Vorschau selbst ist nur vom eigenen Rechner aus erreichbar. Das automatische Neuladen läuft aber über Port 35729 und ist im ganzen Netzwerk offen. Starte die Vorschau deshalb nur in einem vertrauenswürdigen Netz und beende sie mit Strg+C, wenn du sie nicht mehr brauchst.
10. Website veröffentlichen
Einen Bauschritt gibt es nicht: Der Ordner docs ist die Website. Ihn kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben. Kopiere dafür den Inhalt von docs in den Ordner der Website.
Die Seiten haben Adressen wie …/#/installation. Der Teil nach # wird nur im Browser ausgewertet, deshalb braucht der Webserver keine besonderen Einstellungen.
Ein Doppelklick auf index.html im Dateimanager reicht dagegen nicht: Der Browser öffnet die Datei dann ohne Webserver und darf die Markdown-Dateien nicht nachladen. Die Seite bleibt leer.
Aktualisieren
1. Docsify auf der Website
Durch docsify@5 in index.html lädt der Browser automatisch die neueste Version 5.x. Du musst dafür nichts tun. Für eine neue Hauptversion (z. B. Docsify 6) änderst du die Zahl in allen vier Zeilen mit docsify@5, nachdem du die Hinweise unter https://github.com/docsifyjs/docsify/releases gelesen hast.
2. docsify-cli
npx verwendet die Version, die es beim ersten Aufruf zwischengespeichert hat. Mit @latest lädt es die neueste Version.
npx docsify-cli@latest --version
Prüfen: Die Ausgabe zeigt die neue Versionsnummer, z. B. 5.0.0 oder höher.
Deinstallieren
1. Projektordner löschen
Das Projekt besteht nur aus den eigenen Dateien. Achtung: Damit sind auch alle Seiten der Dokumentation gelöscht. Wer sie behalten will, kopiert vorher den Ordner ~/meindocsify/docs.
rm -r ~/meindocsify
Prüfen: ls meldet, dass es den Ordner nicht gibt.
ls ~/meindocsify
2. npm-Zwischenspeicher leeren (optional)
npm bewahrt das vorübergehend geladene docsify-cli in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js und npm bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://docsify.js.org/
- Lizenz: Docsify steht unter der MIT.
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.
Quarto
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Quarto macht aus Markdown-Dateien Websites, Bücher, Präsentationen und PDF-Dokumente. Es baut auf Pandoc auf, bringt Hinweiskästen, Querverweise und eine Suche mit und kann Code in Python, R oder Julia ausführen und die Ergebnisse gleich in die Seite schreiben.
Vorbemerkungen
- Kein apt- oder Snap-Paket: Quarto ist weder in den Ubuntu-Paketquellen noch im Snap Store enthalten. Die Anleitung verwendet die offizielle
.deb-Datei von GitHub. Sie wird bei Updates vonaptnicht erfasst und muss von Hand erneuert werden. - Alles dabei: Das Paket bringt Pandoc, Dart Sass, Deno und Typst in eigenen Versionen mit. Es braucht keine weiteren Pakete aus Ubuntu und stört ein vorhandenes
pandocnicht. - PDF ohne LaTeX: Für PDF-Dateien verwendet diese Anleitung Typst, das schon im Paket steckt. Das Format
pdfbräuchte dagegen eine LaTeX-Installation. - Version: Getestet mit Quarto 1.10.18 unter Ubuntu 26.04. Das Paket belegt nach der Installation etwa 450 MB.
- Port: Die Vorschau soll hier auf Port 4200 laufen, nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt beim Installieren der .deb-Datei auf dem aktuellen Stand ist.
sudo apt update
2. Quarto herunterladen
Lädt das Paket (etwa 150 MB) in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://github.com/quarto-dev/quarto-cli/releases/latest. Bei einer neueren Version ersetzt du 1.10.18 an beiden Stellen im Befehl.
wget -O /tmp/quarto.deb https://github.com/quarto-dev/quarto-cli/releases/download/v1.10.18/quarto-1.10.18-linux-amd64.deb
3. Prüfsummen herunterladen
Die Datei enthält die SHA-256-Prüfsummen aller Pakete dieser Version. Damit lässt sich feststellen, ob der Download vollständig und unverändert ist.
wget -O /tmp/quarto-checksums.txt https://github.com/quarto-dev/quarto-cli/releases/download/v1.10.18/quarto-1.10.18-checksums.txt
4. Prüfsumme vergleichen
Der erste Befehl zeigt die erwartete Prüfsumme, der zweite berechnet die Prüfsumme der heruntergeladenen Datei.
grep linux-amd64.deb /tmp/quarto-checksums.txt
sha256sum /tmp/quarto.deb
Prüfen: Die lange Zeichenfolge am Anfang ist in beiden Ausgaben gleich. Weicht sie ab, lösche die Datei und lade sie noch einmal herunter.
5. Quarto installieren
Der Pfad mit / am Anfang sagt apt, dass es eine lokale Datei installieren soll. Das Paket legt das Programm nach /opt/quarto und den Befehl quarto nach /usr/local/bin.
sudo apt install /tmp/quarto.deb
Prüfen: Die Ausgabe ist die Versionsnummer, z. B. 1.10.18.
quarto --version
6. Heruntergeladene Dateien löschen
Das Paket ist installiert, die beiden Dateien werden nicht mehr gebraucht.
rm /tmp/quarto.deb /tmp/quarto-checksums.txt
7. Installation durchprüfen
quarto check testet die mitgelieferten Programme und rendert zur Probe ein kleines Dokument. Außerdem sucht es nach LaTeX, Python mit Jupyter, R und Julia.
quarto check
Prüfen: Die Zeilen Checking Quarto installation und Checking basic markdown render enden mit OK. Meldungen wie Unable to locate an installed version of R oder Jupyter is not available bedeuten nur, dass diese Sprachen nicht eingerichtet sind. Für diese Anleitung werden sie nicht gebraucht.
Eine Website anlegen
8. Projekt erzeugen
create project website legt den Ordner ~/meinquarto mit einer kleinen Website an: die Einstellungsdatei _quarto.yml, die Seiten index.qmd und about.qmd und die Datei styles.css für eigene Gestaltung. .qmd sind Markdown-Dateien mit Quarto-Erweiterungen. --no-prompt unterdrückt Rückfragen, --no-open verhindert, dass ein Editor startet.
quarto create project website ~/meinquarto "Meine Website" --no-prompt --no-open
Prüfen: Die Ausgabe listet Created _quarto.yml, Created index.qmd, Created about.qmd und Created styles.css.
9. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinquarto
10. Sprache und Menü einstellen
In _quarto.yml stehen die Einstellungen der Website im YAML-Format.
nano _quarto.yml
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein (Strg+Umschalt+V):
project:
type: website
lang: de
website:
title: "Meine Website"
navbar:
left:
- href: index.qmd
text: Startseite
- about.qmd
format:
html:
theme:
- cosmo
- brand
css: styles.css
toc: true
lang: de– feste Beschriftungen wie „Suche“, „Auf dieser Seite“ und „Tipp“ erscheinen auf Deutsch.navbar– die Menüleiste oben. Beim ersten Eintrag steht der Text fest, beim zweiten nimmt Quarto den Titel der Seite.theme–cosmoist eines der mitgelieferten Designs.toc: true– rechts erscheint ein Inhaltsverzeichnis der aktuellen Seite.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Startseite schreiben
nano index.qmd
Ersetze den ganzen Inhalt wie in Schritt 10 durch:
---
title: "Meine Website"
---
Diese Seite wurde mit **Quarto** gebaut.
## Ein Hinweiskasten
::: {.callout-tip}
Quarto kennt Hinweiskästen für Tipps, Warnungen und Hinweise.
:::
## Eine Tabelle
| Werkzeug | Sprache |
|----------|---------|
| Quarto | Markdown |
| mdBook | Markdown |
Oben zwischen den ----Zeilen steht der Titel der Seite. Der Block mit ::: ist ein Hinweiskasten. Statt callout-tip gibt es z. B. auch callout-note und callout-warning.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Zweite Seite schreiben
nano about.qmd
Ersetze den ganzen Inhalt wie in Schritt 10 durch:
---
title: "Über diese Seite"
---
Hier steht, wer die Website betreibt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Vorschau starten
preview baut die Website, startet einen kleinen Webserver auf 127.0.0.1 und baut jede gespeicherte Änderung sofort neu. --port 4200 legt den Port fest, sonst wählt Quarto jedes Mal einen zufälligen. --no-browser verhindert, dass sich der Browser von selbst öffnet.
quarto preview --port 4200 --no-browser
Prüfen: Die Ausgabe enthält Browse at http://localhost:4200/. Öffne http://localhost:4200 im Browser. Oben stehen „Startseite“ und „Über diese Seite“ und rechts die Lupe für die Suche. Die Startseite zeigt einen grünen Kasten „Tipp“ und die Tabelle.
Beende die Vorschau mit Strg+C.
14. Website bauen
Schreibt die fertige Website in den Ordner _site.
quarto render
Prüfen: Die Ausgabe endet mit Output created: _site/index.html. Im Ordner liegen unter anderem index.html, about.html und search.json für die Suche.
ls _site
Den Inhalt von _site kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
15. Eine Seite als PDF ausgeben (optional)
--to typst setzt die Seite mit dem mitgelieferten Typst als PDF. LaTeX ist dafür nicht nötig.
quarto render index.qmd --to typst
Prüfen: Die Ausgabe endet mit Output created: _site/index.pdf. Öffne die Datei mit einem PDF-Betrachter.
xdg-open _site/index.pdf
Aktualisieren
Das Paket kommt nicht aus einer Paketquelle, deshalb bietet apt upgrade keine neuen Versionen an.
1. Neue Version herunterladen und prüfen
Wiederhole die Schritte 1 bis 4 der Installation mit der neuen Versionsnummer von https://github.com/quarto-dev/quarto-cli/releases/latest.
2. Neue Version installieren
apt ersetzt die alte Version durch die neue. Projekte in deinem Home-Verzeichnis bleiben unverändert.
sudo apt install /tmp/quarto.deb
Prüfen: quarto --version zeigt die neue Versionsnummer.
quarto --version
Lösche danach die heruntergeladenen Dateien wie in Schritt 6.
Deinstallieren
1. Quarto entfernen
purge entfernt das Paket samt /opt/quarto und dem Befehl quarto.
sudo apt purge quarto
Prüfen: Die Ausgabe enthält Kommando nicht gefunden (oder No such file or directory, wenn das Terminal den alten Pfad noch kennt).
quarto --version
2. Zwischenspeicher löschen
Quarto legt beim Arbeiten Dateien in ~/.cache/quarto und ~/.local/share/quarto ab. Sie werden ohne Quarto nicht mehr gebraucht.
rm -r ~/.cache/quarto ~/.local/share/quarto
3. Projektordner löschen (optional)
Achtung: Damit sind alle Seiten der Website gelöscht. Wer sie behalten will, lässt diesen Schritt weg oder kopiert vorher die .qmd-Dateien.
rm -r ~/meinquarto
Prüfen: ls meldet, dass es den Ordner nicht gibt.
ls ~/meinquarto
Quellen und Lizenz
- Offizielle Dokumentation: https://quarto.org/docs/guide/
- Lizenz: Quarto steht unter der 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.
Pandoc
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Pandoc wandelt Dokumente zwischen vielen Formaten um, zum Beispiel von Markdown nach HTML, Word (.docx), LibreOffice (.odt) oder PDF und von Word zurück nach Markdown. Es läuft im Terminal und eignet sich deshalb gut, um viele Dateien auf einmal oder immer wieder gleich umzuwandeln.
Vorbemerkungen
- Paket aus Ubuntu: Pandoc ist in den Ubuntu-Paketquellen enthalten und wird mit
aptinstalliert. - PDF ohne LaTeX: Pandoc erzeugt PDF-Dateien nicht selbst, sondern über ein weiteres Programm. Üblich ist LaTeX, das aber mehrere Hundert MB groß ist. Diese Anleitung verwendet stattdessen das kleinere WeasyPrint aus den Ubuntu-Paketquellen. Es setzt die Seite wie ein Browser aus HTML und CSS.
- Verhältnis zu Quarto: Quarto bringt ein eigenes Pandoc mit und baut darauf ganze Websites. Pandoc allein ist das schlankere Werkzeug für einzelne Dateien.
- Version: Getestet mit Pandoc 3.7.0.2 und WeasyPrint 67.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Pandoc installieren
sudo apt install pandoc
Prüfen: Die erste Zeile lautet pandoc 3.7.0.2 (oder eine neuere Nummer).
pandoc --version
3. WeasyPrint für PDF installieren (optional)
Nur nötig, wenn du PDF-Dateien erzeugen willst (Schritt 12).
sudo apt install weasyprint
Prüfen: Die Ausgabe lautet WeasyPrint version 67.0 (oder eine neuere Nummer).
weasyprint --version
Dokumente umwandeln
4. Arbeitsordner anlegen
Ein eigener Ordner hält den Ausgangstext und die erzeugten Dateien zusammen.
mkdir ~/meinpandoc
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinpandoc
6. Ausgangstext in Markdown schreiben
nano text.md
Füge diesen Inhalt ein (Strg+Umschalt+V):
---
title: Mein erstes Dokument
author: Dein Name
lang: de
toc-title: Inhalt
---
# Einleitung
Dieser Text wurde mit **Pandoc** umgewandelt.
# Eine Tabelle
| Format | Endung |
|--------|--------|
| Markdown | .md |
| Word | .docx |
# Eine Liste
1. Text schreiben
2. Umwandeln
3. Ergebnis prüfen
Der Block zwischen den ----Zeilen enthält Angaben zum Dokument (Metadaten). Pandoc übernimmt sie in jedes Ausgabeformat:
titleundauthorerscheinen als Kopf des Dokuments.lang: desagt HTML, Word und LibreOffice, dass der Text deutsch ist. Das ist z. B. für die Silbentrennung und die Rechtschreibprüfung wichtig.toc-titleist die Überschrift des Inhaltsverzeichnisses. Ohne diese Zeile fehlt sie in HTML, in Word stünde dort „Table of Contents“.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. In HTML umwandeln
Pandoc erkennt Eingabe- und Ausgabeformat an den Dateiendungen. -o nennt die Ausgabedatei. -s (standalone) erzeugt eine vollständige HTML-Seite mit Kopf und Gestaltung statt nur eines HTML-Schnipsels. --toc fügt ein Inhaltsverzeichnis ein.
pandoc text.md -s --toc -o text.html
Prüfen: Der Befehl gibt nichts aus, wenn alles in Ordnung ist.
8. HTML-Seite ansehen
Öffnet die Datei im Standardbrowser.
xdg-open text.html
Prüfen: Oben stehen der Titel und „Dein Name“, darunter das Inhaltsverzeichnis „Inhalt“ mit drei Einträgen. Danach folgen der Text, die Tabelle und die Liste.
9. In ein Word-Dokument umwandeln
Erzeugt text.docx. Die Datei lässt sich mit Microsoft Word und LibreOffice Writer öffnen. Bei .docx ist -s nicht nötig, das Ergebnis ist immer ein vollständiges Dokument.
pandoc text.md --toc -o text.docx
Prüfen: Die Datei öffnet sich in LibreOffice Writer (falls installiert) mit Titel, Inhaltsverzeichnis und Tabelle.
xdg-open text.docx
10. In ein LibreOffice-Dokument umwandeln
Erzeugt text.odt im offenen Format von LibreOffice.
pandoc text.md -o text.odt
Prüfen: Die Ausgabe enthält OpenDocument Text.
file text.odt
11. Word-Dokument zurück in Markdown umwandeln
Pandoc kann auch Word-Dateien lesen, z. B. um sie in eine Dokumentation zu übernehmen. -t gfm wählt Markdown in der Schreibweise von GitHub. Tabellen erscheinen dann mit senkrechten Strichen wie im Ausgangstext.
pandoc text.docx -t gfm -o zurueck.md
Prüfen: Die Datei enthält die Überschriften mit #, das fett gedruckte **Pandoc**, die Tabelle und die Liste.
cat zurueck.md
Titel und Autor aus dem Kopf gehen bei diesem Weg verloren, weil Word sie nicht im Text, sondern in den Dokumenteigenschaften speichert.
12. In PDF umwandeln (optional)
Nur möglich, wenn Schritt 3 ausgeführt wurde. --pdf-engine=weasyprint sagt Pandoc, dass es WeasyPrint statt LaTeX verwenden soll.
pandoc text.md --toc --pdf-engine=weasyprint -o text.pdf
Meldungen wie WARNING: Ignored … unknown property betreffen nur CSS-Angaben, die WeasyPrint nicht kennt. Sie stören das Ergebnis nicht.
Prüfen: Die Datei öffnet sich im PDF-Betrachter mit Titel, Inhaltsverzeichnis und Tabelle.
xdg-open text.pdf
Eine Liste aller Formate, die Pandoc lesen bzw. schreiben kann, zeigen pandoc --list-input-formats und pandoc --list-output-formats.
Aktualisieren
Pandoc und WeasyPrint kommen aus den Ubuntu-Paketquellen und werden mit den normalen Systemupdates aktualisiert.
sudo apt update && sudo apt upgrade
Deinstallieren
1. Pandoc und WeasyPrint entfernen
purge entfernt die Programme samt ihrer Systemdateien. Hast du Schritt 3 ausgelassen, meldet apt für weasyprint nur, dass das Paket nicht installiert ist.
sudo apt purge pandoc weasyprint
2. Nicht mehr benötigte Pakete entfernen
Entfernt die Bibliotheken, die mit Pandoc und WeasyPrint installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.
sudo apt autoremove --purge
Das kleine Paket python3-brotli, das mit WeasyPrint kam, bleibt dabei manchmal zurück: Ein anderes Python-Paket schlägt es vor, braucht es aber nicht. Du kannst es so lassen. Wer es entfernen will, prüft zuerst mit -s (nur simulieren), dass apt wirklich nur dieses eine Paket entfernen würde.
sudo apt purge -s python3-brotli
Steht in der Ausgabe nur die Zeile Purg python3-brotli, entfernst du es mit:
sudo apt purge python3-brotli
Prüfen: Die Ausgabe enthält Kommando nicht gefunden.
pandoc --version
3. Arbeitsordner löschen (optional)
Achtung: Damit sind auch der Ausgangstext und alle erzeugten Dateien gelöscht.
rm -r ~/meinpandoc
Quellen und Lizenz
- Offizielle Dokumentation: https://pandoc.org/
- Lizenz: Pandoc steht unter der GPL-2.0-or-later.
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.
Doxygen
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Doxygen erzeugt aus Kommentaren im Quellcode eine Dokumentation als Website. Es liest die Beschreibungen von Funktionen, Parametern und Rückgabewerten direkt aus den Quelldateien und zeichnet auf Wunsch Diagramme, welche Funktion welche aufruft. Es eignet sich vor allem für C und C++, versteht aber auch Java, Python, C#, PHP und weitere Sprachen.
Vorbemerkungen
- Pakete aus Ubuntu: Doxygen und Graphviz sind in den Ubuntu-Paketquellen enthalten und werden mit
aptinstalliert. Graphviz liefert das Programmdot, mit dem Doxygen die Diagramme zeichnet. - Kein Compiler nötig: Doxygen liest den Quellcode nur, es übersetzt ihn nicht. Das Beispiel ist in C geschrieben. Wie man C-Programme übersetzt, steht in der Anleitung C.
- Version: Getestet mit Doxygen 1.15.0 und Graphviz 14.1.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Doxygen und Graphviz installieren
sudo apt install doxygen graphviz
Prüfen: Der erste Befehl zeigt 1.15.0, der zweite dot - graphviz version 14.1.2 (oder jeweils eine neuere Nummer).
doxygen --version
dot -V
Ein Projekt dokumentieren
3. Projektordner anlegen
-p legt den Ordner ~/meinrechner und darin den Unterordner src für den Quellcode in einem Schritt an.
mkdir -p ~/meinrechner/src
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinrechner
5. Header-Datei mit Kommentaren anlegen
In der Header-Datei stehen die Funktionen, die das Programm anbietet, zusammen mit ihrer Beschreibung.
nano src/rechner.h
Füge diesen Inhalt ein (Strg+Umschalt+V):
/**
* @file rechner.h
* @brief Einfache Rechenfunktionen.
*/
#ifndef RECHNER_H
#define RECHNER_H
/**
* @brief Addiert zwei ganze Zahlen.
*
* @param a Erster Summand.
* @param b Zweiter Summand.
* @return Die Summe von @p a und @p b.
*/
int addiere(int a, int b);
/**
* @brief Berechnet das Quadrat einer Zahl.
*
* @param x Die Zahl.
* @return @p x mal @p x.
*/
int quadrat(int x);
/**
* @brief Berechnet a² + b².
*
* Nutzt dafür quadrat() und addiere().
*
* @param a Erste Zahl.
* @param b Zweite Zahl.
* @return Die Summe der Quadrate.
*/
int summe_der_quadrate(int a, int b);
#endif
So liest Doxygen die Kommentare:
- Nur Kommentare, die mit
/**beginnen, gehören zur Dokumentation. Normale Kommentare mit/*oder//übergeht Doxygen. @filemeldet die Datei bei Doxygen an. Ohne diese Zeile erscheinen Funktionen, die nur in einer Datei stehen, nicht in der Dokumentation.@briefist die Kurzbeschreibung für Übersichten. Der Text nach der Leerzeile ist die ausführliche Beschreibung.@parambeschreibt einen Parameter,@returnden Rückgabewert,@phebt einen Parameternamen im Text hervor.- Schreibt man im Text einen Funktionsnamen mit
(), z. B.quadrat(), setzt Doxygen einen Link auf deren Beschreibung.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Quelldatei anlegen
Hier stehen die eigentlichen Funktionen. Die Beschreibungen stehen schon in der Header-Datei und werden nicht wiederholt. Nur der @file-Kommentar ist nötig. Ohne ihn fehlt der Aufrufgraph in Schritt 9.
nano src/rechner.c
Füge diesen Inhalt ein:
/**
* @file rechner.c
* @brief Umsetzung der Rechenfunktionen.
*/
#include "rechner.h"
int addiere(int a, int b)
{
return a + b;
}
int quadrat(int x)
{
return x * x;
}
int summe_der_quadrate(int a, int b)
{
return addiere(quadrat(a), quadrat(b));
}
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Konfigurationsdatei anlegen
Doxygen liest seine Einstellungen aus der Datei Doxyfile. Der Befehl doxygen -g würde eine Vorlage mit über 3000 Zeilen erzeugen. Das ist nicht nötig: Es reicht, nur die Einstellungen einzutragen, die vom Standard abweichen.
nano Doxyfile
Füge diesen Inhalt ein:
PROJECT_NAME = "Mein Rechner"
OUTPUT_LANGUAGE = German
INPUT = src
RECURSIVE = YES
OUTPUT_DIRECTORY = doku
OPTIMIZE_OUTPUT_FOR_C = YES
GENERATE_LATEX = NO
HAVE_DOT = YES
CALL_GRAPH = YES
PROJECT_NAME– steht oben auf jeder Seite.OUTPUT_LANGUAGE = German– Überschriften wie „Funktionen“, „Parameter“ und „Rückgabe“ erscheinen auf Deutsch.INPUTundRECURSIVE– Doxygen liest den Ordnersrcsamt Unterordnern.OUTPUT_DIRECTORY– die fertige Dokumentation landet im Ordnerdoku.OPTIMIZE_OUTPUT_FOR_C– Beschriftungen passend für C statt für C++ (z. B. keine „Klassen“).GENERATE_LATEX = NO– nur HTML erzeugen, keine LaTeX-Dateien für ein PDF.HAVE_DOTundCALL_GRAPH– mit Graphviz Diagramme zeichnen, auch dazu, welche Funktion welche aufruft.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Dokumentation erzeugen
Ohne weitere Angabe liest doxygen die Datei Doxyfile im aktuellen Ordner.
doxygen
Prüfen: Die Ausgabe endet mit finished.... Zeilen mit warning: weisen auf Fehler in den Kommentaren hin, z. B. einen falsch geschriebenen Parameternamen, und nennen Datei und Zeile. Die Zeile Warn for undocumented namespaces... ist keine Warnung, sondern nur eine Fortschrittsmeldung.
9. Dokumentation ansehen
Öffnet die Startseite im Standardbrowser.
xdg-open doku/html/index.html
Prüfen: Oben steht „Mein Rechner“ mit dem Suchfeld „Suchen“. Klicke links auf „Dateien“ und dann auf rechner.h. Die Seite „rechner.h-Dateireferenz“ listet unter „Funktionen“ die drei Funktionen mit ihren Kurzbeschreibungen. Weiter unten stehen bei jeder Funktion „Parameter“ und „Rückgabe“. Bei summe_der_quadrate() zeigt ein Diagramm die Aufrufe von addiere und quadrat.
Nach jeder Änderung an den Kommentaren führst du Schritt 8 erneut aus und lädst die Seite im Browser neu (F5).
Der Ordner doku/html ist eine fertige statische Website. Jeder Webserver kann ihn ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
Doxygen und Graphviz kommen aus den Ubuntu-Paketquellen und werden mit den normalen Systemupdates aktualisiert.
sudo apt update && sudo apt upgrade
Deinstallieren
1. Doxygen und Graphviz entfernen
purge entfernt die Programme samt ihrer Systemdateien. Wer Graphviz für andere Programme weiter braucht, lässt graphviz im Befehl weg.
sudo apt purge doxygen graphviz
2. Nicht mehr benötigte Pakete entfernen
Entfernt die Bibliotheken, die mit Doxygen und Graphviz installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.
sudo apt autoremove --purge
Prüfen: Die Ausgabe enthält Kommando nicht gefunden.
doxygen --version
3. Projektordner löschen (optional)
Achtung: Damit sind auch der Quellcode und die erzeugte Dokumentation gelöscht.
rm -r ~/meinrechner
Quellen und Lizenz
- Offizielle Dokumentation: https://www.doxygen.nl/manual/index.html
- Lizenz: Doxygen steht unter der 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.
Typst
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Typst ist ein Satzsystem, das aus einer Textdatei mit einfacher Auszeichnung ein sauber gesetztes PDF macht, ähnlich wie LaTeX. Es ist deutlich schlanker, übersetzt in Sekundenbruchteilen und meldet Fehler verständlich. Deshalb eignet es sich gut für Briefe, Berichte, Abschlussarbeiten und Dokumente mit Formeln.
Vorbemerkungen
- Kein apt-Paket: Typst ist nicht in den Ubuntu-Paketquellen enthalten. Die Anleitung verwendet das Snap-Paket, das der Hersteller Typst GmbH selbst im Snap Store veröffentlicht. Snap-Pakete aktualisieren sich automatisch.
- Nur im Home-Verzeichnis: Das Snap läuft in einer abgeschotteten Umgebung. Es darf nur Dateien in deinem Home-Verzeichnis lesen und schreiben, aber nicht in versteckten Ordnern wie
~/.irgendwas, nicht unter/tmpund zunächst nicht auf USB-Sticks. Sonst erscheintaccess deniedoderinput file not found. Für USB-Sticks gibt es eine Freigabe (siehe Schritt 3). - Alles dabei: Typst bringt eigene Schriften für Text und Formeln mit. LaTeX ist nicht nötig.
- Version: Getestet mit Typst 0.15.1 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Das Snap selbst braucht diesen Schritt nicht. Er sorgt aber dafür, dass apt die aktuellen Versionen kennt, falls du danach noch etwas installierst, z. B. einen PDF-Betrachter für Schritt 8.
sudo apt update
2. Typst installieren
Lädt Typst aus dem Snap Store (etwa 21 MB).
sudo snap install typst
Prüfen: Die Ausgabe lautet typst 0.15.1 (…) (oder eine neuere Nummer).
typst --version
3. Zugriff auf USB-Sticks erlauben (optional)
Nur nötig, wenn du Dokumente auf einem USB-Stick oder einer externen Festplatte unter /media bearbeiten willst.
sudo snap connect typst:removable-media
Prüfen: In der Zeile removable-media steht in der Spalte „Slot“ jetzt :removable-media statt -.
snap connections typst
Ein Dokument setzen
4. Arbeitsordner anlegen
Der Ordner muss im Home-Verzeichnis liegen und darf nicht versteckt sein (siehe Vorbemerkungen).
mkdir ~/meintypst
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meintypst
6. Dokument anlegen
Typst-Dateien enden auf .typ.
nano dokument.typ
Füge diesen Inhalt ein (Strg+Umschalt+V):
#set document(title: "Mein erstes Dokument", author: "Dein Name")
#set page(paper: "a4", numbering: "1")
#set text(lang: "de", size: 11pt)
#set heading(numbering: "1.")
#align(center, text(20pt, weight: "bold")[Mein erstes Dokument])
#align(center)[Dein Name]
#outline()
= Einleitung
Dieses Dokument wurde mit *Typst* gesetzt. Typst trennt deutsche Wörter
automatisch und setzt "Anführungszeichen" richtig.
= Eine Formel
Der Satz des Pythagoras lautet $a^2 + b^2 = c^2$. Abgesetzt:
$ sum_(k=1)^n k = (n(n+1)) / 2 $
= Eine Tabelle
#figure(
table(
columns: 2,
[*Werkzeug*], [*Eingabeformat*],
[Typst], [Typst-Markup],
[LaTeX], [LaTeX-Markup],
),
caption: [Zwei Satzsysteme],
)
= Eine Liste
+ Text schreiben
+ Mit `typst compile` umwandeln
+ PDF ansehen
So ist die Datei aufgebaut:
- Zeilen mit
#setlegen Regeln für das ganze Dokument fest:documentträgt Titel und Autor in die PDF-Eigenschaften ein.pagewählt A4 und Seitenzahlen.text(lang: "de")schaltet deutsche Silbentrennung, deutsche Anführungszeichen und deutsche Beschriftungen wie „Inhaltsverzeichnis“ und „Tabelle 1“ ein.heading(numbering: "1.")nummeriert die Überschriften.
#outline()setzt an dieser Stelle das Inhaltsverzeichnis.=am Zeilenanfang ist eine Überschrift,*…*fett,+eine nummerierte Liste.- Zwischen
$…$steht eine Formel. Mit Leerzeichen innen ($ … $) wird sie abgesetzt in eine eigene Zeile gestellt. #figureumgibt die Tabelle mit einer nummerierten Beschriftung.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. PDF erzeugen
Übersetzt dokument.typ in dokument.pdf im selben Ordner.
typst compile dokument.typ
Prüfen: Der Befehl gibt nichts aus, wenn alles in Ordnung ist. Bei einem Fehler nennt Typst Zeile und Spalte und markiert die Stelle, z. B. bei einer vergessenen Klammer.
8. PDF ansehen
Öffnet die Datei im Standard-PDF-Betrachter.
xdg-open dokument.pdf
Prüfen: Oben stehen Titel und Name, darunter das „Inhaltsverzeichnis“ mit vier nummerierten Einträgen. Im Text stehen deutsche Anführungszeichen „ “, die Formeln sind gesetzt und unter der Tabelle steht „Tabelle 1: Zwei Satzsysteme“. Unten auf der Seite steht die Seitenzahl.
9. Automatisch neu übersetzen (optional)
watch beobachtet die Datei und erzeugt das PDF bei jedem Speichern neu. Die meisten PDF-Betrachter, z. B. der Dokumentenbetrachter von Ubuntu, laden die Anzeige dann von selbst neu. So siehst du jede Änderung sofort.
typst watch dokument.typ
Prüfen: Die Ausgabe zeigt compiled successfully. Nach jedem Speichern in nano (in einem zweiten Terminal) erscheint die Meldung erneut mit neuer Uhrzeit.
Beende das Beobachten mit Strg+C.
Aktualisieren
Snap-Pakete aktualisieren sich mehrmals täglich von selbst. Wer nicht warten will, stößt die Aktualisierung von Hand an.
sudo snap refresh typst
Prüfen: typst --version zeigt die neue Versionsnummer.
Deinstallieren
1. Typst entfernen
--purge entfernt das Snap ohne die automatische Sicherung, die Snap sonst beim Entfernen anlegt.
sudo snap remove --purge typst
Prüfen: Die Ausgabe enthält Kommando nicht gefunden bzw. No such file or directory.
typst --version
2. Zwischenspeicher löschen
Typst legt Vorlagen und Erweiterungen, die es aus dem Internet lädt, in ~/.cache/typst ab. Hast du keine verwendet, gibt es den Ordner nicht und rm meldet das nur.
rm -r ~/.cache/typst
3. Arbeitsordner löschen (optional)
Achtung: Damit sind auch deine Dokumente gelöscht.
rm -r ~/meintypst
Quellen und Lizenz
- Offizielle Dokumentation: https://typst.app/docs/
- Lizenz: Typst steht unter der Apache-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.
LaTeX (TeX Live)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
LaTeX ist das klassische Satzsystem für wissenschaftliche Arbeiten, Bücher und Dokumente mit vielen Formeln. Man schreibt den Text mit Befehlen in eine Textdatei, und LaTeX setzt daraus ein PDF in Buchdruckqualität. TeX Live ist die Sammlung, die LaTeX samt Schriften und Erweiterungspaketen unter Linux bereitstellt.
Vorbemerkungen
- Pakete aus Ubuntu: TeX Live ist in den Ubuntu-Paketquellen enthalten und in viele Pakete aufgeteilt. Diese Anleitung installiert eine mittlere Auswahl mit etwa 300 MB. Sie reicht für Briefe, Berichte und Abschlussarbeiten auf Deutsch.
- Größere Auswahl bei Bedarf: Meldet LaTeX später, dass eine Datei
….styfehlt, steckt das Erweiterungspaket meist intexlive-latex-extra(Schritt 4). Das Pakettexlive-fullenthält alles, braucht aber mehrere GB. - Leichtere Alternative: Wer nur ab und zu ein Dokument setzt, kommt mit Typst schneller zum Ziel.
- Version: Getestet mit TeX Live 2025 (pdfTeX 1.40.28, LuaHBTeX 1.22.0) und latexmk 4.87 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. TeX Live installieren
Installiert drei Pakete samt Abhängigkeiten:
texlive-latex-recommended– LaTeX selbst mit häufig gebrauchten Erweiterungen, z. B. KOMA-Script für deutsche Dokumente,booktabsfür Tabellen und die Schrift Latin Modern.texlive-lang-german– deutsche Silbentrennung und deutsche Beschriftungen wie „Inhaltsverzeichnis“.latexmk– ein Hilfsprogramm, das LaTeX so oft aufruft, bis Inhaltsverzeichnis und Verweise stimmen.
sudo apt install texlive-latex-recommended texlive-lang-german latexmk
Das Herunterladen und Einrichten dauert einige Minuten.
Prüfen: Die erste Zeile beginnt mit pdfTeX und enthält TeX Live 2025.
pdflatex --version
3. latexmk prüfen
Prüfen: Die letzte Zeile lautet Latexmk, John Collins, … mit einer Versionsnummer.
latexmk --version
4. Weitere Erweiterungen installieren (optional)
Nur nötig, wenn ein Dokument eine Erweiterung braucht, die in der Auswahl aus Schritt 2 fehlt. Das erkennst du an der Meldung ! LaTeX Error: File '….sty' not found. Das Paket bringt mehrere Hundert weitere Erweiterungen mit, z. B. csquotes, und belegt etwa 400 MB zusätzlich.
sudo apt install texlive-latex-extra
Ein Dokument setzen
5. Arbeitsordner anlegen
LaTeX erzeugt beim Übersetzen mehrere Hilfsdateien. Ein eigener Ordner hält sie beisammen.
mkdir ~/meinlatex
6. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinlatex
7. Dokument anlegen
LaTeX-Dateien enden auf .tex.
nano dokument.tex
Füge diesen Inhalt ein (Strg+Umschalt+V):
\documentclass[a4paper,11pt]{scrartcl}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[ngerman]{babel}
\usepackage{amsmath}
\usepackage{booktabs}
\title{Mein erstes Dokument}
\author{Dein Name}
\date{\today}
\begin{document}
\maketitle
\tableofcontents
\section{Einleitung}
Dieses Dokument wurde mit \textbf{LaTeX} gesetzt. Mit babel trennt LaTeX
deutsche Wörter richtig und beschriftet Inhaltsverzeichnis und Tabellen auf Deutsch.
\section{Eine Formel}
Der Satz des Pythagoras lautet $a^2 + b^2 = c^2$. Abgesetzt:
\begin{equation}
\sum_{k=1}^{n} k = \frac{n(n+1)}{2}
\end{equation}
\section{Eine Tabelle}
\begin{table}[h]
\centering
\begin{tabular}{ll}
\toprule
Werkzeug & Eingabeformat \\
\midrule
LaTeX & LaTeX-Markup \\
Typst & Typst-Markup \\
\bottomrule
\end{tabular}
\caption{Zwei Satzsysteme}
\end{table}
\section{Eine Liste}
\begin{enumerate}
\item Text schreiben
\item Mit \texttt{latexmk} übersetzen
\item PDF ansehen
\end{enumerate}
\end{document}
So ist die Datei aufgebaut:
- Vorspann (bis
\begin{document}): Hier stehen die Einstellungen.scrartclist die Dokumentklasse „Artikel“ aus KOMA-Script, die auf deutsche Gepflogenheiten und A4 ausgelegt ist.fontencundlmodernsorgen dafür, dass Umlaute richtig gesetzt werden und sich im PDF suchen und kopieren lassen.babelmitngermanschaltet die neue deutsche Rechtschreibung für Silbentrennung und Beschriftungen ein.amsmatherweitert den Formelsatz,booktabsliefert die Linien\toprule,\midruleund\bottomrulefür Tabellen.
- Textteil (zwischen
\begin{document}und\end{document}):\maketitlesetzt Titel, Autor und Datum.\tableofcontentssetzt das Inhaltsverzeichnis.\sectionbeginnt einen nummerierten Abschnitt.- Zwischen
$…$steht eine Formel im Text,equationsetzt eine nummerierte Formel in eine eigene Zeile.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. PDF erzeugen
-pdf erzeugt ein PDF mit pdflatex. LaTeX muss mehrmals laufen, denn erst beim zweiten Durchgang kennt es die Seitenzahlen für das Inhaltsverzeichnis. latexmk übernimmt das selbst.
latexmk -pdf dokument.tex
Prüfen: Die Ausgabe endet mit Latexmk: All targets (dokument.pdf) are up-to-date oder einer Zeile Output written on dokument.pdf (2 pages, …).
Bei einem Fehler hält LaTeX mit einer Zeile an, die mit ! beginnt, und wartet auf eine Eingabe hinter ?. Tippe dann X und Enter, um abzubrechen. Die Zeilennummer steht in der Meldung hinter l., z. B. l.17.
9. PDF ansehen
Öffnet die Datei im Standard-PDF-Betrachter.
xdg-open dokument.pdf
Prüfen: Oben stehen Titel, Name und das heutige Datum auf Deutsch, darunter das „Inhaltsverzeichnis“ mit vier Einträgen. Die Summenformel trägt rechts die Nummer (1), unter der Tabelle steht „Tabelle 1: Zwei Satzsysteme“. Die Liste steht auf Seite 2.
10. Hilfsdateien entfernen
Neben dem PDF liegen jetzt Dateien wie dokument.aux, dokument.log und dokument.toc. -c löscht sie, das PDF und die .tex-Datei bleiben erhalten.
latexmk -c
Prüfen: Im Ordner liegen nur noch dokument.tex und dokument.pdf.
ls
Aktualisieren
TeX Live kommt aus den Ubuntu-Paketquellen und wird mit den normalen Systemupdates aktualisiert. Den Paketmanager tlmgr von TeX Live verwendet man bei dieser Installation nicht.
sudo apt update && sudo apt upgrade
Deinstallieren
1. TeX Live entfernen
purge entfernt die Pakete samt ihrer Systemdateien. Hast du Schritt 4 ausgelassen, meldet apt für texlive-latex-extra nur, dass das Paket nicht installiert ist.
sudo apt purge texlive-latex-recommended texlive-lang-german latexmk texlive-latex-extra
2. Nicht mehr benötigte Pakete entfernen
Entfernt die Grundpakete, Schriften und Bibliotheken, die mit TeX Live installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.
sudo apt autoremove --purge
Ist auf dem Rechner auch Sphinx installiert, bleibt dabei ein Teil von TeX Live zurück, z. B. texlive-base, texlive-binaries und dvisvgm. Sphinx schlägt diese Pakete für seine PDF-Ausgabe vor, und apt behält vorgeschlagene Pakete. Das ist kein Fehler. Die Reste belegen nur Speicherplatz und stören nicht.
Prüfen: Die Ausgabe enthält Kommando nicht gefunden. Bleiben wegen Sphinx Reste zurück, kann pdflatex noch vorhanden sein.
pdflatex --version
3. Arbeitsordner löschen (optional)
Achtung: Damit sind auch deine Dokumente gelöscht.
rm -r ~/meinlatex
Quellen und Lizenz
- Offizielle Dokumentation: https://www.tug.org/texlive/doc.html
- Lizenz: TeX Live steht unter der TeX Live (verschiedene freie Lizenzen / LPPL / GPL).
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.
gh-pages
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
gh-pages ist ein kleines npm-Werkzeug, das einen fertig gebauten Ordner (z. B. dist) mit einem einzigen Befehl in den Branch gh-pages eines Git-Repositorys schiebt. GitHub Pages veröffentlicht diesen Branch dann als Webseite.
Vorbemerkungen
- Kein apt-Paket: gh-pages gibt es nicht in den Ubuntu-Paketquellen. Es wird pro Projekt mit
npminstalliert. Aus den Ubuntu-Paketquellen kommen nur Git, Node.js und npm. - Version: Diese Anleitung verwendet gh-pages 6 (derzeit 6.3). Es läuft mit jeder Node.js-Version ab 10, das Node.js 22 aus Ubuntu 26.04 passt also.
- Voraussetzung: Du hast ein Repository auf GitHub, und
git pushfunktioniert von deinem Rechner aus (per SSH-Schlüssel oder Zugangstoken). gh-pages nutzt genau diesen Zugang. - Was gh-pages nicht tut: Es baut die Webseite nicht. Den Ordner mit den fertigen Dateien erzeugt vorher dein Werkzeug, z. B. VitePress, Docusaurus oder mdBook.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Git, Node.js und npm kennt.
sudo apt update
2. Git, Node.js und npm installieren
Git überträgt die Dateien zu GitHub, Node.js führt gh-pages aus und npm lädt es herunter. Ist schon alles vorhanden, meldet apt das nur.
sudo apt install git nodejs npm
Prüfen: Beide Befehle geben eine Versionsnummer aus.
node --version
git --version
Beispielprojekt
Die folgenden Schritte zeigen gh-pages an einem kleinen Projekt. Hast du schon ein Projekt, beginne in dessen Ordner bei Schritt 6.
3. Repository von GitHub holen
Lädt ein bestehendes GitHub-Repository auf deinen Rechner. Ersetze BENUTZER und meine-seite durch deinen GitHub-Namen und den Namen des Repositorys. Das Repository sollte schon mindestens einen Commit haben (z. B. eine README.md, die GitHub beim Anlegen erzeugt).
git clone git@github.com:BENUTZER/meine-seite.git ~/meine-seite
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meine-seite
Prüfen: Unter origin steht die Adresse deines GitHub-Repositorys. An diese Adresse schickt gh-pages später die Dateien.
git remote -v
5. package.json anlegen
npm braucht die Datei package.json, um festzuhalten, welche Pakete das Projekt verwendet. -y übernimmt alle Vorschläge, ohne nachzufragen.
npm init -y
6. gh-pages installieren
Lädt gh-pages in den Ordner node_modules und trägt es in package.json ein. -D kennzeichnet es als Entwicklungswerkzeug, das nicht zur Webseite selbst gehört.
npm add -D gh-pages
Prüfen: Die Ausgabe zeigt die installierte Version, z. B. gh-pages@6.3.0.
npm ls gh-pages
7. node_modules von Git ausschließen
Der Ordner node_modules lässt sich jederzeit mit npm install wiederherstellen und gehört nicht ins Repository. gh-pages legt dort außerdem seinen Zwischenspeicher ab.
nano .gitignore
Füge diese Zeile ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
node_modules
8. Ordner für die fertige Webseite anlegen
In einem echten Projekt erzeugt dein Werkzeug diesen Ordner beim Bauen. Für das Beispiel legst du ihn selbst an.
mkdir dist
9. Eine Testseite anlegen
Eine einfache HTML-Seite, an der du erkennst, ob die Veröffentlichung geklappt hat.
nano dist/index.html
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Meine Seite</title>
</head>
<body>
<h1>Hallo von GitHub Pages</h1>
</body>
</html>
10. Kurzbefehl in package.json eintragen
Ein Eintrag unter scripts erspart dir, die Optionen jedes Mal abzutippen. Danach genügt npm run deploy.
nano package.json
Suche mit Strg+W nach "test" und bestätige mit Enter. Lösche diese Zeile mit Strg+K und füge an ihrer Stelle diese Zeile ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
"deploy": "gh-pages -d dist --nojekyll"
Die Optionen bedeuten:
-d dist– dieser Ordner wird veröffentlicht--nojekyll– legt eine leere Datei.nojekyllan. Sonst bereitet GitHub die Seite mit Jekyll auf und lässt dabei Ordner weg, die mit_beginnen (das betrifft z. B. VitePress und Sphinx).
Der Abschnitt scripts sieht danach so aus:
"scripts": {
"deploy": "gh-pages -d dist --nojekyll"
},
11. Projektdateien committen
Sichert package.json, package-lock.json und .gitignore im Branch main. Der Ordner dist wird hier mit übernommen, das ist für das Beispiel in Ordnung.
git add .
git commit -m "gh-pages einrichten"
git push
12. Webseite veröffentlichen
gh-pages kopiert den Inhalt von dist in den Branch gh-pages, erstellt dort einen Commit und schiebt ihn zu GitHub. Den Branch legt es beim ersten Mal selbst an.
npm run deploy
Prüfen: Die Ausgabe endet mit Published. Auf GitHub gibt es jetzt den Branch gh-pages mit den Dateien index.html und .nojekyll.
git ls-remote origin gh-pages
13. GitHub Pages einschalten
Einmalig im Browser: GitHub muss wissen, aus welchem Branch es die Webseite liefern soll.
- Öffne dein Repository auf GitHub.
- Klicke auf Settings und links auf Pages.
- Wähle unter Source den Eintrag Deploy from a branch.
- Wähle unter Branch den Eintrag
gh-pagesund den Ordner/ (root)und klicke auf Save.
Prüfen: Nach ein bis zwei Minuten zeigt https://BENUTZER.github.io/meine-seite/ die Überschrift „Hallo von GitHub Pages“.
Mit anderen Werkzeugen verwenden
Bei einem echten Projekt ersetzt du in Schritt 10 nur dist durch den Ordner, in den dein Werkzeug baut, und baust vor npm run deploy die Seite neu:
| Werkzeug | Ordner für -d |
|---|---|
| mdBook | book |
| VitePress | .vitepress/dist |
| Docusaurus | build |
| Astro Starlight | dist |
Weil die Seite unter /meine-seite/ liegt und nicht direkt unter der Domain, muss dein Werkzeug das wissen. In VitePress trägst du dazu z. B. base: '/meine-seite/' in .vitepress/config.mts ein, in Docusaurus baseUrl. Ohne diese Angabe fehlen auf der veröffentlichten Seite Stile und Bilder.
Beispiel: mdBook unter eigener Domain veröffentlichen
So wird dieses Buch veröffentlicht: mdBook baut die Seiten in den Ordner book, gh-pages schiebt sie in den Branch gh-pages, und GitHub liefert sie unter der Subdomain installieren.wissen-ahrensburg.de aus. Die Schritte setzen voraus, dass gh-pages wie oben im Projekt installiert ist und origin auf das GitHub-Repository zeigt.
1. Kurzbefehl in package.json eintragen
Der Kurzbefehl heißt hier ver (für „veröffentlichen“) und bündelt alle Optionen.
nano package.json
Suche mit Strg+W nach "scripts" und bestätige mit Enter. Füge in der Zeile darunter diese Zeile ein (im Terminal mit Strg+Umschalt+V). Steht danach noch ein weiterer Eintrag wie "test", muss die Zeile mit einem Komma enden. Speichere mit Strg+O und Enter und beende nano mit Strg+X:
"ver": "gh-pages -d book --nojekyll --cname installieren.wissen-ahrensburg.de --no-history"
Die Optionen bedeuten:
-d book– veröffentlicht den Ordnerbook, in denmdbook buildschreibt--nojekyll– verhindert, dass GitHub die Seite mit Jekyll aufbereitet (siehe Schritt 10 oben)--cname installieren.wissen-ahrensburg.de– legt die DateiCNAMEmit dieser Domain in den Branch. Daran erkennt GitHub, unter welcher Domain es die Seite ausliefern soll. Ersetze sie durch deine eigene (Sub-)Domain.--no-history– ersetzt den Branchgh-pagesbei jeder Veröffentlichung durch einen einzigen neuen Commit, statt einen weiteren anzuhängen. Das Repository wächst dadurch nicht mit jeder Veröffentlichung. Ältere Stände der Webseite sind danach nicht mehr im Branchgh-pagesgespeichert; die Quelltexte inmainbleiben unberührt.
Der Abschnitt scripts sieht danach z. B. so aus:
"scripts": {
"ver": "gh-pages -d book --nojekyll --cname installieren.wissen-ahrensburg.de --no-history"
},
Prüfen: npm listet den Kurzbefehl ver auf.
npm run
2. Ordner book von Git ausschließen
book wird bei jedem Bauen neu erzeugt und gehört nicht in den Branch main. Öffne dazu .gitignore:
nano .gitignore
Füge diese Zeile ein, falls sie noch fehlt, speichere mit Strg+O und Enter und beende nano mit Strg+X:
book
3. DNS-Eintrag für die Subdomain setzen
Einmalig beim Anbieter deiner Domain: Die Subdomain muss auf GitHub Pages zeigen. Lege dazu einen CNAME-Eintrag an:
| Name | Typ | Ziel |
|---|---|---|
installieren | CNAME | thorstenkloehn.github.io |
Ersetze thorstenkloehn durch deinen GitHub-Namen. Der Eintrag verweist nur auf deine GitHub-Adresse, nicht auf das Repository. Welches Repository gemeint ist, erkennt GitHub an der Datei CNAME aus Schritt 1.
Prüfen: Nach einiger Zeit (je nach Anbieter Minuten bis Stunden) nennt dieser Befehl zuerst thorstenkloehn.github.io. und danach die Adressen von GitHub, die mit 185.199. beginnen.
dig +short installieren.wissen-ahrensburg.de
Fehlt dig, installierst du es mit sudo apt install bind9-dnsutils.
Hauptdomain statt Subdomain: Soll die Seite direkt unter
wissen-ahrensburg.deerscheinen, ist ein CNAME-Eintrag bei vielen Anbietern nicht erlaubt. Dann legst du stattdessen vier A-Einträge mit den Adressen185.199.108.153,185.199.109.153,185.199.110.153und185.199.111.153an und gibst bei--cnamedie Hauptdomain an.
4. Buch bauen
Erzeugt den Ordner book mit der aktuellen Fassung aller Anleitungen. Ohne diesen Schritt würde gh-pages einen veralteten oder gar keinen Stand veröffentlichen.
mdbook build
Prüfen: Im Ordner book liegt eine index.html.
ls book/index.html
5. Buch veröffentlichen
Führt den Kurzbefehl aus Schritt 1 aus.
npm run ver
Prüfen: Die Ausgabe endet mit Published. Der Branch gh-pages enthält jetzt genau einen Commit:
git fetch origin gh-pages
git log --oneline origin/gh-pages
6. Eigene Domain in GitHub bestätigen
Einmalig im Browser: Öffne im Repository Settings → Pages. Stelle wie in Schritt 13 oben den Branch gh-pages ein. Unter Custom domain steht nun installieren.wissen-ahrensburg.de (aus der Datei CNAME). Setze, sobald GitHub es anbietet, den Haken bei Enforce HTTPS, damit die Seite verschlüsselt ausgeliefert wird.
Prüfen: https://installieren.wissen-ahrensburg.de/ zeigt das Buch.
Bei jeder späteren Änderung genügen die Schritte 4 und 5. Weil die Seite direkt unter der Subdomain liegt und nicht unter /meine-seite/, ist in mdBook keine zusätzliche Pfadangabe nötig.
Aktualisieren
gh-pages wird pro Projekt aktualisiert. Im Projektordner holt dieser Befehl die neueste Version innerhalb von gh-pages 6:
npm update gh-pages
Prüfen:
npm ls gh-pages
Fehlerbehebung
Meldet gh-pages Remote url mismatch, hat sich die Adresse von origin geändert, seit der Zwischenspeicher angelegt wurde. Dieser Befehl leert den Zwischenspeicher, danach funktioniert npm run deploy wieder:
npx gh-pages-clean
Deinstallieren
1. gh-pages aus dem Projekt entfernen
Löscht gh-pages aus node_modules und aus package.json.
npm uninstall gh-pages
Prüfen: Die Ausgabe zeigt (empty).
npm ls gh-pages
2. Kurzbefehl entfernen
Die Einträge deploy bzw. ver funktionieren ohne gh-pages nicht mehr.
nano package.json
Suche mit Strg+W nach "deploy" (bzw. "ver"), lösche die Zeile mit Strg+K, speichere mit Strg+O und Enter und beende nano mit Strg+X.
3. Optional: Veröffentlichte Webseite löschen
Entfernt den Branch gh-pages auf GitHub. Achtung: Die Webseite ist danach nicht mehr erreichbar.
git push origin --delete gh-pages
4. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. VitePress oder Docusaurus).
sudo apt purge nodejs npm
sudo apt autoremove
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.
Ausführbare Lernmaterialien
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Übersicht führt zu den Anleitungen für interaktive Kurse, Notizbücher und lokale Labs auf Ubuntu 26.04 LTS (amd64).
Anleitung auswählen
-
Wähle die Art der Lernmaterialien. Die Kapitel enthalten Installation, ein Einstiegsbeispiel, Funktionsprüfung und Entfernung. Wo die Vorgabe ohne Container keinen belegten vollständigen Installationsweg zulässt, wird diese Grenze ausdrücklich beschrieben.
Werkzeug Wo läuft der Beispielcode? Anleitung Judge0 Server; offizieller Bereitstellungsweg mit Docker Stand der nativen Installation Codapi JavaScript im Browser; Cloud und Server gesondert erklärt Widget lokal einrichten LiaScript Kursdarstellung im Browser; Ausführung abhängig vom Kurs devserver Hyperbook Abhängig von der verwendeten interaktiven Komponente Arbeitsheft Pyodide-MkDocs-Theme Python im Browser MkDocs-Übungen Slidev Präsentation und unterstützte Demos im Browser Folien marimo Lokal auf Ubuntu; nach WASM-Export im Browser Python-Notizbuch Runestone Serververbund; offizieller Weg mit Docker Compose Installationsgrenze Quarto Live Python oder R im Browser Quarto-Erweiterung Runme Befehle direkt auf Ubuntu Lokales Lab Livebook Elixir auf dem Ubuntu-Rechner Lokaler Server MyST Buchdarstellung; Rechnen benötigt zusätzliche Umgebung Dokumentationsprojekt Jupyter Book 2 Lokales Jupyter; alternativ externer Notebookdienst Buch und Notebook Docusaurus Live Codeblock React im Browser React-Demo Google Codelabs Tools Schrittweise Anleitung; kein allgemeiner Rechenkernel Archivierte CLI -
Folge dem verlinkten Kapitel in einem eigenen Projektordner. Lokale Vorschauen beendest du mit Strg + C. Die Beispiele sollen zuerst auf dem eigenen Rechner funktionieren.
-
Prüfe das jeweilige Beispiel auch im Browser. Ein erfolgreicher Buchbau bestätigt die erzeugten Dateien, aber noch nicht die Ausführung von Python, React oder anderen Laufzeiten auf dem Lesergerät.
Bei Binder, JupyterHub und Colab ist der Dienst getrennt vom Buchgenerator zu betrachten. Die Jupyter-Book-Anleitung erklärt die Übergabe einer Notebookdatei und setzt keinen externen Dienst auf.
Die Anleitungen veröffentlichen keine Inhalte und richten keine allgemein zugänglichen Ausführungsdienste ein. Für Judge0 bleibt die bereits dokumentierte fehlende belegte native Installation bestehen.
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.
Codapi
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Codapi ergänzt Webseiten um bearbeitbare und ausführbare Codebeispiele.
Für Ubuntu 26.04 LTS auf amd64. Hier wird das Browser-Widget mit JavaScript eingerichtet; ein eigener Ausführungsserver ist dafür nicht nötig. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/codapi-demo
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/codapi-demo
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. Widget installieren
Speichert JavaScript und CSS lokal im Projekt.
npm install @antonz/codapi@0.20.0
8. Webserver installieren
Python liefert die Demo per HTTP aus.
sudo apt install python3
9. Demoseite schreiben
Das Browser-Attribut führt JavaScript auf dem Gerät des Lesers aus. Die Dateien werden aus dem lokal installierten Paket geladen.
cat > index.html <<'EOF'
<!doctype html>
<html lang="de">
<meta charset="utf-8">
<title>Codapi unter Ubuntu</title>
<link rel="stylesheet" href="./node_modules/@antonz/codapi/dist/snippet.css">
<h1>Rechnen im Browser</h1>
<pre><code>const preise = [4, 7, 12];
console.log(preise.reduce((summe, preis) => summe + preis, 0));</code></pre>
<codapi-snippet engine="browser" sandbox="javascript" editor="basic"></codapi-snippet>
<script src="./node_modules/@antonz/codapi/dist/snippet.js"></script>
</html>
EOF
10. Demo starten
Öffne http://127.0.0.1:8000. Mit Run soll die Ausgabe 23 erscheinen. Ändere einen Preis über Edit und führe erneut aus. Strg + C beendet den Server.
python3 -m http.server 8000 --bind 127.0.0.1
Server und Cloud
Der offizielle selbst betriebene Server verwendet Docker für seine Sandboxes. Unter der Vorgabe dieses Buchs wird er nicht eingerichtet. Die Cloud kann alternativ serverseitige Sprachen ausführen; dabei wird der Quellcode an einen externen Dienst übertragen. Der Anbieter nennt am Prüfdatum ein Gratis-Kontingent von 1000 Ausführungen pro Monat. Prüfe die aktuellen Bedingungen vor der Nutzung. Die Browserdemo oben nutzt dieses Kontingent nicht.
1. Installation prüfen
Zeigt den lokal installierten Widgetstand.
npm ls @antonz/codapi
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/codapi-demo
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/codapi-demo && echo 'Projekt entfernt'
Quellen und Lizenz
Widget-Einbindung, JavaScript im Browser, Cloud und Serverinstallation. Widget: MIT; Server: Apache-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.
LiaScript mit devserver
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
LiaScript stellt Markdown-Kurse mit interaktiven Aufgaben im Browser dar.
Für Ubuntu 26.04 LTS auf amd64. Der devserver dient der lokalen Vorschau. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/liascript-kurs
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/liascript-kurs
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. devserver installieren
Hält den Entwicklungsserver im Projekt statt ihn systemweit einzurichten.
npm install --save-dev @liascript/devserver
8. Kurs anlegen
Schreibt einen kleinen Kurs mit einer Auswahlfrage.
cat > README.md <<'EOF'
<!--
version: 0.0.1
language: de
-->
# Ubuntu kennenlernen
## Paketverwaltung
Welcher Befehl aktualisiert die Paketlisten?
[(X)] sudo apt update
[( )] pwd
EOF
9. Kursvorschau starten
Öffne die im Terminal angezeigte lokale Adresse. Prüfe, ob die erste Antwort als richtig erkannt wird. Der Server kann auch im lokalen Netz lauschen; verwende ihn nur für deine Entwicklungsdateien. Strg + C beendet ihn.
npx liascript-devserver --input README.md --port 3000 --live
Installation prüfen
1. Versionsstand anzeigen
Die Ausgabe nennt devserver und eingebundenen Interpreter getrennt.
npx liascript-devserver --version
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/liascript-kurs
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/liascript-kurs && echo 'Projekt entfernt'
Quellen und Lizenz
devserver und LiaScript-Lizenz. Interpreter: BSD-3-Clause; devserver: MIT.
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.
Hyperbook
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Hyperbook baut interaktive Arbeitshefte aus Markdown-Dateien.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/hyperbook-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/hyperbook-lab
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. Hyperbook installieren
Installiert die CLI im übergeordneten Projektordner. Sie bleibt dadurch auch im Unterordner buch über npx erreichbar.
npm install --save-dev hyperbook
8. Buch erzeugen
Der Assistent fragt nach Beschreibung, Autor, Lizenz und Sprache. Gib für die Sprache de an. Wähle die Lizenz für deine eigenen Inhalte bewusst; sie ist von Hyperbooks MIT-Lizenz getrennt.
npx hyperbook new buch
9. Buchordner öffnen
Wechselt zum erzeugten Arbeitsheft. Die Paketverwaltung liegt eine Ebene darüber; hier ist kein weiteres npm install nötig.
cd buch
10. Vorschau starten
Öffne die vom Terminal angezeigte Adresse, üblicherweise localhost:8080. Prüfe die Navigation und ändere eine Markdown-Seite im Ordner book. Strg + C beendet die Vorschau.
npx hyperbook dev
11. Arbeitsheft bauen
Erzeugt die statische Ausgabe. Der Befehl muss ohne Fehler enden; das Terminal nennt den Ausgabeordner.
npx hyperbook build
Installation prüfen
1. Paketstand anzeigen
Dokumentiert die installierte Hyperbook-Version. Bewahre package-lock.json für spätere Neuinstallationen auf.
npm ls hyperbook
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/hyperbook-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/hyperbook-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Einstieg und Quellcode. Lizenz: MIT. Einzelne eingebundene Laufzeiten können eigene Lizenzen haben.
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.
Pyodide-MkDocs-Theme
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Pyodide-MkDocs-Theme ergänzt MkDocs-Seiten um Python-Übungen, die im Browser laufen.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install python3 python3-venv nano
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/pyodide-mkdocs-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/pyodide-mkdocs-lab
5. Python-Umgebung anlegen
Die Bibliotheken bleiben vom Ubuntu-Python getrennt.
python3 -m venv .venv
6. Paketwerkzeug aktualisieren
Verwendet ausdrücklich pip aus der neuen Umgebung.
.venv/bin/python -m pip install --upgrade pip
7. Theme installieren
Lädt auch die benötigten MkDocs-Erweiterungen in die virtuelle Umgebung.
.venv/bin/python -m pip install pyodide-mkdocs-theme
8. Projektvorlage erzeugen
Verwendet die zum installierten Theme passende Konfiguration und Beispielübungen.
.venv/bin/python -m pyodide_mkdocs_theme --new buch
9. Buchordner öffnen
Die virtuelle Umgebung bleibt eine Ebene darüber.
cd buch
10. Konfiguration öffnen
Setze in mkdocs.yml site_name auf Ubuntu-Labor, site_url auf http://127.0.0.1:8000/ und unter plugins → pyodide_macros → project den Wert id auf ubuntu-labor. Prüfe außerdem den vorgegebenen copyright-Block: Er darf für deine eigenen Inhalte keine ungeprüften Rechteangaben enthalten. Erhalte die übrigen technischen Einstellungen. Speichere mit Strg + O und beende mit Strg + X.
nano mkdocs.yml
11. Vorschau starten
Öffne http://127.0.0.1:8000. Führe die mitgelieferte Python-Übung aus; beim ersten Laden wird die Browserlaufzeit aus dem Netz geladen. Strg + C beendet die Vorschau.
../.venv/bin/mkdocs serve --dev-addr 127.0.0.1:8000
Installation prüfen
1. Seiten bauen
Erzeugt site/. Der Bau und anschließend die Ausführung einer Übung in der Vorschau müssen funktionieren.
../.venv/bin/mkdocs build
2. Paketstand anzeigen
Zeigt Theme und Abhängigkeiten für eine spätere Fehlersuche.
../.venv/bin/python -m pip show pyodide-mkdocs-theme
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/pyodide-mkdocs-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/pyodide-mkdocs-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Installation und Projektvorlage und Paket. Lizenz: GPLv3; zusätzliche Bibliotheken haben eigene Lizenzbedingungen.
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.
Slidev
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Slidev erzeugt Präsentationen mit interaktiven Elementen aus Markdown.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/slidev-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/slidev-lab
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. Slidev installieren
Richtet CLI und Standarddesign lokal ein.
npm install --save-dev @slidev/cli @slidev/theme-default
8. Folien schreiben
Erzeugt zwei eigene Folien; die Trennlinie beginnt eine neue Folie.
cat > slides.md <<'EOF'
---
theme: default
title: Ubuntu-Labor
---
# Unser Ubuntu-Labor
Software direkt auf dem Rechner installieren
---
# Ergebnis prüfen
- Versionsnummer anzeigen
- Ein kleines Beispiel ausführen
EOF
9. Präsentation starten
Öffne http://localhost:3030 und wechsle mit der Pfeiltaste zur zweiten Folie. Strg + C beendet den Server.
npx slidev slides.md
Installation prüfen
1. Präsentation bauen
Erstellt dist/ für die spätere statische Bereitstellung. Dies exportiert keine PDF-Datei.
npx slidev build slides.md
2. Version anzeigen
Zeigt den verwendeten CLI-Stand.
npx slidev --version
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/slidev-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/slidev-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Slidev-Einstieg und CLI. Lizenz: MIT.
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.
marimo
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
marimo ist ein reaktives Python-Notizbuch mit einer Oberfläche im Browser.
Für Ubuntu 26.04 LTS auf amd64. Beim lokalen Editor läuft Python auf Ubuntu. Ein zusätzlicher WebAssembly-Export führt geeignete Notizbücher vollständig im Browser aus. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install python3 python3-venv
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/marimo-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/marimo-lab
5. Python-Umgebung anlegen
Die Bibliotheken bleiben vom Ubuntu-Python getrennt.
python3 -m venv .venv
6. Paketwerkzeug aktualisieren
Verwendet ausdrücklich pip aus der neuen Umgebung.
.venv/bin/python -m pip install --upgrade pip
7. marimo installieren
Installiert marimo und uv in der eigenen Umgebung. Der aktuelle WebAssembly-Export benötigt uv zur Auflösung lokaler Importe.
.venv/bin/python -m pip install marimo uv
8. Notizbuch erstellen
Öffne die angezeigte lokale Adresse. Füge eine Python-Zelle mit print(sum([4, 8, 15])) ein und führe sie aus: erwartet wird 27. Speichere das Notizbuch und beende den Server mit Strg + C.
.venv/bin/marimo edit labor.py --host 127.0.0.1
9. Browserfassung exportieren
Erzeugt dist/ für die Ausführung über Pyodide. Native Systemprogramme und beliebige Python-Erweiterungen sind dort nicht verfügbar.
PATH="$PWD/.venv/bin:$PATH" .venv/bin/marimo export html-wasm labor.py -o dist --mode edit
10. Browserfassung testen
Öffne http://127.0.0.1:8000. Starte die Zelle erneut; dafür ist nun kein laufender marimo-Server nötig. Internet wird zum Laden von Laufzeit und Paketen benötigt. Strg + C beendet den HTTP-Server.
python3 -m http.server 8000 --bind 127.0.0.1 --directory dist
Installation prüfen
1. Version anzeigen
Bestätigt die Installation im Projekt.
.venv/bin/marimo --version
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/marimo-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/marimo-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Installation und WebAssembly-Export. marimo steht unter Apache-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.
Runestone
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Runestone stellt interaktive Lehrbücher, Aufgaben und Kursverwaltung bereit.
Für Ubuntu 26.04 LTS auf amd64. Der aktuelle offizielle Serverweg verwendet Docker Compose. Er widerspricht der Vorgabe dieses Buchs, direkt ohne Container zu installieren. Deshalb wird hier kein vollständiger Runestone-Server eingerichtet.
Installation
1. Offiziellen Betriebsweg prüfen
Die Serveranleitung beschreibt mehrere gemeinsam betriebene Dienste und eine Datenbank. Ein einzelnes Python-Paket ersetzt diesen Verbund nicht.
2. Native Voraussetzungen bewerten
Für einen eigenen nativen Aufbau müssten Datenbank, Webanwendungen, Hintergrundaufgaben, Proxy und Verwaltung zusammen portiert und unter Ubuntu 26.04 getestet werden. Eine belegte vollständige Anleitung liegt hier dafür nicht vor. Die Entwicklerdokumentation zeigt die beteiligten Komponenten.
Installation prüfen
Es wurden keine Programme, Dienste oder Datenbanken eingerichtet. Eine spätere echte Inbetriebnahme müsste Anmeldung, Buchbau, Kurszuordnung, Aufgabenbearbeitung und Speicherung der Ergebnisse gemeinsam prüfen.
Deinstallieren
Es gibt aus diesem Kapitel nichts zu entfernen. Insbesondere werden keine bestehenden Python-Umgebungen oder Datenbanken verändert.
Quellen und Lizenz
Runestone-Dokumentation. Runestone besteht aus mehreren Open-Source-Komponenten; prüfe die Lizenz der konkret verwendeten Repositorys und die gesonderten Rechte an den Lehrbuchinhalten.
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.
Quarto Live
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Quarto Live ergänzt Quarto-Dokumente um R- und Python-Zellen, die im Browser ausgeführt werden.
Für Ubuntu 26.04 LTS auf amd64. Installiere zunächst Quarto nach der Quarto-Anleitung. Hier wird eine Python-Seite eingerichtet. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install python3 python3-venv
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/quarto-live-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/quarto-live-lab
5. Python-Umgebung anlegen
Die Bibliotheken bleiben vom Ubuntu-Python getrennt.
python3 -m venv .venv
6. Paketwerkzeug aktualisieren
Verwendet ausdrücklich pip aus der neuen Umgebung.
.venv/bin/python -m pip install --upgrade pip
7. Jupyter-Werkzeuge installieren
Stellt die beim Rendern verwendete Python-Engine bereit. Die spätere Übung läuft über Pyodide.
.venv/bin/python -m pip install jupyter
8. Quarto-Erweiterung hinzufügen
Lädt die Erweiterung in dieses Projekt. Bestätige die Rückfrage nach dem vertrauenswürdigen Herausgeber.
quarto add r-wasm/quarto-live
9. Dokument schreiben
Die Kennzeichnung pyodide richtet eine interaktive Python-Zelle ein.
cat > index.qmd <<'EOF'
---
title: "Python-Labor im Browser"
format: live-html
---
Ändere die Werte und starte die Rechnung erneut.
```{pyodide}
werte = [3, 6, 12]
print(sum(werte))
```
EOF
10. Vorschau starten
Öffne http://127.0.0.1:4200. Starte die Python-Zelle: erwartet wird 21. Die virtuelle Umgebung wird für den Bau gewählt; Browserlaufzeit und zusätzliche Pakete benötigen beim Laden Internet. Strg + C beendet die Vorschau.
QUARTO_PYTHON="$PWD/.venv/bin/python" quarto preview index.qmd --host 127.0.0.1 --port 4200 --no-browser
Installation prüfen
1. Dokument bauen
Erzeugt index.html und benötigte Begleitdateien. Bewahre sie zusammen auf.
QUARTO_PYTHON="$PWD/.venv/bin/python" quarto render index.qmd
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/quarto-live-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/quarto-live-lab && echo 'Projekt entfernt'
Quarto selbst wird bei Bedarf nach der Quarto-Anleitung entfernt.
Quellen und Lizenz
Quarto Live installieren und Browserpakete. Die Lizenz der Erweiterung und der eingebundenen Laufzeiten ist bei Weitergabe gesondert zu beachten.
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.
Runme
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Runme führt Befehlsblöcke aus Markdown als lokale Arbeitsabläufe aus.
Für Ubuntu 26.04 LTS auf amd64. Die Befehle laufen mit deinen Benutzerrechten auf Ubuntu. Lies fremde Notizbücher vor dem Ausführen. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install golang-go ca-certificates
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/runme-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/runme-lab
5. Go prüfen
Aktuelle Runme-Versionen können ein neueres Go benötigen. Go kann bei Bedarf eine passende Toolchain nachladen, sofern die Netzwerk- und Go-Konfiguration dies erlauben.
go version
6. Zielordner anlegen
Der eigene bin-Ordner hält Runme vom Systempfad getrennt.
mkdir bin
7. Runme bauen
Installiert die v3-CLI aus dem offiziellen Go-Modul in dieses Beispielprojekt.
GOBIN="$PWD/bin" go install github.com/runmedev/runme/v3@latest
8. Labor schreiben
Enthält nur einen harmlosen Testbefehl. Die runme-Markierung gibt dem Block einen Namen.
cat > README.md <<'EOF'
# Lokales Ubuntu-Labor
## Arbeitsordner prüfen
```sh { name=ordner-pruefen }
pwd
```
EOF
9. Aufgaben auswählen
Wähle den Block ordner-pruefen aus. Die Ausgabe soll den Ordner runme-lab zeigen. Beende die Oberfläche über deren Quit-Funktion beziehungsweise Strg + C.
./bin/runme tui
Installation prüfen
1. CLI prüfen
Zeigt die verfügbaren Befehle. Bei Installation aus Go kann eine generische Versionsnummer angezeigt werden.
./bin/runme --help
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/runme-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/runme-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Offizielle CLI-Installation und Go-Modul. Lizenz: Apache-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.
Livebook
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Livebook ist eine Umgebung für ausführbare Elixir-Notizbücher mit einer Browseroberfläche.
Für Ubuntu 26.04 LTS auf amd64. Der Server und die Rechenprozesse laufen bei dieser Anleitung direkt auf Ubuntu.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketstände.
sudo apt update
2. Elixir und Erlang-Komponenten installieren
Livebook benötigt Elixir ab 1.18 und diese Erlang-Anwendungen. Build-Werkzeuge werden für native Erweiterungen mitinstalliert.
sudo apt install elixir erlang-dev erlang-inets erlang-os-mon erlang-runtime-tools erlang-ssl erlang-xmerl erlang-parsetools build-essential
3. Elixir prüfen
Ubuntu 26.04 liefert Elixir 1.18.3. Bei einer älteren aktiven Version hier anhalten.
elixir --version
4. Hex einrichten
Installiert Elixirs Paketwerkzeug im Benutzerkonto.
mix local.hex --force
5. Rebar einrichten
Stellt das Werkzeug zum Bauen von Erlang-Abhängigkeiten bereit.
mix local.rebar --force
6. Livebook installieren
Baut das ausführbare escript im Benutzerkonto. Bestätige die Installation bei der Rückfrage.
mix escript.install hex livebook
7. Server lokal starten
Öffne die im Terminal angezeigte Adresse einschließlich Zugangstoken. Lege ein Notizbuch an und berechne Enum.sum([2, 5, 9]); erwartet wird 16. Speichere die .livemd-Datei im Home-Verzeichnis. Strg + C beendet den Server.
~/.mix/escripts/livebook server --ip 127.0.0.1
Installation prüfen
1. Serveroptionen anzeigen
Bestätigt, dass das escript ausführbar ist.
~/.mix/escripts/livebook server --help
Deinstallieren
1. Livebook entfernen
Entfernt das installierte escript. Gespeicherte .livemd-Dateien bleiben erhalten.
mix escript.uninstall livebook
2. Entfernung prüfen
Die Bestätigung erscheint, wenn der Standard-Installationspfad entfernt wurde.
test ! -e ~/.mix/escripts/livebook && echo 'Livebook entfernt'
Quellen und Lizenz
Direkte Livebook-Installation und Ubuntu-Elixir. Lizenz: Apache-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.
MyST
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
MyST erzeugt wissenschaftliche Dokumentationen aus Markdown und Jupyter-Notizbüchern.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/myst-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/myst-lab
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. MyST installieren
Installiert die CLI und npm 11 im Projekt. Aktuelles MyST benötigt npm ab Version 10; Ubuntu 26.04 liefert npm 9. npx verwendet für MyST die lokale neuere npm-Version. Das apt-Paket wird dabei nicht ersetzt.
npm install --save-dev mystmd npm@11
8. Startseite schreiben
Erzeugt den eigenen Beispielinhalt.
cat > index.md <<'EOF'
# Mein Rechenbuch
Dieses Buch erklärt Versuche unter Ubuntu.
## Erste Beobachtung
Eine Rechnung wird zusammen mit ihrem Ergebnis dokumentiert.
EOF
9. Buch konfigurieren
Legt die Startseite und das Buchdesign fest.
cat > myst.yml <<'EOF'
version: 1
project:
title: Ubuntu-Rechenbuch
toc:
- file: index.md
site:
template: book-theme
EOF
10. Vorschau starten
Das Design wird beim ersten Start geladen. Öffne die im Terminal genannte Adresse, normalerweise http://localhost:3000. Prüfe die Überschrift. Strg + C beendet die Vorschau.
npx myst start
Installation prüfen
1. HTML bauen
Erzeugt die statische Ausgabe unter _build/html. Ein erfolgreicher Bau führt noch keine neuen Python-Zellen aus.
npx myst build --html
2. Version anzeigen
Dokumentiert den installierten CLI-Stand.
npx myst --version
Notizbücher ausführen
Für ein vollständiges Beispiel mit einer lokalen Jupyter-Umgebung und Verweisen auf Binder, JupyterHub und Colab siehe Jupyter Book. Der statische Buchbau allein stellt keinen Rechenserver bereit.
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/myst-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/myst-lab && echo 'Projekt entfernt'
Quellen und Lizenz
MyST-Einstieg und MyST-Projekt. Lizenz: MIT.
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.
Jupyter Book
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Jupyter Book verbindet erklärende Texte mit ausführbaren Jupyter-Notizbüchern.
Für Ubuntu 26.04 LTS auf amd64. Diese Anleitung verwendet Version 2 auf Basis von MyST. Anleitungen für Version 1 mit _config.yml und _toc.yml sind damit nicht austauschbar. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install python3 python3-venv
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/jupyter-book-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/jupyter-book-lab
5. Python-Umgebung anlegen
Die Bibliotheken bleiben vom Ubuntu-Python getrennt.
python3 -m venv .venv
6. Paketwerkzeug aktualisieren
Verwendet ausdrücklich pip aus der neuen Umgebung.
.venv/bin/python -m pip install --upgrade pip
7. Node.js installieren
Die MyST-Engine von Jupyter Book 2 benötigt zusätzlich Node.js.
sudo apt install nodejs npm
8. Buch- und Notebookwerkzeuge installieren
JupyterLab dient als lokale Oberfläche; ipykernel führt die Python-Zellen aus.
.venv/bin/python -m pip install "jupyter-book>=2,<3" jupyterlab ipykernel
9. Beispielnotizbuch schreiben
Erzeugt ein gültiges .ipynb mit einer eigenen kleinen Rechnung.
.venv/bin/python - <<'EOF'
import nbformat as nbf
book = nbf.v4.new_notebook()
book.cells = [
nbf.v4.new_markdown_cell('# Mein Ubuntu-Versuch'),
nbf.v4.new_code_cell('messwerte = [10, 12, 14]\nsum(messwerte) / len(messwerte)')
]
book.metadata.kernelspec = {
'display_name': 'Python 3', 'language': 'python', 'name': 'python3'
}
nbf.write(book, 'versuch.ipynb')
EOF
10. Buch konfigurieren
Nimmt das Notizbuch als Startseite auf.
cat > myst.yml <<'EOF'
version: 1
project:
title: Ubuntu-Notizbuch
toc:
- file: versuch.ipynb
site:
template: book-theme
EOF
11. Notizbuch lokal öffnen
Öffne die angezeigte Adresse mit Token. Wähle versuch.ipynb und führe die Rechenzelle aus. Erwartet wird 12.0. Speichere und beende JupyterLab mit Strg + C.
.venv/bin/jupyter lab --ip=127.0.0.1 --no-browser
12. Buchvorschau starten
Öffne die angezeigte Adresse, normalerweise http://localhost:3000. Die zuvor gespeicherte Ausgabe soll im Buch erscheinen. Strg + C beendet die Vorschau.
.venv/bin/jupyter book start
Installation prüfen
1. HTML bauen
Schreibt die statischen Buchseiten nach _build/html.
.venv/bin/jupyter book build --html
2. Version anzeigen
Die Ausgabe soll Hauptversion 2 zeigen.
.venv/bin/jupyter book --version
Binder, JupyterHub und Colab
Diese Dienste sind getrennte Ausführungsumgebungen. Es wird hier kein externer Dienst eingerichtet oder etwas hochgeladen.
-
Für Binder lege das Notizbuch und eine Datei mit seinen Python-Abhängigkeiten in ein öffentlich erreichbares Repository. Erzeuge anschließend auf mybinder.org einen Startlink für dieses Repository und füge ihn als normalen Markdown-Link in die Buchseite ein. Das öffentliche Angebot baut seine Umgebung extern mit Containern; auf deinem Ubuntu-Rechner wird dadurch kein Docker installiert.
-
Für einen vorhandenen JupyterHub verwende dessen bereitgestellte Notebook- oder nbgitpuller-Links. Die genaue URL hängt vom Hub deiner Einrichtung ab. Ein Buch erzeugt keine Benutzerkonten und keine Hub-Infrastruktur.
-
Für Colab öffne Google Colab, importiere versuch.ipynb über den Dateidialog und führe die Zelle erneut aus. Ein öffentlicher Link setzt eine bewusst freigegebene Notebookdatei voraus.
Die .ipynb-Datei ist die übertragbare Einheit; eine MyST-Markdown-Seite wird von Colab nicht automatisch als Notizbuch ausgeführt.
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/jupyter-book-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/jupyter-book-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Jupyter Book 2 installieren, Website erstellen, Binder, JupyterHub und Colab. Jupyter Book steht unter BSD-3-Clause; Dienste haben eigene Nutzungsbedingungen.
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.
Docusaurus Live Codeblock
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docusaurus Live Codeblock zeigt bearbeitbaren React-Code mit unmittelbarer Vorschau.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/docusaurus-live-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/docusaurus-live-lab
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. Docusaurus-Pakete installieren
Verwendet für alle Docusaurus-Pakete denselben veröffentlichten Stand.
npm install @docusaurus/core@3.10.2 @docusaurus/preset-classic@3.10.2 @docusaurus/theme-live-codeblock@3.10.2 react@19 react-dom@19
8. Seitenordner anlegen
Eine eigene MDX-Seite genügt für die Demo.
mkdir -p src/pages
9. Konfiguration schreiben
Schaltet Dokumentation und Blog für diese reine Demoseite ab und aktiviert das Live-Theme.
cat > docusaurus.config.js <<'EOF'
module.exports = {
title: 'React-Labor',
url: 'https://example.org',
baseUrl: '/',
presets: [['classic', { docs: false, blog: false }]],
themes: ['@docusaurus/theme-live-codeblock'],
i18n: { defaultLocale: 'de', locales: ['de'] }
};
EOF
10. Live-Seite schreiben
Die Markierung live aktiviert die React-Vorschau. Das Beispiel benötigt keinen eigenen Ausführungsserver.
cat > src/pages/index.mdx <<'EOF'
import Layout from '@theme/Layout';
<Layout title="React ausprobieren">
# Mein React-Labor
Ändere den Text oder den Farbwert.
```jsx live
<button style={{ background: '#176b45', color: 'white', padding: 16 }}>
Mein erster Versuch
</button>
```
</Layout>
EOF
11. Vorschau starten
Öffne http://127.0.0.1:3000. Ändere den Text im Live-Editor: die Schaltfläche soll sich sofort ändern. Strg + C beendet die Vorschau.
npx docusaurus start --host 127.0.0.1 --no-open
Installation prüfen
1. Seite bauen
Erzeugt build/. Das bestätigt den MDX- und React-Bau; prüfe die Interaktion zusätzlich in der Vorschau.
npx docusaurus build
2. Paketstände prüfen
Die drei Docusaurus-Pakete sollen dieselbe Version haben.
npm ls @docusaurus/core @docusaurus/preset-classic @docusaurus/theme-live-codeblock
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/docusaurus-live-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/docusaurus-live-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Live-Theme und interaktive Codeblöcke. Lizenz: MIT. Für ein vollständiges Dokumentationsprojekt siehe Docusaurus.
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.
Google Codelabs Tools
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Google Codelabs Tools wandelt schrittweise Lernanleitungen mit claat in Webseiten um.
Für Ubuntu 26.04 LTS auf amd64. Das offizielle Repository ist seit dem 16. Dezember 2025 archiviert. Dieser Weg dient dem Arbeiten mit bestehenden Codelabs; das Projekt erhält dort keine regulären Änderungen mehr. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install golang-go ca-certificates
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/codelabs-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/codelabs-lab
5. Binärordner anlegen
Speichert claat ausschließlich im Beispielprojekt.
mkdir bin
6. claat installieren
Baut die CLI aus dem archivierten offiziellen Modul. Bei einem Abhängigkeitsfehler nicht auf alte go-get-Installationsbefehle ausweichen, sondern die konkrete Fehlermeldung prüfen.
GOBIN="$PWD/bin" go install github.com/googlecodelabs/tools/claat@latest
7. Codelab schreiben
Legt Metadaten, Kennung und zwei Lernschritte an.
cat > labor.md <<'EOF'
author: Ubuntu-Labor
summary: Eine erste lokale Lernanleitung
id: ubuntu-einstieg
categories: ubuntu
environments: Web
status: Draft
# Ubuntu schrittweise erkunden
## Arbeitsordner anzeigen
Duration: 0:02:00
Öffne ein Terminal und führe `pwd` aus.
## Ergebnis verstehen
Duration: 0:01:00
Die Ausgabe nennt den aktuellen Arbeitsordner.
EOF
8. HTML exportieren
Erzeugt den Ordner ubuntu-einstieg mit der Lernanleitung.
./bin/claat export labor.md
9. HTTP-Werkzeug installieren
Python liefert die erzeugten Dateien lokal aus.
sudo apt install python3
10. Codelab ansehen
Öffne http://127.0.0.1:8000/ubuntu-einstieg/ und prüfe beide Schritte. Die erzeugte Oberfläche kann externe Ressourcen nachladen. Strg + C beendet den Server.
python3 -m http.server 8000 --bind 127.0.0.1
Installation prüfen
1. CLI-Hilfe anzeigen
Bestätigt, dass claat gebaut wurde und ausführbar ist.
./bin/claat help
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/codelabs-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/codelabs-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Archivstatus, claat-Installation und Eingabeformat. Lizenz: Apache-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.
Kurse und Lernwerkzeuge
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Übersicht führt zu Lernangeboten und lokalen Übungswerkzeugen für Ubuntu 26.04 LTS (amd64).
Anleitung auswählen
-
Wähle das Werkzeug nach seiner Aufgabe. Webangebote erhalten eine Zugangsanleitung; lokal installierbare Werkzeuge erhalten Installationsbefehle.
Werkzeug Aufgabe und Betriebsart Anleitung JetBrains Academy Plugin Kursaufgaben in einer kompatiblen JetBrains-IDE Plugin Rustlings Rust-Übungen im Terminal Rustlings Exercism-CLI Aufgaben lokal bearbeiten, Konto für Downloads Exercism CodeRoad Git-basierte interaktive Kurse in VS Code CodeRoad CodeTour Geführte Erläuterungen durch Quelldateien CodeTour GitHub Skills Übungsrepositorys mit GitHub Actions Webzugang Eigener Kurs-Prüfer Python-Tests im Terminal und per VS-Code-Befehl Eigenbau Anki mit FSRS Lernkarten und zeitlich verteilte Wiederholungen Anki Execute Program Onlinekurse mit Wiederholungen, begrenzter Gratiszugang Webzugang Python Tutor Programmablauf schrittweise visualisieren Webzugang js-parsons Codeblöcke lokal im Browser ordnen Bibliothek roadmap.sh Lernpfade im Browser Webzugang project-based-learning Linkliste als lokale Git-Kopie Projektideen build-your-own-x Linkliste für Nachbauprojekte Selbstbauideen kurs-lernen.js Eigener Browserkurs mit Vorhersage, Parsons, Karten und Pfad Eigenbau -
Folge der jeweiligen Anleitung in einem neuen Beispielordner. Die Kapitel zeigen auch, wie du die Einrichtung prüfst und wieder entfernst.
-
Verwende für Ergänzungen die vollständigen Quellcodearchive aus den Eigenbau-Kapiteln. Sie enthalten eigene kleine Beispiele. Der Kartenplan von kurs-lernen.js ist bewusst einfach; für den FSRS-Planer verwende Anki.
Die Anleitungen legen keine externen Konten an, buchen keine Zugänge und veröffentlichen keine Kurse. Ein kostenloses Plugin oder eine frei lizenzierte Linkliste garantiert keinen kostenlosen Zugang zu allen verlinkten Inhalten.
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.
JetBrains Academy Plugin
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das JetBrains Academy Plugin bindet Lernaufgaben und deren Prüfungen in JetBrains-IDEs ein.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Voraussetzung ist eine kompatible IDE, beispielsweise nach der IntelliJ-IDEA-Anleitung. Das Plugin ist kostenlos; IDE-Lizenz, einzelne Kurse und externe Angebote können andere Bedingungen haben.
Installation
1. Paketlisten aktualisieren
Aktualisiert Ubuntu-Paketinformationen. Das Plugin selbst wird anschließend über den IDE-Marketplace installiert.
sudo apt update
2. IDE starten
Öffne die bereits installierte JetBrains-IDE über das Ubuntu-Anwendungsmenü.
3. Pluginverwaltung öffnen
Öffne Settings → Plugins. Dort verwaltet die IDE zusätzliche Funktionen.
4. Plugin suchen
Wechsle zu Marketplace und suche JetBrains Academy. Prüfe JetBrains als Anbieter und die Kennung com.jetbrains.edu. Ähnlich benannte Erweiterungen sind andere Produkte.
5. Plugin installieren
Klicke Install. Die IDE wählt eine passende Pluginversion; falls keine angeboten wird, prüfe zunächst die Kompatibilitätsliste im Marketplace.
6. IDE neu starten
Starte die IDE neu, wenn sie dazu auffordert, damit das Plugin geladen wird.
7. Kurs auswählen
Öffne den Lernbereich der IDE, je nach Version unter Learn beziehungsweise My Courses. Wähle einen passenden kostenlosen Kurs oder importiere einen eigenen Kurs. Für dessen Aufgaben muss die jeweilige Sprache eingerichtet sein; das Plugin ersetzt keinen Python-, Java- oder Rust-Compiler.
Installation prüfen
1. Pluginstatus kontrollieren
Unter Settings → Plugins → Installed muss JetBrains Academy mit Versionsnummer und aktiviertem Status erscheinen.
2. Aufgabe prüfen
Öffne eine Aufgabe des ausgewählten Kurses und starte deren Prüfung. Kontrolliere, ob eine verständliche Rückmeldung erscheint. Ein angemeldetes Konto allein bestätigt keine funktionierende lokale Kurslaufzeit.
Deinstallieren
1. Plugin entfernen
Wähle unter Settings → Plugins → Installed bei JetBrains Academy die Aktion Uninstall. Gespeicherte Kursprojekte bleiben als Dateien erhalten.
2. IDE neu starten
Damit wird das Plugin entladen.
3. Entfernung prüfen
Kontrolliere, dass JetBrains Academy nicht mehr in der Liste der installierten Plugins steht.
Quellen und Lizenz
Offizieller Marketplace-Eintrag und Quellcode. Der veröffentlichte Quellcode steht unter Apache-2.0; Marketplace-Distribution und Dienste haben zusätzliche Nutzungsbedingungen.
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.
Rustlings
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Rustlings bietet kleine Rust-Aufgaben, die im Terminal geprüft werden.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Diese Anleitung verwendet Rustlings 6.5.0 mit Mindestversion Rust 1.88. Ubuntu 26.04 liefert einen ausreichend neuen Compiler. Ein neuer Ordner ~/rustlings-lab wird verwendet.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketstände.
sudo apt update
2. Rust-Werkzeuge installieren
Cargo baut Rustlings; die Build-Werkzeuge stellen den Linker bereit.
sudo apt install rustc cargo build-essential
3. Compiler prüfen
Erwartet wird mindestens Rust 1.88. Eine zusätzliche rustup-Installation kann im Suchpfad Vorrang vor apt haben; prüfe dann die tatsächlich angezeigte Version.
rustc --version
4. Rustlings installieren
Baut den festgelegten Stand mit seinen gesperrten Abhängigkeiten im Benutzerkonto.
cargo install rustlings --version 6.5.0 --locked
5. Installationsordner in den Suchpfad aufnehmen
Gilt für dieses Terminal. In einem neuen Terminal erneut ausführen, falls rustlings sonst nicht gefunden wird.
export PATH="$HOME/.cargo/bin:$PATH"
6. Arbeitsordner anlegen
Der Zielordner soll noch nicht existieren.
mkdir ~/rustlings-lab
7. Arbeitsordner öffnen
Hier wird der Übungssatz angelegt.
cd ~/rustlings-lab
8. Übungen erzeugen
Erzeugt den Unterordner rustlings.
rustlings init
9. Übungsordner öffnen
Rustlings sucht hier seine Aufgaben.
cd rustlings
10. Lernmodus starten
Lies die im Terminal angezeigte Aufgabe und bearbeite die genannte Datei mit deinem Editor. Die Oberfläche zeigt den Prüfstatus; beende sie über q beziehungsweise Strg + C.
rustlings
Installation prüfen
1. Version anzeigen
Die Ausgabe soll Rustlings 6.5.0 nennen.
rustlings --version
2. Prüfbefehle anzeigen
Zeigt die tatsächlich verfügbaren Befehle dieser Version. Für eine frisch erzeugte Sammlung sind noch nicht bestandene Übungen normal.
rustlings --help
Deinstallieren
1. Rustlings entfernen
Entfernt die mit Cargo installierte Binärdatei.
cargo uninstall rustlings
2. Übungen optional löschen
Löscht auch eigene Lösungen im Beispielordner; sichere sie vorher.
rm -rf -- ~/rustlings-lab
3. Entfernung prüfen
Im Installationsverzeichnis darf keine rustlings-Binärdatei mehr liegen.
test ! -e ~/.cargo/bin/rustlings && echo 'Rustlings entfernt'
Quellen und Lizenz
Offizielle Einrichtung und Paketstand 6.5.0. Lizenz: MIT. Rust und Cargo bleiben für andere Projekte installiert.
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.
Exercism-CLI
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Die Exercism-CLI lädt Programmieraufgaben herunter und kann Lösungen an Exercism übertragen.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Verwendet wird die offizielle Linux-x86_64-Binärdatei von Version 3.5.9. Für Downloads von Aufgaben brauchst du ein Exercism-Konto; Sprachwerkzeuge werden separat installiert.
Installation
1. Paketlisten aktualisieren
Aktualisiert die Paketinformationen vor dem Installieren der Downloadwerkzeuge.
sudo apt update
2. Werkzeuge installieren
curl lädt das Archiv; Python dient später als Laufzeit für die Beispielaufgabe.
sudo apt install curl ca-certificates tar python3
3. Downloadordner anlegen
Verwende einen neuen Ordner, damit keine vorhandenen Dateien überschrieben werden.
mkdir ~/exercism-installation
4. Downloadordner öffnen
Die folgenden Dateien liegen nur in diesem Ordner.
cd ~/exercism-installation
5. Programm herunterladen
Wählt x86_64, die passende Architektur für Ubuntu amd64.
curl --fail --location --output exercism-3.5.9-linux-x86_64.tar.gz https://github.com/exercism/cli/releases/download/v3.5.9/exercism-3.5.9-linux-x86_64.tar.gz
6. Prüfsummen herunterladen
Die offizielle Release-Datei enthält die erwarteten SHA-256-Werte.
curl --fail --location --output exercism_checksums.txt https://github.com/exercism/cli/releases/download/v3.5.9/exercism_checksums.txt
7. Archiv prüfen
Es muss OK erscheinen. Bei einer Abweichung hier anhalten und das Archiv nicht ausführen.
grep -E '(^|[ /])exercism-3\.5\.9-linux-x86_64\.tar\.gz$' exercism_checksums.txt | sha256sum --check --strict
8. Programm entpacken
Entpackt nur die benötigte Binärdatei.
tar -xzf exercism-3.5.9-linux-x86_64.tar.gz exercism
9. CLI installieren
Legt das Programm unter /usr/local/bin ab. Eine dort vorhandene Exercism-Version wird ersetzt.
sudo install -m 0755 exercism /usr/local/bin/exercism
10. CLI prüfen
Bestätigt, dass das installierte Programm ausführbar ist.
exercism version
11. API-Token ermitteln
Melde dich auf Exercism an und öffne die Einstellungen für den API-Token. Der Token ist ein Zugangsschlüssel und gehört nicht in Kursdateien oder Git-Repositorys.
12. Token verdeckt einlesen
Füge den eigenen Token ein und drücke Enter. Er erscheint nicht im Terminal und nicht als Klartextbefehl in der Shell-Historie.
read -r -s -p 'Exercism-Token: ' exercism_token
13. CLI zuordnen
Speichert die Kontozuordnung in der lokalen CLI-Konfiguration.
exercism configure --token="$exercism_token"
14. Temporäre Variable entfernen
Der Token bleibt nur in der CLI-Konfiguration gespeichert.
unset exercism_token
15. Python-Aufgabe laden
Lädt die Einstiegsaufgabe. Öffne nötigenfalls zuerst den Python-Track auf Exercism und folge dessen Freischaltungshinweisen. Das Terminal nennt den Zielordner.
exercism download --track=python --exercise=hello-world
16. Aufgabenordner öffnen
Bei unveränderter CLI-Konfiguration ist dies der Standardpfad. Verwende sonst den im vorherigen Schritt gemeldeten Pfad.
cd ~/Exercism/python/hello-world
17. Tests ausführen
Die Tests schlagen vor dem Lösen gewöhnlich fehl. Bearbeite anschließend die Lösungsdatei anhand der Aufgabenbeschreibung und wiederhole die Prüfung.
python3 -m unittest discover -p "*_test.py"
Installation prüfen
1. Version erneut anzeigen
Prüft die CLI unabhängig von der Aufgabe.
exercism version
Eine bestandene lokale Aufgabe und der erfolgreiche Download prüfen zusätzlich Laufzeit und Kontozugriff. Eine Abgabe erfolgt nur bewusst mit dem in der Aufgabe genannten submit-Befehl; diese Anleitung überträgt keine Lösung automatisch.
Deinstallieren
1. CLI entfernen
Löscht nur die hier installierte Binärdatei.
sudo rm -- /usr/local/bin/exercism
2. Downloadordner löschen
Entfernt das Installationsarchiv und seine entpackte Kopie.
rm -rf -- ~/exercism-installation
3. Entfernung prüfen
Es soll eine Bestätigung erscheinen.
test ! -e /usr/local/bin/exercism && echo 'Exercism-CLI entfernt'
Aufgaben unter ~/Exercism und die Kontokonfiguration bleiben erhalten. Soll auch der Kontozugriff entfallen, widerrufe den Token in den Exercism-Kontoeinstellungen und lösche nur die zu Exercism gehörenden Konfigurationsdateien; ihre Lage lässt sich vor dem Entfernen mit exercism troubleshoot ermitteln.
Quellen und Lizenz
Offizielle Releases, CLI-Quellcode und lokal arbeiten. Lizenz der CLI: MIT.
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.
CodeRoad
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
CodeRoad spielt interaktive Programmierkurse in VS Code ab.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Installiere zunächst Visual Studio Code. Die Erweiterung verwendet Git; weitere Laufzeiten hängen vom gewählten Kurs ab.
Installation
1. Paketlisten aktualisieren
Bereitet die Git-Installation vor.
sudo apt update
2. Git installieren
CodeRoad verwendet Git-basierte Kursstände.
sudo apt install git
3. VS Code prüfen
Falls der Befehl fehlt, folge zuerst der VS-Code-Anleitung.
code --version
4. Erweiterung installieren
Verwendet die genaue Marketplace-Kennung CodeRoad.coderoad, ohne sudo.
code --install-extension CodeRoad.coderoad
5. Kursordner anlegen
Für den Einstieg einen neuen leeren Ordner verwenden.
mkdir ~/coderoad-lab
6. Kursordner öffnen
Öffnet VS Code in einem eigenen Fenster.
code --new-window ~/coderoad-lab
7. CodeRoad starten
Öffne mit Strg + Umschalt + P die Befehlspalette und wähle CodeRoad: Start.
8. Kurs laden
Wähle Start New Tutorial und lade eine tutorial.json eines vertrauenswürdigen CodeRoad-Kurses. Die offizielle Anleitung beschreibt auch die Erstellung. Prüfe die vom Kurs verlangten Laufzeiten; Hooks können Befehle direkt auf deinem Rechner starten. Ein leerer Ordner allein enthält noch keinen Kurs.
Installation prüfen
1. Installierten Stand anzeigen
Die Ausgabe muss CodeRoad.coderoad mit einer Versionsnummer enthalten.
code --list-extensions --show-versions
2. Kursprüfung kontrollieren
Nach dem Laden muss die Oberfläche die erste Aufgabe zeigen. Starte deren Tests und kontrolliere, dass Rückmeldungen erscheinen. Ohne konkreten Kurs ist nur die Erweiterungsinstallation geprüft.
Deinstallieren
1. Erweiterung entfernen
Entfernt CodeRoad aus dem aktiven VS-Code-Profil.
code --uninstall-extension CodeRoad.coderoad
2. Beispielordner optional löschen
Sichere vorher eigene Kurslösungen; der ganze Ordner wird gelöscht.
rm -rf -- ~/coderoad-lab
3. Entfernung prüfen
CodeRoad.coderoad darf nicht mehr in der Liste erscheinen.
code --list-extensions
Quellen und Lizenz
Marketplace, Einrichtung und Quellcode. Lizenz: AGPL-3.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.
CodeTour
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
CodeTour führt Schritt für Schritt durch Dateien eines Projekts in VS Code.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Voraussetzung ist Visual Studio Code. Das Beispiel benötigt keine Cloud und keine automatische Bewertung.
Installation
1. Paketlisten aktualisieren
Aktualisiert die Paketinformationen für Python.
sudo apt update
2. Python installieren
Wird für das kleine Projektbeispiel gebraucht.
sudo apt install python3
3. Erweiterung installieren
Verwendet die offizielle Marketplace-Kennung.
code --install-extension vsls-contrib.codetour
4. Projektordner anlegen
Verwende einen noch nicht vorhandenen Zielordner.
mkdir ~/codetour-lab
5. Projektordner öffnen
Die folgenden Dateien gehören zu diesem Projekt.
cd ~/codetour-lab
6. Beispielprogramm schreiben
Zwei Zeilen genügen, um Navigation und Erläuterung zu erproben.
cat > beispiel.py <<'EOF'
orte = ["Bremen", "Ulm", "Jena"]
print(sorted(orte))
EOF
7. Tourordner anlegen
CodeTour findet gespeicherte Touren im Verzeichnis .tours.
mkdir .tours
8. Tour schreiben
Die zwei Schritte zeigen auf vorhandene Zeilen des eigenen Beispiels.
cat > .tours/einstieg.tour <<'EOF'
{
"title": "Ortsliste verstehen",
"steps": [
{
"file": "beispiel.py",
"line": 1,
"description": "Hier wird die Liste angelegt. Ergänze einen vierten Ort."
},
{
"file": "beispiel.py",
"line": 2,
"description": "Die Ausgabe ist alphabetisch sortiert. Prüfe sie anschließend im Terminal."
}
]
}
EOF
9. Projekt in VS Code öffnen
CodeTour erkennt die Tour im geöffneten Ordner.
code --new-window .
10. Tour starten
Wähle im CodeTour-Bereich des Explorers Ortsliste verstehen und starte die Tour. Kontrolliere, dass beide Schritte die passenden Zeilen öffnen. Falls der Bereich fehlt, lade das Fenster mit Developer: Reload Window neu.
Installation prüfen
1. Erweiterung anzeigen
Die Ausgabe muss vsls-contrib.codetour mit Versionsnummer enthalten.
code --list-extensions --show-versions
2. Beispiel ausführen
Zeigt die sortierte Liste; dies ist ein manuell gestarteter Befehl und keine automatische CodeTour-Bewertung.
python3 beispiel.py
Deinstallieren
1. Erweiterung entfernen
Entfernt CodeTour aus dem aktiven VS-Code-Profil.
code --uninstall-extension vsls-contrib.codetour
2. Projekt optional entfernen
Löscht auch die eigene Tour und das Beispielprogramm.
rm -rf -- ~/codetour-lab
3. Entfernung prüfen
vsls-contrib.codetour soll nicht mehr in der Ausgabe stehen.
code --list-extensions
Quellen und Lizenz
CodeTour-Projekt, Paketkennung und Tourformat. Lizenz: MIT.
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.
GitHub Skills
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GitHub Skills vermittelt GitHub-Arbeitsabläufe in Übungsrepositorys mit automatischen Rückmeldungen.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Es handelt sich um ein GitHub-Angebot, nicht um ein lokal installierbares Ubuntu-Programm. Ein Browser und ein GitHub-Konto reichen für den Einstieg. Die Adresse skills.github.com leitet derzeit zu GitHub Learn weiter.
Installation
1. Konto öffnen
Melde dich im Browser bei GitHub an. Es werden hier keine Zugangsdaten in Terminalbefehlen benötigt.
2. Übung auswählen
Öffne das offizielle Repository Introduction to GitHub. Es eignet sich als erster Kurs.
3. Eigene Übungskopie anlegen
Verwende Copy Exercise in der Kursbeschreibung. Wähle dein eigenes Konto als Eigentümer und prüfe den Repositorynamen und die Sichtbarkeit, bevor du die Kopie auf GitHub erstellst. Eine öffentliche Kopie ist öffentlich lesbar; private Repositorys können Actions-Kontingente verbrauchen.
4. Kursstart kontrollieren
Öffne in deiner Kopie den Reiter Actions. Der vorbereitende Workflow muss erfolgreich enden; lade danach die Kursseite neu.
5. Ersten Kursschritt bearbeiten
Folge der Anleitung in deiner Kopie. Die Schritte werden durch Änderungen im Repository und passende Workflowläufe ausgewertet; bloßes Klonen aktiviert keinen eigenen Kurs.
Optional lokal arbeiten
1. Paketlisten aktualisieren
Nur für die optionale lokale Git-Nutzung erforderlich.
sudo apt update
2. Git installieren
Stellt das Werkzeug für eine lokale Arbeitskopie bereit.
sudo apt install git
3. Klonadresse übernehmen
Öffne in deinem eigenen Übungsrepository Code und kopiere die HTTPS-Adresse. Klone deine Kopie, nicht nur die ursprüngliche Vorlage. Für ein öffentliches Repository ist zum Lesen keine Anmeldung nötig.
Der zu verwendende Befehl hat diese Form; ersetze DEIN-KONTO und DEIN-KURS vor dem Ausführen:
git clone https://github.com/DEIN-KONTO/DEIN-KURS.git
Einrichtung prüfen
1. Kursfortschritt kontrollieren
In deiner Repositorykopie sollen die Kursanweisungen fortgeschrieben werden und passende Actions-Läufe erfolgreich sein. Für die optionale lokale Nutzung prüft der folgende Befehl zusätzlich Git.
git --version
Entfernen
1. Kursautomatik bei Bedarf stoppen
Deaktiviere in der eigenen Repositorykopie die Kursworkflows unter Actions, wenn sie nicht weiterlaufen sollen.
2. Übungsrepository optional löschen
Öffne Settings → General → Danger Zone deiner eigenen Kopie und verwende Delete this repository nur nach einer Sicherung. Dies entfernt Repository und Kursfortschritt auf GitHub; prüfe die angezeigte Repositorykennung vor der Bestätigung.
3. Entfernung prüfen
Kontrolliere im eigenen GitHub-Konto, dass die Übungskopie entfernt beziehungsweise ihre Workflows deaktiviert sind. Lokale Klone bleiben bestehen und können separat gelöscht werden.
Quellen und Lizenz
GitHub Skills und offizieller Einstiegskurs. Die Kursvorlage steht unter MIT. Für den GitHub-Dienst gelten dessen eigene Nutzungsbedingungen. Diese Anleitung legt selbst kein Repository an.
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.
Eigener Kurs-Prüfer mit VS-Code-Erweiterung
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Dieser kleine Kurs-Prüfer bewertet eine Python-Aufgabe im Terminal und über einen eigenen VS-Code-Befehl.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Voraussetzung für die Editorintegration ist Visual Studio Code. Die Tests laufen direkt mit deinen Benutzerrechten. Das Beispiel ist für eigene lokale Übungen gedacht und keine Sandbox für fremden Code.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketinformationen.
sudo apt update
2. Werkzeuge installieren
Python führt die Tests aus; Node.js und npm bauen die Erweiterung. unzip entpackt den Kurs.
sudo apt install python3 nodejs npm unzip
3. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Verwende für das Paketwerkzeug mindestens Node.js 22.12.
node --version
4. Kursdateien herunterladen
Lade das Beispielarchiv über den Browser nach ~/Downloads herunter. Es enthält den vollständigen eigenen Quellcode, die Aufgabe und ihre Tests. Der Zielordner ~/kurs-pruefer soll noch nicht existieren.
5. Kurs entpacken
Erzeugt ~/kurs-pruefer mit Aufgabe, Tests und Erweiterungsquellen.
unzip ~/Downloads/kurs-pruefer.zip -d ~
6. Kursordner öffnen
Prüfungen werden immer aus diesem Ordner gestartet.
cd ~/kurs-pruefer
7. Ausgangszustand prüfen
Die Aufgabe ist absichtlich unvollständig. Erwartet wird ein Fehler wegen NotImplementedError und ein von null verschiedener Rückgabewert.
python3 -m unittest discover -s tests -p test_aufgabe.py -v
8. Aufgabe bearbeiten
Implementiere quadratsumme(werte): Quadriere jede Zahl und addiere die Ergebnisse. Für eine leere Eingabe ist das Ergebnis 0. Auch Generatoren müssen funktionieren; die Eingabe darf nicht verändert werden. Bearbeite nur aufgabe.py und speichere die Datei.
code aufgabe.py
9. Lösung prüfen
Bei einer richtigen Lösung müssen fünf Tests mit OK enden. Derselbe Befehl wird später von der Erweiterung gestartet.
python3 -m unittest discover -s tests -p test_aufgabe.py -v
10. Erweiterungsordner öffnen
Hier liegt die Paketbeschreibung für VS Code.
cd ~/kurs-pruefer/erweiterung
11. Paketwerkzeug installieren
Installiert vsce nur in diesem Projekt, ohne sudo. Die Erweiterung selbst benötigt keine npm-Laufzeitpakete.
npm install --save-dev @vscode/vsce
12. VSIX bauen
Erzeugt ein lokal installierbares Paket. Die Optionen erlauben einen lokalen Eigenbau ohne Repositoryadresse und ohne festgelegte Weitergabelizenz; es wird nichts im Marketplace veröffentlicht.
npx vsce package --allow-missing-repository --skip-license --out kurs-pruefer-0.1.0.vsix
13. Erweiterung installieren
Registriert das lokale Paket im aktiven VS-Code-Profil. Ein Marketplace-Konto ist nicht erforderlich.
code --install-extension ./kurs-pruefer-0.1.0.vsix
14. Kurs im Editor öffnen
Öffnet ausdrücklich den Kursordner, nicht nur den Unterordner erweiterung. Bestätige das Workspace-Vertrauen nur für diesen selbst geprüften Kurs.
code --new-window ~/kurs-pruefer
15. Kursprüfung starten
Öffne Strg + Umschalt + P und wähle Kurs: Aufgabe prüfen. Die Erweiterung speichert offene Dateien und öffnet einen Python-Testtask. Bei mehreren Arbeitsordnern wird der Zielordner ausgewählt. Im Terminal sollen dieselben fünf Testergebnisse wie zuvor erscheinen.
Installation prüfen
1. Erweiterung anzeigen
Die Ausgabe muss lokale-kurse.kurs-pruefer@0.1.0 enthalten.
code --list-extensions --show-versions
2. Fehlererkennung testen
Baue vorübergehend einen falschen Rückgabewert in aufgabe.py ein. Starte Kurs: Aufgabe prüfen erneut; die Tests müssen scheitern. Stelle danach deine richtige Lösung wieder her und prüfe sie erneut.
Quellcode verstehen
Die Datei tests/test_aufgabe.py enthält fünf Fälle: positive Werte, negative Werte, leere Eingabe, Generator und unveränderte Eingabe. VS Code startet Python über ProcessExecution mit einer festen Argumentliste und dem gewählten Kursordner. Dadurch funktionieren auch Ordnernamen mit Leerzeichen. Die Erweiterung wertet keine Shellbefehle aus Kursbeschreibungen aus. Die Python-Tests selbst führen den Aufgabencode aus.
Der vollständige Quellcode steht im Archiv. Eine zusätzliche fertige VSIX-Datei liegt zum lokalen Installieren bei; die Schritte oben zeigen den eigenen Bau. Der Platzhalter-Herausgeber lokale-kurse ist keine Marketplace-Registrierung. Vor einer Weitergabe eigener Änderungen legst du Lizenz, Herausgeber und Versionspflege selbst fest.
Deinstallieren
1. Erweiterung entfernen
Entfernt die lokale Erweiterung aus dem aktiven Profil.
code --uninstall-extension lokale-kurse.kurs-pruefer
2. Projekt optional entfernen
Sichere vorher deine Lösung. Löscht Aufgabe, Tests und lokale npm-Werkzeuge.
rm -rf -- ~/kurs-pruefer
3. Entfernung prüfen
lokale-kurse.kurs-pruefer darf nicht mehr in der Liste erscheinen.
code --list-extensions
Quellen und Lizenz
Eigener Beispielcode für dieses Buch. Technische Referenzen: VS-Code-Task-API, Paketierung als VSIX, Workspace Trust und Python unittest. Es wird keine Fremdlizenz automatisch auf deinen eigenen Kurs übertragen.
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.
Anki mit FSRS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Anki verwaltet Lernkarten und plant Wiederholungen mit dem eingebauten FSRS-Planer.
Für Ubuntu 26.04 LTS (amd64). Die Ubuntu-Paketsuche führt kein Anki-Paket für 26.04. Deshalb wird der offizielle Linux-Installer 26.09.4 verwendet. Ein sehr altes Paket aus einer anderen Ubuntu-Version wäre kein geeigneter Ersatz für FSRS.
Einrichtung
1. Paketlisten aktualisieren
Aktualisiert die Informationen für die benötigten Systembibliotheken.
sudo apt update
2. Abhängigkeiten installieren
Stellt Download, Archivverarbeitung und die im Handbuch genannten Grafikbibliotheken bereit. Der offizielle Installer kann weitere Systembibliotheken über apt ergänzen.
sudo apt install curl ca-certificates zstd tar xdg-utils libxcb-xinerama0 libxcb-cursor0 libnss3 libxcb-icccm4 libxcb-keysyms1
3. Vorhandene Installation prüfen
Falls bereits eine ältere apt-Version installiert ist, sichere zuerst deine Sammlung und entferne dieses Paket vor dem offiziellen Installer. Bei einem neuen Rechner ist keine Entfernung nötig.
dpkg-query -W anki
Nur wenn dabei ein installiertes Paket angezeigt wird:
sudo apt remove anki
4. Arbeitsordner anlegen
Verwende einen neuen Zielordner.
mkdir ~/anki-installation
5. Arbeitsordner öffnen
Download und entpackte Dateien bleiben zusammen.
cd ~/anki-installation
6. Installer laden
Lädt den offiziellen x86_64-Stand. Die Version ist für diese Anleitung festgelegt.
curl --fail --location --output anki.tar.zst https://github.com/ankitects/anki/releases/download/26.09.4/anki-26.09.4-linux-x86_64.tar.zst
7. Archiv entpacken
Entfernt die oberste Archivebene, sodass install.sh direkt im Arbeitsordner liegt.
tar -xaf anki.tar.zst --strip-components=1
8. Anki installieren
Führt den offiziellen Installer aus. Er legt Anki unter /usr/local ab; Updates laufen danach nicht über Ubuntus apt-Paketverwaltung.
sudo ./install.sh
9. Anki starten
Wähle beim ersten Start die gewünschte Sprache.
anki
10. Teststapel erstellen
Lege einen neuen Stapel Ubuntu-Test an, damit du die Lernfunktionen mit eigenen Karten ausprobieren kannst.
11. FSRS aktivieren
Öffne über das Zahnrad die Stapeloptionen und aktiviere FSRS im entsprechenden Abschnitt. Die Aktivierung gilt global für die Sammlung, nicht nur für den Teststapel. Bei synchronisierten Geräten müssen alle verwendeten Clients FSRS unterstützen.
12. Einstellungen speichern
Behalte für den Einstieg den vorgeschlagenen Zielwert für die Erinnerungswahrscheinlichkeit bei. Ein höherer Wert erhöht die tägliche Wiederholungsarbeit. Für die Aktivierung wird kein zusätzliches FSRS-Add-on benötigt.
13. Eigene Karte hinzufügen
Lege etwa eine Karte mit der Frage Welcher Befehl zeigt den Arbeitsordner? und der Antwort pwd an.
Installation prüfen
1. Versionsstand kontrollieren
Unter Hilfe → Über Anki muss die installierte Version angezeigt werden. In den Stapeloptionen muss FSRS weiterhin aktiviert sein.
2. Lernen ausprobieren
Lerne die Testkarte und bewerte deine tatsächliche Erinnerung. Wenn du die Antwort nicht wusstest, verwende die Bewertung für erneut lernen. Prüfe, dass Anki einen neuen Fälligkeitstermin speichert.
Deinstallieren
Beende Anki und sichere gewünschte Karten vor dem Entfernen.
1. Programm entfernen
Verwendet das mitgelieferte Deinstallationsskript der offiziellen Installation.
sudo /usr/local/share/anki/uninstall.sh
2. Arbeitsordner optional löschen
Entfernt das Archiv und die entpackten Installerdateien.
rm -rf -- ~/anki-installation
3. Entfernung prüfen
Die Bestätigung erscheint, wenn der offizielle Programmstarter entfernt wurde.
test ! -e /usr/local/bin/anki && echo 'Anki entfernt'
Die Sammlung im Benutzerverzeichnis bleibt erhalten. Die Deinstallation löscht keine Lernkarten und kein AnkiWeb-Konto.
Quellen und Lizenz
Ubuntu-Paketsuche, offizielle Downloads, Linux-Installation und FSRS-Optionen. Anki Desktop ist freie Software (AGPL-3.0); Inhalte importierter Kartensammlungen haben gesonderte Rechte.
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.
Execute Program
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Execute Program bietet Programmierkurse mit interaktiven Aufgaben und zeitlich verteilten Wiederholungen.
Für Ubuntu 26.04 LTS (amd64). Das Angebot wird im Browser genutzt. Es wird kein lokales Ubuntu-Paket installiert und kein Execute-Program-Server eingerichtet. Der Anbieter bietet derzeit kostenlose Einstiegslektionen; der volle Kurszugang ist kostenpflichtig.
Einrichtung
1. Angebot öffnen
Öffne Execute Program im Browser.
2. Zugangsumfang prüfen
Prüfe auf der Website den aktuellen Gratisumfang und die Preise. Beginne mit dem kostenlosen Einstieg, wenn du noch keinen kostenpflichtigen Zugang möchtest.
3. Konto anlegen oder anmelden
Ein Konto ordnet Kursfortschritt und spätere Wiederholungen deinem Zugang zu.
4. Kurs auswählen
Wähle einen zum Vorwissen passenden Kurs und öffne dessen erste verfügbare Lektion.
5. Aufgabe bearbeiten
Gib deine Antwort ein und beachte die Rückmeldung. Die Plattform verwaltet den weiteren Kurs- und Wiederholungsablauf.
Einrichtung prüfen
1. Fortschritt kontrollieren
Lade nach einer bearbeiteten Lektion die Kursübersicht neu und prüfe, ob dein Fortschritt erhalten bleibt.
2. Wiederholungen aufrufen
Öffne an einem späteren Lerntag die fälligen Wiederholungen. Ein leerer Bereich direkt nach der Anmeldung ist noch kein Fehler.
Entfernen
1. Kostenpflichtigen Zugang gegebenenfalls kündigen
Nutze dafür die Kontoverwaltung des Anbieters. Abmelden im Browser beendet kein Abonnement.
2. Abmelden
Melde dich auf der Website ab. Bei Bedarf entferne ihre Website-Daten über die Browser-Einstellungen.
Da lokal kein Paket installiert wurde, gibt es keinen apt-Deinstallationsbefehl. Eine Kontolöschung erfolgt getrennt über die vom Anbieter bereitgestellten Kontofunktionen.
Quellen und Lizenz
Offizielle Produkt- und Zugangsseite. Für den Dienst und die Kursinhalte gelten die Bedingungen des Anbieters; diese Anleitung übernimmt keine Lektionstexte.
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.
Python Tutor
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Python Tutor zeigt die Ausführung kleiner Programme schrittweise mit Variablen und Datenstrukturen.
Für Ubuntu 26.04 LTS (amd64). Hier wird der kostenlose Webzugang beschrieben. Der Code wird an den Anbieter übertragen; verwende dafür eigene, unkritische Beispiele. Eine lokale Serverinstallation wird nicht eingerichtet.
Einrichtung
1. Visualizer öffnen
Öffne Python Tutor im Browser und wähle Python.
2. Eigenes Beispiel eingeben
Das Programm verändert eine Liste über zwei Namen. Es eignet sich, um gemeinsame Referenzen zu beobachten.
zahlen = [3, 6]
zweiter_name = zahlen
zweiter_name.append(9)
print(zahlen)
3. Visualisierung starten
Klicke Visualize Execution, damit der Ausführungsablauf berechnet wird.
4. Schrittweise vorgehen
Gehe mit der Vorwärtsschaltfläche jeweils eine Zeile weiter und beobachte, dass beide Namen auf dieselbe Liste zeigen.
Einrichtung prüfen
1. Ergebnis vergleichen
Am Ende muss die Ausgabe [3, 6, 9] erscheinen. Gehe anschließend einen Schritt zurück und prüfe die vorherige Ansicht.
Entfernen
1. Seite schließen
Es wurde kein Ubuntu-Programm installiert. Entferne bei Bedarf die Website-Daten im Browser. Lokal gespeicherte Beispieldateien oder geteilte Links werden dadurch nicht automatisch gelöscht.
Quellen und Lizenz
Python Tutor und Visualizer. Kostenloser Zugang bedeutet keine pauschale freie Lizenz für Website oder Kursinhalte. Der Beispielcode wurde für diese Anleitung geschrieben.
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.
js-parsons
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
js-parsons ist eine JavaScript-Bibliothek für Aufgaben, bei denen Codeblöcke geordnet werden.
Für Ubuntu 26.04 LTS (amd64). Die Demo läuft lokal im Browser. Python dient nur als HTTP-Server; das hier gewählte Beispiel prüft die Reihenfolge der Zeilen und führt kein Python-Programm aus.
Einrichtung
1. Paketlisten aktualisieren
Bereitet die Werkzeuginstallation vor.
sudo apt update
2. Werkzeuge installieren
Git lädt die Bibliothek; Python liefert die Demoseite lokal aus.
sudo apt install git python3
3. Quellen laden
Der Zielordner soll noch nicht existieren.
git clone https://github.com/js-parsons/js-parsons.git ~/js-parsons-lab
4. Projekt öffnen
Die mitgelieferten Abhängigkeiten bleiben im Unterordner lib.
cd ~/js-parsons-lab
5. Eigenes Beispiel schreiben
Legt eine zusätzliche Datei an und lässt die vorhandenen Beispiele unverändert.
cat > ubuntu-demo.html <<'EOF'
<!doctype html>
<html lang="de">
<meta charset="utf-8">
<title>Codezeilen ordnen</title>
<link rel="stylesheet" href="parsons.css">
<h1>Eine Summe berechnen</h1>
<p>Ordne die drei Zeilen: Werte anlegen, Summe bilden, Ergebnis ausgeben.</p>
<div id="vorrat" class="sortable-code"></div>
<div id="loesung" class="sortable-code"></div>
<p style="clear:both"><button id="pruefen">Prüfen</button></p>
<p id="meldung" role="status"></p>
<script src="lib/jquery.min.js"></script>
<script src="lib/jquery-ui.min.js"></script>
<script src="lib/jquery.ui.touch-punch.min.js"></script>
<script src="lib/underscore-min.js"></script>
<script src="lib/lis.js"></script>
<script src="parsons.js"></script>
<script>
const widget = new ParsonsWidget({
sortableId: 'loesung', trashId: 'vorrat', can_indent: false,
feedback_cb: feedback => {
document.getElementById('meldung').textContent = feedback.errors.length
? 'Die Reihenfolge stimmt noch nicht.' : 'Richtig geordnet.';
}
});
widget.init('werte = [4, 9, 2]\ngesamt = sum(werte)\nprint(gesamt)');
widget.shuffleLines();
document.getElementById('pruefen').addEventListener('click', () => widget.getFeedback());
</script>
</html>
EOF
6. Vorschau starten
Öffne http://127.0.0.1:8000/ubuntu-demo.html und verschiebe alle Zeilen vom Vorrat in die Lösung. Strg + C beendet den Server.
python3 -m http.server 8000 --bind 127.0.0.1
Installation prüfen
1. Falsche Reihenfolge prüfen
Klicke mit vertauschten Zeilen auf Prüfen. Es muss eine Rückmeldung über die falsche Reihenfolge erscheinen.
2. Richtige Reihenfolge prüfen
Ordne erst die Liste, dann die Summe, dann print an. Prüfen soll Richtig geordnet melden.
3. Quellstand dokumentieren
Zeigt den geladenen Commit für eine spätere Wiederholung der Einrichtung.
git rev-parse HEAD
Deinstallieren
1. Projekt entfernen
Beende zuerst den Server. Sichere eigene Aufgaben vor dem Löschen.
rm -rf -- ~/js-parsons-lab
2. Entfernung prüfen
Bestätigt das Entfernen des Projektordners.
test ! -e ~/js-parsons-lab && echo 'js-parsons entfernt'
Quellen und Lizenz
Offizielles Repository und Einbindung. Lizenz: MIT. Mitgelieferte Bibliotheken haben eigene Lizenzhinweise, die bei Weitergabe erhalten bleiben müssen.
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.
roadmap.sh
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
roadmap.sh stellt Lernpfade mit Themen und weiterführenden Materialien bereit.
Für Ubuntu 26.04 LTS (amd64). Die Anleitung beschreibt den Webzugang. Es wird kein lokales Ubuntu-Programm und kein eigener roadmap.sh-Server installiert.
Einrichtung
1. Lernpfade öffnen
Öffne roadmap.sh im Browser.
2. Thema auswählen
Wähle beispielsweise Linux, Python oder Frontend. Ein Lernpfad hilft bei der Reihenfolge, installiert aber keine Sprachwerkzeuge.
3. Themenknoten öffnen
Lies die Beschreibung und wähle bei Bedarf ein verlinktes Lernmaterial. Externe Inhalte können andere Zugangsbedingungen haben.
4. Fortschritt einrichten
Wenn du die Fortschrittsfunktionen des Dienstes nutzen möchtest, melde dich an und verwende die auf der gewählten Roadmap angebotenen Statusfunktionen. Lies die Bedingungen zusätzlicher Angebote, bevor du sie buchst.
Einrichtung prüfen
1. Fortschritt kontrollieren
Prüfe nach dem Neuladen, ob ein gesetzter Themenstatus bei deinem Zugang erhalten bleibt. Ohne Konto kannst du die Inhalte weiterhin zum Planen verwenden.
Entfernen
1. Abmelden
Melde dich gegebenenfalls ab und entferne bei Bedarf die Website-Daten im Browser. Gebuchte Leistungen und Kontolöschung werden separat in der Kontoverwaltung behandelt.
Es gibt keinen apt-Deinstallationsschritt, da für diesen Zugang kein lokales Paket eingerichtet wurde.
Quellen und Lizenz
Offizielle Roadmaps. Für Website, Inhalte und Zusatzangebote gelten die jeweiligen Rechte und Bedingungen. Ein frei erreichbarer Lernpfad ist keine pauschale MIT-Lizenz.
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.
project-based-learning
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Sammlung verlinkt Projektanleitungen zum selbstständigen Programmieren.
Für Ubuntu 26.04 LTS (amd64). Das Klonen legt eine lokale Kopie der Linkliste an. Die verlinkten Projekte werden dadurch weder heruntergeladen noch installiert.
Einrichtung
1. Paketlisten aktualisieren
Bereitet die Git-Installation vor.
sudo apt update
2. Git installieren
Wird für die lokale Sammlung benötigt.
sudo apt install git
3. Sammlung klonen
Verwende einen noch nicht vorhandenen Zielordner.
git clone https://github.com/practical-tutorials/project-based-learning.git ~/projektideen
4. Sammlung öffnen
Wechselt in die heruntergeladene Sammlung.
cd ~/projektideen
5. Übersicht lesen
Zeigt die README-Datei im Terminal. Beende less mit q; zum Öffnen der Links ist die GitHub-Ansicht im Browser meist bequemer.
less README.md
6. Projekt auswählen
Öffne einen passenden Link auf der ursprünglichen GitHub-Seite. Installiere anschließend nur die dort tatsächlich benötigten Werkzeuge nach ihrer eigenen Anleitung. Bewerte die Aktualität des Projekts, bevor du alte Installationsbefehle übernimmst.
Installation prüfen
1. Quellstand anzeigen
Bestätigt, dass die Sammlung als Git-Arbeitskopie vorliegt.
git log -1 --oneline
2. README prüfen
Die Ausgabe muss bestätigen, dass die Übersicht vorhanden ist.
test -s README.md && echo 'Projektübersicht vorhanden'
Aktualisieren
1. Sammlung aktualisieren
Holt neue Links, solange keine abweichenden lokalen Änderungen vorliegen.
git pull --ff-only
Deinstallieren
1. Sammlung entfernen
Sichere eigene Notizen vorher; der ganze Beispielordner wird gelöscht.
rm -rf -- ~/projektideen
2. Entfernung prüfen
Bestätigt die Entfernung.
test ! -e ~/projektideen && echo 'Sammlung entfernt'
Quellen und Lizenz
Offizielles Repository. Die Sammlung steht unter MIT. Die verlinkten Anleitungen, Videos und Quelltexte haben eigene Rechte; die Lizenz der Linkliste erstreckt sich nicht automatisch auf sie.
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.
build-your-own-x
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Sammlung verlinkt Projektanleitungen zum selbstständigen Programmieren.
Für Ubuntu 26.04 LTS (amd64). Das Klonen legt eine lokale Kopie der Linkliste an. Die verlinkten Projekte werden dadurch weder heruntergeladen noch installiert.
Einrichtung
1. Paketlisten aktualisieren
Bereitet die Git-Installation vor.
sudo apt update
2. Git installieren
Wird für die lokale Sammlung benötigt.
sudo apt install git
3. Sammlung klonen
Verwende einen noch nicht vorhandenen Zielordner.
git clone https://github.com/codecrafters-io/build-your-own-x.git ~/selbstbau-ideen
4. Sammlung öffnen
Wechselt in die heruntergeladene Sammlung.
cd ~/selbstbau-ideen
5. Übersicht lesen
Zeigt die README-Datei im Terminal. Beende less mit q; zum Öffnen der Links ist die GitHub-Ansicht im Browser meist bequemer.
less README.md
6. Projekt auswählen
Öffne einen passenden Link auf der ursprünglichen GitHub-Seite. Installiere anschließend nur die dort tatsächlich benötigten Werkzeuge nach ihrer eigenen Anleitung. Bewerte die Aktualität des Projekts, bevor du alte Installationsbefehle übernimmst.
Installation prüfen
1. Quellstand anzeigen
Bestätigt, dass die Sammlung als Git-Arbeitskopie vorliegt.
git log -1 --oneline
2. README prüfen
Die Ausgabe muss bestätigen, dass die Übersicht vorhanden ist.
test -s README.md && echo 'Projektübersicht vorhanden'
Aktualisieren
1. Sammlung aktualisieren
Holt neue Links, solange keine abweichenden lokalen Änderungen vorliegen.
git pull --ff-only
Deinstallieren
1. Sammlung entfernen
Sichere eigene Notizen vorher; der ganze Beispielordner wird gelöscht.
rm -rf -- ~/selbstbau-ideen
2. Entfernung prüfen
Bestätigt die Entfernung.
test ! -e ~/selbstbau-ideen && echo 'Sammlung entfernt'
Quellen und Lizenz
Offizielles Repository. Der aktuelle Repositorytext nennt einen Verzicht auf Urheber- und verwandte Rechte, keine MIT-Lizenz. Die verlinkten Anleitungen, Videos und Quelltexte haben eigene Rechte; die Lizenz der Linkliste erstreckt sich nicht automatisch auf sie.
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.
kurs-lernen.js
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
kurs-lernen.js ist ein eigener kleiner Lernkurs mit Ausgabevorhersage, Parsons-Aufgabe, Lernkarten und Lernpfad.
Für Ubuntu 26.04 LTS (amd64). Der Nachbau verwendet eigene Texte und Beispiele. Er übernimmt keine Kursinhalte oder Oberfläche eines Anbieters. Alle Funktionen laufen lokal; die Karten verwenden einen einfachen Wiederholungsplan und kein FSRS.
Einrichtung
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die lokalen Werkzeuge.
sudo apt update
2. Werkzeuge installieren
Python liefert die Dateien per HTTP aus; unzip entpackt das Beispiel. Node.js oder npm werden für die Nutzung nicht benötigt.
sudo apt install python3 unzip
3. Beispiel herunterladen
Speichere das Quellcodearchiv mit dem Browser unter ~/Downloads/kurs-lernen.zip. Der Ordner ~/kurs-lernen darf noch nicht existieren.
4. Beispiel entpacken
Legt HTML, CSS und kurs-lernen.js im Benutzerverzeichnis ab.
unzip ~/Downloads/kurs-lernen.zip -d ~
5. Projektordner öffnen
Von hier aus wird die lokale Vorschau gestartet.
cd ~/kurs-lernen
6. Lernkurs starten
Öffne http://127.0.0.1:8000 im Browser. Verwende immer dieselbe Adresse und denselben Port, damit derselbe lokale Lernstand geladen wird. Strg + C beendet den Server.
python3 -m http.server 8000 --bind 127.0.0.1
7. Ausgabe vorhersagen
Berechne die Ausgabe des angezeigten JavaScript-Beispiels und gib sie ein. Eine richtige Antwort schaltet die Parsons-Aufgabe frei. Die Seite führt dabei keinen beliebigen eingegebenen Programmcode aus.
8. Codezeilen ordnen
Verschiebe die fünf Zeilen über Nach oben und Nach unten. Eine richtige Reihenfolge schaltet die Karten frei. Die Bedienung funktioniert auch per Tastatur.
9. Karten wiederholen
Zeige zunächst die Antwort und bewerte dann ehrlich. Noch einmal setzt die Karte auf eine Minute später. Gewusst verwendet nacheinander 1, 3 und 7 Tage; die nächste Fälligkeit wird beim Neuladen geprüft.
Installation prüfen
1. Fehlerrückmeldungen prüfen
Gib eine falsche Vorhersage ein und prüfe eine falsche Zeilenfolge. In beiden Fällen muss eine Rückmeldung erscheinen, ohne den nächsten noch gesperrten Schritt freizuschalten.
2. Fortschritt prüfen
Löse die Aufgaben und bewerte die Karten. Lade die Seite neu: Freischaltungen, Reihenfolge und Fälligkeiten müssen erhalten bleiben. Wenn der Browser die Speicherung blockiert, weist die Seite darauf hin.
3. Zurücksetzen prüfen
Verwende Lernstand zurücksetzen und bestätige die Rückfrage. Danach muss der Lernpfad wieder am Anfang stehen.
Eigene Inhalte ergänzen
In kurs-lernen.js liegen die Fragen, der Erwartungswert der Vorhersage, die geordnete Codefolge und der Wiederholungsplan. Passe bei neuen Aufgaben auch die zugehörigen Prüfregeln an. Die aktuelle Version enthält nur einen kleinen Kurs und speichert ausschließlich im lokalen Browserspeicher. Sie bietet keinen Login, keine Synchronisierung und keinen allgemeinen Code-Ausführungsdienst. Vor dem Löschen der Website-Daten geht der Lernstand verloren; eine Exportfunktion ist nicht enthalten.
Deinstallieren
1. Lokalen Lernstand entfernen
Setze den Lernstand in der Oberfläche zurück oder entferne die Website-Daten für http://127.0.0.1:8000 im Browser. Auf derselben Adresse können auch andere lokale Beispiele gespeichert sein.
2. Projekt entfernen
Beende zuerst den HTTP-Server. Sichere eigene Änderungen vor dem Löschen.
rm -rf -- ~/kurs-lernen
3. Entfernung prüfen
Bestätigt, dass der Projektordner entfernt wurde.
test ! -e ~/kurs-lernen && echo 'Lernkurs entfernt'
Quellen und Lizenz
Eigener Beispielcode und eigene Lerninhalte für dieses Buch. Eine Weitergabelizenz für einen eigenen abgeleiteten Kurs legst du selbst fest. Es wurden keine Bibliotheken von Anki, Execute Program, js-parsons oder roadmap.sh eingebunden.
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.
Obsidian
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Obsidian ist ein Programm für Notizen und persönliches Wissensmanagement. Notizen sind gewöhnliche Markdown-Dateien in einem Ordner auf deinem Rechner, die sich über Links zu einem Netz verknüpfen lassen. Mit Canvas kommen frei anordenbare Pinnwände hinzu, die ebenfalls in einem offenen Textformat gespeichert werden.
Vorbemerkungen
- Kein apt-Paket: Obsidian ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung installiert es als Snap, das die Hersteller selbst veröffentlichen.
- Lizenz: Obsidian ist kostenlos, auch für die Arbeit, aber nicht quelloffen. Kostenpflichtig sind nur Zusatzdienste wie die Synchronisation zwischen Geräten (Obsidian Sync).
- Vault: Obsidian nennt einen Notizordner Vault (Tresor). Alles, was du schreibst, liegt als Datei in diesem Ordner. Das Programm ist nur die Oberfläche dafür.
- Formate im Mittelpunkt: Diese Anleitung legt zuerst ein Beispiel-Vault im Terminal an. So siehst du, wie die Dateien aussehen, bevor Obsidian sie darstellt.
Installation
1. Paketlisten aktualisieren
Damit apt im nächsten Schritt die aktuelle Version von snapd kennt.
sudo apt update
2. Snap-Unterstützung sicherstellen
snapd ist der Dienst, der Snaps installiert und aktualisiert. Unter Ubuntu ist er normalerweise schon vorhanden, dann meldet apt das nur.
sudo apt install snapd
3. Obsidian installieren
Installiert Obsidian als Snap. --classic ist nötig, damit Obsidian Vaults an jedem Ort öffnen und Links zu anderen Programmen öffnen kann.
sudo snap install obsidian --classic
Prüfen: Die Ausgabe zeigt Name, Version (z. B. 1.13.7) und als Herausgeber obsidianmd.
snap list obsidian
Beispiel-Vault anlegen: die Format-Ebene
4. Ordner für das Vault anlegen
Das Vault ist ein ganz normaler Ordner. Hier als Beispiel ~/Dokumente/Obsidian.
mkdir -p ~/Dokumente/Obsidian
5. In den Ordner wechseln
Die nächsten Dateien werden hier angelegt.
cd ~/Dokumente/Obsidian
6. Eine Notiz in Markdown anlegen
Legt die Notiz Projekt Garten.md an. Sie zeigt die wichtigsten Bausteine des Obsidian-Markdowns:
- Der Block zwischen den
----Zeilen am Anfang enthält Eigenschaften (Properties) im YAML-Format. Obsidian zeigt sie als Formular über der Notiz an. [[Pflanzenliste]]ist ein Wikilink auf eine andere Notiz. Der Dateiname wird ohne.mdangegeben.#gartenist ein Tag.> [!tip]leitet einen Hinweiskasten (Callout) ein.- [ ]ist eine Aufgabe mit Kontrollkästchen.
nano "Projekt Garten.md"
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
---
status: geplant
beginn: 2026-10-01
tags:
- garten
---
# Projekt Garten
Hochbeet im Herbst anlegen, Bepflanzung siehe [[Pflanzenliste]]. #garten
> [!tip] Tipp
> Erde erst nach dem ersten Regen auffüllen.
- [ ] Holz besorgen
- [x] Standort festlegen
7. Die verlinkte Notiz anlegen
Legt die Notiz an, auf die der Wikilink zeigt. Obsidian findet sie allein über den Dateinamen, egal in welchem Unterordner sie liegt.
nano Pflanzenliste.md
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# Pflanzenliste
- Salat
- Radieschen
- Kräuter
8. Ein Canvas anlegen
Ein Canvas ist eine Pinnwand mit Karten und Verbindungslinien. Obsidian speichert sie in Dateien mit der Endung .canvas im offenen Format JSON Canvas. Der Aufbau:
nodes– die Karten. Jede hat eine eindeutigeid, eine Position (x,y) und eine Größe (width,height) in Pixeln. Dertypelegt fest, was die Karte zeigt:text(eigener Markdown-Text),file(eine Notiz aus dem Vault),link(eine Webseite) odergroup(ein Rahmen um andere Karten).edges– die Verbindungslinien.fromNodeundtoNodeverweisen auf dieidder Karten,fromSideundtoSidelegen fest, an welcher Seite (top,right,bottom,left) die Linie ansetzt.
nano Gartenplanung.canvas
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
{
"nodes": [
{
"id": "idee",
"type": "text",
"text": "## Idee\nHochbeet mit Gemüse",
"x": 0, "y": 0, "width": 250, "height": 120
},
{
"id": "projekt",
"type": "file",
"file": "Projekt Garten.md",
"x": 400, "y": -60, "width": 400, "height": 300
}
],
"edges": [
{
"id": "idee-zu-projekt",
"fromNode": "idee", "fromSide": "right",
"toNode": "projekt", "toSide": "left",
"label": "wird zu"
}
]
}
Prüfen: Der Befehl meldet keinen Fehler, die Datei ist also gültiges JSON.
python3 -m json.tool Gartenplanung.canvas > /dev/null
Obsidian verwenden
9. Obsidian starten
Startet Obsidian. Alternativ findest du das Programm im Anwendungsmenü unter „Obsidian“.
obsidian &
10. Beispiel-Vault öffnen
Wähle im Startfenster Open folder as vault und dann den Ordner ~/Dokumente/Obsidian. Beim ersten Öffnen fragt Obsidian, ob du den Autoren des Vaults vertraust. Das betrifft Erweiterungen (Plugins). Weil das Vault von dir stammt, kannst du zustimmen.
Prüfen: Links in der Dateiliste stehen Gartenplanung, Pflanzenliste und Projekt Garten. Die Notiz „Projekt Garten“ zeigt oben die Eigenschaften status und beginn, darunter den Hinweiskasten und die Aufgaben. „Gartenplanung“ zeigt zwei Karten, die mit einem beschrifteten Pfeil verbunden sind.
11. Deutsche Oberfläche einstellen
Öffne die Einstellungen über das Zahnrad unten links (oder Strg+,). Wähle unter General bei Language den Eintrag Deutsch und klicke auf Relaunch, damit Obsidian neu startet.
12. Die wichtigsten Tastenkürzel kennenlernen
| Tasten | Wirkung |
|---|---|
| Strg+O | Notiz schnell öffnen (Schnellwechsler) |
| Strg+P | Befehlspalette: jeden Befehl über seinen Namen suchen |
| Strg+N | Neue Notiz |
| Strg+E | Zwischen Bearbeiten und Leseansicht wechseln |
| Strg+Umschalt+F | Im ganzen Vault suchen |
| Strg+G | Graph-Ansicht: alle Notizen und ihre Links als Netz |
[[ | Link auf eine Notiz einfügen (mit Vorschlagsliste) |
Was Obsidian im Vault ablegt
13. Einstellungsordner ansehen
Beim ersten Öffnen legt Obsidian im Vault den versteckten Ordner .obsidian an. Darin stehen die Einstellungen dieses Vaults als JSON-Dateien, z. B. Darstellung, Tastenkürzel und installierte Plugins. Deine Notizen enthält der Ordner nicht.
ls ~/Dokumente/Obsidian/.obsidian
Prüfen: Es werden Dateien wie app.json und workspace.json angezeigt.
Weil Notizen und Canvas-Dateien reine Textdateien sind, kannst du sie auch mit jedem Editor bearbeiten, mit Git versionieren oder mit anderen Programmen weiterverarbeiten. Obsidian bemerkt Änderungen von außen und zeigt sie sofort an.
Aktualisieren
Snaps aktualisieren sich automatisch im Hintergrund. Sofort aktualisieren kannst du mit:
sudo snap refresh obsidian
Deinstallieren
1. Obsidian entfernen
Entfernt das Snap. --purge verhindert, dass Snap vorher eine Sicherungskopie anlegt. Deine Notizen bleiben erhalten.
sudo snap remove --purge obsidian
2. Programmeinstellungen entfernen
Obsidian merkt sich in ~/.config/obsidian die Liste der geöffneten Vaults und die Fenstereinstellungen. Deine Notizen sind dort nicht enthalten.
rm -rf ~/.config/obsidian
Prüfen: Die Ausgabe meldet, dass kein Snap namens obsidian installiert ist.
snap list obsidian
3. Optional: Vault löschen
Achtung: Dieser Befehl löscht alle Notizen und Canvas-Dateien des Vaults endgültig. Nur ausführen, wenn du sie nicht mehr brauchst oder vorher gesichert hast.
rm -rf ~/Dokumente/Obsidian
Quellen und Lizenz
- Offizielle Dokumentation: https://obsidian.md/
- Lizenz: Obsidian steht unter der Freeware (proprietär für persönliche Nutzung) / Catalyst.
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.
Logseq
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Logseq ist ein Programm für Notizen und persönliches Wissensmanagement. Notizen werden als verschachtelte Stichpunkte (Blöcke) geschrieben und über Links und Tags miteinander verknüpft. Alle Inhalte liegen als gewöhnliche Markdown-Dateien in einem Ordner auf deinem Rechner, nicht in einer Cloud.
Vorbemerkungen
- Kein apt-Paket: Logseq ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung installiert es deshalb als Snap. Das Snap wird unter dem Herausgeber „Logseq, Inc.“ veröffentlicht.
- Zwei Versionen: Logseq teilt sich derzeit in zwei Linien auf:
- Logseq 0.10 – die stabile Version, die Notizen als Markdown-Dateien speichert. Diese Version installiert die Anleitung.
- Logseq 2.0 – eine neue Version, die Notizen in einer Datenbank speichert. Sie ist noch eine Beta-Version und nur als AppImage von der GitHub-Seite des Projekts erhältlich. Für wichtige Notizen ist sie noch nicht zu empfehlen.
- Graph: Logseq nennt einen Ordner mit Notizen einen Graph. Du kannst mehrere Graphen anlegen, z. B. einen privaten und einen beruflichen.
Installation
1. Paketlisten aktualisieren
Damit apt im nächsten Schritt die aktuelle Version von snapd kennt.
sudo apt update
2. Snap-Unterstützung sicherstellen
snapd ist der Dienst, der Snaps installiert und aktualisiert. Unter Ubuntu ist er normalerweise schon vorhanden. Dann meldet apt das nur.
sudo apt install snapd
3. Logseq installieren
Installiert Logseq als Snap. Das Snap läuft in einem abgeschotteten Bereich und darf nur auf dein Home-Verzeichnis (ohne versteckte Ordner) und auf Wechseldatenträger zugreifen. Für Notizen reicht das.
sudo snap install logseq
Prüfen: Die Ausgabe zeigt Name und Version, z. B. 0.10.15.
snap list logseq
Erste Schritte
4. Ordner für die Notizen anlegen
Logseq braucht einen Ordner, in dem es die Notizen ablegt. Er muss in deinem Home-Verzeichnis liegen und darf nicht mit einem Punkt beginnen, sonst hat das Snap keinen Zugriff. Hier als Beispiel ~/Dokumente/Logseq.
mkdir -p ~/Dokumente/Logseq
5. Logseq starten
Startet Logseq. Alternativ findest du das Programm im Anwendungsmenü unter „Logseq“.
logseq &
Prüfen: Es öffnet sich ein Fenster mit einer Begrüßung und der Schaltfläche Choose a folder.
6. Ordner als Graph auswählen
Klicke auf Choose a folder und wähle den Ordner ~/Dokumente/Logseq aus Schritt 4. Logseq richtet darin seine Unterordner ein und öffnet die Tagesseite für heute.
Prüfen: Im Ordner liegen jetzt die Unterordner journals (Tagesseiten), pages (eigene Seiten) und logseq (Einstellungen des Graphen).
ls ~/Dokumente/Logseq
Die Unterordner journals und pages erscheinen erst, sobald du den ersten Text geschrieben hast.
7. Deutsche Oberfläche einstellen
Die Oberfläche ist zunächst auf Englisch. Klicke oben rechts auf die drei Punkte … → Settings. Wähle im Reiter General bei Language den Eintrag Deutsch. Die Umstellung wirkt sofort.
8. Die Grundlagen kennenlernen
Jeder Absatz in Logseq ist ein Block. Blöcke lassen sich einrücken, verlinken und als Aufgabe markieren.
| Eingabe / Tasten | Wirkung |
|---|---|
| Enter | Neuen Block beginnen |
| Umschalt+Enter | Neue Zeile im selben Block |
| Tab / Umschalt+Tab | Block einrücken / ausrücken |
[[Seitenname]] | Link auf eine Seite; existiert sie nicht, wird sie angelegt |
#Tag | Schlagwort, ebenfalls ein Link auf eine gleichnamige Seite |
/ | Menü mit Befehlen öffnen, z. B. Datum, Aufgabe, Überschrift |
TODO am Blockanfang | Block wird zur Aufgabe mit Kontrollkästchen |
| Strg+Enter | Aufgabenstatus umschalten (TODO → DOING → DONE) |
| Strg+K | Suche über alle Seiten und Blöcke |
| G, dann J | Zu den Tagesseiten springen (außerhalb eines Blocks) |
Prüfen: Schreibe auf der Tagesseite Test mit [[Erste Seite]] und klicke dann auf den Link. Logseq öffnet die neue Seite „Erste Seite“ und zeigt unten unter Verlinkte Referenzen, dass die Tagesseite auf sie verweist.
Das Dateiformat
9. Eine Seite als Datei ansehen
Logseq speichert jede Seite als Markdown-Datei, aber in einer besonderen Form: Jeder Block ist ein Listenpunkt (- ), eingerückte Blöcke sind mit Tabulatoren eingerückt. Tagesseiten liegen in journals und heißen nach dem Datum (z. B. 2026_09_23.md), alle anderen Seiten liegen in pages. Dieser Befehl zeigt die Seite „Erste Seite“ aus Schritt 8:
cat ~/Dokumente/Logseq/pages/Erste\ Seite.md
Prüfen: Die Datei beginnt mit - . Hast du auf der Seite etwas geschrieben, steht jeder Block in einer eigenen Zeile mit - .
Weitere Bausteine des Formats:
| Schreibweise | Bedeutung |
|---|---|
- Text | Ein Block |
[[Seite]], #Tag | Links auf andere Seiten |
TODO Text, DONE Text | Aufgabe mit ihrem Status |
schluessel:: wert | Eigenschaft (Property). Steht sie in der ersten Zeile der Datei, gilt sie für die ganze Seite, sonst für den Block darüber. |
id:: 6512… | Kennung eines Blocks, die Logseq anlegt, sobald ein Block von anderswo verlinkt wird |
Die Einstellungen des Graphen stehen in logseq/config.edn, einer Textdatei im EDN-Format (einer Schreibweise aus der Programmiersprache Clojure). Weil alles aus Textdateien besteht, kannst du die Notizen auch mit einem Editor lesen oder mit Git versionieren. Beim Wechsel zu Obsidian lassen sich die Dateien meist direkt weiterverwenden. Nur die Listenpunkt-Struktur und die Schreibweise schluessel:: wert sind dort ungewohnt.
Optional: Notizen sichern
Weil Logseq alle Notizen als Markdown-Dateien speichert, reicht es, den Ordner ~/Dokumente/Logseq in deine normale Datensicherung aufzunehmen. Die Dateien lassen sich auch ohne Logseq mit jedem Texteditor öffnen, z. B. mit GNU nano.
Aktualisieren
Snaps aktualisieren sich automatisch im Hintergrund. Sofort aktualisieren kannst du mit:
sudo snap refresh logseq
Deinstallieren
1. Logseq entfernen
Entfernt das Snap. --purge verhindert, dass Snap vorher eine Sicherungskopie anlegt, und löscht auch die Programmeinstellungen, die das Snap unter ~/snap/logseq gespeichert hat. Deine Notizen in ~/Dokumente/Logseq bleiben erhalten.
sudo snap remove --purge logseq
Prüfen: Die Ausgabe meldet, dass kein Snap namens logseq installiert ist.
snap list logseq
2. Optional: Notizen löschen
Achtung: Dieser Befehl löscht alle Notizen des Graphen endgültig. Nur ausführen, wenn du sie nicht mehr brauchst oder vorher gesichert hast.
rm -rf ~/Dokumente/Logseq
Quellen und Lizenz
- Offizielle Dokumentation: https://logseq.com/
- Lizenz: Logseq steht unter der AGPL-3.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.
SiYuan
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
SiYuan ist ein Programm für Notizen und persönliches Wissensmanagement. Notizen bestehen aus Blöcken, die sich untereinander verlinken, einbetten und in Datenbank-Ansichten (Tabelle, Kanban, Kalender) auswerten lassen. Die Daten liegen lokal auf deinem Rechner.
Vorbemerkungen
- Kein apt-Paket und kein Snap: SiYuan ist weder in den Ubuntu-Paketquellen noch als Snap erhältlich. Die Entwickler veröffentlichen aber auf GitHub ein fertiges
.deb-Paket. Diese Anleitung installiert dieses Paket mitapt, damit die nötigen Abhängigkeiten automatisch mitinstalliert werden. - Version: Die Befehle verwenden die Version 3.8.5. Ist eine neuere Version erschienen, ersetzt du in den Befehlen die Versionsnummer. Die aktuelle Version steht auf der Seite https://github.com/siyuan-note/siyuan/releases/latest.
- Speicherplatz: Das installierte Programm belegt etwa 700 MB.
- Arbeitsbereich: SiYuan speichert alle Notizen in einem Ordner, dem Arbeitsbereich (standardmäßig
~/SiYuan). Die Notizen liegen dort in einem eigenen Format (.sy-Dateien), nicht als Markdown. Über das Menü lassen sie sich aber jederzeit als Markdown exportieren.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Abhängigkeiten kennt, die SiYuan braucht.
sudo apt update
2. In den Download-Ordner wechseln
Die Dateien der nächsten Schritte werden hier abgelegt.
cd ~/Downloads
3. Paket herunterladen
Lädt das .deb-Paket für 64-Bit-PCs (amd64) von der GitHub-Seite des Projekts herunter. Die Datei ist etwa 200 MB groß.
wget https://github.com/siyuan-note/siyuan/releases/download/v3.8.5/siyuan-3.8.5-linux.deb
4. Prüfsummen herunterladen
Die Datei enthält für jede Download-Datei eine Prüfsumme. Damit lässt sich feststellen, ob das Paket vollständig und unverändert angekommen ist.
wget https://github.com/siyuan-note/siyuan/releases/download/v3.8.5/SHA256SUMS.txt
5. Paket prüfen
Berechnet die Prüfsumme des heruntergeladenen Pakets und vergleicht sie mit der Liste. --ignore-missing überspringt die Einträge für Dateien, die du nicht heruntergeladen hast (z. B. für andere Systeme).
sha256sum --ignore-missing -c SHA256SUMS.txt
Prüfen: Die Ausgabe lautet siyuan-3.8.5-linux.deb: OK. Steht dort FEHLSCHLAG bzw. FAILED, lösche die Datei und lade sie erneut herunter.
6. SiYuan installieren
Installiert das Paket. Das ./ vor dem Dateinamen ist wichtig: Es sagt apt, dass es eine lokale Datei installieren soll und nicht nach einem Paket in den Paketquellen suchen. Fehlende Abhängigkeiten lädt apt automatisch aus den Ubuntu-Paketquellen nach. Das Paket richtet außerdem ein AppArmor-Profil ein, das SiYuan unter Ubuntu zum Starten braucht.
sudo apt install ./siyuan-3.8.5-linux.deb
Prüfen: Die Ausgabe zeigt Paketname und Version 3.8.5.
dpkg -l siyuan | tail -n 1
7. Heruntergeladene Dateien löschen
Nach der Installation werden die Dateien nicht mehr gebraucht.
rm siyuan-3.8.5-linux.deb SHA256SUMS.txt
Erste Schritte
8. SiYuan starten
Startet SiYuan. Alternativ findest du das Programm im Anwendungsmenü unter „SiYuan“.
siyuan &
9. Arbeitsbereich festlegen
Beim ersten Start fragt SiYuan, wo der Arbeitsbereich liegen soll. Der Vorschlag ~/SiYuan ist in Ordnung. Bestätige ihn.
Prüfen: SiYuan öffnet sich mit einem Notizbuch mit Einführungsdokumenten. Im Arbeitsbereich liegt jetzt unter anderem der Ordner data.
ls ~/SiYuan
10. Deutsche Oberfläche einstellen
Ist die Oberfläche nicht schon auf Deutsch, öffne die Einstellungen mit Alt+P oder über das Menü oben links. Wähle unter Appearance (Erscheinungsbild) bei Language (Sprache) den Eintrag Deutsch. SiYuan lädt die Oberfläche danach neu.
11. Die Grundlagen kennenlernen
Jeder Absatz, jede Überschrift und jeder Listenpunkt ist in SiYuan ein Block. Blöcke lassen sich über ihre Kennung verlinken und an anderer Stelle einbetten.
| Eingabe / Tasten | Wirkung |
|---|---|
/ | Menü mit Befehlen öffnen, z. B. Überschrift, Tabelle, Datenbank, Aufgabe |
(( | Auf einen anderen Block verweisen (Suche nach dem Block öffnet sich) |
[[ | Auf ein anderes Dokument verweisen |
#Tag# | Schlagwort vergeben |
{{ | Einen anderen Block einbetten (sein Inhalt wird hier angezeigt) |
| Strg+P | Suche über alle Notizen |
| Alt+5 | Tagesnotiz für heute öffnen |
| Alt+P | Einstellungen öffnen |
Prüfen: Lege über das + neben einem Notizbuch ein neues Dokument an, tippe [[ und wähle ein Einführungsdokument aus. Ein Klick auf den Link öffnet das Dokument.
Optional: Notizen sichern
SiYuan legt im Arbeitsbereich regelmäßig eigene Datensicherungen an (Einstellungen → Datenverlauf und Datenrepository). Zusätzlich solltest du den Ordner ~/SiYuan in deine normale Datensicherung aufnehmen. Sicherer ist es, SiYuan vorher zu beenden, damit keine Datei gerade geschrieben wird.
Aktualisieren
SiYuan zeigt beim Start einen Hinweis, wenn eine neue Version erschienen ist. Weil das Paket nicht aus einem Paketarchiv stammt, aktualisiert sudo apt upgrade SiYuan nicht. Zum Aktualisieren wiederholst du die Schritte 2 bis 7 mit der neuen Versionsnummer. Das neue Paket ersetzt das alte, deine Notizen im Arbeitsbereich bleiben erhalten.
Deinstallieren
1. SiYuan beenden
Schließe alle SiYuan-Fenster. SiYuan läuft eventuell noch im Hintergrund weiter (Symbol in der oberen Leiste). Beende es dort über das Symbol mit Beenden.
Prüfen: Die Ausgabe ist leer, es läuft kein SiYuan-Prozess mehr.
pgrep -ai siyuan
2. SiYuan entfernen
Entfernt das Programm unter /opt/SiYuan, den Befehl siyuan und das AppArmor-Profil.
sudo apt purge siyuan
3. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten, die nur für SiYuan installiert wurden.
sudo apt autoremove
4. Programmeinstellungen entfernen
SiYuan speichert seine Programmeinstellungen, die Liste der Arbeitsbereiche und ein Protokoll in ~/.config/siyuan sowie Daten der Programmoberfläche in ~/.config/SiYuan-Electron. Deine Notizen sind dort nicht enthalten.
rm -rf ~/.config/siyuan ~/.config/SiYuan-Electron
Prüfen: Der Befehl wird nicht mehr gefunden.
siyuan --version
5. Optional: Notizen löschen
Achtung: Dieser Befehl löscht den Arbeitsbereich mit allen Notizen und Sicherungen endgültig. Nur ausführen, wenn du sie nicht mehr brauchst oder vorher exportiert bzw. gesichert hast.
rm -rf ~/SiYuan
Quellen und Lizenz
- Offizielle Dokumentation: https://b3log.org/siyuan/
- Lizenz: SiYuan steht unter der AGPL-3.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.
SilverBullet
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
SilverBullet ist eine Notiz- und Wissensablage im Browser, die alle Seiten als Markdown-Dateien in einem Ordner speichert. Seiten werden mit [[Links]] verknüpft, und kleine Abfragen und Skripte machen daraus ein persönliches Wissenssystem. Diese Anleitung lässt SilverBullet als Dienst auf dem eigenen Rechner laufen, mit Anmeldung.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für SilverBullet. Das Projekt stellt den Server als einzelne Programmdatei bereit, die ohne weitere Abhängigkeiten läuft.
- Version: Getestet mit SilverBullet 2.11.1 unter Ubuntu 26.04.
- Datenordner und Spaces: SilverBullet 2 trennt zwei Ordner: Ein Datenordner enthält Einstellungen und Benutzerkonten. Die Notizen selbst liegen in einem Space, einem normalen Ordner mit Markdown-Dateien. Ein Server kann mehrere Spaces haben. Die Anleitung legt einen an.
- Port: SilverBullet läuft normalerweise auf Port 3000. Die Ports 3000 bis 3002 sind hier schon für Martin, Wiki.js und Outline vorgesehen. Die Anleitung verwendet deshalb Port 3003, nur vom eigenen Rechner aus erreichbar.
- Passwort:
AdminPasswort123ist ein Beispiel. Ersetze es durch ein eigenes Passwort.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. curl und unzip installieren
curl lädt das Programm herunter, unzip packt das Archiv aus.
sudo apt install curl unzip
3. Programm herunterladen
Lädt den Server für 64-Bit-PCs mit Intel- oder AMD-Prozessor (etwa 15 MB) in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://github.com/silverbulletmd/silverbullet/releases. Bei einer neueren Version ersetzt du die Nummer im Befehl.
curl -L -o /tmp/silverbullet.zip https://github.com/silverbulletmd/silverbullet/releases/download/2.11.1/silverbullet-server-linux-x86_64.zip
4. Archiv auspacken
Packt die Programmdatei silverbullet nach /tmp/silverbullet.
unzip -o /tmp/silverbullet.zip -d /tmp/silverbullet
5. Programm installieren
install kopiert die Datei nach /usr/local/bin, wo selbst installierte Programme hingehören, und macht sie mit -m 755 für alle ausführbar.
sudo install -m 755 /tmp/silverbullet/silverbullet /usr/local/bin/silverbullet
Prüfen: Die Versionsnummer erscheint, sie beginnt mit 2.11.1.
silverbullet version
Einrichten
6. Systembenutzer anlegen
SilverBullet soll unter einem eigenen Benutzer laufen, mit dem man sich nicht anmelden kann. --create-home legt den Ordner /var/lib/silverbullet an, in dem Einstellungen und Notizen liegen werden.
sudo useradd --system --create-home --home-dir /var/lib/silverbullet --shell /usr/sbin/nologin silverbullet
7. Datenordner, Administrator und ersten Space anlegen
Der Befehl setup erledigt die Ersteinrichtung ohne Browser. Er legt den Datenordner an, darin das Administratorkonto, und einen Space namens „Notizen“. sudo -u silverbullet sorgt dafür, dass alles dem Benutzer aus Schritt 6 gehört.
sudo -u silverbullet silverbullet setup --admin 'admin:AdminPasswort123' --space Notizen --space-folder /var/lib/silverbullet/notizen /var/lib/silverbullet/data
Was die Angaben bedeuten:
--admin 'admin:AdminPasswort123'– Benutzername und Passwort des Administrators, durch einen Doppelpunkt getrennt. SilverBullet speichert das Passwort nur verschlüsselt. Im Verlauf der Shell steht es aber im Klartext. Wer das nicht möchte, löscht die Zeile danach mithistory -dund der Zeilennummer aushistory.--space Notizen– der Name des ersten Space.--space-folder– der Ordner, in dem die Notizen dieses Space als Markdown-Dateien liegen. Ohne diese Angabe landen sie in einem Unterordner mit zufälligem Namen./var/lib/silverbullet/data– der Datenordner für Einstellungen und Benutzerkonten.
Prüfen: Die Ausgabe endet mit Setup complete: admin "admin" created und Space "Notizen" created at "/". Im Ordner der Notizen liegt eine erste Seite index.md.
sudo ls /var/lib/silverbullet/notizen
Alternativ kann man Schritt 7 weglassen. Dann startet SilverBullet beim ersten Aufruf im Browser einen Einrichtungsassistenten unter /.setup/, der dieselben Angaben abfragt.
Als Dienst einrichten
8. systemd-Dienst anlegen
Damit SilverBullet beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/silverbullet.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=SilverBullet
After=network.target
[Service]
Type=simple
User=silverbullet
Group=silverbullet
ExecStart=/usr/local/bin/silverbullet --hostname 127.0.0.1 --port 3003 /var/lib/silverbullet/data
Restart=on-failure
[Install]
WantedBy=multi-user.target
--hostname 127.0.0.1– SilverBullet ist nur vom eigenen Rechner aus erreichbar.--port 3003– der Port, unter dem SilverBullet läuft./var/lib/silverbullet/data– der Datenordner aus Schritt 7. Dort findet SilverBullet auch den Pfad zu den Notizen.
9. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
10. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet SilverBullet zusätzlich sofort.
sudo systemctl enable --now silverbullet
Prüfen: Im Protokoll steht multi-space mode: 1 space(s) configured und server running: http://localhost:3003. Die Zeile runtime Chrome detected erscheint nur, wenn Google Chrome installiert ist. SilverBullet kann damit einige Funktionen auch auf dem Server ausführen, braucht Chrome aber nicht.
sudo journalctl -u silverbullet -n 10
11. Aufruf prüfen
Prüft, ob SilverBullet antwortet und die Notizen ohne Anmeldung gesperrt sind.
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3003/.fs/index.md
Prüfen: Die Ausgabe lautet 401, also „nicht angemeldet“. Die Notizen sind geschützt.
Erste Schritte
12. Im Browser anmelden
Öffne http://localhost:3003 und melde dich mit admin und dem Passwort aus Schritt 7 an. Es erscheint die Seite index des Space „Notizen“.
13. Eine Notiz anlegen
Schreibe auf der Startseite einen Link wie [[Einkaufsliste]] und klicke darauf. SilverBullet legt die Seite an. Alles, was du tippst, wird automatisch gespeichert. Mit Strg+K springst du zu einer beliebigen Seite, mit Strg+/ öffnest du die Befehlsliste.
Prüfen: Die neue Notiz liegt als Markdown-Datei im Ordner des Space.
sudo ls /var/lib/silverbullet/notizen
Weitere Benutzer und Spaces verwaltest du als Administrator im Dashboard unter http://localhost:3003/.dashboard.
Aktualisieren
1. Neue Version herunterladen
Lädt die neueste Version. Ersetze die Versionsnummer durch die aktuelle von der Release-Seite.
curl -L -o /tmp/silverbullet.zip https://github.com/silverbulletmd/silverbullet/releases/download/2.11.1/silverbullet-server-linux-x86_64.zip
2. Archiv auspacken
Überschreibt die zuvor ausgepackte Datei.
unzip -o /tmp/silverbullet.zip -d /tmp/silverbullet
3. Programm ersetzen
Ersetzt die Programmdatei in /usr/local/bin. Einstellungen und Notizen bleiben unberührt.
sudo install -m 755 /tmp/silverbullet/silverbullet /usr/local/bin/silverbullet
4. Dienst neu starten
Der laufende Dienst verwendet sonst weiter die alte Version.
sudo systemctl restart silverbullet
Prüfen: silverbullet version zeigt die neue Versionsnummer.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet SilverBullet und verhindert den Start beim Hochfahren.
sudo systemctl disable --now silverbullet
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 8.
sudo rm /etc/systemd/system/silverbullet.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programm und heruntergeladene Dateien löschen
Entfernt die Programmdatei und die Dateien in /tmp.
sudo rm -rf /usr/local/bin/silverbullet /tmp/silverbullet /tmp/silverbullet.zip
5. Benutzer, Einstellungen und Notizen löschen
-r löscht mit dem Benutzer auch seinen Ordner /var/lib/silverbullet. Achtung: Alle Notizen gehen dabei verloren. Wer sie behalten will, kopiert vorher den Ordner /var/lib/silverbullet/notizen. Die Warnung Mail-Warteschlange … nicht gefunden ist harmlos.
sudo userdel -r silverbullet
Prüfen: Der Befehl silverbullet wird nicht mehr gefunden, und unter Port 3003 antwortet nichts mehr.
curl -sI http://localhost:3003/
Quellen und Lizenz
- Offizielle Dokumentation: https://silverbullet.md/
- Lizenz: SilverBullet steht unter der MIT.
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.
AppFlowy
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
AppFlowy ist eine freie Alternative zu Notion: ein Arbeitsbereich für Notizen, Dokumente, Tabellen, Kanban-Boards und Kalender in einem Programm. Die Daten liegen zunächst auf dem eigenen Rechner. Mit einem Konto bei AppFlowy Cloud oder einem eigenen AppFlowy-Server lassen sie sich zwischen Geräten abgleichen.
Teilweise getestet: Installation, Start und das Anlegen des Datenordners wurden unter Ubuntu 26.04 geprüft. Die ersten Schritte in der Oberfläche (ab Schritt 6) wurden nicht durchgeklickt.
Vorbemerkungen
- Installation als .deb-Paket: Ubuntu hat AppFlowy nicht in seinen Paketquellen. Das Projekt stellt aber ein
.deb-Paket bereit.aptinstalliert es wie ein normales Paket und holt die fehlende Abhängigkeitlibkeybinder-3.0-0automatisch nach. Außerdem gibt es AppFlowy als AppImage, als Flatpak und als Snap. - Version: Getestet mit AppFlowy 0.14.5.
- Keine Prüfsumme: Das Projekt veröffentlicht zu den Downloads keine Prüfsummen. Lade das Paket deshalb nur von der offiziellen GitHub-Seite.
- Cloud oder lokal: Beim ersten Start bietet AppFlowy die Anmeldung bei AppFlowy Cloud an (
beta.appflowy.cloud), z. B. per E-Mail, GitHub oder Google. Ohne Anmeldung bleiben alle Daten auf dem Rechner.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Abhängigkeiten kennt.
sudo apt update
2. In den Download-Ordner wechseln
Das Paket wird dort abgelegt und nach der Installation wieder gelöscht.
cd ~/Downloads
3. Paket herunterladen
Lädt AppFlowy 0.14.5 (etwa 140 MB). Die aktuelle Version steht auf https://github.com/AppFlowy-IO/AppFlowy/releases. Bei einer neueren Version ersetzt du die Nummer an allen drei Stellen im Befehl.
curl -L -o appflowy.deb https://github.com/AppFlowy-IO/AppFlowy/releases/download/0.14.5/AppFlowy-0.14.5-linux-x86_64.deb
4. AppFlowy installieren
Installiert das Paket. Das ./ vor dem Dateinamen ist wichtig: Es sagt apt, dass es eine Datei im aktuellen Ordner installieren soll und nicht nach einem Paket in den Paketquellen suchen. Das Programm landet in /usr/lib/AppFlowy, dazu kommt ein Eintrag im Anwendungsmenü.
sudo apt install ./appflowy.deb
Erscheint am Ende ein Hinweis, dass der Benutzer _apt nicht auf die Datei zugreifen konnte, ist das bei Paketen im Home-Ordner normal und harmlos.
Prüfen: Das Paket ist installiert.
dpkg -s appflowy | grep -E "^(Status|Version)"
5. Heruntergeladene Datei löschen
Das Paket wird nach der Installation nicht mehr gebraucht.
rm appflowy.deb
Erste Schritte (nicht getestet)
6. AppFlowy starten
Starte AppFlowy über das Anwendungsmenü (Suche nach „AppFlowy“) oder im Terminal:
/usr/lib/AppFlowy/AppFlowy
Beim ersten Start legt AppFlowy seinen Datenordner ~/.local/share/io.appflowy.appflowy an. Das hat der Test bestätigt.
7. Anmelden oder lokal arbeiten
Der Startbildschirm bietet die Anmeldung bei AppFlowy Cloud an. Mit einem Konto werden die Daten zwischen Geräten abgeglichen. Wer alles nur auf diesem Rechner behalten möchte, wählt die Möglichkeit, ohne Anmeldung fortzufahren. Wie sie heißt und wo sie steht, ändert sich zwischen den Versionen.
8. Erste Seite anlegen
Lege in der Seitenleiste mit + eine neue Seite an. AppFlowy fragt nach der Art:
- Document – ein Textdokument. Mit
/öffnest du ein Menü mit Überschriften, Listen, Tabellen, Bildern und mehr. - Grid – eine Tabelle, ähnlich einer einfachen Datenbank.
- Board – ein Kanban-Board mit Karten in Spalten.
- Calendar – ein Kalender, dessen Einträge ebenfalls Datensätze sind.
Die Oberfläche lässt sich in den Einstellungen unter Language auf Deutsch umstellen.
Wo liegt was?
/usr/lib/AppFlowy– das Programm.~/.local/share/io.appflowy.appflowy– Einstellungen und alle Daten, darunter die Datenbanken mit den Seiten.
Aktualisieren
1. Neue Version installieren
Lade das neue .deb-Paket wie in den Schritten 2 und 3 herunter und installiere es wie in Schritt 4. apt ersetzt dabei die alte Version, die Daten bleiben erhalten.
sudo apt install ./appflowy.deb
Deinstallieren
1. AppFlowy beenden
Schließe das Fenster von AppFlowy.
2. AppFlowy entfernen
Entfernt das Programm und den Menüeintrag.
sudo apt purge appflowy
3. Nicht mehr benötigte Pakete entfernen
Entfernt die Bibliothek libkeybinder-3.0-0, die nur für AppFlowy installiert wurde.
sudo apt autoremove
4. Daten löschen (optional)
Löscht alle Seiten und Einstellungen von AppFlowy. Achtung: Nicht mit der Cloud abgeglichene Daten gehen dabei unwiderruflich verloren.
rm -rf ~/.local/share/io.appflowy.appflowy
Prüfen: Das Paket ist nicht mehr installiert.
dpkg -s appflowy
Die Ausgabe meldet, dass das Paket nicht installiert ist.
Quellen und Lizenz
- Offizielle Dokumentation: https://appflowy.io/
- Lizenz: AppFlowy steht unter der AGPL-3.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.
Anytype
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Anytype ist eine Notiz- und Wissensanwendung, die nach dem Local-First-Prinzip arbeitet: Alle Daten liegen verschlüsselt auf dem eigenen Rechner. Abgleichen zwischen Geräten geht Ende-zu-Ende-verschlüsselt über ein Peer-to-Peer-Netz. Inhalte sind Objekte mit Typen wie Seite, Aufgabe oder Buch, die sich untereinander verknüpfen lassen.
Teilweise getestet: Installation samt AppArmor-Profil und der Start wurden unter Ubuntu 26.04 geprüft. Die Einrichtung in der Oberfläche (ab Schritt 6) wurde nicht durchgeklickt.
Vorbemerkungen
- Installation als .deb-Paket: Ubuntu hat Anytype nicht in seinen Paketquellen. Das Projekt stellt ein
.deb-Paket auf GitHub bereit, das keine zusätzlichen Pakete nachzieht. Es gibt Anytype auch als AppImage und als Flatpak. - Version: Getestet mit Anytype 0.57.0. Auf der Release-Seite erscheinen oft neuere Versionen mit dem Zusatz
-betaoder-alpha. Diese Anleitung verwendet die letzte Version ohne solchen Zusatz. - AppArmor: Anytype basiert auf Electron und braucht unter Ubuntu ein AppArmor-Profil. Das Paket legt es bei der Installation selbst an (
/etc/apparmor.d/anytype) und entfernt es beim Deinstallieren wieder. - Keine Prüfsumme: Das Projekt veröffentlicht zu den Downloads keine Prüfsummen. Lade das Paket deshalb nur von der offiziellen GitHub-Seite.
- Schlüssel: Anytype hat kein Passwort und kein klassisches Konto. Zugang zu den Daten gibt eine Schlüsselphrase aus mehreren Wörtern, die beim ersten Start erzeugt wird. Wer sie verliert und den Rechner verliert, kommt nicht mehr an seine Daten.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände kennt.
sudo apt update
2. In den Download-Ordner wechseln
Das Paket wird dort abgelegt und nach der Installation wieder gelöscht.
cd ~/Downloads
3. Paket herunterladen
Lädt Anytype 0.57.0 (etwa 230 MB). Die aktuelle Version steht auf https://github.com/anyproto/anytype-ts/releases. Bei einer neueren Version ersetzt du die Nummer an beiden Stellen im Befehl.
curl -L -o anytype.deb https://github.com/anyproto/anytype-ts/releases/download/v0.57.0/anytype_0.57.0_amd64.deb
4. Anytype installieren
Installiert das Paket. Das ./ vor dem Dateinamen sagt apt, dass es eine Datei im aktuellen Ordner installieren soll. Das Programm landet in /opt/Anytype, der Befehl anytype in /usr/bin, dazu kommen ein Eintrag im Anwendungsmenü und das AppArmor-Profil.
sudo apt install ./anytype.deb
Erscheint am Ende ein Hinweis, dass der Benutzer _apt nicht auf die Datei zugreifen konnte, ist das bei Paketen im Home-Ordner normal und harmlos.
Prüfen: Das AppArmor-Profil ist geladen.
sudo aa-status | grep anytype
5. Heruntergeladene Datei löschen
Das Paket wird nach der Installation nicht mehr gebraucht.
rm anytype.deb
Erste Schritte (nicht getestet)
6. Anytype starten
Starte Anytype über das Anwendungsmenü (Suche nach „Anytype“) oder im Terminal:
anytype
Beim ersten Start legt Anytype seinen Datenordner ~/.config/anytype an. Das hat der Test bestätigt.
7. Tresor anlegen und Schlüssel sichern
Wähle beim ersten Start, dass du einen neuen Tresor (Vault) anlegen willst. Anytype zeigt dann die Schlüsselphrase an. Schreibe sie auf oder speichere sie in einem Passwortmanager. Mit ihr meldest du dich auf weiteren Geräten an oder stellst die Daten wieder her.
8. Erstes Objekt anlegen
Lege mit + ein neues Objekt an und wähle einen Typ, z. B. Page für eine Textseite oder Task für eine Aufgabe. Mit / öffnest du im Text ein Menü für Überschriften, Listen, Tabellen und Verknüpfungen zu anderen Objekten. Die Oberfläche lässt sich in den Einstellungen auf Deutsch umstellen.
9. Abgleich über das Netz (optional)
Standardmäßig gleicht Anytype die verschlüsselten Daten über das Netz des Herstellers ab, damit sie auf weiteren Geräten erscheinen. Wer das nicht möchte, kann in den Einstellungen einen Modus nur für das lokale Netz wählen oder einen eigenen Server angeben. Die Daten sind in jedem Fall so verschlüsselt, dass der Betreiber des Netzes sie nicht lesen kann.
Wo liegt was?
/opt/Anytype– das Programm.~/.config/anytype– Einstellungen und alle Daten, verschlüsselt./etc/apparmor.d/anytype– das AppArmor-Profil.
Aktualisieren
1. Neue Version installieren
Lade das neue .deb-Paket wie in den Schritten 2 und 3 herunter und installiere es wie in Schritt 4. apt ersetzt dabei die alte Version, die Daten bleiben erhalten. Anytype meldet neue Versionen auch selbst.
sudo apt install ./anytype.deb
Deinstallieren
1. Anytype beenden
Schließe das Fenster von Anytype.
2. Anytype entfernen
Entfernt das Programm, den Menüeintrag, den Befehl anytype und das AppArmor-Profil.
sudo apt purge anytype
3. Daten löschen (optional)
Löscht alle Objekte und Einstellungen auf diesem Rechner. Achtung: Ohne Schlüsselphrase und ohne Abgleich über das Netz sind die Daten danach unwiderruflich verloren.
rm -rf ~/.config/anytype
Prüfen: Das AppArmor-Profil ist nicht mehr geladen, die Ausgabe ist leer.
sudo aa-status | grep anytype
Quellen und Lizenz
- Offizielle Dokumentation: https://anytype.io/
- Lizenz: Anytype steht unter der Any Source Available License.
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.
Foam
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Foam ist eine Erweiterung für Visual Studio Code, die aus einem Ordner mit Markdown-Dateien ein persönliches Wissensnetz macht. Notizen werden mit [[Wiki-Links]] verknüpft, Foam zeigt Rückverweise und einen Graphen der Verbindungen. Weil alles normale Dateien in einem Git-Repository sind, lassen sich die Notizen mit jedem Editor lesen und mit Git sichern.
Teilweise getestet: Installation der Erweiterung über die Befehlszeile und das Anlegen des Notizordners aus der Vorlage wurden unter Ubuntu 26.04 geprüft. Die Arbeit in der Oberfläche von VS Code (ab Schritt 8) wurde nicht durchgeklickt.
Vorbemerkungen
- Voraussetzungen: Visual Studio Code und Git sind installiert.
- Installation über VS Code: Foam ist kein eigenes Programm, sondern eine Erweiterung aus dem Marketplace von VS Code. Sie lässt sich mit dem Befehl
codeinstallieren. - Version: Getestet mit Foam 0.44.6 und VS Code 1.138. Foam 0.44 braucht mindestens VS Code 1.110.
- Vorlage: Das Projekt stellt eine Vorlage für den Notizordner bereit (
foam-template), mit Einstellungen und einigen Einführungsseiten. Die Anleitung übernimmt sie, trennt sie aber vom Git-Repository des Projekts. Die Vorlage enthält die Einstellunggit.postCommitCommand: sync: VS Code schiebt damit nach jedem Commit automatisch zum eingetragenen Server. Mit einem eigenen Repository ohne Server passiert dabei nichts.
Installation
1. Foam installieren
Lädt die Erweiterung aus dem Marketplace und installiert sie in VS Code.
code --install-extension foam.foam-vscode
Prüfen: Die Ausgabe lautet Extension 'foam.foam-vscode' v0.44.6 was successfully installed. (oder eine neuere Versionsnummer). Die Erweiterung erscheint in der Liste:
code --list-extensions --show-versions | grep foam
2. Vorlage für den Notizordner herunterladen
Lädt die Vorlage in den Ordner ~/notizen. --depth 1 lässt die Versionsgeschichte der Vorlage weg.
git clone --depth 1 https://github.com/foambubble/foam-template.git ~/notizen
3. In den Notizordner wechseln
Die folgenden Befehle arbeiten in diesem Ordner.
cd ~/notizen
4. Verbindung zur Vorlage lösen
Der Ordner .git gehört noch zum Repository des Foam-Projekts. Dieser Befehl löscht ihn. Die Dateien der Vorlage bleiben erhalten.
rm -rf .git
5. Eigenes Git-Repository anlegen
Macht den Ordner zu einem neuen, eigenen Git-Repository. So lassen sich Änderungen an den Notizen nachverfolgen und sichern.
git init -b main
6. Vorlage als ersten Stand speichern
git add . merkt alle Dateien vor, git commit speichert sie als ersten Stand.
git add .
git commit -m "Notizen aus foam-template angelegt"
Prüfen: Der Ordner enthält unter anderem getting-started.md, inbox.md und die Ordner .foam und .vscode.
ls -A
7. Empfohlene Zusatz-Erweiterungen ansehen (optional)
Die Vorlage empfiehlt in .vscode/extensions.json weitere Erweiterungen, z. B. yzhang.markdown-all-in-one für Inhaltsverzeichnisse und Listen. VS Code bietet sie beim Öffnen des Ordners zur Installation an. Für Foam selbst sind sie nicht nötig.
cat .vscode/extensions.json
Erste Schritte (nicht getestet)
8. Notizordner in VS Code öffnen
Öffnet den Ordner als Arbeitsbereich. Die Einstellungen der Vorlage in .vscode/settings.json gelten dann automatisch. Fragt VS Code, ob du den Autoren des Ordners vertraust, bestätige das, sonst bleiben Erweiterungen abgeschaltet.
code ~/notizen
9. Notizen verknüpfen
Öffne inbox.md und schreibe [[ gefolgt von einem Namen, z. B. [[Kaffeerösterei]]. Foam schlägt vorhandene Notizen vor. Ein Link auf eine Notiz, die es noch nicht gibt, lässt sich mit Strg+Klick anlegen.
10. Tagesnotiz öffnen
Alt+D öffnet die Notiz für den heutigen Tag, bei Bedarf legt Foam sie neu an. Sie eignet sich als Tagebuch oder Eingangskorb.
11. Graph anzeigen
Öffne mit Strg+Umschalt+P die Befehlspalette und wähle Foam: Show Graph. Foam zeigt alle Notizen als Punkte und ihre Links als Linien. Weitere Befehle beginnen ebenfalls mit Foam:, z. B. Foam: Create New Note. Foam hat in der Seitenleiste von VS Code eigene Bereiche. Connections zeigt, welche Notizen auf die aktuelle verweisen und wohin sie selbst verweist. Orphans listet Notizen ohne Verbindung, Placeholders Links auf Notizen, die es noch nicht gibt.
12. Änderungen sichern
Speichere geänderte Notizen im Terminal als neuen Stand. Das geht auch in VS Code über die Ansicht Quellcodeverwaltung (Strg+Umschalt+G).
git add .
git commit -m "Neue Notizen"
Aktualisieren
VS Code aktualisiert Erweiterungen normalerweise von selbst. Von Hand geht es so:
code --install-extension foam.foam-vscode --force
Deinstallieren
1. Foam entfernen
Entfernt die Erweiterung aus VS Code. Den Ordner der Erweiterung räumt VS Code beim nächsten Start selbst auf.
code --uninstall-extension foam.foam-vscode
Prüfen: Die Ausgabe ist leer.
code --list-extensions | grep foam
2. Notizen löschen (optional)
Löscht den Notizordner samt Git-Repository. Achtung: Alle Notizen gehen dabei verloren. Die Markdown-Dateien lassen sich aber auch ohne Foam weiter mit jedem Editor nutzen.
rm -rf ~/notizen
Quellen und Lizenz
- Offizielle Dokumentation: https://foambubble.github.io/foam/
- Lizenz: Foam steht unter der MIT.
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.
AFFiNE
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
AFFiNE verbindet Dokumente, Whiteboard und Datenbanktabellen in einem Programm. Jede Seite lässt sich als Text schreiben oder als unendliche Zeichenfläche („Edgeless“) mit Notizzetteln, Formen und Verbindungen bearbeiten. Die Desktop-Version arbeitet lokal: Ohne Anmeldung liegen alle Daten auf dem eigenen Rechner.
Teilweise getestet: Prüfsumme, Installation, Start und das Anlegen des lokalen Arbeitsbereichs wurden unter Ubuntu 26.04 geprüft. Die Arbeit in der Oberfläche (ab Schritt 7) wurde nicht durchgeklickt.
Vorbemerkungen
- Installation als .deb-Paket: Ubuntu hat AFFiNE nicht in seinen Paketquellen. Das Projekt stellt ein
.deb-Paket auf GitHub bereit, das keine zusätzlichen Pakete nachzieht. Es gibt AFFiNE auch als AppImage und als Flatpak. - Version: Getestet mit AFFiNE 0.27.4. Auf der Release-Seite erscheinen fast täglich Versionen mit dem Zusatz
canary. Das sind Vorabversionen zum Testen. Diese Anleitung verwendet die als „Latest“ markierte stabile Version. - Keine AppArmor-Einrichtung nötig: Anders als bei manchen anderen Electron-Programmen bringt das Paket eine Sandbox-Hilfe mit Sonderrechten mit (
chrome-sandboxmit SUID-Bit). Ein eigenes AppArmor-Profil braucht es deshalb nicht. - Lokal oder Cloud: Ohne Anmeldung legt AFFiNE einen lokalen Arbeitsbereich an. Mit einem Konto bei AFFiNE Cloud oder auf einem eigenen AFFiNE-Server lassen sich Arbeitsbereiche zusätzlich abgleichen und teilen. Ein eigener Server ist ohne Docker aufwendig und nicht Teil dieser Anleitung.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände kennt.
sudo apt update
2. In den Download-Ordner wechseln
Das Paket wird dort abgelegt und nach der Installation wieder gelöscht.
cd ~/Downloads
3. Paket herunterladen
Lädt AFFiNE 0.27.4 (etwa 165 MB). Die aktuelle stabile Version steht auf https://github.com/toeverything/AFFiNE/releases/latest. Bei einer neueren Version ersetzt du die Nummer an allen drei Stellen im Befehl.
curl -L -o affine.deb https://github.com/toeverything/AFFiNE/releases/download/v0.27.4/affine-0.27.4-stable-linux-x64.deb
4. Prüfsumme kontrollieren
Das Projekt veröffentlicht die Prüfsummen in der Datei latest-linux.yml, im Format SHA-512, geschrieben in Base64. Der erste Befehl zeigt die veröffentlichte Prüfsumme für das .deb-Paket, der zweite berechnet sie für die heruntergeladene Datei im selben Format.
curl -sL https://github.com/toeverything/AFFiNE/releases/download/v0.27.4/latest-linux.yml | grep -A1 "linux-x64.deb"
openssl dgst -sha512 -binary affine.deb | base64 -w0; echo
Prüfen: Die Zeichenfolge hinter sha512: stimmt mit der zweiten Ausgabe überein. Bei Version 0.27.4 beginnen beide mit kSc2O7cLAXYmUuV/.
5. AFFiNE installieren
Installiert das Paket. Das ./ vor dem Dateinamen sagt apt, dass es eine Datei im aktuellen Ordner installieren soll. Das Programm landet in /usr/lib/affine, der Befehl affine in /usr/bin, dazu kommt ein Eintrag im Anwendungsmenü.
sudo apt install ./affine.deb
Erscheint am Ende ein Hinweis, dass der Benutzer _apt nicht auf die Datei zugreifen konnte, ist das bei Paketen im Home-Ordner normal und harmlos.
Prüfen: Das Paket ist installiert.
dpkg -s affine | grep -E "^(Status|Version)"
6. Heruntergeladene Datei löschen
Das Paket wird nach der Installation nicht mehr gebraucht.
rm affine.deb
Erste Schritte (nicht getestet)
7. AFFiNE starten
Starte AFFiNE über das Anwendungsmenü (Suche nach „AFFiNE“) oder im Terminal:
affine
Beim ersten Start legt AFFiNE seinen Datenordner ~/.config/AFFiNE und darin einen lokalen Arbeitsbereich an. Das hat der Test bestätigt.
8. Seite schreiben
Lege mit New Page eine neue Seite an und schreibe los. Mit / öffnest du ein Menü mit Überschriften, Listen, Tabellen, Code-Blöcken und Verknüpfungen zu anderen Seiten.
9. Auf das Whiteboard wechseln
Oben auf der Seite schaltest du zwischen Page (Dokument) und Edgeless (Whiteboard) um. Im Whiteboard erscheinen die Textblöcke der Seite als Notizen, dazu kommen Formen, Pfeile, freies Zeichnen und Verbindungen. Beide Ansichten zeigen denselben Inhalt.
10. Sprache umstellen
Die Oberfläche lässt sich in den Einstellungen auf Deutsch umstellen.
Wo liegt was?
/usr/lib/affine– das Programm.~/.config/AFFiNE– Einstellungen.~/.config/AFFiNE/workspaces/local– die lokalen Arbeitsbereiche, je einer pro Unterordner mit einer SQLite-Datenbankstorage.db.
Aktualisieren
1. Neue Version installieren
Lade das neue .deb-Paket wie in den Schritten 2 bis 4 herunter, prüfe es und installiere es wie in Schritt 5. apt ersetzt dabei die alte Version, die Daten bleiben erhalten.
sudo apt install ./affine.deb
Deinstallieren
1. AFFiNE beenden
Schließe das Fenster von AFFiNE.
2. AFFiNE entfernen
Entfernt das Programm, den Befehl affine und den Menüeintrag.
sudo apt purge affine
3. Daten löschen (optional)
Löscht Einstellungen und alle lokalen Arbeitsbereiche. Achtung: Nicht abgeglichene Seiten gehen dabei unwiderruflich verloren.
rm -rf ~/.config/AFFiNE
Prüfen: Das Paket ist nicht mehr installiert.
dpkg -s affine
Die Ausgabe meldet, dass das Paket nicht installiert ist.
Quellen und Lizenz
- Offizielle Dokumentation: https://affine.pro/
- Lizenz: AFFiNE steht unter der MPL-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.
TiddlyWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mit TiddlyWiki sammelst du Wissen in vielen kleinen Karteikarten, den „Tiddlern“, statt in langen Dokumenten. Jede Karte lässt sich mit anderen verlinken, mit Schlagwörtern versehen und in Übersichten einbinden. Diese Anleitung lässt TiddlyWiki als Dienst auf dem eigenen Rechner laufen, mit Anmeldung. Jede Notiz wird dabei als eigene Textdatei gespeichert.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für TiddlyWiki. Das Projekt veröffentlicht die Server-Version über npm, den Paketmanager von Node.js. Node.js und npm selbst kommen aus apt.
- Version: Getestet mit TiddlyWiki 5.4.1 und Node.js 22 aus Ubuntu 26.04.
- Zwei Arten, TiddlyWiki zu nutzen: TiddlyWiki gibt es auch als einzelne HTML-Datei, die man im Browser öffnet. Beim Speichern lädt der Browser dann aber jedes Mal eine neue Datei herunter. Die Server-Version aus dieser Anleitung speichert jede Änderung sofort auf dem Rechner. Eine einzelne HTML-Datei lässt sich trotzdem jederzeit erzeugen, siehe Schritt 15.
- Port: Die Ports 3000 bis 3003 sind im Buch schon vergeben (z. B. für SilverBullet). TiddlyWiki läuft deshalb auf Port 3004, nur vom eigenen Rechner aus erreichbar.
- Passwort:
AdminPasswort123ist ein Beispiel. Ersetze es durch ein eigenes Passwort.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt TiddlyWiki aus, npm lädt es herunter. Sind beide schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer beginnt mit v22.
/usr/bin/node --version
3. TiddlyWiki installieren
-g installiert TiddlyWiki für alle Benutzer. Das npm von Ubuntu legt das Programm dabei nach /usr/local/bin/tiddlywiki. Mit @5.4.1 bekommst du genau die getestete Version. Ohne diese Angabe installiert npm die neueste.
sudo npm install -g tiddlywiki@5.4.1
Prüfen: Die Ausgabe lautet 5.4.1.
tiddlywiki --version
Einrichten
4. Systembenutzer anlegen
TiddlyWiki soll unter einem eigenen Benutzer laufen, mit dem man sich nicht anmelden kann. --create-home legt den Ordner /var/lib/tiddlywiki an, in dem das Wiki liegen wird.
sudo useradd --system --create-home --home-dir /var/lib/tiddlywiki --shell /usr/sbin/nologin tiddlywiki
5. Wiki-Ordner anlegen
--init server legt den Ordner /var/lib/tiddlywiki/wiki mit der Vorlage für den Serverbetrieb an. sudo -u tiddlywiki sorgt dafür, dass der Ordner dem Benutzer aus Schritt 4 gehört.
sudo -u tiddlywiki tiddlywiki /var/lib/tiddlywiki/wiki --init server
Prüfen: Die Ausgabe lautet Copied edition 'server' to /var/lib/tiddlywiki/wiki. Im Ordner liegt die Datei tiddlywiki.info, die Einstellungsdatei des Wikis.
sudo ls /var/lib/tiddlywiki/wiki
6. Deutsches Sprachpaket einschalten
TiddlyWiki bringt Übersetzungen mit, lädt aber nur die Sprachen, die in tiddlywiki.info stehen. Öffne die Datei als Benutzer tiddlywiki:
sudo -u tiddlywiki nano /var/lib/tiddlywiki/wiki/tiddlywiki.info
Gehe an das Ende der zweiten Zeile ("description": "Basic client-server edition",), drücke Enter und füge diese Zeile ein:
"languages": ["de-DE"],
Der Anfang der Datei sieht danach so aus:
{
"description": "Basic client-server edition",
"languages": ["de-DE"],
"plugins": [
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Das Komma am Ende der neuen Zeile ist wichtig, sonst startet TiddlyWiki nicht.
7. Datei mit Benutzerkonten anlegen
TiddlyWiki liest Benutzernamen und Passwörter aus einer einfachen CSV-Datei. Sie liegt außerhalb des Wiki-Ordners, damit sie nie im Wiki selbst auftaucht.
sudo -u tiddlywiki nano /var/lib/tiddlywiki/benutzer.csv
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
username,password
admin,AdminPasswort123
Die erste Zeile ist die Kopfzeile und muss genau so lauten. Jede weitere Zeile ist ein Benutzerkonto. Das Passwort steht hier im Klartext, deshalb schützt der nächste Schritt die Datei.
8. Datei mit den Passwörtern schützen
600 bedeutet: Nur der Besitzer, also der Benutzer tiddlywiki, darf die Datei lesen und ändern.
sudo chmod 600 /var/lib/tiddlywiki/benutzer.csv
Als Dienst einrichten
9. systemd-Dienst anlegen
Damit TiddlyWiki beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/tiddlywiki.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=TiddlyWiki
After=network.target
[Service]
Type=simple
User=tiddlywiki
Group=tiddlywiki
ExecStart=/usr/local/bin/tiddlywiki /var/lib/tiddlywiki/wiki --listen host=127.0.0.1 port=3004 credentials=/var/lib/tiddlywiki/benutzer.csv readers=(authenticated) writers=(authenticated)
Restart=on-failure
[Install]
WantedBy=multi-user.target
Was die Angaben hinter --listen bedeuten:
host=127.0.0.1– TiddlyWiki ist nur vom eigenen Rechner aus erreichbar.port=3004– der Port, unter dem TiddlyWiki läuft.credentials=…– die Datei mit den Benutzerkonten aus Schritt 7.readers=(authenticated)undwriters=(authenticated)– nur angemeldete Benutzer dürfen lesen und schreiben. Ohne diese Angaben wäre das Wiki für jeden offen, der den Port erreicht.
10. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
11. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet TiddlyWiki zusätzlich sofort.
sudo systemctl enable --now tiddlywiki
Prüfen: Im Protokoll steht Serving on http://127.0.0.1:3004.
sudo journalctl -u tiddlywiki -n 10
12. Aufruf prüfen
Prüft, ob TiddlyWiki antwortet und ohne Anmeldung gesperrt ist.
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3004/
Prüfen: Die Ausgabe lautet 401, also „nicht angemeldet“. Das Wiki ist geschützt.
Erste Schritte
13. Im Browser anmelden und Deutsch auswählen
Öffne http://localhost:3004 und melde dich mit admin und dem Passwort aus Schritt 7 an. Die Oberfläche ist zunächst englisch. Klicke rechts auf das Zahnrad (Control Panel). Im Reiter Info, Unterreiter Basics, steht ganz oben „Hello! Current language:“. Wähle dort Deutsch (Deutschland).
Prüfen: Die Oberfläche wechselt sofort auf Deutsch. Die Einstellung wird im Wiki gespeichert und gilt ab jetzt für alle Benutzer.
14. Einen Tiddler anlegen
Klicke rechts auf das Plus-Zeichen (Erstelle einen neuen Tiddler). Gib einen Titel ein, z. B. Einkaufsliste, schreibe einen Text und klicke auf das Häkchen (Fertig). Links zu anderen Tiddlern schreibst du als [[Titel]]. Existiert der Tiddler noch nicht, legt ein Klick auf den Link ihn an.
Prüfen: Der neue Tiddler liegt als eigene Datei mit der Endung .tid im Unterordner tiddlers.
sudo ls /var/lib/tiddlywiki/wiki/tiddlers
15. Das Wiki als einzelne HTML-Datei sichern
--build index erzeugt aus allen Tiddlern eine einzige HTML-Datei, die ohne Server in jedem Browser läuft. So lässt sich das Wiki einfach weitergeben oder sichern.
sudo -u tiddlywiki tiddlywiki /var/lib/tiddlywiki/wiki --build index
Prüfen: Im Ordner output liegt die Datei index.html (etwa 3 MB).
sudo ls -l /var/lib/tiddlywiki/wiki/output
Weitere Benutzer trägst du als neue Zeilen in /var/lib/tiddlywiki/benutzer.csv ein und startest danach den Dienst neu (sudo systemctl restart tiddlywiki).
Aktualisieren
1. Neue Version installieren
Installiert die neueste Version von TiddlyWiki. Das Wiki und die Benutzerkonten bleiben unberührt.
sudo npm install -g tiddlywiki@latest
2. Dienst neu starten
Der laufende Dienst verwendet sonst weiter die alte Version.
sudo systemctl restart tiddlywiki
Prüfen: tiddlywiki --version zeigt die neue Versionsnummer.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet TiddlyWiki und verhindert den Start beim Hochfahren.
sudo systemctl disable --now tiddlywiki
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 9.
sudo rm /etc/systemd/system/tiddlywiki.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programm entfernen
Entfernt TiddlyWiki aus /usr/local. Node.js und npm bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo npm uninstall -g tiddlywiki
5. Benutzer, Wiki und Benutzerkonten löschen
-r löscht mit dem Benutzer auch seinen Ordner /var/lib/tiddlywiki. Achtung: Alle Tiddler gehen dabei verloren. Wer sie behalten will, sichert vorher die Datei aus Schritt 15 oder den Ordner /var/lib/tiddlywiki/wiki. Die Warnung Mail-Warteschlange … nicht gefunden ist harmlos.
sudo userdel -r tiddlywiki
Prüfen: Der Befehl tiddlywiki wird nicht mehr gefunden, und unter Port 3004 antwortet nichts mehr.
curl -sI http://localhost:3004/
Quellen und Lizenz
- Offizielle Dokumentation: https://tiddlywiki.com/
- Lizenz: TiddlyWiki steht unter der BSD-3-Clause.
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.
Zettlr
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zettlr ist ein Markdown-Editor für längere Texte und Wissenssammlungen nach dem Zettelkasten-Prinzip: Notizen sind einfache Markdown-Dateien in einem Ordner, die über Links und Schlagwörter miteinander verbunden werden. Mit eingebauter Literaturverwaltung und Export nach PDF oder Word ist Zettlr besonders für wissenschaftliches Schreiben gedacht.
Vorbemerkungen
- Kein apt-Paket, kein Snap: Zettlr ist nicht in den Ubuntu-Paketquellen enthalten. Das Projekt veröffentlicht eine
.deb-Datei auf GitHub. Sie wird mitaptinstalliert, so kümmert sichaptum Abhängigkeiten und die spätere Deinstallation. - Version: Getestet mit Zettlr 4.8.0 unter Ubuntu 26.04.
- Größe: Zettlr selbst ist etwa 135 MB groß.
aptinstalliert zusätzlich TeX Live für den PDF-Export. Alles zusammen belegt gut 1 GB. - Deine Dateien bleiben lesbar: Zettlr speichert nichts in einer eigenen Datenbank. Jede Notiz ist eine
.md-Datei, die du auch mit jedem anderen Editor öffnen kannst.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Abhängigkeiten kennt.
sudo apt update
2. Zettlr herunterladen
Lädt das Paket für 64-Bit-PCs mit Intel- oder AMD-Prozessor in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://github.com/Zettlr/Zettlr/releases. Bei einer neueren Version ersetzt du die Nummer an beiden Stellen im Befehl.
wget -O /tmp/zettlr.deb https://github.com/Zettlr/Zettlr/releases/download/v4.8.0/Zettlr-4.8.0-amd64.deb
3. Download prüfen
Vergleicht die Prüfsumme der Datei mit dem Wert, den das Projekt in der Datei SHA256SUMS.txt für Version 4.8.0 veröffentlicht. So fällt auf, wenn der Download beschädigt oder verändert wurde.
echo "104e5655bd3fa26112707478c133d141aeb4058da7491c61eb3c431037deb90b /tmp/zettlr.deb" | sha256sum -c
Prüfen: Die Ausgabe lautet /tmp/zettlr.deb: OK.
4. Zettlr installieren
Der Pfad mit / am Anfang sagt apt, dass es eine lokale Datei installieren soll. Als empfohlene Pakete kommen TeX Live (für PDF) und Pandoc mit.
sudo apt install /tmp/zettlr.deb
Prüfen: Die Ausgabe lautet Zettlr 4.8.0.
zettlr --version
5. XeLaTeX für den PDF-Export installieren
Zettlr erzeugt PDF-Dateien mit dem Satzprogramm XeLaTeX. Das in Schritt 4 mitinstallierte TeX Live enthält es nicht. Ohne dieses Paket bricht der PDF-Export mit der Meldung 'xelatex' not found ab.
sudo apt install texlive-xetex
Prüfen: Die Ausgabe beginnt mit XeTeX.
xelatex --version
Erste Schritte
6. Ordner für die Notizen anlegen
Zettlr arbeitet mit gewöhnlichen Ordnern, die es Arbeitsverzeichnisse nennt. Hier als Beispiel ~/Dokumente/Zettelkasten.
mkdir -p ~/Dokumente/Zettelkasten
7. Zettlr starten
Starte Zettlr über das Startmenü (Suchbegriff „Zettlr“) oder im Terminal:
zettlr
Prüfen: Das Fenster öffnet sich mit deutscher Oberfläche. Meldungen im Terminal wie '--ozone-platform=wayland' is not compatible with Vulkan sind nur Hinweise und stören nicht.
8. Arbeitsverzeichnis öffnen
Wähle im Menü Datei → Arbeitsverzeichnis öffnen… und dann den Ordner ~/Dokumente/Zettelkasten. Er erscheint links in der Dateiliste.
9. Notizen anlegen und verknüpfen
Lege mit Strg+N eine neue Datei an, z. B. Gartenprojekt. Schreibe darin Markdown, zum Beispiel:
# Gartenprojekt
Im Frühjahr kommen neue Beete dazu. Welche Pflanzen passen, steht in [[Pflanzenliste]].
#garten #planung
[[Pflanzenliste]]ist ein Link auf eine andere Notiz. Mit Strg und Klick auf den Link öffnet Zettlr sie. Gibt es sie noch nicht, legt Zettlr sie an.#gartenist ein Schlagwort. Über die Seitenleiste findest du später alle Notizen mit demselben Schlagwort.
Zettlr speichert automatisch.
Prüfen: Im Ordner liegt die Notiz als Markdown-Datei.
ls ~/Dokumente/Zettelkasten
10. Als PDF exportieren
Öffne die Notiz und wähle Datei → Exportieren…. Wähle als Format XeLaTeX PDF und klicke auf Exportieren. Zettlr legt die PDF-Datei standardmäßig in einem temporären Ordner ab und öffnet sie gleich. Unter Datei → Einstellungen… → Import und Export stellst du ein, dass die PDF-Datei neben der Notiz gespeichert wird.
Aktualisieren
Lade die neue .deb-Datei wie in Schritt 2 herunter, prüfe sie wie in Schritt 3 mit der Prüfsumme aus SHA256SUMS.txt der neuen Version und installiere sie wie in Schritt 4. apt ersetzt dabei die alte Version. Deine Notizen und Einstellungen bleiben erhalten.
Deinstallieren
1. Zettlr und XeLaTeX entfernen
purge entfernt die Programme samt ihrer Systemdateien.
sudo apt purge zettlr texlive-xetex
2. Nicht mehr benötigte Pakete entfernen
Entfernt TeX Live, Pandoc und weitere Pakete, die mit Zettlr installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste. Ist z. B. Sphinx installiert, bleibt TeX Live stehen, weil Sphinx es für seinen PDF-Export vorschlägt.
sudo apt autoremove --purge
3. Persönliche Einstellungen löschen
Entfernt Einstellungen, Zwischenspeicher und Protokolle von Zettlr. Deine Notizen in ~/Dokumente/Zettelkasten bleiben erhalten.
rm -r ~/.config/Zettlr
4. Heruntergeladene Datei löschen
rm /tmp/zettlr.deb
Prüfen: Der Befehl zettlr wird nicht mehr gefunden.
zettlr --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.zettlr.com/
- Lizenz: Zettlr steht unter der GPL-3.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.
Joplin
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Joplin ist ein Notizprogramm, das Notizen in Markdown schreibt und in Notizbüchern und mit Schlagwörtern ordnet. Es synchronisiert auf Wunsch verschlüsselt zwischen Rechner und Smartphone, auch über einen eigenen Speicherort statt einer Cloud. Joplin eignet sich gut als Ersatz für Evernote oder OneNote.
Vorbemerkungen
- Kein apt-Paket: Joplin ist nicht in den Ubuntu-Paketquellen enthalten. Den Snap im Snap Store pflegt nicht das Joplin-Projekt, sondern ein Dritter. Diese Anleitung installiert deshalb die offizielle
.deb-Datei von der Release-Seite des Projekts mitapt. - Version: Getestet mit Joplin 3.7.21 unter Ubuntu 26.04.
- Wo die Notizen liegen: Anders als Obsidian oder Zettlr speichert Joplin die Notizen nicht als einzelne Dateien, sondern in einer SQLite-Datenbank im Ordner
~/.config/joplin-desktop. Über Alles exportieren bekommst du sie jederzeit als Markdown-Dateien heraus, siehe Schritt 9. - Sandbox: Joplin baut auf Electron auf, das Programme in einer abgeschotteten Umgebung ausführt. Ubuntu erlaubt das seit Version 24.04 nur Programmen mit einem AppArmor-Profil. Das Paket richtet dieses Profil bei der Installation selbst ein.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Abhängigkeiten kennt.
sudo apt update
2. Joplin herunterladen
Lädt das Paket (etwa 160 MB) in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://github.com/laurent22/joplin/releases/latest. Bei einer neueren Version ersetzt du die Nummer an beiden Stellen im Befehl.
wget -O /tmp/joplin.deb https://github.com/laurent22/joplin/releases/download/v3.7.21/Joplin-3.7.21.deb
3. Download prüfen
Vergleicht die Prüfsumme der Datei mit dem Wert, den GitHub für diese Datei anzeigt. So fällt auf, wenn der Download beschädigt oder verändert wurde. Bei einer anderen Version steht die Prüfsumme auf der Release-Seite neben dem Dateinamen (sha256:…).
echo "14de2d5524e45341de5f0b68a1e78191b796a6c9817949c49b80afe5cd6ab965 /tmp/joplin.deb" | sha256sum -c
Prüfen: Die Ausgabe lautet /tmp/joplin.deb: OK.
4. Joplin installieren
Der Pfad mit / am Anfang sagt apt, dass es eine lokale Datei installieren soll. Das Paket legt das Programm nach /opt/Joplin, den Befehl joplin nach /usr/bin und das AppArmor-Profil nach /etc/apparmor.d/joplin.
sudo apt install /tmp/joplin.deb
Prüfen: Die Zeile beginnt mit ii und enthält 3.7.21.
dpkg -l joplin
Erste Schritte
5. Joplin starten
Starte Joplin über das Startmenü (Suchbegriff „Joplin“) oder im Terminal:
joplin
Prüfen: Das Fenster öffnet sich mit deutscher Oberfläche. Links steht das Notizbuch Willkommen! mit fünf englischen Einführungsnotizen. Meldungen im Terminal wie vaInitialize failed oder DeprecationWarning sind nur Hinweise und stören nicht.
6. Notizbuch anlegen
Wähle Datei → Neues Notizbuch, gib einen Namen ein, z. B. Garten, und bestätige. Notizbücher sind wie Ordner. Sie lassen sich per Ziehen auch ineinander schachteln.
7. Notiz schreiben
Markiere das Notizbuch und klicke auf Neue Notiz. Gib oben einen Titel ein und schreibe darunter Markdown, zum Beispiel:
## Beete
- [ ] Kompost ausbringen
- [ ] Tomaten vorziehen
**Wichtig:** Erst nach den Eisheiligen auspflanzen.
Joplin zeigt links den Text und rechts die fertige Ansicht. Es speichert automatisch.
8. Schlagwort vergeben
Klicke unten in der Notiz auf das Etikett-Symbol, gib ein Schlagwort ein, z. B. planung, und bestätige. Links unter Schlagwörter findest du danach alle Notizen mit diesem Schlagwort.
9. Notizen als Markdown exportieren
Wähle Datei → Alles exportieren → MD - Markdown und dann einen leeren Ordner, z. B. ~/Dokumente/Joplin-Export. Joplin legt pro Notizbuch einen Ordner und pro Notiz eine .md-Datei an. So kommst du jederzeit ohne Joplin an deine Notizen.
Prüfen: Im Ordner liegen die Notizbücher als Unterordner.
ls ~/Dokumente/Joplin-Export
10. Mit einem Ordner synchronisieren (optional)
Joplin kann mit Joplin Cloud, Nextcloud, WebDAV und anderen Speichern synchronisieren. Am einfachsten ist ein Ordner, z. B. einer, den ein anderes Programm sichert oder auf andere Rechner kopiert. Wähle Werkzeuge → Optionen → Synchronisation, setze Synchronisationsziel auf Dateisystem und trage bei Verzeichnis, mit dem synchronisiert werden soll (absoluter Pfad) einen vollständigen Pfad ein, z. B. /home/DEINNAME/JoplinSync. Mit Überprüfen der Synchronisationseinstellungen testest du die Einstellung. Klicke danach auf OK und dann links unten auf Synchronisieren.
Aktualisieren
Joplin meldet neue Versionen beim Start. Lade die neue .deb-Datei wie in Schritt 2 herunter, prüfe sie wie in Schritt 3 mit der Prüfsumme von der Release-Seite und installiere sie wie in Schritt 4. apt ersetzt dabei die alte Version. Notizen und Einstellungen bleiben erhalten.
Deinstallieren
1. Joplin entfernen
purge entfernt das Programm, den Befehl joplin und das AppArmor-Profil.
sudo apt purge joplin
2. Notizen und Einstellungen löschen
Achtung: In diesen Ordnern liegen alle Notizen. Wer sie behalten will, exportiert sie vorher wie in Schritt 9.
rm -r ~/.config/joplin-desktop ~/.config/Joplin
3. Heruntergeladene Datei löschen
rm /tmp/joplin.deb
Prüfen: Das Paket ist nicht mehr installiert.
dpkg -l joplin
Quellen und Lizenz
- Offizielle Dokumentation: https://joplinapp.org/
- Lizenz: Joplin steht unter der AGPL-3.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.
Excalidraw
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Excalidraw ist ein Zeichenprogramm für Skizzen, Diagramme und Schaubilder im Handzeichnungs-Stil. Es läuft im Browser. Zeichnungen lassen sich als offene JSON-Datei (.excalidraw) speichern oder als PNG bzw. SVG exportieren.
Vorbemerkungen
- Kein apt-Paket, kein Snap: Excalidraw ist eine Web-App. Diese Anleitung baut sie aus dem offiziellen Quellcode und liefert sie mit nginx auf dem eigenen Rechner aus. So läuft sie ohne die Seite excalidraw.com.
- Version: Verwendet wird die Version 0.18.1 (Git-Tag
v0.18.1). Sie braucht Node.js 18 bis 22. Ubuntu 26.04 liefert Node.js 22, das passt. - Speicherplatz und Zeit: Die Build-Werkzeuge belegen etwa 1,1 GB, der Bau dauert je nach Rechner ein bis drei Minuten. Die fertige App ist etwa 45 MB groß.
- Was lokal bleibt: Zeichnen, Speichern und Exportieren funktionieren komplett lokal. Die Funktionen Live-Zusammenarbeit, Link teilen und die Bibliothek mit fertigen Formen nutzen weiterhin die Server von excalidraw.com.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js, npm und Git kennt.
sudo apt update
2. Node.js, npm und Git installieren
Node.js und npm werden zum Bauen gebraucht, Git zum Herunterladen des Quellcodes. Ist alles schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm git
Prüfen: Die Versionsnummer liegt zwischen v18 und v22, z. B. v22.22.1.
node --version
Zeigt der Befehl eine höhere Version (z. B. v25), stammt Node.js aus dem Versionsmanager nvm. Schalte dann für dieses Terminal auf das Node.js von Ubuntu um und prüfe erneut:
nvm use system
Excalidraw bauen
3. Quellcode herunterladen
Lädt den Quellcode der Version 0.18.1 nach ~/excalidraw. --depth 1 lädt nur diesen Stand ohne die gesamte Versionsgeschichte.
git clone --depth 1 -b v0.18.1 https://github.com/excalidraw/excalidraw.git ~/excalidraw
4. In den Quellcode-Ordner wechseln
Alle Befehle zum Bauen werden hier ausgeführt.
cd ~/excalidraw
5. Abhängigkeiten installieren
Excalidraw verwendet den Paketmanager Yarn in Version 1. Ubuntu liefert nur die neuere, nicht passende Yarn-Version 4. npx lädt deshalb genau die benötigte Version 1.22.22 herunter und führt sie aus. --frozen-lockfile installiert exakt die Versionen, die die Entwickler getestet haben.
npx --yes yarn@1.22.22 install --frozen-lockfile
Prüfen: Die Ausgabe endet mit Done in ….
6. App bauen
Erzeugt die fertige Web-App im Ordner excalidraw-app/build. Das Build-Skript heißt build:app:docker, hat aber nichts mit Docker zu tun: Es ist die Variante, die keine Fehlerberichte an den Dienst Sentry sendet und keine Nutzungsstatistik erhebt. Deshalb eignet sie sich für eine eigene Installation.
npx --yes yarn@1.22.22 build:app:docker
Prüfen: Die Ausgabe enthält ✓ built in …, und im Ordner liegt eine index.html.
ls excalidraw-app/build/index.html
Mit nginx ausliefern
7. Zielordner anlegen
Die fertige App wird nach /var/www/excalidraw kopiert, wo nginx sie lesen darf.
sudo mkdir -p /var/www/excalidraw
8. App kopieren
Kopiert den Inhalt des Build-Ordners. Der Punkt am Ende von build/. sorgt dafür, dass auch versteckte Dateien mitkommen.
sudo cp -r excalidraw-app/build/. /var/www/excalidraw/
9. nginx-Konfiguration anlegen
Excalidraw läuft auf Port 8087 und ist nur vom eigenen Rechner aus erreichbar. Die App besteht nur aus statischen Dateien, PHP oder ein anderer Dienst ist nicht nötig. Der zweite Block gibt der Datei manifest.webmanifest den richtigen Typ. Mit ihr kann der Browser Excalidraw als eigene App installieren.
sudo nano /etc/nginx/sites-available/excalidraw
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8087;
server_name localhost;
root /var/www/excalidraw;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location = /manifest.webmanifest {
default_type application/manifest+json;
}
}
10. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/excalidraw /etc/nginx/sites-enabled/excalidraw
11. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
12. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Prüfen: Die Ausgabe enthält den Seitentitel Excalidraw.
curl -s http://localhost:8087/ | grep -o '<title>[^<]*'
Im Browser öffnet http://localhost:8087 die Zeichenfläche. Ist dein Browser auf Deutsch eingestellt, erscheint auch Excalidraw auf Deutsch. Sonst stellst du die Sprache im Menü (☰ oben links) ganz unten um.
13. Optional: Quellcode-Ordner löschen
Der Quellcode samt Build-Werkzeugen (etwa 1,1 GB) wird für den Betrieb nicht mehr gebraucht. Behalte ihn, wenn du später aktualisieren willst.
rm -rf ~/excalidraw
Das Dateiformat .excalidraw
Excalidraw merkt sich die aktuelle Zeichnung automatisch im Speicher des Browsers. Dieser Speicher gehört zur Adresse http://localhost:8087. Löschst du die Browserdaten, ist die Zeichnung weg. Wichtige Zeichnungen speicherst du deshalb mit Strg+S als Datei.
Eine .excalidraw-Datei ist lesbares JSON:
typeist immer"excalidraw",versiondie Formatversion (derzeit2)elementsenthält alle Formen: Rechtecke, Pfeile, Texte usw., jeweils mit Position, Größe, Farben und einer eindeutigenid. Pfeile verweisen über dieseidauf die Formen, die sie verbinden.appStateenthält Ansichtseinstellungen wie Hintergrundfarbe und Rasterfilesenthält eingefügte Bilder, als Text kodiert (Base64)
Beim Export als PNG oder SVG kannst du die Option Szene einbetten wählen. Dann steckt die komplette Zeichnung in der Bilddatei, und Excalidraw kann sie später wieder bearbeitbar öffnen.
Tipp: Wer Obsidian nutzt, kann Excalidraw-Zeichnungen mit der Community-Erweiterung „Excalidraw“ direkt im Vault ablegen und mit Notizen verlinken.
Aktualisieren
Für eine neue Version wiederholst du die Schritte 3 bis 8 mit der neuen Versionsnummer im Befehl git clone. Den alten Quellcode-Ordner löschst du vorher, den alten Inhalt von /var/www/excalidraw ebenfalls (sudo rm -rf /var/www/excalidraw/*). Neue Versionen stehen auf https://github.com/excalidraw/excalidraw/releases. Prüfe dort auch, welche Node.js-Version sie brauchen.
Deinstallieren
1. Seite in nginx deaktivieren
Löscht den Link aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/excalidraw
2. nginx-Konfigurationsdatei löschen
Löscht die Konfigurationsdatei der Seite.
sudo rm -f /etc/nginx/sites-available/excalidraw
3. nginx neu laden
Übernimmt das Abschalten der Seite.
sudo systemctl reload nginx
4. App-Dateien löschen
Entfernt die ausgelieferte App.
sudo rm -rf /var/www/excalidraw
5. Quellcode und Zwischenspeicher löschen
Entfernt den Quellcode-Ordner (falls noch vorhanden) und das von npx zwischengespeicherte Yarn. Andere Projekte sind nicht betroffen, npx lädt benötigte Programme beim nächsten Aufruf neu.
rm -rf ~/excalidraw ~/.npm/_npx
6. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora, Docusaurus, VitePress oder Starlight).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Unter http://localhost:8087 antwortet kein Webserver mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8087/
Zeichnungen, die du als .excalidraw-Datei gespeichert hast, bleiben erhalten. Die automatisch gemerkte Zeichnung im Browser verschwindet erst, wenn du die Browserdaten für localhost:8087 löschst.
Quellen und Lizenz
- Offizielle Dokumentation: https://excalidraw.com/
- Lizenz: Excalidraw steht unter der MIT.
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.
Freeplane
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Freeplane ist ein Programm für Mindmaps: Gedanken, Notizen und Wissen werden als Baum aus Knoten um ein zentrales Thema angeordnet, mit Verbindungen, Symbolen, Notizen und Attributen. Jede Mindmap ist eine offene XML-Datei mit der Endung .mm.
Vorbemerkungen
- Warum nicht die Version aus apt: Ubuntu 26.04 enthält Freeplane nur in der alten Version 1.7.10 von 2019. Im Test startete sie zwar, aber ihr Skript-Modul brach mit einer Fehlermeldung ab, weil es eine Java-Funktion nutzt, die es in neuen Java-Versionen nicht mehr gibt. Diese Anleitung installiert deshalb die aktuelle
.deb-Datei des Projekts. Das Paket wird trotzdem mitaptinstalliert, so kümmert sichaptum die Abhängigkeiten und die spätere Deinstallation. - Version: Getestet mit Freeplane 1.13.3 unter Ubuntu 26.04.
- Java: Freeplane ist in Java geschrieben und läuft laut seinem Startskript nur mit Java 8 oder 11 bis 23. Ubuntu 26.04 bringt als Standard Java 25 mit, eventuell ist auch Java 26 installiert (siehe Java). Beide sind zu neu. Die Anleitung installiert deshalb zusätzlich Java 21, eine Version mit Langzeitpflege, und stellt Freeplane darauf ein. Das übrige System nutzt weiter sein Standard-Java.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Java 21 kennt.
sudo apt update
2. Java 21 installieren
openjdk-21-jre ist die Laufzeitumgebung von Java 21, also alles, was zum Ausführen von Java-Programmen nötig ist. Sie wird neben einem vorhandenen Java installiert und ändert nicht, welches Java der Befehl java startet.
sudo apt install openjdk-21-jre
Prüfen: Die Ausgabe beginnt mit openjdk version "21.
/usr/lib/jvm/java-21-openjdk-amd64/bin/java -version
3. Freeplane herunterladen
Lädt das Paket (etwa 70 MB) von SourceForge, wo das Projekt seine Versionen veröffentlicht, in den Ordner /tmp. Die aktuelle Versionsnummer steht auf https://sourceforge.net/projects/freeplane/files/freeplane%20stable/. Bei einer neueren Version ersetzt du die Nummer im Befehl.
wget -O /tmp/freeplane.deb https://sourceforge.net/projects/freeplane/files/freeplane%20stable/freeplane_1.13.3.upstream-1_all.deb/download
4. Download prüfen
Vergleicht die Prüfsumme der Datei mit dem Wert, den SourceForge für Version 1.13.3 angibt. So fällt auf, wenn der Download beschädigt oder verändert wurde. Bei einer anderen Version steht die passende Prüfsumme auf der Download-Seite hinter dem Info-Symbol (i) der Datei.
echo "28cb439457c282e6f598daa6d21a611379b650e7 /tmp/freeplane.deb" | sha1sum -c
Prüfen: Die Ausgabe lautet /tmp/freeplane.deb: OK.
5. Freeplane installieren
Der Pfad mit / am Anfang sagt apt, dass es eine lokale Datei installieren soll und kein Paket aus den Paketquellen. apt installiert dabei auch das Standard-Java von Ubuntu mit, weil das Paket es als Abhängigkeit angibt.
sudo apt install /tmp/freeplane.deb
Prüfen: Die Zeile beginnt mit ii und enthält 1.13.3~upstream-1.
dpkg -l freeplane
Einrichten
6. Ordner für die Einstellungen anlegen
Das Startskript von Freeplane liest beim Start die Datei /etc/freeplane/freeplanerc, falls es sie gibt. Den Ordner dafür legt das Paket nicht an.
sudo mkdir -p /etc/freeplane
7. Java 21 für Freeplane festlegen
Ohne diese Einstellung nimmt Freeplane das Standard-Java, bricht wegen der zu neuen Version ab und meldet Currently, freeplane requires java version 8 or from 11 to 23.
sudo nano /etc/freeplane/freeplanerc
Füge diese Zeile ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
FREEPLANE_JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
Die Einstellung gilt für alle Benutzer des Rechners, egal ob Freeplane im Terminal oder über das Startmenü gestartet wird.
8. Freeplane zum ersten Mal starten
Startet Freeplane aus dem Terminal. So siehst du Fehlermeldungen sofort. Später startest du Freeplane über das Startmenü (Suchbegriff „Freeplane“).
freeplane
Prüfen: Nach einigen Sekunden öffnet sich das Fenster mit deutscher Oberfläche und einer leeren Mindmap. Im Terminal steht eine Zeile mit freeplane_version = 1.13.3 und java_version = 21. Warnungen wie Could not read update url erscheinen nur ohne Internetverbindung und sind harmlos.
Erste Schritte
9. Eine Mindmap aufbauen
Klicke auf den mittleren Knoten und tippe ein Thema, z. B. Urlaub. Die wichtigsten Tasten:
- Tab – neuer Unterknoten unter dem markierten Knoten
- Enter – neuer Knoten auf derselben Ebene
- F2 – Text des markierten Knotens bearbeiten
- Leertaste – Äste ein- und ausklappen
- Strg+N – neue, leere Mindmap
10. Mindmap speichern
Speichere mit Strg+S und gib einen Dateinamen an, z. B. urlaub.mm im persönlichen Ordner.
Prüfen: Die Datei ist eine lesbare XML-Datei. Die erste Zeile beginnt mit <map version=.
head -1 ~/urlaub.mm
Aktualisieren
Eine neue Version lädst du wie in Schritt 3 herunter, prüfst sie wie in Schritt 4 mit der Prüfsumme von der Download-Seite und installierst sie wie in Schritt 5. apt ersetzt dabei die alte Version. Die Datei /etc/freeplane/freeplanerc und deine Mindmaps bleiben erhalten. Steht in der Versionsliste des neuen Startskripts eine höhere Java-Version als 23, kann die Einstellung aus Schritt 7 entfallen.
Deinstallieren
1. Freeplane entfernen
purge entfernt das Programm samt seiner Systemdateien.
sudo apt purge freeplane
2. Einstellungsdatei löschen
Die Datei aus Schritt 7 gehört nicht zum Paket und wird deshalb nicht mit entfernt.
sudo rm -r /etc/freeplane
3. Java 21 entfernen
Nur ausführen, wenn kein anderes Programm Java 21 braucht.
sudo apt purge openjdk-21-jre openjdk-21-jre-headless
4. Nicht mehr benötigte Pakete entfernen
Entfernt Pakete, die automatisch mitinstalliert wurden und die kein anderes Programm mehr braucht. Lies vor dem Bestätigen die Liste. Das Standard-Java aus Schritt 5 bleibt dabei oft installiert, weil andere Pakete des Systems es empfehlen. Das ist harmlos.
sudo apt autoremove --purge
5. Persönliche Einstellungen löschen
Freeplane legt im persönlichen Ordner Einstellungen, zuletzt geöffnete Dateien und eigene Skripte ab. Deine Mindmaps (.mm-Dateien) liegen woanders und bleiben erhalten.
rm -r ~/.config/freeplane
Prüfen: Der Befehl freeplane wird nicht mehr gefunden.
freeplane
Quellen und Lizenz
- Offizielle Dokumentation: https://freeplane.org/
- Lizenz: Freeplane steht unter der GPL-2.0-or-later.
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.
Yjs und Automerge
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Yjs und Automerge sind Programmbibliotheken für JavaScript, mit denen mehrere Geräte oder Personen gleichzeitig dasselbe Dokument bearbeiten können, auch ohne ständige Verbindung. Änderungen werden später automatisch und ohne Konflikte zusammengeführt. Sie bilden den Kern vieler kollaborativer Editoren und Local-First-Anwendungen.
Vorbemerkungen
- Was ist ein CRDT? Beide Bibliotheken beruhen auf CRDTs (Conflict-free Replicated Data Types, konfliktfreie replizierte Datentypen). Jedes Gerät hat eine vollständige Kopie des Dokuments und ändert sie lokal. Tauschen die Geräte ihre Änderungen aus, kommen alle garantiert zum selben Ergebnis, egal in welcher Reihenfolge die Änderungen eintreffen. Ein zentraler Server, der Konflikte entscheidet, ist nicht nötig.
- Keine Programme, sondern Bibliotheken: Yjs und Automerge haben keine eigene Oberfläche. Man baut sie in eigene Anwendungen ein. Diese Anleitung richtet deshalb ein kleines Testprojekt ein und zeigt an zwei Beispielen, wie sie arbeiten.
- Installation: Die Bibliotheken sind nicht in den Ubuntu-Paketquellen enthalten. Sie werden pro Projekt über
npminstalliert. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. - Versionen: Yjs 13.6 und Automerge 3.5.
Die beiden Bibliotheken im Vergleich
| Yjs | Automerge | |
|---|---|---|
| Schwerpunkt | Echtzeit-Zusammenarbeit an Texten, sehr schnell und sparsam | Dokumente als JSON-ähnliche Daten mit vollständigem Verlauf |
| Datenmodell | Gemeinsame Typen: Y.Text, Y.Array, Y.Map, Y.XmlFragment | Ein gewöhnliches JavaScript-Objekt, das über change() geändert wird |
| Verlauf | Nur der aktuelle Stand (Verlauf optional über Snapshots) | Jede Änderung bleibt mit Beschreibung erhalten, ähnlich wie Commits in Git |
| Speicherformat | Kompaktes Binärformat (Updates) | Kompaktes Binärformat |
| Umsetzung | Reines JavaScript | Kern in Rust, im Browser und in Node.js als WebAssembly |
| Typische Einsätze | Editoren wie Tiptap, ProseMirror, CodeMirror, Monaco | Local-First-Apps, Offline-Synchronisation |
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt die Beispielprogramme aus, npm lädt die Bibliotheken herunter. Ist beides schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer wird angezeigt, z. B. v22.22.1.
node --version
Testprojekt einrichten
3. Projektordner anlegen
Ein eigener Ordner für die Beispiele.
mkdir ~/crdt-test
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/crdt-test
5. Projekt anlegen
Legt die Datei package.json an. Darin hält npm fest, welche Bibliotheken das Projekt braucht. -y übernimmt alle Vorgaben, ohne nachzufragen.
npm init -y
6. Moderne Modul-Schreibweise einschalten
Erlaubt in den Beispielen die Schreibweise import … from …, die heute in JavaScript üblich ist.
npm pkg set type=module
7. Yjs und Automerge installieren
Lädt beide Bibliotheken in den Ordner node_modules und trägt sie in package.json ein.
npm install yjs @automerge/automerge
Prüfen: Die Ausgabe zeigt @automerge/automerge@3.5.0 und yjs@13.6.33 (oder neuere Versionen).
npm ls --depth=0
Beispiel mit Yjs
8. Beispielprogramm anlegen
Das Programm spielt zwei Geräte durch, Laptop und Handy. Beide haben dieselbe Notiz „Einkauf: Brot“ und ergänzen sie gleichzeitig, ohne voneinander zu wissen: das eine um „Milch“, das andere um „Käse“. Danach tauschen sie ihre Änderungen aus. Die wichtigsten Funktionen:
new Y.Doc()– ein Dokument, also eine Kopie auf einem GerätgetText('notiz')– ein gemeinsamer Text mit dem Namennotizinnerhalb des DokumentsY.encodeStateAsUpdate()– packt den Stand eines Dokuments in ein kompaktes Binärpaket (Update)Y.applyUpdate()– spielt ein solches Paket in ein anderes Dokument ein
Am Ende wird der Stand als Datei notiz.yjs gespeichert und in ein neues Dokument geladen.
nano yjs-demo.mjs
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import * as Y from 'yjs'
import { writeFileSync, readFileSync } from 'node:fs'
// Zwei Geräte mit je einer eigenen Kopie des Dokuments
const laptop = new Y.Doc()
const handy = new Y.Doc()
// Gemeinsamer Ausgangsstand: laptop schreibt, handy übernimmt den Stand
laptop.getText('notiz').insert(0, 'Einkauf: Brot')
Y.applyUpdate(handy, Y.encodeStateAsUpdate(laptop))
// Beide ändern gleichzeitig, ohne voneinander zu wissen
laptop.getText('notiz').insert(13, ', Milch')
handy.getText('notiz').insert(13, ', Käse')
// Änderungen in beide Richtungen austauschen
Y.applyUpdate(handy, Y.encodeStateAsUpdate(laptop))
Y.applyUpdate(laptop, Y.encodeStateAsUpdate(handy))
console.log('Laptop:', laptop.getText('notiz').toString())
console.log('Handy: ', handy.getText('notiz').toString())
console.log('Gleich:', laptop.getText('notiz').toString() === handy.getText('notiz').toString())
// Als kompakte Binärdatei speichern und in ein neues Dokument laden
writeFileSync('notiz.yjs', Y.encodeStateAsUpdate(laptop))
const geladen = new Y.Doc()
Y.applyUpdate(geladen, readFileSync('notiz.yjs'))
console.log('Geladen:', geladen.getText('notiz').toString())
9. Beispiel ausführen
Startet das Programm mit Node.js.
node yjs-demo.mjs
Prüfen: Beide Geräte zeigen denselben Text mit beiden Ergänzungen, z. B. Einkauf: Brot, Milch, Käse, und Gleich: true. Die Reihenfolge von Milch und Käse kann bei jedem Start anders sein, weil jedes Dokument eine zufällige Kennung bekommt. Entscheidend ist, dass beide Geräte immer dasselbe Ergebnis haben. Die Datei notiz.yjs ist nur etwa 60 Byte groß.
Beispiel mit Automerge
10. Beispielprogramm anlegen
Dasselbe Szenario mit einer Aufgabenliste. Bei Automerge ist das Dokument ein gewöhnliches JavaScript-Objekt. Die wichtigsten Funktionen:
Automerge.init()– ein leeres DokumentAutomerge.change(dokument, 'Beschreibung', d => { … })– ändert das Dokument. Innerhalb der Klammern arbeitest du mitdwie mit einem normalen Objekt. Das Ergebnis ist ein neuer Stand, deshalb wird es wieder zugewiesen.Automerge.clone()– eine unabhängige Kopie für ein zweites GerätAutomerge.merge()– übernimmt die Änderungen eines anderen StandsAutomerge.getHistory()– alle Änderungen mit ihrer BeschreibungAutomerge.save()/Automerge.load()– Speichern als Binärdaten und Laden
nano automerge-demo.mjs
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import * as Automerge from '@automerge/automerge'
import { writeFileSync, readFileSync } from 'node:fs'
// Gemeinsamer Ausgangsstand mit einer ersten, beschriebenen Änderung
let laptop = Automerge.change(Automerge.init(), 'Liste angelegt', d => {
d.aufgaben = ['Brot kaufen']
})
let handy = Automerge.clone(laptop)
// Beide ändern gleichzeitig, ohne voneinander zu wissen
laptop = Automerge.change(laptop, 'Milch ergänzt', d => { d.aufgaben.push('Milch kaufen') })
handy = Automerge.change(handy, 'Käse ergänzt', d => { d.aufgaben.push('Käse kaufen') })
// Änderungen zusammenführen
laptop = Automerge.merge(laptop, handy)
handy = Automerge.merge(handy, laptop)
console.log('Laptop:', laptop.aufgaben)
console.log('Handy: ', handy.aufgaben)
console.log('Gleich:', JSON.stringify(laptop) === JSON.stringify(handy))
// Verlauf: jede Änderung bleibt mit ihrer Beschreibung erhalten
for (const eintrag of Automerge.getHistory(laptop)) {
console.log('Änderung:', eintrag.change.message)
}
// Als kompakte Binärdatei speichern und wieder laden
writeFileSync('einkauf.automerge', Automerge.save(laptop))
const geladen = Automerge.load(readFileSync('einkauf.automerge'))
console.log('Geladen:', geladen.aufgaben)
11. Beispiel ausführen
Startet das Programm mit Node.js.
node automerge-demo.mjs
Prüfen: Beide Listen enthalten alle drei Aufgaben in derselben Reihenfolge, und es erscheint Gleich: true. Darunter stehen die drei Änderungen „Liste angelegt“, „Milch ergänzt“ und „Käse ergänzt“ aus dem Verlauf, zum Schluss die aus der Datei geladene Liste.
Wie geht es weiter?
Die Beispiele tauschen Änderungen direkt im selben Programm aus. In echten Anwendungen übernehmen das Zusatzbibliotheken, die ebenfalls über npm installiert werden:
- Yjs:
y-websocketsynchronisiert über einen WebSocket-Server,y-webrtcdirekt zwischen Browsern,y-indexeddbspeichert Dokumente im Browser. Für Editoren gibt es fertige Anbindungen, z. B.y-prosemirror,y-codemirror.nextundy-monaco. - Automerge:
@automerge/automerge-repoverwaltet viele Dokumente, speichert sie und synchronisiert sie über Netzwerkadapter, z. B. über WebSocket oder zwischen Browser-Tabs.
Deinstallieren
1. Testprojekt entfernen
Löscht den Projektordner mit den Beispielen, den gespeicherten Dateien und den installierten Bibliotheken.
rm -rf ~/crdt-test
2. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora, Docusaurus, VitePress, Starlight oder Excalidraw).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/crdt-test
Quellen und Lizenz
- Offizielle Dokumentation: https://yjs.dev/
- Lizenz: Yjs und Automerge steht unter der MIT.
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.
Drupal
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Drupal ist ein flexibles, modulares Open-Source-Content-Management-System (CMS) und Web-Framework. Auf dem Entwicklungsrechner dient es zum Aufbau komplexer Websites und Webanwendungen, die lokal mit Composer, nginx, PHP und PostgreSQL entwickelt und getestet werden.
Vorbereitung und PHP-Module
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketdaten aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Benötigte PHP-Erweiterungen und Composer installieren
Drupal benötigt Composer sowie spezifische PHP-Erweiterungen für PostgreSQL (php-pgsql), mathematische Berechnungen (php-bcmath), Bildverarbeitung (php-gd), Unicode-Verarbeitung (php-intl), Caching (php-apcu), XML-Parsing und ZIP-Archive.
sudo apt install -y composer php-pgsql php-bcmath php-gd php-intl php-apcu php-curl php-mbstring php-xml php-zip
Prüfen: Listet die geladenen Module auf.
php -m | grep -E "pgsql|bcmath|gd|intl"
Datenbank in PostgreSQL einrichten
PostgreSQL sollte bereits installiert sein und laufen (siehe PostgreSQL-Anleitung).
3. PostgreSQL-Benutzer für Drupal anlegen
Erstellt einen dedizierten Datenbankbenutzer drupaluser mit einem sicheren Passwort.
sudo -u postgres psql -c "CREATE USER drupaluser WITH PASSWORD 'geheimes_passwort';"
4. Drupal-Datenbank anlegen
Erstellt die Datenbank drupaldb mit UTF-8-Zeichensatz und weist drupaluser als Eigentümer zu.
sudo -u postgres psql -c "CREATE DATABASE drupaldb OWNER drupaluser ENCODING 'UTF8';"
5. PostgreSQL-Erweiterung pg_trgm aktivieren
Drupal setzt für Volltext- und Ähnlichkeitsabfragen in PostgreSQL die Erweiterung pg_trgm voraus.
sudo -u postgres psql -d drupaldb -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"
Prüfen: Die Erweiterung ist in der Datenbank aktiv.
sudo -u postgres psql -d drupaldb -c "\dx pg_trgm"
Drupal mit Composer herunterladen und einrichten
6. Drupal-Projekt mit Composer erstellen
Erstellt über das offizielle Template drupal/recommended-project eine neue Drupal-Installation im Verzeichnis /var/www/drupal. Dabei werden automatisch alle PHP-Abhängigkeiten in vendor/ und das Web-Verzeichnis in web/ angelegt.
sudo composer create-project drupal/recommended-project /var/www/drupal
Prüfen: Das Verzeichnis /var/www/drupal/web existiert.
ls -ld /var/www/drupal/web
7. Drush als Befehlszeilenwerkzeug hinzufügen (optional)
Installiert Drush (The Drupal Shell) als Abhängigkeit im Projekt, um administrative Aufgaben und Installationen im Terminal durchzuführen.
sudo composer require --working-dir=/var/www/drupal drush/drush
8. Dateirechte für den Webserver anpassen
Überträgt die Eigentümerschaft des Drupal-Ordners an den Benutzer www-data, damit Drupal Dateien hochladen und Konfigurationen verwalten kann.
sudo chown -R www-data:www-data /var/www/drupal
nginx für Drupal konfigurieren
9. Konfiguration für Drupal anlegen
Erstellt einen Server-Block auf Port 8090, der nur vom eigenen Rechner aus erreichbar ist und auf das Web-Stammverzeichnis /var/www/drupal/web zeigt. nginx prüft die Blöcke mit regulären Ausdrücken (~) von oben nach unten und nimmt den ersten Treffer. Deshalb stehen die Sperren vor dem Block, der PHP ausführt:
- Sperren: versteckte Dateien wie
.gitund.env, interne Drupal-Dateien (z. B..yml-Einstellungen,.twig-Vorlagen) und PHP-Dateien im Upload-Ordnersites/…/files. So kann niemand eine hochgeladene Datei als Programm starten. - PHP: Alle
.php-Dateien gehen an PHP-FPM.(/|$)erlaubt auch Adressen wie/update.php/selection, die Drupal bei Aktualisierungen verwendet. - Bilder, CSS, JavaScript: Der Browser darf sie 30 Tage zwischenspeichern. Fehlt eine Datei, reicht nginx die Anfrage an Drupal weiter. Drupal erzeugt verkleinerte Bilder und zusammengefasste CSS- und JavaScript-Dateien erst beim ersten Abruf.
- Alles andere: Adressen wie
/node/1gibt es nicht als Datei.try_filesreicht sie anindex.phpweiter, und Drupal entscheidet, welche Seite erscheint.
sudo nano /etc/nginx/sites-available/drupal
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8090;
server_name localhost;
root /var/www/drupal/web;
index index.php;
client_max_body_size 20m;
# Versteckte Dateien und Ordner (z. B. .git, .env) sperren
location ~ /\.(?!well-known/) {
return 403;
}
# Interne Drupal-Dateien sperren (Konfiguration, Vorlagen, Module)
location ~* \.(engine|inc|install|module|profile|theme|twig|yml|yaml|sql|lock|log|md)$ {
return 403;
}
# Hochgeladene Dateien dürfen nie als PHP ausgeführt werden
location ~ ^/sites/[^/]+/files/.*\.php$ {
return 403;
}
# PHP über PHP-FPM ausführen, auch mit Pfad dahinter (update.php/...)
location ~ \.php(/|$) {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
# Bilder, CSS und JavaScript: fehlt eine Datei, erzeugt Drupal sie
location ~* \.(css|js|png|jpe?g|gif|ico|svg|webp|woff2?)$ {
try_files $uri /index.php?$query_string;
expires 30d;
access_log off;
}
# Alle übrigen Adressen beantwortet Drupal über index.php
location / {
try_files $uri $uri/ /index.php?$query_string;
}
}
10. Konfiguration aktivieren
Erstellt einen symbolischen Link in sites-enabled.
sudo ln -s /etc/nginx/sites-available/drupal /etc/nginx/sites-enabled/drupal
11. nginx-Konfiguration prüfen
Prüft alle Konfigurationsdateien auf Syntaxfehler.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
12. nginx neu laden
Aktiviert die neue Seite im Webserver.
sudo systemctl reload nginx
Drupal initialisieren und testen
13. Drupal über Drush auf der Befehlszeile installieren
Richtet Drupal mit dem Standard-Profil, der PostgreSQL-Datenbank und einem Administrator-Konto ein.
sudo -u www-data /var/www/drupal/vendor/bin/drush site:install standard \
--db-url='pgsql://drupaluser:geheimes_passwort@127.0.0.1/drupaldb' \
--site-name='Mein Entwicklungs-Drupal' \
--account-name='admin' \
--account-pass='AdminPasswort123' \
--yes \
--root=/var/www/drupal/web
(Alternativ kann die Ersteinrichtung über den grafischen Installationsassistenten im Browser unter http://localhost:8090 aufgerufen werden.)
14. Website im Browser aufrufen
Prüft, ob Drupal Webanfragen beantwortet.
curl -sI http://localhost:8090/
Prüfen: Die Antwort liefert HTTP/1.1 200 OK. Im Browser erreichst du deine Drupal-Website unter http://localhost:8090.
Soll die Website unter einer eigenen Domain erreichbar sein, geht es weiter mit Drupal mit nginx unter eigener Domain.
Deinstallieren
1. Seite in nginx deaktivieren
Löscht die Verknüpfung aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/drupal
2. nginx-Konfigurationsdatei löschen
Entfernt die Datei aus sites-available.
sudo rm -f /etc/nginx/sites-available/drupal
3. nginx neu laden
Übernimmt die Deaktivierung des Serverblocks.
sudo systemctl reload nginx
4. Drupal-Dateien löschen
Entfernt das gesamte Drupal-Projektverzeichnis.
sudo rm -rf /var/www/drupal
5. Drupal-Datenbank in PostgreSQL löschen
Löscht die Datenbank drupaldb. Achtung: Alle Inhalte und Tabellen gehen dabei verloren.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS drupaldb;"
6. Datenbankbenutzer in PostgreSQL löschen
Entfernt den PostgreSQL-Benutzer drupaluser.
sudo -u postgres psql -c "DROP USER IF EXISTS drupaluser;"
7. Nicht mehr benötigte Pakete entfernen (optional)
Entfernt Composer und zusätzliche Module, falls sie nicht anderweitig gebraucht werden.
sudo apt purge composer php-bcmath
8. Verwaiste Abhängigkeiten bereinigen
Entfernt nicht mehr benötigte Systempakete.
sudo apt autoremove
Prüfen: Unter http://localhost:8090 antwortet kein Webserver mehr.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.drupal.org/docs
- Lizenz: Drupal steht unter der GPL-2.0-or-later.
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.
Joomla
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Joomla ist ein Content-Management-System für Websites mit Beiträgen, Menüs, Benutzerverwaltung und vielen Erweiterungen. Inhalte werden im Browser über eine Verwaltungsoberfläche gepflegt, ohne HTML-Kenntnisse. Es eignet sich für Vereins- und Firmenwebsites ebenso wie für mehrsprachige Portale.
Vorbemerkungen
- Kein apt-Paket: Joomla ist nicht in den Ubuntu-Paketquellen enthalten. Die Anleitung lädt das offizielle Paket von GitHub. PHP, PostgreSQL und nginx kommen aus den Ubuntu-Paketquellen.
- Voraussetzungen: nginx und PostgreSQL sind installiert und laufen. Joomla kann auch MySQL/MariaDB verwenden, diese Anleitung nutzt PostgreSQL wie die Anleitung für Drupal.
- Adresse: Joomla läuft hier unter http://localhost:8091, nur vom eigenen Rechner aus erreichbar. Port 8091 wurde gewählt, damit Joomla nicht mit anderen Websites auf Port 80 oder Drupal auf Port 8090 zusammenstößt. Für eine öffentliche Website mit eigener Domain passt man die nginx-Konfiguration an, wie in nginx auf dem Produktionsserver beschrieben.
- Version: Getestet mit Joomla 6.1.3, PHP 8.5 und PostgreSQL 18 unter Ubuntu 26.04. Joomla 6 braucht mindestens PHP 8.3.
- Sprache: Joomla wird auf Englisch installiert. Die deutsche Sprache kommt in Schritt 15 dazu.
PHP vorbereiten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP und benötigte Erweiterungen installieren
php-fpmführt PHP-Dateien für nginx aus.php-pgsqlverbindet PHP mit PostgreSQL.- Die übrigen Erweiterungen braucht Joomla für Bilder (
gd), Sprachen und Zahlenformate (intl), Pakete (zip), XML-Dateien (xml), Umlaute (mbstring) und Downloads, z. B. von Sprachpaketen und Updates (curl).
Sind die Pakete schon vorhanden, etwa durch die Drupal-Anleitung, meldet apt das nur.
sudo apt install php-fpm php-pgsql php-gd php-intl php-zip php-xml php-mbstring php-curl
Prüfen: Die Ausgabe beginnt mit PHP 8.3 oder höher, z. B. PHP 8.5.4.
php --version
Joomla herunterladen
3. Joomla herunterladen
Lädt das vollständige Paket (etwa 28 MB) nach /tmp. Die aktuelle Version steht auf https://github.com/joomla/joomla-cms/releases/latest. Bei einer neueren Version ersetzt du 6.1.3 an allen drei Stellen im Befehl.
wget -O /tmp/joomla.tar.gz https://github.com/joomla/joomla-cms/releases/download/6.1.3/Joomla_6.1.3-Stable-Full_Package.tar.gz
4. Prüfsumme vergleichen
Berechnet die SHA-256-Prüfsumme der Datei. So lässt sich feststellen, ob der Download vollständig und unverändert ist.
sha256sum /tmp/joomla.tar.gz
Prüfen: Vergleiche die Ausgabe mit dem Wert in der Tabelle „Installation Packages“ auf der Release-Seite in der Zeile „GNU Zip Archive (.tar.gz)“. Für 6.1.3 lautet er 184f8c582cde5981693de7c28547c6e834c48c50cb377c7b8421bbfd33bbdf6f. Weicht er ab, lösche die Datei und lade sie neu.
5. Verzeichnis für Joomla anlegen
Hier liegen später alle Dateien der Website.
sudo mkdir /var/www/joomla
6. Joomla entpacken
-C entpackt das Archiv in das neue Verzeichnis.
sudo tar -xzf /tmp/joomla.tar.gz -C /var/www/joomla
Prüfen: Die Ausgabe enthält unter anderem administrator, installation und index.php.
ls /var/www/joomla
7. Dateien dem Webserver übergeben
PHP-FPM läuft als Benutzer www-data. Joomla muss eigene Dateien schreiben können, etwa beim Installieren von Erweiterungen und bei Updates. Deshalb gehören alle Dateien diesem Benutzer.
sudo chown -R www-data:www-data /var/www/joomla
8. Heruntergeladene Datei löschen
rm /tmp/joomla.tar.gz
Datenbank in PostgreSQL einrichten
9. Datenbankbenutzer anlegen
Joomla meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 13.
sudo -u postgres psql -c "CREATE USER joomlauser WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
10. Datenbank anlegen
Legt die Datenbank joomladb an, die dem neuen Benutzer gehört.
sudo -u postgres psql -c "CREATE DATABASE joomladb OWNER joomlauser ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
nginx einrichten
11. Konfiguration für Joomla anlegen
sudo nano /etc/nginx/sites-available/joomla
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8091;
server_name localhost;
root /var/www/joomla;
index index.php index.html;
client_max_body_size 64M;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ ^/(administrator/logs|cli|logs|tmp)/ {
deny all;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ /\.(?!well-known) {
deny all;
}
}
listen 127.0.0.1:8091– nginx nimmt nur Anfragen vom eigenen Rechner auf Port 8091 an.client_max_body_size 64M– erlaubt größere Uploads, z. B. für Erweiterungen und Bilder.try_files … /index.php?$args– Adressen, zu denen es keine Datei gibt, gehen an Joomla. Das braucht Joomla für suchmaschinenfreundliche Adressen.deny allbeiadministrator/logs,cli,logsundtmp– diese Ordner enthalten Protokolle, Befehlszeilenprogramme und Zwischendateien, die niemand über den Browser abrufen soll. Der Block muss vor dem PHP-Block stehen. nginx prüft solche Regeln der Reihe nach und nimmt die erste passende, sonst würdecli/joomla.phpdoch ausgeführt.- Der letzte Block sperrt versteckte Dateien wie
.htaccess.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Konfiguration aktivieren, prüfen und laden
Der erste Befehl aktiviert die Seite über einen Link in sites-enabled. Der zweite prüft die Konfiguration auf Tippfehler, der dritte lädt sie, ohne laufende Verbindungen zu unterbrechen.
sudo ln -s /etc/nginx/sites-available/joomla /etc/nginx/sites-enabled/joomla
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
sudo systemctl reload nginx
Joomla installieren
13. Joomla über die Befehlszeile installieren
Joomla bringt ein Installationsprogramm für die Befehlszeile mit. Es richtet die Datenbank ein, schreibt die Einstellungen in configuration.php und löscht danach den Ordner installation. sudo -u www-data führt es als Webserver-Benutzer aus, damit alle neuen Dateien diesem gehören.
Passe vorher die Werte an:
--admin-user– dein Name,--admin-username– der Anmeldename für die Verwaltung,--admin-email– deine E-Mail-Adresse.--admin-password– ein Passwort mit mindestens 12 Zeichen.--db-pass– das Passwort aus Schritt 9.--db-prefix– eine Vorsilbe für alle Tabellennamen. Sie erlaubt mehrere Joomla-Installationen in einer Datenbank.
cd /var/www/joomla && sudo -u www-data php installation/joomla.php install --site-name="Meine Joomla-Website" --admin-user="Dein Name" --admin-username=admin --admin-password='Ein-langes-Passwort-2026' --admin-email=admin@example.com --db-type=pgsql --db-host=localhost --db-user=joomlauser --db-pass=geheimes_passwort --db-name=joomladb --db-prefix=jml_ -n
Prüfen: Alle Zeilen enden mit OK, die letzte lautet [OK] Joomla has been installed.
Wer lieber im Browser installiert, lässt diesen Schritt weg und ruft stattdessen http://localhost:8091 auf. Der Browser führt dann durch dieselben Angaben. Als Datenbanktyp wählt man dort „PostgreSQL (PDO)“.
14. An der Verwaltung anmelden
Öffne http://localhost:8091/administrator im Browser und melde dich mit dem Anmeldenamen und Passwort aus Schritt 13 an.
Prüfen: Das Dashboard „Home Dashboard“ erscheint. Links steht das Menü mit Content, Menus, Components, Users und System.
15. Deutsches Sprachpaket installieren
Klicke links auf System. Im Bereich Install klickst du auf Languages. Tippe in das Suchfeld German und drücke Enter. Klicke in der Zeile „German“ mit dem Kürzel de-DE auf Install. Joomla lädt das Sprachpaket herunter und meldet danach, dass die Installation erfolgreich war.
16. Deutsch als Standardsprache festlegen
Klicke links auf System. Im Bereich Manage klickst du auf Languages.
- Oben ist im Auswahlfeld Site eingestellt, also die öffentliche Website. Klicke in der Zeile „German (Germany)“ in der Spalte Default auf den Stern (Set default).
- Stelle das Auswahlfeld auf Administrator um und klicke auch dort in der Zeile „German (Germany)“ auf den Stern.
Nach dem zweiten Klick erscheint die Verwaltung auf Deutsch.
Prüfen: Beide Male erscheint die Meldung „Default Language Saved“ bzw. „Die Standardsprache wurde gespeichert.“. In der Spalte Default bzw. Standard leuchtet der Stern jetzt bei „German (Germany)“.
17. Website ansehen
Öffne http://localhost:8091 im Browser.
Prüfen: Die Startseite mit dem Design „Cassiopeia“ erscheint. Rechts steht ein Anmeldeformular mit „Benutzername“, „Passwort“ und „Anmelden“. Die Überschriften „Home“, „Main Menu“ und „Login Form“ bleiben englisch, weil es Inhalte sind, die bei der Installation angelegt wurden. Du änderst sie in der Verwaltung unter Menüs und Inhalt → Site Module.
Aktualisieren
Joomla aktualisiert sich über die Verwaltung. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/joomla.
1. Nach Updates suchen
Führt die Suche als Webserver-Benutzer auf der Befehlszeile aus.
cd /var/www/joomla && sudo -u www-data php cli/joomla.php core:update:check
Prüfen: Die Ausgabe nennt entweder eine neue Version oder meldet You already have the latest Joomla version.
2. Update einspielen
Die Verwaltung zeigt ein verfügbares Update auch auf dem Dashboard an. Klicke in der Verwaltung links auf System, im Bereich Updates auf Joomla und folge den Anweisungen.
Alternativ spielt dieser Befehl das Update auf der Befehlszeile ein:
cd /var/www/joomla && sudo -u www-data php cli/joomla.php core:update
3. Sprachpaket aktualisieren
Nach einem Joomla-Update gibt es meist auch ein neues deutsches Sprachpaket. Klicke auf System, im Bereich Updates auf Erweiterungen und aktualisiere dort „German (DE)“.
Deinstallieren
1. Seite in nginx deaktivieren
Entfernt nur den Link in sites-enabled, die Konfigurationsdatei bleibt zunächst erhalten.
sudo rm /etc/nginx/sites-enabled/joomla
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/joomla
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Joomla-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht.
sudo rm -r /var/www/joomla
5. Datenbank löschen
Achtung: Damit sind alle Beiträge, Menüs und Benutzer der Website gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS joomladb;"
6. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS joomlauser;"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8091
PHP, PostgreSQL und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden. Wer PHP nicht mehr braucht, entfernt die Pakete aus Schritt 2 mit sudo apt purge und danach sudo apt autoremove --purge.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.joomla.org/
- Lizenz: Joomla steht unter der GPL-2.0-or-later.
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.
TYPO3
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
TYPO3 ist ein Content-Management-System für große und mehrsprachige Websites mit fein abgestuften Rechten für Redakteure. Im deutschsprachigen Raum ist es besonders bei Hochschulen, Behörden und Unternehmen verbreitet. Inhalte werden im Browser gepflegt, das Aussehen bestimmen Themes und Vorlagen.
Vorbemerkungen
- Kein apt-Paket: TYPO3 ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP, PostgreSQL und nginx kommen aus den Ubuntu-Paketquellen.
- Voraussetzungen: nginx und PostgreSQL sind installiert und laufen. TYPO3 kann auch MySQL/MariaDB verwenden, diese Anleitung nutzt PostgreSQL wie die Anleitungen für Drupal und Joomla.
- Adresse: TYPO3 läuft hier unter http://localhost:8092, nur vom eigenen Rechner aus erreichbar. Rufe es immer über
localhostauf und nicht über127.0.0.1. TYPO3 prüft den Hostnamen und zeigt bei einem unerwarteten Namen nur „Oops, an error occurred!“. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die TYPO3-Befehle laufen alswww-data. So können Webserver und Befehlszeile dieselben Dateien schreiben. - Version: Getestet mit TYPO3 14.3.7 (Langzeitversion mit Pflege bis Mitte 2029), PHP 8.5, Composer 2.9 und PostgreSQL 18 unter Ubuntu 26.04.
PHP und Composer vorbereiten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und Composer installieren
php-fpmführt PHP-Dateien für nginx aus,php-pgsqlverbindet PHP mit PostgreSQL.gd,intl,zip,xml,mbstringundcurlbraucht TYPO3 für Bilder, Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt TYPO3 und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install php-fpm php-pgsql php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
3. Ordner für TYPO3 und den Composer-Zwischenspeicher anlegen
/var/www/typo3 nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache.
sudo mkdir /var/www/typo3 /var/www/.cache
4. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/typo3 /var/www/.cache
TYPO3 herunterladen
5. TYPO3-Projekt anlegen
create-project lädt die offizielle Grundausstattung typo3/cms-base-distribution in Version 14 samt aller Bibliotheken nach /var/www/typo3. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project "typo3/cms-base-distribution:^14" /var/www/typo3
Prüfen: Die Ausgabe endet mit No security vulnerability advisories found. Hinweise auf „funding“ kannst du ignorieren.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/typo3
Prüfen: Die Ausgabe beginnt mit TYPO3 CMS 14.3.7.
sudo -u www-data vendor/bin/typo3 --version
7. Theme „Camino“ hinzufügen
Camino ist das Standard-Theme von TYPO3 14. Es bringt ein fertiges Design und eine Beispielwebsite mit, die beim Einrichten in Schritt 12 automatisch angelegt wird. Ohne Theme bliebe die Website zunächst leer.
sudo -u www-data composer require typo3/theme-camino:^14.3
Datenbank in PostgreSQL einrichten
8. Datenbankbenutzer anlegen
Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 12. Benutzer und Datenbank heißen beide typo3. Das ist wichtig, denn das Einrichtungsprogramm von TYPO3 meldet sich zuerst bei der Datenbank an, die denselben Namen wie der Benutzer hat.
sudo -u postgres psql -c "CREATE USER typo3 WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
9. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE typo3 OWNER typo3 ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
nginx einrichten
10. Konfiguration für TYPO3 anlegen
sudo nano /etc/nginx/sites-available/typo3
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8092;
server_name localhost;
root /var/www/typo3/public;
index index.php index.html;
client_max_body_size 64M;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location = /typo3 {
rewrite ^ /typo3/;
}
location /typo3/ {
try_files $uri /index.php$is_args$args;
}
location ~ ^/(fileadmin/_recycler_|fileadmin/user_upload/_temp_|typo3temp/var)/ {
deny all;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/typo3/public– nur der Unterordnerpublicist über das Web erreichbar. Einstellungen, Bibliotheken und Protokolle liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an TYPO3, auch die Verwaltung unter/typo3/.deny all– sperrt den Papierkorb, temporäre Uploads und Zwischendateien. Der Block steht vor dem PHP-Block, weil nginx solche Regeln der Reihe nach prüft und die erste passende nimmt.- Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Konfiguration aktivieren, prüfen und laden
sudo ln -s /etc/nginx/sites-available/typo3 /etc/nginx/sites-enabled/typo3
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
sudo systemctl reload nginx
TYPO3 einrichten
12. TYPO3 über die Befehlszeile einrichten
setup legt die Tabellen in der Datenbank an, schreibt die Einstellungen nach config/system/settings.php, legt das Administratorkonto an und importiert die Beispielwebsite von Camino.
Passe vorher die Werte an:
--password– das Datenbankpasswort aus Schritt 8.--admin-username,--admin-user-passwordund--admin-email– deine Anmeldedaten für die Verwaltung. Das Passwort muss mindestens 8 Zeichen lang sein und Groß- und Kleinbuchstaben, eine Ziffer und ein Sonderzeichen enthalten.--project-name– der Name der Installation, er erscheint in der Verwaltung.
sudo -u www-data vendor/bin/typo3 setup -n --driver=postgres --host=localhost --port=5432 --dbname=typo3 --username=typo3 --password=geheimes_passwort --admin-username=admin --admin-user-password='Ein-langes-Passwort-2026!' --admin-email=admin@example.com --project-name="Meine TYPO3-Website" --server-type=other
Prüfen: Die letzte Zeile lautet ✓ Congratulations - TYPO3 Setup is done.
Bricht der Befehl mit einer Fehlermeldung ab, behebe die Ursache, lösche die Datenbank und lege sie neu an (Schritt 9 und Abschnitt „Deinstallieren“, Schritt 6). Hänge beim erneuten Aufruf --force an, damit TYPO3 die schon geschriebene settings.php überschreibt.
13. Website auf Deutsch und die Startadresse umstellen
Die Beispielwebsite ist auf Englisch eingestellt und liegt unter /camino/. In der Site-Konfiguration stellst du Sprache, Adresse und Titel um.
sudo nano config/sites/camino/config.yaml
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
base: /
dependencies:
- typo3/theme-camino
languages:
-
title: Deutsch
enabled: '1'
locale: de-DE
hreflang: de-DE
base: /
websiteTitle: 'Meine TYPO3-Website'
navigationTitle: Deutsch
flag: de
languageId: '0'
rootPageId: 1
websiteTitle: 'Meine TYPO3-Website'
base: /– die Website erscheint direkt unter http://localhost:8092/.locale: de-DE– Datumsangaben, feste Texte des Themes und die Sprachangabe im HTML werden deutsch.websiteTitle– steht im Titel jedes Browser-Tabs.
Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Deutsch für die Verwaltung freischalten
TYPO3 lädt Übersetzungen für die Verwaltung nur für Sprachen, die in den Einstellungen freigeschaltet sind. Eigene Einstellungen gehören in die Datei additional.php. Die Datei settings.php verwaltet TYPO3 selbst.
sudo nano config/system/additional.php
Füge diesen Inhalt ein:
<?php
$GLOBALS['TYPO3_CONF_VARS']['LANG']['availableLocales'] = ['de'];
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Deutsches Sprachpaket herunterladen
Lädt die deutschen Übersetzungen für alle installierten Erweiterungen nach var/labels/de.
sudo -u www-data vendor/bin/typo3 language:update de
Prüfen: Die Ausgabe listet Zeilen wie Fetching new pack for language "de" for extension "backend". Die Meldung Language iso code de not available or active bedeutet, dass Schritt 14 fehlt oder einen Tippfehler enthält.
16. Zwischenspeicher leeren
TYPO3 hält Einstellungen und Seiten im Zwischenspeicher. Nach den Änderungen in Schritt 13 und 14 muss er geleert werden. Das ist auch nach jeder späteren Änderung an config.yaml nötig.
sudo -u www-data vendor/bin/typo3 cache:flush
17. Website ansehen
Öffne http://localhost:8092 im Browser.
Prüfen: Die Beispielwebsite von Camino erscheint mit der Überschrift „Walk the Camino de Compostela“. Die Texte der Beispielseiten bleiben englisch, weil es Inhalte sind. Du bearbeitest oder löschst sie in der Verwaltung.
18. An der Verwaltung anmelden
Öffne http://localhost:8092/typo3/ und melde dich mit dem Benutzernamen und Passwort aus Schritt 12 an.
Prüfen: Die Verwaltung öffnet sich. Links steht die Modulleiste, daneben der Seitenbaum mit der Seite „Camino“.
19. Verwaltung auf Deutsch umstellen
Die Sprache der Verwaltung stellt jeder Benutzer für sich ein. Klicke oben rechts auf deinen Benutzernamen und wähle User Settings. Wähle im Feld Language den Eintrag für Deutsch („German“) und klicke oben auf Save.
Prüfen: Nach dem Neuladen der Seite (F5) sind Menüs und Beschriftungen deutsch, z. B. „Benutzereinstellungen“.
Aktualisieren
TYPO3 wird mit Composer aktualisiert. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/typo3.
1. In den Projektordner wechseln
cd /var/www/typo3
2. Neue Versionen anzeigen
Listet die Pakete auf, für die es neuere Versionen gibt. Everything up to date bedeutet, dass nichts zu tun ist.
sudo -u www-data composer outdated "typo3/*"
3. Pakete aktualisieren
Aktualisiert TYPO3 innerhalb der Version 14. Für den Sprung auf eine neue Hauptversion liest man vorher die Hinweise unter https://docs.typo3.org.
sudo -u www-data composer update "typo3/*" --with-all-dependencies
4. Datenbank anpassen und Sprachpakete erneuern
Neue Versionen bringen manchmal geänderte Tabellen und neue Übersetzungen mit. extension:setup passt die Datenbank an, language:update lädt die passenden Übersetzungen, cache:flush leert den Zwischenspeicher.
sudo -u www-data vendor/bin/typo3 extension:setup
sudo -u www-data vendor/bin/typo3 language:update de
sudo -u www-data vendor/bin/typo3 cache:flush
Prüfen: sudo -u www-data vendor/bin/typo3 --version zeigt die neue Versionsnummer.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/typo3
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/typo3
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. TYPO3-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/typo3
5. Composer-Zwischenspeicher von www-data löschen
sudo rm -r /var/www/.cache
6. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS typo3;"
7. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS typo3;"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8092
8. Composer entfernen (optional)
Nur wenn kein anderes Projekt Composer braucht. PHP, PostgreSQL und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge composer
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.typo3.org/
- Lizenz: TYPO3 steht unter der GPL-2.0-or-later.
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.
Grav
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Grav ist ein Content-Management-System, das ohne Datenbank auskommt: Jede Seite ist eine Markdown-Datei in einem Ordner, Einstellungen stehen in YAML-Dateien. Man kann Inhalte deshalb wahlweise im Browser über die Verwaltung oder direkt mit einem Texteditor bearbeiten und die ganze Website einfach als Ordner sichern oder mit Git verwalten.
Vorbemerkungen
- Kein apt-Paket: Grav ist nicht in den Ubuntu-Paketquellen enthalten. Die Anleitung lädt das offizielle Paket mit Verwaltung („Grav + Admin“) von GitHub. PHP und nginx kommen aus den Ubuntu-Paketquellen.
- Keine Datenbank: Anders als Drupal, Joomla oder TYPO3 braucht Grav kein PostgreSQL oder MySQL.
- Voraussetzung: nginx ist installiert und läuft.
- Adresse: Grav läuft hier unter http://localhost:8093, nur vom eigenen Rechner aus erreichbar. Für eine öffentliche Website mit eigener Domain passt man die nginx-Konfiguration an, wie in nginx auf dem Produktionsserver beschrieben.
- Version: Getestet mit Grav 2.2.1 und der neuen Verwaltung „Admin2“ 2.1.23 unter PHP 8.5 und Ubuntu 26.04. Grav 2 braucht mindestens PHP 8.3.
PHP vorbereiten
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und unzip installieren
php-fpmführt PHP-Dateien für nginx aus.gdbraucht Grav für Bilder,curlfür Downloads von Updates und Erweiterungen,zipzum Entpacken von Erweiterungen,xmlfür XML undmbstringfür Umlaute.unzipentpackt das heruntergeladene Grav-Paket.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install php-fpm php-gd php-curl php-zip php-xml php-mbstring unzip
Prüfen: Die Ausgabe beginnt mit PHP 8.3 oder höher, z. B. PHP 8.5.4.
php --version
Grav herunterladen
3. Grav herunterladen
Lädt das Paket mit Verwaltung (etwa 21 MB) nach /tmp. Die aktuelle Version steht auf https://github.com/getgrav/grav/releases/latest. Bei einer neueren Version ersetzt du 2.2.1 an beiden Stellen im Befehl.
wget -O /tmp/grav.zip https://github.com/getgrav/grav/releases/download/2.2.1/grav-admin-v2.2.1.zip
4. Prüfsumme vergleichen
Berechnet die SHA-256-Prüfsumme der Datei. So lässt sich feststellen, ob der Download vollständig und unverändert ist.
sha256sum /tmp/grav.zip
Prüfen: Auf der Release-Seite steht unter „Assets“ neben grav-admin-v2.2.1.zip die Prüfsumme (sha256:…). Für 2.2.1 lautet sie 0916525e4a359b3b366eb76afe82a5d5d8d3efd4dbb3a085262d82a19367cb7e. Weicht sie ab, lösche die Datei und lade sie neu.
5. Grav entpacken
Das Archiv enthält einen Ordner grav-admin. Er landet in /var/www.
sudo unzip -q /tmp/grav.zip -d /var/www
6. Ordner umbenennen
Ein kürzerer Name, der zum Rest der Anleitung passt.
sudo mv /var/www/grav-admin /var/www/grav
Prüfen: Die Ausgabe enthält unter anderem index.php, system, user und webserver-configs.
ls /var/www/grav
7. Dateien dem Webserver übergeben
PHP-FPM läuft als Benutzer www-data. Grav schreibt Seiten, Einstellungen, Zwischenspeicher und Updates selbst. Deshalb gehören alle Dateien diesem Benutzer.
sudo chown -R www-data:www-data /var/www/grav
8. Heruntergeladene Datei löschen
rm /tmp/grav.zip
nginx einrichten
9. Mitgelieferte Vorlage kopieren
Grav bringt im Ordner webserver-configs eine fertige nginx-Konfiguration mit. Sie sperrt unter anderem Einstellungen, Benutzerkonten, Protokolle und den Zwischenspeicher gegen Zugriffe aus dem Web. Du übernimmst sie und änderst nur zwei Zeilen.
sudo cp /var/www/grav/webserver-configs/nginx.conf /etc/nginx/sites-available/grav
10. Adresse und Ordner eintragen
sudo nano /etc/nginx/sites-available/grav
Ändere zwei Zeilen ganz oben in der Datei:
-
Aus
#listen 80;wird die folgende Zeile. Das#am Anfang fällt weg. nginx nimmt dann nur Anfragen vom eigenen Rechner auf Port 8093 an.listen 127.0.0.1:8093; -
Aus
root /home/USER/www/html;wird die folgende Zeile. Sie sagt nginx, wo Grav liegt.root /var/www/grav;
Alle anderen Zeilen bleiben unverändert. Die Zeile fastcgi_pass unix:/var/run/php/php-fpm.sock; passt schon zu Ubuntu.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe zeigt genau diese beiden Zeilen.
grep -E '^\s*(listen|root)' /etc/nginx/sites-available/grav
11. Konfiguration aktivieren, prüfen und laden
sudo ln -s /etc/nginx/sites-available/grav /etc/nginx/sites-enabled/grav
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
sudo systemctl reload nginx
Grav einrichten
12. In den Grav-Ordner wechseln
Die Befehlszeilenprogramme von Grav liegen im Unterordner bin.
cd /var/www/grav
Prüfen: Die Ausgabe lautet Grav CLI Application 2.2.1.
sudo -u www-data bin/grav --version
13. Administratorkonto anlegen
Legt ein Konto an, mit dem du dich an der Verwaltung und an der Website anmelden kannst. Solange es kein Konto gibt, leitet Grav jeden Aufruf zur Verwaltung um.
-u– der Anmeldename,-e– deine E-Mail-Adresse,-N– dein Name.-P b– Zugang zur Verwaltung und zur Website.-t– ein Titel, der in der Verwaltung unter dem Namen steht.-l de– die Verwaltung erscheint für dieses Konto auf Deutsch.
sudo -u www-data bin/plugin login new-user -u admin -e admin@example.com -P b -N "Dein Name" -t Administrator -l de
Grav fragt nach dem Passwort und dann noch einmal zur Bestätigung. Die Eingabe bleibt unsichtbar. Das Passwort muss mindestens 8 Zeichen lang sein und Groß- und Kleinbuchstaben sowie eine Ziffer enthalten.
Prüfen: Die Ausgabe endet mit Success! User admin created.
14. Titel und Sprache der Website einstellen
Die allgemeinen Angaben zur Website stehen in user/config/site.yaml.
sudo nano user/config/site.yaml
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein (Strg+Umschalt+V):
title: 'Meine Grav-Website'
default_lang: de
author:
name: 'Dein Name'
email: 'admin@example.com'
metadata:
description: 'Meine Website mit Grav'
title– steht im Titel jedes Browser-Tabs und im Kopf der Website.default_lang: de– das Design schreibtlang="de"in jede Seite. Browser und Suchmaschinen erkennen den Text so als deutsch.metadata– die Beschreibung erscheint bei Suchmaschinen unter dem Titel.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Startseite bearbeiten
Jede Seite ist ein Ordner unter user/pages mit einer Markdown-Datei. Die Zahl vor dem Ordnernamen bestimmt die Reihenfolge im Menü.
sudo nano user/pages/01.home/default.md
Ersetze den ganzen Inhalt wie in Schritt 14 durch:
---
title: Startseite
---
# Willkommen
Diese Website läuft mit **Grav**. Jede Seite ist eine Markdown-Datei,
eine Datenbank gibt es nicht.
Oben zwischen den ----Zeilen stehen Angaben zur Seite (Front Matter), darunter der Text in Markdown.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Zwischenspeicher leeren
Grav bemerkt geänderte Dateien meist von selbst. Nach Änderungen an Einstellungen sorgt dieser Befehl dafür, dass sie sicher übernommen werden.
sudo -u www-data bin/grav clearcache
17. Website ansehen
Öffne http://localhost:8093 im Browser.
Prüfen: Die Startseite zeigt „Willkommen“ und den Text aus Schritt 15. Im Browser-Tab steht „Startseite | Meine Grav-Website“. Das Menü enthält außerdem die Beispielseite „Typography“.
18. An der Verwaltung anmelden
Öffne http://localhost:8093/admin und melde dich mit dem Anmeldenamen und Passwort aus Schritt 13 an.
Prüfen: Das Dashboard erscheint auf Deutsch mit „Willkommen zurück, Dein Name“. Links stehen „Konfiguration“, „Benutzer“, „Seiten“, „Medien“, „Plugins“, „Themes“ und „Werkzeuge“. Unter „Seiten“ findest du die Startseite aus Schritt 15 wieder und kannst sie auch hier bearbeiten.
Oben erscheint ein Hinweis, dass E-Mail-Links noch nicht an einen vertrauenswürdigen Hostnamen gebunden sind. Er betrifft nur Mails zum Zurücksetzen von Passwörtern und ist für eine Testinstallation auf dem eigenen Rechner unwichtig.
Aktualisieren
Grav aktualisiert sich mit seinem eigenen Paketmanager GPM. Lege vorher eine Sicherung an, am einfachsten eine Kopie des Ordners /var/www/grav/user, in dem Seiten, Einstellungen und Konten liegen.
1. In den Grav-Ordner wechseln
cd /var/www/grav
2. Grav selbst aktualisieren
sudo -u www-data bin/gpm selfupgrade
Prüfen: Die Ausgabe nennt die neue Version oder meldet You are already running the latest version of Grav.
3. Plugins und Themes aktualisieren
sudo -u www-data bin/gpm update
Prüfen: Die Ausgabe listet die aktualisierten Erweiterungen oder meldet Nothing to update.
Updates lassen sich auch in der Verwaltung einspielen. Das Dashboard zeigt unter „Updates“, ob etwas ansteht.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/grav
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/grav
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Grav löschen
Achtung: Damit sind alle Seiten, Bilder, Einstellungen und Konten gelöscht, denn bei Grav liegt alles in diesem Ordner. Wer die Inhalte behalten will, kopiert vorher /var/www/grav/user. cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/grav
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8093
PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://learn.getgrav.org/
- Lizenz: Grav steht unter der MIT.
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.
Contao
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Contao ist ein Open-Source-Content-Management-System aus Deutschland. Es eignet sich für Firmen-, Vereins- und Behördenwebsites und legt großen Wert auf Barrierefreiheit und Datenschutz. Neuigkeiten, Termine, FAQ, Formulare und Newsletter sind schon eingebaut.
Vorbemerkungen
- Kein apt-Paket: Contao ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Contao läuft nur mit MariaDB oder MySQL, nicht mit PostgreSQL. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit. Ein vorhandenes PostgreSQL stört dabei nicht.
- Voraussetzung: nginx ist installiert und läuft.
- Adresse: Contao läuft hier unter http://localhost:8094, nur vom eigenen Rechner aus erreichbar. Die Verwaltung (bei Contao „Backend“ genannt) liegt unter
/contao. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die Contao-Befehle laufen alswww-data. So können Webserver und Befehlszeile dieselben Dateien schreiben. - Version: Getestet mit Contao 5.7.13 (Langzeitversion), PHP 8.5, Composer 2.9 und MariaDB 11.8 unter Ubuntu 26.04. Die neuere Reihe Contao 6.0 bekommt neue Funktionen zuerst, 5.7 wird dafür länger mit Sicherheitsupdates versorgt.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP, Erweiterungen und Composer installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gd,intl,zip,xml,mbstringundcurlbraucht Contao für Bilder, Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt Contao und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe enthält 11.8 und MariaDB.
mariadb --version
Und diese Ausgabe beginnt mit Composer version 2:
composer --version
3. Ordner für Contao und den Composer-Zwischenspeicher anlegen
/var/www/contao nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache. -p sorgt dafür, dass es keinen Fehler gibt, wenn .cache von einer anderen Anleitung (z. B. TYPO3) schon existiert.
sudo mkdir -p /var/www/contao /var/www/.cache
4. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/contao /var/www/.cache
Contao herunterladen
5. Contao-Projekt anlegen
create-project lädt die „Managed Edition“ von Contao in Version 5.7 samt aller Bibliotheken nach /var/www/contao. Zum Schluss legt Contao selbst die nötigen Unterordner an und füllt den Zwischenspeicher. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project contao/managed-edition /var/www/contao 5.7
Das Herunterladen dauert einige Minuten.
Prüfen: Kurz vor dem Ende steht Done! Please run the contao:migrate command, die letzte Zeile lautet No security vulnerability advisories found.
Bricht der Befehl ab, muss der Ordner /var/www/contao vor dem nächsten Versuch wieder ganz leer sein, sonst meldet Composer Project directory "/var/www/contao" is not empty. Lösche ihn dann mit sudo rm -r /var/www/contao und beginne wieder bei Schritt 3.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/contao
Prüfen: Die Ausgabe beginnt mit Contao Managed Edition 5.7.
sudo -u www-data vendor/bin/contao-console --version
7. Datenbank-Bibliothek auf Version 4.4 festhalten
Contao spricht über die Bibliothek Doctrine DBAL mit der Datenbank. Mit deren Version 4.5 (Stand September 2026) scheitert die Einrichtung der Tabellen in Schritt 13 an der Tabelle tl_message_queue mit dem Fehler You have an error in your SQL syntax … near ''. Das betrifft Contao 5.7 und 6.0 gleichermaßen. Mit Version 4.4 läuft alles fehlerfrei.
Der Befehl trägt die Einschränkung in die Datei composer.json ein und tauscht die Bibliothek aus.
sudo -u www-data composer require "doctrine/dbal:~4.4.0" --with-all-dependencies
Prüfen: Die Ausgabe enthält Downgrading doctrine/dbal (4.5.0 => 4.4.5) oder eine ähnliche Zeile mit 4.4.
Wie man die Einschränkung später wieder aufhebt, steht im Abschnitt „Aktualisieren“.
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
8. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis. Contao erwartet genau diese Einstellung.
sudo mariadb -e "CREATE DATABASE contao CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
Prüfen: Der Befehl gibt nichts aus. Eine Fehlermeldung erscheint nur, wenn etwas schiefgeht.
9. Datenbankbenutzer anlegen
Contao meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 11. Verwende nur Buchstaben, Ziffern, - und _. Zeichen wie @, :, / oder # stören in Schritt 11, weil das Passwort dort Teil einer Adresse ist.
sudo mariadb -e "CREATE USER 'contao'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
10. Dem Benutzer die Datenbank freigeben
Der Benutzer darf nur in der Datenbank contao arbeiten, dort aber alles.
sudo mariadb -e "GRANT ALL PRIVILEGES ON contao.* TO 'contao'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `contao`.* TO `contao`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'contao'@'localhost';"
Contao einrichten
11. Datenbankverbindung eintragen
Eigene Einstellungen stehen in der Datei .env.local. Composer hat sie in Schritt 5 schon mit einem geheimen Schlüssel (APP_SECRET) angelegt.
sudo nano .env.local
Drücke Strg+Ende, um ans Ende der Datei zu springen, und füge in einer neuen Zeile ein (Strg+Umschalt+V):
DATABASE_URL=mysql://contao:geheimes_passwort@localhost:3306/contao
Die Adresse ist so aufgebaut: mysql://BENUTZER:PASSWORT@RECHNER:PORT/DATENBANK. Setze statt geheimes_passwort dein Passwort aus Schritt 9 ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Datei mit dem Passwort schützen
Die Datei ist zunächst für alle Benutzer des Rechners lesbar. Danach darf nur noch www-data sie lesen.
sudo chmod 600 .env.local
Prüfen: Die Zeile beginnt mit -rw------- und nennt zweimal www-data.
ls -l .env.local
13. Tabellen anlegen
contao:migrate legt alle Tabellen in der Datenbank an. Denselben Befehl brauchst du auch nach jedem Update. Vorher sichert Contao die Datenbank automatisch in den Ordner var/backups.
sudo -u www-data vendor/bin/contao-console contao:migrate -n
-n beantwortet die Sicherheitsfrage „Execute the listed database updates?“ automatisch mit Ja.
Prüfen: Die letzte Zeile lautet [OK] All migrations completed. Ein zweiter Aufruf meldet nur noch Database dump skipped because there are no migrations to execute. und [OK] All migrations completed., ohne Pending database migrations.
14. Administratorkonto anlegen
Legt das erste Konto für die Verwaltung an. --language=de stellt die Verwaltung für dieses Konto auf Deutsch, --admin gibt ihm alle Rechte. Setze deinen Namen, deine E-Mail-Adresse und ein eigenes Passwort ein. Das Passwort landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung in der Verwaltung unter „Profil“.
sudo -u www-data vendor/bin/contao-console contao:user:create -n --username=admin --name="Dein Name" --email=admin@example.com --password='Ein-langes-Passwort-2026' --language=de --admin
Prüfen: Die Ausgabe lautet [OK] User admin with admin permissions created.
nginx einrichten
15. Konfiguration für Contao anlegen
sudo nano /etc/nginx/sites-available/contao
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8094;
server_name localhost;
root /var/www/contao/public;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ ^/(index|preview)\.php(/|$) {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/contao/public– nur der Unterordnerpublicist über das Web erreichbar. Einstellungen, Bibliotheken und Sicherungen liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an Contao, auch die Verwaltung unter/contao.- Contao braucht nur die beiden PHP-Dateien
index.phpundpreview.php(für die Vorschau in der Verwaltung). Alle anderen PHP-Dateien liefert nginx nicht aus (return 404). - Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/contao /etc/nginx/sites-enabled/contao
17. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
18. nginx neu laden
sudo systemctl reload nginx
Contao verwenden
19. An der Verwaltung anmelden
Öffne http://localhost:8094/contao im Browser und melde dich mit dem Benutzernamen und Passwort aus Schritt 14 an. Die Anmeldeseite erscheint in der Sprache deines Browsers.
Prüfen: Die Startseite der Verwaltung zeigt „Willkommen bei Contao!“. Links stehen die Bereiche „Inhalte“, „Layout“, „Benutzerverwaltung“ und „System“.
Die Website selbst unter http://localhost:8094 zeigt noch einen Fehler („Not Found“). Das ist richtig: Es gibt noch keine Seite. Die legen die nächsten Schritte an.
20. Theme und Seitenlayout anlegen
Ein Theme bündelt das Aussehen der Website, ein Seitenlayout legt fest, welche Bereiche eine Seite hat (Kopf, Spalten, Fuß).
- Klicke links unter Layout auf Themes und dann oben auf Neu.
- Gib als Titel
Mein Themeund als Autor deinen Namen ein und klicke auf Speichern und schließen. - Klicke in der Zeile von „Mein Theme“ auf das Symbol Seitenlayouts und dann auf Neu.
- Gib als Titel
Standardein. Lass Art des Layouts auf „Standardlayout“. Unter „Eingebundene Elemente“ ist „Artikel“ in der Hauptspalte schon eingetragen. - Klicke auf Speichern und schließen.
21. Startpunkt der Website anlegen
Jede Website in Contao beginnt mit einer Seite vom Typ „Startpunkt einer Webseite“. Sie legt Sprache, Adresse und Layout für alle Seiten darunter fest.
- Klicke links unter Inhalte auf Seiten und dann oben auf Neu. Contao zeigt jetzt Einfüge-Symbole: Klicke auf das Symbol neben dem obersten Eintrag des Seitenbaums („Einfügen in“).
- Seitenname:
Meine Website - Seitentyp: „Startpunkt einer Webseite“
- Sprache:
de - Protokoll:
http://– wichtig, weil die Website hier ohne HTTPS läuft. Mithttps://leitet Contao aufhttps://localhostum, und der Browser meldet einen Fehler. - Setze die Haken bei Sprachen-Fallback und Ein Layout zuweisen und wähle als Seitenlayout „Standard“.
- Setze den Haken bei Seite veröffentlichen.
- Klicke auf Speichern und schließen.
22. Startseite anlegen
- Klicke wieder auf Neu und dann beim Eintrag „Meine Website“ auf das Symbol Einfügen in. So wird die neue Seite eine Unterseite des Startpunkts.
- Seitenname:
Startseite, Seitentyp: „Reguläre Seite“. - Setze den Haken bei Seite veröffentlichen und klicke auf Speichern und schließen.
Contao legt für die neue Seite automatisch einen leeren Artikel mit dem gleichen Namen an. Artikel sind die Behälter für die eigentlichen Inhalte.
23. Text auf die Startseite schreiben
- Klicke links unter Inhalte auf Artikel.
- Klicke beim Artikel „Startseite“ auf das Bearbeiten-Symbol (Stift) und dann auf Neu.
- Elementtyp: „Text“. Gib eine Überschrift und einen Text ein.
- Klicke auf Speichern und schließen.
24. Website ansehen
Öffne http://localhost:8094 im Browser. Contao leitet auf die Adresse der Startseite weiter, z. B. http://localhost:8094/startseite.
Prüfen: Überschrift und Text aus Schritt 23 erscheinen. Im Tab des Browsers steht „Startseite - Meine Website“. Das Aussehen ist noch schlicht, weil das Theme keine eigenen Stylesheets hat.
Aktualisieren
Contao wird mit Composer aktualisiert. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/contao. Eine Sicherung der Datenbank erzeugt sudo -u www-data vendor/bin/contao-console contao:backup:create.
1. In den Projektordner wechseln
cd /var/www/contao
2. Pakete aktualisieren
Aktualisiert Contao innerhalb der Version 5.7 und alle Bibliotheken. Am Ende richtet Contao den Zwischenspeicher neu ein.
sudo -u www-data composer update
Prüfen: Die letzte Zeile lautet No security vulnerability advisories found.
3. Datenbank anpassen
Neue Versionen bringen manchmal neue oder geänderte Tabellen mit.
sudo -u www-data vendor/bin/contao-console contao:migrate -n
Prüfen: sudo -u www-data vendor/bin/contao-console --version zeigt die neue Versionsnummer.
Einschränkung für Doctrine DBAL aufheben
Sobald Contao den Fehler aus Schritt 7 behoben hat, entfernst du die Einschränkung wieder. Der erste Befehl löscht sie aus composer.json, der zweite zeigt ohne Änderungen, ob die Datenbank danach noch zu Contao passt:
sudo -u www-data composer remove doctrine/dbal
Die Meldung Removal failed, doctrine/dbal is still present ist hier richtig: Contao braucht die Bibliothek weiterhin, nur die Einschränkung auf 4.4 ist weg. Darüber steht Upgrading doctrine/dbal (4.4.5 => …).
sudo -u www-data vendor/bin/contao-console contao:migrate -n --dry-run
Enthält die Ausgabe wieder ALTER TABLE tl_message_queue ENGINE = ohne Wert dahinter, ist der Fehler noch nicht behoben. Setze die Einschränkung dann mit Schritt 7 wieder.
Den Sprung auf eine neue Hauptversion (z. B. 6.0) macht man, indem man in composer.json die Versionsangaben ändert. Lies dafür vorher die Hinweise unter https://docs.contao.org.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/contao
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/contao
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Contao-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien und die Datenbanksicherungen in var/backups gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/contao
5. Composer-Zwischenspeicher von www-data löschen
Nur wenn keine andere Anleitung (z. B. TYPO3) ihn noch braucht.
sudo rm -r /var/www/.cache
6. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS contao;"
7. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'contao'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8094
8. MariaDB und Composer entfernen (optional)
Nur wenn kein anderes Programm MariaDB oder Composer braucht. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql composer
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB und Composer mitinstalliert wurden (z. B. galera-4, php-symfony-console). Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.contao.org/
- Lizenz: Contao steht unter der LGPL-3.0-or-later.
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.
Neos
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neos ist ein Open-Source-Content-Management-System aus dem Umfeld von TYPO3. Redakteure bearbeiten Texte und Bilder direkt in der Vorschau der Seite und sehen sofort, wie sie aussehen. Änderungen landen zuerst in einem persönlichen Arbeitsbereich und gehen erst nach dem Veröffentlichen online. Neos steht unter der freien Lizenz GPL-3.0.
Vorbemerkungen
- Kein apt-Paket: Neos ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Neos 9 speichert Inhalte nur in MariaDB oder MySQL. Mit PostgreSQL bricht die Einrichtung mit
Cannot build content graph for non mariadb/mysql connectionab. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit. - Voraussetzung: nginx ist installiert und läuft.
- Adresse: Neos läuft hier unter http://localhost:8095, nur vom eigenen Rechner aus erreichbar. Die Verwaltung liegt unter
/neos. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die Neos-Befehle laufen alswww-data. - Betriebsart: Neos kennt die Betriebsarten („Kontexte“)
DevelopmentundProduction. Diese Anleitung verwendetProduction: schneller und ohne technische Fehlerdetails auf der Website. Deshalb beginnen alle Neos-Befehle mitFLOW_CONTEXT=Production, und nginx gibt denselben Wert an PHP weiter. - Version: Getestet mit Neos 9.1.9, PHP 8.5, Composer 2.9 und MariaDB 11.8 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP, Erweiterungen und Composer installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gdbearbeitet Bilder (Vorschaubilder, Zuschnitte).intl,zip,xml,mbstringundcurlbraucht Neos für Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt Neos und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
3. Ordner für Neos und den Composer-Zwischenspeicher anlegen
/var/www/neos nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache. -p verhindert einen Fehler, falls .cache von einer anderen Anleitung schon existiert.
sudo mkdir -p /var/www/neos /var/www/.cache
4. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/neos /var/www/.cache
Neos herunterladen
5. Neos-Projekt anlegen
create-project lädt die Grundausstattung neos/neos-base-distribution in Version 9.1 samt aller Bibliotheken nach /var/www/neos. Dazu gehört die Demo-Website Neos.Demo. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project neos/neos-base-distribution /var/www/neos "^9.1"
Das Herunterladen dauert einige Minuten.
Prüfen: Die Ausgabe endet mit Please configure your database in the settings … und Neos setup not complete. Das ist richtig, die Datenbank folgt in den nächsten Schritten.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/neos
Prüfen: Die erste Zeile endet mit 9.1.9 ("Production" context) oder einer neueren Version.
sudo -u www-data FLOW_CONTEXT=Production ./flow help | head -1
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
7. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis.
sudo mariadb -e "CREATE DATABASE neos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
8. Datenbankbenutzer anlegen
Neos meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 10.
sudo mariadb -e "CREATE USER 'neos'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
9. Dem Benutzer die Datenbank freigeben
sudo mariadb -e "GRANT ALL PRIVILEGES ON neos.* TO 'neos'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `neos`.* TO `neos`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'neos'@'localhost';"
Neos einrichten
10. Einstellungen anlegen
Eigene Einstellungen stehen in Configuration/Settings.yaml. Sie gelten für alle Betriebsarten.
sudo nano Configuration/Settings.yaml
Füge diesen Inhalt ein (Strg+Umschalt+V) und setze bei password dein Passwort aus Schritt 8 ein:
Neos:
Flow:
persistence:
backendOptions:
driver: pdo_mysql
host: localhost
dbname: neos
user: neos
password: geheimes_passwort
charset: utf8mb4
Neos:
userInterface:
defaultLanguage: de
persistence– die Verbindung zur Datenbank aus Schritt 7 bis 9.defaultLanguage: de– die Verwaltung erscheint auf Deutsch. Jeder Benutzer kann das später für sich ändern.
Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Einstellungsdatei dem Webserver-Benutzer übergeben
nano hat die Datei als root angelegt. Neos soll sie als www-data lesen.
sudo chown www-data:www-data Configuration/Settings.yaml
12. Datei mit dem Passwort schützen
Danach darf nur noch www-data die Datei lesen.
sudo chmod 600 Configuration/Settings.yaml
Prüfen: Die Zeile beginnt mit -rw------- und nennt zweimal www-data.
ls -l Configuration/Settings.yaml
13. Zwischenspeicher leeren
Neos liest geänderte Einstellungen erst nach dem Leeren des Zwischenspeichers. Das ist auch nach jeder späteren Änderung an Settings.yaml nötig.
sudo -u www-data FLOW_CONTEXT=Production ./flow flow:cache:flush
Prüfen: Die Ausgabe lautet Flushed all caches for "Production" context.
14. Tabellen anlegen
Legt die Tabellen für Benutzer, Medien und Einstellungen an.
sudo -u www-data FLOW_CONTEXT=Production ./flow doctrine:migrate
Prüfen: Die Ausgabe beginnt mit Migrating up to … und listet viele Zeilen mit CREATE TABLE. Ein zweiter Aufruf meldet nur noch Already at the latest version.
15. Content Repository einrichten
Das Content Repository speichert alle Seiten und Inhalte samt ihrer Änderungsgeschichte. Der Befehl legt die Tabellen dafür an.
sudo -u www-data FLOW_CONTEXT=Production ./flow cr:setup
Prüfen: Die Ausgabe lautet Content repository "default" was set up.
16. Demo-Website importieren
Importiert die Beispielwebsite mit Seiten, Bildern und einem Blog. Sie zeigt, was Neos kann, und dient als Vorlage für eigene Websites. Ihre Texte sind englisch.
sudo -u www-data FLOW_CONTEXT=Production ./flow site:importall --package-key Neos.Demo
Prüfen: Die Ausgabe endet mit Import finished.
17. Dateien der Website veröffentlichen
Kopiert Bilder, Stylesheets und Skripte in den Ordner Web/_Resources, aus dem nginx sie ausliefert.
sudo -u www-data FLOW_CONTEXT=Production ./flow resource:publish
Prüfen: Die Ausgabe endet mit einer Zeile wie Published 22.
18. Administratorkonto anlegen
Die Werte bedeuten der Reihe nach: Rolle, Benutzername, Passwort, Vorname, Nachname. Setze ein eigenes Passwort ein. Es landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung in der Verwaltung unter „Benutzereinstellungen“.
sudo -u www-data FLOW_CONTEXT=Production ./flow user:create --roles Administrator admin 'Ein-langes-Passwort-2026' Dein Name
Prüfen: Die Ausgabe lautet Created user "admin" and assigned the following role: Neos.Neos:Administrator.
nginx einrichten
19. Konfiguration für Neos anlegen
sudo nano /etc/nginx/sites-available/neos
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8095;
server_name localhost;
root /var/www/neos/Web;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri /index.php$is_args$args;
}
location = /index.php {
include snippets/fastcgi-php.conf;
fastcgi_param FLOW_CONTEXT Production;
fastcgi_param FLOW_REWRITEURLS 1;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/neos/Web– nur der UnterordnerWebist über das Web erreichbar. Einstellungen, Bibliotheken und Daten liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an Neos, auch die Verwaltung unter/neos.FLOW_CONTEXT Production– dieselbe Betriebsart wie bei den Befehlen.FLOW_REWRITEURLS 1– Neos erzeugt kurze Adressen wie/featuresstatt/index.php/features.- Neos braucht nur die Datei
index.php. Andere PHP-Dateien liefert nginx nicht aus (return 404). Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
20. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/neos /etc/nginx/sites-enabled/neos
21. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
22. nginx neu laden
sudo systemctl reload nginx
Neos verwenden
23. Website ansehen
Öffne http://localhost:8095 im Browser. Der erste Aufruf dauert etwa eine Sekunde, danach kommt die Seite aus dem Zwischenspeicher.
Prüfen: Die Demo-Website erscheint mit der Überschrift „Welcome to the Neos CMS 9.1 demo“ und einem Bild eines Bergsees.
24. An der Verwaltung anmelden
Öffne http://localhost:8095/neos und melde dich mit Benutzername und Passwort aus Schritt 18 an. Der Aufbau der Verwaltung dauert beim ersten Mal einige Sekunden.
Prüfen: Links stehen „Dokumentbaum“ und „Inhaltsbaum“, in der Mitte die Startseite, rechts die Eigenschaften der Seite. Oben rechts steht in Grün „Veröffentlicht - Public live workspace“.
25. Eine Seite bearbeiten und veröffentlichen
- Ändere rechts unter Dokument den Titel von „Home“ in
Startseite. - Klicke unten rechts auf Übernehmen. Die Änderung liegt jetzt in deinem persönlichen Arbeitsbereich. Besucher sehen sie noch nicht.
- Oben rechts steht jetzt Nach Public live workspace veröffentlichen mit der Zahl der Änderungen. Klicke darauf.
Texte in der Vorschau in der Mitte kannst du direkt anklicken und bearbeiten. Auch sie werden erst mit dem Veröffentlichen sichtbar.
Prüfen: Oben rechts steht wieder „Veröffentlicht - Public live workspace“. Lädst du http://localhost:8095 neu, steht im Menü „Startseite“.
Aktualisieren
Neos wird mit Composer aktualisiert. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/neos.
1. In den Projektordner wechseln
cd /var/www/neos
2. Pakete aktualisieren
Aktualisiert Neos innerhalb der Version 9.1 und alle Bibliotheken.
sudo -u www-data composer update
Prüfen: Die letzte Zeile lautet No security vulnerability advisories found.
3. Zwischenspeicher leeren
sudo -u www-data FLOW_CONTEXT=Production ./flow flow:cache:flush
4. Tabellen anpassen
Gibt es keine Änderungen, meldet der Befehl Already at the latest version.
sudo -u www-data FLOW_CONTEXT=Production ./flow doctrine:migrate
5. Content Repository anpassen
sudo -u www-data FLOW_CONTEXT=Production ./flow cr:setup
6. Dateien der Website neu veröffentlichen
sudo -u www-data FLOW_CONTEXT=Production ./flow resource:publish
Prüfen: sudo -u www-data FLOW_CONTEXT=Production ./flow help | head -1 zeigt die neue Versionsnummer.
Für den Sprung auf eine neue Neos-Version (z. B. 9.2) änderst du die Versionsangaben in composer.json. Lies dafür vorher die Hinweise unter https://docs.neos.io.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/neos
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/neos
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Neos-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/neos
5. Composer-Zwischenspeicher von www-data löschen
Nur wenn keine andere Anleitung (z. B. TYPO3 oder Contao) ihn noch braucht.
sudo rm -r /var/www/.cache
6. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS neos;"
7. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'neos'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8095
8. MariaDB und Composer entfernen (optional)
Nur wenn kein anderes Programm MariaDB oder Composer braucht, z. B. Contao. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql composer
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB und Composer mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.neos.io/
- Lizenz: Neos steht unter der GPL-3.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.
Concrete CMS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Concrete CMS ist ein Open-Source-Content-Management-System, bei dem man Seiten direkt im Browser bearbeitet: Man klickt auf einen Textblock, ändert ihn an Ort und Stelle und veröffentlicht die Seite. Neue Inhalte setzt man per Drag-and-drop als Blöcke auf die Seite. Concrete steht unter der freien MIT-Lizenz. Früher hieß es „concrete5“.
Vorbemerkungen
- Kein apt-Paket: Concrete ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Concrete läuft nur mit MariaDB oder MySQL. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit.
- Voraussetzung: nginx ist installiert und läuft.
- Adresse: Concrete läuft hier unter http://localhost:8096, nur vom eigenen Rechner aus erreichbar.
- Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die Concrete-Befehle laufen alswww-data. - Google Fonts: Das mitgelieferte Theme „Atomik“ lädt Schriften von Servern von Google. Dabei erfährt Google die IP-Adresse jedes Besuchers. Für eine öffentliche Website in der EU solltest du die Schriften selbst ausliefern oder ein anderes Theme verwenden.
- Version: Getestet mit Concrete 9.5.3, PHP 8.5, Composer 2.9 und MariaDB 11.8 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP, Erweiterungen und Composer installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gd,intl,zip,xml,mbstringundcurlbraucht Concrete für Bilder, Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt Concrete und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
3. Ordner für Concrete und den Composer-Zwischenspeicher anlegen
/var/www/concrete nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache. -p verhindert einen Fehler, falls .cache von einer anderen Anleitung schon existiert.
sudo mkdir -p /var/www/concrete /var/www/.cache
4. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/concrete /var/www/.cache
Concrete herunterladen
5. Concrete-Projekt anlegen
create-project lädt die offizielle Projektvorlage concretecms/composer mit der aktuellen Version 9 von Concrete nach /var/www/concrete. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project concretecms/composer /var/www/concrete
Prüfen: Die Ausgabe enthält mehrere Zeilen Applying patch … und endet mit No security vulnerability advisories found.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/concrete
Prüfen: Die Ausgabe lautet concrete 9.5.3 oder nennt eine neuere Version.
sudo -u www-data public/concrete/bin/concrete --version
Der Befehl vendor/bin/concrete, den manche Anleitungen nennen, bricht in dieser Projektvorlage mit Failed opening required …/concrete/dispatcher.php ab. Verwende immer public/concrete/bin/concrete.
7. Ordner für hochgeladene Dateien anlegen
Concrete speichert Bilder und Dokumente in public/application/files. Die Projektvorlage bringt den Ordner nicht mit. Ohne ihn bricht die Installation in Schritt 11 mit This directory must exist and it must be writable … application/files/ ab.
sudo -u www-data mkdir public/application/files
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
8. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis.
sudo mariadb -e "CREATE DATABASE concrete CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
9. Datenbankbenutzer anlegen
Concrete meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 11.
sudo mariadb -e "CREATE USER 'concrete'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
10. Dem Benutzer die Datenbank freigeben
sudo mariadb -e "GRANT ALL PRIVILEGES ON concrete.* TO 'concrete'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `concrete`.* TO `concrete`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'concrete'@'localhost';"
Concrete einrichten
11. Concrete installieren
c5:install prüft die Voraussetzungen, legt die Tabellen an, erzeugt das Administratorkonto und füllt die Website mit Beispielseiten. -n beantwortet alle Rückfragen automatisch. Passe vorher die Werte an:
--db-…– die Datenbank aus Schritt 8 bis 10. Setze bei--db-passworddein Passwort ein.--timezone– die Zeitzone für Datums- und Zeitangaben.--site– der Name der Website, er erscheint im Titel jeder Seite.--canonical-url– die Adresse der Website. Sie muss mit/enden.--starting-point=atomik_full– Beispielwebsite mit dem Theme „Atomik“, mehreren Seiten und einem Blog.atomik_blanklegt nur eine leere Startseite an.--admin-emailund--admin-password– die Anmeldedaten des Kontosadmin. Das Passwort landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung unter „Profil bearbeiten“.--languageund--site-locale– Sprache der Verwaltung und der Website.--disable-marketplace-connect– Concrete verbindet sich nicht automatisch mit dem Online-Marktplatz des Herstellers.
sudo -u www-data public/concrete/bin/concrete c5:install -n --db-server=localhost --db-username=concrete --db-password=geheimes_passwort --db-database=concrete --timezone=Europe/Berlin --site="Meine Website" --canonical-url=http://localhost:8096/ --starting-point=atomik_full --admin-email=admin@example.com --admin-password='Ein-langes-Passwort-2026' --language=de_DE --site-locale=de_DE --disable-marketplace-connect
Das dauert etwa eine halbe Minute. Die Ausgabe listet zuerst alle geprüften Voraussetzungen mit passed und dann den Fortschritt in Prozent.
Prüfen: Die letzte Zeile lautet Installation Complete!
Steht stattdessen One or more precondition failed! da, nennt eine Zeile ohne passed darüber die Ursache.
12. Datei mit dem Datenbankpasswort schützen
Concrete hat die Zugangsdaten in public/application/config/database.php geschrieben. Die Datei ist zunächst für alle Benutzer des Rechners lesbar. Danach darf nur noch www-data sie lesen. Über das Web ist sie nicht abrufbar, weil nginx außer index.php keine PHP-Dateien ausliefert (Schritt 16).
sudo chmod 600 public/application/config/database.php
13. Deutsches Sprachpaket installieren
Die Übersetzungen sind nicht in Concrete enthalten. Der Befehl lädt sie für Deutsch herunter und legt sie in public/application/languages/de_DE ab.
sudo -u www-data public/concrete/bin/concrete c5:language-install --add de_DE
Prüfen: Die Ausgabe enthält Adding language de_DE und Number of language files added: 1.
14. Kurze Adressen einschalten
Ohne diese Einstellung enthalten alle Adressen index.php, z. B. http://localhost:8096/index.php/about. Danach heißen sie http://localhost:8096/about. Die nginx-Konfiguration in Schritt 16 leitet solche Adressen an Concrete weiter.
sudo -u www-data public/concrete/bin/concrete c5:config set concrete.seo.url_rewriting true
15. Zwischenspeicher leeren
Damit Concrete die neue Sprache und die kurzen Adressen sofort verwendet.
sudo -u www-data public/concrete/bin/concrete c5:clear-cache
Prüfen: Die Ausgabe lautet Clearing the cache... done.
nginx einrichten
16. Konfiguration für Concrete anlegen
sudo nano /etc/nginx/sites-available/concrete
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8096;
server_name localhost;
root /var/www/concrete/public;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location = /index.php {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/concrete/public– nur der Unterordnerpublicist über das Web erreichbar. Bibliotheken und Composer-Dateien liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an Concrete. Hochgeladene Bilder inapplication/filesliefert nginx direkt aus.- Concrete braucht nur die Datei
index.php. Alle anderen PHP-Dateien, auch die Einstellungen inapplication/config, liefert nginx nicht aus (return 404). Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
17. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/concrete /etc/nginx/sites-enabled/concrete
18. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
19. nginx neu laden
sudo systemctl reload nginx
Concrete verwenden
20. Website ansehen
Öffne http://localhost:8096 im Browser.
Prüfen: Die Beispielwebsite erscheint mit dem Schriftzug „MEINE WEBSITE“ oben links und den Menüpunkten „Info“, „Ressourcen“ und „Dokumente“. Die Texte der Beispielseiten sind englisch. Der Tab des Browsers zeigt „Home :: Meine Website“.
21. Anmelden
Öffne http://localhost:8096/login und melde dich mit dem Benutzernamen admin und dem Passwort aus Schritt 11 an.
Danach fragt ein Dialog „Tell us a little about your site“, wofür du Concrete verwendest. Send schickt die Antworten an den Hersteller. Klicke auf Skip, dann erscheint der Dialog nicht wieder.
Prüfen: Oben erscheint die Werkzeugleiste von Concrete mit einem Stift, einem Zahnrad und einem Pluszeichen links und einer Suche rechts.
22. Einen Text bearbeiten und veröffentlichen
- Öffne die Seite http://localhost:8096/about. Im Menü der Website heißt sie „Info“.
- Klicke oben links in der Werkzeugleiste auf den Stift. Die Seite wechselt in den Bearbeitungsmodus, alle Blöcke bekommen einen Rahmen. Beim ersten Mal erscheint eine Einführung, die du mit Got It! schließt.
- Klicke auf einen Textblock, z. B. „WHAT WE DO“, und wähle im Menü Block bearbeiten.
- Ändere den Text direkt auf der Seite. Über der Seite erscheint eine Leiste zum Formatieren. Klicke dort auf OK.
- Klicke oben links wieder auf den Stift. Es öffnet sich eine Leiste mit Veröffentlichen, Änderungen speichern und Änderungen verwerfen. Klicke auf Veröffentlichen.
„Änderungen speichern“ sichert die Änderungen als Entwurf, ohne sie Besuchern zu zeigen. Mit dem Pluszeichen in der Werkzeugleiste fügst du im Bearbeitungsmodus neue Blöcke wie Text, Bild oder Formular hinzu.
Prüfen: Öffne http://localhost:8096/about in einem privaten Fenster (Strg+Umschalt+P in Firefox, Strg+Umschalt+N in Chrome). Dort bist du nicht angemeldet und siehst die Seite wie ein Besucher, mit deinem geänderten Text.
Aktualisieren
Concrete wird mit Composer aktualisiert. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/concrete.
1. In den Projektordner wechseln
cd /var/www/concrete
2. Pakete aktualisieren
Aktualisiert Concrete innerhalb der Version 9 und alle Bibliotheken.
sudo -u www-data composer update
Prüfen: Die letzte Zeile lautet No security vulnerability advisories found.
3. Datenbank anpassen
c5:update passt die Tabellen an die neue Version an. Gibt es nichts zu tun, gibt der Befehl nichts aus.
sudo -u www-data public/concrete/bin/concrete c5:update -n
4. Sprachpaket aktualisieren
sudo -u www-data public/concrete/bin/concrete c5:language-install --update
5. Zwischenspeicher leeren
sudo -u www-data public/concrete/bin/concrete c5:clear-cache
Prüfen: sudo -u www-data public/concrete/bin/concrete --version zeigt die neue Versionsnummer.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/concrete
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/concrete
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Concrete-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/concrete
5. Composer-Zwischenspeicher von www-data löschen
Nur wenn keine andere Anleitung (z. B. TYPO3, Contao oder Neos) ihn noch braucht.
sudo rm -r /var/www/.cache
6. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS concrete;"
7. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'concrete'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8096
8. MariaDB und Composer entfernen (optional)
Nur wenn kein anderes Programm MariaDB oder Composer braucht, z. B. Contao oder Neos. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql composer
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB und Composer mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://documentation.concretecms.org/
- Lizenz: Concrete CMS steht unter der MIT.
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.
Bolt CMS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Bolt ist ein schlankes Open-Source-Content-Management-System auf Basis des PHP-Frameworks Symfony. Welche Inhaltstypen es gibt (Seiten, Blogeinträge, Produkte …) und welche Felder sie haben, legt man in einer übersichtlichen YAML-Datei fest. Das Aussehen bestimmen Twig-Vorlagen. Bolt steht unter der freien MIT-Lizenz.
Vorbemerkungen
- Kein apt-Paket: Bolt ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Diese Anleitung verwendet SQLite, die Voreinstellung von Bolt. Die ganze Datenbank ist dann eine Datei im Projektordner, ein Datenbankserver ist nicht nötig. Das reicht für kleine und mittlere Websites. Mit PostgreSQL bricht die Einrichtung von Bolt 6 ab (
Schema »public« existiert bereits). - Voraussetzung: nginx ist installiert und läuft.
- Adresse: Bolt läuft hier unter http://localhost:8097, nur vom eigenen Rechner aus erreichbar. Die Verwaltung liegt unter
/bolt. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die Bolt-Befehle laufen alswww-data. - Datenschutz: Das mitgelieferte Theme lädt Schriften von Google Fonts, ein Skript von jsDelivr und bindet eine Karte von Google Maps ein. Dabei erfahren diese Dienste die IP-Adresse jedes Besuchers. Für eine öffentliche Website in der EU solltest du ein eigenes Theme verwenden oder diese Teile entfernen.
- Version: Getestet mit Bolt 6.1.8, Symfony 6.4, PHP 8.5, Composer 2.9 und SQLite 3.46 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und Composer installieren
php-fpmführt PHP-Dateien für nginx aus,php-sqlite3verbindet PHP mit SQLite.gd,intl,zip,xml,mbstringundcurlbraucht Bolt für Bilder, Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt Bolt und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install php-fpm php-sqlite3 php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe enthält pdo_sqlite und sqlite3.
php -m | grep -i sqlite
3. PHP-FPM neu laden
PHP-FPM läuft schon, falls eine andere Anleitung es installiert hat. Damit es die neue SQLite-Erweiterung kennt, muss es neu geladen werden.
sudo systemctl reload php8.5-fpm
4. Ordner für Bolt und den Composer-Zwischenspeicher anlegen
/var/www/bolt nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache. -p verhindert einen Fehler, falls .cache von einer anderen Anleitung schon existiert.
sudo mkdir -p /var/www/bolt /var/www/.cache
5. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/bolt /var/www/.cache
Bolt herunterladen
6. Bolt-Projekt anlegen
create-project lädt die offizielle Projektvorlage bolt/project samt aller Bibliotheken nach /var/www/bolt. Dabei erzeugt Bolt einen geheimen Schlüssel (APP_SECRET) in der Datei .env. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project bolt/project /var/www/bolt
Das Herunterladen dauert einige Minuten.
Prüfen: Die Ausgabe enthält No security vulnerability advisories found. und endet mit Running composer "post-create-project-cmd" scripts.
7. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/bolt
8. Produktionsmodus einstellen
Bolt startet im Entwicklungsmodus (dev). Er zeigt Besuchern bei Fehlern technische Details und ist langsamer. Eigene Einstellungen gehören in die Datei .env.local.
sudo nano .env.local
Die Datei enthält nur Kommentare mit Beispielen. Drücke Strg+Ende, um ans Ende zu springen, und füge in einer neuen Zeile ein:
APP_ENV=prod
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe endet mit (env: prod, debug: false).
sudo -u www-data bin/console --version
Bolt einrichten
9. Datenbank, Konto und Beispielinhalte anlegen
bolt:setup legt die SQLite-Datenbank in var/data/bolt.sqlite an, erzeugt die Tabellen und einen neuen geheimen Schlüssel. --fixtures füllt die Website mit Beispielseiten, Blogeinträgen und Bildern. Die Bilder lädt Bolt dafür von einem Server des Projekts herunter.
sudo -u www-data bin/console bolt:setup --fixtures
Bolt fragt nacheinander nach dem ersten Konto. Es bekommt die höchste Rolle „Developer“ und darf alles.
Username– dein Benutzername, z. B.admin.Password (input is hidden)– dein Passwort. Die Eingabe bleibt unsichtbar. Drückst du nur Enter, setzt Bolt ein zufälliges Passwort, das du nicht kennst. Gib also unbedingt ein eigenes ein.Email– deine E-Mail-Adresse.Display Name– der Name, der in der Verwaltung erscheint.
Prüfen: Die Ausgabe enthält User was successfully created und endet mit Bolt was set up successfully!. Der Hinweis auf server:start darunter betrifft den eingebauten Testserver, den du hier nicht brauchst.
Die Beispielinhalte legen zusätzlich fünf Demo-Konten an (z. B. jane_chief, tom_admin). Sie haben zufällige Passwörter, die niemand kennt. Lösche sie nicht, solange die Beispielinhalte da sind: Die Inhalte verweisen auf sie als Autoren, und die Startseite zeigt sonst einen Fehler.
10. Zwischenspeicher neu aufbauen
Das Setup hinterlässt einen unvollständigen Zwischenspeicher. Ohne diesen Schritt zeigt die Startseite einen Fehler (500 :: Internal Server Error).
sudo -u www-data bin/console cache:clear
Prüfen: Die Ausgabe lautet Cache for the "prod" environment (debug=false) was successfully cleared.
11. Datenbankdatei schützen
Die Datenbank enthält unter anderem die Passwort-Hashes der Konten und ist zunächst für alle Benutzer des Rechners lesbar. Danach darf nur noch www-data sie lesen und schreiben. Über das Web ist sie nicht erreichbar, weil sie außerhalb des Ordners public liegt.
sudo chmod 600 var/data/bolt.sqlite
nginx einrichten
12. Konfiguration für Bolt anlegen
sudo nano /etc/nginx/sites-available/bolt
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8097;
server_name localhost;
root /var/www/bolt/public;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri /index.php$is_args$args;
}
location = /index.php {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/bolt/public– nur der Unterordnerpublicist über das Web erreichbar. Einstellungen, Datenbank und Bibliotheken liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an Bolt, auch die Verwaltung unter/bolt. Bilder inpublic/filesundpublic/thumbsliefert nginx direkt aus.- Bolt braucht nur die Datei
index.php. Andere PHP-Dateien liefert nginx nicht aus (return 404). Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/bolt /etc/nginx/sites-enabled/bolt
14. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
15. nginx neu laden
sudo systemctl reload nginx
Bolt verwenden
16. Website ansehen
Öffne http://localhost:8097 im Browser.
Prüfen: Die Beispielwebsite erscheint mit der Überschrift „Welcome to your new site“ und darunter „Introduction“. Die übrigen Texte sind Blindtext in Pseudo-Latein.
17. An der Verwaltung anmelden
Öffne http://localhost:8097/bolt und melde dich mit Benutzername und Passwort aus Schritt 9 an.
Prüfen: Das Dashboard begrüßt dich mit „Hey, Dein Name!“. Links stehen die Inhaltstypen „Homepage“, „Pages“, „Entries“, „People“, „Blocks“ und „Products“ und darunter „Configuration“, „Maintenance“ und „File management“.
18. Verwaltung auf Deutsch umstellen
Die Sprache der Verwaltung stellt jeder Benutzer für sich ein.
- Klicke oben rechts auf deinen Namen und dann auf Edit Profile, oder öffne http://localhost:8097/bolt/profile-edit.
- Wähle im Feld Locale den Eintrag 🇩🇪 German (Deutsch, de).
- Klicke auf Save changes.
Prüfen: Menüpunkte wie „Konfiguration“, „Wartung“ und „Dateiverwaltung“ sind jetzt deutsch. Die Namen der Inhaltstypen („Pages“, „Entries“ …) bleiben englisch. Sie stehen in config/bolt/contenttypes.yaml und lassen sich dort mit name und singular_name umbenennen.
Ändere nicht die Einstellung locale in config/services.yaml auf de: Die Inhaltstypen der Vorlage kennen die Sprache de nicht, und die Startseite leitet dann endlos auf sich selbst um.
19. Eine Seite bearbeiten
- Klicke links auf Homepage. Der Inhaltstyp hat nur einen Eintrag, deshalb öffnet sich gleich der Editor.
- Ändere das Feld Title.
- Klicke rechts auf Speichern.
Über Vorschau siehst du die Seite vor dem Speichern. Unter Status legst du fest, ob ein Eintrag veröffentlicht, ein Entwurf oder zurückgezogen ist.
Prüfen: Lädst du http://localhost:8097 neu, steht der geänderte Titel auf der Startseite.
Aktualisieren
Bolt wird mit Composer aktualisiert. Lege vorher eine Sicherung des Ordners /var/www/bolt an. Darin liegt auch die Datenbank (var/data/bolt.sqlite).
1. In den Projektordner wechseln
cd /var/www/bolt
2. Pakete aktualisieren
Aktualisiert Bolt und alle Bibliotheken innerhalb der erlaubten Versionen. Danach passt Bolt die Datenbank an und kopiert neue Dateien für die Verwaltung nach public.
sudo -u www-data composer update
Prüfen: Die Ausgabe enthält No security vulnerability advisories found.
3. Zwischenspeicher neu aufbauen
sudo -u www-data bin/console cache:clear
Prüfen: Die Ausgabe enthält Bolt version: mit der neuen Versionsnummer.
sudo -u www-data bin/console bolt:info
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/bolt
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/bolt
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Bolt löschen
Achtung: Damit sind auch die Datenbank mit allen Inhalten und Konten und alle hochgeladenen Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/bolt
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8097
5. Composer-Zwischenspeicher von www-data löschen
Nur wenn keine andere Anleitung (z. B. TYPO3, Contao oder Neos) ihn noch braucht.
sudo rm -r /var/www/.cache
6. SQLite-Erweiterung und Composer entfernen (optional)
Nur wenn kein anderes Programm sie braucht. PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge php-sqlite3 composer
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden (z. B. php8.5-sqlite3, php-symfony-console). Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.bolt.cm/
- Lizenz: Bolt CMS steht unter der MIT.
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.
Backdrop CMS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Backdrop CMS ist ein Open-Source-Content-Management-System für kleine und mittlere Organisationen wie Vereine, Schulen oder Firmen. Es ist aus Drupal 7 hervorgegangen, bleibt aber bewusst einfacher und sparsamer im Betrieb. Beiträge, Seiten, Menüs, Layouts und Benutzerrechte verwaltet man im Browser. Backdrop steht unter der freien Lizenz GPL-2.0.
Vorbemerkungen
- Kein apt-Paket: Backdrop ist nicht in den Ubuntu-Paketquellen enthalten. Es wird als ZIP-Datei von GitHub heruntergeladen und über ein mitgeliefertes Skript installiert. Composer ist nicht nötig. PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Backdrop läuft nur mit MariaDB oder MySQL. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit.
- Voraussetzung: nginx ist installiert und läuft.
- Adresse: Backdrop läuft hier unter http://localhost:8098, nur vom eigenen Rechner aus erreichbar. Rufe es immer über
localhostauf und nicht über127.0.0.1: Schritt 15 lässt nur diesen Namen zu, alles andere beantwortet Backdrop mit einem Fehler. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch das Installationsskript läuft alswww-data. - Version: Getestet mit Backdrop 1.35.1, PHP 8.5 und MariaDB 11.8 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP und Erweiterungen installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gd,intl,zip,xml,mbstringundcurlbraucht Backdrop für Bilder, Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.unzipentpackt die ZIP-Datei von Backdrop.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl unzip
Prüfen: Die Ausgabe enthält 11.8 und MariaDB.
mariadb --version
3. PHP-FPM neu laden
PHP-FPM läuft schon, falls eine andere Anleitung es installiert hat. Damit es die neue MariaDB-Erweiterung kennt, muss es neu geladen werden.
sudo systemctl reload php8.5-fpm
Backdrop herunterladen
4. ZIP-Datei herunterladen
Lädt Backdrop 1.35.1 von GitHub in den Ordner /tmp. Die aktuelle Version findest du unter https://github.com/backdrop/backdrop/releases. Ersetze dann in diesem und dem nächsten Befehl die Versionsnummer.
cd /tmp && wget https://github.com/backdrop/backdrop/releases/download/1.35.1/backdrop.zip
Prüfen: Die letzte Zeile enthält ‘backdrop.zip’ gespeichert.
5. Nach /var/www entpacken
Die ZIP-Datei enthält einen Ordner backdrop. -d /var/www legt ihn dort ab, er heißt dann /var/www/backdrop. -q unterdrückt die lange Liste der entpackten Dateien.
sudo unzip -q backdrop.zip -d /var/www
6. ZIP-Datei löschen
rm backdrop.zip
7. Dateien dem Webserver-Benutzer übergeben
-R ändert den Eigentümer aller Dateien und Unterordner. Backdrop muss in den Ordner files schreiben und schreibt bei der Installation auch settings.php.
sudo chown -R www-data:www-data /var/www/backdrop
Deutsche Übersetzung bereitstellen
Das Installationsskript kann Deutsch nur einrichten, wenn die Übersetzungsdatei schon im Ordner liegt.
8. Ordner für Übersetzungen anlegen
sudo -u www-data mkdir /var/www/backdrop/files/translations
9. Deutsche Übersetzung herunterladen
Lädt die Übersetzung vom Übersetzungsserver des Backdrop-Projekts. 1.x steht für alle Versionen der Reihe 1.
sudo -u www-data wget -O /var/www/backdrop/files/translations/backdropcms-1.x.de.po https://localize.backdropcms.org/files/l10n_packager/all/backdropcms/backdropcms-1.x.de.po
Prüfen: Die Datei ist knapp 1 MB groß (etwa 939843).
ls -l /var/www/backdrop/files/translations
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
10. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis.
sudo mariadb -e "CREATE DATABASE backdrop CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
11. Datenbankbenutzer anlegen
Backdrop meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 14. Verwende nur Buchstaben, Ziffern, - und _, weil das Passwort in Schritt 14 Teil einer Adresse ist.
sudo mariadb -e "CREATE USER 'backdrop'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
12. Dem Benutzer die Datenbank freigeben
sudo mariadb -e "GRANT ALL PRIVILEGES ON backdrop.* TO 'backdrop'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `backdrop`.* TO `backdrop`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'backdrop'@'localhost';"
Backdrop einrichten
13. In den Backdrop-Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/backdrop
14. Backdrop installieren
Das Skript install.sh legt die Tabellen an, schreibt die Datenbankverbindung in settings.php, erzeugt das Administratorkonto und importiert die deutsche Übersetzung. Es ist ein PHP-Skript und wird deshalb mit php aufgerufen. Passe vorher die Werte an:
--db-url– die Datenbank aus Schritt 10 bis 12, aufgebaut alsmysql://BENUTZER:PASSWORT@RECHNER/DATENBANK. Setze dein Passwort ein.--account-name,--account-passund--account-mail– die Anmeldedaten für die Verwaltung. Das Passwort landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung unter „Mein Konto“ → „Bearbeiten“. Ohne--account-passerzeugt das Skript ein zufälliges Passwort, das es nicht anzeigt.--site-nameund--site-mail– Name der Website und Absender für E-Mails der Website.--langcode=de– Deutsch als Sprache der Website und der Verwaltung.
sudo -u www-data php core/scripts/install.sh --db-url=mysql://backdrop:geheimes_passwort@localhost/backdrop --account-name=admin --account-pass='Ein-langes-Passwort-2026' --account-mail=admin@example.com --site-name="Meine Website" --site-mail=admin@example.com --langcode=de
Das dauert etwa 20 Sekunden.
Prüfen: Die Ausgabe lautet Backdrop installed successfully.
15. Erlaubte Adresse festlegen
Backdrop beantwortet sonst Anfragen mit jedem beliebigen Rechnernamen. Das kann ein Angreifer ausnutzen, etwa um gefälschte Links in E-Mails zum Zurücksetzen von Passwörtern unterzubringen. Der Statusbericht warnt deshalb, solange die Einstellung fehlt.
sudo nano settings.php
Drücke Strg+Ende, um ans Ende der Datei zu springen, und füge in einer neuen Zeile ein:
$settings['trusted_host_patterns'] = array('^localhost(:8098)?$');
Das Muster erlaubt localhost mit und ohne Port 8098. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. settings.php schützen
Die Datei enthält das Datenbankpasswort. Danach darf nur noch www-data sie lesen, und niemand darf sie ändern. Über das Web ist sie nicht abrufbar, weil nginx außer den Einstiegsdateien von Backdrop keine PHP-Dateien ausliefert (Schritt 17).
sudo chmod 400 settings.php
Prüfen: Die Zeile beginnt mit -r-------- und nennt zweimal www-data.
ls -l settings.php
Willst du settings.php später ändern, gib vorher mit sudo chmod 600 settings.php das Schreibrecht zurück und setze es danach wieder auf 400.
nginx einrichten
17. Konfiguration für Backdrop anlegen
sudo nano /etc/nginx/sites-available/backdrop
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8098;
server_name localhost;
root /var/www/backdrop;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ ^/(index|core/update|core/authorize)\.php$ {
include snippets/fastcgi-php.conf;
fastcgi_param PHP_VALUE "max_input_vars=10000";
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ ^/files/.*\.(po|htaccess)$ {
deny all;
}
location ~ /\.(?!well-known) {
deny all;
}
}
try_files … /index.php– alle Adressen ohne passende Datei gehen an Backdrop. So entstehen kurze Adressen wie/posts/mein-beitrag.index,core/updateundcore/authorize– die einzigen PHP-Dateien, die Backdrop über das Web braucht: die Website selbst, die Aktualisierung der Datenbank nach einem Update und die Installation von Erweiterungen. Alle anderen PHP-Dateien, auchsettings.php, liefert nginx nicht aus (return 404).max_input_vars=10000– PHP nimmt sonst nur 1000 Felder pro Formular an. Große Formulare der Verwaltung, etwa die Berechtigungen, brauchen mehr, und der Statusbericht warnt. PHP-FPM behält den Wert in seinen Arbeitsprozessen, sodass ihn auch andere Websites auf dem Rechner bekommen können. Das schadet nicht.files/…(po|htaccess)– sperrt die Übersetzungsdateien und die Schutzdateien im Upload-Ordner. Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/backdrop /etc/nginx/sites-enabled/backdrop
19. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
20. nginx neu laden
sudo systemctl reload nginx
Backdrop verwenden
21. Website ansehen
Öffne http://localhost:8098 im Browser.
Prüfen: Die Startseite zeigt „Welcome to Meine Website!“ und darunter Kärtchen wie „Organisieren Sie Ihre Inhalte“. Im Tab des Browsers steht „Startseite | Meine Website“.
22. Anmelden
Öffne http://localhost:8098/user/login und melde dich mit Benutzername und Passwort aus Schritt 14 an.
Prüfen: Backdrop öffnet das Dashboard. Oben steht die Verwaltungsleiste mit „Dashboard“, „Inhalt“, „Benutzerkonten“, „Design“, „Funktionalität“, „Struktur“, „Konfiguration“ und „Berichte“.
23. Einen Beitrag schreiben
- Klicke in der Verwaltungsleiste auf Inhalt und dann auf Inhalt hinzufügen. Zur Auswahl stehen „Beitrag“, „Card“ und „Seite“.
- Wähle Beitrag.
- Gib einen Title und im Feld Body einen Text ein.
- Lass unter „Veröffentlichungsaktion“ die Auswahl Jetzt veröffentlichen stehen und klicke unten auf Speichern.
Prüfen: Backdrop zeigt den Beitrag unter einer Adresse wie http://localhost:8098/posts/mein-titel und meldet „Beitrag … wurde erstellt.“ Einige Feldnamen wie „Title“ und „Body“ bleiben englisch, weil sie als Namen der Felder gespeichert sind. Du kannst sie unter Struktur → Inhaltstypen umbenennen.
24. Statusbericht ansehen
Öffne Berichte → Statusbericht (http://localhost:8098/admin/reports/status). Hier zeigt Backdrop, ob alles in Ordnung ist und ob Updates bereitstehen.
Prüfen: Keine Zeile ist als „Warnung“ oder „Fehler“ markiert.
Aktualisieren
Bei einem Update ersetzt man nur den Ordner core. Eigene Module, Themes, Layouts, hochgeladene Dateien und settings.php liegen außerhalb und bleiben erhalten. Lege vorher eine Sicherung der Datenbank und des Ordners /var/www/backdrop an. Der Statusbericht zeigt, wenn eine neue Version bereitsteht.
1. Neue Version herunterladen
Ersetze 1.35.1 durch die neue Versionsnummer von https://github.com/backdrop/backdrop/releases.
cd /tmp && wget https://github.com/backdrop/backdrop/releases/download/1.35.1/backdrop.zip
2. Neue Version entpacken
Entpackt die Dateien nach /tmp/backdrop.
unzip -q backdrop.zip
3. Alten Kern löschen
sudo rm -r /var/www/backdrop/core
4. Neuen Kern einsetzen
sudo cp -r /tmp/backdrop/core /var/www/backdrop/
5. Neuen Kern dem Webserver-Benutzer übergeben
sudo chown -R www-data:www-data /var/www/backdrop/core
6. Heruntergeladene Dateien löschen
rm -r /tmp/backdrop /tmp/backdrop.zip
7. Datenbank im Browser aktualisieren
Melde dich an und öffne http://localhost:8098/core/update.php. Klicke auf Continue und folge den Schritten. Gibt es nichts zu tun, meldet Backdrop „Keine ausstehenden Aktualisierungen.“
Prüfen: Der Statusbericht nennt unter „Backdrop CMS“ die neue Versionsnummer.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/backdrop
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/backdrop
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Backdrop-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/backdrop
5. Datenbank löschen
Achtung: Damit sind alle Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS backdrop;"
6. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'backdrop'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8098
7. MariaDB entfernen (optional)
Nur wenn kein anderes Programm MariaDB braucht, z. B. Contao, Neos oder Concrete CMS. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP, unzip und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.backdropcms.org/
- Lizenz: Backdrop CMS steht unter der GPL-2.0-or-later.
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.
ProcessWire
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ProcessWire ist ein Open-Source-Content-Management-System, das Entwicklern freie Hand beim Aussehen lässt: Es gibt keine Themes im üblichen Sinn, sondern einfache PHP-Vorlagen, in denen man Inhalte über eine übersichtliche Programmierschnittstelle abruft. Redakteure pflegen Seiten in einem aufgeräumten Seitenbaum. ProcessWire steht unter der freien Mozilla Public License 2.0.
Vorbemerkungen
- Kein apt-Paket: ProcessWire ist nicht in den Ubuntu-Paketquellen enthalten. Es wird als ZIP-Datei von GitHub heruntergeladen und im Browser installiert. Composer ist nicht nötig. PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: ProcessWire läuft nur mit MariaDB oder MySQL. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit.
- Voraussetzung: nginx ist installiert und läuft.
- Adresse: ProcessWire läuft hier unter http://localhost:8099, nur vom eigenen Rechner aus erreichbar. Die Verwaltung liegt unter
/processwire/. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data. - Sprache: Installer und Verwaltung sind zunächst englisch. Die Verwaltung wird mit einem deutschen Sprachpaket aus der Community übersetzt (Schritt 22 bis 24).
- Version: Getestet mit ProcessWire 3.0.259 (stabiler Zweig
master), dem Beispielprofil „Regular“, PHP 8.5 und MariaDB 11.8 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP und Erweiterungen installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gd,intl,zip,xml,mbstringundcurlbraucht ProcessWire für Bilder, Sprachen, ZIP-Dateien, XML-Dateien, Umlaute und Downloads.unzipentpackt die ZIP-Dateien.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl unzip
Prüfen: Die Ausgabe enthält 11.8 und MariaDB.
mariadb --version
3. PHP-FPM neu laden
PHP-FPM läuft schon, falls eine andere Anleitung es installiert hat. Damit es die neue MariaDB-Erweiterung kennt, muss es neu geladen werden.
sudo systemctl reload php8.5-fpm
ProcessWire herunterladen
4. ZIP-Datei herunterladen
Lädt ProcessWire 3.0.259 von GitHub in den Ordner /tmp. Welche Version gerade stabil ist, zeigt der Zweig master unter https://github.com/processwire/processwire: Die Datei wire/core/ProcessWire.php nennt sie in versionRevision. Der Zweig dev enthält Entwicklungsversionen. Ersetze dann in diesem und im übernächsten Befehl die Versionsnummer.
cd /tmp && wget -O processwire.zip https://github.com/processwire/processwire/archive/refs/tags/3.0.259.zip
5. Nach /var/www entpacken
Die ZIP-Datei enthält einen Ordner processwire-3.0.259. -d /var/www legt ihn dort ab.
sudo unzip -q processwire.zip -d /var/www
6. Ordner umbenennen
Ein Ordnername ohne Versionsnummer bleibt auch nach Updates gleich.
sudo mv /var/www/processwire-3.0.259 /var/www/processwire
7. ZIP-Datei löschen
rm processwire.zip
Beispielprofil bereitstellen
ProcessWire bringt nur das Profil „Blank“ mit, eine fast leere Website. Das offizielle Profil „Regular“ enthält eine fertige Beispielwebsite mit Blog, Suche und Sitemap. Es eignet sich gut zum Kennenlernen.
8. Profil herunterladen
wget -O site-regular.zip https://github.com/processwire/site-regular/archive/refs/heads/main.zip
9. Profil entpacken
Legt den Ordner site-regular-main in /var/www/processwire ab.
sudo unzip -q site-regular.zip -d /var/www/processwire
10. Profilordner umbenennen
Der Installer erkennt Profile nur an Ordnernamen, die mit site- beginnen und keinen weiteren Zusatz haben.
sudo mv /var/www/processwire/site-regular-main /var/www/processwire/site-regular
11. ZIP-Datei löschen
rm site-regular.zip
12. Dateien dem Webserver-Benutzer übergeben
-R ändert den Eigentümer aller Dateien und Unterordner. Der Installer muss den Profilordner umbenennen, site/config.php schreiben und sich am Ende selbst löschen.
sudo chown -R www-data:www-data /var/www/processwire
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
13. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis.
sudo mariadb -e "CREATE DATABASE processwire CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
14. Datenbankbenutzer anlegen
ProcessWire meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 20.
sudo mariadb -e "CREATE USER 'processwire'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
15. Dem Benutzer die Datenbank freigeben
sudo mariadb -e "GRANT ALL PRIVILEGES ON processwire.* TO 'processwire'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `processwire`.* TO `processwire`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'processwire'@'localhost';"
nginx einrichten
nginx wird vor der Installation eingerichtet, weil der Installer im Browser läuft.
16. Konfiguration für ProcessWire anlegen
sudo nano /etc/nginx/sites-available/processwire
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8099;
server_name localhost;
root /var/www/processwire;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri $uri/ /index.php?it=$uri&$args;
}
location ~ ^/(index|install)\.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ ^/site/assets/(cache|logs|backups|sessions|config|install|tmp)/ {
deny all;
}
location ~* \.(inc|module|info|sql|json|md|txt|yml|latte|twig|tpl)$ {
deny all;
}
location ~ /\.(?!well-known) {
deny all;
}
}
try_files … /index.php?it=$uri&$args– alle Adressen ohne passende Datei gehen an ProcessWire. Den Pfad bekommt es im Parameteritübergeben, so erwartet es ProcessWire.indexundinstall– die einzigen PHP-Dateien, die über das Web erreichbar sind.install.phplöscht sich nach der Installation selbst. Vorlagen, Module undsite/config.phpliefert nginx nicht aus (return 404).site/assets/(cache|logs|…)– sperrt Zwischenspeicher, Protokolle, Sicherungen und Sitzungsdaten.- Die Endungen
inc,module,json,sqlusw. – sperrt Quelltexte, Übersetzungsdateien und Datenbankabzüge. Diese Regeln übernehmen bei nginx die Aufgabe der Datei.htaccess, die ProcessWire für den Webserver Apache mitbringt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
17. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/processwire /etc/nginx/sites-enabled/processwire
18. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
19. nginx neu laden
sudo systemctl reload nginx
ProcessWire installieren
20. Installer im Browser durchlaufen
Öffne http://localhost:8099/install.php im Browser. Bleib bis zum Ende im selben Browserfenster: Der Installer merkt sich den Zwischenstand nur innerhalb der laufenden Sitzung.
- Welcome: Klicke auf Get Started.
- Site Installation Profile: Wähle Regular Uikit 3.x site/blog profile und klicke auf Continue.
- Compatibility Check: Alle Punkte sind grün bis auf den Hinweis
Unable to determine if Apache mod_rewrite … is installed. Er betrifft nur den Webserver Apache, nicht nginx. Klicke auf Continue To Next Step. - MySQL Database: Trage bei DB Name
processwire, bei DB Userprocesswireund bei DB Pass dein Passwort aus Schritt 14 ein. Wähle bei Time ZoneEurope/Berlin. Unter HTTP Host Names stehen schonlocalhost:8099undlocalhost, das passt. Lass bei Debug mode? die Auswahl OFF stehen und klicke auf Continue. - Admin Panel und Admin Account: Lass bei Admin Login URL
processwirestehen, dann liegt die Verwaltung unter/processwire/. Gib bei User deinen Benutzernamen, zweimal ein Password und eine Email Address ein. Das Passwort kann ProcessWire später nicht anzeigen, merke es dir gut. - Cleanup: Lass alle Haken gesetzt. Der Installer löscht dann
install.php, die Installationsdateien des Profils und das ungenutzte Profil „Blank“. Klicke auf Continue.
Prüfen: Die letzte Seite meldet User account saved und Your admin URL is /processwire/.
21. site/config.php schützen
In site/config.php stehen das Datenbankpasswort und ein geheimer Schlüssel für die Passwörter der Benutzer. Der Installer empfiehlt selbst, die Datei schreibzuschützen. Danach darf nur noch www-data sie lesen, und niemand darf sie ändern.
sudo chmod 400 /var/www/processwire/site/config.php
Prüfen: Die Zeile beginnt mit -r-------- und nennt zweimal www-data.
ls -l /var/www/processwire/site/config.php
Willst du site/config.php später ändern, gib vorher mit sudo chmod 600 /var/www/processwire/site/config.php das Schreibrecht zurück und setze es danach wieder auf 400.
Verwaltung auf Deutsch umstellen
22. Deutsches Sprachpaket herunterladen
Das Sprachpaket wird von der deutschsprachigen Community auf GitHub gepflegt und verwendet die Anrede „Sie“. Der Befehl legt die ZIP-Datei in deinem Home-Verzeichnis ab. Von dort lädst du sie im Browser hoch.
wget -O ~/pw-lang-de.zip https://github.com/jmartsch/pw-lang-de/archive/refs/heads/master.zip
23. Modul für Sprachen installieren
Öffne http://localhost:8099/processwire/ und melde dich an.
- Klicke oben auf Modules und dann auf den Reiter Core.
- Suche in der Liste den Eintrag Languages Support (
LanguageSupport) und klicke daneben auf Install.
Prüfen: ProcessWire meldet unter anderem Created Default Language Page: /processwire/setup/languages/default/ und Language Support Installed!.
24. Sprachpaket in die Standardsprache laden
Die Standardsprache heißt zunächst „default“ und ist englisch. Mit dem Sprachpaket wird sie deutsch.
- Klicke oben auf Setup → Languages und dann auf default.
- Ändere das Feld Title in
Deutsch. - Klicke im Feld Core Translation Files auf den Link zum Auswählen von Dateien (oder ziehe die Datei mit der Maus hinein) und wähle
pw-lang-de.zipaus deinem Home-Verzeichnis. ProcessWire entpackt sie selbst und listet danach die einzelnen.json-Dateien. - Klicke auf Save.
- Melde dich ab (oben rechts unter deinem Namen) und wieder an.
Nimm das Feld Core Translation Files und nicht „Site Translation Files“. Das zweite Feld ist für Übersetzungen deiner eigenen Vorlagen gedacht.
Prüfen: Die Anmeldeseite zeigt „Benutzername“, „Passwort“ und „Einloggen“. Oben stehen die Menüpunkte „Seiten“, „Verwaltung“, „Module“ und „Zugriff“.
Die ZIP-Datei in deinem Home-Verzeichnis brauchst du danach nicht mehr:
rm ~/pw-lang-de.zip
ProcessWire verwenden
25. Website ansehen
Öffne http://localhost:8099 im Browser.
Prüfen: Die Beispielwebsite erscheint mit den Menüpunkten „About“, „Blog“ und „Site Map“. Die Texte sind englisch, weil sie Inhalte des Profils sind.
26. Eine Seite bearbeiten
- Klicke in der Verwaltung auf Seiten. Der Seitenbaum zeigt „Home“ mit den Unterseiten „About“, „Blog“, „Categories“ usw.
- Klicke auf Home und dann auf Bearbeiten.
- Ändere im Reiter Inhalt das Feld Titel, z. B. in
Willkommen. Darunter liegen die Felder des Profils wie „Headline“, „Body“ und „Images“. - Klicke auf Speichern.
Prüfen: ProcessWire meldet „Gespeichert: /“. Lädst du http://localhost:8099 neu, erscheint der neue Titel.
Aktualisieren
Bei einem Update ersetzt man nur den Ordner wire. Deine Website mit Vorlagen, Modulen, Dateien und site/config.php liegt im Ordner site und bleibt erhalten. Lege vorher eine Sicherung der Datenbank und des Ordners /var/www/processwire an.
1. Neue Version herunterladen
Ersetze 3.0.259 durch die neue stabile Versionsnummer.
cd /tmp && wget -O processwire.zip https://github.com/processwire/processwire/archive/refs/tags/3.0.259.zip
2. Neue Version entpacken
Entpackt die Dateien nach /tmp/processwire-3.0.259.
unzip -q processwire.zip
3. Alten Kern löschen
sudo rm -r /var/www/processwire/wire
4. Neuen Kern einsetzen
sudo cp -r /tmp/processwire-3.0.259/wire /var/www/processwire/
5. Neuen Kern dem Webserver-Benutzer übergeben
sudo chown -R www-data:www-data /var/www/processwire/wire
6. Heruntergeladene Dateien löschen
rm -r /tmp/processwire-3.0.259 /tmp/processwire.zip
7. In der Verwaltung anmelden
Öffne http://localhost:8099/processwire/ und melde dich an. ProcessWire passt die Datenbank beim ersten Aufruf der Verwaltung selbst an und meldet das oben auf der Seite.
Prüfen: Unten in der Verwaltung steht die neue Versionsnummer, z. B. „ProcessWire 3.0.259 © 2026“.
Nach einem Update kann das Sprachpaket einzelne neue Texte noch nicht enthalten, sie erscheinen dann englisch. Eine neue Fassung des Pakets lädst du wie in Schritt 22 und 24 hoch.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/processwire
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/processwire
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. ProcessWire-Dateien löschen
Achtung: Damit sind auch alle Vorlagen und hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/processwire
5. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS processwire;"
6. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'processwire'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8099
7. MariaDB entfernen (optional)
Nur wenn kein anderes Programm MariaDB braucht, z. B. Contao, Neos, Concrete CMS oder Backdrop CMS. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP, unzip und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://processwire.com/docs/
- Lizenz: ProcessWire steht unter der MPL-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.
Strapi
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Strapi ist ein Headless-CMS: Es verwaltet Inhalte wie Artikel, Produkte oder Termine in einer Verwaltungsoberfläche im Browser und gibt sie über eine REST- oder GraphQL-Schnittstelle aus. Die eigentliche Website oder App baut man getrennt davon, z. B. mit Astro, React, einer Handy-App oder einem statischen Website-Generator.
Vorbemerkungen
- Kein apt-Paket: Strapi ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt über
npminstalliert. Node.js und npm kommen aus den Ubuntu-Paketquellen. - Voraussetzung: PostgreSQL ist installiert und läuft. Strapi kann auch SQLite, MySQL und MariaDB verwenden. Für den Dauerbetrieb empfiehlt sich aber eine richtige Datenbank.
- Zwei Betriebsarten: Im Entwicklungsmodus (
npm run develop) legt man fest, welche Arten von Inhalten es gibt, z. B. „Artikel“ mit Titel, Text und Bild. Im Produktionsmodus (npm run start) pflegt man nur noch Inhalte, die Struktur ist dann gesperrt. - Adresse: Strapi läuft hier unter http://localhost:1337, nur vom eigenen Rechner aus erreichbar.
- Version: Getestet mit Strapi 5.55.1 unter Node.js 22 und npm 9 aus Ubuntu 26.04 und PostgreSQL 18. Strapi 5 braucht Node.js 20 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Strapi aus, npm lädt es herunter. Sind beide schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v20, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie zwischen v20 und v26 liegt.
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer anlegen
Strapi meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 5.
sudo -u postgres psql -c "CREATE USER strapi WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
4. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE strapi OWNER strapi ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
Projekt anlegen
5. Strapi-Projekt erzeugen
npx lädt das Einrichtungsprogramm create-strapi und legt damit das Projekt ~/meinstrapi an. Die Optionen beantworten alle Fragen im Voraus:
--no-run– Strapi nach dem Anlegen noch nicht starten.--tsund--use-npm– das Projekt in TypeScript anlegen und npm als Paketmanager verwenden.--skip-cloud– keine Anmeldung beim kostenpflichtigen Dienst Strapi Cloud.--no-exampleund--no-git-init– ohne Beispieldaten und ohne Git-Repository.--db…– die Verbindung zur Datenbank aus Schritt 3 und 4. Setze bei--dbpassworddein Passwort ein.
npx create-strapi@latest ~/meinstrapi --no-run --ts --use-npm --install --skip-cloud --no-example --no-git-init --dbclient=postgres --dbhost=127.0.0.1 --dbport=5432 --dbname=strapi --dbusername=strapi --dbpassword=geheimes_passwort --dbssl=false
Die Frage Need to install the following packages: create-strapi … Ok to proceed? (y) beantwortest du mit Enter. Das Herunterladen aller Pakete dauert einige Minuten.
Prüfen: Die Ausgabe enthält ✓ Dependencies installed und Your application was created!.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinstrapi
7. Nur vom eigenen Rechner erreichbar machen
In der Datei .env stehen Einstellungen, Datenbankpasswort und geheime Schlüssel. Voreingestellt ist HOST=0.0.0.0: Strapi wäre dann von jedem Rechner im Netzwerk erreichbar.
nano .env
Ändere die Zeile HOST=0.0.0.0 ganz oben in:
HOST=127.0.0.1
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Die Datei .env enthält geheime Schlüssel. Gib sie nicht weiter und lade sie nicht in ein öffentliches Git-Repository hoch.
8. Telemetrie abschalten
Strapi schickt sonst anonyme Nutzungsdaten an den Hersteller. Der Befehl trägt "telemetryDisabled": true in die Datei package.json ein.
npm run strapi telemetry:disable
Prüfen: Die Ausgabe endet mit Successfully opted out of Strapi telemetry.
9. Deutsche Oberfläche freischalten
Die Verwaltung ist zunächst nur auf Englisch verfügbar. Weitere Sprachen schaltet man in der Datei src/admin/app.tsx frei.
nano src/admin/app.tsx
Füge diesen Inhalt ein (Strg+Umschalt+V):
import type { StrapiApp } from '@strapi/strapi/admin';
export default {
config: {
locales: ['de'],
},
bootstrap(app: StrapiApp) {},
};
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Administratorkonto anlegen
Legt das erste Konto für die Verwaltung an. Setze deinen Namen, deine E-Mail-Adresse und ein Passwort mit mindestens 8 Zeichen, Groß- und Kleinbuchstaben und einer Ziffer ein. Das Passwort landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung in der Verwaltung unter „Profil-Einstellungen“.
npm run strapi admin:create-user -- --firstname=Dein --lastname=Name --email=admin@example.com --password='Ein-langes-Passwort-2026'
-- trennt die Optionen für Strapi von denen für npm.
Prüfen: Die letzte Zeile lautet Successfully created new admin. Eine Warnung zum E-Mail-Anbieter sendmail kannst du ignorieren.
Strapi verwenden
11. Im Entwicklungsmodus starten
Startet Strapi, baut die Verwaltung und startet neu, sobald sich Dateien im Projekt ändern. Nur in diesem Modus kann man neue Inhaltstypen anlegen.
npm run develop
Prüfen: Nach etwa einer Minute erscheint Strapi started successfully.
12. Verwaltung öffnen und Sprache wählen
Öffne http://localhost:1337/admin im Browser. Klicke oben auf der Anmeldeseite auf das Auswahlfeld English und wähle Deutsch. Melde dich dann mit E-Mail-Adresse und Passwort aus Schritt 10 an. Der Browser merkt sich die Sprache.
Prüfen: Die Startseite begrüßt dich mit „Hallo Dein“. Links stehen unter anderem „Content Manager“, „Medienbibliothek“, „Inhaltstyp-Editor“ und „Einstellungen“. Die Sprache lässt sich später auch unter „Profil-Einstellungen“ ändern.
13. Einen Inhaltstyp anlegen
Im Inhaltstyp-Editor legst du fest, welche Felder ein Inhalt hat. Ein Beispiel:
- Klicke im Bereich Sammlungen auf Neue Sammlung erstellen und gib als Namen
Artikelein. - Füge ein Feld vom Typ Text mit dem Namen
titelhinzu. - Füge ein Feld vom Typ Formatierter Text (Blocks) mit dem Namen
inhalthinzu. - Speichere. Strapi legt dafür Dateien im Ordner
src/api/artikelan und startet danach kurz neu.
Anschließend kannst du im Content Manager Artikel schreiben und veröffentlichen. Damit andere Programme sie ohne Anmeldung abrufen dürfen, öffnest du Einstellungen, dann im Bereich Nutzer- & Berechtigungen-Plugin den Punkt Rollen und die Rolle Public. Gib dort beim Typ „Artikel“ die Aktionen find und findOne frei und speichere.
Beende den Entwicklungsmodus mit Strg+C.
14. Verwaltung für den Produktionsmodus bauen
Erzeugt eine fertige, schnellere Fassung der Verwaltung im Ordner dist. Das ist nach jeder Änderung an src/admin und nach jedem Update nötig.
NODE_ENV=production npm run build
Prüfen: Die Ausgabe endet mit ✔ Building admin panel.
15. Im Produktionsmodus starten
Startet Strapi ohne Beobachtung der Dateien. Der Inhaltstyp-Editor ist hier nur lesbar, Inhalte pflegst du wie gewohnt.
NODE_ENV=production npm run start
Prüfen: Die Ausgabe enthält Strapi started successfully. Die Verwaltung ist wieder unter http://localhost:1337/admin erreichbar. Ein Aufruf von http://localhost:1337/api/artikels zeigt die veröffentlichten Artikel als JSON, wenn du sie in Schritt 13 freigegeben hast. Strapi hängt dafür ein „s“ an den Namen des Typs an.
Beende Strapi mit Strg+C.
Aktualisieren
Strapi bringt ein eigenes Werkzeug für Updates mit. Es aktualisiert die Pakete und passt bei Bedarf den Code des Projekts an. Lege vorher eine Sicherung des Projektordners und der Datenbank an.
1. In den Projektordner wechseln
cd ~/meinstrapi
2. Update ausprobieren
--dry zeigt nur, was sich ändern würde. minor bleibt innerhalb der Hauptversion 5.
npx @strapi/upgrade minor --dry
Prüfen: Die Ausgabe listet die geplanten Änderungen oder meldet The project is already up-to-date (minor).
3. Update einspielen
npx @strapi/upgrade minor
4. Verwaltung neu bauen
NODE_ENV=production npm run build
Den Sprung auf eine neue Hauptversion macht man mit npx @strapi/upgrade major, nachdem man die Hinweise unter https://docs.strapi.io gelesen hat.
Deinstallieren
1. Strapi beenden
Läuft Strapi noch in einem Terminal, beende es dort mit Strg+C.
2. Projektordner löschen
Achtung: Damit sind auch hochgeladene Bilder und Dateien gelöscht. Sie liegen in ~/meinstrapi/public/uploads.
rm -r ~/meinstrapi
3. Datenbank löschen
Achtung: Damit sind alle Inhalte, Inhaltstypen und Konten gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS strapi;"
4. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS strapi;"
Prüfen: Strapi ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:1337
5. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js, npm und PostgreSQL bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.strapi.io/
- Lizenz: Strapi steht unter der Community Edition / MIT.
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.
Directus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Directus ist ein Headless-CMS: Es legt eine Verwaltungsoberfläche und eine REST- und GraphQL-Schnittstelle über eine SQL-Datenbank. Tabellen und Felder richtet man im Browser ein, die Inhalte holen sich Websites, Apps oder Skripte über die Schnittstelle. Anders als bei Strapi entstehen dabei keine Code-Dateien, alles steht in der Datenbank.
Vorbemerkungen
- Kein apt-Paket: Directus ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt über
npminstalliert. Node.js und npm kommen aus den Ubuntu-Paketquellen. - Voraussetzung: PostgreSQL ist installiert und läuft. Directus kann auch MySQL, MariaDB und SQLite verwenden.
- Lizenz: Directus ist quelloffen, aber keine Open-Source-Software. Es steht unter der „Monospace Sustainable Core License“ (MSCL). Kostenlos erlaubt sind unter anderem die eigene interne Nutzung, nicht kommerzielle Lehre und Forschung sowie das Einrichten für Kunden. Nicht erlaubt ist, Directus als Konkurrenzangebot zum kostenpflichtigen Angebot des Herstellers bereitzustellen. Jede Version wird vier Jahre nach ihrem Erscheinen zusätzlich unter der GPL-3.0 freigegeben. Den vollständigen Text findest du nach der Installation in
~/meindirectus/node_modules/directus/license. - Adresse: Directus läuft hier unter http://localhost:8055, nur vom eigenen Rechner aus erreichbar.
- Version: Getestet mit Directus 12.4.1 unter Node.js 22 und npm 9 aus Ubuntu 26.04 und PostgreSQL 18. Directus 12 braucht Node.js 22 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Directus aus, npm lädt es herunter. Sind beide schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v22, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v22 ist.
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer anlegen
Directus meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 10.
sudo -u postgres psql -c "CREATE USER directus WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
4. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE directus OWNER directus ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
Projekt anlegen
5. Projektordner anlegen
In diesem Ordner liegen Directus, seine Einstellungen und die hochgeladenen Dateien.
mkdir ~/meindirectus
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meindirectus
7. Directus herunterladen
Lädt Directus mit allen Bibliotheken in den Unterordner node_modules und legt die Datei package.json an. Das dauert etwa eine Minute.
npm install directus
Prüfen: Die Ausgabe lautet 12.4.1 oder eine neuere Versionsnummer.
npx directus --version
8. Ordner für Uploads und Erweiterungen anlegen
Directus legt hochgeladene Dateien in uploads ab und lädt Erweiterungen aus extensions. Fehlen die Ordner, meldet Directus beim Start is not read/writeable bzw. is not readable.
mkdir uploads extensions
9. Geheimen Schlüssel erzeugen
Directus unterschreibt damit die Anmeldungen. Der Befehl gibt eine zufällige Zeichenkette aus 64 Zeichen aus. Markiere sie und kopiere sie mit Strg+Umschalt+C. Du brauchst sie im nächsten Schritt.
openssl rand -hex 32
10. Einstellungsdatei anlegen
Directus liest seine Einstellungen aus der Datei .env im Projektordner.
nano .env
Füge diesen Inhalt ein (Strg+Umschalt+V):
HOST=127.0.0.1
PORT=8055
PUBLIC_URL=http://localhost:8055
SECRET=HIER_DEN_SCHLUESSEL_EINSETZEN
DB_CLIENT=pg
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=directus
DB_USER=directus
DB_PASSWORD=geheimes_passwort
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=Ein-langes-Passwort-2026
TELEMETRY=false
PROJECT_OWNER_ENABLED=false
Passe dann diese Werte an:
SECRET– ersetzeHIER_DEN_SCHLUESSEL_EINSETZENdurch den Schlüssel aus Schritt 9.DB_PASSWORD– das Datenbankpasswort aus Schritt 3.ADMIN_EMAILundADMIN_PASSWORD– deine Anmeldedaten für die Verwaltung. Sie werden nur in Schritt 11 gebraucht.
Die übrigen Zeilen bedeuten:
HOST=127.0.0.1undPORT=8055– Directus ist nur vom eigenen Rechner aus erreichbar.DB_…– die Verbindung zur Datenbank aus Schritt 3 und 4.pgsteht für PostgreSQL.TELEMETRY=false– Directus schickt keine Nutzungsdaten an den Hersteller.PROJECT_OWNER_ENABLED=false– Directus fragt nicht nach einem „Projektinhaber“. Ohne diese Zeile erscheint nach der Anmeldung ein Dialog, der E-Mail-Adresse und Verwendungszweck an den Hersteller schickt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Die Datei .env enthält Passwörter und den geheimen Schlüssel. Gib sie nicht weiter und lade sie nicht in ein öffentliches Git-Repository hoch.
11. Datenbank einrichten
bootstrap legt die Tabellen von Directus in der Datenbank an und erzeugt das Administratorkonto mit den Daten aus ADMIN_EMAIL und ADMIN_PASSWORD.
npx directus bootstrap
Prüfen: Die letzten Zeilen lauten Adding first admin user... und Done.
12. Administratorpasswort aus der Einstellungsdatei entfernen
Das Konto ist jetzt angelegt. Die beiden Zeilen werden nicht mehr gebraucht, und das Passwort soll nicht dauerhaft im Klartext in der Datei stehen.
nano .env
Drücke Strg+W, gib ADMIN_EMAIL ein und drücke Enter. Drücke dann zweimal Strg+K. Das löscht die Zeilen ADMIN_EMAIL=… und ADMIN_PASSWORD=…. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Der Befehl gibt nichts aus.
grep ADMIN_ .env
Directus verwenden
13. Directus starten
Startet den Server im Terminal. Er läuft so lange, bis du ihn mit Strg+C beendest.
npx directus start
Prüfen: Nach wenigen Sekunden erscheint Server started at http://127.0.0.1:8055. Die Warnung PostGIS isn't installed kannst du ignorieren. PostGIS braucht man nur für Geodaten.
14. An der Verwaltung anmelden
Öffne http://localhost:8055 im Browser. Directus leitet auf die Anmeldeseite unter /admin weiter. Melde dich mit E-Mail-Adresse und Passwort aus Schritt 10 an.
15. Lizenzfrage beantworten
Nach der ersten Anmeldung fragt Directus „Have a license key?“. Für die kostenlose Nutzung:
- Klicke auf I'm using Core plan.
- Wähle unter „What are you using Directus for?“ den passenden Zweck, z. B. Personal / Side project.
- Klicke auf Save.
Die Antwort wird nur in deiner eigenen Datenbank gespeichert. Klickst du stattdessen auf Skip, erscheint die Frage bei jeder Anmeldung wieder.
Prüfen: Links steht „Content“ mit dem Hinweis „No Collections“.
16. Oberfläche auf Deutsch umstellen
- Klicke in der linken Leiste auf das Zahnrad (Settings) und dann auf Settings.
- Wähle im Feld Default Language den Eintrag German (Germany).
- Klicke oben rechts auf Save (Häkchen).
- Lade die Seite mit F5 neu.
Prüfen: Die Menüs heißen jetzt „Datenmodell“, „Benutzerrollen“, „Einstellungen“ usw. Die Einstellung gilt für alle Benutzer, die keine eigene Sprache gewählt haben.
17. Eine Sammlung anlegen
Eine Sammlung ist eine Tabelle in der Datenbank, z. B. für Artikel. Ein Beispiel:
- Klicke in der linken Leiste auf das Zahnrad, dann auf Datenmodell und oben rechts auf Erstellen.
- Gib als Name
artikelein. Klicke oben rechts auf Weiter und danach auf Einrichtung abschließen. Das Primärschlüsselfeldidlegt Directus selbst an. - Klicke in der neuen Sammlung auf Feld erstellen und wähle Eingabe. Gib als Schlüssel
titelein und klicke auf Speichern. - Klicke in der linken Leiste ganz oben auf den Würfel (Inhalt), dann auf Artikel und oben rechts auf Erstellen. Gib einen Titel ein und klicke auf Speichern.
18. Artikel öffentlich lesbar machen
Ohne Anmeldung liefert die Schnittstelle zunächst nichts aus.
- Klicke in der linken Leiste auf das Zahnrad, dann auf Zugangsrichtlinien und in der Liste auf Öffentlich.
- Klicke unter „Permissions“ auf Sammlung hinzufügen und wähle
artikel. - In der neuen Zeile
artikelstehen die Aktionen „Erstellen“, „Lesen“, „Aktualisieren“, „Löschen“ und „Teilen“. Klicke auf Lesen und wähle Kompletter Zugriff. „Lesen“ wird daraufhin farbig hervorgehoben. - Klicke oben rechts auf Speichern.
Prüfen: Öffne ein zweites Terminal. Die Ausgabe enthält deinen Artikel, z. B. {"data":[{"id":1,"titel":"Hallo Directus"}]}. Vor der Freigabe steht dort You don't have permission to access collection "artikel".
curl http://localhost:8055/items/artikel
Beende Directus im ersten Terminal mit Strg+C.
Aktualisieren
Lege vorher eine Sicherung des Projektordners und der Datenbank an.
1. In den Projektordner wechseln
cd ~/meindirectus
2. Nach neuen Versionen sehen
Zeigt eine Tabelle mit der installierten (Current) und der neuesten Version (Latest). Gibt der Befehl nichts aus, ist Directus aktuell.
npm outdated directus
3. Directus aktualisieren
Installiert die neueste Version. Beim Sprung auf eine neue Hauptversion (z. B. von 12 auf 13) liest man vorher die Hinweise unter https://directus.com/docs.
npm install directus@latest
4. Datenbank anpassen
Neue Versionen bringen oft geänderte Tabellen mit. Directus muss dafür beendet sein.
npx directus database migrate:latest
Prüfen: Die Ausgabe endet mit Database up to date.
Deinstallieren
1. Directus beenden
Läuft Directus noch in einem Terminal, beende es dort mit Strg+C.
2. Projektordner löschen
Achtung: Damit sind auch hochgeladene Bilder und Dateien gelöscht. Sie liegen in ~/meindirectus/uploads.
rm -r ~/meindirectus
3. Datenbank löschen
Achtung: Damit sind alle Sammlungen, Inhalte und Konten gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS directus;"
4. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS directus;"
Prüfen: Directus ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8055
5. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js, npm und PostgreSQL bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.directus.io/
- Lizenz: Directus steht unter der BSL-1.1 / Apache-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.
Payload CMS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Payload ist ein Headless-CMS, bei dem man Inhaltstypen als TypeScript-Code beschreibt. Daraus erzeugt es eine Verwaltungsoberfläche, eine REST- und GraphQL-Schnittstelle und die passenden Tabellen in der Datenbank. Payload baut auf dem Webframework Next.js auf, deshalb kann dasselbe Projekt auch die eigentliche Website ausliefern. Anders als Directus steht Payload unter der freien MIT-Lizenz.
Vorbemerkungen
- Kein apt-Paket: Payload ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt über
npminstalliert. Node.js und npm kommen aus den Ubuntu-Paketquellen. - Voraussetzung: PostgreSQL ist installiert und läuft. Payload kann auch MongoDB und SQLite verwenden.
- Code statt Klicks: Neue Inhaltstypen („Sammlungen“) legt man nicht in der Oberfläche an, sondern als Datei im Ordner
src/collections. Grundkenntnisse in TypeScript oder JavaScript helfen, sind für diese Anleitung aber nicht nötig. - Adresse: Payload läuft hier unter http://localhost:3001, nur vom eigenen Rechner aus erreichbar. Der voreingestellte Port 3000 ist auf diesem Rechner schon von Martin belegt.
- Version: Getestet mit Payload 3.90.2 und Next.js 16.3 unter Node.js 22 und npm 9 aus Ubuntu 26.04 und PostgreSQL 18.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Payload aus, npm lädt es herunter. Sind beide schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v20.9, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v20.9 ist.
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer anlegen
Payload meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 6. Verwende nur Buchstaben, Ziffern, - und _, weil das Passwort in Schritt 6 Teil einer Adresse ist.
sudo -u postgres psql -c "CREATE USER payload WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
4. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE payload OWNER payload ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
Projekt anlegen
5. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
6. Payload-Projekt erzeugen
npx lädt das Einrichtungsprogramm create-payload-app und legt damit das Projekt ~/meinpayload an. Die Optionen beantworten alle Fragen im Voraus:
-n meinpayload– der Name des Projektordners.-t blank– die leere Vorlage mit Benutzern und einer Medienbibliothek. Die Vorlagewebsitebringt zusätzlich eine fertige Website mit.--db postgresund--db-connection-string– die Datenbank aus Schritt 3 und 4. Die Adresse ist so aufgebaut:postgres://BENUTZER:PASSWORT@RECHNER:PORT/DATENBANK. Setze dein Passwort ein.--use-npm– npm als Paketmanager verwenden.--no-agentund--no-git– keine Anleitungsdateien für KI-Assistenten und kein Git-Repository anlegen.
npx create-payload-app@latest -n meinpayload -t blank --db postgres --db-connection-string postgres://payload:geheimes_passwort@127.0.0.1:5432/payload --use-npm --no-agent --no-git
Die Frage Need to install the following packages: create-payload-app … Ok to proceed? (y) beantwortest du mit Enter. Das Herunterladen aller Pakete dauert etwa eine Minute.
Prüfen: Die Ausgabe enthält Successfully installed Payload and dependencies und Payload project successfully created!.
Das Programm schreibt die Datenbankadresse und einen zufälligen geheimen Schlüssel (PAYLOAD_SECRET) in die Datei .env im Projektordner. Gib sie nicht weiter und lade sie nicht in ein öffentliches Git-Repository hoch.
7. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinpayload
8. Telemetrie von Next.js abschalten
Next.js schickt sonst anonyme Nutzungsdaten an den Hersteller Vercel. Die Einstellung gilt für alle Next.js-Projekte deines Benutzers. Für Payload selbst schaltet Schritt 10 die Telemetrie ab.
npx next telemetry disable
Prüfen: Die Ausgabe enthält Status: Disabled.
9. Sammlung „Artikel“ anlegen
Diese Datei beschreibt einen Inhaltstyp mit Titel und formatiertem Text. slug ist der Name in der Datenbank und in der Adresse der Schnittstelle. read: () => true erlaubt jedem, Artikel über die Schnittstelle zu lesen. Anlegen, Ändern und Löschen bleibt angemeldeten Benutzern vorbehalten.
nano src/collections/Artikel.ts
Füge diesen Inhalt ein (Strg+Umschalt+V):
import type { CollectionConfig } from 'payload'
export const Artikel: CollectionConfig = {
slug: 'artikel',
labels: {
singular: 'Artikel',
plural: 'Artikel',
},
admin: {
useAsTitle: 'titel',
},
access: {
read: () => true,
},
fields: [
{
name: 'titel',
label: 'Titel',
type: 'text',
required: true,
},
{
name: 'inhalt',
label: 'Inhalt',
type: 'richText',
},
],
}
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Hauptkonfiguration anpassen
In src/payload.config.ts stehen alle Einstellungen des Projekts. Hier wird die neue Sammlung eingebunden, die Oberfläche auf Deutsch gestellt und die Telemetrie von Payload abgeschaltet.
nano src/payload.config.ts
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
import { postgresAdapter } from '@payloadcms/db-postgres'
import { lexicalEditor } from '@payloadcms/richtext-lexical'
import { de } from '@payloadcms/translations/languages/de'
import path from 'path'
import { buildConfig } from 'payload'
import { fileURLToPath } from 'url'
import sharp from 'sharp'
import { Users } from './collections/Users'
import { Media } from './collections/Media'
import { Artikel } from './collections/Artikel'
const filename = fileURLToPath(import.meta.url)
const dirname = path.dirname(filename)
export default buildConfig({
admin: {
user: Users.slug,
importMap: {
baseDir: path.resolve(dirname),
},
},
collections: [Users, Media, Artikel],
editor: lexicalEditor(),
i18n: {
supportedLanguages: { de },
fallbackLanguage: 'de',
},
telemetry: false,
secret: process.env.PAYLOAD_SECRET || '',
typescript: {
outputFile: path.resolve(dirname, 'payload-types.ts'),
},
db: postgresAdapter({
pool: {
connectionString: process.env.DATABASE_URL || '',
},
}),
sharp,
plugins: [],
})
Gegenüber der Vorlage neu sind:
import { de } …und der Blocki18n– die Verwaltung erscheint auf Deutsch, unabhängig von der Sprache des Browsers.import { Artikel } …undArtikelin der Listecollections– bindet die Sammlung aus Schritt 9 ein.telemetry: false– Payload schickt keine Nutzungsdaten an den Hersteller.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Payload verwenden
11. Im Entwicklungsmodus starten
Im Entwicklungsmodus legt Payload fehlende Tabellen in der Datenbank selbst an und lädt Änderungen an den Dateien sofort nach. -- gibt die folgenden Optionen an Next.js weiter: -p 3001 wählt den Port, -H 127.0.0.1 macht Payload nur vom eigenen Rechner aus erreichbar.
npm run dev -- -p 3001 -H 127.0.0.1
Prüfen: Nach wenigen Sekunden erscheint ✓ Ready. Beim ersten Aufruf einer Seite folgen Pulling schema from database... und die Tabellen werden angelegt. Die Warnung No email adapter provided kannst du ignorieren: Ohne Mailserver schreibt Payload E-Mails, z. B. zum Zurücksetzen von Passwörtern, nur ins Terminal.
12. Ersten Benutzer anlegen
Öffne http://localhost:3001/admin im Browser. Der erste Aufruf dauert einige Sekunden, weil Next.js die Seite erst übersetzt. Payload zeigt die Seite „Willkommen“, weil es noch keinen Benutzer gibt. Gib E-Mail-Adresse und zweimal ein Passwort ein und klicke auf Erstellen.
Prüfen: Die Übersicht zeigt unter „Sammlungen“ die Einträge „Users“, „Media“ und „Artikel“. „Users“ und „Media“ heißen so in der Vorlage, du kannst sie in src/collections/Users.ts und Media.ts genauso mit labels umbenennen wie in Schritt 9.
13. Einen Artikel anlegen
Klicke auf Artikel und dann auf Neu erstellen. Gib einen Titel und etwas Text ein und klicke oben rechts auf Speichern.
14. Artikel über die Schnittstelle abrufen
Öffne ein zweites Terminal. depth=0 liefert verknüpfte Einträge nur als Nummer statt vollständig.
curl "http://localhost:3001/api/artikel?depth=0"
Prüfen: Die Ausgabe beginnt mit {"docs":[{"id":1,"titel":"…" und enthält deinen Artikel. Die Benutzerliste unter /api/users bleibt ohne Anmeldung gesperrt, dort erscheint Du hast keine Berechtigung, diese Aktion auszuführen.
Beende den Entwicklungsmodus im ersten Terminal mit Strg+C.
15. Produktionsfassung bauen
Next.js übersetzt das ganze Projekt in eine schnelle, fertige Fassung im Ordner .next. Das ist nach jeder Änderung an den Dateien und nach jedem Update nötig.
npm run build
Prüfen: Die Ausgabe enthält ✓ Compiled successfully und endet mit einer Liste der Adressen (Route (app)).
16. Im Produktionsmodus starten
Startet die fertige Fassung. Die Tabellen hat der Entwicklungsmodus in Schritt 11 schon angelegt.
npm run start -- -p 3001 -H 127.0.0.1
Prüfen: Es erscheint ✓ Ready. Die Verwaltung ist wieder unter http://localhost:3001/admin erreichbar, die Startseite http://localhost:3001 zeigt „Welcome to your new project.“ aus der Vorlage.
Beende Payload mit Strg+C.
Für den Betrieb auf einem Server legt man Änderungen an der Datenbank nicht über den Entwicklungsmodus an, sondern mit Migrationen (npm run payload migrate:create und npm run payload migrate). Die Hinweise dazu stehen unter https://payloadcms.com/docs/database/migrations.
Aktualisieren
Lege vorher eine Sicherung des Projektordners und der Datenbank an.
1. In den Projektordner wechseln
cd ~/meinpayload
2. Nach neuen Versionen sehen
Zeigt eine Tabelle mit der installierten (Current) und der neuesten Version (Latest). Gibt der Befehl nichts aus, ist Payload aktuell.
npm outdated payload
3. Payload aktualisieren
Die Pakete von Payload müssen immer dieselbe Version haben. Deshalb werden alle zusammen aktualisiert.
npm install payload@latest @payloadcms/next@latest @payloadcms/ui@latest @payloadcms/richtext-lexical@latest @payloadcms/db-postgres@latest
npm meldet danach oft vulnerabilities. Die Warnungen betreffen meist Werkzeuge, die nur beim Entwickeln laufen. Führe nicht npm audit fix --force aus: Der Befehl springt auf andere Hauptversionen und kann das Projekt unbrauchbar machen.
4. Produktionsfassung neu bauen
npm run build
Den Sprung auf eine neue Hauptversion (z. B. von 3 auf 4) macht man erst, nachdem man die Hinweise unter https://payloadcms.com/docs gelesen hat.
Deinstallieren
1. Payload beenden
Läuft Payload noch in einem Terminal, beende es dort mit Strg+C.
2. Projektordner löschen
Achtung: Damit sind auch hochgeladene Bilder und Dateien gelöscht. Sie liegen in ~/meinpayload/media.
rm -r ~/meinpayload
3. Datenbank löschen
Achtung: Damit sind alle Inhalte und Benutzer gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS payload;"
4. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS payload;"
Prüfen: Payload ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:3001
5. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js, npm und PostgreSQL bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://payloadcms.com/docs
- Lizenz: Payload CMS steht unter der MIT.
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.
Wagtail
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Wagtail ist ein Open-Source-Content-Management-System auf Basis des Python-Webframeworks Django. Redakteure pflegen Seiten in einer übersichtlichen Verwaltung, Entwickler legen in Python fest, welche Seitentypen und Felder es gibt. Wagtail steht unter der freien BSD-Lizenz.
Vorbemerkungen
- Kein apt-Paket: Wagtail ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt in einer virtuellen Python-Umgebung mit
pipinstalliert. Python und das Modulvenvkommen aus den Ubuntu-Paketquellen. - Voraussetzung: PostgreSQL ist installiert und läuft. Ohne weitere Einstellungen würde Wagtail eine SQLite-Datei verwenden.
- Seitentypen als Code: Welche Felder eine Seite hat, steht in der Datei
models.py, das Aussehen in HTML-Vorlagen. Diese Anleitung ergänzt die Startseite um ein Textfeld. Grundkenntnisse in Python helfen, sind aber nicht nötig. - Adresse: Wagtail läuft hier im Entwicklungsserver unter http://127.0.0.1:8000, nur vom eigenen Rechner aus erreichbar. Für den echten Betrieb auf einem Server braucht man zusätzlich einen Anwendungsserver wie Gunicorn hinter nginx. Das behandelt diese Anleitung nicht.
- Version: Getestet mit Wagtail 8.0 und Django 6.1 unter Python 3.14 aus Ubuntu 26.04 und PostgreSQL 18.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Modul für virtuelle Umgebungen installieren
Eine virtuelle Umgebung ist ein eigener Ordner mit Python-Paketen nur für dieses Projekt. So kommen sich Wagtail und die Python-Pakete des Systems nicht in die Quere. Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer anlegen
Wagtail meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 11.
sudo -u postgres psql -c "CREATE USER wagtail WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
4. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE wagtail OWNER wagtail ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
Projekt anlegen
5. Projektordner anlegen
mkdir ~/meinwagtail
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinwagtail
7. Virtuelle Umgebung anlegen
Legt die Umgebung im versteckten Unterordner .venv an.
python3 -m venv .venv
8. Virtuelle Umgebung aktivieren
Ab jetzt verwenden python und pip die Umgebung im Projektordner. Vor der Eingabezeile steht (.venv). In jedem neuen Terminal musst du diesen Befehl im Projektordner wiederholen.
source .venv/bin/activate
9. Wagtail installieren
Lädt Wagtail samt Django und allen Bibliotheken in die Umgebung. psycopg verbindet Python mit PostgreSQL, [binary] bringt die dafür nötigen Bibliotheken fertig übersetzt mit.
pip install wagtail "psycopg[binary]"
Prüfen: Die Ausgabe lautet You are using Wagtail 8.0 oder nennt eine neuere Version.
wagtail --version
10. Wagtail-Projekt erzeugen
Legt das Projekt meinewebsite im aktuellen Ordner an (daher der Punkt am Ende). Dazu gehören manage.py für alle Verwaltungsbefehle, der Ordner meinewebsite mit den Einstellungen und die App home mit der Startseite.
wagtail start meinewebsite .
Prüfen: Die Ausgabe endet mit Success! meinewebsite has been created.
11. Eigene Einstellungen anlegen
Das Projekt lädt im Entwicklungsmodus zusätzlich die Datei meinewebsite/settings/local.py, falls es sie gibt. Dort stehen deine Einstellungen, die vorgegebenen Dateien bleiben unverändert.
nano meinewebsite/settings/local.py
Füge diesen Inhalt ein (Strg+Umschalt+V) und setze bei PASSWORD dein Passwort aus Schritt 3 ein:
from .base import INSTALLED_APPS
INSTALLED_APPS = INSTALLED_APPS + ["django.contrib.postgres"]
DATABASES = {
"default": {
"ENGINE": "django.db.backends.postgresql",
"NAME": "wagtail",
"USER": "wagtail",
"PASSWORD": "geheimes_passwort",
"HOST": "127.0.0.1",
"PORT": "5432",
}
}
LANGUAGE_CODE = "de"
TIME_ZONE = "Europe/Berlin"
WAGTAIL_SITE_NAME = "Meine Website"
WAGTAILADMIN_BASE_URL = "http://127.0.0.1:8000"
django.contrib.postgres– die Suche von Wagtail nutzt damit die Volltextsuche von PostgreSQL. Ohne diese Zeile bricht Schritt 12 mit'django.contrib.postgres' must be in INSTALLED_APPSab.DATABASES– die Verbindung zur Datenbank aus Schritt 3 und 4.LANGUAGE_CODEundTIME_ZONE– Verwaltung auf Deutsch, Uhrzeiten in deutscher Zeit.WAGTAIL_SITE_NAME– der Name, der in der Verwaltung erscheint.WAGTAILADMIN_BASE_URL– die Adresse, die Wagtail in Links verwendet, z. B. in E-Mails.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Die Datei enthält das Datenbankpasswort. Legst du später ein Git-Repository an, trage meinewebsite/settings/local.py in die Datei .gitignore ein, damit das Passwort nicht mit hochgeladen wird.
12. Einstellungen prüfen
Django prüft das ganze Projekt, auch die Verbindung zur Datenbank.
python manage.py check
Prüfen: Die Ausgabe lautet System check identified no issues (0 silenced).
13. Tabellen anlegen
Legt alle Tabellen von Django und Wagtail an, dazu eine erste Startseite „Home“.
python manage.py migrate
Prüfen: Die Ausgabe endet mit Zeilen wie Applying wagtailusers.0015_… OK.
14. Administratorkonto anlegen
Fragt nacheinander nach Benutzername, E-Mail-Adresse und zweimal nach dem Passwort. Die Passworteingabe bleibt unsichtbar.
python manage.py createsuperuser
Prüfen: Die letzte Zeile lautet Superuser created successfully.
Startseite um ein Textfeld erweitern
Die Startseite der Vorlage hat nur einen Titel und zeigt eine englische Begrüßung. Die nächsten Schritte geben ihr ein Feld für formatierten Text.
15. Seitenmodell ändern
In home/models.py steht, welche Felder eine Startseite hat.
nano home/models.py
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
from django.db import models
from wagtail.admin.panels import FieldPanel
from wagtail.fields import RichTextField
from wagtail.models import Page
class HomePage(Page):
inhalt = RichTextField(blank=True, verbose_name="Inhalt")
content_panels = Page.content_panels + [
FieldPanel("inhalt"),
]
RichTextField– ein Feld für Text mit Überschriften, Fettdruck, Listen und Links.blank=Trueerlaubt, es leer zu lassen.content_panels– zeigt das Feld in der Verwaltung unter dem Titel an.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Vorlage der Startseite ersetzen
Die Vorlage bestimmt, wie die Startseite im Browser aussieht.
nano home/templates/home/home_page.html
Ersetze den ganzen Inhalt wie in Schritt 15 und füge ein:
{% extends "base.html" %}
{% load wagtailcore_tags %}
{% block body_class %}template-homepage{% endblock %}
{% block content %}
<main>
<h1>{{ page.title }}</h1>
{{ page.inhalt|richtext }}
</main>
{% endblock content %}
{% extends "base.html" %}– übernimmt das Grundgerüst der Seite ausmeinewebsite/templates/base.html.{{ page.title }}– der Titel der Seite.{{ page.inhalt|richtext }}– der Text aus dem neuen Feld.richtextwandelt die internen Links von Wagtail in normale Adressen um.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
17. Sprache im Grundgerüst auf Deutsch stellen
Das Grundgerüst gibt die Sprache der Seite fest als Englisch an. Browser und Vorleseprogramme richten sich danach, z. B. bei der Silbentrennung und der Aussprache.
nano meinewebsite/templates/base.html
Drücke Strg+W, gib lang="en" ein und drücke Enter. Ändere die Zeile in:
<html lang="de">
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Migration erzeugen
Django vergleicht models.py mit der Datenbank und schreibt die nötige Änderung als Datei in home/migrations.
python manage.py makemigrations
Prüfen: Die Ausgabe enthält + Add field inhalt to homepage.
19. Migration anwenden
Fügt der Tabelle der Startseite die neue Spalte hinzu.
python manage.py migrate
Prüfen: Die Ausgabe enthält Applying home.0003_homepage_inhalt... OK.
Wagtail verwenden
20. Entwicklungsserver starten
Startet den eingebauten Webserver von Django. Er lädt geänderte Python-Dateien und Vorlagen automatisch neu. Das Terminal bleibt dabei belegt.
python manage.py runserver
Prüfen: Die Ausgabe enthält Starting WSGI development server at http://127.0.0.1:8000/. Die Warnung This is a development server darunter erinnert nur daran, dass dieser Server nicht für den echten Betrieb gedacht ist.
21. An der Verwaltung anmelden
Öffne http://127.0.0.1:8000/admin/ im Browser und melde dich mit dem Konto aus Schritt 14 an.
Prüfen: Das Dashboard zeigt „Meine Website“ und „1 Seite erstellt in Meine Website“. Links stehen „Seiten“, „Bilder“, „Dokumente“, „Berichte“ und „Einstellungen“.
22. Startseite bearbeiten
- Klicke links auf Seiten und dann auf Home.
- Ändere den Titel, z. B. in
Willkommen. - Schreibe im Feld Inhalt einen Text. Über das Pluszeichen am Zeilenanfang fügst du Überschriften, Listen und Bilder ein.
- Klicke unten auf den Pfeil neben Entwurf speichern und wähle Veröffentlichen.
„Entwurf speichern“ allein sichert die Änderung, ohne sie auf der Website zu zeigen.
23. Website ansehen
Öffne http://127.0.0.1:8000 im Browser.
Prüfen: Titel und Text aus Schritt 22 erscheinen. Das Aussehen ist noch schlicht. Stylesheets legst du in meinewebsite/static/css/meinewebsite.css ab, das Grundgerüst bindet die Datei schon ein.
Beende den Server im Terminal mit Strg+C.
Aktualisieren
Lege vorher eine Sicherung des Projektordners und der Datenbank an.
1. In den Projektordner wechseln
cd ~/meinwagtail
2. Virtuelle Umgebung aktivieren
source .venv/bin/activate
3. Wagtail aktualisieren
-U holt die neueste Version, zusammen mit einer passenden Django-Version. Beim Sprung auf eine neue Hauptversion (z. B. von 8 auf 9) liest man vorher die Hinweise unter https://docs.wagtail.org.
pip install -U wagtail
Prüfen: wagtail --version zeigt die neue Versionsnummer.
4. Datenbank anpassen
Neue Versionen bringen oft geänderte Tabellen mit.
python manage.py migrate
Prüfen: Die Ausgabe endet mit OK-Zeilen oder mit No migrations to apply.
Deinstallieren
1. Server beenden
Läuft der Entwicklungsserver noch in einem Terminal, beende ihn dort mit Strg+C.
2. Virtuelle Umgebung verlassen
Ist vor der Eingabezeile noch (.venv) zu sehen, verlässt du die Umgebung mit:
deactivate
3. Projektordner löschen
Achtung: Damit sind auch der Code, die Vorlagen und die hochgeladenen Bilder und Dokumente gelöscht. Die Uploads liegen in ~/meinwagtail/media. Die virtuelle Umgebung mit Wagtail liegt ebenfalls im Projektordner und verschwindet mit.
rm -r ~/meinwagtail
4. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS wagtail;"
5. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS wagtail;"
Prüfen: Der Server ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://127.0.0.1:8000
6. pip-Zwischenspeicher leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
python3 -m pip cache purge
Python, python3-venv und PostgreSQL bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.wagtail.org/
- Lizenz: Wagtail steht unter der BSD-3-Clause.
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.
MediaWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
MediaWiki ist eine leistungsfähige Open-Source-Wiki-Software, die unter anderem die freie Enzyklopädie Wikipedia antreibt. Auf dem Entwicklungsrechner dient sie dazu, Wissenssammlungen, Dokumentationen oder eigene Erweiterungen lokal mit nginx, PHP und PostgreSQL einzurichten und zu testen.
Vorbemerkungen
- Voraussetzungen: nginx, PHP mit PHP-FPM und PostgreSQL sind nach den jeweiligen Anleitungen installiert und laufen.
- Installation über Git: Ubuntu enthält zwar ein Paket
mediawiki, diese Anleitung holt MediaWiki aber direkt aus dem Git-Repository des Projekts. So lässt sich der Quellcode leicht untersuchen, auf neue Versionen umstellen und für eigene Erweiterungen nutzen. - Version: Verwendet wird die Version mit Langzeitunterstützung (LTS) 1.43 (Git-Zweig
REL1_43). Sie läuft auch mit PHP 8.5 aus Ubuntu 26.04 ohne Fehlermeldungen. - Passwörter:
geheimes_passwortundAdminPasswort123sind Beispiele. Ersetze sie überall durch eigene Passwörter.
Vorbereitung und Abhängigkeiten
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. PHP-Erweiterungen, Git und Composer installieren
MediaWiki braucht neben git und dem PHP-Paketmanager composer Module für die PostgreSQL-Anbindung (php-pgsql), Unicode-Verarbeitung (php-intl), Bildbearbeitung (php-gd), Zwischenspeicher (php-apcu), Netzwerkzugriffe (php-curl), Zeichenketten (php-mbstring) und XML (php-xml).
sudo apt install git composer php-pgsql php-intl php-gd php-apcu php-curl php-mbstring php-xml
Prüfen: Die Liste enthält apcu, gd, intl und pgsql.
php -m | grep -E "^(pgsql|intl|gd|apcu)$"
3. PHP-FPM neu starten
PHP-FPM lädt neu installierte Module erst nach einem Neustart. Ohne diesen Schritt kennt der Webserver z. B. die PostgreSQL-Anbindung noch nicht.
sudo systemctl restart php8.5-fpm
Datenbank in PostgreSQL einrichten
4. Datenbankbenutzer für MediaWiki anlegen
Erstellt einen eigenen Benutzer wikiuser in PostgreSQL. MediaWiki meldet sich mit diesem Benutzer und Passwort an der Datenbank an.
sudo -u postgres psql -c "CREATE USER wikiuser WITH PASSWORD 'geheimes_passwort';"
5. Datenbank für MediaWiki anlegen
Erstellt die leere Datenbank wikidb und macht wikiuser zu ihrem Eigentümer.
sudo -u postgres psql -c "CREATE DATABASE wikidb OWNER wikiuser;"
Prüfen: Die Datenbank wird in der Datenbankliste aufgeführt.
sudo -u postgres psql -l | grep wikidb
MediaWiki per Git herunterladen und einrichten
6. MediaWiki per Git klonen
Klont die LTS-Version in das Verzeichnis /var/www/mediawiki. Mit --depth 1 wird nur der aktuelle Stand ohne die gesamte Versionsgeschichte geladen, das spart Zeit und Speicherplatz.
sudo git clone -b REL1_43 --depth 1 https://gerrit.wikimedia.org/r/mediawiki/core.git /var/www/mediawiki
Prüfen: Das Verzeichnis enthält unter anderem index.php und composer.json.
ls /var/www/mediawiki
7. Standard-Design (Vector) per Git klonen
MediaWiki trennt den Kern von den Designs (Skins). Das bekannte Design Vector wird separat in den Ordner skins/Vector geklont. Der Git-Zweig muss zur Version von MediaWiki passen.
sudo git clone -b REL1_43 --depth 1 https://gerrit.wikimedia.org/r/mediawiki/skins/Vector /var/www/mediawiki/skins/Vector
8. Eigentümer auf deinen Benutzer ändern
Die Dateien gehören nach dem Klonen root. Als Entwickler sollst du sie ohne sudo bearbeiten, mit Git aktualisieren und Composer ausführen können. Der Webserver braucht nur Lesezugriff, der ohnehin besteht. Schreibrechte bekommt er in Schritt 12 gezielt für zwei Ordner.
sudo chown -R "$USER":"$USER" /var/www/mediawiki
9. Externe PHP-Bibliotheken mit Composer installieren
Installiert alle in composer.json festgelegten Bibliotheken in den Ordner vendor/. --no-dev lässt Werkzeuge weg, die nur zum Testen von MediaWiki selbst gebraucht werden.
composer install --no-dev -d /var/www/mediawiki
Prüfen: Der Ordner vendor enthält jetzt Unterordner, z. B. wikimedia.
ls /var/www/mediawiki/vendor
MediaWiki installieren
10. MediaWiki über die Kommandozeile installieren
Das Installationsskript legt die Tabellen in PostgreSQL an, erstellt das Administratorkonto WikiAdmin und schreibt die zentrale Einstellungsdatei LocalSettings.php. Die wichtigsten Angaben:
--server– Adresse, unter der das Wiki erreichbar ist (mit Port, sonst zeigen Links ins Leere)--scriptpath ""– das Wiki liegt direkt unter/, nicht in einem Unterordner--lang de– Oberfläche und Seitennamen auf Deutsch (z. B. „Hauptseite“)- die beiden letzten Angaben – Name des Wikis und Name des Administratorkontos
Das Skript erkennt das Design Vector im Ordner skins von selbst und trägt es in LocalSettings.php ein.
php /var/www/mediawiki/maintenance/run.php install \
--dbtype postgres \
--dbserver 127.0.0.1 \
--dbname wikidb \
--dbuser wikiuser \
--dbpass 'geheimes_passwort' \
--pass 'AdminPasswort123' \
--server http://localhost:8085 \
--scriptpath "" \
--lang de \
"Mein Entwicklungs-Wiki" \
WikiAdmin
Prüfen: Die Ausgabe endet mit MediaWiki wurde erfolgreich installiert. In LocalSettings.php stehen die Adresse und das Design:
grep -E "wgServer|wfLoadSkin" /var/www/mediawiki/LocalSettings.php
11. Kurze Adressen einschalten
Ohne diese Einstellung erzeugt MediaWiki Links wie /index.php?title=Hauptseite. Mit ihr heißen sie einfach /Hauptseite. Die nginx-Konfiguration in Schritt 14 ist darauf abgestimmt.
nano /var/www/mediawiki/LocalSettings.php
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
$wgArticlePath = "/$1";
12. Schreibrechte für den Webserver vergeben
Der Webserver läuft als Benutzer www-data. Er muss hochgeladene Dateien im Ordner images speichern und im Ordner cache Zwischenergebnisse ablegen können.
sudo chown -R www-data:www-data /var/www/mediawiki/images /var/www/mediawiki/cache
13. Einstellungsdatei schützen
LocalSettings.php enthält das Datenbank-Passwort. Diese beiden Befehle erlauben das Lesen nur noch dir und der Gruppe www-data, also dem Webserver.
sudo chgrp www-data /var/www/mediawiki/LocalSettings.php
chmod 640 /var/www/mediawiki/LocalSettings.php
Prüfen: Die Rechte lauten -rw-r-----, die Gruppe ist www-data.
ls -l /var/www/mediawiki/LocalSettings.php
nginx konfigurieren
14. Konfiguration für MediaWiki anlegen
Erstellt einen eigenen Server-Block auf Port 8085, der nur vom eigenen Rechner aus erreichbar ist. Die Reihenfolge der Blöcke ist wichtig: nginx prüft Blöcke mit regulären Ausdrücken (~) von oben nach unten und nimmt den ersten Treffer. Deshalb stehen die Sperren für interne Ordner, versteckte Dateien (z. B. den Ordner .git) und Konfigurationsdateien vor dem Block, der PHP-Dateien ausführt. Für kurze Adressen wie /Hauptseite gibt es keine Datei. try_files übergibt sie deshalb an index.php. MediaWiki liest den Seitennamen aus der ursprünglichen Adresse, die nginx als REQUEST_URI mitschickt, und vergleicht sie mit $wgArticlePath aus Schritt 11.
sudo nano /etc/nginx/sites-available/mediawiki
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8085;
server_name localhost;
root /var/www/mediawiki;
index index.php;
client_max_body_size 20m;
# Interne Ordner und versteckte Dateien (z. B. .git) sperren
location ~ /\. {
return 403;
}
location ~ ^/(cache|includes|languages|maintenance|serialized|tests|vendor)/ {
return 403;
}
location ~ \.(lock|json|yml|yaml|md)$ {
return 403;
}
# Im Upload-Ordner keine PHP-Dateien ausführen
location ^~ /images/ {
location ~ \.php$ {
return 403;
}
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
# Statische Dateien zwischenspeichern; fehlt die Datei, ist es eine
# Wiki-Seite wie /Datei:Bild.png
location ~* \.(js|css|png|jpe?g|gif|ico|svg|webp|woff2?)$ {
try_files $uri /index.php?$args;
expires 7d;
access_log off;
}
# Kurze Adressen: Was es nicht als Datei gibt, bekommt index.php.
# MediaWiki liest den Seitennamen selbst aus der ursprünglichen Adresse.
location / {
try_files $uri $uri/ /index.php?$args;
}
}
15. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/mediawiki /etc/nginx/sites-enabled/mediawiki
16. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
17. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Testen
18. Hauptseite abrufen
Prüft, ob das Wiki unter der kurzen Adresse antwortet.
curl -sI http://localhost:8085/Hauptseite
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK. Im Browser leitet http://localhost:8085 auf die Hauptseite deines Wikis im Vector-Design weiter. Oben rechts kannst du dich mit WikiAdmin und dem Administrator-Passwort anmelden.
19. Sperren prüfen
Stichprobe, ob interne Dateien wirklich gesperrt sind. Hier am Beispiel des Git-Ordners, der sonst die Versionsgeschichte preisgeben würde.
curl -sI http://localhost:8085/.git/config
Prüfen: Die erste Zeile lautet HTTP/1.1 403 Forbidden.
Soll das Wiki unter einer eigenen Domain erreichbar sein, geht es weiter mit MediaWiki mit nginx unter eigener Domain.
Aktualisieren
Innerhalb der Version 1.43 erscheinen regelmäßig Fehler- und Sicherheitskorrekturen. So holst du sie:
1. Neuen Stand von MediaWiki holen
Lädt die Änderungen des Git-Zweigs REL1_43 herunter.
git -C /var/www/mediawiki pull
2. Neuen Stand des Designs holen
Das Design Vector ist ein eigenes Git-Repository und wird getrennt aktualisiert.
git -C /var/www/mediawiki/skins/Vector pull
3. Bibliotheken angleichen
Bringt die Bibliotheken in vendor/ auf den Stand, den die neue MediaWiki-Version erwartet.
composer update --no-dev -d /var/www/mediawiki
4. Datenbank anpassen
Passt die Tabellen an die neue Version an, falls nötig. --quick überspringt die Wartezeit vor dem Start.
php /var/www/mediawiki/maintenance/run.php update --quick
Prüfen: Die Ausgabe endet mit Done. Die Seite http://localhost:8085/Spezial:Version zeigt die neue Versionsnummer.
Deinstallieren
1. Seite in nginx deaktivieren
Löscht den Link aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/mediawiki
2. nginx-Konfigurationsdatei löschen
Löscht die Konfigurationsdatei der Seite.
sudo rm -f /etc/nginx/sites-available/mediawiki
3. nginx neu laden
Übernimmt das Abschalten der Seite.
sudo systemctl reload nginx
4. MediaWiki-Dateien löschen
Entfernt den gesamten MediaWiki-Ordner. Achtung: Auch hochgeladene Dateien im Ordner images gehen verloren.
sudo rm -rf /var/www/mediawiki
5. MediaWiki-Datenbank löschen
Löscht die Datenbank wikidb. Achtung: Alle Seiten und Daten des Wikis werden dabei unwiderruflich gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS wikidb;"
6. Datenbankbenutzer löschen
Löscht den Benutzer wikiuser.
sudo -u postgres psql -c "DROP USER IF EXISTS wikiuser;"
7. Nicht mehr benötigte Pakete entfernen (optional)
Entfernt Composer und den PHP-Zwischenspeicher, falls sie nicht für andere Projekte gebraucht werden. Die übrigen PHP-Module aus Schritt 2 brauchen oft auch andere PHP-Anwendungen und bleiben deshalb erhalten.
sudo apt purge composer php-apcu
sudo apt autoremove
Prüfen: Unter http://localhost:8085 antwortet kein Webserver mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8085/
Quellen und Lizenz
- Offizielle Dokumentation: https://www.mediawiki.org/wiki/Documentation
- Lizenz: MediaWiki steht unter der GPL-2.0-or-later.
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.
Semantic MediaWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Semantic MediaWiki (SMW) ist eine Erweiterung für MediaWiki, mit der man Wiki-Seiten maschinenlesbare Angaben wie „Einwohner: 34.800“ geben kann. Diese Angaben lassen sich danach wie in einer Datenbank abfragen, sortieren und als Tabelle oder Liste auf anderen Seiten anzeigen. Diese Anleitung ergänzt ein vorhandenes MediaWiki mit PostgreSQL um SMW.
Vorbemerkungen
- Voraussetzung: MediaWiki ist nach der Anleitung MediaWiki installiert. Es liegt in
/var/www/mediawiki, nutzt die PostgreSQL-Datenbankwikidb, läuft unter http://localhost:8085, und Composer ist installiert. - Keine Installation über apt: SMW gibt es nicht als Ubuntu-Paket. Es wird wie die Bibliotheken von MediaWiki mit Composer installiert.
- Version: Die Anleitung verwendet SMW 7.3. Getestet mit MediaWiki 1.43, PHP 8.5 und PostgreSQL 18. SMW 7 unterstützt laut Projekt MediaWiki 1.43 bis 1.46, PHP 8.1 bis 8.5 und PostgreSQL ab Version 10.
- Neu seit SMW 7: Ältere Anleitungen nennen noch die Zeile
enableSemantics( … );inLocalSettings.php. Seit Version 7 ist sie überflüssig und erzeugt nur eine Warnung.
Installation
1. In den MediaWiki-Ordner wechseln
Composer und die Wartungsskripte von MediaWiki arbeiten im Ordner des Wikis.
cd /var/www/mediawiki
2. SMW in die lokale Composer-Datei eintragen
MediaWiki liest neben seiner eigenen composer.json auch eine Datei composer.local.json. Dort stehen Erweiterungen, die du selbst hinzufügst. So bleiben sie beim Aktualisieren von MediaWiki erhalten.
nano composer.local.json
Gibt es die Datei noch nicht, füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
{
"require": {
"mediawiki/semantic-media-wiki": "~7.3"
}
}
~7.3 bedeutet: Version 7.3 oder eine neuere 7.x-Version, aber nicht 8.0. So kommen Fehlerkorrekturen automatisch, ein großer Versionssprung aber nur, wenn du ihn hier einträgst.
Gibt es die Datei schon mit anderen Einträgen, füge nur die Zeile "mediawiki/semantic-media-wiki": "~7.3" in den Block "require" ein. Die Zeile davor braucht dann ein Komma am Ende.
3. SMW herunterladen
Composer liest composer.local.json mit ein, lädt SMW nach extensions/SemanticMediaWiki und installiert die Bibliotheken, die SMW braucht. --no-dev lässt Werkzeuge weg, die nur für die Entwicklung von SMW selbst gedacht sind.
composer update --no-dev
Prüfen: Die Zeile versions zeigt * 7.3.0 oder eine neuere 7.x-Version.
composer show mediawiki/semantic-media-wiki | grep versions
4. SMW in MediaWiki einschalten
Die Erweiterung liegt jetzt im Ordner, MediaWiki lädt sie aber erst nach einem Eintrag in LocalSettings.php.
nano LocalSettings.php
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
wfLoadExtension( 'SemanticMediaWiki' );
nano behält beim Speichern Eigentümer und Rechte der Datei bei. Andere Werkzeuge wie sed -i legen die Datei neu an. Dann verliert sie die Gruppe www-data, und das Wiki meldet LocalSettings.php not readable.
5. Datenbanktabellen anlegen
Das Update-Skript von MediaWiki legt jetzt auch die Tabellen von SMW in PostgreSQL an. --quick überspringt die Wartezeit vor dem Start.
php maintenance/run.php update --quick
Prüfen: Die Ausgabe enthält keine Fehlermeldung. In der Datenbank gibt es jetzt rund 40 Tabellen, deren Name mit smw beginnt.
sudo -u postgres psql -d wikidb -c "\dt smw*"
6. Vorhandene Seiten auswerten (nur bei einem Wiki mit Inhalt)
Enthält das Wiki schon Seiten, liest dieses Skript sie einmal komplett durch und übernimmt vorhandene Angaben in die SMW-Tabellen. Bei einem frisch installierten Wiki kannst du den Schritt überspringen. -v zeigt den Fortschritt an.
php maintenance/run.php SemanticMediaWiki:rebuildData -v
7. Installation prüfen
Die Seite Spezial:Version listet alle geladenen Erweiterungen auf.
curl -s http://localhost:8085/Spezial:Version | grep -o "Semantic MediaWiki" | head -1
Prüfen: Die Ausgabe lautet Semantic MediaWiki. Im Browser steht auf http://localhost:8085/Spezial:Version auch die Versionsnummer. Die Seite http://localhost:8085/Spezial:SemanticMediaWiki zeigt Einstellungen und Wartungsfunktionen.
Ausprobieren
Die folgenden Schritte legen zwei Städte mit Angaben an und zeigen sie in einer automatisch erzeugten Tabelle. Die Seiten entstehen hier mit dem Wartungsskript edit, damit die Befehle direkt kopiert werden können. Im Browser geht es genauso: Seite aufrufen, Bearbeiten, Text eingeben, speichern. WikiAdmin ist das Administratorkonto aus der MediaWiki-Anleitung.
8. Eigenschaft „Einwohner“ als Zahl festlegen
In SMW heißen Eigenschaften auf Deutsch Attribute. Jedes Attribut hat eine eigene Seite, auf der sein Datentyp steht. Ohne Angabe gilt ein Wert als Name einer Wiki-Seite. Für Einwohnerzahlen soll der Typ Zahl gelten, damit SMW richtig sortiert und rechnet.
echo 'Diese Eigenschaft ist vom Typ [[Datentyp::Zahl]].' | php maintenance/run.php edit --user WikiAdmin "Attribut:Einwohner"
Prüfen: Die Ausgabe lautet Saving...done.
9. Eigenschaft „Bundesland“ als Seite festlegen
Das Bundesland soll auf eine eigene Wiki-Seite verweisen, deshalb bekommt dieses Attribut den Typ Seite.
echo 'Diese Eigenschaft ist vom Typ [[Datentyp::Seite]].' | php maintenance/run.php edit --user WikiAdmin "Attribut:Bundesland"
10. Erste Stadt anlegen
Eine Angabe schreibt man wie einen Wiki-Link, nur mit Attribut und zwei Doppelpunkten davor: [[Einwohner::1910000]]. Im Text erscheint nur der Wert, SMW merkt sich zusätzlich die Angabe. Die Kategorie hilft später bei der Abfrage.
echo 'Hamburg hat [[Einwohner::1910000]] Einwohner und liegt im Bundesland [[Bundesland::Hamburg]]. [[Kategorie:Stadt]]' | php maintenance/run.php edit --user WikiAdmin "Hamburg"
11. Zweite Stadt anlegen
Dasselbe für eine zweite Stadt.
echo 'Ahrensburg hat [[Einwohner::34800]] Einwohner und liegt in [[Bundesland::Schleswig-Holstein]]. [[Kategorie:Stadt]]' | php maintenance/run.php edit --user WikiAdmin "Ahrensburg"
12. Abfrage-Seite anlegen
Die Funktion #ask sucht alle Seiten der Kategorie Stadt. Die Zeilen mit ? legen fest, welche Attribute als Spalten erscheinen. sort und order=desc sortieren nach Einwohnerzahl, die größte Stadt zuerst.
echo '{{#ask: [[Kategorie:Stadt]] |?Einwohner |?Bundesland |sort=Einwohner |order=desc}}' | php maintenance/run.php edit --user WikiAdmin "Städte"
13. Warteschlange abarbeiten
MediaWiki erledigt manche Arbeiten nach dem Speichern erst später, beim nächsten Seitenaufruf. Dieser Befehl arbeitet die Warteschlange sofort ab.
php maintenance/run.php runJobs
14. Ergebnis ansehen
Ruft die Seite Städte ab und sucht die Einwohnerzahlen in der erzeugten Tabelle.
curl -s http://localhost:8085/St%C3%A4dte | grep -oE "1\.910\.000|34\.800"
Prüfen: Die Ausgabe zeigt 1.910.000 und darunter 34.800. Im Browser zeigt http://localhost:8085/Städte eine Tabelle mit den Spalten Einwohner und Bundesland. Legst du eine weitere Stadt mit Kategorie an, erscheint sie dort automatisch. Eigene Abfragen kannst du auf Spezial:Semantische Suche zusammenklicken.
Aktualisieren
Innerhalb von Version 7 holt Composer neue Versionen automatisch, weil in composer.local.json ~7.3 steht.
1. In den MediaWiki-Ordner wechseln
Composer arbeitet im Ordner des Wikis.
cd /var/www/mediawiki
2. Neue Version herunterladen
Aktualisiert SMW und die übrigen Bibliotheken von MediaWiki.
composer update --no-dev
3. Datenbank anpassen
Passt die Tabellen von MediaWiki und SMW bei Bedarf an die neuen Versionen an.
php maintenance/run.php update --quick
Prüfen: Die neue Versionsnummer steht auf Spezial:Version.
Für einen Sprung auf eine neue Hauptversion (z. B. 8.x) änderst du vorher die Zeile in composer.local.json und liest die Hinweise zur neuen Version auf https://github.com/SemanticMediaWiki/SemanticMediaWiki/releases.
Deinstallieren
MediaWiki selbst bleibt dabei erhalten. Nur SMW und seine Daten werden entfernt.
1. In den MediaWiki-Ordner wechseln
Alle folgenden Befehle arbeiten im Ordner des Wikis.
cd /var/www/mediawiki
2. SMW-Daten aus der Datenbank löschen
Löscht alle SMW-Tabellen und damit alle gespeicherten Angaben. Das Skript geht nur, solange SMW noch eingeschaltet ist, deshalb kommt es zuerst. Zur Sicherheit fragt es nach: Tippe DELETE in Großbuchstaben und drücke Enter. Jede andere Eingabe bricht ab. Die Angaben im Text der Seiten, z. B. [[Einwohner::34800]], bleiben erhalten. Sie werden danach als normale Links angezeigt.
php maintenance/run.php SemanticMediaWiki:setupStore --delete
3. SMW in MediaWiki ausschalten
Öffnet LocalSettings.php, um die Zeile aus Schritt 4 der Installation zu entfernen.
nano LocalSettings.php
Suche mit Strg+W nach SemanticMediaWiki und bestätige mit Enter. Lösche die Zeile wfLoadExtension( 'SemanticMediaWiki' ); mit Strg+K, speichere mit Strg+O und Enter und beende nano mit Strg+X.
4. SMW aus der Composer-Datei entfernen
Öffnet composer.local.json.
nano composer.local.json
Lösche die Zeile mit mediawiki/semantic-media-wiki (Suchen mit Strg+W, Löschen mit Strg+K). Stand SMW als einziger Eintrag in der Datei, bleibt ein leerer Block "require": {} stehen. Das ist in Ordnung. Achte darauf, dass die letzte verbleibende Zeile im Block kein Komma am Ende hat. Speichere und beende nano wie gewohnt.
5. SMW-Dateien entfernen
Composer entfernt jetzt den Ordner extensions/SemanticMediaWiki und alle Bibliotheken, die nur SMW gebraucht hat.
composer update --no-dev
Prüfen: Der Ordner existiert nicht mehr, und das Wiki antwortet weiterhin.
ls extensions/SemanticMediaWiki
curl -sI http://localhost:8085/Hauptseite
Der erste Befehl meldet No such file or directory, der zweite beginnt mit HTTP/1.1 200 OK.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.semantic-mediawiki.org/wiki/Help:User_manual
- Lizenz: Semantic MediaWiki steht unter der GPL-2.0-or-later.
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.
Pywikibot
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mit Pywikibot schreibst du in Python kleine Programme („Bots“), die in einem MediaWiki ohne Klicken im Browser Seiten lesen, anlegen und ändern. Für häufige Aufgaben wie Suchen und Ersetzen über viele Seiten oder das Einsortieren in Kategorien bringt es fertige Skripte mit. Die Wikipedia-Bots arbeiten seit vielen Jahren damit.
Vorbemerkungen
- Voraussetzung: Ein laufendes MediaWiki, auf dem du ein Benutzerkonto hast. Die Anleitung verwendet das Wiki aus der MediaWiki-Anleitung unter
http://localhost:8085mit dem KontoWikiAdmin. Für ein anderes Wiki ersetzt du Adresse und Benutzernamen. - Installation über pip: Ubuntu hat kein Paket für Pywikibot. Es wird mit
pipin eine virtuelle Umgebung (venv) installiert, einen eigenen Ordner nur für dieses Projekt. Ubuntu verhindert absichtlich, dasspipPakete systemweit installiert, siehe Python. - Version: Getestet mit Pywikibot 11.7.0, Python 3.14 aus Ubuntu 26.04 und MediaWiki 1.43.
- Fremde Wikis: Auf Wikipedia und anderen öffentlichen Wikis darf ein Bot erst nach Genehmigung durch die jeweilige Gemeinschaft schreiben. Probiere Bots deshalb im eigenen Wiki aus.
- Passwort: Der Bot meldet sich nicht mit deinem normalen Passwort an, sondern mit einem Bot-Passwort. Das erlaubt nur ausgewählte Rechte und lässt sich jederzeit einzeln löschen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von python3-venv kennt.
sudo apt update
2. Werkzeug für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Python selbst ist unter Ubuntu schon installiert.
sudo apt install python3-venv
3. Projektordner anlegen
In diesem Ordner liegen später die virtuelle Umgebung, die Einstellungen des Bots und deine eigenen Skripte.
mkdir ~/pywikibot
4. In den Projektordner wechseln
Pywikibot sucht seine Einstellungsdateien im aktuellen Ordner. Alle weiteren Befehle werden deshalb hier ausgeführt.
cd ~/pywikibot
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an. Dort landen alle Python-Pakete dieses Projekts.
python3 -m venv .venv
6. Virtuelle Umgebung einschalten
Danach verwenden python, pip und pwb in diesem Terminal die Programme aus .venv. Das gilt nur für das aktuelle Terminal. In einem neuen Terminal wiederholst du die Schritte 4 und 6.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. Pywikibot installieren
pywikibot ist die Bibliothek mit dem Startprogramm pwb. pywikibot-scripts enthält die fertigen Bot-Skripte, z. B. zum Ergänzen von Text oder Ersetzen von Begriffen.
pip install pywikibot pywikibot-scripts
Prüfen: Die Ausgabe enthält Release version: 11.7.0 (oder eine neuere Nummer).
pwb version
Bot-Passwort im Wiki anlegen
8. Seite für Bot-Passwörter öffnen
Öffne http://localhost:8085/Spezial:BotPasswords im Browser und melde dich mit WikiAdmin an. Die Seite heißt auf Deutsch „Botpasswörter“.
9. Bot-Passwort erstellen
Trage bei Name des Bots Pywikibot ein und klicke auf Erstellen. Hake auf der nächsten Seite unter Anwendbare Berechtigungen diese Punkte an:
- (Bot-)Massenbearbeitungen
- Vorhandene Seiten bearbeiten
- Seiten erstellen, bearbeiten und verschieben
Klicke unten erneut auf Erstellen. Nur diese Rechte stehen dem Bot später zur Verfügung, auch wenn dein Konto mehr darf.
Prüfen: Es erscheint „Botpasswort erstellt“ mit einem 32 Zeichen langen Passwort. Kopiere es jetzt, denn das Wiki zeigt es nur dieses eine Mal an.
Pywikibot einrichten
10. Wiki bei Pywikibot bekannt machen
Pywikibot kennt Wikipedia und die anderen Wikimedia-Projekte bereits. Für ein eigenes Wiki braucht es eine sogenannte Familien-Datei. Der Befehl liest die nötigen Angaben über die Schnittstelle des Wikis aus und nennt die Familie meinwiki. Das n am Ende beantwortet die Frage nach weiteren Sprachversionen des Wikis mit Nein.
pwb generate_family_file http://localhost:8085/Hauptseite meinwiki n
Prüfen: Die Ausgabe zeigt API url: http://localhost:8085/api.php und die MediaWiki-Version und endet mit Writing …/families/meinwiki_family.py.
11. Benutzereinstellungen erzeugen
Der Befehl fragt nacheinander alles ab, was Pywikibot über dich und dein Wiki wissen muss, und schreibt daraus die Dateien user-config.py und user-password.cfg.
pwb generate_user_files
Beantworte die Fragen so:
| Frage | Eingabe |
|---|---|
Select family of sites we are working on | meinwiki |
The site code of the site we're working on (default: de) | Enter |
Username on de:meinwiki | WikiAdmin |
Do you want to add any other projects? | n |
Do you want to add a BotPassword for WikiAdmin? | y |
BotPassword's "bot name" for WikiAdmin | Pywikibot |
BotPassword's "password" for "Pywikibot" | das Passwort aus Schritt 9 (die Eingabe bleibt unsichtbar) |
Do you want to select framework setting sections? | Enter |
Do you want to select scripts setting sections? | Enter |
Prüfen: Die Ausgabe endet mit user-config.py' written. und user-password.cfg' written.. Die Passwortdatei darf nur dein Benutzer lesen, ls zeigt deshalb -rw-------.
ls -l user-config.py user-password.cfg
12. Anmeldung testen
Meldet den Bot mit dem Bot-Passwort am Wiki an.
pwb login
Prüfen: Die Ausgabe lautet Logged in on meinwiki:de as WikiAdmin.
Erste Schritte
13. Mit einem fertigen Skript eine Seite schreiben
Das Skript add_text hängt Text an eine Seite an. Die Angaben bedeuten:
-page:Spielwiese– die Seite, die bearbeitet wird-text:…– der Text, der angehängt wird-summary:…– die Zusammenfassung, die in der Versionsgeschichte steht-create– die Seite anlegen, falls es sie noch nicht gibt-always– nicht vor jeder Änderung nachfragen
pwb add_text -page:Spielwiese -text:"Diese Zeile hat Pywikibot geschrieben." -summary:"Test mit Pywikibot" -create -always
Prüfen: Die Ausgabe endet mit Script terminated successfully. Die Seite http://localhost:8085/Spielwiese enthält den Satz. In ihrer Versionsgeschichte steht WikiAdmin mit der Zusammenfassung „Test mit Pywikibot“.
Pywikibot wartet zwischen zwei Schreibvorgängen absichtlich etwa zehn Sekunden, um das Wiki nicht zu überlasten. Eine einzelne Änderung dauert deshalb spürbar länger als ein Lesezugriff.
Die mitgelieferten Skripte liegen als Python-Dateien in der virtuellen Umgebung. Dieser Befehl listet sie auf:
ls .venv/lib/python3*/site-packages/pywikibot_scripts
Was ein Skript kann und welche Angaben es versteht, zeigt -help, z. B.:
pwb replace -help
14. Ein eigenes Skript schreiben
Ein eigener Bot ist eine kurze Python-Datei. Lege sie im Projektordner an:
nano seitenliste.py
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import pywikibot
site = pywikibot.Site()
for page in site.allpages():
print(page.title(), len(page.text), "Zeichen")
pywikibot.Site() verbindet sich mit dem Wiki aus user-config.py. allpages() liefert nacheinander alle Seiten, page.text den Wikitext der Seite.
15. Eigenes Skript ausführen
pwb findet Skripte im aktuellen Ordner. Der Name wird ohne .py angegeben.
pwb seitenliste
Prüfen: Jede Seite des Wikis erscheint mit ihrer Länge, z. B. Spielwiese 38 Zeichen.
Aktualisieren
1. In den Projektordner wechseln
cd ~/pywikibot
2. Virtuelle Umgebung einschalten
source .venv/bin/activate
3. Neue Version installieren
--upgrade ersetzt beide Pakete durch die neueste Version. Einstellungen, Familien-Datei und eigene Skripte bleiben erhalten.
pip install --upgrade pywikibot pywikibot-scripts
Prüfen: pwb version zeigt die neue Versionsnummer.
Deinstallieren
1. Virtuelle Umgebung ausschalten
Falls sie im aktuellen Terminal noch eingeschaltet ist. (.venv) verschwindet aus der Eingabeaufforderung.
deactivate
2. Projektordner löschen
Entfernt Pywikibot, die Einstellungen mit dem Bot-Passwort und die eigenen Skripte. Achtung: Wer eigene Skripte behalten will, kopiert sie vorher an einen anderen Ort.
rm -r ~/pywikibot
3. Bot-Passwort im Wiki löschen
Öffne http://localhost:8085/Spezial:BotPasswords, klicke unter Vorhandene Botpasswörter auf Pywikibot und dann auf Löschen. Danach kann sich niemand mehr mit diesem Passwort anmelden, auch wenn es noch irgendwo gespeichert ist.
python3-venv bleibt installiert, weil andere Anleitungen es ebenfalls verwenden.
Prüfen: Der Ordner ist verschwunden.
ls ~/pywikibot
Quellen und Lizenz
- Offizielle Dokumentation: https://www.mediawiki.org/wiki/Manual:Pywikibot
- Lizenz: Pywikibot steht unter der MIT.
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.
DokuWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
DokuWiki ist eine schlanke Wiki-Software in PHP, die ihre Seiten als einfache Textdateien speichert und deshalb keine Datenbank braucht. Sie eignet sich gut für Dokumentationen, Notizen und kleine Teams. Diese Anleitung installiert DokuWiki aus den Paketquellen von Ubuntu und bindet es in nginx ein.
Vorbemerkungen
- Voraussetzungen: nginx und PHP mit PHP-FPM sind nach den jeweiligen Anleitungen installiert und laufen.
- Installation über apt: Ubuntu 26.04 liefert DokuWiki im Paket
dokuwiki(Version 2025-05-14b „Librarian“). Das Projekt selbst ist schon eine Version weiter. Dafür bekommt man überaptSicherheitsupdates automatisch mit dem restlichen System. - Aufteilung der Dateien: Das Paket legt den Programmcode nach
/usr/share/dokuwiki, die Einstellungen nach/etc/dokuwikiund die Wiki-Seiten nach/var/lib/dokuwiki/data. Einstellungen und Seiten liegen damit außerhalb des Ordners, den nginx ausliefert. - Vorsicht mit Apache: Das Paket richtet DokuWiki normalerweise ungefragt in Apache ein. Auf diesem Rechner läuft Apache aber schon für den Tileserver. Schritt 3 zeigt deshalb alle Fragen des Pakets an, damit du Apache abwählen kannst.
- Port: Das Wiki läuft unter nginx auf Port 8086 und ist nur vom eigenen Rechner aus erreichbar.
- Getestet: mit nginx 1.28 und PHP 8.5 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Paketinformationen ansehen (optional)
Zeigt Version und Abhängigkeiten des Pakets. Unter Recommends stehen die PHP-Module php-gd (Bilder verkleinern), php-intl (Sprachen und Sortierung) und php-mbstring (Umlaute und andere Sonderzeichen). apt installiert sie automatisch mit.
apt show dokuwiki
3. DokuWiki installieren und alle Fragen anzeigen
Das Paket stellt bei der Installation mehrere Fragen, zeigt die meisten davon aber nur auf Wunsch. DEBIAN_PRIORITY=low sorgt dafür, dass du alle zu sehen bekommst, auch die Frage nach dem Webserver.
sudo DEBIAN_PRIORITY=low apt install dokuwiki
In den Dialogen wechselst du mit der Tab-Taste zwischen Feld und Schaltflächen und bestätigst mit Enter. So beantwortest du die Fragen (die Texte erscheinen auf Deutsch, wenn das System auf Deutsch eingestellt ist):
- Automatisch einzurichtende(r) Webserver –
apache2ist vorausgewählt. Entferne mit der Leertaste das Sternchen, sodass nichts mehr ausgewählt ist, und bestätige mit Ok. nginx richtest du in Schritt 4 selbst ein. - Wiki-Speicherort –
/dokuwikieinfach bestätigen. Die Angabe gilt nur für Apache. - Zugelassenes Netzwerk –
nur lokaler Rechnerbestätigen. Auch das gilt nur für Apache. - Seiten beim vollständigen Entfernen des Pakets löschen? – Nein. So gehen deine Seiten nicht verloren, wenn du das Paket einmal entfernst.
- Einstellungen für den Webserver schreibbar machen? – Nein. Einstellungen änderst du dann mit nano wie in Schritt 10. Bei Ja kann der Administrator sie auch im Browser ändern. Dafür darf der Webserver aber in
/etc/dokuwikischreiben. - Verzeichnis der Plugins für den Webserver schreibbar machen? – Nein. Bei Ja kann man Erweiterungen im Browser installieren, der Webserver darf dafür aber Programmcode ablegen.
- Wiki-Titel – ein Name für dein Wiki, z. B.
Mein Wiki. - Wiki-Lizenz – unter welcher Lizenz die Inhalte stehen. Für ein privates Wiki reicht
keine. - ACL aktivieren? – Ja. Nur mit der Zugriffssteuerung (ACL) gibt es Benutzerkonten und Rechte.
- Benutzername, Echter Name und E-Mail-Adresse des Administrators – die Angaben für das Administratorkonto, z. B.
admin. - Passwort des Administrators – das Passwort für dieses Konto, danach noch einmal zur Kontrolle.
- Anfängliche ACL-Richtlinie –
öffentlichbedeutet: Alle dürfen lesen, nur angemeldete Benutzer dürfen schreiben.offenerlaubt allen das Schreiben,geschlossenerlaubt nur angemeldeten Benutzern überhaupt den Zugriff.
Prüfen: In der Ausgabe stehen Creating config file /etc/dokuwiki/local.php with new version und keine Zeile, die apache2 neu lädt. Die Einstellungsdatei enthält den gewählten Titel:
cat /etc/dokuwiki/local.php
nginx konfigurieren
4. Konfiguration für DokuWiki anlegen
Legt einen eigenen Server-Block auf Port 8086 an. Die Ordner bin, inc und vendor enthalten Programmcode, der nie direkt aufgerufen werden soll. Sie werden gesperrt, ebenso versteckte Dateien wie .htaccess.dist. Der Block für PHP-Dateien reicht Anfragen an PHP-FPM weiter. Das Snippet fastcgi-php.conf von Ubuntu prüft dabei selbst, ob die Datei existiert.
sudo nano /etc/nginx/sites-available/dokuwiki
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8086;
server_name localhost;
root /usr/share/dokuwiki;
index doku.php;
client_max_body_size 20m;
# Programmcode und versteckte Dateien sperren
location ~ /\. {
return 403;
}
location ~ ^/(bin|inc|vendor)/ {
return 403;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location / {
try_files $uri $uri/ =404;
}
}
5. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/dokuwiki /etc/nginx/sites-enabled/dokuwiki
6. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Steht dort ein Fehler, lädt nginx im nächsten Schritt die neue Konfiguration nicht. Die bisherigen Seiten laufen dann unverändert weiter.
7. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Testen
8. Startseite abrufen
Prüft, ob das Wiki antwortet.
curl -sI http://localhost:8086/
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK. Im Browser zeigt http://localhost:8086 die noch leere Startseite deines Wikis. Oben rechts meldest du dich mit dem Administratorkonto aus Schritt 3 an.
9. Sperren prüfen
Stichprobe, ob der Programmcode wirklich gesperrt ist.
curl -sI http://localhost:8086/inc/init.php
Prüfen: Die erste Zeile lautet HTTP/1.1 403 Forbidden.
Oberfläche auf Deutsch umstellen
10. Sprache in der Einstellungsdatei setzen
Die Oberfläche ist zunächst englisch. Die Sprache legst du in der lokalen Einstellungsdatei fest.
sudo nano /etc/dokuwiki/local.php
Suche mit Strg+W nach lang und bestätige mit Enter. Ändere die gefundene Zeile
#$conf['lang'] = 'en';
so ab (Raute am Anfang entfernen, en durch de ersetzen):
$conf['lang'] = 'de';
Speichere mit Strg+O und Enter und beende nano mit Strg+X. DokuWiki liest die Datei bei jedem Aufruf neu, ein Neustart ist nicht nötig.
Prüfen: Oben rechts steht jetzt Anmelden statt Log In.
curl -s http://localhost:8086/doku.php | grep -o Anmelden | head -1
Wo liegt was?
/var/lib/dokuwiki/data/pages– die Wiki-Seiten als Textdateien, eine Datei pro Seite./var/lib/dokuwiki/data/media– hochgeladene Bilder und Dateien./var/lib/dokuwiki/data/attic– ältere Fassungen der Seiten./var/lib/dokuwiki/acl– Benutzerkonten (users.auth.php) und Zugriffsrechte (acl.auth.php)./etc/dokuwiki/local.php– deine Einstellungen.
Für eine Sicherung reicht es, die Ordner /var/lib/dokuwiki und /etc/dokuwiki zu kopieren.
Soll das Wiki unter einer eigenen Domain erreichbar sein, passt man listen und server_name an und richtet ein Zertifikat ein, wie in der Anleitung MediaWiki mit nginx unter eigener Domain beschrieben.
Aktualisieren
DokuWiki kommt aus den Ubuntu-Paketquellen und wird mit dem restlichen System aktualisiert.
1. Paketlisten aktualisieren
Holt die aktuellen Paketlisten.
sudo apt update
2. Pakete aktualisieren
Installiert neue Versionen, darunter DokuWiki. Seiten und Einstellungen bleiben erhalten.
sudo apt upgrade
Deinstallieren
1. Seite in nginx deaktivieren
Löscht den Link aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/dokuwiki
2. nginx-Konfigurationsdatei löschen
Löscht die Konfigurationsdatei der Seite.
sudo rm -f /etc/nginx/sites-available/dokuwiki
3. nginx neu laden
Übernimmt das Abschalten der Seite.
sudo systemctl reload nginx
4. DokuWiki entfernen
purge entfernt das Paket samt Einstellungen in /etc/dokuwiki. Die Seiten bleiben erhalten, wenn du in Schritt 3 der Installation das Löschen abgelehnt hast. dpkg meldet dann, dass einige Ordner nicht leer sind und deshalb bleiben.
sudo apt purge dokuwiki
5. Nicht mehr benötigte Pakete entfernen
Entfernt Bibliotheken, die nur für DokuWiki installiert wurden. PHP-FPM und die übrigen PHP-Module bleiben, weil sie eigenständig installiert sind.
sudo apt autoremove
6. Wiki-Seiten löschen (optional)
Entfernt die übrig gebliebenen Seiten, Anhänge und Benutzerkonten. Achtung: Alle Inhalte des Wikis gehen dabei unwiderruflich verloren.
sudo rm -rf /var/lib/dokuwiki
Prüfen: Unter Port 8086 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8086/
Quellen und Lizenz
- Offizielle Dokumentation: https://www.dokuwiki.org/manual
- Lizenz: DokuWiki steht unter der 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.
PmWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
PmWiki ist ein schlankes Wiki in PHP, das ohne Datenbank auskommt: Jede Seite wird als einfache Textdatei gespeichert. Es eignet sich für kleine und mittlere Wikis, die mit wenig Wartung über viele Jahre laufen sollen. Diese Anleitung richtet PmWiki mit nginx und PHP-FPM auf dem eigenen Rechner ein.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für PmWiki. Das Projekt veröffentlicht ein Archiv, das man nur auspacken muss.
- Version: Getestet mit PmWiki 2.7.6, PHP 8.5 und nginx aus Ubuntu 26.04.
- Voraussetzung: nginx und PHP-FPM sind installiert, wie in der Anleitung DokuWiki oder MediaWiki. Schritt 2 installiert sie sonst nach.
- Port: Die Ports 8085 bis 8087 sind im Buch schon vergeben. PmWiki läuft auf Port 8088, nur vom eigenen Rechner aus erreichbar.
- Passwörter: PmWiki hat keine Benutzerkonten, sondern Passwörter für Tätigkeiten: eins zum Bearbeiten von Seiten, eins für die Verwaltung.
EditPasswort123undAdminPasswort123sind Beispiele. Ersetze sie durch eigene Passwörter.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von nginx und PHP kennt.
sudo apt update
2. nginx, PHP-FPM und unzip installieren
nginx liefert die Seiten aus, PHP-FPM führt PmWiki aus, unzip packt das deutsche Sprachpaket aus. Ist alles schon vorhanden, meldet apt das nur.
sudo apt install nginx php-fpm unzip
3. PmWiki herunterladen
Lädt immer die neueste Version (etwa 1 MB) in den Ordner /tmp.
wget -O /tmp/pmwiki.tgz https://www.pmwiki.org/pub/pmwiki/pmwiki-latest.tgz
4. Archiv auspacken
Packt PmWiki nach /var/www. Der entstandene Ordner trägt die Versionsnummer im Namen, z. B. pmwiki-2.7.6.
sudo tar xzf /tmp/pmwiki.tgz -C /var/www
5. Ordner umbenennen
Ein Ordnername ohne Versionsnummer bleibt auch nach Aktualisierungen gleich. Passe die Nummer an, falls in Schritt 4 eine neuere Version ausgepackt wurde.
sudo mv /var/www/pmwiki-2.7.6 /var/www/pmwiki
Prüfen: Die Ausgabe enthält die Versionsnummer, z. B. pmwiki-2.7.6.
grep -o "pmwiki-[0-9.]*" /var/www/pmwiki/scripts/version.php
6. Deutsches Sprachpaket herunterladen
Das Sprachpaket enthält die Übersetzung der Oberfläche und die deutsche Hilfe.
wget -O /tmp/i18n-de.zip https://www.pmwiki.org/pub/pmwiki/i18n/i18n-de.zip
7. Sprachpaket auspacken
Die Seiten des Sprachpakets gehören in den Ordner wikilib.d, in dem auch die mitgelieferten englischen Seiten liegen. Im Archiv stecken sie im Unterordner UTF-8/wikilib.d. -j lässt diese Ordnerangaben weg und legt die Dateien direkt im Zielordner ab.
sudo unzip -j /tmp/i18n-de.zip 'UTF-8/wikilib.d/*' -d /var/www/pmwiki/wikilib.d
Prüfen: Die Zahl der deutschen Seiten ist größer als 100.
ls /var/www/pmwiki/wikilib.d | grep -c PmWikiDe
Einrichten
8. Ordner für die Wiki-Seiten anlegen
In wiki.d speichert PmWiki jede Seite, die du anlegst oder änderst, als eigene Datei.
sudo mkdir /var/www/pmwiki/wiki.d
9. Schreibrechte für den Webserver vergeben
PHP-FPM läuft als Benutzer www-data und muss in wiki.d schreiben dürfen. Alle übrigen Dateien bleiben im Besitz von root, PmWiki kann sein eigenes Programm also nicht verändern.
sudo chown www-data:www-data /var/www/pmwiki/wiki.d
10. Einstellungsdatei anlegen
Alle eigenen Einstellungen stehen in local/config.php. Das Archiv enthält diese Datei nicht, damit eine Aktualisierung sie nie überschreibt.
sudo nano /var/www/pmwiki/local/config.php
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<?php if (!defined('PmWiki')) exit();
$WikiTitle = 'Mein PmWiki';
# Passwörter: admin darf alles, edit darf Seiten bearbeiten
$DefaultPasswords['admin'] = pmcrypt('AdminPasswort123');
$DefaultPasswords['edit'] = pmcrypt('EditPasswort123');
# Zeichensatz UTF-8 und deutsche Oberfläche
include_once("scripts/xlpage-utf-8.php");
XLPage('de', 'PmWikiDe.XLPage');
- Die erste Zeile verhindert, dass jemand die Datei direkt im Browser aufruft.
$WikiTitleist der Name des Wikis, der im Browser-Tab erscheint.pmcryptspeichert die Passwörter verschlüsselt. Ohneedit-Passwort dürfte jeder Besucher alle Seiten ändern.- Ohne die Zeile mit
xlpage-utf-8.phpverwendet PmWiki den alten Zeichensatz ISO-8859-1. Umlaute aus dem Sprachpaket und in deinen Seiten würden dann falsch angezeigt.
nginx konfigurieren
11. Konfiguration für PmWiki anlegen
Legt einen eigenen Server-Block auf Port 8088 an. Nur pmwiki.php und der Ordner pub (Designs und Bilder) sollen von außen erreichbar sein. Die Seiten in wiki.d und wikilib.d, die Einstellungen in local sowie der Programmcode in scripts und cookbook werden gesperrt.
sudo nano /etc/nginx/sites-available/pmwiki
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8088;
server_name localhost;
root /var/www/pmwiki;
index pmwiki.php;
# Versteckte Dateien, Seitenspeicher, Einstellungen und Programmcode sperren
location ~ /\. {
return 403;
}
location ~ ^/(wiki\.d|wikilib\.d|local|cookbook|scripts|docs)/ {
return 403;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location / {
try_files $uri $uri/ =404;
}
}
12. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/pmwiki /etc/nginx/sites-enabled/pmwiki
13. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
14. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Testen
15. Startseite abrufen
Prüft, ob PmWiki antwortet und UTF-8 verwendet.
curl -sI http://localhost:8088/pmwiki.php
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK, und die Zeile Content-Type endet mit charset=UTF-8.
16. Sperren prüfen
Die Einstellungsdatei mit den Passwörtern darf nicht abrufbar sein.
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8088/local/config.php
Prüfen: Die Ausgabe lautet 403.
Erste Schritte
17. Eine Seite anlegen
Öffne http://localhost:8088/pmwiki.php?n=Main.Spielwiese&action=edit im Browser. PmWiki fragt nach dem Passwort. Gib das edit-Passwort aus Schritt 10 ein. Schreibe einen Text, z. B. Grüße aus Ahrensburg, und klicke auf Speichern.
Links zu anderen Seiten schreibst du in doppelten eckigen Klammern, z. B. [[Einkaufsliste]]. Klickst du auf einen Link zu einer Seite, die es noch nicht gibt, kannst du sie gleich anlegen. Die Startseite Main.HomePage ist anfangs englisch. Über Bearbeiten änderst du sie wie jede andere Seite.
Prüfen: Die neue Seite liegt als Datei im Ordner wiki.d.
ls /var/www/pmwiki/wiki.d
Die deutsche Hilfe zur Bearbeitung findest du unter http://localhost:8088/pmwiki.php?n=PmWikiDe.DocumentationIndex.
Aktualisieren
1. Neue Version herunterladen
wget -O /tmp/pmwiki.tgz https://www.pmwiki.org/pub/pmwiki/pmwiki-latest.tgz
2. Über die vorhandene Installation auspacken
--strip-components=1 lässt den Ordner mit der Versionsnummer weg und packt die Dateien direkt nach /var/www/pmwiki. Das Archiv enthält weder wiki.d noch local/config.php. Deine Seiten und Einstellungen bleiben deshalb erhalten.
sudo tar xzf /tmp/pmwiki.tgz -C /var/www/pmwiki --strip-components=1
Prüfen: Die Versionsnummer ist gestiegen.
grep -o "pmwiki-[0-9.]*" /var/www/pmwiki/scripts/version.php
Deinstallieren
1. Seite in nginx deaktivieren
Entfernt den Link aus Schritt 12.
sudo rm /etc/nginx/sites-enabled/pmwiki
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/pmwiki
3. nginx neu laden
sudo systemctl reload nginx
4. PmWiki und alle Seiten löschen
Achtung: Damit sind auch alle Wiki-Seiten weg. Wer sie behalten will, kopiert vorher den Ordner /var/www/pmwiki/wiki.d.
sudo rm -r /var/www/pmwiki
5. Heruntergeladene Dateien löschen
rm /tmp/pmwiki.tgz /tmp/i18n-de.zip
nginx, PHP-FPM und unzip bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Prüfen: Unter Port 8088 antwortet nichts mehr.
curl -sI http://localhost:8088/
Quellen und Lizenz
- Offizielle Dokumentation: https://www.pmwiki.org/wiki/PmWiki/DocumentationIndex
- Lizenz: PmWiki steht unter der 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.
Foswiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Foswiki ist eine in Perl geschriebene Wiki-Software, die ihre Seiten als Textdateien speichert und keine Datenbank braucht. Mit Makros, Formularen und Suchen lassen sich strukturierte Anwendungen im Wiki bauen, etwa Aufgabenlisten oder Wissensdatenbanken. Diese Anleitung installiert Foswiki von Hand, lässt es als FastCGI-Dienst laufen und bindet es in nginx ein.
Vorbemerkungen
- Voraussetzung: nginx ist nach der Anleitung installiert und läuft.
- Keine Installation über apt: Ubuntu enthält kein Foswiki-Paket. Das Projekt stellt ein fertiges Archiv bereit. Die Perl-Module, die Foswiki braucht, kommen aber alle aus den Ubuntu-Paketquellen.
- Version: Getestet mit Foswiki 2.1.11, Perl 5 und nginx 1.28 unter Ubuntu 26.04.
- Wie Foswiki mit nginx läuft: nginx kann selbst keine Perl-Programme ausführen. Foswiki läuft deshalb als eigener Dienst mit einigen ständig laufenden Prozessen (FastCGI). nginx liefert Bilder und Anhänge selbst aus und reicht alle übrigen Anfragen an diesen Dienst weiter.
- Ports: Das Wiki ist unter nginx auf Port 8087 erreichbar. Der FastCGI-Dienst hört auf Port 9010. Beide sind nur vom eigenen Rechner aus erreichbar.
- Passwort:
AdminPasswort123ist ein Beispiel. Ersetze es durch ein eigenes Passwort.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Perl-Module installieren
Installiert alle Perl-Module, die Foswiki braucht.
sudo apt install libcgi-pm-perl libcgi-session-perl libcrypt-passwdmd5-perl libcrypt-eksblowfish-perl libemail-address-xs-perl libemail-mime-perl libfile-copy-recursive-perl libfcgi-perl libfcgi-procmanager-perl liblocale-maketext-lexicon-perl liblocale-msgfmt-perl liblocale-codes-perl libarchive-zip-perl libmozilla-ca-perl
Wofür die Module da sind:
libcgi-pm-perlundlibcgi-session-perl– verarbeiten Webanfragen und merken sich angemeldete Benutzer.libcrypt-passwdmd5-perlundlibcrypt-eksblowfish-perl– verschlüsseln Passwörter.libemail-address-xs-perlundlibemail-mime-perl– prüfen E-Mail-Adressen und erzeugen E-Mails, z. B. für Benachrichtigungen.libfile-copy-recursive-perl– kopiert ganze Ordner, etwa beim Umbenennen von Seiten.libfcgi-perlundlibfcgi-procmanager-perl– der FastCGI-Dienst, über den nginx mit Foswiki spricht.liblocale-maketext-lexicon-perl,liblocale-msgfmt-perlundliblocale-codes-perl– Übersetzungen der Oberfläche, z. B. ins Deutsche.libarchive-zip-perlundlibmozilla-ca-perl– entpacken Erweiterungen und prüfen Zertifikate beim Herunterladen.
Prüfen: Der Befehl gibt nichts aus. Fehlt ein Modul, erscheint eine Meldung mit Can't locate.
perl -MCGI -MCGI::Session -MFCGI -MFCGI::ProcManager -MEmail::MIME -e1
Foswiki installieren
3. Programmarchiv herunterladen
Lädt Foswiki 2.1.11 (etwa 19 MB) in den Ordner /tmp. Die aktuelle Version steht auf https://github.com/foswiki/distro/releases.
curl -L -o /tmp/Foswiki-2.1.11.tgz https://github.com/foswiki/distro/releases/download/FoswikiRelease02x01x11/Foswiki-2.1.11.tgz
4. Prüfsumme kontrollieren
Stellt sicher, dass das Archiv vollständig und unverändert angekommen ist. Die Prüfsumme veröffentlicht das Projekt neben dem Archiv in der Datei Foswiki-2.1.11.sha1.
sha1sum /tmp/Foswiki-2.1.11.tgz
Prüfen: Die Ausgabe beginnt mit 6fd484903d10ca1ae908c67d7977bdedfe265c3e.
5. Archiv entpacken
Packt Foswiki nach /var/www aus. Dabei entsteht der Ordner /var/www/Foswiki-2.1.11.
sudo tar xzf /tmp/Foswiki-2.1.11.tgz -C /var/www
6. Ordner umbenennen
Ein Ordnername ohne Versionsnummer macht die Pfade in den Einstellungen einfacher.
sudo mv /var/www/Foswiki-2.1.11 /var/www/foswiki
7. Eigentümer setzen
Foswiki läuft als Benutzer www-data und muss in die Ordner für Seiten (data), Anhänge (pub) und Zwischendateien (working) schreiben. Außerdem schreibt es seine Einstellungen nach lib/LocalSite.cfg.
sudo chown -R www-data:www-data /var/www/foswiki
8. In den Programmordner wechseln
Die folgenden Befehle arbeiten im Ordner von Foswiki.
cd /var/www/foswiki
9. Grundeinstellungen anlegen
Das Werkzeug tools/configure legt die Einstellungsdatei lib/LocalSite.cfg an. -noprompt lässt es alle Pfade selbst ermitteln. Mit -set gibst du die Werte vor, die es nicht erraten kann.
sudo -u www-data perl tools/configure -save -noprompt -set {DefaultUrlHost}=http://localhost:8087 -set {ScriptUrlPath}=/bin -set {ScriptUrlPaths}{view}= -set {PubUrlPath}=/pub -set {SafeEnvPath}=/usr/bin:/bin -set {UserInterfaceInternationalisation}=1 -set {Languages}{de}{Enabled}=1
Was die Einstellungen bedeuten:
{DefaultUrlHost}– die Adresse, unter der das Wiki im Browser aufgerufen wird.{ScriptUrlPath}=/bin– Aktionen wie Bearbeiten oder Anmelden liegen unter/bin/…, z. B./bin/edit/Main/WebHome.{ScriptUrlPaths}{view}=(leer) – Seiten werden ohne Vorsatz angezeigt, also/Main/WebHomestatt/bin/view/Main/WebHome.{PubUrlPath}=/pub– unter dieser Adresse liegen Bilder und Anhänge.{SafeEnvPath}=/usr/bin:/bin– die Ordner, in denen Foswiki Hilfsprogramme wiegrepsucht. Ohne diese Einstellung findet Foswiki sie im FastCGI-Betrieb nicht, weil nginx keinen Suchpfad mitschickt. Viele Seiten enden dann mit dem Fehler502 Bad Gateway.{UserInterfaceInternationalisation}=1und{Languages}{de}{Enabled}=1– schaltet die Übersetzungen ein und gibt Deutsch frei. Foswiki richtet sich dann nach der Spracheinstellung des Browsers.
Prüfen: Die Ausgabe endet mit New configuration saved in /var/www/foswiki/lib/LocalSite.cfg.
10. Administratorpasswort setzen
Foswiki hat ein eingebautes Administratorkonto mit dem Anmeldenamen admin. Dieser Befehl legt sein Passwort fest. Foswiki speichert es nur verschlüsselt. Im Verlauf der Shell steht es aber im Klartext. Wer das nicht möchte, löscht die Zeile danach mit history -d und der Zeilennummer aus history.
sudo -u www-data perl tools/configure -save -set {Password}=AdminPasswort123
Prüfen: In der Einstellungsdatei steht jetzt eine verschlüsselte Zeichenfolge, die mit $apr1$ beginnt.
sudo grep "{Password}" lib/LocalSite.cfg
FastCGI-Dienst einrichten
11. systemd-Dienst anlegen
Das Archiv enthält unter tools/systemd/foswiki.service eine Vorlage. Die folgende Datei ist eine vereinfachte Fassung davon, mit Port 9010 statt 9000.
sudo nano /etc/systemd/system/foswiki.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Foswiki
After=network.target
[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/var/www/foswiki/bin/
ExecStart=/usr/bin/perl /var/www/foswiki/bin/foswiki.fcgi -n 3 -l 127.0.0.1:9010 -a foswiki
ExecReload=/bin/kill -HUP $MAINPID
Restart=always
SyslogIdentifier=foswiki
[Install]
WantedBy=multi-user.target
Was die Angaben bedeuten:
User=www-data– Foswiki läuft mit denselben Rechten wie der Webserver und darf in seine Ordner schreiben.WorkingDirectory=– Foswiki erwartet, im Ordnerbingestartet zu werden.-n 3– drei Prozesse beantworten Anfragen gleichzeitig.-l 127.0.0.1:9010– der Dienst ist nur vom eigenen Rechner aus erreichbar.-a foswiki– unter diesem Namen erscheinen die Prozesse inpsundtop.ExecReload=–systemctl reload foswikilässt Foswiki geänderte Einstellungen neu einlesen.
12. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
13. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet den Dienst zusätzlich sofort.
sudo systemctl enable --now foswiki
Prüfen: Das Protokoll zeigt FastCGI: manager (pid …): initialized und für jeden der drei Prozesse server (pid …) started.
sudo journalctl -u foswiki -n 10
nginx konfigurieren
14. Konfiguration für Foswiki anlegen
Legt einen eigenen Server-Block auf Port 8087 an. Nur der Ordner pub mit Bildern und Anhängen wird direkt ausgeliefert. Alle Adressen unter /bin/ gehen an den FastCGI-Dienst. Alle übrigen Adressen gelten als Seitennamen und werden intern an /bin/view/ weitergereicht. Die Ordner data, lib und working sind damit von außen gar nicht erreichbar.
sudo nano /etc/nginx/sites-available/foswiki
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8087;
server_name localhost;
root /var/www/foswiki;
client_max_body_size 20m;
# Nur pub/ wird als Datei ausgeliefert, ohne die Arbeitsordner
location ^~ /pub/ {
location ~ ^/pub/[^/]+/.*/_work_areas/ {
return 403;
}
try_files $uri =404;
expires 7d;
}
# Aktionen wie /bin/edit/Main/WebHome an Foswiki weitergeben
location ~ ^/bin/ {
fastcgi_pass 127.0.0.1:9010;
fastcgi_split_path_info ^(/bin/[^/]+)(/.*)?$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root/bin/foswiki.fcgi;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
# Kurze Adressen: /Main/WebHome zeigt die Seite an
location / {
rewrite ^/(.*)$ /bin/view/$1 last;
}
}
fastcgi_split_path_info– zerlegt z. B./bin/edit/Main/WebHomein die Aktion/bin/editund den Seitennamen/Main/WebHome. Foswiki bekommt beides getrennt alsSCRIPT_NAMEundPATH_INFO.rewrite … /bin/view/$1 last– aus/Main/WebHomewird intern/bin/view/Main/WebHome. Im Browser bleibt die kurze Adresse stehen.
15. Konfiguration aktivieren
Ein Link in sites-enabled sorgt dafür, dass nginx die neue Seite lädt.
sudo ln -s /etc/nginx/sites-available/foswiki /etc/nginx/sites-enabled/foswiki
16. nginx-Konfiguration testen
Findet Tippfehler, bevor nginx neu geladen wird.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
17. nginx neu laden
Übernimmt die Konfiguration, ohne laufende Verbindungen abzubrechen.
sudo systemctl reload nginx
Testen
18. Startseite abrufen
Prüft, ob das Wiki über nginx antwortet.
curl -sI http://localhost:8087/System/WebHome
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK. Kommt stattdessen 502 Bad Gateway, läuft der Dienst aus Schritt 13 nicht, oder {SafeEnvPath} aus Schritt 9 fehlt.
19. Sperre der Einstellungen prüfen
Die Datei mit den Einstellungen darf nicht abrufbar sein.
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8087/lib/LocalSite.cfg
Prüfen: Die Ausgabe lautet 404. Foswiki sucht dabei eine Seite namens lib/LocalSite.cfg und findet keine.
20. Im Browser anmelden
Öffne http://localhost:8087. Ist der Browser auf Deutsch eingestellt, erscheint die Oberfläche auf Deutsch. Klicke oben auf Anmelden und melde dich mit dem Namen admin und dem Passwort aus Schritt 10 an. Foswiki zeigt dich dann als AdminUser an. Mit diesem Konto darfst du alles, auch Seiten bearbeiten und die Einstellungen im Browser unter http://localhost:8087/bin/configure ändern.
Für die tägliche Arbeit legst du besser ein persönliches Konto an: über die Seite System.UserRegistration (http://localhost:8087/System/UserRegistration). Soll dieses Konto Administratorrechte bekommen, trägst du es als AdminUser auf der Seite Main.AdminGroup ein.
Wo liegt was?
/var/www/foswiki/data– die Seiten als Textdateien, ein Ordner pro Web (z. B.Main,Sandbox)./var/www/foswiki/pub– Anhänge und Bilder./var/www/foswiki/lib/LocalSite.cfg– die Einstellungen.
Für eine Sicherung reichen diese drei. Hinweise zum Umstieg auf eine neue Version stehen im Archiv in der Datei UpgradeGuide.html.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Foswiki und verhindert den Start beim Hochfahren.
sudo systemctl disable --now foswiki
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 11.
sudo rm /etc/systemd/system/foswiki.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Seite in nginx deaktivieren
Löscht den Link aus sites-enabled.
sudo rm -f /etc/nginx/sites-enabled/foswiki
5. nginx-Konfigurationsdatei löschen
Löscht die Konfigurationsdatei der Seite.
sudo rm -f /etc/nginx/sites-available/foswiki
6. nginx neu laden
Übernimmt das Abschalten der Seite.
sudo systemctl reload nginx
7. Foswiki-Ordner und Archiv löschen
Entfernt Foswiki samt Seiten, Anhängen und Einstellungen. Achtung: Alle Inhalte des Wikis gehen dabei unwiderruflich verloren.
sudo rm -rf /var/www/foswiki /tmp/Foswiki-2.1.11.tgz
8. Perl-Module entfernen (optional)
Nur ausführen, wenn kein anderes Programm diese Module braucht.
sudo apt purge libcgi-pm-perl libcgi-session-perl libcrypt-passwdmd5-perl libcrypt-eksblowfish-perl libemail-address-xs-perl libemail-mime-perl libfile-copy-recursive-perl libfcgi-perl libfcgi-procmanager-perl liblocale-maketext-lexicon-perl liblocale-msgfmt-perl liblocale-codes-perl libarchive-zip-perl libmozilla-ca-perl
9. Nicht mehr benötigte Pakete entfernen
Entfernt Bibliotheken, die nur zusammen mit den Perl-Modulen installiert wurden.
sudo apt autoremove
Prüfen: Unter Port 8087 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8087/
Quellen und Lizenz
- Offizielle Dokumentation: https://foswiki.org/Support/Documentation
- Lizenz: Foswiki steht unter der 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.
Wiki.js
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Wiki.js ist eine moderne Wiki-Software auf Basis von Node.js, deren Seiten man in Markdown oder in einem grafischen Editor schreibt. Diese Anleitung richtet sie als Dienst auf dem eigenen Rechner ein und speichert alle Inhalte in PostgreSQL.
Vorbemerkungen
- Voraussetzung: PostgreSQL ist nach der Anleitung installiert und läuft.
- Keine Installation über apt: Für Wiki.js gibt es kein Ubuntu-Paket. Das Projekt stellt aber ein fertiges Archiv bereit, in dem alle benötigten Node.js-Bibliotheken schon enthalten sind. Node.js selbst kommt aus den Paketquellen von Ubuntu.
- Version: Die Anleitung verwendet Wiki.js 2.5, die aktuelle stabile Version (getestet mit 2.5.315, Node.js 22 aus Ubuntu 26.04 und PostgreSQL 18). Wiki.js 3 ist noch in Entwicklung.
- Port: Wiki.js läuft normalerweise auf Port 3000. Diesen Port belegt hier schon Martin, deshalb verwendet die Anleitung Port 3001. Wiki.js ist dabei nur vom eigenen Rechner aus erreichbar.
- Passwort:
geheimes_passwortist ein Beispiel. Ersetze es überall durch ein eigenes Passwort.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und curl installieren
Wiki.js ist in JavaScript geschrieben und braucht Node.js ab Version 20. Ubuntu 26.04 liefert Version 22. Mit curl lädst du später das Programmarchiv herunter.
sudo apt install nodejs curl
Prüfen: Die Ausgabe beginnt mit v22.
/usr/bin/node --version
Der Befehl nennt den vollen Pfad /usr/bin/node. Wer zusätzlich Node.js über nvm installiert hat, bekommt mit dem kurzen Befehl node sonst dessen Version angezeigt. Der Dienst in Schritt 11 verwendet ausdrücklich das Node.js aus Ubuntu.
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer für Wiki.js anlegen
Legt in PostgreSQL den Benutzer wikijs an. Mit ihm und seinem Passwort meldet sich Wiki.js an der Datenbank an.
sudo -u postgres psql -c "CREATE USER wikijs WITH PASSWORD 'geheimes_passwort';"
4. Datenbank für Wiki.js anlegen
Legt die leere Datenbank wikijs an und macht den gleichnamigen Benutzer zu ihrem Eigentümer. Die Tabellen erstellt Wiki.js beim ersten Start selbst.
sudo -u postgres psql -c "CREATE DATABASE wikijs OWNER wikijs;"
Prüfen: Die Datenbank erscheint in der Liste.
sudo -u postgres psql -l | grep wikijs
Wiki.js installieren
5. Systembenutzer anlegen
Wiki.js soll nicht mit Administratorrechten und nicht unter deinem Benutzerkonto laufen, sondern unter einem eigenen Benutzer wikijs ohne Anmeldemöglichkeit. Wird das Programm angegriffen, kommt der Angreifer so nur an die Dateien von Wiki.js.
sudo useradd --system --home-dir /opt/wikijs --shell /usr/sbin/nologin wikijs
Prüfen: Der Benutzer existiert.
id wikijs
6. Programmarchiv herunterladen
Lädt die neueste Version von Wiki.js als Archiv (etwa 90 MB) in den Ordner /tmp. -L folgt der Weiterleitung von GitHub zur eigentlichen Datei.
curl -L -o /tmp/wiki-js.tar.gz https://github.com/requarks/wiki/releases/latest/download/wiki-js.tar.gz
Prüfen: Die Datei ist ungefähr 90 MB groß.
ls -lh /tmp/wiki-js.tar.gz
7. Programmordner anlegen
Legt den Ordner an, in dem Wiki.js liegen soll. /opt ist unter Linux für Programme gedacht, die nicht aus Paketen stammen.
sudo mkdir /opt/wikijs
8. Archiv entpacken
Packt das Programm samt aller Bibliotheken in den neuen Ordner aus. -C gibt den Zielordner an.
sudo tar xzf /tmp/wiki-js.tar.gz -C /opt/wikijs
Prüfen: Der Ordner enthält unter anderem server, node_modules und config.sample.yml.
ls /opt/wikijs
9. Einstellungsdatei anlegen
Die Datei config.yml sagt Wiki.js, auf welchem Port es läuft und wie es die Datenbank erreicht. Alle Einstellungen, die hier fehlen, übernimmt Wiki.js aus seinen Standardwerten. Eine ausführlich kommentierte Vorlage mit allen Möglichkeiten liegt in config.sample.yml.
sudo nano /opt/wikijs/config.yml
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X. Die Einrückung unter db: muss aus Leerzeichen bestehen, nicht aus Tabulatoren, sonst kann Wiki.js die Datei nicht lesen.
port: 3001
bindIP: 127.0.0.1
db:
type: postgres
host: 127.0.0.1
port: 5432
user: wikijs
pass: 'geheimes_passwort'
db: wikijs
ssl: false
logLevel: info
dataPath: ./data
Was die Einträge bedeuten:
port– der Port, auf dem Wiki.js Anfragen annimmt.bindIP: 127.0.0.1– Wiki.js ist nur vom eigenen Rechner aus erreichbar, nicht aus dem Netzwerk.db– Art der Datenbank, Adresse, Benutzer, Passwort und Name der Datenbank aus den Schritten 3 und 4. Das Passwort steht in einfachen Anführungszeichen, damit Sonderzeichen keine Probleme machen.dataPath– Ordner für Zwischenspeicher und hochgeladene Dateien, relativ zum Programmordner.
10. Eigentümer und Rechte setzen
Der erste Befehl übergibt den Programmordner dem Benutzer wikijs, damit Wiki.js in den Ordner data schreiben kann. Der zweite sorgt dafür, dass nur noch dieser Benutzer die Einstellungsdatei mit dem Datenbank-Passwort lesen darf.
sudo chown -R wikijs:wikijs /opt/wikijs
sudo chmod 600 /opt/wikijs/config.yml
Prüfen: Die Rechte lauten -rw-------, Eigentümer ist wikijs.
sudo ls -l /opt/wikijs/config.yml
Als Dienst einrichten
11. systemd-Dienst anlegen
Damit Wiki.js beim Rechnerstart automatisch läuft und nach einem Absturz neu startet, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/wikijs.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Wiki.js
After=network.target postgresql.service
[Service]
Type=simple
User=wikijs
Group=wikijs
WorkingDirectory=/opt/wikijs
ExecStart=/usr/bin/node server
Environment=NODE_ENV=production
Restart=always
[Install]
WantedBy=multi-user.target
Was die Einträge bedeuten:
After=– Wiki.js startet erst, wenn Netzwerk und PostgreSQL bereit sind.User=undGroup=– der Dienst läuft unter dem Benutzer aus Schritt 5.WorkingDirectory=– Wiki.js suchtconfig.ymlunddatain diesem Ordner.ExecStart=– startet das Programm mit dem Node.js aus Ubuntu.Restart=always– systemd startet Wiki.js neu, falls es sich beendet.WantedBy=multi-user.target– der Dienst startet beim normalen Hochfahren mit.
12. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
13. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet den Dienst zusätzlich sofort.
sudo systemctl enable --now wikijs
Prüfen: In der Ausgabe steht active (running). Mit q verlässt du die Anzeige.
systemctl status wikijs
14. Protokoll ansehen
Beim ersten Start stellt Wiki.js fest, dass die Datenbank noch leer ist, und startet einen Einrichtungsassistenten. -f zeigt neue Zeilen fortlaufend an, Strg+C beendet die Anzeige.
sudo journalctl -u wikijs -f
Prüfen: Im Protokoll stehen Database Connection Successful und Starting setup wizard.... Steht dort eine Fehlermeldung zur Datenbank, stimmen Benutzer oder Passwort in config.yml nicht mit den Schritten 3 und 4 überein.
Einrichtung im Browser
15. Einrichtungsassistenten öffnen
Öffne im Browser die Adresse http://localhost:3001. Es erscheint die Seite des Einrichtungsassistenten.
Prüfen: Auch ohne Browser lässt sich feststellen, dass Wiki.js antwortet. Die erste Zeile lautet HTTP/1.1 200 OK.
curl -sI http://localhost:3001/
16. Administratorkonto und Adresse eintragen
Fülle im Assistenten die Felder aus:
- Administrator Email – deine E-Mail-Adresse, sie dient später als Anmeldename.
- Password und Confirm Password – das Passwort für das Administratorkonto.
- Site URL –
http://localhost:3001. Wiki.js baut damit Links, etwa in E-Mails. - Telemetry – schalte den Schalter aus, wenn Wiki.js keine anonymen Nutzungsdaten an die Entwickler senden soll.
Klicke dann auf Install. Wiki.js legt jetzt die Tabellen in PostgreSQL an und leitet nach einigen Sekunden auf die Startseite weiter.
Prüfen: In der Datenbank gibt es jetzt gut 30 Tabellen.
sudo -u postgres psql -d wikijs -c "\dt"
17. Anmelden und erste Seite anlegen
Melde dich mit der E-Mail-Adresse und dem Passwort aus Schritt 16 an. Auf der Startseite bietet Wiki.js an, die Startseite des Wikis anzulegen (Create Home Page). Wähle einen Editor, z. B. Markdown, schreibe einen Text und speichere mit Create.
18. Oberfläche auf Deutsch umstellen (optional)
Die Oberfläche ist zunächst englisch. Öffne oben rechts über das Zahnrad die Administration und wähle links Locale. Wähle unter Site Locale den Eintrag für Deutsch und bestätige mit Apply. Wiki.js lädt die Übersetzung aus dem Internet und stellt die Oberfläche um.
Soll Wiki.js später unter einer eigenen Domain erreichbar sein, leitet man die Anfragen wie bei anderen Diensten über nginx an 127.0.0.1:3001 weiter.
Aktualisieren
Neue Versionen von Wiki.js 2.5 installierst du, indem du das Programm austauschst. config.yml und die Daten in PostgreSQL bleiben dabei erhalten.
1. Dienst stoppen
Wiki.js darf beim Austausch der Dateien nicht laufen.
sudo systemctl stop wikijs
2. Neue Version herunterladen
Lädt das aktuelle Archiv und überschreibt dabei ein älteres in /tmp.
curl -L -o /tmp/wiki-js.tar.gz https://github.com/requarks/wiki/releases/latest/download/wiki-js.tar.gz
3. Alte Programmdateien löschen
Entfernt Programmcode und Bibliotheken der alten Version, damit keine veralteten Dateien übrig bleiben. config.yml und der Ordner data werden nicht angefasst.
sudo rm -rf /opt/wikijs/assets /opt/wikijs/node_modules /opt/wikijs/server
4. Neue Version entpacken
Packt die neue Version in den Programmordner aus. Das Archiv enthält keine config.yml, deine Einstellungen bleiben also erhalten.
sudo tar xzf /tmp/wiki-js.tar.gz -C /opt/wikijs
5. Eigentümer wieder setzen
Die neu entpackten Dateien gehören root. Dieser Befehl übergibt sie wieder dem Benutzer wikijs.
sudo chown -R wikijs:wikijs /opt/wikijs
6. Dienst starten
Beim Start passt Wiki.js die Tabellen in PostgreSQL bei Bedarf selbst an die neue Version an.
sudo systemctl start wikijs
Prüfen: In der Administration zeigt die Seite System Info die neue Versionsnummer von Wiki.js.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Wiki.js und verhindert, dass es beim nächsten Hochfahren wieder startet.
sudo systemctl disable --now wikijs
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 11.
sudo rm /etc/systemd/system/wikijs.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programmordner löschen
Entfernt Wiki.js samt Einstellungen und dem Ordner data. Achtung: Hochgeladene Dateien liegen in der Datenbank und in data. Wer sie behalten will, sichert vorher beides.
sudo rm -rf /opt/wikijs
5. Heruntergeladenes Archiv löschen
Entfernt das Archiv aus /tmp, falls es noch vorhanden ist.
rm -f /tmp/wiki-js.tar.gz
6. Datenbank löschen
Löscht die Datenbank wikijs. Achtung: Alle Seiten des Wikis gehen dabei unwiderruflich verloren.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS wikijs;"
7. Datenbankbenutzer löschen
Entfernt den PostgreSQL-Benutzer aus Schritt 3.
sudo -u postgres psql -c "DROP USER IF EXISTS wikijs;"
8. Systembenutzer löschen
Entfernt den Linux-Benutzer aus Schritt 5.
sudo userdel wikijs
9. Node.js entfernen (optional)
Nur ausführen, wenn kein anderes Programm Node.js aus Ubuntu braucht.
sudo apt purge nodejs
sudo apt autoremove
Prüfen: Unter Port 3001 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:3001/
Quellen und Lizenz
- Offizielle Dokumentation: https://js.wiki/
- Lizenz: Wiki.js steht unter der AGPL-3.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.
XWiki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
XWiki ist eine in Java geschriebene Wiki-Plattform für Unternehmen und Teams. Neben normalen Wiki-Seiten bietet sie strukturierte Daten, feine Rechteverwaltung und viele Erweiterungen. Diese Anleitung installiert XWiki aus dem offiziellen apt-Repository, lässt es im Webserver Tomcat laufen und speichert alle Inhalte in PostgreSQL.
Vorbemerkungen
- Voraussetzung: PostgreSQL ist nach der Anleitung installiert und läuft.
- Offizielles Repository: Ubuntu selbst enthält kein XWiki-Paket. Das XWiki-Projekt betreibt aber ein eigenes apt-Repository. Die Pakete richten die Datenbank selbst ein und binden XWiki in Tomcat ein. Tomcat und Java kommen aus den Paketquellen von Ubuntu.
- Version: Die Anleitung verwendet den Zweig mit Langzeitunterstützung (LTS), derzeit XWiki 17.10. Er bekommt über längere Zeit nur Fehlerkorrekturen und ist deshalb ruhiger im Betrieb. Wer immer die neuesten Funktionen möchte, nimmt den Zweig
stable(Hinweis in Schritt 4). - Getestet: XWiki 17.10.13 mit Tomcat 11, Java 25 und PostgreSQL 18 unter Ubuntu 26.04.
- Port: Tomcat läuft normalerweise auf Port 8080. Auf diesem Rechner belegt Apache diesen Port schon (siehe Tileserver). Die Anleitung stellt Tomcat deshalb auf Port 8082 um. XWiki ist dabei nur vom eigenen Rechner aus erreichbar.
- Platzbedarf: Die Pakete brauchen etwa 600 MB. XWiki sollte mindestens 2 GB freien Arbeitsspeicher haben.
Repository einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
curl lädt den Signaturschlüssel herunter, ca-certificates enthält die Zertifikate für die HTTPS-Verbindung.
sudo apt install curl ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich vom XWiki-Projekt stammen. --fail verhindert, dass bei einem Fehler eine Fehlerseite als Schlüssel gespeichert wird.
sudo curl -o /usr/share/keyrings/xwiki-keyring.gpg --fail https://maven.xwiki.org/xwiki-keyring.gpg
Prüfen: Angezeigt wird ein Schlüssel von XWiki Dev Team <committers@xwiki.org>.
gpg --show-keys /usr/share/keyrings/xwiki-keyring.gpg
4. Paketquelle eintragen
Legt eine neue Datei an, in der die Adresse des Repositorys steht. apt liest alle Dateien mit der Endung .sources in diesem Ordner als zusätzliche Paketquellen ein.
sudo nano /etc/apt/sources.list.d/xwiki-lts.sources
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://maven.xwiki.org
Suites: lts/
Signed-By: /usr/share/keyrings/xwiki-keyring.gpg
Was die Felder bedeuten:
Types: deb– aus dieser Quelle kommen fertige Programmpakete.URIs– die Internetadresse des Repositorys.Suites: lts/– der Zweig mit Langzeitunterstützung. Der Schrägstrich am Ende ist wichtig: Das XWiki-Repository ist ein sogenanntes flaches Repository ohne Unterbereiche, deshalb fehlt auch die ZeileComponents. Für die neueste Version steht hierstable/.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 akzeptiert.
5. Paketlisten neu einlesen
Jetzt lädt apt das Paketverzeichnis des XWiki-Repositorys herunter.
sudo apt update
Prüfen: Beim Installationskandidat steht eine Version, die mit 17.10 beginnt.
apt policy xwiki-tomcat11-pgsql
Tomcat einrichten
6. Tomcat installieren
XWiki ist eine Java-Webanwendung und braucht einen Servlet-Container, der sie ausführt. Das ist hier Tomcat 11 aus Ubuntu. Tomcat wird vor XWiki installiert, damit du zuerst den Port ändern kannst. Die Installation bringt auch Java mit, falls es noch nicht vorhanden ist.
sudo apt install tomcat11
Direkt nach der Installation versucht Tomcat, Port 8080 zu belegen. Ist der Port schon vergeben, steht im Protokoll ein Fehler mit BindException. Das wird im nächsten Schritt behoben.
7. Port von Tomcat ändern
Öffnet die zentrale Einstellungsdatei von Tomcat.
sudo nano /etc/tomcat11/server.xml
Suche mit Strg+W nach Connector port="8080" und bestätige mit Enter. Ändere die gefundene Zeile
<Connector port="8080" protocol="HTTP/1.1"
so ab:
<Connector port="8082" address="127.0.0.1" protocol="HTTP/1.1"
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
port="8082"– Tomcat nimmt Anfragen auf Port 8082 an statt auf dem belegten Port 8080.address="127.0.0.1"– Tomcat ist nur vom eigenen Rechner aus erreichbar.
Weiter unten in der Datei steht noch einmal port="8080", aber innerhalb eines Kommentars (<!-- … -->). Diese Stelle bleibt unverändert.
8. Tomcat neu starten
Tomcat liest server.xml nur beim Start ein.
sudo systemctl restart tomcat11
Prüfen: Nach einigen Sekunden lautet die erste Zeile HTTP/1.1 200.
curl -sI http://localhost:8082/
XWiki installieren
9. XWiki-Paket für Tomcat 11 und PostgreSQL installieren
Das Paket xwiki-tomcat11-pgsql zieht alle nötigen Teile nach: XWiki selbst, die Anbindung an Tomcat 11 und die Anbindung an PostgreSQL.
sudo apt install xwiki-tomcat11-pgsql
Während der Installation erscheinen Fragen des Hilfsprogramms dbconfig-common, das die Datenbank für XWiki anlegt. Mit der Tab-Taste wechselst du zwischen den Schaltflächen, mit Enter bestätigst du:
- Datenbank für xwiki mit dbconfig-common konfigurieren? – Ja. Dann legt das Paket in PostgreSQL den Benutzer
xwikiund die Datenbankxwikian und trägt die Zugangsdaten in die Einstellungen von XWiki ein. - PostgreSQL-Anwendungspasswort für xwiki – Lass das Feld leer und bestätige mit Ok. Dann erzeugt das Paket ein zufälliges Passwort. Du musst es dir nicht merken, weil nur XWiki selbst es braucht. Ein eigenes Passwort geht auch, dann wird es noch einmal zur Bestätigung abgefragt.
Prüfen: In der Ausgabe stehen creating postgres user xwiki: success. und creating database xwiki: success.
10. Tomcat neu starten
Die Installation legt XWiki in Tomcat ab und gibt Tomcat Schreibrechte für den Datenordner /var/lib/xwiki/data. Tomcat übernimmt beides erst nach einem Neustart.
sudo systemctl restart tomcat11
11. Start von XWiki abwarten
Der erste Start dauert etwa eine halbe Minute. Im Protokoll von Tomcat siehst du, wann er fertig ist. Strg+C beendet die Anzeige.
sudo journalctl -u tomcat11 -f
Prüfen: Es erscheint eine Zeile mit Server startup in. Einige Warnungen mit WARNING: sun.misc.Unsafe sind normal und stören nicht.
12. Datenbank prüfen
Beim ersten Aufruf von XWiki werden die Tabellen in PostgreSQL angelegt. Dieser Aufruf erledigt das und prüft gleichzeitig, ob XWiki antwortet.
curl -sL -o /dev/null -w '%{http_code}\n' http://localhost:8082/xwiki/
Prüfen: Die Ausgabe lautet 200. Danach gibt es in der Datenbank xwiki etwa 40 Tabellen.
sudo -u postgres psql -d xwiki -c "\dt"
Einrichtung im Browser
13. Einrichtungsassistenten öffnen
Öffne im Browser http://localhost:8082/xwiki/. Ein frisch installiertes XWiki ist noch leer und startet den Distribution Wizard, der dich durch die restliche Einrichtung führt.
14. Administratorkonto anlegen
Im ersten Schritt legst du das Konto für den Administrator an: Vor- und Nachname, Benutzername, Passwort und E-Mail-Adresse. Mit diesem Konto verwaltest du später das Wiki. Bestätige mit Register and login und dann Continue.
15. Flavor installieren
Ein Flavor ist eine Zusammenstellung von Erweiterungen, die aus der leeren Plattform ein fertiges Wiki macht. Wähle XWiki Standard Flavor und klicke auf Install. XWiki lädt dabei mehrere hundert Erweiterungen von extensions.xwiki.org herunter. Das dauert je nach Internetverbindung einige Minuten. Klicke danach weiter auf Continue, bis der Assistent die Startseite des Wikis zeigt.
16. Oberfläche auf Deutsch umstellen (optional)
Öffne über das Menü oben rechts die Administration (Administer Wiki) und dort Content → Localization. Wähle bei Default Language den Eintrag für Deutsch und speichere.
Soll XWiki später unter einer eigenen Domain erreichbar sein, leitet man die Anfragen wie bei anderen Diensten über nginx an 127.0.0.1:8082 weiter.
Aktualisieren
XWiki kommt aus einem apt-Repository und wird deshalb mit dem restlichen System aktualisiert.
1. Paketlisten aktualisieren
Holt die aktuellen Paketlisten, auch die aus dem XWiki-Repository.
sudo apt update
2. Pakete aktualisieren
Installiert neue Versionen aller Pakete, darunter XWiki und Tomcat. Die Einstellungen in /etc/xwiki und die Daten in PostgreSQL bleiben erhalten.
sudo apt upgrade
3. Tomcat neu starten
Tomcat lädt die neue XWiki-Version erst nach einem Neustart. Beim nächsten Aufruf im Browser bietet XWiki bei Bedarf an, auch die Erweiterungen des Flavors zu aktualisieren.
sudo systemctl restart tomcat11
Prüfen: Die neue Versionsnummer steht unten auf jeder Seite von XWiki.
Deinstallieren
1. Tomcat stoppen
Beendet Tomcat und damit XWiki.
sudo systemctl stop tomcat11
2. XWiki-Pakete entfernen
purge entfernt die Pakete samt Einstellungen in /etc/xwiki. Fragt dbconfig-common, ob die Datenbank gelöscht werden soll, kannst du Ja wählen. Sonst erledigen das die Schritte 3 und 4.
sudo apt purge xwiki-tomcat11-pgsql xwiki-tomcat11-common xwiki-pgsql-common xwiki-common
3. Datenbank löschen
Löscht die Datenbank xwiki, falls sie noch existiert. Achtung: Alle Seiten des Wikis gehen dabei unwiderruflich verloren.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS xwiki;"
4. Datenbankbenutzer löschen
Entfernt den PostgreSQL-Benutzer xwiki.
sudo -u postgres psql -c "DROP USER IF EXISTS xwiki;"
5. Datenordner löschen
Nach purge bleibt der Ordner mit Anhängen, Suchindex und installierten Erweiterungen übrig. Achtung: Hochgeladene Dateien gehen dabei verloren.
sudo rm -rf /var/lib/xwiki
6. Tomcat entfernen
Entfernt Tomcat samt Einstellungen und Protokollen. Nur ausführen, wenn Tomcat nicht für andere Anwendungen gebraucht wird.
sudo apt purge tomcat11 tomcat11-common libtomcat11-java
7. Nicht mehr benötigte Pakete entfernen
Entfernt Pakete, die nur für XWiki und Tomcat installiert wurden, z. B. dbconfig-common, Java-Bibliotheken und – falls es nur dafür nachinstalliert wurde – Java. Sieh dir die Liste vor dem Bestätigen kurz an: Sie kann auch Pakete aus anderen Installationen enthalten, die schon vorher überflüssig waren.
sudo apt autoremove --purge
8. Systembenutzer von Tomcat löschen
Tomcat hat bei der Installation den Benutzer tomcat angelegt, der beim Entfernen der Pakete erhalten bleibt.
sudo userdel tomcat
9. Paketquelle und Schlüssel entfernen
Löscht die Datei aus Schritt 4 und den Schlüssel aus Schritt 3 der Installation.
sudo rm -f /etc/apt/sources.list.d/xwiki-lts.sources /usr/share/keyrings/xwiki-keyring.gpg
10. Paketlisten aktualisieren
Damit apt das entfernte Repository vergisst.
sudo apt update
Prüfen: In der Ausgabe kommt maven.xwiki.org nicht mehr vor, und unter Port 8082 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:8082/
Quellen und Lizenz
- Offizielle Dokumentation: https://www.xwiki.org/xwiki/bin/view/Documentation/
- Lizenz: XWiki steht unter der LGPL-2.1.
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.
Outline
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Outline ist ein Wiki für Teams, in dem mehrere Personen gleichzeitig an Dokumenten schreiben, ähnlich wie in Notion oder Confluence. Diese Anleitung baut Outline ohne Docker aus dem Quellcode, speichert die Inhalte in PostgreSQL und lässt die Anmeldung über Keycloak laufen.
Vorbemerkungen
- Voraussetzungen: PostgreSQL und Keycloak sind nach den jeweiligen Anleitungen installiert und laufen. In Keycloak gibt es den Realm
internmit mindestens einem Benutzer, der eine E-Mail-Adresse hat. - Warum Keycloak: Outline hat keine eigene Benutzerverwaltung mit Passwörtern. Das erste Konto lässt sich nur über einen Anmeldedienst wie Slack, Google oder einen OpenID-Connect-Server anlegen. Keycloak ist so ein Server, der vollständig auf dem eigenen Rechner läuft.
- Ohne Docker: Das Projekt veröffentlicht fertige Pakete nur als Docker-Image. Ohne Docker lädt man den Quellcode mit Git und baut ihn selbst. Node.js und Redis kommen aus den Paketquellen von Ubuntu. Den Paketmanager Yarn holt das Hilfsprogramm corepack in genau der Version, die Outline vorschreibt.
- Version: Getestet mit Outline 1.10.1, Node.js 22, Redis 8, Keycloak 26.7 und PostgreSQL 18.
- Platz und Zeit: Quellcode, Bibliotheken und Build brauchen etwa 2,5 GB. Das Bauen dauert je nach Rechner einige Minuten und braucht mindestens 4 GB freien Arbeitsspeicher.
- Port: Outline läuft normalerweise auf Port 3000. Diesen Port belegt hier schon Martin, Port 3001 ist für Wiki.js vorgesehen. Die Anleitung verwendet deshalb Port 3002. Outline selbst nimmt Verbindungen auf allen Netzwerkschnittstellen an. Der Dienst in Schritt 20 beschränkt das auf den eigenen Rechner.
- Passwort:
geheimes_passwortist ein Beispiel. Ersetze es überall durch ein eigenes Passwort.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Git, Node.js, corepack und Redis installieren
gitlädt den Quellcode von Outline.nodejsführt Outline aus. Outline 1.10 braucht Node.js 20, 22, 24 oder 26, Ubuntu 26.04 liefert Version 22.node-corepackholt später die passende Version des Paketmanagers Yarn.redis-serverist ein schneller Zwischenspeicher im Arbeitsspeicher. Outline verteilt darüber Aufgaben und hält die Dokumente beim gemeinsamen Bearbeiten auf dem gleichen Stand.
sudo apt install git nodejs node-corepack redis-server
Prüfen: Die Node.js-Version beginnt mit v22.
/usr/bin/node --version
Prüfen: Redis läuft und antwortet mit PONG.
redis-cli ping
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer für Outline anlegen
Legt in PostgreSQL den Benutzer outline an.
sudo -u postgres psql -c "CREATE USER outline WITH PASSWORD 'geheimes_passwort';"
4. Datenbank für Outline anlegen
Legt die leere Datenbank outline an. Die Tabellen erstellt Outline beim ersten Start selbst.
sudo -u postgres psql -c "CREATE DATABASE outline OWNER outline;"
Prüfen: Die Datenbank erscheint in der Liste.
sudo -u postgres psql -l | grep outline
Outline in Keycloak eintragen
Damit Keycloak Anmeldungen für Outline annimmt, bekommt Outline dort einen eigenen Client. Das ist der Eintrag eines Programms, das Keycloak zur Anmeldung nutzt.
5. Client-Secret erzeugen
Outline weist sich gegenüber Keycloak mit einem geheimen Schlüssel aus, dem Client-Secret. Dieser Befehl erzeugt eine zufällige Zeichenfolge. Kopiere sie, du brauchst sie in Schritt 7 und Schritt 18.
openssl rand -hex 32
6. Befehlszeilenwerkzeug von Keycloak anmelden
Die Anmeldung aus der Keycloak-Anleitung läuft nach kurzer Zeit ab. Melde kcadm.sh deshalb neu an. Es fragt nach dem Passwort des Keycloak-Administrators.
/opt/keycloak/bin/kcadm.sh config credentials --server http://localhost:8083 --realm master --user admin
7. Client für Outline anlegen
Legt im Realm intern den Client outline an. Ersetze DEIN_CLIENT_SECRET durch die Zeichenfolge aus Schritt 5.
/opt/keycloak/bin/kcadm.sh create clients -r intern -s clientId=outline -s enabled=true -s publicClient=false -s secret=DEIN_CLIENT_SECRET -s 'redirectUris=["http://localhost:3002/auth/oidc.callback"]' -s 'webOrigins=["http://localhost:3002"]' -s standardFlowEnabled=true -s directAccessGrantsEnabled=false
Was die Angaben bedeuten:
publicClient=falseundsecret– Outline muss sich mit dem Client-Secret ausweisen. Das geht, weil Outline auf dem Server läuft und das Secret dort geheim bleibt.redirectUris– die einzige Adresse, zu der Keycloak nach der Anmeldung zurückleiten darf. Bei Outline endet sie immer auf/auth/oidc.callback.webOrigins– erlaubt dem Browser Anfragen von der Adresse von Outline an Keycloak.standardFlowEnabled=true– die übliche Anmeldung über eine Weiterleitung im Browser.directAccessGrantsEnabled=false– Outline darf keine Passwörter direkt an Keycloak schicken. Das braucht es nicht.
Prüfen: Die Ausgabe lautet Created new client with id '…'.
Outline herunterladen und bauen
8. Systembenutzer anlegen
Outline läuft unter einem eigenen Benutzer outline, mit dem man sich nicht anmelden kann. Sein Heimatordner ist der Programmordner. Dort legt corepack auch die heruntergeladene Yarn-Version ab.
sudo useradd --system --home-dir /opt/outline --shell /usr/sbin/nologin outline
9. Quellcode herunterladen
Lädt die Version 1.10.1 von Outline nach /opt/outline. -b v1.10.1 wählt genau diese Version, --depth 1 lässt die Versionsgeschichte weg. Die aktuelle Versionsnummer steht auf https://github.com/outline/outline/releases.
sudo git clone -b v1.10.1 --depth 1 https://github.com/outline/outline.git /opt/outline
Die Meldung über einen „losgelösten HEAD“ (detached HEAD) ist normal: Git zeigt eine feste Version statt eines Entwicklungszweigs.
10. Eigentümer ändern
Übergibt den Ordner dem Benutzer outline, damit er dort bauen darf.
sudo chown -R outline:outline /opt/outline
11. In den Programmordner wechseln
Die folgenden Yarn-Befehle arbeiten immer im aktuellen Ordner.
cd /opt/outline
12. Bibliotheken installieren
Lädt alle Bibliotheken, die Outline braucht, in den Ordner node_modules. corepack liest aus package.json, welche Yarn-Version Outline vorschreibt, und lädt sie beim ersten Aufruf. Fragt corepack, ob es Yarn herunterladen darf, bestätige mit Y. --immutable sorgt dafür, dass genau die Versionen installiert werden, mit denen die Entwickler getestet haben. Meldungen mit YN0004 (Build-Skripte abgeschaltet) sind normal.
sudo -u outline corepack yarn install --immutable
Prüfen: Die letzte Zeile beginnt mit ➤ YN0000: · Done.
13. Outline bauen
Übersetzt die Weboberfläche und den Server in fertiges JavaScript im Ordner build. Das dauert einige Minuten.
sudo -u outline corepack yarn build
Prüfen: Die Ausgabe endet mit Done!, und der Ordner build enthält app und server.
ls /opt/outline/build
Outline einrichten
14. Ordner für hochgeladene Dateien anlegen
Outline speichert Bilder und Anhänge hier auf der Festplatte statt in einem Cloud-Speicher.
sudo mkdir -p /var/lib/outline/data
15. Eigentümer des Datenordners setzen
Nur Outline soll in diesen Ordner schreiben.
sudo chown -R outline:outline /var/lib/outline
16. Ersten geheimen Schlüssel erzeugen
Outline braucht zwei zufällige Schlüssel. Mit ihnen verschlüsselt es Anmeldesitzungen und gespeicherte Zugangsdaten. Kopiere die Ausgabe für SECRET_KEY in Schritt 18.
openssl rand -hex 32
17. Zweiten geheimen Schlüssel erzeugen
Derselbe Befehl noch einmal, diesmal für UTILS_SECRET. Die beiden Schlüssel müssen verschieden sein.
openssl rand -hex 32
18. Einstellungsdatei anlegen
Outline liest seine Einstellungen aus der Datei .env im Programmordner. Eine ausführlich kommentierte Vorlage mit allen Möglichkeiten liegt in .env.sample.
sudo nano /opt/outline/.env
Füge diesen Inhalt ein (Strg+Umschalt+V). Setze die Schlüssel aus den Schritten 16 und 17 und das Client-Secret aus Schritt 5 ein. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
NODE_ENV=production
URL=http://localhost:3002
PORT=3002
FORCE_HTTPS=false
SECRET_KEY=SCHLÜSSEL_AUS_SCHRITT_16
UTILS_SECRET=SCHLÜSSEL_AUS_SCHRITT_17
DATABASE_URL=postgres://outline:geheimes_passwort@127.0.0.1:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://127.0.0.1:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data
OIDC_ISSUER_URL=http://localhost:8083/realms/intern
OIDC_CLIENT_ID=outline
OIDC_CLIENT_SECRET=DEIN_CLIENT_SECRET
OIDC_DISPLAY_NAME=Keycloak
OIDC_USERNAME_CLAIM=preferred_username
OIDC_SCOPES=openid profile email
DEFAULT_LANGUAGE=de_DE
Was die Einträge bedeuten:
URL– die Adresse, unter der Outline im Browser aufgerufen wird. Sie muss genau zurredirectUrisaus Schritt 7 passen.PORT– der Port, auf dem Outline Anfragen annimmt.FORCE_HTTPS=false– Outline leitet sonst jede Anfrage auf HTTPS um. Hier gibt es kein Zertifikat.SECRET_KEYundUTILS_SECRET– die beiden Schlüssel aus den Schritten 16 und 17.DATABASE_URL– Benutzer, Passwort, Adresse und Name der Datenbank aus den Schritten 3 und 4.PGSSLMODE=disable– die Verbindung zur Datenbank bleibt auf dem eigenen Rechner und braucht keine Verschlüsselung.REDIS_URL– die Adresse von Redis.FILE_STORAGE=localundFILE_STORAGE_LOCAL_ROOT_DIR– Anhänge landen im Ordner aus Schritt 14.OIDC_ISSUER_URL– die Adresse des Realmsintern. Outline liest dort alle weiteren Adressen von Keycloak selbst aus.OIDC_CLIENT_IDundOIDC_CLIENT_SECRET– Name und Secret des Clients aus Schritt 7.OIDC_DISPLAY_NAME– die Beschriftung der Anmeldeschaltfläche.OIDC_USERNAME_CLAIM– aus diesem Feld übernimmt Outline den Benutzernamen.OIDC_SCOPES– Outline fragt bei Keycloak Name und E-Mail-Adresse des Benutzers ab.DEFAULT_LANGUAGE=de_DE– neue Benutzer sehen die Oberfläche auf Deutsch.
19. Einstellungsdatei schützen
Die Datei enthält Passwörter und Schlüssel. Die beiden Befehle übergeben sie dem Benutzer outline und sperren sie für alle anderen.
sudo chown outline:outline /opt/outline/.env
sudo chmod 600 /opt/outline/.env
Als Dienst einrichten
20. systemd-Dienst anlegen
Damit Outline beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/outline.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Outline
After=network.target postgresql.service redis-server.service keycloak.service
[Service]
Type=simple
User=outline
Group=outline
WorkingDirectory=/opt/outline
ExecStart=/usr/bin/node build/server/index.js
Restart=on-failure
IPAddressDeny=any
IPAddressAllow=localhost
[Install]
WantedBy=multi-user.target
After=– Outline startet erst nach PostgreSQL, Redis und Keycloak.WorkingDirectory=– Outline findet dort die Datei.env.ExecStart=– startet den gebauten Server mit dem Node.js aus Ubuntu.IPAddressDeny=anyundIPAddressAllow=localhost– systemd lässt nur Verbindungen vom und zum eigenen Rechner durch. Aus dem Netzwerk ist Outline so nicht erreichbar, obwohl es auf allen Schnittstellen lauscht.
21. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
22. Dienst starten und Autostart einschalten
Startet Outline sofort und bei jedem Hochfahren. Beim ersten Start legt Outline die Tabellen in PostgreSQL an.
sudo systemctl enable --now outline
23. Protokoll ansehen
Zeigt die Meldungen von Outline fortlaufend an. Strg+C beendet die Anzeige.
sudo journalctl -u outline -f
Prüfen: Nach vielen Zeilen mit Migrating … erscheint Listening on http://localhost:3002. Die Warnung Enforced https was disabled ist gewollt.
24. Aufruf prüfen
Prüft, ob Outline antwortet.
curl -sI http://localhost:3002/
Prüfen: Die erste Zeile lautet HTTP/1.1 200 OK.
Erste Anmeldung
25. Mit Keycloak anmelden
Öffne im Browser http://localhost:3002. Klicke auf die Schaltfläche mit Keycloak. Der Browser wechselt zur Anmeldeseite von Keycloak. Melde dich dort mit dem Benutzer aus dem Realm intern an. Danach leitet Keycloak zurück zu Outline.
Beim allerersten Anmelden legt Outline einen Arbeitsbereich an und macht dich zu dessen Administrator. Alle weiteren Benutzer aus dem Realm intern können sich danach ebenfalls anmelden und landen im selben Arbeitsbereich.
Prüfen: Outline zeigt die Sammlung Welcome mit einigen Beispieldokumenten.
26. Arbeitsbereich benennen (optional)
Den Namen des Arbeitsbereichs änderst du unter Einstellungen → Details.
Soll Outline später unter einer eigenen Domain erreichbar sein, leitet man die Anfragen über nginx an 127.0.0.1:3002 weiter. Dann müssen URL in .env, die Adressen des Clients in Keycloak und hostname in der Keycloak-Einstellung zur neuen Adresse passen, und IPAddressDeny bleibt, weil nginx auf demselben Rechner läuft.
Aktualisieren
Neue Versionen holst du mit Git und baust sie neu. Die Datenbank passt Outline beim nächsten Start selbst an. Die Befehle 2 bis 5 laufen im Ordner /opt/outline. v1.10.2 steht hier als Beispiel für die neue Versionsnummer.
1. In den Programmordner wechseln
Git und Yarn arbeiten im aktuellen Ordner.
cd /opt/outline
2. Neue Version herunterladen
Holt nur die gewünschte Version vom Server.
sudo -u outline git fetch --depth 1 origin tag v1.10.2
3. Auf die neue Version umschalten
Tauscht den Quellcode gegen die neue Version aus. .env gehört nicht zum Quellcode und bleibt erhalten.
sudo -u outline git checkout v1.10.2
4. Bibliotheken aktualisieren
Bringt node_modules auf den Stand der neuen Version.
sudo -u outline corepack yarn install --immutable
5. Neu bauen
Erzeugt den Ordner build für die neue Version.
sudo -u outline corepack yarn build
6. Dienst neu starten
Startet die neue Version. Dabei laufen die nötigen Änderungen an der Datenbank.
sudo systemctl restart outline
Prüfen: Im Protokoll (sudo journalctl -u outline -n 50) steht wieder Listening on http://localhost:3002.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Outline und verhindert den Start beim Hochfahren.
sudo systemctl disable --now outline
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 20.
sudo rm /etc/systemd/system/outline.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programm- und Datenordner löschen
Entfernt Outline samt Einstellungen und alle hochgeladenen Dateien. Achtung: Anhänge gehen dabei verloren.
sudo rm -rf /opt/outline /var/lib/outline
5. Datenbank löschen
Löscht die Datenbank outline. Achtung: Alle Dokumente gehen unwiderruflich verloren.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS outline;"
6. Datenbankbenutzer löschen
Entfernt den PostgreSQL-Benutzer aus Schritt 3.
sudo -u postgres psql -c "DROP USER IF EXISTS outline;"
7. Systembenutzer löschen
Entfernt den Linux-Benutzer aus Schritt 8.
sudo userdel outline
8. Befehlszeilenwerkzeug von Keycloak anmelden
Für das Entfernen des Clients braucht kcadm.sh eine gültige Anmeldung.
/opt/keycloak/bin/kcadm.sh config credentials --server http://localhost:8083 --realm master --user admin
9. Interne Nummer des Clients ermitteln
Keycloak löscht Clients über ihre interne Nummer (id), nicht über den Namen. Dieser Befehl zeigt sie an.
/opt/keycloak/bin/kcadm.sh get clients -r intern -q clientId=outline --fields id
10. Client in Keycloak löschen
Ersetze CLIENT_ID durch die Nummer aus Schritt 9.
/opt/keycloak/bin/kcadm.sh delete clients/CLIENT_ID -r intern
11. Redis entfernen (optional)
Nur ausführen, wenn kein anderes Programm Redis braucht. purge entfernt auch die gespeicherten Daten von Redis.
sudo apt purge redis-server redis-tools
sudo apt autoremove
Prüfen: Unter Port 3002 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:3002/
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.getoutline.com/
- Lizenz: Outline steht unter der BSL-1.1 (Business Source License).
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.
Gollum
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Gollum ist ein schlankes Wiki, das alle Seiten als Markdown-Dateien in einem Git-Repository speichert. Jede Änderung im Browser wird zu einem Git-Commit. Man kann das Wiki deshalb genauso gut mit einem Texteditor und git bearbeiten. Diese Anleitung installiert Gollum als Ruby-Programm und lässt es als Dienst auf dem eigenen Rechner laufen.
Vorbemerkungen
- Voraussetzung: Git ist installiert (
git --version). - Installation über RubyGems: Ubuntu hat kein Paket für Gollum selbst. Es wird mit dem Ruby-Paketmanager
geminstalliert. Ruby, die Build-Werkzeuge und die Git-Bibliothekruggedkommen aber aus apt. - Warum
ruggedaus apt: Gollum greift überruggedauf Git zu. Holtgemdieses Modul selbst, muss es die Bibliothek libgit2 übersetzen. Unter Ubuntu 26.04 bricht das mit einem Linkerfehler ab (-l:libjitterentropy.a kann nicht gefunden werden). Das fertige Paketruby-ruggedumgeht das.gemerkennt es als bereits installiert. - Version: Getestet mit Gollum 6.1.0 und Ruby 3.3 unter Ubuntu 26.04.
- Keine Benutzerkonten: Gollum hat keine Anmeldung. Jeder, der das Wiki erreicht, darf lesen und schreiben. Die Anleitung macht es deshalb nur auf dem eigenen Rechner erreichbar, auf Port 4567.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Ruby, Build-Werkzeuge und rugged installieren
ruby– die Programmiersprache, in der Gollum geschrieben ist, samt Paketmanagergem.ruby-devundbuild-essential– Compiler und Kopfdateien. Einige Bibliotheken von Gollum enthalten C-Code, dengembei der Installation übersetzt.ruby-rugged– die fertig übersetzte Git-Anbindung für Ruby.
sudo apt install ruby ruby-dev build-essential ruby-rugged
Prüfen: Die Ausgabe beginnt mit ruby 3.3, und gem findet rugged in Version 1.9.
ruby --version
gem list rugged
3. Gollum installieren
Lädt Gollum und rund 35 Bibliotheken, die es braucht, von https://rubygems.org und installiert sie für das ganze System. Einige davon werden dabei übersetzt (Building native extensions), das dauert etwa eine Minute. --no-document lässt die Hilfetexte der Bibliotheken weg.
sudo gem install --no-document gollum
Prüfen: Die Ausgabe endet mit … gems installed, und Gollum meldet seine Version.
gollum --version
Wiki einrichten
4. Systembenutzer anlegen
Gollum soll unter einem eigenen Benutzer laufen, mit dem man sich nicht anmelden kann. --create-home legt gleich den Ordner /var/lib/gollum an, in dem das Wiki liegen wird.
sudo useradd --system --create-home --home-dir /var/lib/gollum --shell /usr/sbin/nologin gollum
5. Git-Repository für das Wiki anlegen
Legt ein leeres Git-Repository an, in dem Gollum die Seiten speichert. -b main nennt den Hauptzweig main. Gollum wird in Schritt 6 angewiesen, genau diesen Zweig zu verwenden. sudo -u gollum sorgt dafür, dass der Ordner dem Benutzer gollum gehört.
sudo -u gollum git init -b main /var/lib/gollum/wiki
Prüfen: Die Ausgabe lautet Leeres Git-Repository in /var/lib/gollum/wiki/.git/ initialisiert (oder englisch Initialized empty Git repository …).
Als Dienst einrichten
6. systemd-Dienst anlegen
Damit Gollum beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/gollum.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Gollum Wiki
After=network.target
[Service]
Type=simple
User=gollum
Group=gollum
WorkingDirectory=/var/lib/gollum
ExecStart=/usr/local/bin/gollum --host 127.0.0.1 --port 4567 --ref main --allow-uploads dir --h1-title /var/lib/gollum/wiki
Restart=on-failure
[Install]
WantedBy=multi-user.target
Was die Angaben für Gollum bedeuten:
--host 127.0.0.1– nur vom eigenen Rechner aus erreichbar. Ohne diese Angabe lauscht Gollum auf allen Netzwerkschnittstellen.--port 4567– der Port, unter dem das Wiki erreichbar ist.--ref main– der Git-Zweig aus Schritt 5. Gollum erwartet sonstmaster.--allow-uploads dir– erlaubt das Hochladen von Bildern und Dateien. Sie landen im Repository im Ordneruploads.--h1-title– die erste Überschrift einer Seite dient als Seitentitel statt des Dateinamens./var/lib/gollum/wiki– das Git-Repository mit den Seiten.
7. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
8. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet Gollum zusätzlich sofort.
sudo systemctl enable --now gollum
Prüfen: Im Protokoll steht Sinatra (v4.2.1) has taken the stage on 4567.
sudo journalctl -u gollum -n 10
9. Aufruf prüfen
Gollum leitet die Startadresse auf die Seite Home weiter.
curl -sI http://localhost:4567/
Prüfen: Die erste Zeile lautet HTTP/1.1 302 Found, und bei Location steht http://localhost:4567/Home.
Erste Seite anlegen
10. Startseite im Browser anlegen
Öffne http://localhost:4567. Da es die Seite Home noch nicht gibt, bietet Gollum an, sie anzulegen. Wähle als Format Markdown, schreibe einen Text und speichere mit Save. Im Feld Edit message kannst du beschreiben, was du geändert hast. Das wird zur Commit-Nachricht.
Links auf andere Wiki-Seiten schreibst du so: [[Notizen]]. Existiert die Seite noch nicht, legt ein Klick darauf sie an.
11. Änderung in Git ansehen
Jede gespeicherte Seite ist ein Commit im Repository. Diesen Befehl führst du als Benutzer gollum aus, weil ihm das Repository gehört.
sudo -u gollum git -C /var/lib/gollum/wiki log --oneline
Prüfen: Die Liste zeigt einen Commit mit deiner Nachricht. Als Autor trägt Gollum Anonymous ein, weil es keine Benutzerkonten kennt. Die Seite selbst liegt als Home.md im Repository:
sudo -u gollum git -C /var/lib/gollum/wiki ls-files
Aktualisieren
1. Neue Version installieren
gem update holt die neueste Version von Gollum und seinen Bibliotheken.
sudo gem update --no-document gollum
2. Dienst neu starten
Der laufende Dienst verwendet sonst weiter die alte Version.
sudo systemctl restart gollum
Prüfen: gollum --version zeigt die neue Versionsnummer.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Gollum und verhindert den Start beim Hochfahren.
sudo systemctl disable --now gollum
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 6.
sudo rm /etc/systemd/system/gollum.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Benutzer und Wiki löschen
-r löscht mit dem Benutzer auch seinen Ordner /var/lib/gollum und damit das Git-Repository mit allen Seiten. Achtung: Wer die Seiten behalten will, kopiert den Ordner /var/lib/gollum/wiki vorher woanders hin. Die Warnung Mail-Warteschlange … nicht gefunden ist harmlos.
sudo userdel -r gollum
5. Gollum und alle Gems entfernen
Entfernt alle Ruby-Bibliotheken, die mit sudo gem install installiert wurden, samt ihrer Startbefehle in /usr/local/bin. --install-dir beschränkt das auf den Ordner, in den gem installiert. Pakete aus apt wie ruby-rugged bleiben unberührt. Achtung: Hast du mit sudo gem install noch andere Programme installiert, verschwinden sie ebenfalls.
sudo gem uninstall --all --ignore-dependencies --executables --install-dir /var/lib/gems/3.3.0
Prüfen: Die letzte Zeile lautet INFO: Uninstalled all gems in /var/lib/gems/3.3.0.
6. Ruby entfernen (optional)
Nur ausführen, wenn kein anderes Programm Ruby braucht. build-essential bleibt installiert, weil es auch für andere Anleitungen wie C und C++ gebraucht wird.
sudo apt purge ruby ruby-dev ruby-rugged
sudo apt autoremove
7. Leere Gem-Ordner löschen
Nach dem Entfernen von Ruby bleibt der leere Ordner /var/lib/gems zurück.
sudo rm -rf /var/lib/gems
Prüfen: Der Befehl gollum wird nicht mehr gefunden, und unter Port 4567 antwortet nichts mehr.
curl -sI http://localhost:4567/
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/gollum/gollum
- Lizenz: Gollum steht unter der MIT.
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.
Apache Jena Fuseki
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Apache Jena Fuseki ist ein Server für RDF-Daten, also für Wissen in Form von Aussagen wie „Hamburg – hat Einwohner – 1.910.000“. Solche Aussagen heißen Tripel. Fuseki speichert sie dauerhaft und beantwortet Abfragen in der Abfragesprache SPARQL, über eine Weboberfläche oder per HTTP. Diese Anleitung lässt Fuseki als Dienst auf dem eigenen Rechner laufen.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für Fuseki. Die Apache Software Foundation stellt ein fertiges Archiv bereit, das nur Java braucht. Java kommt aus den Paketquellen von Ubuntu.
- Version: Getestet mit Fuseki 6.2.0 und Java 25 unter Ubuntu 26.04. Fuseki 6 braucht mindestens Java 21.
- Ordner: Das Programm liegt in
/opt/fuseki. Datenbanken, Einstellungen und Protokolle legt Fuseki in einem eigenen Arbeitsordner ab, hier/var/lib/fuseki. So bleiben die Daten bei einem Update unberührt. - Port: Fuseki läuft auf Port 3030 und ist nur vom eigenen Rechner aus erreichbar.
- Kein Passwort: Die Verwaltung (Datenbanken anlegen und löschen) erlaubt Fuseki von Haus aus nur vom eigenen Rechner. Abfragen und Änderungen an den Daten sind ohne Anmeldung möglich. Solange Fuseki nur auf
localhosthört, ist das in Ordnung.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. Java und curl installieren
openjdk-25-jre-headless ist die Java-Laufzeitumgebung ohne grafische Teile. Mit curl lädst du später das Archiv herunter und sprichst mit Fuseki.
sudo apt install openjdk-25-jre-headless curl
Prüfen: Der Ordner mit Java 25 ist vorhanden. Den Pfad braucht der Dienst in Schritt 8.
ls /usr/lib/jvm/java-25-openjdk-amd64/bin/java
3. Programmarchiv herunterladen
Lädt Fuseki 6.2.0 (etwa 50 MB) in den Ordner /tmp. Die aktuelle Version steht auf https://jena.apache.org/download/.
curl -L -o /tmp/fuseki.tar.gz https://dlcdn.apache.org/jena/binaries/apache-jena-fuseki-6.2.0.tar.gz
4. Prüfsumme kontrollieren
Stellt sicher, dass das Archiv vollständig und unverändert angekommen ist. Apache veröffentlicht die Prüfsumme neben dem Archiv, in einer Datei mit der Endung .sha512.
sha512sum /tmp/fuseki.tar.gz
Prüfen: Die Ausgabe beginnt mit ba65f5867d2d4741b2ed9e2af5a0d4fbb447909894ab2a0c6bc4dac8997f4fe339c87b13c48d45d054977769f0f8bf763ea346b1f7792d5cdc458041bd43a132.
5. Programmordner anlegen
Legt den Ordner für das Programm an.
sudo mkdir /opt/fuseki
6. Archiv entpacken
Im Archiv liegt alles in einem Unterordner apache-jena-fuseki-6.2.0. --strip-components=1 lässt diese Ebene weg, sodass die Dateien direkt in /opt/fuseki landen.
sudo tar xzf /tmp/fuseki.tar.gz -C /opt/fuseki --strip-components=1
Prüfen: Der Ordner enthält fuseki-server und fuseki-server.jar.
ls /opt/fuseki
7. Systembenutzer anlegen
Fuseki soll unter einem eigenen Benutzer laufen, mit dem man sich nicht anmelden kann. --create-home legt dabei den Arbeitsordner /var/lib/fuseki an. Das Programm in /opt/fuseki gehört weiter root, Fuseki kann es also nicht verändern.
sudo useradd --system --create-home --home-dir /var/lib/fuseki --shell /usr/sbin/nologin fuseki
Als Dienst einrichten
8. systemd-Dienst anlegen
Im Archiv liegt unter service/service/fuseki.service eine Vorlage. Die folgende Datei baut darauf auf, mit angepassten Pfaden.
sudo nano /etc/systemd/system/fuseki.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Apache Jena Fuseki
After=network.target
[Service]
Type=simple
User=fuseki
Group=fuseki
Environment=FUSEKI_HOME=/opt/fuseki
Environment=FUSEKI_BASE=/var/lib/fuseki
Environment=JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64
Environment=JVM_ARGS=-Xmx2G
ExecStart=/opt/fuseki/fuseki-server --localhost --port 3030
Restart=on-abort
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
Was die Angaben bedeuten:
FUSEKI_HOME– der Programmordner aus Schritt 6.FUSEKI_BASE– der Arbeitsordner für Datenbanken, Einstellungen und Protokolle.JAVA_HOME– Fuseki nutzt ausdrücklich Java 25, auch wenn weitere Java-Versionen installiert sind.JVM_ARGS=-Xmx2G– Fuseki darf bis zu 2 GB Arbeitsspeicher belegen. Für große Datenmengen erhöht man den Wert.--localhost– Fuseki ist nur vom eigenen Rechner aus erreichbar.--port 3030– der Port für Weboberfläche und Abfragen.SuccessExitStatus=143– Java beendet sich beim Stoppen mit dem Code 143. systemd soll das nicht als Fehler werten.
9. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
10. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet Fuseki zusätzlich sofort. Beim ersten Start legt Fuseki im Arbeitsordner Unterordner wie databases und configuration an.
sudo systemctl enable --now fuseki
Prüfen: Im Protokoll stehen Fuseki Base = /var/lib/fuseki und Start Fuseki.
sudo journalctl -u fuseki -n 15
11. Erreichbarkeit prüfen
/$/ping ist eine Adresse, die nur meldet, ob Fuseki läuft. Die einfachen Anführungszeichen verhindern, dass die Shell $ als Variable liest.
curl -s 'http://localhost:3030/$/ping'
Prüfen: Die Ausgabe ist Datum und Uhrzeit, z. B. 2026-09-25T22:14:24.069+00:00. Im Browser zeigt http://localhost:3030 die Weboberfläche von Fuseki.
Erste Daten
12. Datenbank anlegen
Legt eine dauerhafte Datenbank namens wissen an. tdb2 ist das Speicherformat von Jena, das die Daten auf der Festplatte ablegt. Dasselbe geht auch in der Weboberfläche im Bereich zur Verwaltung der Datenbanken.
curl -s --data 'dbName=wissen&dbType=tdb2' 'http://localhost:3030/$/datasets'
Prüfen: Die Datenbank erscheint in der Liste der Datenbanken von Fuseki.
curl -s 'http://localhost:3030/$/datasets' | grep ds.name
13. Beispieldaten schreiben
Legt eine Datei im Format Turtle an, einer gut lesbaren Schreibweise für RDF.
nano ~/staedte.ttl
Füge diesen Inhalt ein, speichere mit Strg+O und Enter und beende nano mit Strg+X:
@prefix ex: <http://example.org/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
ex:Hamburg rdfs:label "Hamburg" ; ex:einwohner 1910000 ; ex:liegtIn ex:Hamburg_Land .
ex:Ahrensburg rdfs:label "Ahrensburg" ; ex:einwohner 34800 ; ex:liegtIn ex:Schleswig-Holstein .
@prefix– Abkürzungen:ex:Hamburgsteht fürhttp://example.org/Hamburg. In RDF hat jedes Ding eine weltweit eindeutige Adresse.- Jede Zeile beschreibt eine Stadt.
;trennt mehrere Aussagen über dieselbe Stadt,.beendet sie. Zusammen sind es sechs Tripel.
14. Daten laden
Schickt die Datei an die Datenbank wissen. Content-Type: text/turtle sagt Fuseki, in welchem Format die Daten kommen.
curl -s -X POST -H 'Content-Type: text/turtle' --data-binary @$HOME/staedte.ttl http://localhost:3030/wissen/data
Prüfen: Die Antwort meldet "tripleCount" : 6.
15. SPARQL-Abfrage stellen
Fragt alle Städte mit ihrer Einwohnerzahl ab, die größte zuerst. Accept: text/csv bestellt das Ergebnis als einfache Tabelle.
curl -s -H 'Accept: text/csv' --data-urlencode 'query=PREFIX ex: <http://example.org/> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT ?stadt ?einwohner WHERE { ?s rdfs:label ?stadt ; ex:einwohner ?einwohner } ORDER BY DESC(?einwohner)' http://localhost:3030/wissen/query
Prüfen: Die Ausgabe lautet:
stadt,einwohner
Hamburg,1910000
Ahrensburg,34800
Bequemer geht es im Browser: Auf http://localhost:3030 gibt es zu jeder Datenbank einen Abfrage-Editor.
Wo liegt was?
/var/lib/fuseki/databases– die Datenbanken, ein Ordner pro Datenbank./var/lib/fuseki/configuration– eine Beschreibung pro Datenbank, damit Fuseki sie nach einem Neustart wieder öffnet./var/lib/fuseki/shiro.ini– Zugriffsregeln. Hier legt man bei Bedarf Benutzer und Passwörter an./var/lib/fuseki/backups– Sicherungen, die man in der Weboberfläche anstoßen kann.
Aktualisieren
1. Neue Version herunterladen
Lädt die neue Version. Ersetze 6.2.0 durch die aktuelle Versionsnummer.
curl -L -o /tmp/fuseki.tar.gz https://dlcdn.apache.org/jena/binaries/apache-jena-fuseki-6.2.0.tar.gz
2. Dienst stoppen
Fuseki darf beim Austausch der Dateien nicht laufen.
sudo systemctl stop fuseki
3. Neue Version entpacken
Überschreibt die Programmdateien in /opt/fuseki. Die Daten in /var/lib/fuseki bleiben unberührt.
sudo tar xzf /tmp/fuseki.tar.gz -C /opt/fuseki --strip-components=1
4. Dienst starten
Startet die neue Version.
sudo systemctl start fuseki
Prüfen: Im Protokoll (sudo journalctl -u fuseki -n 15) steht die neue Versionsnummer.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Fuseki und verhindert den Start beim Hochfahren.
sudo systemctl disable --now fuseki
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 8.
sudo rm /etc/systemd/system/fuseki.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programm und Archiv löschen
Entfernt den Programmordner und das heruntergeladene Archiv.
sudo rm -rf /opt/fuseki /tmp/fuseki.tar.gz
5. Benutzer und Daten löschen
-r löscht mit dem Benutzer auch seinen Ordner /var/lib/fuseki und damit alle Datenbanken. Achtung: Die Daten gehen dabei verloren. Die Warnung Mail-Warteschlange … nicht gefunden ist harmlos.
sudo userdel -r fuseki
6. Beispieldatei löschen
Entfernt die Datei aus Schritt 13.
rm -f ~/staedte.ttl
7. Java entfernen (optional)
Nur ausführen, wenn kein anderes Programm Java 25 braucht, z. B. Keycloak.
sudo apt purge openjdk-25-jre-headless
sudo apt autoremove
Prüfen: Unter Port 3030 antwortet nichts mehr, curl meldet einen Verbindungsfehler.
curl -sI http://localhost:3030/
Quellen und Lizenz
- Offizielle Dokumentation: https://jena.apache.org/documentation/fuseki2/
- Lizenz: Apache Jena Fuseki steht unter der Apache-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.
LangGraph und LangChain
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
LangChain und LangGraph sind Python-Bibliotheken, mit denen man Anwendungen rund um große Sprachmodelle (LLMs) baut: Chatbots, Agenten, die selbstständig Werkzeuge aufrufen, oder mehrstufige Abläufe. LangGraph beschreibt solche Abläufe als Graph aus Schritten mit gemeinsamem Zustand. LangChain liefert darauf aufbauend fertige Bausteine wie Agenten und Anbindungen an viele Modellanbieter.
Vorbemerkungen
-
Das Ökosystem: Die Pakete bauen aufeinander auf:
Paket Aufgabe langchain-coreGemeinsame Grundlagen: Nachrichten, Werkzeuge, Schnittstelle für Chat-Modelle langgraphAbläufe als Graph mit Zustand, Verzweigungen, Schleifen und Gedächtnis langchainFertige Bausteine, vor allem create_agentfür Agenten mit Werkzeugen. Baut intern auf LangGraph auf.langchain-anthropicAnbindung an Claude von Anthropic. Für andere Anbieter gibt es entsprechende Pakete, z. B. langchain-openaioderlangchain-ollama.LangSmith Optionaler Online-Dienst zum Nachverfolgen und Auswerten von Abläufen. Wird in dieser Anleitung nicht verwendet. -
Installation über pip: Die Pakete sind nicht in den Ubuntu-Paketquellen enthalten. Sie werden mit
pipin eine virtuelle Umgebung (venv) installiert. Das ist ein eigener Ordner nur für dieses Projekt. Ubuntu verhindert absichtlich, dasspipPakete systemweit installiert, damit die Python-Pakete des Systems nicht durcheinandergeraten. -
Versionen: LangGraph 1.2, LangChain 1.4 und langchain-anthropic 1.7 unter Python 3.14.
-
Sprachmodell: Das Beispiel mit Agent verwendet Claude Opus 5. Dafür brauchst du einen API-Schlüssel von Anthropic (https://console.anthropic.com), und jede Anfrage kostet Geld. Das erste Beispiel kommt ohne Sprachmodell aus.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des Pakets für virtuelle Umgebungen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Python selbst ist unter Ubuntu schon installiert.
sudo apt install python3-venv
3. Projektordner anlegen
Ein eigener Ordner für die Beispiele.
mkdir ~/langgraph-test
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/langgraph-test
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an. Dort landen später alle Pakete dieses Projekts.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Sorgt dafür, dass python und pip in diesem Terminal die Umgebung verwenden. Das musst du in jedem neuen Terminal wiederholen, bevor du mit dem Projekt arbeitest.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. LangGraph, LangChain und die Claude-Anbindung installieren
Installiert die drei Pakete samt Abhängigkeiten (darunter langchain-core und das Anthropic-SDK). -U holt jeweils die neueste Version.
pip install -U langgraph langchain langchain-anthropic
Prüfen: Die Liste zeigt die installierten Versionen, z. B. langgraph 1.2.12.
pip list | grep -E "^(langgraph|langchain|anthropic) "
Beispiel 1: Ein Graph ohne Sprachmodell
8. Beispielprogramm anlegen
Das Programm zeigt die Grundbegriffe von LangGraph, ganz ohne KI:
- Zustand (
Zustand) – die Daten, die durch den Graphen wandern. Hier ein Text und die Anzahl seiner Wörter. - Knoten (
add_node) – einzelne Schritte, jeweils eine normale Python-Funktion. Sie bekommen den Zustand und geben die Felder zurück, die sie ändern. - Kanten (
add_edge) – feste Übergänge von einem Knoten zum nächsten.STARTundENDmarkieren Anfang und Ende. - Bedingte Kante (
add_conditional_edges) – eine Weiche, die anhand des Zustands entscheidet, welcher Knoten als Nächstes kommt.
nano graph_demo.py
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from typing import TypedDict
from langgraph.graph import StateGraph, START, END
# Der Zustand: Daten, die von Knoten zu Knoten weitergereicht werden
class Zustand(TypedDict):
text: str
woerter: int
# Knoten sind einfache Funktionen: Sie bekommen den Zustand und
# geben die Felder zurück, die sie ändern
def zaehlen(zustand: Zustand) -> dict:
return {"woerter": len(zustand["text"].split())}
def kurz(zustand: Zustand) -> dict:
return {"text": zustand["text"].upper()}
def lang(zustand: Zustand) -> dict:
return {"text": zustand["text"][:20] + " …"}
# Bedingte Kante: entscheidet anhand des Zustands, wohin es weitergeht
def weiche(zustand: Zustand) -> str:
return "kurz" if zustand["woerter"] <= 3 else "lang"
graph = StateGraph(Zustand)
graph.add_node("zaehlen", zaehlen)
graph.add_node("kurz", kurz)
graph.add_node("lang", lang)
graph.add_edge(START, "zaehlen")
graph.add_conditional_edges("zaehlen", weiche, ["kurz", "lang"])
graph.add_edge("kurz", END)
graph.add_edge("lang", END)
app = graph.compile()
print(app.invoke({"text": "Hallo LangGraph"}))
print(app.invoke({"text": "Dies ist ein etwas längerer Satz zum Testen"}))
print(app.get_graph().draw_mermaid())
9. Beispiel ausführen
Startet das Programm in der virtuellen Umgebung.
python graph_demo.py
Prüfen: Die ersten beiden Zeilen lauten:
{'text': 'HALLO LANGGRAPH', 'woerter': 2}
{'text': 'Dies ist ein etwas l …', 'woerter': 8}
Der kurze Text ging also über den Knoten kurz, der lange über lang. Darunter steht der Aufbau des Graphen als Mermaid-Diagramm. Du kannst es z. B. in mdBook oder MkDocs mit einer Mermaid-Erweiterung oder auf https://mermaid.live anzeigen lassen.
Beispiel 2: Ein Agent mit Claude
10. API-Schlüssel eingeben
Die Claude-Anbindung liest den Schlüssel aus der Umgebungsvariablen ANTHROPIC_API_KEY. read -rs fragt ihn ab, ohne ihn anzuzeigen. So landet er weder auf dem Bildschirm noch im Befehlsverlauf. Füge den Schlüssel ein und drücke Enter.
read -rsp "API-Schlüssel: " ANTHROPIC_API_KEY
11. API-Schlüssel für Programme freigeben
export macht die Variable für Programme sichtbar, die aus diesem Terminal gestartet werden. Sie gilt nur, bis das Terminal geschlossen wird.
export ANTHROPIC_API_KEY
Prüfen: Die Ausgabe ist eine Zahl über 0 (die Länge des Schlüssels), nicht der Schlüssel selbst.
echo ${#ANTHROPIC_API_KEY}
12. Agent-Programm anlegen
Ein Agent ist ein Sprachmodell, das selbst entscheidet, ob und wann es Werkzeuge aufruft. Das Programm verwendet:
tage_bis– ein Werkzeug: eine normale Python-Funktion. Aus Name, Parametern und Docstring erkennt das Modell, wofür es da ist.ChatAnthropic– die Anbindung an Claude Opus 5 (claude-opus-5).max_tokensbegrenzt die Länge einer Antwort.betasundfallbacksschalten eine Absicherung ein: Lehnen die Sicherheitsfilter von Anthropic eine Anfrage ab, beantwortet sie automatisch ein anderes passendes Claude-Modell.create_agent– baut aus Modell, Werkzeugen und Anweisung (system_prompt) einen fertigen Agenten. Intern ist das ein LangGraph-Graph mit Schleife: Modell fragen → Werkzeug ausführen → Modell erneut fragen, bis eine Antwort vorliegt.InMemorySaver– das Gedächtnis. Es speichert den Gesprächsverlauf pro Unterhaltung, erkennbar an derthread_id. Deshalb versteht der Agent bei der zweiten Frage, worauf sich „Und in Wochen?“ bezieht.
nano agent_demo.py
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from datetime import date
from langchain.agents import create_agent
from langchain_anthropic import ChatAnthropic
from langgraph.checkpoint.memory import InMemorySaver
# Ein Werkzeug (Tool): eine normale Python-Funktion. Der Docstring
# erklärt dem Modell, wofür das Werkzeug da ist.
def tage_bis(datum: str) -> str:
"""Berechnet, wie viele Tage es noch bis zu einem Datum (JJJJ-MM-TT) sind."""
ziel = date.fromisoformat(datum)
return f"Noch {(ziel - date.today()).days} Tage bis {datum}."
modell = ChatAnthropic(
model="claude-opus-5",
max_tokens=16000,
# Bei einer Ablehnung durch Sicherheitsfilter automatisch auf ein
# geeignetes anderes Claude-Modell ausweichen
betas=["server-side-fallback-2026-07-01"],
model_kwargs={"fallbacks": "default"},
)
agent = create_agent(
modell,
tools=[tage_bis],
system_prompt="Du bist ein hilfreicher Assistent. Antworte kurz und auf Deutsch.",
# Merkt sich den Gesprächsverlauf pro Unterhaltung (thread_id)
checkpointer=InMemorySaver(),
)
unterhaltung = {"configurable": {"thread_id": "test-1"}}
antwort = agent.invoke(
{"messages": [{"role": "user", "content": "Wie viele Tage sind es noch bis Silvester 2026?"}]},
unterhaltung,
)
print(antwort["messages"][-1].text)
antwort = agent.invoke(
{"messages": [{"role": "user", "content": "Und in Wochen?"}]},
unterhaltung,
)
print(antwort["messages"][-1].text)
13. Agent ausführen
Startet den Agenten. Er stellt zwei Anfragen an Claude, die erste davon mit einem Werkzeugaufruf. Das dauert einige Sekunden und kostet wenige Cent.
python agent_demo.py
Prüfen: Es erscheinen zwei deutsche Antworten: zuerst die Anzahl der Tage bis zum 31.12.2026 (vom Werkzeug berechnet), dann dieselbe Zeitspanne in Wochen. Der genaue Wortlaut ändert sich bei jedem Aufruf.
Erscheint stattdessen ein Fehler mit authentication_error, ist der Schlüssel falsch oder fehlt. Wiederhole dann die Schritte 10 und 11.
Wie geht es weiter?
- Eigene Graphen mit Modell: Ein Knoten kann auch
modell.invoke(...)aufrufen. So lassen sich feste Abläufe bauen, in denen das Modell nur an bestimmten Stellen gefragt wird, z. B. erst Text zusammenfassen, dann prüfen, dann übersetzen. - Dauerhaftes Gedächtnis:
InMemorySaververgisst alles, wenn das Programm endet. Das Paketlanggraph-checkpoint-postgresspeichert den Verlauf stattdessen in PostgreSQL. - Wissen aus eigenen Dokumenten (RAG): Mit Embeddings und einem Vektorspeicher wie pgvector findet der Agent passende Textstellen und bezieht sie in seine Antworten ein.
- Menschliche Freigabe: Mit
interrupt_beforehält der Agent vor bestimmten Schritten an und wartet auf eine Bestätigung.
Deinstallieren
1. Virtuelle Umgebung verlassen
Schaltet das Terminal zurück auf das Python des Systems. (.venv) verschwindet aus der Eingabeaufforderung.
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und allen darin installierten Paketen. Außerhalb dieses Ordners hat pip nichts installiert.
rm -rf ~/langgraph-test
3. Zwischenspeicher von pip leeren (optional)
pip hebt heruntergeladene Pakete in einem Zwischenspeicher auf, um spätere Installationen zu beschleunigen.
rm -rf ~/.cache/pip
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/langgraph-test
Hinweis: Den API-Schlüssel kannst du in der Anthropic Console jederzeit sperren oder löschen, wenn du ihn nicht mehr brauchst.
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.
Ollama
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ollama führt große Sprachmodelle (LLMs) direkt auf dem eigenen Rechner aus, ohne Cloud-Dienst, Konto oder Kosten pro Anfrage. Es lädt Modelle mit einem Befehl herunter und stellt sie über eine einfache HTTP-Schnittstelle bereit. Programme wie LlamaIndex können sie darüber nutzen. Neben Chat-Modellen gibt es Embedding-Modelle, die Texte in Vektoren für die Ähnlichkeitssuche umwandeln.
Vorbemerkungen
- Keine Installation über apt: Ubuntu hat kein Paket für Ollama. Der Snap im Snap Store stammt nicht vom Hersteller. Die Anleitung installiert deshalb das offizielle Archiv von GitHub von Hand. Das Projekt bietet auch ein Installationsskript an (
curl … | sh). Der Weg von Hand zeigt aber genau, was wohin kommt. - Version: Getestet mit Ollama 0.34.4 unter Ubuntu 26.04.
- Grafikkarte: Mit einer NVIDIA-Grafikkarte und installiertem Treiber rechnet Ollama auf der Grafikkarte und ist dann viel schneller. Getestet mit einer GeForce GTX 1660 mit 6 GB. Ob ein Treiber läuft, zeigt
nvidia-smi. Ohne Grafikkarte läuft Ollama auf dem Prozessor, nur langsamer. - Modelle: Die Anleitung verwendet zwei kleine Modelle, die zusammen gut in 6 GB Grafikspeicher passen:
qwen3:4b-instruct(2,5 GB) – ein Chat-Modell, das Deutsch versteht und Werkzeuge aufrufen kann.nomic-embed-text(274 MB) – ein Embedding-Modell, das Texte in Vektoren mit 768 Zahlen umwandelt.
- Kleine Modelle wissen wenig: Modelle dieser Größe formulieren gut, kennen aber nur wenige Fakten sicher. Im Test hat die „denkende“ Variante
qwen3:4bdie Hauptstadt von Schleswig-Holstein falsch beantwortet.qwen3:4b-instructlag richtig. Für Antworten zu eigenen Dokumenten kombiniert man solche Modelle deshalb mit einer Suche in diesen Dokumenten (RAG), siehe LlamaIndex. - Platz: Das Programm braucht etwa 4 GB, weil es Bibliotheken für verschiedene Grafikkarten mitbringt. Dazu kommen die Modelle.
- Port: Ollama läuft auf Port 11434 und ist nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. curl und zstd installieren
curl lädt das Archiv herunter. zstd packt es aus, denn Ollama verwendet das Kompressionsformat Zstandard (.tar.zst).
sudo apt install curl zstd
3. Programmarchiv herunterladen
Lädt Ollama 0.34.4 (etwa 1,4 GB) in den Ordner /tmp. Die aktuelle Version steht auf https://github.com/ollama/ollama/releases.
curl -L -o /tmp/ollama-linux-amd64.tar.zst https://github.com/ollama/ollama/releases/download/v0.34.4/ollama-linux-amd64.tar.zst
4. Prüfsumme kontrollieren
Der erste Befehl zeigt die Prüfsumme, die das Projekt für das Archiv veröffentlicht. Der zweite berechnet sie für die heruntergeladene Datei.
curl -sL https://github.com/ollama/ollama/releases/download/v0.34.4/sha256sum.txt | grep ollama-linux-amd64.tar.zst
sha256sum /tmp/ollama-linux-amd64.tar.zst
Prüfen: Beide Ausgaben beginnen mit derselben langen Zeichenfolge, bei Version 0.34.4 mit c238986e61d40c0cc5f4a9b9e40b9eea104350b77efa34741fc134e105cb9533.
5. Archiv auspacken
Das Archiv enthält die Ordner bin und lib. Ausgepackt nach /usr/local landet das Programm in /usr/local/bin/ollama und seine Bibliotheken in /usr/local/lib/ollama. Dort liegen selbst installierte Programme, getrennt von den Paketen aus apt.
sudo tar --zstd -xf /tmp/ollama-linux-amd64.tar.zst -C /usr/local
Prüfen: Die Ausgabe enthält die Versionsnummer 0.34.4. Die Warnung, dass keine Verbindung zum Server besteht, ist normal, denn der Dienst läuft noch nicht.
ollama --version
6. Systembenutzer anlegen
Ollama soll unter einem eigenen Benutzer laufen, mit dem man sich nicht anmelden kann. Die Modelle speichert Ollama in dessen Heimatordner, hier /usr/share/ollama/.ollama/models.
sudo useradd --system --create-home --home-dir /usr/share/ollama --shell /usr/sbin/nologin ollama
Als Dienst einrichten
7. systemd-Dienst anlegen
Damit Ollama beim Rechnerstart automatisch läuft, bekommt es eine Dienstdatei für systemd.
sudo nano /etc/systemd/system/ollama.service
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Ollama
After=network-online.target
[Service]
Type=simple
User=ollama
Group=ollama
ExecStart=/usr/local/bin/ollama serve
Environment=OLLAMA_HOST=127.0.0.1:11434
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
ExecStart=… serve– startet Ollama als Server, der auf Anfragen wartet.OLLAMA_HOST=127.0.0.1:11434– Ollama ist nur vom eigenen Rechner aus erreichbar. Ollama hat keine Anmeldung. Wäre es im Netzwerk erreichbar, könnte jeder dort die Modelle nutzen.Restart=alwaysundRestartSec=3– startet Ollama nach einem Absturz nach drei Sekunden neu.
8. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein.
sudo systemctl daemon-reload
9. Dienst starten und Autostart einschalten
enable sorgt für den Start beim Hochfahren, --now startet Ollama zusätzlich sofort.
sudo systemctl enable --now ollama
Prüfen: Die Antwort lautet Ollama is running.
curl -s http://localhost:11434/
10. Grafikkarte prüfen
Beim Start sucht Ollama nach Grafikkarten und schreibt das Ergebnis ins Protokoll.
sudo journalctl -u ollama | grep "inference compute"
Prüfen: Bei einer NVIDIA-Karte steht in der Zeile library=CUDA und der Name der Karte, z. B. NVIDIA GeForce GTX 1660. Steht dort library=cpu, rechnet Ollama auf dem Prozessor.
Modelle laden und nutzen
11. Chat-Modell herunterladen
Lädt qwen3:4b-instruct aus der Modellbibliothek von Ollama (https://ollama.com/library). Der Teil hinter dem Doppelpunkt heißt Tag und wählt Größe und Variante.
ollama pull qwen3:4b-instruct
12. Embedding-Modell herunterladen
Lädt nomic-embed-text. Embedding-Modelle antworten nicht mit Text, sondern mit einer Liste von Zahlen, die die Bedeutung eines Textes beschreibt.
ollama pull nomic-embed-text
Prüfen: Beide Modelle erscheinen in der Liste.
ollama list
13. Mit dem Modell sprechen
Stellt dem Modell eine Frage und gibt die Antwort aus. Beim ersten Aufruf lädt Ollama das Modell in den Grafikspeicher. Das kann eine Weile dauern, danach geht es schnell.
ollama run qwen3:4b-instruct "Wie heißt die Landeshauptstadt von Schleswig-Holstein? Antworte mit einem Wort."
Prüfen: Die Antwort lautet Kiel. Ohne Frage am Ende startet ollama run qwen3:4b-instruct ein Gespräch im Terminal, das du mit /bye beendest.
14. Wo läuft das Modell?
Zeigt die geladenen Modelle und ob sie auf der Grafikkarte (GPU) oder dem Prozessor (CPU) laufen. Ollama entlädt ein Modell nach fünf Minuten ohne Anfrage wieder.
ollama ps
Prüfen: In der Spalte PROCESSOR steht bei einer passenden Grafikkarte 100% GPU.
15. Die HTTP-Schnittstelle nutzen
Programme sprechen Ollama über HTTP an. Dieser Aufruf wandelt einen Satz in einen Vektor um und zählt, wie viele Zahlen er enthält.
curl -s http://localhost:11434/api/embed -d '{"model":"nomic-embed-text","input":"Ahrensburg liegt in Schleswig-Holstein."}' | python3 -c 'import json,sys; print(len(json.load(sys.stdin)["embeddings"][0]))'
Ollama antwortet im Format JSON. Das kleine Python-Programm am Ende liest die Antwort und gibt nur die Länge des Vektors aus.
Prüfen: Die Ausgabe lautet 768. Chat-Anfragen gehen entsprechend an /api/chat. Zusätzlich bietet Ollama unter /v1 eine Schnittstelle im Format von OpenAI an, die viele Programme direkt verstehen.
Wo liegt was?
/usr/local/bin/ollama– das Programm./usr/local/lib/ollama– Bibliotheken für Prozessor und Grafikkarten./usr/share/ollama/.ollama/models– die heruntergeladenen Modelle.
Nicht mehr gebrauchte Modelle löschst du mit ollama rm NAME, z. B. ollama rm qwen3:4b-instruct.
Aktualisieren
1. Neue Version herunterladen
Lädt die neue Version. Ersetze v0.34.4 durch die aktuelle Versionsnummer und kontrolliere die Prüfsumme wie in Schritt 4.
curl -L -o /tmp/ollama-linux-amd64.tar.zst https://github.com/ollama/ollama/releases/download/v0.34.4/ollama-linux-amd64.tar.zst
2. Dienst stoppen
Ollama darf beim Austausch der Dateien nicht laufen.
sudo systemctl stop ollama
3. Alte Bibliotheken löschen
Die neue Version bringt eigene Bibliotheken mit. Alte Dateien könnten sonst stören. Die Modelle bleiben unberührt.
sudo rm -rf /usr/local/lib/ollama
4. Neue Version auspacken
Wie in Schritt 5 der Installation.
sudo tar --zstd -xf /tmp/ollama-linux-amd64.tar.zst -C /usr/local
5. Dienst starten
Startet die neue Version.
sudo systemctl start ollama
Prüfen: ollama --version zeigt die neue Versionsnummer, ohne Warnung.
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Ollama und verhindert den Start beim Hochfahren.
sudo systemctl disable --now ollama
2. Dienstdatei löschen
Entfernt die Dienstdatei aus Schritt 7.
sudo rm /etc/systemd/system/ollama.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Programm, Bibliotheken und Archiv löschen
Entfernt alles, was in Schritt 5 ausgepackt wurde, und das heruntergeladene Archiv.
sudo rm -rf /usr/local/bin/ollama /usr/local/lib/ollama /tmp/ollama-linux-amd64.tar.zst
5. Benutzer und Modelle löschen
-r löscht mit dem Benutzer auch seinen Ordner /usr/share/ollama samt allen heruntergeladenen Modellen. Die Warnung Mail-Warteschlange … nicht gefunden ist harmlos.
sudo userdel -r ollama
Prüfen: Der Befehl ollama wird nicht mehr gefunden, und unter Port 11434 antwortet nichts mehr.
curl -s http://localhost:11434/
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/ollama/ollama
- Lizenz: Ollama steht unter der MIT.
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.
llama.cpp
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
llama.cpp führt Sprachmodelle im GGUF-Format direkt auf dem eigenen Rechner aus, auf dem Prozessor oder auf der Grafikkarte. Es bringt einen Chat im Terminal mit und einen Server mit einer Schnittstelle wie bei OpenAI und einer einfachen Chat-Seite im Browser. Viele bekannte Programme bauen intern darauf auf, darunter Ollama.
Vorbemerkungen
- Unterschied zu Ollama: Ollama verwaltet Modelle selbst und lädt sie nur bei Bedarf. llama.cpp ist schlanker und lässt sich genauer einstellen. Modelle lädt es direkt von Hugging Face, wo es zu fast jedem offenen Modell GGUF-Dateien in mehreren Stufen gibt.
- Aus den Ubuntu-Paketquellen: Ubuntu 26.04 liefert llama.cpp als Paket mit, samt systemd-Dienst für den Server.
- Grafikkarte über Vulkan: Eine Fassung für NVIDIAs CUDA gibt es in den Paketquellen nicht. Das Zusatzpaket für Vulkan nutzt aber Grafikkarten von NVIDIA, AMD und Intel. Bei NVIDIA muss dafür der proprietäre Treiber installiert sein. Ohne passende Grafikkarte rechnet llama.cpp auf dem Prozessor, nur langsamer.
- Modell: Die Anleitung verwendet Qwen3-4B-Instruct in der Stufe
Q4_K_M(2,4 GB) aus dem Hugging-Face-Kontounsloth. Es ist dasselbe Modell, das in Ollamaqwen3:4b-instructheißt. Es steht unter der freien Lizenz Apache 2.0. - Speicher der Grafikkarte: Der Server hält das Modell dauerhaft im Grafikspeicher, im Test knapp 5 GB auf einer GeForce GTX 1660 mit 6 GB. Laufen gleichzeitig Modelle in Ollama, reicht der Speicher nicht für beide, und eines davon wird langsamer.
- Port: Der Server lauscht normalerweise auf Port 8080. Diesen Port belegen oft schon andere Dienste, z. B. Apache aus der Anleitung Tileserver. Die Anleitung verwendet deshalb Port 8082.
- Version: Getestet mit llama.cpp 8681 aus Ubuntu 26.04 auf einer GeForce GTX 1660.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. llama.cpp mit Vulkan-Unterstützung installieren
llama.cpp– die Programmellama-cli,llama-server,llama-benchund weiterelibggml0-backend-vulkan– das Zusatzpaket, mit dem llama.cpp auf der Grafikkarte rechnet. Ohne geeignete Grafikkarte kann es entfallen.
sudo apt install llama.cpp libggml0-backend-vulkan
Prüfen: Die letzte Zeile beginnt mit version: 8681.
llama-cli --version
3. Grafikkarte prüfen
Zeigt, welche Geräte llama.cpp zum Rechnen findet.
llama-server --list-devices
Prüfen: Unter Available devices steht die Grafikkarte, z. B. Vulkan0: NVIDIA GeForce GTX 1660 (6390 MiB, 5725 MiB free). Ist die Liste leer, rechnet llama.cpp auf dem Prozessor.
Erster Test im Terminal
4. Eine Frage stellen
-hf lädt das Modell von Hugging Face. Hinter dem Doppelpunkt steht die Stufe. Beim ersten Mal dauert das wegen des Downloads einige Minuten. Die Datei landet in ~/.cache/huggingface und wird danach wiederverwendet. -p gibt die Frage vor, -st beendet das Programm nach der ersten Antwort.
llama-cli -hf unsloth/Qwen3-4B-Instruct-2507-GGUF:Q4_K_M -p "Wie heißt die Landeshauptstadt von Schleswig-Holstein? Antworte mit einem Wort." -st
Prüfen: Unter der Frage steht Kiel. Darunter zeigt llama.cpp die Geschwindigkeit, im Test etwa Generation: 17 t/s (Wortteile pro Sekunde).
5. Im Terminal chatten
Ohne -p und -st startet ein Gespräch. Gib nach dem Zeichen > eine Frage ein und drücke Enter. Mit /exit oder Strg+C beendest du das Gespräch.
llama-cli -hf unsloth/Qwen3-4B-Instruct-2507-GGUF:Q4_K_M
Server als Dienst
Der Server stellt das Modell anderen Programmen zur Verfügung. Das Paket bringt dafür einen systemd-Dienst mit, der unter dem eigenen Systembenutzer _llama-server läuft. Er ist nach der Installation noch ausgeschaltet.
6. Einstellungen des Dienstes öffnen
Der Dienst liest seine Einstellungen aus dieser Datei. Sie enthält bisher nur auskommentierte Beispiele.
sudo nano /etc/default/llama-server
7. Modell und Port eintragen
Füge am Ende der Datei diese zwei Zeilen ein:
LLAMA_ARG_HF_REPO=unsloth/Qwen3-4B-Instruct-2507-GGUF:Q4_K_M
LLAMA_ARG_PORT=8082
LLAMA_ARG_HF_REPO– das Modell, das der Dienst beim Start lädt. Der Dienst lädt es in seinen eigenen Ordner/var/cache/llama-server. Die Datei aus Schritt 4 im Home-Ordner kann er nicht lesen, deshalb wird das Modell noch einmal heruntergeladen.LLAMA_ARG_PORT– der Port, hier 8082 statt 8080.- Ohne weitere Angabe ist der Server nur vom eigenen Rechner aus erreichbar (
127.0.0.1).
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Dienst starten und dauerhaft einschalten
enable startet den Server künftig bei jedem Hochfahren, --now startet ihn sofort.
sudo systemctl enable --now llama-server
9. Auf das Laden des Modells warten
Beim ersten Start lädt der Dienst das Modell herunter. Danach braucht er für den Start nur noch Sekunden. Der Befehl zeigt die Meldungen des Dienstes laufend an. Beende ihn mit Strg+C, sobald server is listening on http://127.0.0.1:8082 erscheint.
journalctl -u llama-server -f
Prüfen: Die Antwort lautet {"status":"ok"}.
curl http://127.0.0.1:8082/health
10. Schnittstelle testen
Schickt eine Frage im Format der Schnittstelle von OpenAI an den Server. Programme und Bibliotheken, die OpenAI ansprechen, können llama.cpp genauso verwenden.
curl -s http://127.0.0.1:8082/v1/chat/completions -H "Content-Type: application/json" -d '{"messages":[{"role":"user","content":"Nenne drei Städte in Schleswig-Holstein, nur die Namen mit Komma getrennt."}]}'
Prüfen: Die Antwort ist ein JSON-Text. Hinter "content" stehen die Städte. Im Test kamen Kiel, Lübeck, Schwerin heraus. Schwerin liegt allerdings in Mecklenburg-Vorpommern: Ein kleines Modell formuliert flüssig, kennt Fakten aber nicht zuverlässig. Unter "timings" steht die Geschwindigkeit, im Test rund 34 Wortteile pro Sekunde.
11. Chat-Seite im Browser öffnen
Öffne im Browser diese Adresse:
http://localhost:8082
Es erscheint eine schlichte Chat-Seite, über die du direkt mit dem Modell schreiben kannst. Ubuntu liefert sie statt der Oberfläche, die das llama.cpp-Projekt selbst mitbringt.
Wie geht es weiter?
- Mit Open WebUI verbinden: In Open WebUI trägt man im Admin-Bereich bei den Verbindungen eine OpenAI-Verbindung mit der Adresse
http://127.0.0.1:8082/v1ein. Dann erscheint das Modell neben denen von Ollama. - Weitere Einstellungen:
llama-server --helplistet alle Optionen. Jede lässt sich alsLLAMA_ARG_…in/etc/default/llama-serversetzen, z. B.LLAMA_ARG_CTX_SIZEfür die Länge des Gesprächs, die das Modell im Blick behält. - Zugriff schützen: Mit
LLAMA_API_KEY=…in derselben Datei verlangt der Server einen Schlüssel. Für den Zugriff aus dem Netz schaltet man nginx mit HTTPS davor. - Geschwindigkeit messen:
llama-bench -hf …misst, wie schnell ein Modell auf dem Rechner läuft. - Dokumentation: https://github.com/ggml-org/llama.cpp
Deinstallieren
1. Dienst beenden und ausschalten
sudo systemctl disable --now llama-server
2. Pakete entfernen
purge löscht auch die Datei /etc/default/llama-server.
sudo apt purge llama.cpp llama.cpp-tools llama.cpp-tools-extra libggml0-backend-vulkan
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt Pakete, die nur für llama.cpp mitinstalliert wurden, z. B. libllama0, libggml0 und python3-gguf. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
4. Modell und Daten des Dienstes löschen
Diese Ordner bleiben beim Entfernen der Pakete erhalten.
sudo rm -rf /var/cache/llama-server /var/lib/llama-server
5. Systembenutzer entfernen
Entfernt den Benutzer _llama-server, unter dem der Dienst lief.
sudo deluser --system _llama-server
6. Modell im Home-Ordner löschen
Löscht das Modell aus Schritt 4 der Installation. Andere Modelle von Hugging Face bleiben erhalten.
rm -rf ~/.cache/huggingface/hub/models--unsloth--Qwen3-4B-Instruct-2507-GGUF
Prüfen: Der Befehl llama-cli wird nicht mehr gefunden.
llama-cli --version
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/ggerganov/llama.cpp
- Lizenz: llama.cpp steht unter der MIT.
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.
LiteLLM
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
LiteLLM bündelt viele Anbieter von Sprachmodellen hinter einer einheitlichen Schnittstelle im Format von OpenAI. Als Python-Bibliothek ruft man damit Ollama, OpenAI, Anthropic und rund hundert weitere Dienste mit demselben Befehl auf. Als Proxy-Server steht LiteLLM zwischen den eigenen Programmen und den Modellen, verteilt Anfragen, springt bei Ausfällen auf ein anderes Modell um und verlangt einen Schlüssel.
Vorbemerkungen
- Wofür ein Proxy? Programme müssen dann nur eine Adresse und einen Schlüssel kennen. Welches Modell dahinter antwortet, ob Ollama, llama.cpp oder ein Cloud-Anbieter, legt eine Konfigurationsdatei fest. Ändert man sie, merken die Programme davon nichts.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Die Anleitung bindet zusätzlich llama.cpp auf Port 8082 ein. Läuft es nicht, zeigt das Beispiel, wie LiteLLM auf Ollama ausweicht. - Ohne Datenbank: Der Proxy kann Benutzer, eigene Schlüssel und Kosten in einer PostgreSQL-Datenbank verwalten und bietet dann auch eine Weboberfläche. Diese Anleitung kommt ohne Datenbank aus und schützt den Proxy mit einem einzigen Hauptschlüssel.
- Preisliste: Beim Start lädt LiteLLM normalerweise eine aktuelle Preisliste der Cloud-Anbieter von GitHub. Für lokale Modelle ist sie unnötig. Die Anleitung schaltet das mit
LITELLM_LOCAL_MODEL_COST_MAP=Trueab, LiteLLM verwendet dann die mitgelieferte Liste. - Port: Der Proxy lauscht auf Port 4000 und nur für den eigenen Rechner.
- Installation über pip: LiteLLM ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 700 MB. - Version: Getestet mit litellm 1.103.2 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
Hier liegen das Programm und seine Konfiguration.
mkdir ~/litellm
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/litellm
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. LiteLLM installieren
litellm[proxy]– die Bibliothek samt Proxy-Server und Befehllitellmprisma– eigentlich für die Datenbank gedacht. Ohne dieses Paket beantwortet der Proxy Anfragen ohne Schlüssel mit einem internen Fehler statt mit einer klaren Ablehnung.
pip install "litellm[proxy]" prisma
Prüfen: Die Ausgabe nennt Version: 1.103.2 oder eine neuere Version.
pip show litellm
Beispiel 1: LiteLLM als Bibliothek
8. Programm anlegen
Das Programm stellt eine Frage an Ollama. Für einen anderen Anbieter ändert man nur die Angabe model, der Rest bleibt gleich.
nano erste.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import os
# Mitgelieferte Preisliste verwenden statt sie von GitHub zu laden
os.environ["LITELLM_LOCAL_MODEL_COST_MAP"] = "True"
from litellm import completion
antwort = completion(
model="ollama_chat/qwen3:4b-instruct",
api_base="http://localhost:11434",
messages=[
{"role": "user", "content": "Wie heißt die Landeshauptstadt von Schleswig-Holstein? Antworte mit einem Wort."}
],
)
print(antwort.choices[0].message.content)
print(antwort.usage)
model– vor dem Schrägstrich steht der Anbieter, dahinter das Modell.ollama_chat/spricht die Chat-Schnittstelle von Ollama an. Für einen Cloud-Anbieter stünde dort z. B.anthropic/…, und der Schlüssel käme aus einer Umgebungsvariablen.- Antwort – hat bei jedem Anbieter denselben Aufbau wie bei OpenAI.
usagezählt die verbrauchten Wortteile (Token).
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python erste.py
Prüfen: Die Ausgabe lautet Kiel, darunter eine Zeile, die mit Usage(completion_tokens= beginnt.
Beispiel 2: Der Proxy-Server
10. Hauptschlüssel erzeugen
Erzeugt einen zufälligen Schlüssel, der mit sk- beginnt. Mit ihm melden sich später alle Programme beim Proxy an. Kopiere die Ausgabe für den nächsten Schritt.
echo "sk-$(openssl rand -hex 16)"
11. Konfiguration anlegen
nano config.yaml
Füge diesen Inhalt ein und ersetze sk-HIER-DEIN-SCHLUESSEL durch den Schlüssel aus Schritt 10:
model_list:
- model_name: lokal
litellm_params:
model: ollama_chat/qwen3:4b-instruct
api_base: http://localhost:11434
- model_name: llamacpp
litellm_params:
model: openai/qwen3-4b
api_base: http://localhost:8082/v1
api_key: kein-schluessel
router_settings:
fallbacks:
- llamacpp: ["lokal"]
general_settings:
master_key: sk-HIER-DEIN-SCHLUESSEL
model_list– die Modelle, die der Proxy anbietet.model_nameist der Name, unter dem Programme das Modell anfragen.litellm_paramssagt, wohin die Anfrage wirklich geht.lokal– leitet an Ollama weiter.llamacpp– leitet an den Server aus der Anleitung llama.cpp weiter.openai/bedeutet: ein Dienst mit der Schnittstelle von OpenAI. Der Modellname dahinter ist bei llama.cpp beliebig, weil der Server nur ein Modell hat.api_keymuss gesetzt sein, llama.cpp prüft ihn aber nicht.fallbacks– antwortetllamacppnicht, übernimmtlokaldie Anfrage.master_key– nur Anfragen mit diesem Schlüssel werden angenommen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Proxy als Benutzerdienst einrichten
Der Proxy soll im Hintergrund laufen und bei jeder Anmeldung starten. Dafür bekommt er einen systemd-Dienst des eigenen Benutzers. -p legt den Ordner an, falls es ihn noch nicht gibt.
mkdir -p ~/.config/systemd/user
13. Dienstdatei anlegen
nano ~/.config/systemd/user/litellm.service
Füge diesen Inhalt ein:
[Unit]
Description=LiteLLM Proxy
After=network-online.target
[Service]
WorkingDirectory=%h/litellm
Environment=LITELLM_LOCAL_MODEL_COST_MAP=True
ExecStart=%h/litellm/.venv/bin/litellm --config %h/litellm/config.yaml --host 127.0.0.1 --port 4000
Restart=on-failure
[Install]
WantedBy=default.target
%h– setzt systemd durch den Home-Ordner ersetzt, z. B./home/thorsten.--host 127.0.0.1 --port 4000– nur der eigene Rechner erreicht den Proxy, und zwar auf Port 4000.Restart=on-failure– startet den Proxy nach einem Absturz neu.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. systemd die neue Datei bekannt machen
--user steht für die Dienste des eigenen Benutzers, deshalb ohne sudo.
systemctl --user daemon-reload
15. Dienst starten und dauerhaft einschalten
systemctl --user enable --now litellm
Prüfen: Nach einigen Sekunden lautet die Antwort "I'm alive!".
curl http://127.0.0.1:4000/health/liveliness
16. Schlüssel in einer Variablen ablegen
Damit du den Schlüssel in den nächsten Befehlen nicht jedes Mal einfügen musst. Ersetze sk-HIER-DEIN-SCHLUESSEL wieder durch deinen Schlüssel. Die Variable gilt nur in diesem Terminal.
export LITELLM_KEY=sk-HIER-DEIN-SCHLUESSEL
17. Erreichbarkeit der Modelle prüfen
Der Proxy schickt an jedes Modell eine kurze Testanfrage.
curl -s http://127.0.0.1:4000/health -H "Authorization: Bearer $LITELLM_KEY"
Prüfen: "healthy_count":1 zählt die erreichbaren Modelle, "unhealthy_count":1 die nicht erreichbaren. Läuft llama.cpp nicht, steht es bei den nicht erreichbaren. Läuft es, stehen beide Modelle bei den erreichbaren.
18. Ohne Schlüssel anfragen
Prüft, dass der Proxy Anfragen ohne Schlüssel ablehnt.
curl -s http://127.0.0.1:4000/v1/models
Prüfen: Die Antwort enthält Authentication Error, No api key passed in. und "code":"401".
Beispiel 3: Programme mit dem Proxy verbinden
19. Programm anlegen
Das Programm verwendet das offizielle Paket openai, das mit LiteLLM schon installiert wurde. Es weiß nicht, dass dahinter Ollama und llama.cpp stehen. So lassen sich alle Programme und Bibliotheken anbinden, die eine Adresse für OpenAI-kompatible Dienste erlauben.
nano frage.py
Füge diesen Inhalt ein:
import os
from openai import OpenAI
client = OpenAI(base_url="http://127.0.0.1:4000", api_key=os.environ["LITELLM_KEY"])
for modell in ["lokal", "llamacpp"]:
antwort = client.chat.completions.create(
model=modell,
messages=[
{"role": "user", "content": "Wie heißt die Landeshauptstadt von Schleswig-Holstein? Antworte mit einem Wort."}
],
)
print(f"{modell:9} -> {antwort.choices[0].message.content} (beantwortet von: {antwort.model})")
base_url– zeigt auf den Proxy statt auf OpenAI.api_key– der Hauptschlüssel aus der Variablen von Schritt 16.antwort.model– verrät, welches Modell tatsächlich geantwortet hat.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
20. Programm ausführen
Im selben Terminal wie Schritt 16, damit die Variable gesetzt ist.
python frage.py
Prüfen: Läuft llama.cpp nicht, lautet die Ausgabe:
lokal -> Kiel (beantwortet von: lokal)
llamacpp -> Kiel (beantwortet von: ollama_chat/qwen3:4b-instruct)
Die Anfrage an llamacpp ist gescheitert, und LiteLLM hat sie an Ollama weitergereicht. Das Programm hat trotzdem eine Antwort bekommen.
Wie geht es weiter?
- Cloud-Anbieter: Ein Eintrag wie
model: anthropic/…mitapi_key: os.environ/ANTHROPIC_API_KEYholt den Schlüssel aus einer Umgebungsvariablen statt ihn in die Datei zu schreiben. Die Variable trägt man dann mitEnvironment=in die Dienstdatei ein. - Lastverteilung: Mehrere Einträge mit demselben
model_nameverteilt LiteLLM abwechselnd. So teilen sich etwa zwei Rechner mit Ollama die Arbeit. - Eigene Schlüssel und Kosten: Mit einer PostgreSQL-Datenbank (
database_urluntergeneral_settings) vergibt der Proxy eigene Schlüssel mit Budget pro Benutzer und bietet eine Weboberfläche unter/ui. - Andere Programme anbinden: Open WebUI und Frameworks wie das OpenAI Agents SDK sprechen den Proxy über eine OpenAI-Verbindung mit der Adresse
http://127.0.0.1:4000an. - Dokumentation: https://docs.litellm.ai
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Dienst beenden und ausschalten
systemctl --user disable --now litellm
3. Dienstdatei löschen
rm ~/.config/systemd/user/litellm.service
4. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
systemctl --user daemon-reload
5. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und Konfiguration.
rm -rf ~/litellm
6. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/BerriAI/litellm
- Lizenz: LiteLLM steht unter der MIT.
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.
whisper.cpp
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
whisper.cpp wandelt gesprochene Sprache in Text um, vollständig auf dem eigenen Rechner. Es verwendet die Whisper-Modelle von OpenAI, versteht rund 100 Sprachen, darunter Deutsch, und schreibt auf Wunsch Untertitel mit Zeitangaben. Gedacht ist es etwa für Interviews, Sprachnotizen, Vorträge oder Videos.
Vorbemerkungen
- Aus den Ubuntu-Paketquellen: Ubuntu 26.04 liefert whisper.cpp als Paket mit. Es nutzt dieselbe Rechenbibliothek ggml wie llama.cpp.
- Grafikkarte über Vulkan: Wie bei llama.cpp gibt es keine Fassung für CUDA, aber ein Zusatzpaket für Vulkan. Es nutzt Grafikkarten von NVIDIA, AMD und Intel. Ohne geeignete Grafikkarte rechnet whisper.cpp auf dem Prozessor, nur langsamer.
- Modelle: Die Modelle gehören nicht zum Paket. Sie liegen als Dateien bei Hugging Face und stehen wie Whisper selbst unter der MIT-Lizenz. Die Anleitung verwendet
large-v3-turboin einer verkleinerten Fassung (q5_0, 550 MB). Es erkennt Deutsch sehr zuverlässig. Zum Vergleich gibt es das kleine Modellbase(150 MB). - Audioformate: whisper.cpp liest WAV-, MP3- und Ogg-Dateien direkt (im Test geprüft). Für Videos oder andere Formate braucht man zusätzlich
ffmpeg. - Port: Der mitgelieferte Server lauscht normalerweise auf Port 8080. Diesen Port belegen oft schon andere Dienste, z. B. Apache aus der Anleitung Tileserver. Die Anleitung verwendet deshalb Port 8083.
- Version: Getestet mit whisper.cpp 1.8.3 aus Ubuntu 26.04 auf einer GeForce GTX 1660.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. whisper.cpp mit Vulkan-Unterstützung installieren
whisper.cpp– die Programmewhisper-cli,whisper-server,whisper-streamund weiterelibggml0-backend-vulkan– das Zusatzpaket, mit dem whisper.cpp auf der Grafikkarte rechnet. Ohne geeignete Grafikkarte kann es entfallen. Ist llama.cpp schon installiert, ist es meist schon vorhanden.
sudo apt install whisper.cpp libggml0-backend-vulkan
Prüfen: Die Hilfe von whisper-cli erscheint und beginnt mit usage: whisper-cli [options] file0 file1 ....
whisper-cli --help
3. Ordner für Modelle und Aufnahmen anlegen
mkdir ~/whisper
4. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/whisper
5. Großes Modell herunterladen
Lädt large-v3-turbo in der Fassung q5_0 aus dem Hugging-Face-Konto des whisper.cpp-Projekts. -L folgt der Weiterleitung zum eigentlichen Speicherort, -o legt den Dateinamen fest.
curl -L -o ggml-large-v3-turbo-q5_0.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin
6. Kleines Modell herunterladen
Das Modell base dient zum Vergleich. Wer nur das große Modell nutzen will, kann diesen Schritt überspringen.
curl -L -o ggml-base.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin
Prüfen: Die Liste zeigt beide Dateien mit den Größen 548M und 142M.
ls -lh
Erste Schritte
7. Englisches Beispiel erkennen
Das Paket bringt zwei kurze Aufnahmen aus der gesprochenen Wikipedia mit. -m wählt das Modell, -f die Audiodatei.
whisper-cli -m ggml-base.bin -f /usr/share/sounds/debian/samples/en-Wikipedia-Ignore_All_Rules.wav
Prüfen: Unter vielen technischen Meldungen stehen Zeilen mit Zeitangaben und Text, die erste lautet [00:00:00.000 --> 00:00:09.240] Wikipedia, Ignore all rules …. Weiter oben steht using Vulkan0 backend, wenn whisper.cpp die Grafikkarte verwendet.
8. Deutsche Aufnahme herunterladen
Ein gesprochener Wikipedia-Artikel über das Radio, 2 Minuten 39 Sekunden lang. Die Aufnahme liegt auf Wikimedia Commons unter der Lizenz CC BY-SA 3.0, gesprochen von Benutzer HendrixXx.
curl -L -o radio.ogg https://upload.wikimedia.org/wikipedia/commons/a/a1/De-Radio-article.ogg
9. Deutsche Aufnahme in Text umwandeln
-l de legt die Sprache fest. Ohne diese Angabe nimmt whisper.cpp Englisch an. -l auto erkennt die Sprache selbst. -otxt speichert den Text zusätzlich in einer Datei, -of legt ihren Namen ohne Endung fest.
whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l de -f radio.ogg -otxt -of radio
Prüfen: Die Zeilen beginnen mit Radio aus Wikipedia, der freien Enzyklopädie. Im Test war der ganze Text bis auf Kleinigkeiten fehlerfrei, sogar mit Satzzeichen. Für die 2:39 Minuten brauchte die GTX 1660 knapp 10 Sekunden. Den Text gibt es jetzt auch als Datei:
cat radio.txt
10. Mit dem kleinen Modell vergleichen
whisper-cli -m ggml-base.bin -l de -f radio.ogg -otxt -of radio-base
Prüfen: Das kleine Modell ist nur wenig schneller, macht aber deutlich mehr Fehler. Im Test hat es „lateinisch Radius, der Strahl“ als „Lateinisch-Radius der Strahl“ geschrieben und eine Internetadresse als „Schrägstrich.wiki.schrägstrich“. Mit Grafikkarte lohnt sich deshalb das große Modell.
11. Untertitel erzeugen
-osrt schreibt eine Untertiteldatei im Format SRT, die Videoprogramme wie VLC zusammen mit dem Video anzeigen. -ovtt erzeugt das Format WebVTT für Webseiten.
whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l de -f radio.ogg -osrt -of radio
Prüfen: Die Datei radio.srt enthält nummerierte Abschnitte mit Zeitangaben wie 00:00:00,000 --> 00:00:03,880.
head radio.srt
Eigene Sprache aufnehmen
12. Zehn Sekunden aufnehmen
arecord gehört bei Ubuntu zur Grundausstattung. Der Befehl nimmt zehn Sekunden über das Standardmikrofon auf, gleich in dem Format, das Whisper intern verwendet: 16 000 Messwerte pro Sekunde, ein Kanal. Sprich nach dem Start einen beliebigen Satz.
arecord -f S16_LE -r 16000 -c 1 -d 10 aufnahme.wav
13. Aufnahme erkennen
whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l de -f aufnahme.wav
Prüfen: Dein Satz erscheint als Text. Steht dort ein Satz, den du nicht gesagt hast, etwa Untertitelung des ZDF, 2020, war die Aufnahme leer oder zu leise. Genau diesen Satz hat Whisper im Test bei einer stillen Datei erfunden, weil es unter anderem mit Untertiteln aus dem Fernsehen trainiert wurde. Wähle dann in den Einstellungen von Ubuntu das richtige Mikrofon als Eingabegerät.
Whisper als Server
whisper-server hält ein Modell im Speicher und nimmt Audiodateien über das Netz entgegen. So können andere Programme Sprache erkennen lassen, ohne das Modell jedes Mal neu zu laden.
14. Server starten
Der Server läuft im Vordergrund, das Terminal bleibt also belegt. --host 127.0.0.1 lässt nur Zugriffe vom eigenen Rechner zu.
whisper-server -m ggml-large-v3-turbo-q5_0.bin -l de --host 127.0.0.1 --port 8083
Prüfen: Die letzte Zeile lautet whisper server listening at http://127.0.0.1:8083.
15. Zweites Terminal öffnen
Öffne ein neues Terminal mit Strg+Alt+T und wechsle dort in den Ordner:
cd ~/whisper
16. Datei an den Server schicken
-F schickt die Datei wie ein Formular im Browser. response_format=text verlangt reinen Text. Andere Werte sind json, srt und vtt.
curl http://127.0.0.1:8083/inference -F file=@radio.ogg -F response_format=text
Prüfen: Nach gut zehn Sekunden erscheint derselbe Text wie in Schritt 9.
17. Server beenden
Wechsle in das erste Terminal und drücke dort Strg+C.
Wie geht es weiter?
- Live mitschreiben:
whisper-stream -m ggml-large-v3-turbo-q5_0.bin -l dehört dauerhaft am Mikrofon zu und schreibt alle paar Sekunden den erkannten Text. Beenden mit Strg+C. - Ins Englische übersetzen:
-trerkennt die Sprache und gibt gleich eine englische Übersetzung aus. In andere Sprachen übersetzt Whisper nicht. - Videos: Mit
sudo apt install ffmpeglässt sich die Tonspur eines Videos in eine WAV-Datei umwandeln, etwaffmpeg -i video.mp4 -ar 16000 -ac 1 ton.wav. - Weitere Modelle: Unter https://huggingface.co/ggerganov/whisper.cpp liegen alle Größen von
tinybislarge-v3. Modelle mit.enim Namen verstehen nur Englisch. - Dokumentation: https://github.com/ggml-org/whisper.cpp
Deinstallieren
1. Pakete entfernen
sudo apt purge whisper.cpp libggml0-backend-vulkan
Wird libggml0-backend-vulkan noch von llama.cpp gebraucht, lass es im Befehl weg.
2. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt Pakete, die nur für whisper.cpp mitinstalliert wurden, z. B. libwhisper1 und libggml0. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
3. Modelle und Aufnahmen löschen
Löscht den Ordner mit den Modellen, Aufnahmen und erzeugten Texten.
rm -rf ~/whisper
Prüfen: Der Befehl whisper-cli wird nicht mehr gefunden.
whisper-cli --help
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/ggerganov/whisper.cpp
- Lizenz: whisper.cpp steht unter der MIT.
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.
Piper
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Piper ist eine Sprachausgabe, die Text auf dem eigenen Rechner in natürlich klingende Sprache umwandelt. Es ist schnell genug für den Prozessor, braucht keine Grafikkarte und bringt Stimmen für viele Sprachen mit, darunter mehrere deutsche. Typische Einsätze sind Sprachassistenten, Vorlesen von Texten und Ansagen.
Vorbemerkungen
- Gegenstück zu whisper.cpp: whisper.cpp macht aus Sprache Text, Piper macht aus Text Sprache. Zusammen mit einem Sprachmodell aus Ollama ergeben sie einen Sprachassistenten, der vollständig lokal läuft.
- Nicht das Ubuntu-Paket
piper: In den Ubuntu-Paketquellen gibt es ein Paketpiper. Das ist aber ein anderes Programm, mit dem man Gaming-Mäuse einstellt. Die Sprachausgabe Piper heißt bei pippiper-ttsund wird in eine virtuelle Umgebung installiert, rund 200 MB. - Stimme: Die Anleitung verwendet die deutsche Stimme
de_DE-thorsten-high(114 MB). Sie beruht auf den Aufnahmen des Projekts Thorsten-Voice, die unter der freien Lizenz CC0 stehen. Weitere deutsche Stimmen sindkerstin,ramona,eva_kundkarlsson, meist in geringerer Qualität. - Lizenz von Piper: Piper selbst steht unter der GPL 3. Für eigene Programme, die Piper einbinden und weitergegeben werden, ist das zu beachten.
- Version: Getestet mit piper-tts 1.8.0 unter Python 3.14 aus Ubuntu 26.04. Zur Kontrolle hat whisper.cpp die erzeugten Sätze wieder in Text umgewandelt. Sie kamen Wort für Wort richtig zurück.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
Hier liegen später das Programm, die Stimmen und die erzeugten Audiodateien.
mkdir ~/piper
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/piper
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python, pip und piper die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Piper installieren
pip install piper-tts
Prüfen: Die Ausgabe nennt Version: 1.8.0 oder eine neuere Version.
pip show piper-tts
8. Deutsche Stimmen anzeigen
Ohne Angabe einer Stimme listet der Befehl alle verfügbaren Stimmen auf. grep de_DE zeigt nur die deutschen.
python -m piper.download_voices | grep de_DE
Prüfen: Die Liste enthält unter anderem de_DE-thorsten-high.
9. Stimme herunterladen
Lädt die Stimme aus dem Hugging-Face-Konto des Projekts in den aktuellen Ordner. Zu jeder Stimme gehören zwei Dateien: das Modell (.onnx) und seine Einstellungen (.onnx.json).
python -m piper.download_voices de_DE-thorsten-high
Prüfen: Die Liste zeigt de_DE-thorsten-high.onnx und de_DE-thorsten-high.onnx.json.
ls
Erste Schritte
10. Einen Satz in eine Datei sprechen
echo gibt den Text an Piper weiter. -m wählt die Stimme, -f die Ausgabedatei.
echo "Willkommen in Ahrensburg. Die Werkstatt nimmt Reparaturen dienstags und donnerstags an." | piper -m de_DE-thorsten-high.onnx -f test.wav
Prüfen: Nach etwa zwei Sekunden liegt die Datei test.wav im Ordner.
11. Datei abspielen
aplay gehört bei Ubuntu zur Grundausstattung und spielt WAV-Dateien über den Standard-Lautsprecher ab.
aplay test.wav
Prüfen: Du hörst den Satz. Im Terminal steht Wiedergabe: WAVE 'test.wav' : Signed 16 bit Little Endian, Rate: 22050 Hz, mono.
12. Direkt sprechen, ohne Datei
--output-raw gibt die Audiodaten fortlaufend aus, statt eine Datei zu schreiben. aplay spielt sie sofort ab. Weil dabei die Angaben einer WAV-Datei fehlen, nennt man aplay das Format: 22 050 Messwerte pro Sekunde, 16 Bit, ein Kanal.
echo "Hallo aus dem Lautsprecher." | piper -m de_DE-thorsten-high.onnx --output-raw | aplay -r 22050 -f S16_LE -t raw -c 1 -
13. Eine Textdatei vorlesen
Lege eine Textdatei mit einigen Sätzen an:
nano vorlesen.txt
Schreibe ein paar Sätze hinein, speichere mit Strg+O und Enter und beende nano mit Strg+X. Danach liest Piper die Datei vor. --sentence-silence 0.5 fügt nach jedem Satz eine halbe Sekunde Pause ein.
piper -m de_DE-thorsten-high.onnx -i vorlesen.txt -f vorlesen.wav --sentence-silence 0.5
aplay vorlesen.wav
Aus Python verwenden
14. Programm anlegen
Das Programm erzeugt denselben Satz zweimal, einmal normal und einmal langsamer gesprochen, und gibt die Länge der Aufnahmen aus.
nano sprechen.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import wave
from piper import PiperVoice, SynthesisConfig
stimme = PiperVoice.load("de_DE-thorsten-high.onnx")
satz = "Ihr Fahrrad ist fertig. Sie können es ab morgen um neun Uhr abholen."
fassungen = {
"normal.wav": SynthesisConfig(),
"langsam.wav": SynthesisConfig(length_scale=1.4),
}
for datei, einstellung in fassungen.items():
with wave.open(datei, "wb") as wav:
stimme.synthesize_wav(satz, wav, syn_config=einstellung)
with wave.open(datei, "rb") as wav:
print(f"{datei}: {wav.getnframes() / wav.getframerate():.1f} Sekunden")
PiperVoice.load– lädt die Stimme einmal. Die Einstellungsdatei.onnx.jsonfindet Piper von selbst, wenn sie daneben liegt.SynthesisConfig– Einstellungen für das Sprechen.length_scaledehnt die Laute: Werte über 1 sprechen langsamer, unter 1 schneller. Weitere Angaben sind etwavolumefür die Lautstärke.synthesize_wav– schreibt die Sprache in eine geöffnete WAV-Datei.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm ausführen
python sprechen.py
Prüfen: Die Ausgabe lautet:
normal.wav: 3.8 Sekunden
langsam.wav: 4.9 Sekunden
16. Beide Fassungen anhören
aplay normal.wav langsam.wav
Wie geht es weiter?
- Andere Stimmen: Hörproben aller Stimmen gibt es unter https://rhasspy.github.io/piper-samples. Eine neue Stimme lädt man wie in Schritt 9 und wählt sie mit
-m. - Mehrere Sprechweisen: Die Stimme
de_DE-thorsten_emotional-mediumenthält acht Sprechweisen, etwa neutral (Nummer 4), müde (5) oder flüsternd (7).-swählt eine davon über ihre Nummer aus. Die Zuordnung steht in der Datei.onnx.jsonunterspeaker_id_map. - Als Dienst: Mit
pip install "piper-tts[http]"kommt ein kleiner Webserver dazu (python -m piper.http_server -m …), dem andere Programme Text schicken. - Sprachassistent: whisper.cpp erkennt die Frage, ein Modell aus Ollama formuliert die Antwort, Piper spricht sie aus.
- Dokumentation: https://github.com/OHF-Voice/piper1-gpl
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung, Stimmen und Audiodateien.
rm -rf ~/piper
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/rhasspy/piper
- Lizenz: Piper steht unter der MIT.
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.
Lokaler Sprachassistent
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Diese Anleitung baut aus drei Programmen dieses Buchs einen Sprachassistenten, der vollständig auf dem eigenen Rechner läuft. Man stellt eine Frage ins Mikrofon, whisper.cpp macht daraus Text, ein Sprachmodell in Ollama formuliert die Antwort und Piper liest sie vor. Keine Aufnahme und keine Frage verlässt den Rechner.
Vorbemerkungen
- Ablauf: Aufnahme mit
arecord→ Spracherkennung mit whisper.cpp → Antwort vonqwen3:4b-instructin Ollama → Sprachausgabe mit Piper → Wiedergabe mitaplay. Ein kleines Python-Programm verbindet die Schritte. - Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Die übrigen Programme richtet diese Anleitung selbst ein. Wer die Anleitungen zu whisper.cpp und Piper schon durchgearbeitet hat, kennt die Schritte bereits. - Grafikkarte: Im Test auf einer GeForce GTX 1660 mit 6 GB passten das Whisper-Modell und das Sprachmodell gleichzeitig in den Grafikspeicher. Eine Frage samt Antwort dauerte rund vier Sekunden. Ohne Grafikkarte funktioniert alles auch, nur deutlich langsamer.
- Ohne Mikrofon testen: Damit der erste Test unabhängig vom Mikrofon gelingt, spricht Piper zuerst zwei Testfragen in Dateien, die der Assistent dann beantwortet.
- Kleine Modelle wissen wenig: Im Test hat der Assistent Kiel richtig als Landeshauptstadt genannt, aber eine falsche Einwohnerzahl (180 000 statt rund 250 000). Für Fakten ist ein Modell mit 4 Milliarden Parametern nicht verlässlich.
- Version: Getestet mit whisper.cpp 1.8.3 aus Ubuntu 26.04, piper-tts 1.8.0, ollama (Python-Paket) 0.6 und Ollama 0.34.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. whisper.cpp und Python-Umgebungen installieren
whisper.cpp– die Spracherkennunglibggml0-backend-vulkan– damit whisper.cpp auf der Grafikkarte rechnet. Ohne geeignete Grafikkarte kann es entfallen.python3-venv– für die virtuelle Umgebung des Assistenten
sudo apt install whisper.cpp libggml0-backend-vulkan python3-venv
3. Projektordner anlegen
mkdir ~/assistent
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/assistent
5. Virtuelle Umgebung anlegen
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Die Eingabezeile beginnt danach mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Piper und den Ollama-Client installieren
piper-tts– die Sprachausgabeollama– die Python-Anbindung an den laufenden Ollama-Dienst
pip install piper-tts ollama
8. Deutsche Stimme herunterladen
python -m piper.download_voices de_DE-thorsten-high
9. Modell für die Spracherkennung herunterladen
curl -L -o ggml-large-v3-turbo-q5_0.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin
Prüfen: Im Ordner liegen de_DE-thorsten-high.onnx, de_DE-thorsten-high.onnx.json und ggml-large-v3-turbo-q5_0.bin.
ls
Das Programm
10. Programm anlegen
nano assistent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import subprocess
import sys
import wave
import ollama
from piper import PiperVoice
WHISPER_MODELL = "ggml-large-v3-turbo-q5_0.bin"
SPRACHMODELL = "qwen3:4b-instruct"
STIMME = PiperVoice.load("de_DE-thorsten-high.onnx")
# Bisheriges Gespräch, damit das Modell Rückfragen versteht
verlauf = [
{
"role": "system",
"content": "Du bist ein freundlicher Sprachassistent. Antworte auf Deutsch in höchstens zwei kurzen Sätzen, "
"ohne Aufzählungen, Emojis oder Formatierungen, denn deine Antwort wird vorgelesen.",
}
]
def aufnehmen(datei, sekunden=5):
"""Nimmt über das Standardmikrofon auf."""
print(f"Sprich jetzt ({sekunden} Sekunden) …")
subprocess.run(["arecord", "-q", "-f", "S16_LE", "-r", "16000", "-c", "1", "-d", str(sekunden), datei], check=True)
def erkennen(datei):
"""Wandelt Sprache mit whisper.cpp in Text um."""
ergebnis = subprocess.run(
["whisper-cli", "-m", WHISPER_MODELL, "-l", "de", "-nt", "-np", "-f", datei],
capture_output=True, text=True, check=True,
)
return ergebnis.stdout.strip()
def antworten(frage):
"""Fragt das Sprachmodell in Ollama."""
verlauf.append({"role": "user", "content": frage})
antwort = ollama.chat(model=SPRACHMODELL, messages=verlauf).message.content
verlauf.append({"role": "assistant", "content": antwort})
return antwort
def sprechen(text, datei="antwort.wav"):
"""Spricht den Text mit Piper und spielt ihn ab."""
with wave.open(datei, "wb") as wav:
STIMME.synthesize_wav(text, wav)
subprocess.run(["aplay", "-q", datei], check=True)
def runde(datei):
frage = erkennen(datei)
print("Du:", frage)
antwort = antworten(frage)
print("Assistent:", antwort)
sprechen(antwort)
if len(sys.argv) > 1:
# Fertige Audiodateien nacheinander beantworten
for datei in sys.argv[1:]:
runde(datei)
else:
while input("Enter drücken zum Sprechen, q und Enter zum Beenden: ").strip().lower() != "q":
aufnehmen("frage.wav")
runde("frage.wav")
verlauf– die Liste aller bisherigen Fragen und Antworten. Sie geht bei jeder Frage mit an das Modell, deshalb versteht es Rückfragen wie „Und wie viele Einwohner hat sie?“. Die erste Nachricht mit der Rollesystemlegt fest, wie der Assistent antwortet. Kurze Sätze ohne Aufzählungen klingen beim Vorlesen natürlicher.aufnehmen– nimmt fünf Sekunden im Format auf, mit dem Whisper intern arbeitet.erkennen– ruftwhisper-cliauf.-ntlässt die Zeitangaben weg,-npalle Meldungen außer dem erkannten Text.antworten– schickt den Verlauf an Ollama und hängt die Antwort an.sprechen– erzeugt mit Piper die Dateiantwort.wavund spielt sie mitaplayab.- Zwei Betriebsarten: Mit Dateinamen beim Aufruf beantwortet das Programm diese Aufnahmen. Ohne Dateinamen hört es nach jedem Enter fünf Sekunden zu.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Test ohne Mikrofon
11. Erste Testfrage sprechen lassen
Piper spricht die Frage in die Datei frage1.wav.
echo "Wie heißt die Landeshauptstadt von Schleswig-Holstein?" | piper -m de_DE-thorsten-high.onnx -f frage1.wav
12. Zweite Testfrage sprechen lassen
Eine Rückfrage, die sich auf die erste bezieht.
echo "Und wie viele Einwohner hat sie ungefähr?" | piper -m de_DE-thorsten-high.onnx -f frage2.wav
13. Assistent mit den Testfragen starten
python assistent.py frage1.wav frage2.wav
Prüfen: Nach einigen Sekunden stehen im Terminal etwa diese Zeilen, und du hörst beide Antworten aus dem Lautsprecher:
Du: Wie heißt die Landeshauptstadt von Schleswig-Holstein?
Assistent: Die Landeshauptstadt von Schleswig-Holstein ist Kiel.
Du: Und wie viele Einwohner hat sie ungefähr?
Assistent: Kiel hat etwa 180.000 Einwohner.
Die Rückfrage wurde verstanden: „sie“ hat der Assistent auf Kiel bezogen. Die Zahl ist allerdings falsch, siehe Vorbemerkungen.
Mit dem Mikrofon sprechen
14. Assistent ohne Dateien starten
python assistent.py
15. Eine Frage stellen
Drücke Enter, warte auf Sprich jetzt (5 Sekunden) … und stelle deine Frage. Nach der Aufnahme zeigt das Programm, was es verstanden hat, und spricht die Antwort. Danach kannst du mit Enter die nächste Frage stellen oder mit q und Enter aufhören.
Prüfen: Hinter Du: steht deine Frage. Steht dort etwas, das du nicht gesagt hast, z. B. Untertitelung des ZDF, 2020, war die Aufnahme leer. Dann in den Einstellungen von Ubuntu das richtige Mikrofon als Eingabegerät wählen, siehe whisper.cpp.
Wie geht es weiter?
- Eigenes Wissen: Statt allgemeiner Fragen kann der Assistent in eigenen Dokumenten nachschlagen. Dafür sucht man vor
antwortenmit Chroma passende Abschnitte und gibt sie in der Nachricht mit. - Werkzeuge: Mit
tools=[…]beiollama.chatkann das Modell Python-Funktionen aufrufen, etwa für die Uhrzeit oder einen Lagerbestand, wie in Vercel AI SDK oder Mastra gezeigt. - Länger zuhören:
sekunden=5inaufnehmenändern oderwhisper-streamaus whisper.cpp für fortlaufendes Mitschreiben verwenden. - Andere Stimme oder anderes Modell:
STIMMEundSPRACHMODELLoben im Programm anpassen.
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung, Stimme, Whisper-Modell und Aufnahmen.
rm -rf ~/assistent
3. whisper.cpp entfernen (optional)
Nur ausführen, wenn du whisper.cpp nicht mehr brauchst. Wird libggml0-backend-vulkan noch von llama.cpp gebraucht, lass es im Befehl weg.
sudo apt purge whisper.cpp libggml0-backend-vulkan
4. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
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.
Model Context Protocol (MCP)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das Model Context Protocol ist ein offener Standard, über den KI-Anwendungen auf Werkzeuge und Daten zugreifen. Ein MCP-Server bietet Werkzeuge an, etwa eine Datenbankabfrage oder eine Suche, und ein MCP-Client wie Claude Code, ein Agenten-Framework oder ein Chatprogramm verwendet sie. Diese Anleitung baut mit dem offiziellen Python-SDK einen eigenen Server und bindet ihn an.
Vorbemerkungen
- Wozu? Ohne MCP muss man jedes Werkzeug für jedes Programm neu einbauen, etwa einmal für LangGraph und einmal für Pydantic AI. Ein MCP-Server wird einmal geschrieben und funktioniert dann mit allen Programmen, die MCP verstehen.
- Bausteine: Ein Server bietet Werkzeuge (Funktionen, die das Modell aufruft), Ressourcen (Daten zum Lesen, mit einer Adresse wie
laden://adresse) und Prompts (Vorlagen) an. - Verbindung über stdio: Meist startet der Client den Server als eigenes Programm und spricht über dessen Ein- und Ausgabe mit ihm. Ein Netzwerkport ist dafür nicht nötig. Alternativ kann ein Server auch über HTTP laufen.
- Version 2 des SDK: Diese Anleitung verwendet mcp 2.2. Viele Beispiele im Netz stammen noch aus Version 1 und verwenden
FastMCP. Diese Klasse heißt jetztMCPServer. Alter Code bricht mit einer Fehlermeldung ab, die auf die neue Klasse hinweist. - Installation über pip: Das SDK ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 75 MB. - Version: Getestet mit mcp 2.2.0 unter Python 3.14 aus Ubuntu 26.04 und Claude Code 2.1.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/mcp-laden
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/mcp-laden
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. MCP-SDK installieren
[cli] installiert zusätzlich den Befehl mcp mit Hilfsprogrammen für die Entwicklung.
pip install "mcp[cli]"
Prüfen: Die Ausgabe nennt Version: 2.2.0 oder eine neuere Version.
pip show mcp
Einen MCP-Server schreiben
8. Server anlegen
Der Server gibt Auskunft über einen Fahrradladen. Er bietet zwei Werkzeuge an, Lagerbestand und Öffnungszeiten, und eine Ressource mit der Anschrift.
nano laden_server.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from pydantic import BaseModel
from mcp.server import MCPServer
server = MCPServer("Fahrradladen", instructions="Auskünfte über Lager und Öffnungszeiten eines Fahrradladens.")
LAGER = {"citybike": 4, "trekkingrad": 0, "lastenrad": 1}
ZEITEN = {
"montag": "9 bis 18 Uhr",
"dienstag": "9 bis 18 Uhr",
"mittwoch": "9 bis 18 Uhr",
"donnerstag": "9 bis 18 Uhr",
"freitag": "9 bis 18 Uhr",
"samstag": "10 bis 14 Uhr",
"sonntag": "geschlossen",
}
class Bestand(BaseModel):
modell: str
anzahl: int | None
@server.tool()
def lagerbestand(modell: str) -> Bestand:
"""Gibt zurück, wie viele Räder eines Modells (citybike, trekkingrad, lastenrad) im Lager sind."""
return Bestand(modell=modell, anzahl=LAGER.get(modell.strip().lower()))
@server.tool()
def oeffnungszeiten(wochentag: str) -> str:
"""Nennt die Öffnungszeiten des Ladens an einem Wochentag, z. B. samstag."""
return ZEITEN.get(wochentag.strip().lower(), "Unbekannter Wochentag")
@server.resource("laden://adresse")
def adresse() -> str:
"""Anschrift des Ladens."""
return "Fahrradladen Speiche, Große Straße 1, 22926 Ahrensburg"
if __name__ == "__main__":
server.run()
MCPServer– der Server.instructionserklärt dem Client, wofür der Server da ist.@server.tool()– macht eine Funktion zu einem Werkzeug. Der Name der Funktion wird zum Namen des Werkzeugs, der Docstring zur Beschreibung für das Modell, die Typangaben zur Beschreibung der Parameter.Bestand– ein Pydantic-Modell als Rückgabetyp. Dann liefert der Server die Antwort zusätzlich als strukturierte Daten mit festen Feldern, die ein Programm direkt weiterverarbeiten kann.@server.resource(…)– stellt Daten unter einer festen Adresse zum Lesen bereit.server.run()– startet den Server über stdio. Er wartet dann auf Anfragen und gibt selbst nichts im Terminal aus.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Den Server aus Python verwenden
9. Client anlegen
Der Client startet den Server, fragt ab, welche Werkzeuge es gibt, ruft sie auf und liest die Ressource.
nano client.py
Füge diesen Inhalt ein:
import asyncio
import sys
from mcp import StdioServerParameters
from mcp.client import Client
async def main():
# Den Server mit demselben Python starten, das auch den Client ausführt
server = StdioServerParameters(command=sys.executable, args=["laden_server.py"])
async with Client(server) as client:
werkzeuge = await client.list_tools()
for werkzeug in werkzeuge.tools:
print("Werkzeug:", werkzeug.name, "-", werkzeug.description)
ergebnis = await client.call_tool("lagerbestand", {"modell": "lastenrad"})
print("lagerbestand:", ergebnis.structured_content)
ergebnis = await client.call_tool("oeffnungszeiten", {"wochentag": "Samstag"})
print("oeffnungszeiten:", ergebnis.content[0].text)
inhalt = await client.read_resource("laden://adresse")
print("Adresse:", inhalt.contents[0].text)
asyncio.run(main())
StdioServerParameters– sagt dem Client, wie er den Server startet.sys.executableist das Python der virtuellen Umgebung. Ein einfachespythonwürde in manchen Fällen das Python von Ubuntu treffen, dem das Paketmcpfehlt.Client(server)– startet den Server und handelt mit ihm die Protokollversion aus. Am Ende desasync with-Blocks beendet er ihn wieder.structured_content– die strukturierte Antwort aus dem Pydantic-Modell.contententhält dieselbe Antwort als Text für das Sprachmodell.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Client ausführen
python client.py
Prüfen: Die Ausgabe lautet:
Werkzeug: lagerbestand - Gibt zurück, wie viele Räder eines Modells (citybike, trekkingrad, lastenrad) im Lager sind.
Werkzeug: oeffnungszeiten - Nennt die Öffnungszeiten des Ladens an einem Wochentag, z. B. samstag.
lagerbestand: {'modell': 'lastenrad', 'anzahl': 1}
oeffnungszeiten: 10 bis 14 Uhr
Adresse: Fahrradladen Speiche, Große Straße 1, 22926 Ahrensburg
Den Server in Claude Code einbinden
Dieser Teil setzt ein installiertes Claude Code voraus. Andere Programme mit MCP-Unterstützung binden einen Server auf ähnliche Weise ein: Man nennt ihnen den Befehl, mit dem sie den Server starten.
11. Server anmelden
Meldet den Server unter dem Namen laden an. Hinter -- steht der Befehl, mit dem Claude Code ihn startet, mit vollständigen Pfaden, weil Claude Code die virtuelle Umgebung nicht kennt. $HOME ersetzt die Shell durch den Home-Ordner. Ohne weitere Angabe gilt der Eintrag nur, wenn Claude Code im aktuellen Ordner gestartet wird.
claude mcp add laden -- $HOME/mcp-laden/.venv/bin/python $HOME/mcp-laden/laden_server.py
Prüfen: Die Ausgabe beginnt mit Added stdio MCP server laden.
12. Verbindung prüfen
Claude Code startet dabei jeden angemeldeten Server kurz und prüft, ob er antwortet.
claude mcp list
Prüfen: In der Liste steht laden: … - ✔ Connected.
13. Claude Code verwenden
Starte Claude Code im Projektordner:
claude
Frage dann zum Beispiel „Habt ihr ein Lastenrad auf Lager, und bis wann habt ihr am Samstag geöffnet?“. Claude Code ruft dafür die Werkzeuge lagerbestand und oeffnungszeiten des Servers laden auf. Je nach Einstellung fragt es vorher, ob es das darf. Mit /mcp zeigt Claude Code die angemeldeten Server und ihre Werkzeuge an.
Getestet wurde hier die Verbindung aus Schritt 12, nicht ein ganzes Gespräch in Claude Code.
Wie geht es weiter?
- Über HTTP:
server.run(transport="streamable-http", port=8000)startet den Server als Webdienst unterhttp://127.0.0.1:8000/mcp. Im Client genügt dannClient("http://127.0.0.1:8000/mcp"). Der Server lauscht dabei nur für den eigenen Rechner. Für den Zugriff von anderen Rechnern schaltet man nginx mit HTTPS davor. - Prüfwerkzeug:
mcp dev laden_server.pystartet den MCP Inspector, eine Weboberfläche zum Ausprobieren der Werkzeuge. Er braucht Node.js mitnpx. - In Agenten-Frameworks: Pydantic AI, das OpenAI Agents SDK, LangGraph und andere können MCP-Server einbinden. So nutzt auch ein lokales Modell aus Ollama dieselben Werkzeuge.
- Fertige Server: Für Dateisystem, Git, Datenbanken und viele Webdienste gibt es fertige MCP-Server, eine Übersicht unter https://github.com/modelcontextprotocol/servers.
- Dokumentation: https://modelcontextprotocol.io und für das Python-SDK https://py.sdk.modelcontextprotocol.io
Deinstallieren
1. Server bei Claude Code abmelden
Nur nötig, wenn du ihn in Schritt 11 angemeldet hast. Den Befehl im Projektordner ausführen, denn der Eintrag gilt nur dort.
claude mcp remove laden
2. Virtuelle Umgebung verlassen
deactivate
3. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/mcp-laden
4. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://modelcontextprotocol.io/
- Lizenz: Model Context Protocol steht unter der MIT.
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.
LlamaIndex
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
LlamaIndex ist eine Python-Bibliothek, mit der man Sprachmodelle mit eigenen Dokumenten verbindet. Sie liest Texte ein, zerlegt sie in Abschnitte, speichert sie als Vektoren und sucht zu einer Frage die passenden Abschnitte heraus. Das Sprachmodell formuliert dann die Antwort daraus. Dieses Vorgehen heißt RAG (Retrieval-Augmented Generation). Diese Anleitung baut ein kleines RAG-Beispiel mit Ollama als Sprachmodell und PostgreSQL mit pgvector als Speicher.
Vorbemerkungen
-
Voraussetzungen:
- PostgreSQL ist installiert und läuft.
- Ollama läuft und hat die Modelle
qwen3:4b-instructundnomic-embed-textgeladen.
-
Alles lokal: Dokumente, Vektoren und Sprachmodell bleiben auf dem eigenen Rechner. Es entstehen keine Kosten pro Anfrage.
-
Installation über pip: LlamaIndex ist nicht in den Ubuntu-Paketquellen. Es wird mit
pipin eine virtuelle Umgebung (venv) installiert, wie in der Anleitung LangGraph und LangChain. -
Pakete: LlamaIndex ist in viele kleine Pakete aufgeteilt. Man installiert nur, was man braucht:
Paket Aufgabe llama-index-coreGrundlagen: Dokumente einlesen, zerlegen, Index, Abfragen llama-index-llms-ollamaAnbindung an Chat-Modelle in Ollama llama-index-embeddings-ollamaAnbindung an Embedding-Modelle in Ollama llama-index-vector-stores-postgresSpeichert die Vektoren in PostgreSQL mit pgvector -
Versionen: Getestet mit llama-index-core 0.14.25, Python 3.14, Ollama 0.34 und PostgreSQL 18 mit pgvector 0.8.
-
Passwort:
geheimes_passwortist ein Beispiel. Ersetze es überall durch ein eigenes Passwort.
Vorbereitung
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketstände der Ubuntu-Paketquellen kennt.
sudo apt update
2. pgvector und venv-Unterstützung installieren
postgresql-18-pgvector erweitert PostgreSQL um den Datentyp vector und die Ähnlichkeitssuche. python3-venv wird für virtuelle Umgebungen gebraucht. Ist beides schon vorhanden, meldet apt das nur.
sudo apt install postgresql-18-pgvector python3-venv
3. Datenbankbenutzer anlegen
Legt in PostgreSQL den Benutzer llamaindex an, mit dem sich das Python-Programm anmeldet.
sudo -u postgres psql -c "CREATE USER llamaindex WITH PASSWORD 'geheimes_passwort';"
4. Datenbank anlegen
Legt die Datenbank llamaindex an und macht den gleichnamigen Benutzer zu ihrem Eigentümer.
sudo -u postgres psql -c "CREATE DATABASE llamaindex OWNER llamaindex;"
5. pgvector in der Datenbank einschalten
Erweiterungen schaltet man pro Datenbank ein, und das darf nur ein Administrator. Deshalb erledigt das der Benutzer postgres und nicht das Programm selbst.
sudo -u postgres psql -d llamaindex -c "CREATE EXTENSION vector;"
Prüfen: Die Tabelle zeigt die Erweiterung vector.
sudo -u postgres psql -d llamaindex -c "\dx vector"
Installation
6. Projektordner anlegen
Legt einen Ordner für das Beispiel an.
mkdir ~/llamaindex-test
7. In den Projektordner wechseln
Alle weiteren Befehle arbeiten in diesem Ordner.
cd ~/llamaindex-test
8. Virtuelle Umgebung anlegen
Erzeugt den Unterordner .venv mit einer eigenen Python-Umgebung für dieses Projekt.
python3 -m venv .venv
9. Virtuelle Umgebung aktivieren
Ab jetzt beziehen sich python und pip in diesem Terminal auf die Umgebung. Vor der Eingabeaufforderung steht (.venv). In einem neuen Terminal musst du diesen Schritt wiederholen.
source .venv/bin/activate
10. LlamaIndex installieren
Installiert die vier Pakete samt Abhängigkeiten, darunter die PostgreSQL-Treiber psycopg2 und asyncpg und das Python-Paket ollama.
pip install llama-index-core llama-index-llms-ollama llama-index-embeddings-ollama llama-index-vector-stores-postgres
Prüfen: Alle vier Pakete erscheinen in der Liste.
pip list | grep llama-index
Beispiel: Fragen an eigene Dokumente
Das Beispiel verwendet Texte über eine erfundene Kaffeerösterei. So ist sicher, dass das Modell die Antworten nicht aus seinem Training kennt, sondern aus den Dokumenten holt.
11. Ordner für die Dokumente anlegen
LlamaIndex liest später alle Dateien aus diesem Ordner.
mkdir daten
12. Erstes Dokument schreiben
nano daten/roesterei.txt
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Die Kaffeerösterei Stormarn wurde 2011 von Jana Petersen in Ahrensburg gegründet.
Sie röstet jede Woche etwa 400 Kilogramm Kaffee in einem Trommelröster aus dem Jahr 1958.
Die beliebteste Sorte heißt "Schlossblick" und stammt aus Kolumbien.
13. Zweites Dokument schreiben
nano daten/oeffnungszeiten.txt
Füge diesen Inhalt ein, speichere und beende nano wie in Schritt 12:
Der Laden der Kaffeerösterei Stormarn in der Hagener Allee hat dienstags bis samstags von 9 bis 18 Uhr geöffnet.
Montags ist Rösttag, dann bleibt der Laden geschlossen.
Jeden ersten Samstag im Monat gibt es um 11 Uhr eine kostenlose Röstvorführung.
14. Gemeinsame Einstellungen schreiben
Beide Programme der nächsten Schritte brauchen dieselben Einstellungen. Deshalb stehen sie in einer eigenen Datei.
nano einstellungen.py
Füge diesen Inhalt ein, speichere und beende nano:
from llama_index.core import Settings
from llama_index.embeddings.ollama import OllamaEmbedding
from llama_index.llms.ollama import Ollama
from llama_index.vector_stores.postgres import PGVectorStore
Settings.llm = Ollama(model="qwen3:4b-instruct", request_timeout=300, context_window=4096)
Settings.embed_model = OllamaEmbedding(model_name="nomic-embed-text")
speicher = PGVectorStore.from_params(
host="127.0.0.1",
port=5432,
database="llamaindex",
user="llamaindex",
password="geheimes_passwort",
table_name="notizen",
embed_dim=768,
)
Was die Zeilen bewirken:
Settings.llm– das Chat-Modell in Ollama, das die Antworten formuliert.request_timeout=300lässt ihm bis zu fünf Minuten Zeit, falls es erst geladen werden muss.context_window=4096sagt LlamaIndex, wie viel Text das Modell auf einmal verarbeitet.Settings.embed_model– das Embedding-Modell, das Texte und Fragen in Vektoren umwandelt.PGVectorStore.from_params– die Verbindung zur Datenbank aus den Schritten 3 bis 5. LlamaIndex legt dort die Tabelledata_notizenselbst an.embed_dim=768muss zur Länge der Vektoren vonnomic-embed-textpassen.
15. Programm zum Einlesen schreiben
nano einlesen.py
Füge diesen Inhalt ein, speichere und beende nano:
from llama_index.core import SimpleDirectoryReader, StorageContext, VectorStoreIndex
from einstellungen import speicher
dokumente = SimpleDirectoryReader("daten").load_data()
kontext = StorageContext.from_defaults(vector_store=speicher)
VectorStoreIndex.from_documents(dokumente, storage_context=kontext, show_progress=True)
print(f"{len(dokumente)} Dokumente eingelesen.")
SimpleDirectoryReader– liest alle Dateien im Ordnerdaten. Neben Text versteht es mit Zusatzpaketen z. B. auch PDF und Word.VectorStoreIndex.from_documents– zerlegt die Dokumente in Abschnitte, lässt für jeden Abschnitt einen Vektor berechnen und speichert beides in PostgreSQL.
16. Dokumente einlesen
Führt das Programm aus. Beim ersten Mal lädt Ollama das Embedding-Modell, danach geht es schneller.
python einlesen.py
Prüfen: Die letzte Zeile lautet 2 Dokumente eingelesen., und in der Datenbank stehen zwei Einträge.
sudo -u postgres psql -d llamaindex -c "SELECT count(*) FROM data_notizen;"
17. Programm zum Fragen schreiben
nano fragen.py
Füge diesen Inhalt ein, speichere und beende nano:
import sys
from llama_index.core import VectorStoreIndex
from einstellungen import speicher
index = VectorStoreIndex.from_vector_store(speicher)
abfrage = index.as_query_engine(similarity_top_k=2)
antwort = abfrage.query(sys.argv[1])
print(antwort)
print("\nQuellen:")
for treffer in antwort.source_nodes:
print(f"- {treffer.metadata['file_name']} (Ähnlichkeit {treffer.score:.2f})")
from_vector_store– öffnet den vorhandenen Index in PostgreSQL. Die Dokumente müssen nicht erneut eingelesen werden.similarity_top_k=2– sucht die zwei Abschnitte, die der Frage am ähnlichsten sind, und gibt sie dem Sprachmodell mit.sys.argv[1]– die Frage kommt als Text von der Befehlszeile.source_nodes– die gefundenen Abschnitte. So sieht man, woher die Antwort stammt.
18. Eine Frage stellen
python fragen.py "Wann kann ich eine Röstvorführung sehen, und an welchem Tag ist der Laden zu?"
Prüfen: Die Antwort nennt den ersten Samstag im Monat um 11 Uhr und den Montag. Darunter stehen beide Dateien als Quellen, oeffnungszeiten.txt mit der höheren Ähnlichkeit.
Eigene Dokumente legst du in den Ordner daten und führst Schritt 16 erneut aus. Dabei werden alle Dateien noch einmal eingelesen. Für wiederholtes Einlesen ohne doppelte Einträge bietet LlamaIndex eine IngestionPipeline mit Dokumentenverwaltung.
Hinweis: Ein kleines Modell gibt Fakten aus den Dokumenten zuverlässig wieder, rechnet aber leicht falsch. Im Test antwortete es auf die Frage nach dem Alter des Rösters mit „65 Jahre“, weil es das aktuelle Jahr nicht kennt. Wichtige Antworten prüft man deshalb anhand der angegebenen Quellen.
Deinstallieren
1. Virtuelle Umgebung verlassen
Stellt das Terminal wieder auf das Python des Systems um.
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung, Dokumenten und Programmen.
rm -rf ~/llamaindex-test
3. Datenbank löschen
Löscht die Datenbank mit allen gespeicherten Vektoren.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS llamaindex;"
4. Datenbankbenutzer löschen
Entfernt den Benutzer aus Schritt 3.
sudo -u postgres psql -c "DROP USER IF EXISTS llamaindex;"
5. Zwischenspeicher von pip leeren (optional)
pip hebt heruntergeladene Pakete in einem Zwischenspeicher auf, um spätere Installationen zu beschleunigen. Dieser Befehl gibt den Platz frei.
rm -rf ~/.cache/pip
Prüfen: Die Datenbank llamaindex fehlt in der Liste.
sudo -u postgres psql -l | grep llamaindex
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.llamaindex.ai/
- Lizenz: LlamaIndex steht unter der MIT.
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.
Microsoft GraphRAG
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GraphRAG ist ein Werkzeug von Microsoft, das aus Texten einen Wissensgraphen baut. Ein Sprachmodell liest die Dokumente, erkennt Personen, Organisationen, Orte und Ereignisse und die Beziehungen zwischen ihnen. Es fasst zusammenhängende Gruppen zu Themen zusammen. Fragen werden danach mit Hilfe dieses Graphen beantwortet. Das hilft besonders bei Fragen nach Zusammenhängen, die über mehrere Textstellen verteilt sind. Diese Anleitung nutzt Ollama als lokales Sprachmodell.
Vorbemerkungen
- Voraussetzung: Ollama läuft und hat die Modelle
qwen3:4b-instructundnomic-embed-textgeladen. - Python-Version: GraphRAG 3.2 läuft nur mit Python 3.11 bis 3.13. Ubuntu 26.04 bringt Python 3.14 mit, und ältere Versionen gibt es in den Paketquellen nicht. Die Anleitung verwendet deshalb uv, einen schnellen Paketmanager für Python. Er lädt für das Projekt ein passendes Python 3.13 herunter, ohne das Python von Ubuntu zu verändern.
uvselbst wird mitpipxinstalliert, wie es die Anleitung Python für Kommandozeilenprogramme empfiehlt. - Version: Getestet mit GraphRAG 3.2.0, uv 0.12, Python 3.13 und Ollama 0.34 auf einer GeForce GTX 1660.
- Rechenaufwand: GraphRAG schickt beim Aufbau des Graphen sehr viele Anfragen an das Sprachmodell. Drei kurze Absätze haben im Test fast fünf Minuten gebraucht. Für große Textmengen ist ein lokales 4B-Modell zu langsam und zu ungenau. Dort nimmt man ein größeres Modell oder einen Cloud-Anbieter.
- Ergebnis im Test: Die lokale Suche (
--method local) hat Fragen nach Zusammenhängen richtig beantwortet. Der Graph enthielt aber auch Fehler des kleinen Modells, etwa falsch geschriebene Namen. Die globale Suche (--method global) lieferte mit diesem Modell keine Antwort.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von pipx kennt.
sudo apt update
2. pipx installieren
pipx installiert Python-Programme jeweils in eine eigene Umgebung.
sudo apt install pipx
3. uv installieren
Installiert uv und legt die Befehle uv und uvx in ~/.local/bin ab.
pipx install uv
Prüfen: Die Versionsnummer erscheint, z. B. uv 0.12.19. Fehlt der Befehl, pipx ensurepath ausführen und ein neues Terminal öffnen.
uv --version
4. Projektordner anlegen
Legt einen Ordner für das Beispiel an.
mkdir ~/graphrag-test
5. In den Projektordner wechseln
Alle weiteren Befehle arbeiten in diesem Ordner.
cd ~/graphrag-test
6. Virtuelle Umgebung mit Python 3.13 anlegen
uv lädt Python 3.13 herunter (nach ~/.local/share/uv) und legt damit im Unterordner .venv eine virtuelle Umgebung an.
uv venv --python 3.13
Prüfen: Die Ausgabe beginnt mit Using CPython 3.13.
7. GraphRAG installieren
Installiert GraphRAG mit allen Abhängigkeiten in die Umgebung aus Schritt 6. uv findet den Ordner .venv im aktuellen Ordner von selbst und ist dabei deutlich schneller als pip.
uv pip install graphrag
8. Virtuelle Umgebung aktivieren
Ab jetzt ist der Befehl graphrag in diesem Terminal verfügbar. Vor der Eingabeaufforderung steht (graphrag-test).
source .venv/bin/activate
Prüfen: Die Hilfe von GraphRAG erscheint mit den Befehlen init, index und query.
graphrag --help
Projekt einrichten
9. Projekt anlegen
Erzeugt die Einstellungsdatei settings.yaml, die Datei .env für Zugangsdaten, den Ordner input für die Texte und den Ordner prompts mit den Anweisungen an das Sprachmodell. -m und -e geben das Chat- und das Embedding-Modell an. Ohne diese Angaben fragt der Befehl danach.
graphrag init --root . -m qwen3:4b-instruct -e nomic-embed-text
10. Platzhalter-Schlüssel eintragen
GraphRAG verlangt einen API-Schlüssel. Ollama braucht keinen und ignoriert ihn, deshalb reicht ein Platzhalter.
nano .env
Ändere die Zeile GRAPHRAG_API_KEY=<API_KEY> so ab, speichere mit Strg+O und Enter und beende nano mit Strg+X:
GRAPHRAG_API_KEY=ollama
11. Einstellungen an Ollama anpassen
GraphRAG spricht standardmäßig mit OpenAI. Ollama bietet unter /v1 eine Schnittstelle im selben Format an. Man muss GraphRAG nur die Adresse nennen.
nano settings.yaml
Nimm diese vier Änderungen vor. Strg+W sucht jeweils nach dem Text.
-
Suche
model: qwen3:4b-instruct. Füge direkt darunter eine neue Zeile mit derselben Einrückung ein:api_base: http://127.0.0.1:11434/v1 -
Suche
model: nomic-embed-textund füge darunter dieselbe Zeile ein. -
Suche
size: 1200und ändere den Wert aufsize: 600. Ollama verarbeitet standardmäßig nur 4.096 Tokens auf einmal. Kleinere Textabschnitte passen mit den Anweisungen von GraphRAG hinein. -
Suche
max_input_length: 8000und ändere den Wert aufmax_input_length: 2500. Aus demselben Grund.
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Die Einrückung muss aus Leerzeichen bestehen, sonst kann GraphRAG die Datei nicht lesen.
Prüfen: Die Datei enthält die neuen Werte.
grep -nE "api_base|size: 600|max_input_length" settings.yaml
12. Beispieltext schreiben
GraphRAG liest alle Textdateien im Ordner input. Der Text über eine erfundene Rösterei enthält Personen, Firmen, Orte und ein Ereignis.
nano input/roesterei.txt
Füge diesen Inhalt ein, speichere und beende nano:
Die Kaffeerösterei Stormarn wurde 2011 von Jana Petersen in Ahrensburg gegründet. Jana Petersen hatte vorher bei der Hamburger Reederei Nordlicht gearbeitet.
Die Rösterei bezieht ihren Rohkaffee von der Kooperative La Esperanza in Kolumbien. Aus diesem Kaffee entsteht die beliebteste Sorte "Schlossblick", benannt nach dem Ahrensburger Schloss.
Seit 2020 beliefert die Rösterei das Café am Schloss, das von Tom Becker geführt wird. Tom Becker und Jana Petersen organisieren gemeinsam jedes Jahr im September das Ahrensburger Kaffeefest.
Graph bauen und abfragen
13. Index aufbauen
Liest den Text, lässt das Sprachmodell Einträge und Beziehungen herausziehen, bildet Themengruppen, schreibt Berichte dazu und berechnet Vektoren. Das Ergebnis landet im Ordner output. Im Test dauerte das knapp fünf Minuten.
graphrag index --root .
Prüfen: Die letzte Zeile lautet Pipeline complete.
14. Erkannte Einträge ansehen
Die Ergebnisse liegen als Parquet-Dateien vor. Dieser Befehl zeigt die erkannten Einträge mit ihrem Typ.
python -c "import pandas as pd; print(pd.read_parquet('output/entities.parquet')[['title','type']])"
Prüfen: Die Liste enthält u. a. JANA PETERSEN und TOM BECKER (Typ PERSON), KAFFEERÖSTEREI STORMARN (Typ ORGANIZATION) und AHRENSBURG (Typ GEO). Einzelne Namen können falsch geschrieben sein, im Test z. B. „SCHLOSSLICK“.
15. Frage nach einem Zusammenhang stellen
Die lokale Suche geht von den Einträgen aus, die zur Frage passen, und folgt ihren Beziehungen im Graphen.
graphrag query --root . --method local "Welche Verbindung besteht zwischen Jana Petersen und Tom Becker?"
Prüfen: Die Antwort nennt das gemeinsam organisierte Kaffeefest und dass die Rösterei seit 2020 das Café am Schloss beliefert. Die Angaben wie [Data: Entities (1, 6); Relationships (5)] verweisen auf die Stellen im Graphen, auf die sich die Antwort stützt.
Deinstallieren
1. Virtuelle Umgebung verlassen
Stellt das Terminal wieder auf das Python des Systems um.
deactivate
2. Projekt entfernen
Löscht den Projektordner mit virtueller Umgebung, Texten, Graph und Einstellungen.
rm -rf ~/graphrag-test
3. Zwischenspeicher von uv leeren
uv hebt heruntergeladene Pakete auf, im Test rund 1 GB.
uv cache clean
4. Python 3.13 von uv entfernen
Entfernt das Python, das uv in Schritt 6 heruntergeladen hat. Das Python von Ubuntu bleibt unberührt.
uv python uninstall 3.13
5. uv entfernen
Entfernt uv selbst.
pipx uninstall uv
6. pipx entfernen (optional)
Nur ausführen, wenn du keine anderen Programme mit pipx installiert hast. pipx list zeigt, welche es gibt.
sudo apt purge pipx
sudo apt autoremove
Prüfen: Der Befehl uv wird nicht mehr gefunden.
uv --version
Quellen und Lizenz
- Offizielle Dokumentation: https://microsoft.github.io/graphrag/
- Lizenz: Microsoft GraphRAG steht unter der MIT.
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.
Letta
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Letta, früher MemGPT, baut KI-Agenten mit dauerhaftem Gedächtnis. Ein Letta-Agent merkt sich über Gespräche hinweg, was er über dich und deine Arbeit gelernt hat, und schreibt dieses Wissen selbst in seinen Speicher. Diese Anleitung installiert „Letta Code“, die aktuelle Form von Letta, als Programm im Terminal und verbindet es mit Claude von Anthropic.
Nicht vollständig getestet: Installation, Umstellung auf den lokalen Betrieb, das Verbinden mit Anthropic und die Modellliste (Schritte 1 bis 9) wurden unter Ubuntu 26.04 geprüft. Die Gespräche mit dem Agenten (ab Schritt 10) wurden nicht ausprobiert, weil dafür ein kostenpflichtiger API-Schlüssel nötig ist.
Vorbemerkungen
- Was sich geändert hat: Der frühere Letta-Server in Python (MemGPT) wird nicht mehr weiterentwickelt. Unter dem Namen
lettagibt es heute Letta Code, ein Programm für das Terminal mit eingebautem Agenten-Server. Ältere Anleitungen mitletta serverund einer eigenen PostgreSQL-Datenbank passen nicht mehr. - Installation mit pipx: Letta Code gibt es als Python-Paket. Es wird mit
pipxinstalliert, wie es die Anleitung Python für Kommandozeilenprogramme empfiehlt. Das Projekt verteilt es auch über npm. - Lokal statt Cloud: Ohne weitere Einstellung speichert Letta Code Agenten bei Letta Cloud, dafür braucht man ein Konto. Die Anleitung stellt auf den lokalen Betrieb um. Agenten und ihr Gedächtnis liegen dann im Ordner
~/.lettaauf deinem Rechner. - Sprachmodell: Die Anleitung verwendet Claude Opus 5.5 von Anthropic. Dafür brauchst du einen API-Schlüssel (https://console.anthropic.com), und jede Anfrage kostet Geld. Ein Agent schickt bei jeder Anfrage lange Anweisungen mit, etwa 25.000 Tokens. Das macht jede Anfrage spürbar teurer als eine einfache Chat-Frage.
- Warum kein lokales Modell: Letta Code kann auch Modelle aus Ollama nutzen. Im Test mit
qwen3:4b-instructauf einer Grafikkarte mit 6 GB war das aber nicht brauchbar. Die langen Anweisungen verlangen ein Kontextfenster von 32.768 Tokens, das Modell passte dann nicht mehr ganz in den Grafikspeicher, und eine Antwort dauerte rund fünf Minuten. Außerdem hatte sich der Agent die Information aus der vorigen Nachricht nicht gemerkt und eine Antwort erfunden. - Version: Letta Code 0.33.2 unter Python 3.14.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von pipx kennt.
sudo apt update
2. pipx installieren
pipx installiert Python-Programme jeweils in eine eigene virtuelle Umgebung und macht ihren Befehl trotzdem überall verfügbar.
sudo apt install pipx
3. Letta Code installieren
Lädt Letta Code von https://pypi.org und legt den Befehl letta in ~/.local/bin ab.
pipx install letta
Prüfen: Die Ausgabe lautet z. B. 0.33.2 (Letta Code).
letta --version
Meldet das Terminal letta: Kommando nicht gefunden, fehlt ~/.local/bin im Suchpfad. pipx ensurepath trägt den Ordner ein. Danach ein neues Terminal öffnen.
4. Auf lokalen Betrieb umstellen
Legt fest, dass neue Agenten auf diesem Rechner gespeichert werden und nicht bei Letta Cloud. Die Einstellung gilt dauerhaft.
letta backend local
Prüfen: Die Ausgabe lautet Agents you create by default will be stored on this device.
Mit Claude verbinden
5. API-Schlüssel eingeben
read -rsp fragt den Schlüssel ab, ohne ihn anzuzeigen, und legt ihn in der Variablen ANTHROPIC_API_KEY ab. So landet er weder auf dem Bildschirm noch im Befehlsverlauf. Füge den Schlüssel ein und drücke Enter.
read -rsp "API-Schlüssel: " ANTHROPIC_API_KEY
6. Anthropic als Anbieter eintragen
Übergibt den Schlüssel an Letta Code. Im Befehlsverlauf steht dabei nur der Variablenname, nicht der Schlüssel selbst. Letta speichert ihn in ~/.letta/lc-local-backend/providers/auth.json. Diese Datei darf nur dein Benutzer lesen.
letta connect anthropic --api-key "$ANTHROPIC_API_KEY"
Prüfen: Die Ausgabe endet mit Connected Anthropic (anthropic) in local storage. Im Test erschien diese Meldung auch bei einem ungültigen Schlüssel. Ob der Schlüssel stimmt, zeigt sich erst beim ersten Gespräch.
7. Schlüssel aus dem Terminal entfernen
Der Schlüssel liegt jetzt bei Letta. Die Variable im Terminal wird nicht mehr gebraucht.
unset ANTHROPIC_API_KEY
8. Verfügbare Claude-Modelle anzeigen
Listet die Modelle, die Letta über den eingetragenen Anbieter nutzen kann. Jedes Modell hat einen „Handle“ in der Form anbieter/modell.
letta model list | grep '"handle": "anthropic/claude-opus-5-5"' | head -1
Prüfen: Die Ausgabe enthält anthropic/claude-opus-5-5.
9. Projektordner anlegen und hineinwechseln
Letta Code merkt sich pro Ordner, mit welchem Agenten du zuletzt gesprochen hast. Ein eigener Ordner hält das Beispiel getrennt.
mkdir ~/letta-test
cd ~/letta-test
Erster Agent (nicht getestet)
10. Agenten anlegen und ihm etwas mitteilen
--new-agent legt einen neuen Agenten an, --model wählt Claude Opus 5.5. -p schickt eine einzelne Nachricht und gibt die Antwort aus, ohne die bildschirmfüllende Oberfläche zu öffnen.
letta --new-agent --model anthropic/claude-opus-5-5 -p "Merke dir bitte dauerhaft: Mein Lieblingskaffee ist die Sorte Schlossblick. Antworte kurz auf Deutsch."
Erwartet: Der Agent bestätigt, dass er sich die Sorte gemerkt hat.
11. Das Gedächtnis prüfen
Ohne --new-agent spricht Letta Code mit dem zuletzt in diesem Ordner genutzten Agenten weiter.
letta -p "Welche Kaffeesorte mag ich am liebsten? Antworte in einem Satz."
Erwartet: Der Agent nennt „Schlossblick“, obwohl die Frage eine neue Anfrage ist.
12. Agenten anzeigen
Listet die Agenten auf diesem Rechner im Format JSON, mit Name, Modell und Systemanweisungen.
letta agents list
13. Interaktiv arbeiten
Ohne weitere Angaben öffnet letta eine Oberfläche im Terminal, in der du fortlaufend mit dem Agenten schreibst. Befehle beginnen dort mit /, z. B. /help. Mit Strg+C beendest du sie.
letta
Wo liegt was?
~/.local/share/pipx/venvs/letta– das Programm in seiner virtuellen Umgebung.~/.letta/settings.json– Einstellungen, z. B. der lokale Betrieb aus Schritt 4.~/.letta/lc-local-backend– Agenten, Gespräche und die Zugangsdaten zu Anthropic.
Aktualisieren
1. Neue Version installieren
pipx aktualisiert Letta Code in seiner eigenen Umgebung. Letta Code bringt dafür auch einen eigenen Befehl letta update mit.
pipx upgrade letta
Prüfen: letta --version zeigt die neue Versionsnummer.
Deinstallieren
1. Letta Code entfernen
Entfernt das Programm samt seiner virtuellen Umgebung.
pipx uninstall letta
2. Agenten, Gespräche und Zugangsdaten löschen
Löscht den Ordner mit allen Agenten, ihrem Gedächtnis und dem gespeicherten API-Schlüssel. Achtung: Das Gedächtnis der Agenten geht dabei verloren.
rm -rf ~/.letta
3. Projektordner löschen
Entfernt den Ordner aus Schritt 9.
rm -rf ~/letta-test
4. pipx entfernen (optional)
Nur ausführen, wenn du keine anderen Programme mit pipx installiert hast. pipx list zeigt, welche es gibt.
sudo apt purge pipx
sudo apt autoremove
Prüfen: Der Befehl letta wird nicht mehr gefunden.
letta --version
Hinweis: Den API-Schlüssel kannst du in der Anthropic Console jederzeit sperren oder löschen, wenn du ihn nicht mehr brauchst.
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.
AnythingLLM
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
AnythingLLM ist ein Desktop-Programm, in dem man mit Sprachmodellen chattet und ihnen eigene Dokumente zum Nachschlagen gibt (RAG). Es bringt Vektordatenbank, Dokumentenimport und Oberfläche in einer Anwendung mit. Mit Ollama als Modell bleibt dabei alles auf dem eigenen Rechner.
Teilweise getestet: Installation, AppArmor-Profil, Start und die Erkennung der Ollama-Modelle wurden unter Ubuntu 26.04 geprüft. Die Einrichtung und der Chat in der Oberfläche (ab Schritt 10) wurden nicht durchgeklickt.
Vorbemerkungen
- Voraussetzung: Ollama läuft und hat die Modelle
qwen3:4b-instructundnomic-embed-textgeladen. - Keine Installation über apt: Für Linux gibt es AnythingLLM Desktop nur als AppImage. Das ist eine einzelne Programmdatei, die ohne Installation läuft. Der Hersteller bietet auch ein Installationsskript an. Diese Anleitung macht dieselben Schritte von Hand, lässt aber das zusätzliche, eingebaute Ollama weg, weil Ollama schon als Dienst läuft.
- Version: Getestet mit AnythingLLM Desktop 1.16.2.
- AppArmor: Ubuntu erlaubt Programmen seit Version 24.04 bestimmte Sandbox-Funktionen nur mit einem passenden AppArmor-Profil. Ohne Profil bricht AnythingLLM beim Start ab mit
The SUID sandbox helper binary was found, but is not configured correctly. Schritt 6 legt das Profil an. - Ports: AnythingLLM startet im Hintergrund einen eigenen Server auf 127.0.0.1:3001 und einen Dokumentensammler auf 127.0.0.1:8888. Port 3001 verwendet auch Wiki.js in dieser Sammlung. Läuft Wiki.js, stoppe es vor dem Start von AnythingLLM mit
sudo systemctl stop wikijs. - Platz: Das AppImage ist etwa 900 MB groß.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfspakete aus dem nächsten Schritt kennt.
sudo apt update
2. FUSE-Bibliothek installieren
AppImages binden sich beim Start als eigenes kleines Dateisystem ein. Dafür braucht AnythingLLM die ältere FUSE-Bibliothek in Version 2, die Ubuntu nicht mehr standardmäßig installiert. Ohne sie bricht der Start ab mit error loading libfuse.so.2.
sudo apt install libfuse2t64 curl
3. Ordner für Programme anlegen
Ein eigener Ordner im Home-Verzeichnis hält selbst heruntergeladene Programme zusammen.
mkdir -p ~/Anwendungen
4. AppImage herunterladen
Lädt AnythingLLM Desktop 1.16.2 (etwa 900 MB). Die aktuelle Version steht auf https://github.com/Mintplex-Labs/anything-llm/releases. Der Dateiname muss AnythingLLMDesktop.AppImage lauten, weil das AppArmor-Profil in Schritt 6 genau diesen Namen erwartet.
curl -L -o ~/Anwendungen/AnythingLLMDesktop.AppImage https://github.com/Mintplex-Labs/anything-llm/releases/download/v1.16.2/AnythingLLMDesktop.AppImage
5. AppImage ausführbar machen
Heruntergeladene Dateien sind unter Linux zunächst nicht ausführbar. chmod +x ändert das.
chmod +x ~/Anwendungen/AnythingLLMDesktop.AppImage
6. AppArmor-Profil anlegen
Legt ein Profil an, das AnythingLLM die Sandbox-Funktionen erlaubt. Es gilt für jede Datei namens AnythingLLMDesktop.AppImage, egal in welchem Ordner.
sudo nano /etc/apparmor.d/anythingllmdesktop
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
# AppArmor-Profil für AnythingLLM Desktop
abi <abi/4.0>,
include <tunables/global>
profile anythingllmdesktop /**/AnythingLLMDesktop.AppImage flags=(unconfined) {
userns,
}
profile anythingllmdesktop /**/AnythingLLMDesktop.AppImage– der Name des Profils und für welche Dateien es gilt./**/steht für einen beliebigen Ordner.flags=(unconfined)– das Programm wird sonst nicht eingeschränkt.userns,– erlaubt dem Programm, sogenannte User-Namespaces anzulegen. Die eingebaute Chromium-Sandbox braucht sie.
7. Profil laden
Lädt das neue Profil sofort, ohne Neustart.
sudo apparmor_parser -r /etc/apparmor.d/anythingllmdesktop
Prüfen: Das Profil erscheint in der Liste der geladenen Profile.
sudo aa-status | grep anythingllm
Starten
8. AnythingLLM starten
Startet das Programm. Beim ersten Start richtet es seinen Datenordner ~/.config/anythingllm-desktop ein, das dauert einige Sekunden.
~/Anwendungen/AnythingLLMDesktop.AppImage
Das Terminal bleibt belegt, solange AnythingLLM läuft, und zeigt laufend Meldungen. Beim Schließen des Fensters endet auch der Befehl.
9. Hintergrund-Server prüfen
Öffne ein zweites Terminal. Dieser Befehl fragt den eingebauten Server von AnythingLLM, ob er läuft.
curl -s http://127.0.0.1:3001/api/ping
Prüfen: Die Antwort lautet {"online":true}.
Einrichten (nicht getestet)
10. Ollama als Sprachmodell wählen
Beim ersten Start führt AnythingLLM durch eine Einrichtung. Wähle beim Sprachmodell (LLM Preference) den Anbieter Ollama. Als Adresse trägst du http://127.0.0.1:11434 ein, falls sie nicht schon da steht. Im Test fand AnythingLLM die Modelle von Ollama darüber selbst. Wähle qwen3:4b-instruct.
11. Ollama für Embeddings wählen
Unter Embedder wählst du ebenfalls Ollama und das Modell nomic-embed-text. Sonst nutzt AnythingLLM ein eingebautes, kleineres Embedding-Modell. Als Vektordatenbank bleibt die eingebaute LanceDB eingestellt. Sie braucht keine weitere Einrichtung.
12. Arbeitsbereich anlegen und Dokument hochladen
Lege einen Arbeitsbereich (Workspace) an, z. B. „Rösterei“. Über das Symbol zum Hochladen ziehst du eine Textdatei, ein PDF oder ein Word-Dokument hinein und fügst sie dem Arbeitsbereich hinzu (Move to Workspace, dann Save and Embed). AnythingLLM zerlegt das Dokument und speichert die Vektoren.
13. Frage stellen
Stelle im Arbeitsbereich eine Frage zum Inhalt des Dokuments. Unter der Antwort zeigt AnythingLLM die verwendeten Quellen. Als Übungsdokumente eignen sich die beiden Texte aus der Anleitung LlamaIndex.
Optional: Eintrag im Anwendungsmenü
14. Starter anlegen
Damit AnythingLLM im Anwendungsmenü von Ubuntu erscheint, braucht es eine Desktop-Datei. Das ~ wird darin nicht verstanden, deshalb steht dort der volle Pfad. Ersetze DEINNAME durch deinen Benutzernamen (Ausgabe von whoami).
nano ~/.local/share/applications/anythingllmdesktop.desktop
Füge diesen Inhalt ein, speichere und beende nano:
[Desktop Entry]
Type=Application
Name=AnythingLLM Desktop
Exec=/home/DEINNAME/Anwendungen/AnythingLLMDesktop.AppImage
Icon=/home/DEINNAME/.config/anythingllm-desktop/storage/icon.png
StartupWMClass=anythingllm-desktop
Categories=Utility;
Wo liegt was?
~/Anwendungen/AnythingLLMDesktop.AppImage– das Programm.~/.config/anythingllm-desktop/storage– Einstellungen, hochgeladene Dokumente, Vektordatenbank und Chats./etc/apparmor.d/anythingllmdesktop– das AppArmor-Profil.
Aktualisieren
1. AnythingLLM beenden
Schließe das Fenster von AnythingLLM.
2. Neue Version herunterladen
Überschreibt das AppImage mit der neuen Version. Ersetze v1.16.2 durch die aktuelle Versionsnummer. Einstellungen und Dokumente bleiben erhalten.
curl -L -o ~/Anwendungen/AnythingLLMDesktop.AppImage https://github.com/Mintplex-Labs/anything-llm/releases/download/v1.16.2/AnythingLLMDesktop.AppImage
3. Wieder ausführbar machen
Die neue Datei ist wie beim ersten Download nicht ausführbar.
chmod +x ~/Anwendungen/AnythingLLMDesktop.AppImage
Deinstallieren
1. AnythingLLM beenden
Schließe das Fenster von AnythingLLM.
2. Programm löschen
Entfernt das AppImage.
rm ~/Anwendungen/AnythingLLMDesktop.AppImage
3. Daten löschen
Löscht Einstellungen, Dokumente, Vektoren und Chats. Achtung: Alles, was du in AnythingLLM gespeichert hast, geht verloren.
rm -rf ~/.config/anythingllm-desktop
4. Menüeintrag löschen (falls angelegt)
Entfernt die Desktop-Datei aus Schritt 14. -f verhindert eine Fehlermeldung, falls es sie nicht gibt.
rm -f ~/.local/share/applications/anythingllmdesktop.desktop
5. AppArmor-Profil entladen
Nimmt das Profil aus dem laufenden AppArmor heraus.
sudo apparmor_parser -R /etc/apparmor.d/anythingllmdesktop
6. AppArmor-Profil löschen
Entfernt die Datei aus Schritt 6.
sudo rm /etc/apparmor.d/anythingllmdesktop
7. FUSE-Bibliothek entfernen (optional)
Nur ausführen, wenn kein anderes AppImage sie braucht.
sudo apt purge libfuse2t64
Prüfen: Das Profil ist nicht mehr geladen, die Ausgabe ist leer.
sudo aa-status | grep anythingllm
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/Mintplex-Labs/anything-llm
- Lizenz: AnythingLLM steht unter der MIT.
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.
Open WebUI
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open WebUI ist eine Weboberfläche zum Chatten mit Sprachmodellen, die im Browser ähnlich aussieht wie bekannte Chat-Dienste. Sie läuft auf dem eigenen Rechner, spricht direkt mit Ollama, speichert Gespräche, verwaltet mehrere Benutzer und beantwortet Fragen auch zu hochgeladenen Dokumenten.
Vorbemerkungen
- Voraussetzung: Ein laufendes Ollama mit mindestens einem Modell, hier
qwen3:4b-instruct. Open WebUI findet Ollama unterhttp://localhost:11434von selbst und zeigt alle dort geladenen Modelle an. - Python-Version: Open WebUI 0.11 läuft nur mit Python 3.11 oder 3.12. Ubuntu 26.04 bringt Python 3.14 mit. Die Anleitung verwendet deshalb wie bei Microsoft GraphRAG den Paketmanager uv. Er lädt ein eigenes Python 3.12 herunter und lässt das Python von Ubuntu unverändert.
- Kleinere Installation ohne CUDA: Für die Suche in Dokumenten bringt Open WebUI die Bibliothek PyTorch mit. In der Standardfassung mit Unterstützung für NVIDIA-Grafikkarten wird die Installation 6,9 GB groß. Die Anleitung wählt die Fassung für den Prozessor, damit sind es 2,5 GB. Die Antworten der Sprachmodelle berechnet weiterhin Ollama, auf Wunsch auch mit der Grafikkarte.
- Erster Start: Beim ersten Start lädt Open WebUI ein kleines Modell für die Dokumentensuche von Hugging Face herunter, rund 900 MB in
~/.cache/huggingface. - Port: Open WebUI lauscht normalerweise auf Port 8080. Diesen Port belegen oft schon andere Dienste, z. B. Apache aus der Anleitung Tileserver. Die Anleitung verwendet deshalb Port 8081 und lässt nur Zugriffe vom eigenen Rechner zu.
- Als Benutzerdienst: Open WebUI wird im eigenen Home-Ordner installiert und läuft als systemd-Dienst des angemeldeten Benutzers. Dafür braucht es nach der Installation kein
sudomehr. - Version: Getestet mit Open WebUI 0.11.4, uv 0.12 und Python 3.12.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von pipx kennt.
sudo apt update
2. pipx installieren
pipx installiert Python-Programme jeweils in eine eigene Umgebung. Ist es schon vorhanden, meldet apt das nur.
sudo apt install pipx
3. uv installieren
Legt die Befehle uv und uvx in ~/.local/bin ab.
pipx install uv
Prüfen: Die Versionsnummer erscheint, z. B. uv 0.12.21. Fehlt der Befehl, pipx ensurepath ausführen und ein neues Terminal öffnen.
uv --version
4. Programmordner anlegen
Hier liegen später das Programm, seine Datenbank und hochgeladene Dateien.
mkdir ~/open-webui
5. In den Programmordner wechseln
cd ~/open-webui
6. Virtuelle Umgebung mit Python 3.12 anlegen
uv lädt Python 3.12 nach ~/.local/share/uv herunter und legt damit im Unterordner .venv eine eigene Python-Umgebung an.
uv venv --python 3.12
Prüfen: Die Ausgabe beginnt mit Using CPython 3.12.
7. Open WebUI installieren
--torch-backend cpu wählt die kleinere Fassung von PyTorch ohne CUDA. Der Download ist trotzdem groß und dauert je nach Leitung einige Minuten.
uv pip install open-webui --torch-backend cpu
Prüfen: Die Ausgabe nennt Version: 0.11.4 oder eine neuere Version.
uv pip show open-webui
Als Dienst einrichten
8. Ordner für Benutzerdienste anlegen
systemd sucht die Dienste eines Benutzers in ~/.config/systemd/user. -p legt fehlende Zwischenordner mit an und meldet keinen Fehler, wenn der Ordner schon existiert.
mkdir -p ~/.config/systemd/user
9. Dienstdatei anlegen
nano ~/.config/systemd/user/open-webui.service
Füge diesen Inhalt ein (Strg+Umschalt+V):
[Unit]
Description=Open WebUI
After=network-online.target
[Service]
WorkingDirectory=%h/open-webui
Environment=DATA_DIR=%h/open-webui/data
Environment=SCARF_NO_ANALYTICS=true
Environment=DO_NOT_TRACK=true
Environment=ANONYMIZED_TELEMETRY=false
ExecStart=%h/open-webui/.venv/bin/open-webui serve --host 127.0.0.1 --port 8081
Restart=on-failure
[Install]
WantedBy=default.target
%h– setzt systemd durch den Home-Ordner des Benutzers ersetzt, z. B./home/thorsten.WorkingDirectory– beim ersten Start legt Open WebUI hier die Datei.webui_secret_keyan. Mit diesem Schlüssel unterschreibt es die Anmeldungen im Browser.DATA_DIR– Ordner für die Datenbankwebui.db, hochgeladene Dateien und die Suchdaten der Dokumente. Ohne diese Angabe lägen die Daten versteckt in der virtuellen Umgebung und gingen bei einer Neuinstallation verloren.SCARF_NO_ANALYTICS,DO_NOT_TRACK,ANONYMIZED_TELEMETRY– schalten anonyme Nutzungsstatistiken von Open WebUI und seinen Bibliotheken ab.--host 127.0.0.1 --port 8081– nur der eigene Rechner erreicht die Oberfläche, und zwar auf Port 8081.Restart=on-failure– startet Open WebUI nach einem Absturz neu.WantedBy=default.target– der Dienst startet, sobald du dich anmeldest.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. systemd die neue Datei bekannt machen
systemd liest Dienstdateien nur beim Start oder auf Anweisung ein. --user steht für die Dienste des eigenen Benutzers, deshalb ohne sudo.
systemctl --user daemon-reload
11. Dienst starten und dauerhaft einschalten
enable startet Open WebUI künftig bei jeder Anmeldung, --now startet es sofort.
systemctl --user enable --now open-webui
Prüfen: In der Ausgabe steht active (running). Beende die Anzeige mit q.
systemctl --user status open-webui
12. Auf den ersten Start warten
Beim ersten Start richtet Open WebUI seine Datenbank ein und lädt das Modell für die Dokumentensuche herunter. Im Test dauerte das gut eine Minute, spätere Starts etwa zehn Sekunden. Der Befehl zeigt die Meldungen des Dienstes laufend an. Beende ihn mit Strg+C, sobald eine Zeile mit Started server process erscheint.
journalctl --user -u open-webui -f
Prüfen: Die Antwort lautet {"status":true}.
curl http://127.0.0.1:8081/health
13. Auch ohne Anmeldung laufen lassen (optional)
Benutzerdienste laufen normalerweise nur, solange der Benutzer angemeldet ist. Dieser Befehl lässt sie schon beim Hochfahren des Rechners starten und nach dem Abmelden weiterlaufen. Für die Nutzung am eigenen Desktop ist das nicht nötig.
sudo loginctl enable-linger $USER
Erste Schritte im Browser
14. Oberfläche öffnen
Öffne im Browser diese Adresse:
http://localhost:8081
Die Oberfläche richtet sich nach der Sprache des Browsers und erscheint daher meist auf Deutsch.
15. Administratorkonto anlegen
Klicke auf Loslegen und gib Name, E-Mail-Adresse und Passwort ein. Das erste Konto wird automatisch zum Administrator. Die E-Mail-Adresse dient nur als Anmeldename. Open WebUI verschickt keine E-Mails.
Prüfen: Nach dem Klick auf Admin-Konto erstellen erscheint das Chatfenster.
16. Modell auswählen und chatten
Oben links steht die Modellauswahl. Wähle qwen3:4b-instruct und stelle unten im Eingabefeld eine Frage, z. B. „Wie heißt die Landeshauptstadt von Schleswig-Holstein? Antworte mit einem Wort.“
Prüfen: Die Antwort lautet „Kiel“. Das Gespräch erscheint links in der Liste und bleibt auch nach einem Neustart erhalten.
17. Fragen zu einem Dokument stellen
Klicke im Eingabefeld auf das Pluszeichen, wähle Datei(en) hochladen und lade eine Textdatei oder ein PDF hoch. Stelle danach eine Frage zum Inhalt. Open WebUI sucht die passenden Stellen im Dokument heraus und gibt sie dem Modell mit.
Prüfen: Die Antwort bezieht sich auf das Dokument und trägt eine Quellenangabe wie [1]. Im Test hat das Modell aus einer kurzen Datei mit Öffnungszeiten richtig herausgelesen, an welchen Tagen die Werkstatt Reparaturen annimmt.
Wie geht es weiter?
- Weitere Benutzer: Neue Konten bekommen zunächst den Status „ausstehend“ und müssen im Admin-Bereich freigeschaltet werden. Dort lässt sich die Registrierung auch ganz abschalten.
- Wissen: Im Arbeitsbereich fasst man mehrere Dokumente zu einer Wissenssammlung zusammen und bindet sie in jedem Chat mit
#ein. - Cloud-Anbieter: Im Admin-Bereich unter den Verbindungen lassen sich zusätzlich Dienste mit der Schnittstelle von OpenAI eintragen. Deren Modelle erscheinen dann neben denen von Ollama.
- Zugriff aus dem Netz: Soll die Oberfläche unter einer eigenen Domain erreichbar sein, schaltet man nginx mit HTTPS davor, wie bei den anderen Diensten dieses Buchs.
- Dokumentation: https://docs.openwebui.com
Aktualisieren
1. In den Programmordner wechseln
cd ~/open-webui
2. Neue Version installieren
-U holt die neueste Version. Datenbank und Dateien in data bleiben erhalten.
uv pip install -U open-webui --torch-backend cpu
3. Dienst neu starten
systemctl --user restart open-webui
Deinstallieren
1. Dienst beenden und ausschalten
systemctl --user disable --now open-webui
2. Dienstdatei löschen
rm ~/.config/systemd/user/open-webui.service
3. systemd neu einlesen lassen
Damit systemd den gelöschten Dienst vergisst.
systemctl --user daemon-reload
4. Programm und Daten entfernen
Löscht die virtuelle Umgebung, den Schlüssel und alle Daten, also auch Konten, Gespräche und hochgeladene Dateien.
rm -rf ~/open-webui
5. Modell für die Dokumentensuche entfernen
Löscht den Zwischenspeicher von Hugging Face. Verwendest du andere Programme, die Modelle von Hugging Face laden, lösche stattdessen nur den Unterordner hub/models--sentence-transformers--all-MiniLM-L6-v2.
rm -rf ~/.cache/huggingface
6. Zwischenspeicher von uv leeren
uv hebt heruntergeladene Pakete auf. Der Befehl leert den ganzen Speicher, also auch den anderer Projekte, die uv verwenden.
uv cache clean
7. Python 3.12 von uv entfernen (optional)
Nur ausführen, wenn kein anderes Projekt das Python 3.12 von uv braucht. Das Python von Ubuntu bleibt unberührt.
uv python uninstall 3.12
8. uv entfernen (optional)
Nur ausführen, wenn uv nicht mehr gebraucht wird, z. B. für CrewAI oder Microsoft GraphRAG.
pipx uninstall uv
Prüfen: Der Befehl uv wird nicht mehr gefunden.
uv --version
9. pipx entfernen (optional)
Nur ausführen, wenn keine anderen Programme mit pipx installiert sind. pipx list zeigt sie an.
sudo apt purge pipx
10. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt Pakete, die nur für pipx mitinstalliert wurden. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove
11. Dauerbetrieb zurücknehmen (falls in Schritt 13 eingeschaltet)
sudo loginctl disable-linger $USER
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.openwebui.com/
- Lizenz: Open WebUI steht unter der MIT.
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.
Qdrant
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Qdrant ist eine Vektordatenbank. Sie speichert Vektoren, etwa Embeddings von Texten oder Bildern, zusammen mit beliebigen Zusatzdaten und findet in Millisekunden die Einträge, die einem Suchvektor am ähnlichsten sind. Damit ist sie ein typischer Baustein für semantische Suche und RAG-Anwendungen (Sprachmodelle, die in eigenen Dokumenten nachschlagen).
Vorbemerkungen
- Kein apt-Paket und kein offizielles Snap: Qdrant ist nicht in den Ubuntu-Paketquellen enthalten. Die Entwickler veröffentlichen aber auf GitHub ein fertiges
.deb-Paket, das diese Anleitung mitaptinstalliert. - Das Paket ist schlicht: Es enthält nur das Programm
/usr/bin/qdrant, eine Einstellungsdatei und die Weboberfläche. Einen Systembenutzer und einen systemd-Dienst legt es nicht an. Das erledigst du in den Schritten 7 bis 12. - Version: Die Befehle verwenden Version 1.19.1. Ist eine neuere Version erschienen, ersetzt du in den Befehlen die Versionsnummer und die Prüfsumme. Beides steht auf https://github.com/qdrant/qdrant/releases/latest.
- Nur lokal erreichbar: Ohne weitere Einstellung lauscht Qdrant auf allen Netzwerkschnittstellen, ohne Passwort. Diese Anleitung beschränkt es auf den eigenen Rechner (
127.0.0.1) und schaltet die anonyme Nutzungsstatistik ab, die Qdrant sonst an die Hersteller sendet. - Alternative: Wer Vektoren direkt neben seinen übrigen Daten ablegen möchte, kann auch PostgreSQL mit pgvector verwenden. Qdrant ist dagegen auf Vektorsuche spezialisiert und bringt eigene Filter, eine Weboberfläche und Werkzeuge zum Skalieren mit.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt das Paket herunter, mit curl sprichst du später die Datenbank an. Beide sind meist schon vorhanden.
sudo apt install wget curl
3. In den Download-Ordner wechseln
Das Paket wird hier abgelegt.
cd ~/Downloads
4. Paket herunterladen
Lädt das offizielle .deb-Paket für 64-Bit-PCs (amd64) herunter, etwa 25 MB.
wget https://github.com/qdrant/qdrant/releases/download/v1.19.1/qdrant_1.19.1-1_amd64.deb
5. Paket prüfen
Vergleicht die Prüfsumme der heruntergeladenen Datei mit dem Wert, den GitHub auf der Release-Seite neben der Datei anzeigt (sha256:…). So erkennst du, ob die Datei vollständig und unverändert angekommen ist.
echo "858dda511c5c05bb5ceb19d7f79669c1e13a64390df205eee6f33b929a0a9a84 qdrant_1.19.1-1_amd64.deb" | sha256sum -c
Prüfen: Die Ausgabe lautet qdrant_1.19.1-1_amd64.deb: OK. Bei FEHLSCHLAG bzw. FAILED löschst du die Datei und lädst sie erneut herunter.
6. Qdrant installieren
Installiert das Paket. Das ./ vor dem Dateinamen sagt apt, dass es eine lokale Datei installieren soll.
sudo apt install ./qdrant_1.19.1-1_amd64.deb
Prüfen: Die Ausgabe lautet qdrant 1.19.1.
qdrant --version
Die heruntergeladene Datei kannst du danach löschen:
rm qdrant_1.19.1-1_amd64.deb
Als Dienst einrichten
7. Systembenutzer anlegen
Qdrant soll nicht mit Administratorrechten laufen, sondern als eigener Benutzer qdrant ohne Anmeldemöglichkeit. --system legt einen Benutzer für Dienste an, --home-dir setzt sein Verzeichnis auf den Datenordner.
sudo useradd --system --home-dir /var/lib/qdrant --shell /usr/sbin/nologin qdrant
8. Datenordner übergeben
Der Benutzer qdrant muss in /var/lib/qdrant schreiben dürfen. Dort legt Qdrant die Unterordner storage (Daten) und snapshots (Sicherungen) an. Die Weboberfläche liegt ebenfalls hier, im Ordner static.
sudo chown -R qdrant:qdrant /var/lib/qdrant
9. systemd-Dienst anlegen
Die Dienstdatei sorgt dafür, dass systemd Qdrant startet, beim Systemstart automatisch hochfährt und nach einem Absturz neu startet. Die wichtigsten Angaben:
User,Group– Qdrant läuft als BenutzerqdrantExecStart– startet Qdrant mit der Einstellungsdatei aus dem PaketQDRANT__SERVICE__HOST=127.0.0.1– nur vom eigenen Rechner aus erreichbarQDRANT__TELEMETRY_DISABLED=true– keine Nutzungsstatistik an die HerstellerLimitNOFILE– erlaubt viele gleichzeitig geöffnete Dateien, die Qdrant bei vielen Daten braucht
Umgebungsvariablen, die mit QDRANT__ beginnen, überschreiben Einstellungen aus der Datei. So bleibt /etc/qdrant/config.yaml unverändert und wird bei Updates nicht zum Konflikt.
sudo nano /etc/systemd/system/qdrant.service
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Unit]
Description=Qdrant Vektordatenbank
After=network.target
[Service]
User=qdrant
Group=qdrant
WorkingDirectory=/var/lib/qdrant
ExecStart=/usr/bin/qdrant --config-path /etc/qdrant/config.yaml
Environment=QDRANT__SERVICE__HOST=127.0.0.1
Environment=QDRANT__TELEMETRY_DISABLED=true
Restart=on-failure
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
10. systemd die neue Datei bekannt machen
systemd liest neue oder geänderte Dienstdateien erst nach diesem Befehl ein.
sudo systemctl daemon-reload
11. Dienst starten und Autostart einschalten
enable sorgt für den Start bei jedem Hochfahren, --now startet den Dienst zusätzlich sofort.
sudo systemctl enable --now qdrant
Prüfen: In der Ausgabe steht Active: active (running). Mit q verlässt du die Anzeige.
systemctl status qdrant
12. Adresse und Telemetrie prüfen
Zeigt die Startmeldungen des Dienstes. Die zwei Warnungen Config file not found: config/… sind harmlos: Qdrant sucht zusätzlich nach Einstellungsdateien im Arbeitsordner, die es hier nicht gibt.
sudo journalctl -u qdrant --no-pager | grep -E "Telemetry|listening on:"
Prüfen: Die Ausgabe enthält Telemetry reporting disabled und listening on: 127.0.0.1:6333.
Erste Schritte
Qdrant wird über eine REST-Schnittstelle auf Port 6333 angesprochen (und über gRPC auf Port 6334 für schnelle Programmanbindungen). Die folgenden Schritte verwenden curl und das gleiche Beispiel wie die pgvector-Anleitung: drei Einträge mit kleinen Vektoren aus drei Zahlen. Echte Embeddings haben meist mehrere hundert Zahlen.
13. Verbindung testen
Fragt Name und Version des Servers ab.
curl -s http://localhost:6333/
Prüfen: Die Antwort enthält "version":"1.19.1".
14. Sammlung anlegen
Eine Sammlung (Collection) entspricht einer Tabelle. Beim Anlegen legst du fest, wie viele Zahlen jeder Vektor hat (size) und wie Ähnlichkeit gemessen wird (distance). Cosine vergleicht die Richtung der Vektoren, das ist für Text-Embeddings üblich.
curl -s -X PUT http://localhost:6333/collections/notizen -H 'Content-Type: application/json' -d '{"vectors": {"size": 3, "distance": "Cosine"}}'
Prüfen: Die Antwort lautet {"result":true,"status":"ok",…}.
15. Einträge einfügen
Ein Eintrag heißt in Qdrant Punkt (Point). Er besteht aus einer id, dem Vektor und einer frei gestaltbaren Payload mit Zusatzdaten im JSON-Format. wait=true wartet, bis die Daten gespeichert sind.
curl -s -X PUT 'http://localhost:6333/collections/notizen/points?wait=true' -H 'Content-Type: application/json' -d '{
"points": [
{"id": 1, "vector": [1, 0, 0], "payload": {"text": "Apfel", "art": "obst"}},
{"id": 2, "vector": [0.9, 0.1, 0], "payload": {"text": "Birne", "art": "obst"}},
{"id": 3, "vector": [0, 0, 1], "payload": {"text": "Auto", "art": "fahrzeug"}}
]
}'
Prüfen: Die Antwort enthält "status":"completed".
16. Ähnlichkeitssuche
Sucht die zwei Punkte, die dem Suchvektor am ähnlichsten sind. score gibt die Ähnlichkeit an: Je näher an 1, desto ähnlicher. with_payload liefert die Zusatzdaten mit.
curl -s -X POST http://localhost:6333/collections/notizen/points/query -H 'Content-Type: application/json' -d '{"query": [1, 0.05, 0], "limit": 2, "with_payload": true}'
Prüfen: Die Antwort enthält zuerst Apfel, dann Birne, beide mit einem score knapp unter 1. Auto fehlt, weil es nicht ähnlich ist.
17. Suche mit Filter
Eine Stärke von Qdrant: Suche und Filter auf die Payload lassen sich kombinieren. Dieselbe Suche wie oben, aber nur unter Einträgen mit art = fahrzeug.
curl -s -X POST http://localhost:6333/collections/notizen/points/query -H 'Content-Type: application/json' -d '{"query": [1, 0.05, 0], "limit": 2, "with_payload": true, "filter": {"must": [{"key": "art", "match": {"value": "fahrzeug"}}]}}'
Prüfen: Die Antwort enthält nur noch Auto, obwohl es dem Suchvektor gar nicht ähnlich ist. Der Filter wird zuerst angewendet.
18. Weboberfläche öffnen
Qdrant bringt eine Weboberfläche mit. Dort siehst du Sammlungen und Punkte, kannst Vektoren grafisch darstellen und Anfragen in einer Konsole ausprobieren.
Prüfen: http://localhost:6333/dashboard zeigt die Sammlung notizen mit 3 Punkten.
19. Beispiel-Sammlung löschen
Entfernt die Sammlung samt aller Punkte wieder.
curl -s -X DELETE http://localhost:6333/collections/notizen
Aus Programmen verwenden
Für viele Sprachen gibt es offizielle Client-Bibliotheken, z. B. qdrant-client für Python (mit pip in einer virtuellen Umgebung, siehe LangGraph-Anleitung) oder @qdrant/js-client-rest für JavaScript. LangChain bindet Qdrant über das Paket langchain-qdrant als Vektorspeicher an.
Optional: Zugriff mit API-Schlüssel schützen
Auf einem Entwicklungsrechner, auf dem nur du arbeitest, reicht die Beschränkung auf 127.0.0.1. Nutzen weitere Personen den Rechner, kannst du einen Schlüssel verlangen. Dazu ergänzt du in der Dienstdatei aus Schritt 9 im Abschnitt [Service] eine Zeile wie Environment=QDRANT__SERVICE__API_KEY=ein-langes-geheimes-wort und wiederholst die Schritte 10 und 11 (bei laufendem Dienst: sudo systemctl restart qdrant). Anfragen müssen den Schlüssel dann im Kopf api-key mitschicken, z. B. curl -H 'api-key: ein-langes-geheimes-wort' ….
Aktualisieren
Das Paket stammt nicht aus einem Paketarchiv, deshalb aktualisiert sudo apt upgrade Qdrant nicht. Für eine neue Version wiederholst du die Schritte 3 bis 6 mit neuer Versionsnummer und Prüfsumme und startest danach den Dienst neu:
sudo systemctl restart qdrant
Deine Daten in /var/lib/qdrant/storage bleiben dabei erhalten. Lies vorher die Versionshinweise: Qdrant unterstützt Updates nur schrittweise über jeweils eine Nebenversion (z. B. von 1.18 auf 1.19, nicht direkt von 1.17 auf 1.19).
Deinstallieren
1. Dienst stoppen und Autostart ausschalten
Beendet Qdrant und verhindert den Start beim Hochfahren.
sudo systemctl disable --now qdrant
2. Dienstdatei löschen
Entfernt die Datei aus Schritt 9.
sudo rm /etc/systemd/system/qdrant.service
3. systemd neu einlesen
Damit systemd den gelöschten Dienst vergisst.
sudo systemctl daemon-reload
4. Qdrant entfernen
purge entfernt das Programm, die Weboberfläche und die Einstellungsdatei /etc/qdrant/config.yaml.
sudo apt purge qdrant
5. Daten löschen
Achtung: Löscht alle Sammlungen, Punkte und Sicherungen endgültig.
sudo rm -rf /var/lib/qdrant
6. Systembenutzer löschen
Entfernt den Benutzer qdrant aus Schritt 7.
sudo userdel qdrant
Prüfen: Der Befehl wird nicht mehr gefunden.
qdrant --version
Quellen und Lizenz
- Offizielle Dokumentation: https://qdrant.tech/documentation/
- Lizenz: Qdrant steht unter der Apache-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.
Milvus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Milvus ist eine quelloffene Vektordatenbank. Sie speichert Vektoren, etwa Embeddings von Texten oder Bildern, zusammen mit weiteren Feldern und findet die Einträge, die einem Suchvektor am ähnlichsten sind. Milvus ist für sehr große Datenmengen gebaut und wird oft für semantische Suche und RAG-Anwendungen eingesetzt.
Vorbemerkungen
-
Welche Variante? Milvus gibt es in mehreren Formen:
Variante Beschreibung In dieser Anleitung Milvus Lite Offizielle, schlanke Ausgabe für Python. Läuft im eigenen Programm oder als kleiner Server, die Daten liegen in einem Ordner. ja Milvus Standalone / Distributed Vollständiger Server für große Datenmengen. Wird offiziell über Docker oder Kubernetes betrieben. nein .deb-Paket von Milvus StandaloneGab es auf GitHub, zuletzt für Version 2.6.18 (Juni 2026). Neuere Versionen erscheinen nicht mehr als Paket. Der Dienst läuft außerdem als rootund ist ohne Anpassung aus dem Netz erreichbar.nein Diese Anleitung verwendet Milvus Lite. Es ist aktuell, braucht weder Docker noch Administratorrechte und ist für Entwicklung, Tests und Datenmengen bis etwa eine Million Vektoren gedacht.
-
Gleiche Schnittstelle: Programme sprechen Milvus Lite und den großen Milvus-Server mit derselben Python-Bibliothek
pymilvusan. Für den Umstieg reicht es, beim Verbinden statt eines Ordnernamens die Adresse des Servers anzugeben. Nicht alle Funktionen des großen Servers stehen in Milvus Lite zur Verfügung. -
Installation über pip: Milvus Lite ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung (venv) installiert, also in einen eigenen Ordner nur für dieses Projekt. -
Versionen: pymilvus 3.0 und Milvus Lite 3.2 unter Python 3.14.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des Pakets für virtuelle Umgebungen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Ist es schon vorhanden (z. B. aus der LangGraph-Anleitung), meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
Ein eigener Ordner für die Beispiele.
mkdir ~/milvus-test
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/milvus-test
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Sorgt dafür, dass python und pip in diesem Terminal die Umgebung verwenden. Das musst du in jedem neuen Terminal wiederholen.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. pymilvus mit Milvus Lite installieren
Installiert die Python-Bibliothek pymilvus. Der Zusatz [milvus-lite] holt Milvus Lite gleich mit. Die Anführungszeichen verhindern, dass die Shell die eckigen Klammern selbst auswertet.
pip install -U "pymilvus[milvus-lite]"
Prüfen: Die Liste zeigt milvus-lite und pymilvus mit ihren Versionen, z. B. 3.2.1 und 3.0.2.
pip list | grep -i milvus
Erstes Beispiel
8. Beispielprogramm anlegen
Das Programm verwendet dasselbe Beispiel wie die Anleitungen zu pgvector und Qdrant: drei Einträge mit kleinen Vektoren aus drei Zahlen. Echte Embeddings haben meist mehrere hundert Zahlen. Die wichtigsten Befehle:
MilvusClient("notizen.db")– öffnet die Datenbank im Ordnernotizen.dbund legt ihn beim ersten Mal ancreate_collection– legt eine Sammlung an (entspricht einer Tabelle).dimensionist die Anzahl der Zahlen pro Vektor,metric_type="COSINE"misst Ähnlichkeit über die Richtung der Vektoren.insert– fügt Einträge ein. Nebenidundvectorsind beliebige weitere Felder erlaubt.search– sucht die ähnlichsten Einträge.filterschränkt die Suche mit einer Bedingung auf die Felder ein,output_fieldslegt fest, welche Felder zurückkommen.
nano milvus_demo.py
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from pymilvus import MilvusClient
# Milvus Lite: Die ganze Datenbank steckt in diesem einen Ordner
client = MilvusClient("notizen.db")
# Sammlung neu anlegen: Vektoren mit 3 Zahlen, Ähnlichkeit per Kosinus
if client.has_collection("notizen"):
client.drop_collection("notizen")
client.create_collection("notizen", dimension=3, metric_type="COSINE")
# Einträge einfügen: id, Vektor und beliebige weitere Felder
client.insert("notizen", [
{"id": 1, "vector": [1, 0, 0], "text": "Apfel", "art": "obst"},
{"id": 2, "vector": [0.9, 0.1, 0], "text": "Birne", "art": "obst"},
{"id": 3, "vector": [0, 0, 1], "text": "Auto", "art": "fahrzeug"},
])
# Ähnlichkeitssuche: die zwei ähnlichsten Einträge
treffer = client.search("notizen", data=[[1, 0.05, 0]], limit=2, output_fields=["text"])
for t in treffer[0]:
print("Suche:", t["entity"]["text"], round(t["distance"], 4))
# Suche mit Filter auf ein Feld
treffer = client.search("notizen", data=[[1, 0.05, 0]], limit=2,
filter='art == "fahrzeug"', output_fields=["text"])
for t in treffer[0]:
print("Mit Filter:", t["entity"]["text"], round(t["distance"], 4))
print("Anzahl:", client.get_collection_stats("notizen")["row_count"])
client.close()
9. Beispiel ausführen
Startet das Programm in der virtuellen Umgebung.
python milvus_demo.py
Prüfen: Die Ausgabe lautet:
Suche: Apfel 0.9988
Suche: Birne 0.9982
Mit Filter: Auto 0.0
Anzahl: 3
Beim Kosinus-Maß bedeutet ein Wert nahe 1 „sehr ähnlich“. Mit dem Filter bleibt nur Auto übrig, obwohl es dem Suchvektor gar nicht ähnlich ist (Wert 0): Der Filter wird zuerst angewendet.
10. Datenordner ansehen
Milvus Lite speichert alles im Ordner notizen.db. Um die Datenbank zu sichern oder weiterzugeben, kopierst du diesen Ordner, während kein Programm darauf zugreift.
ls notizen.db
Prüfen: Es werden LOCK, collections und databases angezeigt. LOCK verhindert, dass zwei Programme gleichzeitig in denselben Ordner schreiben.
Optional: Milvus Lite als Server
Im ersten Beispiel läuft die Datenbank im Programm selbst, und nur dieses Programm kann auf sie zugreifen. Sollen mehrere Programme gleichzeitig dieselben Daten nutzen, startest du Milvus Lite als kleinen Server. Programme verbinden sich dann über das Netzwerkprotokoll gRPC auf Port 19530, genau wie mit einem großen Milvus-Server.
11. Server starten
--data-dir legt den Datenordner fest. --host 127.0.0.1 ist wichtig: Ohne diese Angabe wäre der Server aus dem ganzen Netz erreichbar, ohne Passwort. Der Server läuft im Vordergrund, das Terminal bleibt dabei belegt.
milvus-lite server --data-dir ~/milvus-test/serverdaten --host 127.0.0.1
12. Zweites Terminal vorbereiten
Öffne ein zweites Terminal, wechsle in den Projektordner und aktiviere dort ebenfalls die virtuelle Umgebung.
cd ~/milvus-test && source .venv/bin/activate
13. Beispiel auf den Server umstellen
Erstellt eine Kopie des Beispielprogramms, die sich statt mit dem Ordner notizen.db mit dem Server verbindet. Das ist die einzige Änderung, der übrige Code bleibt gleich.
cp milvus_demo.py milvus_server_demo.py
nano milvus_server_demo.py
Suche mit Strg+W nach MilvusClient( und drücke Enter. Die Zeile lautet client = MilvusClient("notizen.db"). Ändere die gefundene Zeile so, dass sie lautet:
client = MilvusClient("http://127.0.0.1:19530")
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Beispiel gegen den Server ausführen
Startet die Kopie. Sie legt die Sammlung jetzt im Server an.
python milvus_server_demo.py
Prüfen: Die Ausgabe ist dieselbe wie in Schritt 9. Im Ordner ~/milvus-test/serverdaten liegen jetzt die Daten des Servers.
15. Server beenden
Wechsle in das erste Terminal und drücke Strg+C. Die Daten bleiben im Ordner serverdaten erhalten und stehen beim nächsten Start wieder zur Verfügung.
Wie geht es weiter?
- Mit LangChain: Das Paket
langchain-milvusbindet Milvus als Vektorspeicher an, siehe LangGraph und LangChain. - Umzug auf einen großen Milvus-Server:
milvus-lite dumpschreibt eine Sammlung in JSON-Dateien, die ein vollständiger Milvus-Server einlesen kann, z. B.milvus-lite dump -d notizen.db -c notizen -p ./export. Dafür brauchst du einmalig den Zusatzpip install "pymilvus[bulk_writer]". - Vergleich: Für kleinere Projekte ohne Python-Bindung ist Qdrant als eigenständiger Dienst oft einfacher. Liegen die übrigen Daten ohnehin in PostgreSQL, reicht häufig pgvector.
Aktualisieren
Milvus Lite wird pro Projekt aktualisiert. In der aktivierten virtuellen Umgebung holt dieser Befehl die neuesten Versionen:
pip install -U "pymilvus[milvus-lite]"
Sichere vorher den Datenordner und lies bei einem Sprung der Hauptversion (z. B. von 3 auf 4) die Versionshinweise von Milvus Lite.
Deinstallieren
1. Virtuelle Umgebung verlassen
Schaltet das Terminal zurück auf das Python des Systems. (.venv) verschwindet aus der Eingabeaufforderung.
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung, Beispielprogrammen und beiden Datenordnern. Achtung: Alle darin gespeicherten Sammlungen gehen verloren. Außerhalb dieses Ordners hat pip nichts installiert.
rm -rf ~/milvus-test
3. Zwischenspeicher von pip leeren (optional)
pip hebt heruntergeladene Pakete in einem Zwischenspeicher auf, um spätere Installationen zu beschleunigen.
rm -rf ~/.cache/pip
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/milvus-test
Quellen und Lizenz
- Offizielle Dokumentation: https://milvus.io/docs
- Lizenz: Milvus steht unter der Apache-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.
Chroma
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Chroma ist eine Vektordatenbank für Python, die man ohne eigenen Server direkt im Programm verwenden kann. Man gibt ihr Texte, sie berechnet daraus selbst die Vektoren (Embeddings) und findet später zu einer Frage die Texte mit der ähnlichsten Bedeutung. Damit ist sie ein einfacher Einstieg in semantische Suche und RAG-Anwendungen.
Vorbemerkungen
- Unterschied zu Qdrant und Milvus: Qdrant und Milvus laufen als eigener Dienst und erwarten fertige Vektoren. Chroma speichert seine Daten dagegen einfach in einem Ordner des Programms und rechnet Texte auf Wunsch selbst in Vektoren um. Bei Bedarf läuft es auch als Server.
- Eingebautes Einbettungsmodell: Ohne weitere Angaben verwendet Chroma das kleine Modell
all-MiniLM-L6-v2. Beim ersten Gebrauch lädt es das Modell herunter, rund 170 MB in~/.cache/chroma. Das Modell wurde mit englischen Texten trainiert. Beispiel 1 zeigt, dass es bei deutschen Texten oft danebenliegt. - Mehrsprachiges Modell über Ollama: Beispiel 2 verwendet deshalb das Einbettungsmodell
embeddinggemmaaus Ollama, das auch Deutsch versteht. Voraussetzung dafür ist ein laufendes Ollama. - Installation über pip: Chroma ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 450 MB. - Nutzungsdaten: Der Python-Teil von Chroma 1.5 enthält zwar noch eine Einstellung für anonyme Nutzungsstatistiken, die zugehörige Funktion sendet aber nichts mehr.
- Version: Getestet mit chromadb 1.5.9 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/chroma
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/chroma
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Chroma installieren
chromadb– die Datenbank samt Befehlchromafür den Serverbetriebollama– die Anbindung an Ollama, die Beispiel 2 für das Einbettungsmodell braucht
pip install chromadb ollama
Prüfen: Die Ausgabe nennt Version: 1.5.9 oder eine neuere Version.
pip show chromadb
Beispiel 1: Suche mit dem eingebauten Modell
8. Programm anlegen
Das Programm speichert fünf kurze Auskünfte eines Fahrradladens und sucht zu fünf Kundenfragen jeweils die passendste heraus.
nano suche.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import chromadb
# Daten im Unterordner "daten" speichern
client = chromadb.PersistentClient(path="daten")
sammlung = client.get_or_create_collection("laden")
sammlung.upsert(
ids=["werkstatt", "zeiten", "zahlung", "verleih", "kette"],
documents=[
"Die Werkstatt nimmt Reparaturen nur dienstags und donnerstags an.",
"Wir haben Montag bis Freitag von 9 bis 18 Uhr geöffnet, samstags von 10 bis 14 Uhr.",
"Bezahlen können Sie bar, mit Karte oder per Überweisung.",
"Lastenräder kann man bei uns für einen Tag ausleihen.",
"Die Kette sollte alle 500 Kilometer gereinigt und geölt werden.",
],
metadatas=[
{"thema": "werkstatt"},
{"thema": "laden"},
{"thema": "laden"},
{"thema": "verleih"},
{"thema": "werkstatt"},
],
)
fragen = [
"Wann kann ich mein Rad reparieren lassen?",
"Wie lange habt ihr am Samstag offen?",
"Kann ich mit Kreditkarte zahlen?",
"Ich brauche ein Rad für einen Umzug.",
"Meine Kette quietscht.",
]
for frage in fragen:
treffer = sammlung.query(query_texts=[frage], n_results=1)
print(f"{frage:45} -> {treffer['ids'][0][0]}")
# Suche nur in Einträgen mit dem Thema "werkstatt"
treffer = sammlung.query(query_texts=["Meine Kette quietscht."], n_results=2, where={"thema": "werkstatt"})
print("Mit Filter:", treffer["ids"][0])
PersistentClient(path="daten")– Chroma legt den Ordnerdatenan und speichert dort alles. Beim nächsten Start ist die Sammlung noch da.- Sammlung – entspricht einer Tabelle.
get_or_create_collectionöffnet sie oder legt sie beim ersten Mal an. upsert– fügt Einträge ein oder ersetzt sie, wenn es dieidsschon gibt. Deshalb entstehen keine doppelten Einträge, wenn du das Programm mehrmals startest. Zu jedem Text berechnet Chroma selbst den Vektor.metadatas– beliebige Zusatzangaben zu jedem Eintrag, nach denen sich filtern lässt.query– rechnet die Frage ebenfalls in einen Vektor um und liefert dien_resultsähnlichsten Einträge.wherebeschränkt die Suche auf Einträge mit passenden Zusatzangaben.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
Beim ersten Start lädt Chroma das Einbettungsmodell herunter und zeigt dabei einen Fortschrittsbalken.
python suche.py
Prüfen: Im Test kam heraus:
Wann kann ich mein Rad reparieren lassen? -> werkstatt
Wie lange habt ihr am Samstag offen? -> zeiten
Kann ich mit Kreditkarte zahlen? -> zahlung
Ich brauche ein Rad für einen Umzug. -> zahlung
Meine Kette quietscht. -> zahlung
Mit Filter: ['werkstatt', 'kette']
Drei Fragen sind richtig zugeordnet, zwei falsch. Das englische Modell erkennt zwischen „Umzug“ und „Lastenrad“ oder zwischen „quietscht“ und „geölt“ keinen Zusammenhang. Mit dem Filter kommen nur noch die beiden Einträge zum Thema werkstatt in Frage. Auch hier stuft das Modell die Kette aber nicht als besten Treffer ein. Beispiel 2 behebt das.
Beispiel 2: Mehrsprachiges Modell über Ollama
10. Einbettungsmodell laden
Lädt das Einbettungsmodell embeddinggemma (rund 620 MB) in Ollama. Es erzeugt nur Vektoren und kann nicht chatten.
ollama pull embeddinggemma
Prüfen: embeddinggemma:latest steht in der Liste.
ollama list
11. Programm anlegen
Das Programm verwendet dieselben Texte und Fragen, lässt die Vektoren aber von Ollama berechnen.
nano suche_ollama.py
Füge diesen Inhalt ein:
import chromadb
from chromadb.utils.embedding_functions import OllamaEmbeddingFunction
# Vektoren mit dem Modell embeddinggemma aus Ollama berechnen
einbettung = OllamaEmbeddingFunction(url="http://localhost:11434", model_name="embeddinggemma")
client = chromadb.PersistentClient(path="daten")
sammlung = client.get_or_create_collection("laden_ollama", embedding_function=einbettung)
sammlung.upsert(
ids=["werkstatt", "zeiten", "zahlung", "verleih", "kette"],
documents=[
"Die Werkstatt nimmt Reparaturen nur dienstags und donnerstags an.",
"Wir haben Montag bis Freitag von 9 bis 18 Uhr geöffnet, samstags von 10 bis 14 Uhr.",
"Bezahlen können Sie bar, mit Karte oder per Überweisung.",
"Lastenräder kann man bei uns für einen Tag ausleihen.",
"Die Kette sollte alle 500 Kilometer gereinigt und geölt werden.",
],
)
fragen = [
"Wann kann ich mein Rad reparieren lassen?",
"Wie lange habt ihr am Samstag offen?",
"Kann ich mit Kreditkarte zahlen?",
"Ich brauche ein Rad für einen Umzug.",
"Meine Kette quietscht.",
]
for frage in fragen:
treffer = sammlung.query(query_texts=[frage], n_results=1)
print(f"{frage:45} -> {treffer['ids'][0][0]}")
OllamaEmbeddingFunction– schickt jeden Text an Ollama und bekommt den Vektor zurück.- Eigene Sammlung – jede Sammlung gehört zu genau einem Einbettungsmodell, denn Vektoren verschiedener Modelle lassen sich nicht vergleichen. Deshalb heißt sie hier
laden_ollama. Chroma merkt sich das Modell der Sammlung und verwendet es auch für die Fragen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
python suche_ollama.py
Prüfen: Jetzt sind alle fünf Fragen richtig zugeordnet:
Wann kann ich mein Rad reparieren lassen? -> werkstatt
Wie lange habt ihr am Samstag offen? -> zeiten
Kann ich mit Kreditkarte zahlen? -> zahlung
Ich brauche ein Rad für einen Umzug. -> verleih
Meine Kette quietscht. -> kette
Chroma als Server
Sollen mehrere Programme oder Rechner dieselbe Datenbank verwenden, läuft Chroma als eigener Server. Die Programme verbinden sich dann über das Netz statt einen Ordner zu öffnen.
13. Server starten
Startet Chroma mit dem Datenordner server-daten auf Port 8000. Ohne weitere Angabe ist der Server nur vom eigenen Rechner aus erreichbar. Er läuft im Vordergrund, das Terminal bleibt also belegt.
chroma run --path ~/chroma/server-daten --port 8000
Prüfen: Unter dem Chroma-Logo steht Connect to Chroma at: http://localhost:8000.
14. Zweites Terminal öffnen
Öffne ein neues Terminal mit Strg+Alt+T. Die folgenden Schritte laufen dort.
15. Virtuelle Umgebung im zweiten Terminal aktivieren
cd ~/chroma && source .venv/bin/activate
16. Verbindung testen
heartbeat ist eine einfache Abfrage, mit der man prüft, ob der Server antwortet.
python -c "import chromadb; print(chromadb.HttpClient(host='localhost', port=8000).heartbeat())"
Prüfen: Eine lange Zahl erscheint, die aktuelle Uhrzeit des Servers in Nanosekunden.
Um die Beispiele mit dem Server zu verwenden, ersetzt du in ihnen nur die Zeile mit PersistentClient durch:
client = chromadb.HttpClient(host="localhost", port=8000)
Die Vektoren berechnet weiterhin das Programm, nicht der Server.
17. Server beenden
Wechsle in das erste Terminal und drücke dort Strg+C.
Wie geht es weiter?
- RAG: Die gefundenen Texte gibt man zusammen mit der Frage an ein Sprachmodell, das daraus eine Antwort formuliert. Frameworks wie LlamaIndex und LangChain bringen fertige Anbindungen an Chroma mit.
- Mehrere Treffer:
n_results=3liefert die drei ähnlichsten Einträge,treffer["distances"]den Abstand zur Frage. Je kleiner der Wert, desto ähnlicher. - Volltextsuche:
where_document={"$contains": "Kette"}findet nur Einträge, deren Text ein bestimmtes Wort enthält. - Dauerbetrieb: Für einen dauerhaft laufenden Server richtet man
chroma runwie bei Qdrant als systemd-Dienst ein. - Dokumentation: https://docs.trychroma.com
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und allen gespeicherten Sammlungen.
rm -rf ~/chroma
3. Eingebautes Einbettungsmodell entfernen
rm -rf ~/.cache/chroma
4. Einbettungsmodell aus Ollama entfernen
ollama rm embeddinggemma
5. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.trychroma.com/
- Lizenz: Chroma steht unter der Apache-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.
Hermes Agent
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Hermes Agent ist ein persönlicher KI-Agent von Nous Research, der im Terminal läuft. Anders als ein reiner Chat führt er selbst Befehle aus, liest und schreibt Dateien und legt sich aus erledigten Aufgaben eigene Anleitungen („Skills“) an, die er beim nächsten Mal wiederverwendet. Er merkt sich Wissen über mehrere Sitzungen hinweg, kann Aufgaben zeitgesteuert ausführen und ist auf Wunsch auch über Telegram, Discord und andere Dienste erreichbar.
Hinweis: nicht selbst getestet. Diese Anleitung beruht auf der offiziellen Dokumentation von Hermes Agent (Stand 27. September 2026). Installation und Bedienung von Hermes Agent selbst wurden für dieses Buch nicht ausprobiert. Selbst getestet sind nur die Vorbereitung von Ollama in den Schritten 8 bis 10 und das Herunterladen des Installationsskripts. Befehle und Ausgaben können daher von der Beschreibung abweichen.
Vorbemerkungen
- Was ein Agent darf: Hermes führt Befehle mit deinen Rechten aus. Er kann also alles, was du im Terminal auch kannst, auch Dateien löschen. Vor gefährlichen Befehlen fragt er nach (Schritt 13). Starte ihn für den Anfang in einem eigenen Übungsordner und bestätige nur Befehle, die du verstehst.
- Keine Pakete von Ubuntu: Hermes Agent gibt es weder als apt-Paket noch als Snap. Auf PyPI liegt nur die ältere Version 0.19.0 vom Juli 2026, die Python unter 3.14 verlangt. Ubuntu 26.04 hat aber Python 3.14, und das Projekt veröffentlicht inzwischen Versionen nach Datum (zuletzt v2026.9.24). Der Hersteller empfiehlt deshalb sein Installationsskript. Es braucht kein
sudound installiert alles für deinen Benutzer: den Code nach~/.hermes/hermes-agent, Einstellungen und Daten nach~/.hermesund den Befehlhermesnach~/.local/bin. Python, Node.js und weitere Werkzeuge bringt es in eigenen Versionen mit. - Sprachmodell: Hermes braucht ein großes Sprachmodell (LLM). Diese Anleitung verwendet ein lokales Modell über Ollama. Dann verlassen keine Daten den Rechner und es fallen keine Kosten an. Alternativ lässt sich Hermes mit kostenpflichtigen Anbietern wie OpenRouter, OpenAI, Anthropic oder dem Abo „Nous Portal“ des Herstellers verbinden.
- Leistung lokaler Modelle: Ein Agent braucht viel Kontext. Hermes verlangt mindestens 64 000 Tokens. Im Test belegte
qwen3:4b-instructmit diesem Kontext rund 12 GB Arbeitsspeicher statt 2,5 GB und lief bei 8 GB Grafikspeicher größtenteils auf dem Prozessor. Kleine Modelle verstehen Aufgaben außerdem schlechter als große. Die Hersteller-Doku empfiehlt für ernsthafte Arbeit Modelle wiegemma4:31b(rund 20 GB, 24 GB Arbeitsspeicher oder mehr). - Ähnliche Programme: Das bekannteste vergleichbare Projekt ist OpenClaw. Hermes kann dessen Einstellungen mit
hermes claw migrateübernehmen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Voraussetzungen installieren
Das Installationsskript braucht Git, curl und tar. Sind sie schon vorhanden, meldet apt das nur.
sudo apt install git curl tar
3. Installationsskript herunterladen
Speichert das Skript zuerst als Datei. So kannst du vor dem Ausführen nachsehen, was es tut, statt es ungesehen aus dem Internet zu starten.
curl -fsSL -o ~/hermes-install.sh https://hermes-agent.nousresearch.com/install.sh
4. Skript ansehen (optional)
Zeigt das Skript seitenweise an, mit Q beendest du die Anzeige. Wichtig: Es verwendet kein sudo. Es lädt das Werkzeug uv herunter und prüft dessen Prüfsumme, klont den Quellcode mit Git und legt die Ordner unter ~/.hermes an. Fehlt ~/.local/bin im Suchpfad, trägt es den Ordner in ~/.bashrc und ~/.profile ein.
less ~/hermes-install.sh
5. Skript ausführen
--skip-browser lässt die Browser-Werkzeuge samt eigenem Chromium weg, mit denen der Agent Webseiten bedienen kann. Sie lassen sich später mit hermes pm install agent-browser nachinstallieren. --non-interactive überspringt den Einrichtungsassistenten am Ende, die Einrichtung folgt in Schritt 11.
bash ~/hermes-install.sh --skip-browser --non-interactive
Das Skript zeigt für jeden Schritt eine Statuszeile. Die ausführliche Ausgabe schreibt es nach ~/.hermes/logs/install.log. Schlägt ein Schritt fehl, nennt es die letzten Zeilen und den Pfad zu dieser Datei.
6. Skript löschen
Das Skript wird nicht mehr gebraucht.
rm ~/hermes-install.sh
7. Neues Terminal öffnen
Schließe das Terminal und öffne ein neues, damit die Shell den Befehl hermes findet.
Prüfen: Die Ausgabe nennt die Version von Hermes Agent.
hermes --version
Lokales Modell vorbereiten
Diese Schritte setzen ein laufendes Ollama mit dem Modell qwen3:4b-instruct voraus. Sie wurden selbst getestet.
8. Modelldatei anlegen
Ollama verwendet ohne Angabe einen kleinen Kontext. Eine Modelldatei legt eine Variante mit 64 000 Tokens an. Sie verweist nur auf das vorhandene Modell, belegt also keinen zusätzlichen Platz auf der Festplatte.
nano ~/Modelfile-agent
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V):
FROM qwen3:4b-instruct
PARAMETER num_ctx 65536
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Modellvariante erzeugen
Erzeugt die Variante qwen3-agent.
ollama create qwen3-agent -f ~/Modelfile-agent
Prüfen: Die Ausgabe endet mit success. In der Liste der Modelle steht jetzt qwen3-agent:latest.
ollama list
10. Schnittstelle prüfen
Hermes spricht Ollama über dessen OpenAI-kompatible Schnittstelle unter http://localhost:11434/v1 an. Dieser Aufruf schickt eine Testfrage dorthin.
curl http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model": "qwen3-agent", "messages": [{"role": "user", "content": "Antworte nur mit: Hallo"}]}'
Prüfen: Die Antwort ist JSON und enthält "content":"Hallo". ollama ps zeigt danach unter CONTEXT den Wert 65536 und unter SIZE, wie viel Speicher das Modell jetzt belegt.
Hermes einrichten
11. Modell auswählen
hermes model führt durch die Auswahl des Anbieters und schreibt das Ergebnis nach ~/.hermes/config.yaml.
hermes model
Wähle als Anbieter Custom Endpoint und gib ein:
- Base URL:
http://localhost:11434/v1 - API Key: leer lassen oder
no-keyeingeben, Ollama braucht keinen - Model:
qwen3-agent
Laut Doku kann man stattdessen auch den Abschnitt model: in ~/.hermes/config.yaml mit nano so einstellen:
model:
default: "qwen3-agent"
provider: "custom"
base_url: "http://localhost:11434/v1"
12. Einrichtung prüfen
hermes doctor prüft Einstellungen und Abhängigkeiten und nennt gefundene Probleme mit einem Vorschlag zur Behebung.
hermes doctor
Erste Schritte
13. Übungsordner anlegen und Hermes starten
Ein eigener Ordner, in dem der Agent Dateien anlegen darf.
mkdir ~/hermes-uebung
cd ~/hermes-uebung
hermes
Hermes zeigt eine Oberfläche im Terminal mit Eingabezeile. Probiere z. B.:
Lege eine Datei notizen.md mit drei Tipps zum Arbeiten im Terminal an.
Zeige mir, welche Dateien in diesem Ordner liegen und wie groß sie sind.
Der Agent entscheidet selbst, welche Werkzeuge er braucht, und zeigt jeden Befehl, den er ausführt. Mit einem kleinen lokalen Modell dauern Antworten spürbar länger als mit großen Modellen im Netz.
Nachfragen bei gefährlichen Befehlen: In der Voreinstellung (approvals.mode: smart) bewertet Hermes Befehle vor dem Ausführen. Harmlose führt er aus, eindeutig gefährliche lehnt er ab, und bei unklaren fragt er dich. Lies die Nachfrage und bestätige nur, was du verstehst. Der „YOLO-Modus“ (hermes --yolo oder /yolo) schaltet alle Nachfragen ab und ist nur für Wegwerf-Umgebungen gedacht.
14. Befehle in der Sitzung
Befehle mit Schrägstrich steuern die Sitzung:
| Befehl | Wirkung |
|---|---|
/help | Alle Befehle anzeigen |
/model | Modell anzeigen oder wechseln |
/new | Neue Unterhaltung beginnen |
/quit | Hermes beenden (auch /exit) |
Mehrzeilige Eingaben entstehen mit Alt+Enter oder Strg+J.
15. Einzelne Frage ohne Sitzung
hermes -z beantwortet eine einzelne Aufgabe und gibt nur die Antwort aus. Das eignet sich für Skripte.
hermes -z "Welche Hauptstadt hat Frankreich? Antworte mit einem Wort."
Wie geht es weiter?
- Werkzeuge wählen:
hermes toolslegt fest, welche Werkzeuge der Agent verwenden darf, etwa Terminal, Dateien, Websuche oder Browser. - Messenger:
hermes gateway setupverbindet Hermes mit Telegram, Discord, Slack, Signal und anderen Diensten. Lege dabei unbedingt fest, welche Benutzer mit dem Agenten sprechen dürfen, sonst kann jeder, der den Bot findet, Befehle auf deinem Rechner auslösen. - Zeitgesteuerte Aufgaben: Hermes hat eine eingebaute Zeitsteuerung. Aufgaben wie „fasse mir jeden Morgen die neuen Dateien im Ordner zusammen“ beschreibt man in normaler Sprache.
- Sandbox: Statt direkt auf dem Rechner kann Hermes Befehle auch per SSH auf einem anderen Rechner oder in abgeschotteten Umgebungen ausführen. Die Doku beschreibt das unter „terminal backends“.
- Dokumentation: https://hermes-agent.nousresearch.com/docs/
Aktualisieren
Hermes aktualisiert sich über seinen eigenen Befehl, nicht über apt. Vor dem Update sichert er seine wichtigsten Einstellungen.
hermes update
Deinstallieren
1. Messenger-Dienst beenden
Nur nötig, wenn du Hermes mit einem Messenger verbunden hast.
hermes gateway stop
2. Entfernen ansehen
--dry-run zeigt nur, was entfernt würde, ohne etwas zu löschen.
hermes uninstall --dry-run
3. Hermes entfernen
--full entfernt auch Einstellungen, Erinnerungen, Skills und Sitzungen in ~/.hermes. Ohne --full bleiben diese Daten für eine spätere Neuinstallation erhalten. Achtung: Mit --full gehen alle Daten des Agenten verloren. hermes backup sichert sie vorher.
hermes uninstall --full
Laut Doku geht es auch von Hand:
rm -f ~/.local/bin/hermes
rm -rf ~/.hermes
4. Übungsordner und Modellvariante entfernen
Löscht den Übungsordner, die Modelldatei und die Modellvariante aus Schritt 9. Das Grundmodell qwen3:4b-instruct bleibt erhalten.
rm -rf ~/hermes-uebung ~/Modelfile-agent
ollama rm qwen3-agent
Prüfen: Die Shell meldet, dass der Befehl hermes nicht gefunden wurde.
hermes --version
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.
OpenClaw
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
OpenClaw ist ein freier KI-Assistent, der auf dem eigenen Rechner läuft und Aufgaben selbst erledigt: Er führt Befehle aus, bearbeitet Dateien und nutzt Werkzeuge und Erweiterungen („Skills“). Erreichbar ist er über eine Oberfläche im Terminal, eine Weboberfläche und über Messenger wie Telegram, Signal, WhatsApp, Discord oder Slack. Zentrale Stelle ist das Gateway, ein Hintergrunddienst, der Sitzungen, Werkzeuge und Verbindungen verwaltet.
Hinweis: nicht selbst getestet. Diese Anleitung beruht auf der offiziellen Dokumentation von OpenClaw (Stand 27. September 2026). Installation und Bedienung von OpenClaw wurden für dieses Buch nicht ausprobiert. Selbst geprüft wurden nur das Herunterladen des Installationsskripts und dessen Inhalt. Befehle und Ausgaben können daher von der Beschreibung abweichen.
Vorbemerkungen
- Verhältnis zu Hermes Agent: Hermes Agent ist ein ähnliches Projekt. Beide sind persönliche Agenten mit Gedächtnis, Skills und Messenger-Anbindung. OpenClaw ist in TypeScript geschrieben und stellt das Gateway mit Weboberfläche und vielen Messengern in den Mittelpunkt. Hermes setzt stärker auf das Terminal und auf selbst gelernte Skills. Beide können Einstellungen des jeweils anderen übernehmen.
- Was ein Agent darf: Werkzeuge laufen ohne weitere Einstellung direkt auf dem Rechner, mit deinen Rechten. Nachrichten, die über Messenger hereinkommen, sind als nicht vertrauenswürdig zu behandeln. Unbekannte Absender müssen erst gekoppelt werden (Schritt 15).
- Node.js 24 nötig: OpenClaw braucht Node.js 24.16 oder neuer. Ubuntu 26.04 liefert nur Node.js 22, das Paket
nodejsausaptreicht also nicht. Das empfohlene Skriptinstall.shwürde unter Linux das Paketarchiv NodeSource einrichten und damit dasnodejsvon Ubuntu ersetzen. Diese Anleitung verwendet deshalb das zweite offizielle Skriptinstall-cli.sh. Es braucht kein root und legt ein eigenes Node.js und OpenClaw nur in~/.openclawab. Das System bleibt unverändert. - Sprachmodell: Diese Anleitung verbindet OpenClaw mit einem lokalen Modell über Ollama. Dann verlassen keine Daten den Rechner und es fallen keine Kosten an. Kleine lokale Modelle wie
qwen3:4b-instructverstehen Aufgaben aber deutlich schlechter als große. Alternativ nutzt OpenClaw Anbieter wie Anthropic, OpenAI oder OpenRouter mit eigenem, meist kostenpflichtigem Zugang. - Was OpenClaw ins Netz sendet: Laut Hersteller nur eine tägliche Prüfung auf neue Versionen. Anonyme Nutzungsstatistiken sind ab Werk aus. Schritt 17 schaltet auch die Versionsprüfung ab.
- Träger: OpenClaw gehört der gemeinnützigen OpenClaw Foundation, steht unter der MIT-Lizenz und hat keine Bezahlversion.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Voraussetzungen installieren
Das Installationsskript braucht curl und Git. Sind sie schon vorhanden, meldet apt das nur.
sudo apt install curl git
3. Installationsskript herunterladen
Speichert das Skript zuerst als Datei, statt es ungesehen aus dem Internet zu starten. --proto '=https' --tlsv1.2 erzwingt eine verschlüsselte Verbindung.
curl -fsSL --proto '=https' --tlsv1.2 -o ~/openclaw-install-cli.sh https://openclaw.ai/install-cli.sh
4. Skript ansehen (optional)
Zeigt das Skript seitenweise an, mit Q beendest du die Anzeige. Es lädt Node.js in einer festen Version nach ~/.openclaw/tools, prüft dessen Prüfsumme, installiert OpenClaw mit diesem Node.js nach ~/.openclaw und legt den Befehl ~/.openclaw/bin/openclaw an. sudo verwendet es nur, falls Git fehlt.
less ~/openclaw-install-cli.sh
5. Skript ausführen
Ohne weitere Angaben installiert das Skript die aktuelle Version und startet die Einrichtung noch nicht, die folgt in Schritt 10.
bash ~/openclaw-install-cli.sh
Prüfen: Gegen Ende steht eine Zeile OpenClaw installed (…) mit der Versionsnummer.
6. Skript löschen
Das Skript wird nicht mehr gebraucht.
rm ~/openclaw-install-cli.sh
7. Befehl in den Suchpfad aufnehmen
Das Skript legt den Befehl nach ~/.openclaw/bin, trägt diesen Ordner aber nicht in den Suchpfad ein.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an:
export PATH="$HOME/.openclaw/bin:$PATH"
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Öffne danach ein neues Terminal.
Prüfen: Die Ausgabe nennt die Version von OpenClaw.
openclaw --version
Mit Ollama verbinden
8. Modell prüfen
OpenClaw braucht ein Modell, das Werkzeuge aufrufen kann und mindestens 16 000 Tokens Kontext hat. qwen3:4b-instruct aus der Ollama-Anleitung erfüllt beides. Unter Capabilities muss tools stehen.
ollama show qwen3:4b-instruct
9. Modell laden
Die automatische Suche der Einrichtung berücksichtigt vor allem Modelle, die Ollama gerade im Speicher hat. Dieser Aufruf lädt das Modell mit einer kurzen Frage. Ollama behält es danach fünf Minuten im Speicher.
ollama run qwen3:4b-instruct "Antworte nur mit: bereit"
10. Einrichtung starten
openclaw onboard führt durch die Einrichtung. Zuerst zeigt es einen Hinweis zur Sicherheit, den du bestätigen musst.
openclaw onboard
Wähle als Anbieter Ollama und als Betriebsart Local only. Gib als Adresse http://127.0.0.1:11434 ein und wähle das Modell qwen3:4b-instruct. OpenClaw schickt vor dem Speichern eine echte Testanfrage an das Modell und legt den Arbeitsordner ~/.openclaw/workspace an.
Prüfen: Die Liste enthält qwen3:4b-instruct.
openclaw models list --provider ollama
Gateway und Oberflächen
11. Gateway als Dienst einrichten
Das Gateway soll im Hintergrund laufen. Dieser Befehl legt dafür einen systemd-Dienst für deinen Benutzer an. sudo ist nicht nötig.
openclaw gateway install
12. Gateway prüfen
openclaw gateway status
Prüfen: Die Ausgabe meldet, dass das Gateway läuft.
13. Weboberfläche öffnen
Öffnet die Control UI im Browser. Dort siehst du Sitzungen, Einstellungen und ein Chatfenster. Schicke eine erste Nachricht, z. B. Welche Dateien liegen in deinem Arbeitsordner?.
openclaw dashboard
14. Terminal-Oberfläche verwenden
openclaw ohne weitere Angaben öffnet eine Chat-Oberfläche im Terminal, die mit dem Gateway verbunden ist.
openclaw
Sicherheit
15. Messenger nur mit Kopplung
Wer OpenClaw über einen Messenger erreichbar macht (openclaw configure → Kanäle), sollte wissen: Unbekannte Absender bekommen in Direktnachrichten zunächst einen Kopplungscode. Erst wenn du ihn bestätigst (hier am Beispiel des Kanals telegram und des Codes 123456), reagiert der Agent auf sie:
openclaw pairing approve telegram 123456
Bestätige nur Personen, denen du erlaubst, auf deinem Rechner Befehle auszulösen.
16. Sicherheitsprüfung
openclaw doctor prüft Einstellungen, Dienst und Laufzeitumgebung und nennt Probleme. openclaw doctor --fix behebt, was sich automatisch beheben lässt.
openclaw doctor
Bevor du andere Benutzer anbindest oder das Gateway aus dem Netz erreichbar machst, lies die Seiten zu Sicherheit und Sandbox in der Doku: Mit einer Sandbox laufen Werkzeuge abgeschottet statt direkt auf dem Rechner.
17. Versionsprüfung abschalten (optional)
Schaltet die tägliche Anfrage nach neuen Versionen ab. Die Einstellung landet in ~/.openclaw/openclaw.json.
openclaw config set update.checkOnStart false
Wie geht es weiter?
- Einstellungen:
openclaw configureändert später Modell, Gateway, Kanäle, Plugins oder Skills. Die Einstellungen stehen in~/.openclaw/openclaw.json. Das Gateway übernimmt Änderungen an der Datei selbst. - Skills und Plugins: Erweiterungen gibt es im Verzeichnis ClawHub (https://clawhub.ai). Prüfe fremde Skills vor der Installation, denn sie laufen mit denselben Rechten wie der Agent.
- Umzug von Hermes:
openclaw onboard --import-from hermesübernimmt Einstellungen aus Hermes Agent. - Dokumentation: https://docs.openclaw.ai
Aktualisieren
OpenClaw aktualisiert sich über seinen eigenen Befehl, nicht über apt. Er erneuert auch den Gateway-Dienst und meldet Erfolg erst, wenn das Gateway danach wieder läuft.
openclaw update
openclaw update --dry-run zeigt vorher, was geschehen würde. Scheitert ein Update, hilft laut Doku, das Installationsskript aus den Schritten 3 bis 6 erneut auszuführen.
Deinstallieren
1. Entfernen ansehen
--dry-run zeigt nur, was entfernt würde. --all wählt Dienst, Einstellungen, Arbeitsordner und Programm.
openclaw uninstall --dry-run --all
2. OpenClaw entfernen
Entfernt den Gateway-Dienst, alle Einstellungen, den Arbeitsordner mit den Dateien des Agenten und das Programm. Achtung: Alle Daten des Agenten gehen dabei verloren.
openclaw uninstall --all
3. Restliche Dateien entfernen
Löscht, was von ~/.openclaw noch übrig ist, etwa das mitgebrachte Node.js.
rm -rf ~/.openclaw
4. Suchpfad-Eintrag entfernen
nano ~/.bashrc
Lösche die Zeile export PATH="$HOME/.openclaw/bin:$PATH": Cursor in die Zeile setzen und Strg+K drücken. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: In einem neuen Terminal meldet die Shell, dass der Befehl openclaw nicht gefunden wurde.
openclaw --version
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.
OpenAI Agents SDK
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das OpenAI Agents SDK ist eine schlanke Python-Bibliothek für KI-Agenten. Ein Agent besteht aus Anweisungen, einem Sprachmodell und Werkzeugen (normalen Python-Funktionen). Mehrere Agenten können sich Aufgaben übergeben (Handoffs). Den Ablauf – Modell fragen, Werkzeug ausführen, Ergebnis zurückgeben, bis eine Antwort feststeht – übernimmt das SDK.
Vorbemerkungen
- Nicht nur für OpenAI: Das SDK stammt von OpenAI, arbeitet aber mit jedem Dienst, der die Chat-Schnittstelle von OpenAI anbietet. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Installation über pip: Das SDK ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, einen eigenen Ordner nur für dieses Projekt (rund 100 MB). - Tracing abschalten: Das SDK zeichnet jeden Lauf auf und sendet diese „Traces“ ab Werk an OpenAI, um sie dort im Dashboard anzuzeigen. Die Beispiele schalten das mit
set_tracing_disabled(True)ab. - Version: Getestet mit openai-agents 0.22.3 und openai 3.19 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-openai
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-openai
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. SDK installieren
Installiert das SDK samt der Bibliothek openai, mit der es Modelle anspricht.
pip install openai-agents
Prüfen: Die Ausgabe nennt Version: 0.22.3 oder eine neuere Version.
pip show openai-agents
Beispiel 1: Ein Agent mit Werkzeug
8. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, Runner, function_tool, set_tracing_disabled
# Keine Ablaufdaten (Traces) an OpenAI senden
set_tracing_disabled(True)
# Ollama spricht dieselbe Schnittstelle wie OpenAI
ollama = AsyncOpenAI(base_url="http://localhost:11434/v1", api_key="ollama")
modell = OpenAIChatCompletionsModel(model="qwen3:4b-instruct", openai_client=ollama)
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
@function_tool
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
print(f" [Werkzeug] landeshauptstadt({bundesland!r})")
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
agent = Agent(
name="Erdkunde",
instructions="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
model=modell,
tools=[landeshauptstadt],
)
ergebnis = Runner.run_sync(agent, "Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?")
print(ergebnis.final_output)
- Modell:
AsyncOpenAIist der Client der OpenAI-Bibliothek. Mitbase_urlzeigt er auf Ollama. Ollama prüft den Schlüssel nicht, die Bibliothek verlangt aber einen, deshalbapi_key="ollama".OpenAIChatCompletionsModelverbindet den Client mit dem Modellnamen. - Werkzeug:
@function_toolmacht aus einer Python-Funktion ein Werkzeug. Name, Typangaben und Docstring (die Beschreibung in"""…""") schickt das SDK dem Modell als Beschreibung. Das Modell entscheidet selbst, wann es das Werkzeug aufruft und mit welchem Wert. Die Zeile mitprintzeigt im Terminal, wann das geschieht. - Agent:
instructionssind die Anweisungen an das Modell,toolsdie Liste der Werkzeuge. - Runner:
Runner.run_syncstartet den Ablauf und wartet auf das Ergebnis.final_outputist die fertige Antwort.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python agent.py
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
[Werkzeug] landeshauptstadt('Schleswig-Holstein')
[Werkzeug] landeshauptstadt('Bayern')
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Das Modell hat die Frage zerlegt und das Werkzeug zweimal aufgerufen. Die Antwort kann bei jedem Lauf etwas anders formuliert sein.
Beispiel 2: Zwei Agenten mit Übergabe
10. Programm anlegen
Ein Empfangs-Agent nimmt Fragen an und übergibt Fragen zum Lager an einen zweiten Agenten, der als einziger das Werkzeug lagerbestand hat.
nano team.py
Füge diesen Inhalt ein:
from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, Runner, function_tool, handoff, set_tracing_disabled
from agents.extensions import handoff_filters
set_tracing_disabled(True)
ollama = AsyncOpenAI(base_url="http://localhost:11434/v1", api_key="ollama")
modell = OpenAIChatCompletionsModel(model="qwen3:4b-instruct", openai_client=ollama)
LAGER = {"fahrrad": 3, "helm": 0, "luftpumpe": 12}
@function_tool
def lagerbestand(artikel: str) -> str:
"""Liefert, wie viele Stück eines Artikels auf Lager sind.
Args:
artikel: Name des Artikels, z. B. Helm.
"""
print(f" [Werkzeug] lagerbestand({artikel!r})")
anzahl = LAGER.get(artikel.lower())
return "Artikel unbekannt" if anzahl is None else f"{anzahl} Stück"
lager = Agent(
name="Lager",
handoff_description="Beantwortet Fragen zum Lagerbestand von Artikeln.",
instructions="Frage den Bestand immer mit dem Werkzeug lagerbestand ab. Antworte kurz auf Deutsch.",
model=modell,
tools=[lagerbestand],
)
empfang = Agent(
name="Empfang",
instructions="Du nimmst Fragen entgegen. Fragen zum Lagerbestand gibst du an das Lager weiter.",
model=modell,
# Beim Übergeben die bisherigen Werkzeugaufrufe aus dem Verlauf entfernen
handoffs=[handoff(lager, input_filter=handoff_filters.remove_all_tools)],
)
ergebnis = Runner.run_sync(empfang, "Habt ihr noch Helme und Luftpumpen auf Lager?")
print("Geantwortet hat:", ergebnis.last_agent.name)
print(ergebnis.final_output)
handoffs– die Agenten, an dieempfangabgeben darf. Für das Modell sieht eine Übergabe aus wie ein Werkzeug namenstransfer_to_lager.handoff_descriptionerklärt ihm, wofür der andere Agent zuständig ist.input_filter– bestimmt, welchen Gesprächsverlauf der übernehmende Agent sieht.remove_all_toolsentfernt dabei alle bisherigen Werkzeugaufrufe, auch den der Übergabe. Im Test war das mit dem kleinen lokalen Modell nötig: Ohne Filter antwortete der Lager-Agent nach der Übergabe ohne Werkzeug und behauptete, Helme seien vorrätig.last_agent– der Agent, der die letzte Antwort gegeben hat.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Programm ausführen
python team.py
Prüfen: Die Ausgabe lautet z. B.:
[Werkzeug] lagerbestand('Helm')
[Werkzeug] lagerbestand('Luftpumpe')
Geantwortet hat: Lager
Helm: 0 Stück auf Lager. Luftpumpe: 12 Stück auf Lager.
Hinweise zu kleinen lokalen Modellen
- Werkzeuge werden manchmal übergangen: In einem Test sollte ein Agent 19 % Mehrwertsteuer mit einem Werkzeug berechnen.
qwen3:4b-instructrechnete lieber selbst, zum Glück richtig. Werkzeuge werden zuverlässiger genutzt, wenn sie Wissen liefern, das das Modell nicht haben kann, wie hier Lagerbestand oder eine Tabelle. tool_choicewirkt nicht: Die EinstellungModelSettings(tool_choice="required"), die einen Werkzeugaufruf erzwingen soll, hat Ollama im Test nicht beachtet.- Größere Modelle: Mit größeren Modellen in Ollama oder mit einem OpenAI-Modell (
model="gpt-…"und UmgebungsvariableOPENAI_API_KEY, kostenpflichtig) arbeiten Agenten deutlich verlässlicher.
Wie geht es weiter?
- Guardrails: Prüffunktionen, die Eingaben oder Ausgaben eines Agenten kontrollieren und den Lauf bei Bedarf abbrechen, etwa bei Fragen, die nicht zum Thema gehören.
- Sitzungen: Mit
SQLiteSessionmerkt sich ein Agent den Gesprächsverlauf über mehrere Aufrufe hinweg. - Streaming:
Runner.run_streamedliefert die Antwort Stück für Stück, während das Modell sie erzeugt. - MCP: Über das Model Context Protocol bindet man fertige Werkzeug-Server an, etwa für Dateisysteme oder Datenbanken.
- Dokumentation: https://openai.github.io/openai-agents-python/
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-openai
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
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.
Pydantic AI
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Pydantic AI ist eine Python-Bibliothek für KI-Agenten von den Entwicklern von Pydantic, der verbreiteten Bibliothek zum Prüfen von Daten. Ihre Stärke sind strukturierte Ergebnisse: Statt freiem Text liefert ein Agent auf Wunsch ein fertiges, geprüftes Python-Objekt mit festen Feldern und Typen. Werkzeuge sind normale Python-Funktionen, deren Typangaben Pydantic AI dem Modell als Beschreibung mitgibt.
Vorbemerkungen
- Viele Anbieter: Pydantic AI spricht OpenAI, Anthropic, Google, Mistral, Groq und andere an und hat eine eigene Anbindung für Ollama. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Schlanke Installation: Das Paket
pydantic-aiinstalliert die Anbindungen an alle Anbieter.pydantic-ai-slim[openai]bringt nur den Kern und die OpenAI-kompatible Schnittstelle mit, über die auch Ollama läuft (rund 90 MB statt deutlich mehr). - Werbe-Banner: Beim Start zeigt Pydantic AI ein großes Banner für den eigenen Beobachtungsdienst Logfire. Schritt 8 schaltet es ab. Daten werden dabei nicht gesendet, das Banner meldet ausdrücklich
observability: off. - Version: Getestet mit pydantic-ai-slim 2.51.0 und Pydantic 2.13 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-pydantic
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-pydantic
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Pydantic AI installieren
Die Anführungszeichen verhindern, dass die Shell die eckigen Klammern auswertet.
pip install "pydantic-ai-slim[openai]"
Prüfen: Die Ausgabe nennt Version: 2.51.0 oder eine neuere Version.
pip show pydantic-ai-slim
8. Banner abschalten (optional)
Setzt die Umgebungsvariable, die das Banner beim Start abschaltet. Sie gilt für dieses Terminal.
export PYDANTIC_AI_NO_BANNER=1
Beispiel 1: Ein Agent mit Werkzeug
9. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.ollama import OllamaProvider
# Lokales Modell über Ollama
modell = OpenAIChatModel(
"qwen3:4b-instruct",
provider=OllamaProvider(base_url="http://localhost:11434/v1"),
)
agent = Agent(
modell,
instructions="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
)
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
@agent.tool_plain
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
print(f" [Werkzeug] landeshauptstadt({bundesland!r})")
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
ergebnis = agent.run_sync("Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?")
print(ergebnis.output)
- Modell:
OpenAIChatModelspricht die Chat-Schnittstelle von OpenAI.OllamaProviderrichtet sie auf Ollama aus, einen Schlüssel braucht es dafür nicht. - Werkzeug:
@agent.tool_plainmeldet die Funktion beim Agenten als Werkzeug an. Name, Typangaben und Docstring gehen als Beschreibung an das Modell.tool_plainheißt: Die Funktion braucht keinen Zugriff auf den Ablauf. Mit@agent.toolbekäme sie zusätzlich einen Kontext, etwa für eine Datenbankverbindung. - Ausführen:
run_syncstartet den Agenten und wartet auf das Ergebnis.outputist die Antwort.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm ausführen
python agent.py
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
[Werkzeug] landeshauptstadt('Schleswig-Holstein')
[Werkzeug] landeshauptstadt('Bayern')
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Die Antwort kann bei jedem Lauf etwas anders formuliert sein.
Beispiel 2: Strukturiertes Ergebnis
11. Programm anlegen
Der Agent soll aus einer formlosen Nachricht einen Termin herauslesen und als Objekt mit festen Feldern zurückgeben.
nano termin.py
Füge diesen Inhalt ein:
from datetime import date
from pydantic import BaseModel, Field
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.ollama import OllamaProvider
modell = OpenAIChatModel(
"qwen3:4b-instruct",
provider=OllamaProvider(base_url="http://localhost:11434/v1"),
)
# So soll das Ergebnis aussehen
class Termin(BaseModel):
titel: str = Field(description="Kurzer Titel des Termins")
datum: date
ort: str
teilnehmer: list[str]
agent = Agent(
modell,
output_type=Termin,
instructions="Lies aus dem Text den Termin heraus. Heute ist der 27. September 2026.",
)
text = "Hallo Anna, hallo Ben, wir treffen uns am 3. Oktober 2026 in der Stadtbücherei Ahrensburg zur Planung vom Sommerfest."
ergebnis = agent.run_sync(text)
termin = ergebnis.output
print(type(termin).__name__, termin)
WOCHENTAGE = ["Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag", "Samstag", "Sonntag"]
print("Wochentag:", WOCHENTAGE[termin.datum.weekday()])
class Termin(BaseModel)– beschreibt mit Pydantic, welche Felder das Ergebnis hat und welchen Typ sie haben.Field(description=…)gibt dem Modell zusätzliche Hinweise.output_type=Termin– Pydantic AI teilt dem Modell diese Form mit und prüft die Antwort dagegen. Passt sie nicht, etwa weil das Datum kein gültiges Datum ist, schickt Pydantic AI den Fehler an das Modell zurück und lässt es erneut versuchen.- Echte Typen:
termin.datumist danach ein Python-date. Damit lässt sich weiterrechnen, hier der Wochentag.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
python termin.py
Prüfen: Die Ausgabe lautet:
Termin titel='Planung Sommerfest' datum=datetime.date(2026, 10, 3) ort='Stadtbücherei Ahrensburg' teilnehmer=['Anna', 'Ben']
Wochentag: Samstag
Wie geht es weiter?
- Abhängigkeiten: Mit
deps_typebekommt ein Agent beim Start Daten oder Verbindungen mit, etwa eine Datenbank. Werkzeuge mit@agent.toollesen sie überctx.deps. So lassen sich Agenten auch gut testen. - Andere Modelle: Statt eines Modellobjekts genügt oft ein Text wie
"anthropic:claude-…"oder"openai:gpt-…". Dafür braucht es das passende Zusatzpaket (z. B.pydantic-ai-slim[anthropic]) und einen kostenpflichtigen Schlüssel in einer Umgebungsvariable. - Streaming:
agent.run_streamliefert Text und sogar strukturierte Ergebnisse Stück für Stück. - Mehrere Agenten: Ein Agent kann einen anderen innerhalb eines Werkzeugs aufrufen. Für feste Abläufe gibt es das Zusatzpaket
pydantic-graph. - Dokumentation: https://ai.pydantic.dev
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-pydantic
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://ai.pydantic.dev/
- Lizenz: Pydantic AI steht unter der MIT.
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.
Google ADK
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das Agent Development Kit (ADK) von Google ist ein Python-Framework für KI-Agenten. Ein Agent ist ein Python-Paket mit einer Variablen root_agent. Das Befehlszeilenwerkzeug adk startet ihn im Terminal, als Weboberfläche zum Ausprobieren und Nachverfolgen oder als Schnittstelle für andere Programme. Mehrere Agenten lassen sich zu Teams und festen Abläufen verbinden.
Vorbemerkungen
- Nicht nur für Gemini: ADK ist auf die Gemini-Modelle von Google ausgerichtet, bindet über die Bibliothek LiteLLM aber auch viele andere Anbieter an. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Installation über pip: ADK ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert. Zusammen mit LiteLLM belegt sie rund 370 MB, die Installation dauert etwa eine Minute. - Wo was landet: Gesprächsverläufe speichert
adk runin.adk/session.dbim Ordner des Agenten, Protokolle in/tmp/agents_log. - Version: Getestet mit google-adk 2.10.0 und LiteLLM 1.102 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
In diesem Ordner liegen später die Agenten, jeder in einem eigenen Unterordner.
mkdir ~/agent-adk
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-adk
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python, pip und adk die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. ADK und LiteLLM installieren
pip install google-adk litellm
Prüfen: Die Ausgabe nennt Version: 2.10.0 oder eine neuere Version.
pip show google-adk
Ersten Agenten anlegen
8. Ordner für den Agenten anlegen
Jeder Agent ist ein eigener Ordner. Sein Name ist zugleich der Name des Agenten beim Start.
mkdir erdkunde
9. Paketdatei anlegen
Die Datei __init__.py macht den Ordner zu einem Python-Paket. Die eine Zeile lädt beim Import die Datei agent.py, damit ADK den Agenten findet.
nano erdkunde/__init__.py
Füge diese Zeile ein:
from . import agent
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Agenten schreiben
nano erdkunde/agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from google.adk.agents import Agent
from google.adk.models.lite_llm import LiteLlm
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
def landeshauptstadt(bundesland: str) -> dict:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
print(f" [Werkzeug] landeshauptstadt({bundesland!r})")
stadt = HAUPTSTAEDTE.get(bundesland.lower())
if stadt is None:
return {"status": "fehler", "meldung": f"{bundesland} ist nicht bekannt"}
return {"status": "ok", "hauptstadt": stadt}
# ADK sucht in diesem Paket nach einer Variablen namens root_agent
root_agent = Agent(
name="erdkunde",
# LiteLLM leitet die Anfragen an Ollama weiter
model=LiteLlm(model="ollama_chat/qwen3:4b-instruct"),
description="Beantwortet Fragen zu deutschen Bundesländern.",
instruction="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
tools=[landeshauptstadt],
)
- Werkzeug: In ADK ist jede normale Python-Funktion in
toolsein Werkzeug, ein Decorator ist nicht nötig. Name, Typangaben und Docstring gehen als Beschreibung an das Modell. Google empfiehlt, ein Dictionary mit einem Feldstatuszurückzugeben, damit das Modell Erfolg und Fehler unterscheiden kann. - Modell:
LiteLlmmit dem Namenollama_chat/…schickt die Anfragen an Ollama unterhttp://localhost:11434. Läuft Ollama auf einem anderen Rechner, setzt man die UmgebungsvariableOLLAMA_API_BASE. Für Gemini würde man stattdessen nurmodel="gemini-…"schreiben und einen Schlüssel von Google hinterlegen. descriptionbraucht ADK, wenn der Agent später Teil eines Teams ist: Andere Agenten entscheiden danach, ob sie ihm eine Aufgabe übergeben.instructionsind die Anweisungen an das Modell.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Starten und testen
11. Agenten im Terminal fragen
adk run lädt den Agenten aus dem Ordner erdkunde. Mit einer Frage dahinter beantwortet er nur diese und beendet sich.
adk run erdkunde "Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?"
Prüfen: Nach einigen Sekunden lauten die letzten Zeilen:
[Werkzeug] landeshauptstadt('Schleswig-Holstein')
[Werkzeug] landeshauptstadt('Bayern')
[erdkunde]: Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Davor stehen mehrere Warnungen mit [EXPERIMENTAL] und Zeilen von LiteLLM. Sie weisen nur auf Funktionen hin, die sich noch ändern können. Ohne Frage am Ende startet adk run erdkunde ein Gespräch im Terminal, das du mit exit beendest.
12. Weboberfläche starten
adk web startet einen Server mit einer Oberfläche zum Ausprobieren aller Agenten im aktuellen Ordner. Das Terminal bleibt belegt.
adk web
Prüfen: Die Ausgabe enthält Uvicorn running on http://127.0.0.1:8000. Der Server ist nur vom eigenen Rechner aus erreichbar. Ist Port 8000 belegt, startet ihn adk web --port 8001 auf einem anderen Port.
13. Agenten im Browser verwenden
Öffne http://127.0.0.1:8000 im Browser. Wähle oben links den Agenten erdkunde und stelle unten im Eingabefeld eine Frage, z. B. Was ist die Hauptstadt von Niedersachsen?.
Links zeigt die Oberfläche jeden Schritt als Ereignis: den Aufruf des Werkzeugs landeshauptstadt, seine Antwort und die Antwort des Modells. Ein Klick auf ein Ereignis zeigt die Einzelheiten, z. B. die genaue Anfrage an das Modell. So lässt sich nachvollziehen, warum ein Agent etwas getan hat.
14. Server beenden
Wechsle in das Terminal mit adk web und drücke Strg+C.
Wie geht es weiter?
- Teams: Ein Agent mit
sub_agents=[…]übergibt Aufgaben an spezialisierte Agenten. Feste Abläufe bauenSequentialAgent(nacheinander),ParallelAgent(gleichzeitig) undLoopAgent(wiederholt). - Schnittstelle:
adk api_serverstartet nur die HTTP-Schnittstelle ohne Oberfläche, damit andere Programme den Agenten aufrufen können. - Gemini: Mit einem Schlüssel aus Google AI Studio (Umgebungsvariable
GOOGLE_API_KEY) undmodel="gemini-…"verwendet der Agent die Modelle von Google. Je nach Nutzung ist das kostenpflichtig. - Dokumentation: https://google.github.io/adk-docs/
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und gespeicherten Gesprächen.
rm -rf ~/agent-adk
3. Protokolle entfernen
Löscht die Protokolldateien von ADK.
rm -rf /tmp/agents_log
4. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
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.
Microsoft Agent Framework
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das Microsoft Agent Framework ist Microsofts Bibliothek für KI-Agenten in Python und .NET. Es führt die beiden früheren Projekte Semantic Kernel und AutoGen zusammen. Ein Agent verbindet einen Chat-Client mit Anweisungen und Werkzeugen. Sitzungen halten Gespräche über mehrere Runden fest, und Workflows verbinden mehrere Agenten und Programmschritte zu festen Abläufen.
Vorbemerkungen
- Nicht nur für Azure: Das Framework ist auf Azure OpenAI und Microsoft Foundry ausgerichtet, spricht aber jeden Dienst mit der Chat-Schnittstelle von OpenAI an. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Einzelne Pakete: Das Sammelpaket
agent-frameworkinstalliert die Anbindungen an alle Dienste. Diese Anleitung nimmt nur den Kernagent-framework-coreund die OpenAI-Anbindungagent-framework-openai, zusammen rund 70 MB. Eine eigene Ollama-Anbindung gibt es auch, sie ist aber noch als Beta gekennzeichnet. - Asynchron: Die Beispiele verwenden
asyncundawait, weilagent.runauf die Antwort des Modells wartet, ohne das Programm zu blockieren.asyncio.run(main())startet die Funktionmain. - Version: Getestet mit agent-framework-core 1.19.0 und agent-framework-openai 1.14.4 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-ms
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-ms
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Framework installieren
pip install agent-framework-core agent-framework-openai
Prüfen: Die Ausgabe nennt Version: 1.19.0 oder eine neuere Version.
pip show agent-framework-core
Beispiel 1: Ein Agent mit Werkzeug
8. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import asyncio
from typing import Annotated
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIChatCompletionClient
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
@tool
def landeshauptstadt(
bundesland: Annotated[str, "Name des Bundeslands, z. B. Bayern"],
) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands."""
print(f" [Werkzeug] landeshauptstadt({bundesland!r})")
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
async def main():
# Ollama über die OpenAI-kompatible Chat-Schnittstelle
client = OpenAIChatCompletionClient(
model="qwen3:4b-instruct",
base_url="http://localhost:11434/v1",
api_key="ollama",
)
agent = Agent(
client,
instructions="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
name="Erdkunde",
tools=[landeshauptstadt],
)
antwort = await agent.run("Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?")
print(antwort.text)
asyncio.run(main())
- Client:
OpenAIChatCompletionClientspricht die klassische Chat-Schnittstelle von OpenAI (/v1/chat/completions), die auch Ollama anbietet.base_urlzeigt auf Ollama. Ollama prüft den Schlüssel nicht, der Client verlangt aber einen. Das Framework hat noch einen zweiten ClientOpenAIChatClient, der die neuere „Responses“-Schnittstelle von OpenAI verwendet. - Werkzeug:
@toolmacht aus der Funktion ein Werkzeug.Annotated[str, "…"]hängt an den Parameter eine Beschreibung, die das Modell zusammen mit dem Docstring bekommt. - Agent: Er verbindet Client, Anweisungen und Werkzeuge.
agent.runschickt die Frage, führt die gewünschten Werkzeuge aus und liefert die fertige Antwort,antwort.textist ihr Text.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python agent.py
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
[Werkzeug] landeshauptstadt('Schleswig-Holstein')
[Werkzeug] landeshauptstadt('Bayern')
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Die Antwort kann bei jedem Lauf etwas anders formuliert sein.
Beispiel 2: Gespräch mit Gedächtnis
10. Programm anlegen
Ein Agent vergisst ohne Weiteres alles nach jeder Antwort. Eine Sitzung hält den Verlauf fest und schickt ihn bei jeder neuen Frage mit.
nano gespraech.py
Füge diesen Inhalt ein:
import asyncio
from agent_framework import Agent
from agent_framework.openai import OpenAIChatCompletionClient
async def main():
client = OpenAIChatCompletionClient(
model="qwen3:4b-instruct",
base_url="http://localhost:11434/v1",
api_key="ollama",
)
agent = Agent(client, instructions="Du bist ein freundlicher Assistent. Antworte kurz auf Deutsch.")
# Eine Sitzung hält den Gesprächsverlauf fest
sitzung = agent.create_session()
for frage in [
"Ich heiße Thorsten und wohne in Ahrensburg.",
"In welchem Bundesland liegt mein Wohnort?",
"Wie heiße ich?",
]:
antwort = await agent.run(frage, session=sitzung)
print(f"> {frage}\n{antwort.text}\n")
# Ohne Sitzung kennt der Agent den Verlauf nicht
antwort = await agent.run("Wie heiße ich?")
print(f"> Wie heiße ich? (ohne Sitzung)\n{antwort.text}")
asyncio.run(main())
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Programm ausführen
python gespraech.py
Prüfen: Mit Sitzung nennt der Agent auf die zweite Frage Schleswig-Holstein und auf die dritte den Namen Thorsten. Ohne Sitzung antwortet er, dass er den Namen nicht kennt. Die genaue Formulierung wechselt. Kleine Modelle wie qwen3:4b-instruct machen dabei auch Grammatikfehler und hängen gern Emojis an.
Wie geht es weiter?
- Sitzungen speichern:
FileSessionStorelegt Sitzungen in Dateien ab, damit ein Gespräch nach einem Neustart des Programms weitergeht. - Workflows: Mit
WorkflowBuilderverbindet man Agenten und eigene Funktionen zu einem Graphen, etwa „Entwurf schreiben → prüfen → überarbeiten“. Zwischenstände lassen sich speichern, und ein Mensch kann an festgelegten Stellen freigeben. - Middleware: Eigene Funktionen können jeden Werkzeugaufruf oder jede Anfrage an das Modell vorher prüfen oder protokollieren.
- Andere Modelle: Für OpenAI genügt
OpenAIChatClient(model="gpt-…")mit der UmgebungsvariableOPENAI_API_KEY, für Azure OpenAI gibt es eigene Clients. Beides ist kostenpflichtig. - Dokumentation: https://learn.microsoft.com/agent-framework/
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-ms
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
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.
Strands Agents
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Strands Agents ist ein Python-Framework für KI-Agenten von Amazon Web Services (AWS). Es setzt darauf, dass das Sprachmodell selbst plant: Ein Agent besteht nur aus Modell, Systemanweisung und Werkzeugen, den Ablauf aus Nachdenken, Werkzeugaufrufen und Antworten steuert das Modell. Ein Agent wird wie eine Funktion aufgerufen und zeigt seine Antwort beim Entstehen im Terminal an.
Vorbemerkungen
- Nicht nur für AWS: Ohne Angabe verwendet Strands die Modelle von Amazon Bedrock. Es bringt aber Anbindungen für Anthropic, OpenAI, Gemini, Mistral, LiteLLM und Ollama mit. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Installation über pip: Strands ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, samt der Ollama-Anbindung rund 115 MB. Die AWS-Bibliothekboto3kommt dabei immer mit, auch wenn man AWS nicht nutzt. - Version: Getestet mit strands-agents 1.57.1 und der Python-Bibliothek ollama 0.6 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-strands
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-strands
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Strands mit Ollama-Anbindung installieren
[ollama] installiert zusätzlich die Bibliothek, mit der Strands Ollama anspricht. Die Anführungszeichen verhindern, dass die Shell die eckigen Klammern auswertet.
pip install "strands-agents[ollama]"
Prüfen: Die Ausgabe nennt Version: 1.57.1 oder eine neuere Version.
pip show strands-agents
Beispiel 1: Ein Agent mit Werkzeug
8. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from strands import Agent, tool
from strands.models.ollama import OllamaModel
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
@tool
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
# Lokales Modell über Ollama statt Amazon Bedrock
modell = OllamaModel(host="http://localhost:11434", model_id="qwen3:4b-instruct")
agent = Agent(
model=modell,
system_prompt="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
tools=[landeshauptstadt],
)
agent("Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?")
- Werkzeug:
@toolmacht aus der Funktion ein Werkzeug. Name, Typangaben und Docstring gehen als Beschreibung an das Modell. - Modell:
OllamaModelspricht Ollama direkt über dessen eigene Schnittstelle an.model_idist der Modellname ausollama list. - Aufruf: Ein Agent wird aufgerufen wie eine Funktion:
agent("…"). Strands zeigt dabei jeden Werkzeugaufruf und die Antwort beim Entstehen im Terminal an. Der Rückgabewert enthält die Antwort und Messwerte wie die verbrauchten Tokens.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python agent.py
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
Tool #1: landeshauptstadt
Tool #2: landeshauptstadt
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Strands führt die beiden Werkzeugaufrufe gleichzeitig aus. Die Antwort kann bei jedem Lauf etwas anders formuliert sein.
Beispiel 2: Agenten als Werkzeug
10. Programm anlegen
Ein häufiges Muster in Strands: Ein Agent ist selbst ein Werkzeug eines anderen Agenten. Hier gibt ein „Chef“-Agent Übersetzungen an einen spezialisierten Übersetzer-Agenten weiter.
nano team.py
Füge diesen Inhalt ein:
from strands import Agent, tool
from strands.models.ollama import OllamaModel
modell = OllamaModel(host="http://localhost:11434", model_id="qwen3:4b-instruct")
@tool
def uebersetzer(text: str, sprache: str) -> str:
"""Übersetzt einen Text in eine andere Sprache.
Args:
text: Der Text, der übersetzt werden soll.
sprache: Zielsprache, z. B. Englisch oder Französisch.
"""
# Ein eigener Agent nur für Übersetzungen, ohne Ausgabe im Terminal
fachagent = Agent(
model=modell,
system_prompt="Du bist Übersetzer. Gib nur die Übersetzung aus, ohne Erklärung.",
callback_handler=None,
)
return str(fachagent(f"Übersetze ins {sprache}: {text}"))
chef = Agent(
model=modell,
system_prompt="Du hilfst bei Texten. Für Übersetzungen nutzt du immer das Werkzeug uebersetzer, "
"für jede Sprache einzeln. Fasse die Ergebnisse als Liste zusammen.",
tools=[uebersetzer],
)
chef("Übersetze 'Guten Morgen, wie geht es dir?' ins Englische und ins Französische.")
- Der Übersetzer-Agent steckt in einem Werkzeug. Er hat seine eigene, einfache Systemanweisung, der Chef-Agent kennt nur die Beschreibung des Werkzeugs.
callback_handler=Noneschaltet die Ausgabe des Übersetzers im Terminal ab. So erscheint nur die Antwort des Chefs.str(…)macht aus dem Ergebnis des Übersetzers seinen Antworttext.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Programm ausführen
python team.py
Prüfen: Die Ausgabe lautet z. B.:
Tool #1: uebersetzer
Tool #2: uebersetzer
- Englisch: "Good morning, how are you?"
- Französisch: "Bonjour, comment allez-vous ?"
Wie geht es weiter?
- Fertige Werkzeuge: Das Zusatzpaket
strands-agents-toolsbringt Werkzeuge mit, etwa zum Lesen und Schreiben von Dateien, für HTTP-Anfragen oder einen Taschenrechner. Werkzeuge, die Befehle ausführen oder Dateien ändern, fragen vorher nach. - Mehrere Agenten: Neben „Agenten als Werkzeug“ kennt Strands Schwärme (Agenten übergeben sich gegenseitig Aufgaben) und Graphen (feste Abläufe).
- MCP: Über das Model Context Protocol bindet man fertige Werkzeug-Server an.
- Amazon Bedrock: Ohne
model=verwendet Strands Claude über Amazon Bedrock. Dafür braucht es ein AWS-Konto mit Zugangsdaten, die Nutzung ist kostenpflichtig. - Dokumentation: https://strandsagents.com
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-strands
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
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.
Vercel AI SDK
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Das AI SDK von Vercel ist eine Bibliothek für TypeScript und JavaScript, mit der man Sprachmodelle in eigene Programme einbindet. Eine einheitliche Schnittstelle spricht viele Anbieter an. Die Bibliothek erzeugt Text, streamt Antworten Stück für Stück und baut mit ToolLoopAgent Agenten, die selbstständig Werkzeuge aufrufen. Sie läuft in Node.js-Programmen ebenso wie in Webanwendungen, etwa mit Next.js.
Vorbemerkungen
- Viele Anbieter: Für jeden Anbieter gibt es ein eigenes Paket, z. B.
@ai-sdk/openaioder@ai-sdk/anthropic. Diese Anleitung verwendet ein lokales Modell über Ollama, angebunden mit dem Paket@ai-sdk/openai-compatible. Es fallen also keine Kosten an und keine Daten verlassen den Rechner. - Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Node.js aus Ubuntu: Das AI SDK braucht Node.js 22 oder neuer. Ubuntu 26.04 liefert Node.js 22.22, das reicht. Dieses Node.js kann TypeScript-Dateien aber nicht selbst ausführen: Es wurde ohne diese Funktion übersetzt und meldet
ERR_NO_TYPESCRIPT. Die Anleitung verwendet deshalb das kleine Werkzeugtsx, das TypeScript direkt startet. - Installation pro Projekt: Die Pakete lädt
npmin den Projektordner, zusammen rund 70 MB. - Version: Getestet mit ai 7.0.118, @ai-sdk/openai-compatible 3.0, zod 4.6, tsx 4.23 und TypeScript 7.0 unter Node.js 22.22 und npm 9.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Ist beides schon vorhanden (z. B. aus der Express-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer beginnt mit v22 oder höher.
node --version
3. Projektordner anlegen
mkdir ~/agent-aisdk
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-aisdk
5. Projekt anlegen
Legt die Datei package.json mit Vorgabewerten an. Darin hält npm fest, welche Pakete das Projekt braucht.
npm init -y
6. Moderne Module einschalten
Stellt das Projekt auf ES-Module um. Erst dann funktionieren import … from … und await direkt in der Datei, ohne umschließende Funktion.
npm pkg set type=module
7. AI SDK installieren
ai– der Kern mit Textgenerierung, Streaming, Werkzeugen und Agenten@ai-sdk/openai-compatible– die Anbindung an Dienste mit der Schnittstelle von OpenAI, hier Ollamazod– beschreibt, welche Eingaben ein Werkzeug erwartet, und prüft sie
npm install ai @ai-sdk/openai-compatible zod
Prüfen: Die Ausgabe endet mit found 0 vulnerabilities.
8. Werkzeuge für TypeScript installieren
--save-dev kennzeichnet sie als Werkzeuge nur für die Entwicklung. tsx führt TypeScript-Dateien aus, typescript prüft die Typen, @types/node beschreibt die Typen von Node.js selbst.
npm install --save-dev tsx typescript @types/node@22
Prüfen: Die Liste nennt ai@7.0.118 (oder neuer), @ai-sdk/openai-compatible, zod, tsx, typescript und @types/node.
npm ls --depth=0
Beispiel 1: Ein Agent mit Werkzeug
9. Programm anlegen
nano agent.ts
Füge diesen Inhalt ein (Strg+Umschalt+V):
import { ToolLoopAgent, tool } from "ai";
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { z } from "zod";
// Ollama über die OpenAI-kompatible Schnittstelle
const ollama = createOpenAICompatible({
name: "ollama",
baseURL: "http://localhost:11434/v1",
});
const HAUPTSTAEDTE: Record<string, string> = {
"schleswig-holstein": "Kiel",
hamburg: "Hamburg",
niedersachsen: "Hannover",
bayern: "München",
};
const agent = new ToolLoopAgent({
model: ollama("qwen3:4b-instruct"),
instructions:
"Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. " +
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
tools: {
landeshauptstadt: tool({
description: "Liefert die Landeshauptstadt eines deutschen Bundeslands.",
inputSchema: z.object({
bundesland: z.string().describe("Name des Bundeslands, z. B. Bayern"),
}),
execute: async ({ bundesland }) => {
console.log(` [Werkzeug] landeshauptstadt(${bundesland})`);
return HAUPTSTAEDTE[bundesland.toLowerCase()] ?? "unbekannt";
},
}),
},
});
const ergebnis = await agent.generate({
prompt: "Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?",
});
console.log(ergebnis.text);
console.log(`Schritte: ${ergebnis.steps.length}`);
- Modell:
createOpenAICompatiblelegt eine Anbindung an Ollama an.ollama("qwen3:4b-instruct")wählt daraus das Modell. - Werkzeug:
tool({ … })beschreibt ein Werkzeug mitdescription, den erwarteten Eingaben als zod-Schema (inputSchema) und der Funktionexecute, die es ausführt. zod prüft die Eingaben des Modells, bevorexecutesie bekommt. TypeScript kennt dadurch auch den Typ vonbundesland. - Agent:
ToolLoopAgentwiederholt die Schleife „Modell fragen → Werkzeuge ausführen → Ergebnisse zurückgeben“, bis das Modell eine Antwort liefert.generatestartet den Lauf.ergebnis.stepsenthält jeden Durchgang dieser Schleife.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm ausführen
npx startet tsx aus dem Ordner node_modules des Projekts.
npx tsx agent.ts
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
[Werkzeug] landeshauptstadt(Schleswig-Holstein)
[Werkzeug] landeshauptstadt(Bayern)
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Schritte: 2
Im ersten Schritt hat das Modell die Werkzeuge aufgerufen, im zweiten mit den Ergebnissen geantwortet.
Beispiel 2: Antwort streamen
11. Programm anlegen
Bei längeren Antworten will man nicht warten, bis alles fertig ist. streamText liefert den Text Stück für Stück, sobald das Modell ihn erzeugt.
nano stream.ts
Füge diesen Inhalt ein:
import { streamText } from "ai";
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
const ollama = createOpenAICompatible({
name: "ollama",
baseURL: "http://localhost:11434/v1",
});
const ergebnis = streamText({
model: ollama("qwen3:4b-instruct"),
prompt: "Schreibe ein kurzes Gedicht mit vier Zeilen über den Herbst an der Ostsee.",
});
// Text Stück für Stück ausgeben, sobald er ankommt
for await (const stueck of ergebnis.textStream) {
process.stdout.write(stueck);
}
process.stdout.write("\n");
textStream liefert die Textstücke nacheinander, for await wartet jeweils auf das nächste. process.stdout.write gibt sie ohne Zeilenumbruch aus, damit der Text zusammenhängend erscheint.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
npx tsx stream.ts
Prüfen: Das Gedicht erscheint Wort für Wort im Terminal. Es ist bei jedem Lauf anders.
Für Fragen nach Fakten eignen sich kleine Modelle wie qwen3:4b-instruct nur bedingt. Im Test erfand das Modell auf die Frage, wofür Ahrensburg bekannt ist, eine „historische Stadtbahn“. Für Faktenfragen gibt man einem Agenten deshalb Werkzeuge, die verlässliche Daten liefern, wie in Beispiel 1.
13. Typen prüfen
tsx entfernt die Typangaben nur und prüft sie nicht. Die Prüfung übernimmt der TypeScript-Compiler tsc. --noEmit prüft nur, ohne JavaScript-Dateien zu schreiben.
npx tsc --noEmit --strict --module nodenext --target es2022 --skipLibCheck --types node agent.ts stream.ts
Prüfen: Der Befehl gibt nichts aus. Bei Fehlern nennt er Datei, Zeile und Grund, z. B. einen Tippfehler in einem Feldnamen.
Wie geht es weiter?
- Strukturierte Ergebnisse: Mit
output: Output.object({ schema: z.object({ … }) })liefertgenerateTextein geprüftes Objekt statt Text. - Weboberfläche: Das Paket
@ai-sdk/reactbringt Hooks wieuseChatfür Chat-Oberflächen in React und Next.js mit. Der Server-Teil streamt die Antwort mitstreamTextan den Browser. - Freigaben: Werkzeuge können mit
needsApproval: trueeine Bestätigung durch den Menschen verlangen, bevor sie laufen. - Andere Anbieter: Mit
@ai-sdk/anthropicoder@ai-sdk/openaiund einem kostenpflichtigen Schlüssel in einer Umgebungsvariable tauscht man nur die Zeile mitmodel:aus. - Dokumentation: Die Doku passend zur installierten Version liegt in
node_modules/ai/docs, online unter https://ai-sdk.dev/docs.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt node_modules.
rm -rf ~/agent-aisdk
2. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
3. Node.js und npm entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. Express oder Next.js.
sudo apt purge nodejs npm
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
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.
smolagents
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
smolagents ist eine kleine Python-Bibliothek für KI-Agenten von Hugging Face. Ihre Besonderheit sind Code-Agenten: Statt ein Werkzeug nach dem anderen per JSON aufzurufen, schreibt das Sprachmodell ein kurzes Python-Programm, das die Werkzeuge verwendet, Zwischenergebnisse in Variablen speichert und rechnet. smolagents führt das Programm aus und gibt dem Modell die Ausgabe zurück. So erledigt ein Agent mehrere Schritte oft in einem einzigen Durchgang.
Vorbemerkungen
- Zwei Arten von Agenten:
CodeAgentlässt das Modell Python schreiben.ToolCallingAgentarbeitet wie die meisten anderen Frameworks mit einzelnen Werkzeugaufrufen. Beispiel 2 vergleicht beide. - Sprachmodell: smolagents spricht Modelle von Hugging Face, OpenAI, über LiteLLM und jeden Dienst mit der Schnittstelle von OpenAI an. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. - Vom Modell geschriebener Code: Der
CodeAgentführt Code aus, den das Modell erzeugt hat. smolagents verwendet dafür einen eigenen Python-Interpreter, der nur freigegebene Module importieren darf und gefährliche Funktionen sperrt. Eine echte Sandbox ist das nicht. Für fremde Eingaben oder heikle Umgebungen bietet smolagents die Ausführung in Docker oder bei Cloud-Diensten an. - Installation über pip: smolagents ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 125 MB. - Version: Getestet mit smolagents 1.26.0 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-smol
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-smol
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. smolagents installieren
[openai] installiert zusätzlich die Bibliothek für die OpenAI-kompatible Schnittstelle, über die Ollama angesprochen wird. Die Anführungszeichen verhindern, dass die Shell die eckigen Klammern auswertet.
pip install "smolagents[openai]"
Prüfen: Die Ausgabe nennt Version: 1.26.0 oder eine neuere Version.
pip show smolagents
Beispiel 1: Ein Code-Agent
8. Programm anlegen
Der Agent soll ausrechnen, wie viele Einwohner zwei Landeshauptstädte zusammen haben. Dafür braucht er zwei Werkzeuge nacheinander und muss danach rechnen.
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from smolagents import CodeAgent, OpenAIModel, tool
# Lokales Modell über die OpenAI-kompatible Schnittstelle von Ollama
modell = OpenAIModel(
model_id="qwen3:4b-instruct",
api_base="http://localhost:11434/v1",
api_key="ollama",
)
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
EINWOHNER = {"Kiel": 247000, "Hamburg": 1910000, "Hannover": 548000, "München": 1510000}
@tool
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
@tool
def einwohner(stadt: str) -> int:
"""Liefert die ungefähre Einwohnerzahl einer Stadt.
Args:
stadt: Name der Stadt, z. B. Kiel.
"""
if stadt not in EINWOHNER:
# Fehler statt 0: Der Agent sieht die Meldung und kann sich korrigieren
raise ValueError(f"Unbekannte Stadt {stadt!r}. Bekannt sind: {', '.join(EINWOHNER)}")
return EINWOHNER[stadt]
agent = CodeAgent(
tools=[landeshauptstadt, einwohner],
model=modell,
max_steps=5,
instructions="Ermittle Landeshauptstädte immer mit dem Werkzeug landeshauptstadt, "
"nie aus dem Gedächtnis. Gib als Endergebnis nur die Zahl zurück.",
)
antwort = agent.run(
"Wie viele Einwohner haben die Landeshauptstädte von Schleswig-Holstein und Bayern zusammen?"
)
print("Antwort:", antwort)
- Modell:
OpenAIModelspricht die Chat-Schnittstelle von OpenAI,api_basezeigt auf Ollama. Ollama prüft den Schlüssel nicht, die Bibliothek verlangt aber einen. - Werkzeuge:
@toolmacht aus einer Funktion ein Werkzeug. smolagents verlangt Typangaben für alle Parameter und den Rückgabewert und im Docstring einen AbschnittArgs:, der jeden Parameter beschreibt. Daraus baut es die Beschreibung für das Modell. - Fehler statt stiller Vorgabewerte:
einwohnerlöst bei einer unbekannten Stadt einen Fehler aus, statt 0 zurückzugeben. Im Test schrieb das Modell manchmal „Munich“ statt „München“. Mit einer stillen 0 kam dann ein falsches Ergebnis heraus. Mit der Fehlermeldung sieht der Agent, welche Städte es gibt, und korrigiert sich im nächsten Schritt. - Anweisungen: Ohne den Hinweis in
instructionsübersprang das kleine Modell oft das Werkzeuglandeshauptstadtund verwendete eigenes, teils falsches Wissen. max_stepsbegrenzt die Zahl der Durchgänge, damit ein Agent nicht endlos weiterläuft.final_answerist ein Werkzeug, das smolagents selbst mitbringt. Ruft das Programm des Modells es auf, ist der Lauf beendet.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python agent.py
Prüfen: smolagents zeigt in Kästen die Aufgabe, den vom Modell geschriebenen Code, dessen Ausgabe und die Antwort. Ein typischer Lauf (Kommentare im Code gekürzt):
─ Executing parsed code: ─────────────────────────────────────────────────────
capital_schleswig_holstein = landeshauptstadt("Schleswig-Holstein")
print(f"Capital of Schleswig-Holstein: {capital_schleswig_holstein}")
capital_bayern = landeshauptstadt("Bayern")
print(f"Capital of Bayern: {capital_bayern}")
population_schleswig_holstein = einwohner(capital_schleswig_holstein)
population_bayern = einwohner(capital_bayern)
total_population = population_schleswig_holstein + population_bayern
final_answer(total_population)
Execution logs:
Capital of Schleswig-Holstein: Kiel
Capital of Bayern: München
Final answer: 1757000
[Step 1: Duration 5.51 seconds| Input tokens: 2,188 | Output tokens: 251]
Antwort: 1757000
Das Modell hat alle Werkzeugaufrufe und die Addition in einem einzigen Programm erledigt. Der Code ist bei jedem Lauf etwas anders, die Kommentare darin schreibt das Modell meist auf Englisch. Manchmal braucht der Agent zwei oder drei Schritte, etwa wenn er zuerst nur die Hauptstädte abfragt oder einen Fehler von einwohner korrigiert. Im Test lieferten 8 von 8 Läufen 1757000.
Beispiel 2: Vergleich mit einzelnen Werkzeugaufrufen
10. Programm kopieren
Die Vergleichsfassung ist dasselbe Programm mit einer anderen Art von Agent.
cp agent.py vergleich.py
11. Art des Agenten ändern
nano vergleich.py
Ersetze CodeAgent an beiden Stellen durch ToolCallingAgent: in der ersten Zeile beim import und bei agent = CodeAgent(. Mit Strg+\ ersetzt nano Text: Gib CodeAgent ein, drücke Enter, gib ToolCallingAgent ein, drücke Enter und bestätige mit A (alle ersetzen).
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Vergleich ausführen
python vergleich.py
Prüfen: Jetzt zeigt smolagents für jeden Schritt einen Kasten Calling tool: … mit einem einzelnen Werkzeugaufruf: zweimal landeshauptstadt, zweimal einwohner und am Ende final_answer.
Im Test brauchte der ToolCallingAgent jedes Mal 6 Schritte und rund 8 400 Eingabe-Tokens, der CodeAgent 1 bis 3 Schritte und rund 2 200 bis 7 500 Tokens. Mit dem kleinen lokalen Modell fehlte beim ToolCallingAgent außerdem in 2 von 3 Läufen die Summe in der Antwort: Er nannte nur die beiden Städte. Bei Aufgaben, in denen Ergebnisse weiterverarbeitet werden, ist der Code-Agent deshalb meist schneller und verlässlicher.
Wie geht es weiter?
- Weitere Module erlauben: Der Code-Agent darf ab Werk nur wenige Module importieren, etwa
math,datetimeoderre. Mitadditional_authorized_imports=["json"]gibt man weitere frei. - Fertige Werkzeuge: smolagents bringt Werkzeuge mit, z. B. eine Websuche (
WebSearchTool) oder das Abrufen von Webseiten. Werkzeuge lassen sich auch über den Hugging Face Hub teilen oder per MCP anbinden. - Weboberfläche: Mit
pip install "smolagents[gradio]"undGradioUI(agent).launch()bekommt ein Agent eine Chat-Oberfläche im Browser. - Mehrere Agenten: Ein Agent kann andere Agenten als Werkzeuge verwenden (
managed_agents=[…]). - Dokumentation: https://huggingface.co/docs/smolagents
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-smol
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://huggingface.co/docs/smolagents
- Lizenz: smolagents steht unter der Apache-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.
Agno
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Agno ist ein Python-Framework für KI-Agenten, das auf wenig Code und schnellen Start ausgelegt ist. Ein Agent bekommt Modell, Anweisungen und Werkzeuge. Gesprächsverläufe, Erinnerungen an Benutzer und Zusammenfassungen speichert Agno auf Wunsch gleich in einer Datenbank, etwa SQLite oder PostgreSQL. Mit AgentOS lassen sich Agenten außerdem als Webdienst betreiben.
Vorbemerkungen
- Viele Anbieter: Agno bindet über 20 Anbieter an, darunter OpenAI, Anthropic, Google und Ollama. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Telemetrie: Agno sendet ab Werk bei jedem Lauf eines Agenten ein Ereignis an den Hersteller (
os-api.agno.com). Die Beispiele schalten das mittelemetry=Falseab. Für alle Programme auf einmal geht es mit der UmgebungsvariableAGNO_TELEMETRY=false. - Pakete zusammensuchen: Der Kern
agnobringt die Anbindungen nicht mit. Für Ollama braucht es die Paketeollamaundopenai, für SQLitesqlalchemy,aiosqliteundgreenlet. Schritt 7 installiert alles auf einmal. Im Test reichte das Extraagno[ollama]allein nicht, und SQLAlchemy 2.1 installiertgreenletnicht mehr selbst. - Installation über pip: Agno ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 170 MB. - Version: Getestet mit agno 3.0.11, ollama 0.6, openai 3.19 und SQLAlchemy 2.1 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-agno
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-agno
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Agno mit Ollama- und SQLite-Anbindung installieren
agno[ollama,openai,sqlite]– Agno samt den Bibliothekenollama,openai,sqlalchemyundaiosqlitesqlalchemy[asyncio]– ergänztgreenlet, ohne das die SQLite-Speicherung mit einemImportErrorabbricht
Die Anführungszeichen verhindern, dass die Shell die eckigen Klammern auswertet.
pip install "agno[ollama,openai,sqlite]" "sqlalchemy[asyncio]"
Prüfen: Die Liste enthält agno 3.0.11 (oder neuer), ollama, openai, SQLAlchemy, aiosqlite und greenlet.
pip list
Beispiel 1: Ein Agent mit Werkzeug
8. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from agno.agent import Agent
from agno.models.ollama import Ollama
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
Args:
bundesland: Name des Bundeslands, z. B. Bayern.
"""
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
agent = Agent(
model=Ollama(id="qwen3:4b-instruct"),
instructions="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
tools=[landeshauptstadt],
# Keine Nutzungsdaten an Agno senden
telemetry=False,
)
agent.print_response("Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?", show_tool_calls=True)
- Modell:
Ollama(id=…)spricht Ollama unterhttp://localhost:11434an. Läuft Ollama woanders, gibt manhost="http://…"mit. - Werkzeug: Jede normale Python-Funktion in
toolsist ein Werkzeug. Name, Typangaben und Docstring gehen als Beschreibung an das Modell. - Ausgabe:
print_responsezeigt Frage, Werkzeugaufrufe und Antwort in Kästen im Terminal an. Im eigenen Programm verwendet man stattdessenergebnis = agent.run("…")und liest die Antwort ausergebnis.content.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python agent.py
Prüfen: Nach einigen Sekunden erscheinen drei Kästen: „Message“ mit der Frage, „Tool Calls“ mit landeshauptstadt(bundesland=Schleswig-Holstein) und landeshauptstadt(bundesland=Bayern) und „Response“ mit der Antwort:
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Beispiel 2: Gedächtnis in einer Datenbank
10. Programm anlegen
Der Agent soll sich an ein Gespräch erinnern, auch wenn das Programm zwischendurch beendet wird. Dafür speichert Agno jede Runde in einer SQLite-Datei. Die Frage kommt als Argument beim Aufruf.
nano gedaechtnis.py
Füge diesen Inhalt ein:
import sys
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.ollama import Ollama
agent = Agent(
model=Ollama(id="qwen3:4b-instruct"),
instructions="Du bist ein freundlicher Assistent. Antworte kurz auf Deutsch.",
# Gespräche und Erinnerungen in einer SQLite-Datei speichern
db=SqliteDb(db_file="agent.db"),
user_id="thorsten",
session_id="erstes-gespraech",
# Die letzten Runden des Gesprächs bei jeder Frage mitschicken
add_history_to_context=True,
num_history_runs=5,
telemetry=False,
)
frage = " ".join(sys.argv[1:]) or "Hallo!"
agent.print_response(frage)
db=SqliteDb(…)– Agno legt die Dateiagent.dban und speichert darin Sitzungen und Läufe.user_idundsession_id– ordnen das Gespräch einem Benutzer und einer Sitzung zu. Eine anderesession_idbeginnt ein neues Gespräch.add_history_to_context– schickt die letzten Runden (hier höchstens 5) bei jeder Frage an das Modell mit. Ohne diese Einstellung würde Agno zwar speichern, das Modell sähe den Verlauf aber nicht.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Etwas erzählen
python gedaechtnis.py Ich heiße Thorsten und wohne in Ahrensburg.
Prüfen: Der Agent begrüßt dich mit Namen. Im Ordner liegt jetzt die Datei agent.db.
12. Nachfragen in einem neuen Aufruf
Das Programm läuft jetzt neu, der Verlauf kommt aus der Datenbank.
python gedaechtnis.py In welchem Bundesland liegt mein Wohnort?
python gedaechtnis.py Wie heiße ich?
Prüfen: Der Agent nennt Schleswig-Holstein und den Namen Thorsten. Kleine Modelle wie qwen3:4b-instruct machen dabei Grammatikfehler („in der Bundesländer“) und hängen gern Emojis an. Löschst du agent.db, hat der Agent alles vergessen.
Wie geht es weiter?
- Erinnerungen an Benutzer: Mit
update_memory_on_run=Truelegt Agno aus Gesprächen dauerhafte Notizen über den Benutzer an, etwa Vorlieben, und bezieht sie in spätere Sitzungen ein. - Wissen: Mit einer Wissensbasis und einer Vektordatenbank wie Qdrant durchsucht ein Agent eigene Dokumente, bevor er antwortet.
- Teams:
Teamfasst mehrere Agenten zusammen, die sich Aufgaben teilen. - AgentOS: Agno kann Agenten als FastAPI-Webdienst bereitstellen. Die Weboberfläche dazu betreibt der Hersteller unter
os.agno.com. Das Befehlszeilenwerkzeugagnoctlverbindet Programmier-Assistenten mit einem laufenden AgentOS. - Dokumentation: https://docs.agno.com
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und der Datenbank agent.db.
rm -rf ~/agent-agno
3. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.agno.com/
- Lizenz: Agno steht unter der Apache-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.
Haystack
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Haystack von der Berliner Firma deepset ist ein Python-Framework für Anwendungen mit Sprachmodellen. Sein Kern sind Pipelines: Bausteine (Komponenten) wie „Text in Vektor umwandeln“, „passende Dokumente suchen“, „Prompt bauen“ und „Modell fragen“ werden zu einem festen Ablauf verbunden. Haystack ist besonders für die Suche in eigenen Dokumenten (RAG) bekannt und bringt außerdem einen Agenten mit, der Werkzeuge verwendet.
Vorbemerkungen
- Pakete:
haystack-aienthält den Kern. Anbindungen an einzelne Dienste kommen als eigene Pakete, hierollama-haystackfür Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner. - Voraussetzung: Ein laufendes Ollama mit dem Chat-Modell
qwen3:4b-instructund dem Embedding-Modellnomic-embed-text, beide aus der Ollama-Anleitung. - Telemetrie: Haystack sendet ab Werk anonyme Nutzungsdaten an den Dienst PostHog (
eu.posthog.com) und legt dafür eine zufällige Kennung in~/.haystack/config.yamlab. Schritt 8 schaltet das über die UmgebungsvariableHAYSTACK_TELEMETRY_ENABLEDab. Dann legt Haystack den Ordner auch nicht an. - Installation über pip: Haystack ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 175 MB. - Version: Getestet mit haystack-ai 3.2.0 und ollama-haystack 7.0.1 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-haystack
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-haystack
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. Haystack und Ollama-Anbindung installieren
pip install haystack-ai ollama-haystack
Prüfen: Die Liste enthält haystack-ai 3.2.0 (oder neuer) und ollama-haystack.
pip list
8. Telemetrie abschalten
Setzt die Umgebungsvariable für dieses Terminal. Wer Haystack öfter verwendet, trägt die Zeile mit nano ~/.bashrc am Ende der Datei ein, dann gilt sie in jedem neuen Terminal.
export HAYSTACK_TELEMETRY_ENABLED=False
Beispiel 1: Ein Agent mit Werkzeug
9. Programm anlegen
nano agent.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from haystack.components.agents import Agent
from haystack.dataclasses import ChatMessage
from haystack.tools import tool
from haystack_integrations.components.generators.ollama import OllamaChatGenerator
HAUPTSTAEDTE = {
"schleswig-holstein": "Kiel",
"hamburg": "Hamburg",
"niedersachsen": "Hannover",
"bayern": "München",
}
@tool
def landeshauptstadt(bundesland: str) -> str:
"""Liefert die Landeshauptstadt eines deutschen Bundeslands.
:param bundesland: Name des Bundeslands, z. B. Bayern.
"""
print(f" [Werkzeug] landeshauptstadt({bundesland!r})")
return HAUPTSTAEDTE.get(bundesland.lower(), "unbekannt")
agent = Agent(
chat_generator=OllamaChatGenerator(model="qwen3:4b-instruct", url="http://localhost:11434"),
system_prompt="Du beantwortest Fragen zu deutschen Bundesländern kurz auf Deutsch. "
"Nutze für Landeshauptstädte immer das Werkzeug landeshauptstadt.",
tools=[landeshauptstadt],
)
ergebnis = agent.run(messages=[ChatMessage.from_user("Was ist die Hauptstadt von Schleswig-Holstein und von Bayern?")])
print(ergebnis["last_message"].text)
OllamaChatGenerator– die Komponente, die das Chat-Modell in Ollama befragt.@tool– macht aus der Funktion ein Werkzeug. Haystack liest die Parameterbeschreibung aus dem Docstring im Stil:param name: ….ChatMessage.from_user– Haystack arbeitet mit Nachrichten-Objekten statt einfachem Text.- Ergebnis:
agent.runliefert ein Dictionary mit allen Nachrichten.last_messageist die letzte, also die Antwort.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm ausführen
python agent.py
Prüfen: Die Ausgabe lautet nach einigen Sekunden:
[Werkzeug] landeshauptstadt('Schleswig-Holstein')
[Werkzeug] landeshauptstadt('Bayern')
Die Hauptstadt von Schleswig-Holstein ist Kiel und die Hauptstadt von Bayern ist München.
Beispiel 2: Fragen zu eigenen Texten (RAG)
11. Programm anlegen
Das Modell soll Fragen zu einem erfundenen Schachclub beantworten, über den es nichts wissen kann. Zwei Pipelines erledigen das: Die erste wandelt die Texte in Vektoren um und speichert sie. Die zweite wandelt die Frage in einen Vektor um, sucht die zwei ähnlichsten Texte und gibt sie dem Modell mit.
nano rag.py
Füge diesen Inhalt ein:
from haystack import Document, Pipeline
from haystack.components.builders import ChatPromptBuilder
from haystack.components.retrievers.in_memory import InMemoryEmbeddingRetriever
from haystack.components.writers import DocumentWriter
from haystack.dataclasses import ChatMessage
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack_integrations.components.embedders.ollama import OllamaDocumentEmbedder, OllamaTextEmbedder
from haystack_integrations.components.generators.ollama import OllamaChatGenerator
OLLAMA = "http://localhost:11434"
# Eigene Texte, die das Modell nicht kennen kann
texte = [
"Der Schachclub Waldblick trifft sich jeden Dienstag um 19 Uhr im Bürgerhaus, Raum 2.",
"Die Jahreshauptversammlung des Schachclubs findet am 14. November im Gemeindesaal statt.",
"Der Mitgliedsbeitrag beträgt 60 Euro im Jahr, Schüler zahlen 20 Euro.",
"Ansprechpartnerin für neue Mitglieder ist Frau Petersen.",
"Im Sommer spielt der Club donnerstags draußen im Stadtpark am großen Brett.",
]
speicher = InMemoryDocumentStore()
# Pipeline 1: Texte in Vektoren umwandeln und speichern
indizieren = Pipeline()
indizieren.add_component("embedder", OllamaDocumentEmbedder(model="nomic-embed-text", url=OLLAMA, progress_bar=False))
indizieren.add_component("writer", DocumentWriter(document_store=speicher))
indizieren.connect("embedder.documents", "writer.documents")
indizieren.run({"embedder": {"documents": [Document(content=t) for t in texte]}})
vorlage = [
ChatMessage.from_system(
"Beantworte die Frage nur mit Hilfe der folgenden Texte. "
"Steht die Antwort nicht darin, sage das.\n"
"{% for doc in documents %}- {{ doc.content }}\n{% endfor %}"
),
ChatMessage.from_user("{{ frage }}"),
]
# Pipeline 2: passende Texte suchen und damit antworten
fragen = Pipeline()
fragen.add_component("embedder", OllamaTextEmbedder(model="nomic-embed-text", url=OLLAMA))
fragen.add_component("retriever", InMemoryEmbeddingRetriever(document_store=speicher, top_k=2))
fragen.add_component("prompt", ChatPromptBuilder(template=vorlage, required_variables=["frage", "documents"]))
fragen.add_component("llm", OllamaChatGenerator(model="qwen3:4b-instruct", url=OLLAMA))
fragen.connect("embedder.embedding", "retriever.query_embedding")
fragen.connect("retriever.documents", "prompt.documents")
fragen.connect("prompt.prompt", "llm.messages")
for frage in ["Wann trifft sich der Schachclub?", "Was kostet die Mitgliedschaft für Schüler?", "Wer ist Vorsitzender?"]:
ergebnis = fragen.run({"embedder": {"text": frage}, "prompt": {"frage": frage}}, include_outputs_from={"retriever"})
print(f"> {frage}")
print(ergebnis["llm"]["replies"][0].text)
print(" Quellen:", [d.content[:40] for d in ergebnis["retriever"]["documents"]], "\n")
- Komponenten und Verbindungen:
add_componentfügt einen Baustein mit Namen hinzu,connect("a.ausgang", "b.eingang")verbindet den Ausgang des einen mit dem Eingang des anderen. Haystack prüft dabei, ob die Datentypen zusammenpassen. - Embeddings:
nomic-embed-textwandelt jeden Text in einen Zahlenvektor um. Texte mit ähnlicher Bedeutung bekommen ähnliche Vektoren.InMemoryDocumentStorehält sie im Arbeitsspeicher, für größere Mengen gibt es Anbindungen an Datenbanken wie Qdrant. - Suche:
InMemoryEmbeddingRetrieverfindet dietop_kTexte, deren Vektor dem der Frage am nächsten ist. - Prompt:
ChatPromptBuilderfüllt die Vorlage mit der Frage und den gefundenen Texten.{% for … %}und{{ … }}sind Jinja2-Schreibweise. include_outputs_from– gibt zusätzlich die gefundenen Texte aus, damit man sieht, worauf sich die Antwort stützt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
python rag.py
Prüfen: Die Ausgabe lautet z. B.:
> Wann trifft sich der Schachclub?
Der Schachclub trifft sich jeden Dienstag um 19 Uhr im Bürgerhaus, Raum 2.
Quellen: ['Der Schachclub Waldblick trifft sich jed', 'Die Jahreshauptversammlung des Schachclu']
> Was kostet die Mitgliedschaft für Schüler?
Die Mitgliedschaft für Schüler kostet 20 Euro.
Quellen: ['Der Mitgliedsbeitrag beträgt 60 Euro im ', 'Im Sommer spielt der Club donnerstags dr']
> Wer ist Vorsitzender?
Die Information über den Vorsitzenden steht nicht im Text.
Quellen: ['Ansprechpartnerin für neue Mitglieder is', 'Der Mitgliedsbeitrag beträgt 60 Euro im ']
Die dritte Frage ist eine Falle: Der Vorsitzende steht in keinem Text. Weil die Anweisung verlangt, nur die Texte zu verwenden, sagt das Modell das, statt einen Namen zu erfinden.
Wie geht es weiter?
- Eigene Dateien: Komponenten wie
TextFileToDocument,PyPDFToDocumentundDocumentSplitterlesen Dateien ein und zerlegen lange Texte in kleinere Abschnitte, bevor sie in den Speicher kommen. - Dauerhafter Speicher: Mit
qdrant-haystackund einem laufenden Qdrant bleiben die Vektoren nach dem Programmende erhalten. - Pipeline als Werkzeug: Eine ganze Pipeline lässt sich mit
PipelineToolals Werkzeug an einen Agenten geben. Dann entscheidet der Agent selbst, wann er in den Dokumenten sucht. - Pipelines speichern:
pipeline.dumps()schreibt eine Pipeline als YAML,Pipeline.loads()liest sie wieder ein. - Dokumentation: https://docs.haystack.deepset.ai
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-haystack
3. Kennung der Telemetrie entfernen
Nur nötig, wenn Haystack einmal ohne abgeschaltete Telemetrie lief. Dann liegt die zufällige Kennung in ~/.haystack. -f meldet keinen Fehler, wenn der Ordner fehlt.
rm -rf ~/.haystack
4. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.haystack.deepset.ai/
- Lizenz: Haystack steht unter der Apache-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.
DSPy
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
DSPy ist ein Python-Framework aus der Universität Stanford, mit dem man Sprachmodelle programmiert statt Prompts von Hand zu schreiben. Man beschreibt nur, welche Eingaben eine Aufgabe hat und welche Ausgaben herauskommen sollen, als Signatur. DSPy baut daraus den Prompt und liest die Antwort wieder in Felder aus. Mit Beispieldaten und einer Bewertungsfunktion kann DSPy den Prompt außerdem selbst optimieren, etwa indem es gute Beispiele auswählt.
Vorbemerkungen
- Die Idee: Ein Programm besteht aus Modulen wie
dspy.Predict(einfache Anfrage),dspy.ChainOfThought(erst nachdenken, dann antworten) oderdspy.ReAct(Agent mit Werkzeugen). Optimierer wieBootstrapFewShotverbessern diese Module anhand messbarer Ergebnisse. Den Prompt muss man dabei nicht anfassen. - Sprachmodell: DSPy spricht OpenAI, Anthropic, Google und viele andere an. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. - Zwischenspeicher: DSPy speichert jede Antwort des Modells in
~/.dspy_cache. Ein zweiter Aufruf mit genau denselben Eingaben liefert die gespeicherte Antwort, ohne das Modell zu fragen. Das spart Zeit beim Entwickeln, kann beim Ausprobieren aber verwirren.cache=Falseschaltet es ab. - Installation über pip: DSPy ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit
pipin eine virtuelle Umgebung installiert, rund 300 MB. - Version: Getestet mit dspy 3.4.0 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Unterstützung für virtuelle Umgebungen installieren
Ist das Paket schon vorhanden, meldet apt das nur.
sudo apt install python3-venv
3. Projektordner anlegen
mkdir ~/agent-dspy
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-dspy
5. Virtuelle Umgebung anlegen
Legt eine eigene Python-Umgebung für dieses Projekt im Unterordner .venv an. Ubuntu verhindert absichtlich, dass pip Pakete systemweit installiert.
python3 -m venv .venv
6. Virtuelle Umgebung aktivieren
Danach verwenden python und pip die Umgebung. Die Eingabezeile beginnt mit (.venv). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
7. DSPy installieren
pip install dspy
Prüfen: Die Ausgabe nennt Version: 3.4.0 oder eine neuere Version.
pip show dspy
Beispiel 1: Eine Signatur
8. Programm anlegen
Das Programm soll Kundenbewertungen als positiv, neutral oder negativ einordnen und kurz begründen.
nano erste.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import dspy
# Lokales Modell über Ollama
lm = dspy.LM("ollama_chat/qwen3:4b-instruct", api_base="http://localhost:11434/v1")
dspy.configure(lm=lm)
# Eine Signatur beschreibt, was hineingeht und was herauskommt
class Stimmung(dspy.Signature):
"""Bestimme die Stimmung einer Kundenbewertung."""
bewertung: str = dspy.InputField()
stimmung: str = dspy.OutputField(desc="positiv, neutral oder negativ")
begruendung: str = dspy.OutputField(desc="ein kurzer Satz auf Deutsch")
einschaetzen = dspy.Predict(Stimmung)
for text in [
"Das Fahrrad kam schnell und ist super verarbeitet.",
"Die Lieferung dauerte drei Wochen, und der Sattel war kaputt.",
"Ganz okay, nichts Besonderes.",
]:
ergebnis = einschaetzen(bewertung=text)
print(f"{ergebnis.stimmung:9} | {ergebnis.begruendung}")
# So sah der Prompt aus, den DSPy aus der Signatur gebaut hat
dspy.inspect_history(n=1)
- Modell:
ollama_chat/…wählt Ollama. DSPy spricht es über die OpenAI-kompatible Schnittstelle an, deshalb endetapi_baseauf/v1. Ohne/v1meldet DSPy404 page not found. Einenapi_keygibt man für Ollama gar nicht an. Ein leerer Schlüssel (api_key="") führt zum Fehlerempty credential. - Signatur: Die Klasse beschreibt die Aufgabe. Der Docstring wird zur Aufgabenbeschreibung im Prompt,
InputFieldundOutputFieldzu den Feldern,desczu Hinweisen für das Modell. - Modul:
dspy.Predict(Stimmung)macht aus der Signatur eine aufrufbare Funktion. Das Ergebnis hat für jedes Ausgabefeld ein Attribut. inspect_historyzeigt den letzten Prompt samt Antwort.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
python erste.py
Prüfen: Die ersten drei Zeilen lauten sinngemäß:
positiv | Die Bewertung enthält positive Bestimmungen wie „schnell“ und „super verarbeitet“.
negativ | Die Kundenbewertung erwähnt eine lange Lieferzeit und einen defekten Produkt, …
neutral | Die Bewertung besagt, dass etwas „ganz okay“ ist, aber nichts Besonderes, …
Darunter steht der Prompt, den DSPy gebaut hat: eine Beschreibung der Felder, die Aufgabe aus dem Docstring und Markierungen wie [[ ## stimmung ## ]], an denen DSPy die Antwort wieder in Felder zerlegt. Führst du das Programm erneut aus, kommen die Antworten sofort aus dem Zwischenspeicher.
Beispiel 2: Automatisch optimieren
10. Programm anlegen
Das Programm ordnet Kundenanfragen an einen Fahrradladen einer Abteilung zu. Es misst die Trefferquote an zehn Prüfbeispielen, lässt DSPy den Prompt anhand von acht Lernbeispielen verbessern und misst erneut.
nano optimieren.py
Füge diesen Inhalt ein:
import dspy
lm = dspy.LM("ollama_chat/qwen3:4b-instruct", api_base="http://localhost:11434/v1")
dspy.configure(lm=lm)
class Anfrage(dspy.Signature):
"""Ordne eine Kundenanfrage an einen Fahrradladen einer Abteilung zu."""
nachricht: str = dspy.InputField()
abteilung: str = dspy.OutputField(desc="genau eines von: lieferung, rechnung, werkstatt, sonstiges")
def beispiel(nachricht, abteilung):
return dspy.Example(nachricht=nachricht, abteilung=abteilung).with_inputs("nachricht")
# Beispiele zum Lernen
training = [
beispiel("Wo bleibt mein Paket? Bestellt habe ich vor zehn Tagen.", "lieferung"),
beispiel("Auf der Rechnung steht der falsche Betrag.", "rechnung"),
beispiel("Meine Gangschaltung springt ständig raus.", "werkstatt"),
beispiel("Habt ihr am Samstag geöffnet?", "sonstiges"),
beispiel("Der Kurier hat das Rad beim Nachbarn abgegeben, der ist aber verreist.", "lieferung"),
beispiel("Ich möchte per Überweisung statt mit Karte zahlen.", "rechnung"),
beispiel("Können Sie meine Scheibenbremsen entlüften?", "werkstatt"),
beispiel("Sucht ihr noch Aushilfen für den Sommer?", "sonstiges"),
]
# Beispiele zum Prüfen, die beim Lernen nicht vorkommen
pruefung = [
beispiel("Die Sendungsnummer funktioniert nicht.", "lieferung"),
beispiel("Bitte schicken Sie mir eine Kopie der Rechnung vom März.", "rechnung"),
beispiel("Das Hinterrad eiert seit dem Sturz.", "werkstatt"),
beispiel("Kann ich bei euch einen Gutschein kaufen?", "sonstiges"),
beispiel("Mein Paket wurde als zugestellt markiert, ist aber nicht da.", "lieferung"),
beispiel("Ich wurde für die Bestellung zweimal belastet.", "rechnung"),
beispiel("Die Kette quietscht, obwohl ich sie geölt habe.", "werkstatt"),
beispiel("Wie lange habt ihr heute auf?", "sonstiges"),
beispiel("Der Karton kam beschädigt an.", "lieferung"),
beispiel("Die Mahnung ist doch längst bezahlt.", "rechnung"),
]
def richtig(beispiel, vorhersage, trace=None):
"""Bewertung: 1, wenn die Abteilung stimmt, sonst 0."""
return beispiel.abteilung == vorhersage.abteilung.strip().lower()
pruefen = dspy.Evaluate(devset=pruefung, metric=richtig, display_progress=False)
einfach = dspy.Predict(Anfrage)
print("Vorher:", pruefen(einfach).score, "%")
optimierer = dspy.BootstrapFewShot(metric=richtig, max_bootstrapped_demos=4, max_labeled_demos=4)
optimiert = optimierer.compile(einfach, trainset=training)
print("Nachher:", pruefen(optimiert).score, "%")
optimiert.save("anfrage.json")
dspy.Example– ein Beispiel mit Eingabe und erwartetem Ergebnis.with_inputs("nachricht")legt fest, welches Feld Eingabe ist.- Metrik:
richtigbewertet eine Vorhersage. Sie ist der Maßstab, an dem DSPy misst und optimiert. dspy.Evaluate– lässt das Programm alle Prüfbeispiele beantworten und liefert den Anteil richtiger Antworten.BootstrapFewShot– lässt das Programm die Lernbeispiele bearbeiten, behält die richtig gelösten und setzt bis zu vier davon als Musterbeispiele in den Prompt.save– speichert das optimierte Programm samt ausgewählter Beispiele als JSON. Ein neuesdspy.Predict(Anfrage)lädt es mit.load("anfrage.json")wieder.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Programm ausführen
Der Lauf dauert etwa eine halbe Minute.
python optimieren.py
Prüfen: Zwischen Meldungen von DSPy stehen die Zeilen:
Vorher: 80.0 %
Nachher: 100.0 %
Im Test ordnete das einfache Programm „Ich wurde für die Bestellung zweimal belastet.“ der Lieferung statt der Rechnung zu und „Wie lange habt ihr heute auf?“ der Werkstatt statt „sonstiges“. Mit den vier Musterbeispielen im Prompt waren alle zehn Prüfbeispiele richtig. Das Ergebnis war auch ohne Zwischenspeicher bei wiederholten Läufen gleich. Im Ordner liegt jetzt anfrage.json mit den ausgewählten Beispielen.
Wie geht es weiter?
- Nachdenken lassen:
dspy.ChainOfThought(Stimmung)stattdspy.Predictfügt ein Feldreasoninghinzu, in dem das Modell vor der Antwort überlegt. - Kurzschreibweise: Einfache Signaturen lassen sich als Text schreiben, z. B.
dspy.Predict("frage -> antwort"). - Agenten:
dspy.ReAct(Signatur, tools=[funktion])baut einen Agenten, der Python-Funktionen als Werkzeuge aufruft. - Stärkere Optimierer:
MIPROv2undGEPAschreiben auch die Aufgabenbeschreibung um und probieren viele Varianten aus. Sie brauchen mehr Beispiele und deutlich mehr Anfragen an das Modell. - Dokumentation: https://dspy.ai
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung und anfrage.json.
rm -rf ~/agent-dspy
3. Zwischenspeicher von DSPy entfernen
Löscht die gespeicherten Antworten des Modells.
rm -rf ~/.dspy_cache
4. Zwischenspeicher von pip leeren (optional)
pip bewahrt heruntergeladene Pakete in ~/.cache/pip auf. Der Befehl leert den ganzen Speicher. Das betrifft alle Python-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
pip cache purge
Quellen und Lizenz
- Offizielle Dokumentation: https://dspy-docs.vercel.app/
- Lizenz: DSPy steht unter der MIT.
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.
CrewAI
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
CrewAI ist ein Python-Framework, mit dem mehrere KI-Agenten als Team („Crew“) zusammenarbeiten. Jeder Agent bekommt eine Rolle, ein Ziel und eine kurze Vorgeschichte. Aufgaben werden den Agenten zugeteilt und der Reihe nach erledigt. Das Ergebnis einer Aufgabe fließt dabei in die nächste ein.
Vorbemerkungen
- Die Bausteine: Ein
Agentist eine Rolle, etwa „Lagerverwalter“. EineTaskbeschreibt eine Aufgabe und das erwartete Ergebnis. EineCrewfasst Agenten und Aufgaben zusammen und startet die Arbeit mitkickoff(). - Sprachmodell: CrewAI spricht OpenAI, Anthropic, Google und viele andere Anbieter an. Diese Anleitung verwendet ein lokales Modell über Ollama. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. - Python-Version: CrewAI 1.15 läuft nur mit Python 3.10 bis 3.13. Ubuntu 26.04 bringt Python 3.14 mit, ältere Versionen gibt es in den Paketquellen nicht. Die Anleitung verwendet deshalb wie bei Microsoft GraphRAG den Paketmanager uv. Er lädt für das Projekt ein eigenes Python 3.13 herunter und lässt das Python von Ubuntu unverändert.
- Nutzungsdaten: CrewAI schickt von sich aus anonyme Nutzungsdaten an den Hersteller. Die Beispiele schalten das mit der Umgebungsvariablen
CREWAI_DISABLE_TELEMETRYab. - Platzbedarf: Die virtuelle Umgebung belegt rund 750 MB, dazu kommen etwa 800 MB im Zwischenspeicher von uv und 110 MB für Python 3.13.
- Version: Getestet mit CrewAI 1.15.23, uv 0.12 und Python 3.13.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von pipx kennt.
sudo apt update
2. pipx installieren
pipx installiert Python-Programme jeweils in eine eigene Umgebung. Ist es schon vorhanden, meldet apt das nur.
sudo apt install pipx
3. uv installieren
Legt die Befehle uv und uvx in ~/.local/bin ab.
pipx install uv
Prüfen: Die Versionsnummer erscheint, z. B. uv 0.12.21. Fehlt der Befehl, pipx ensurepath ausführen und ein neues Terminal öffnen.
uv --version
4. Projektordner anlegen
mkdir ~/agent-crewai
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-crewai
6. Virtuelle Umgebung mit Python 3.13 anlegen
uv lädt Python 3.13 nach ~/.local/share/uv herunter und legt damit im Unterordner .venv eine eigene Python-Umgebung an.
uv venv --python 3.13
Prüfen: Die Ausgabe beginnt mit Using CPython 3.13.
7. CrewAI installieren
uv findet den Ordner .venv im aktuellen Ordner von selbst und installiert CrewAI samt Abhängigkeiten hinein.
uv pip install crewai
8. Virtuelle Umgebung aktivieren
Danach verwendet python das Python 3.13 der Umgebung. Die Eingabezeile beginnt mit (agent-crewai). In jedem neuen Terminal muss die Umgebung erneut aktiviert werden.
source .venv/bin/activate
Prüfen: Die Ausgabe lautet 1.15.23 oder eine neuere Version.
python -c "import crewai; print(crewai.__version__)"
Beispiel 1: Ein Agent, eine Aufgabe
9. Programm anlegen
Ein einzelner Agent schreibt aus ein paar Stichpunkten einen kurzen Werbetext für ein Fahrrad.
nano erste.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
import os
# Keine anonymen Nutzungsdaten an CrewAI senden
os.environ["CREWAI_DISABLE_TELEMETRY"] = "true"
from crewai import Agent, Crew, LLM, Task
# Lokales Modell über Ollama
llm = LLM(model="ollama/qwen3:4b-instruct", base_url="http://localhost:11434")
texter = Agent(
role="Werbetexter",
goal="Kurze, ansprechende Produkttexte auf Deutsch schreiben",
backstory="Du schreibst seit Jahren Texte für den Onlineshop eines Fahrradladens. "
"Du verwendest nur die Angaben, die du bekommst, und erfindest nichts dazu.",
llm=llm,
)
beschreiben = Task(
description="Schreibe eine Produktbeschreibung für dieses Fahrrad: {angaben}",
expected_output="Zwei bis drei Sätze ohne Überschrift",
agent=texter,
)
crew = Crew(agents=[texter], tasks=[beschreiben])
ergebnis = crew.kickoff(
inputs={"angaben": "Citybike Hansa, 7-Gang-Nabenschaltung, Nabendynamo, Gepäckträger, 16 kg"}
)
print(ergebnis.raw)
- Umgebungsvariable: Sie muss gesetzt sein, bevor
crewaigeladen wird. Deshalb steht sie ganz oben. - Modell:
ollama/…wählt Ollama,base_urlist die Adresse des Ollama-Dienstes. Einen API-Schlüssel braucht Ollama nicht. role,goal,backstory– daraus baut CrewAI die Anweisungen an das Modell. Je genauer die Vorgeschichte, desto besser hält sich der Agent an seine Rolle.expected_output– sagt dem Agenten, wie das Ergebnis aussehen soll.{angaben}– ein Platzhalter.kickoff(inputs=…)setzt den Text dort ein. So lässt sich dieselbe Crew mit anderen Eingaben wiederverwenden.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm ausführen
python erste.py
Prüfen: Nach einigen Sekunden erscheinen zwei bis drei Sätze über das Citybike, die Schaltung, Dynamo, Gepäckträger und Gewicht nennen. Im Test mischte das kleine Modell einzelne englische Wörter ein und machte Tippfehler („perfaktes“). Größere Modelle schreiben deutlich sauberer.
Beispiel 2: Zwei Agenten mit Werkzeug
11. Programm anlegen
Ein Kunde fragt per E-Mail, ob bestimmte Räder vorrätig sind. Der erste Agent sieht mit einem Werkzeug im Lager nach. Der zweite schreibt mit diesem Ergebnis die Antwort an den Kunden.
nano laden.py
Füge diesen Inhalt ein:
import os
# Keine anonymen Nutzungsdaten an CrewAI senden
os.environ["CREWAI_DISABLE_TELEMETRY"] = "true"
from crewai import Agent, Crew, LLM, Process, Task
from crewai.tools import tool
llm = LLM(model="ollama/qwen3:4b-instruct", base_url="http://localhost:11434", temperature=0)
LAGER = {"citybike": 4, "trekkingrad": 0, "lastenrad": 1}
@tool("Lagerbestand")
def lagerbestand(modell: str) -> str:
"""Gibt zurück, wie viele Räder eines Modells (citybike, trekkingrad, lastenrad) im Lager sind."""
anzahl = LAGER.get(modell.strip().lower())
if anzahl is None:
return f"Das Modell {modell} führen wir nicht."
return f"{modell}: {anzahl} Stück auf Lager"
lager = Agent(
role="Lagerverwalter",
goal="Den Lagerbestand genau ermitteln",
backstory="Du arbeitest im Lager eines Fahrradladens und schaust jeden Bestand im System nach, statt zu raten.",
tools=[lagerbestand],
llm=llm,
)
service = Agent(
role="Kundenservice",
goal="Freundliche, kurze Antworten an Kunden schreiben",
backstory="Du beantwortest E-Mails von Kunden eines Fahrradladens auf Deutsch.",
llm=llm,
)
nachsehen = Task(
description="Ein Kunde fragt: {anfrage}\nSieh für jedes erwähnte Modell den Bestand nach.",
expected_output="Für jedes Modell eine Zeile mit dem Bestand",
agent=lager,
)
antworten = Task(
description="Schreibe dem Kunden eine Antwort auf seine Anfrage: {anfrage}",
expected_output="Eine E-Mail mit höchstens fünf Sätzen auf Deutsch",
agent=service,
context=[nachsehen],
)
crew = Crew(
agents=[lager, service],
tasks=[nachsehen, antworten],
process=Process.sequential,
verbose=True,
)
ergebnis = crew.kickoff(
inputs={"anfrage": "Habt ihr ein Trekkingrad oder ein Lastenrad da? Ich würde es am Samstag abholen."}
)
print(ergebnis.raw)
@tool– macht aus einer Python-Funktion ein Werkzeug. Der Docstring erklärt dem Modell, wofür es da ist. Die Typangabemodell: strlegt den Parameter fest.tools=[lagerbestand]– nur der Lagerverwalter darf das Werkzeug benutzen.context=[nachsehen]– das Ergebnis der ersten Aufgabe wird der zweiten mitgegeben. Der Kundenservice kennt also den Bestand, ohne selbst nachzusehen.Process.sequential– die Aufgaben laufen in der angegebenen Reihenfolge. Die AlternativeProcess.hierarchicalsetzt einen zusätzlichen Leiter-Agenten ein, der die Aufgaben selbst verteilt.temperature=0– das Modell antwortet möglichst gleichbleibend. Das macht Werkzeugaufrufe kleiner Modelle zuverlässiger.verbose=True– zeigt jeden Arbeitsschritt im Terminal an.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
Der Lauf dauert etwa eine halbe Minute.
python laden.py
Prüfen: In umrahmten Kästen zeigt CrewAI, welcher Agent gerade arbeitet. Unter Tool Execution steht zweimal das Werkzeug lagerbestand, einmal mit trekkingrad (Ergebnis 0 Stück) und einmal mit lastenrad (Ergebnis 1 Stück). Am Ende steht die E-Mail, im Test sinngemäß:
Hallo,
zu Ihrem Anliegen haben wir derzeit ein Lastenrad auf Lager – ein Trekkingrad ist leider nicht verfügbar.
Das Lastenrad können Sie am Samstag abholen.
Der letzte Kasten „Tracing Status“ weist nur darauf hin, dass die Ablaufaufzeichnung für den Onlinedienst des Herstellers ausgeschaltet ist. Das ist gewollt.
Wie geht es weiter?
- Projektvorlage: Der Befehl
crewai create crew NAMElegt ein Projekt an, in dem Agenten und Aufgaben in YAML-Dateien stehen statt im Python-Code. Das ist bei größeren Crews übersichtlicher. - Flows: Mit
Flowsteuert man den Ablauf selbst, etwa mit Verzweigungen, und ruft Crews als einzelne Schritte auf. - Gedächtnis:
Crew(memory=True)lässt Agenten sich an frühere Läufe erinnern. Dafür braucht CrewAI ein Modell für Einbettungen, z. B.nomic-embed-textüber Ollama. - Fertige Werkzeuge: Das Paket
crewai-toolsbringt Werkzeuge zum Lesen von Dateien, Webseiten und Datenbanken mit. - Dokumentation: https://docs.crewai.com
Deinstallieren
1. Virtuelle Umgebung verlassen
deactivate
2. Projekt entfernen
Löscht den Projektordner samt virtueller Umgebung.
rm -rf ~/agent-crewai
3. Daten von CrewAI entfernen
CrewAI legt unter ~/.local/share einen Ordner mit dem Namen des Projektordners an (Ergebnisse des letzten Laufs) und einen Ordner crewai mit einem Schlüssel für gespeicherte Anmeldedaten.
rm -rf ~/.local/share/agent-crewai ~/.local/share/crewai
4. Zwischenspeicher von uv leeren
uv hebt heruntergeladene Pakete auf, im Test rund 800 MB. Der Befehl leert den ganzen Speicher, also auch den anderer Projekte, die uv verwenden.
uv cache clean
5. Python 3.13 von uv entfernen (optional)
Nur ausführen, wenn kein anderes Projekt das Python 3.13 von uv braucht, z. B. Microsoft GraphRAG. Das Python von Ubuntu bleibt unberührt.
uv python uninstall 3.13
6. uv entfernen (optional)
Nur ausführen, wenn uv nicht mehr gebraucht wird.
pipx uninstall uv
Prüfen: Der Befehl uv wird nicht mehr gefunden.
uv --version
7. pipx entfernen (optional)
Nur ausführen, wenn keine anderen Programme mit pipx installiert sind. pipx list zeigt sie an.
sudo apt purge pipx
8. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt Pakete, die nur für pipx mitinstalliert wurden. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.crewai.com/
- Lizenz: CrewAI steht unter der MIT.
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.
Mastra
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Mastra ist ein Framework für TypeScript, mit dem man KI-Agenten und Workflows baut. Agenten rufen selbstständig Werkzeuge auf. Workflows legen dagegen eine feste Abfolge von Schritten fest, prüfen dabei jede Ein- und Ausgabe und können einzelne Schritte einem Agenten übergeben. Mastra baut auf dem Vercel AI SDK auf und läuft in Node.js.
Vorbemerkungen
- Agent oder Workflow: Bei einem Agenten entscheidet das Sprachmodell, welche Werkzeuge es wann aufruft. Bei einem Workflow bestimmt der Programmcode die Reihenfolge, und das Modell erledigt nur die Schritte, in denen Sprache gebraucht wird. Die Anleitung zeigt beides.
- Sprachmodell: Mastra spricht OpenAI, Anthropic, Google und viele andere Anbieter an. Diese Anleitung verwendet ein lokales Modell über Ollama und seine OpenAI-kompatible Schnittstelle. Es fallen also keine Kosten an und keine Daten verlassen den Rechner.
- Voraussetzung: Ein laufendes Ollama mit dem Modell
qwen3:4b-instruct. Es kann Werkzeuge aufrufen. - Node.js aus Ubuntu: Mastra braucht Node.js 22.13 oder neuer. Ubuntu 26.04 liefert Node.js 22.22, das reicht. TypeScript-Dateien startet die Anleitung wie beim Vercel AI SDK mit dem kleinen Werkzeug
tsx, weil das Node.js von Ubuntu das nicht selbst kann. - Installation pro Projekt: Die Pakete lädt
npmin den Projektordner, zusammen rund 180 MB. - Version: Getestet mit @mastra/core 1.74.0, zod 4.6, tsx 4.23 und TypeScript 7.0 unter Node.js 22.22 und npm 9.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Ist beides schon vorhanden (z. B. aus der Anleitung Vercel AI SDK), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer beginnt mit v22 oder höher.
node --version
3. Projektordner anlegen
mkdir ~/agent-mastra
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/agent-mastra
5. Projekt anlegen
Legt die Datei package.json an, in der npm die Pakete des Projekts festhält.
npm init -y
6. Moderne Module einschalten
Mit ES-Modulen funktionieren import … from … und await direkt in der Datei.
npm pkg set type=module
7. Mastra installieren
@mastra/core– Agenten, Werkzeuge, Workflows und die Anbindung der Sprachmodellezod– beschreibt, welche Daten ein Werkzeug oder ein Schritt erwartet, und prüft sie
npm install @mastra/core zod
Prüfen: Die Ausgabe endet mit found 0 vulnerabilities.
8. Werkzeuge für TypeScript installieren
tsx führt TypeScript-Dateien aus, typescript prüft die Typen, @types/node beschreibt die Typen von Node.js 22. --save-dev kennzeichnet sie als reine Entwicklungswerkzeuge.
npm install --save-dev tsx typescript @types/node@22
Prüfen: Die Liste nennt @mastra/core@1.74.0 (oder neuer), zod, tsx, typescript und @types/node.
npm ls --depth=0
Beispiel 1: Ein Agent mit Werkzeug
9. Programm anlegen
Ein Agent im Verkauf eines Fahrradladens beantwortet eine Kundenfrage. Den Lagerbestand sieht er mit einem Werkzeug nach.
nano agent.ts
Füge diesen Inhalt ein (Strg+Umschalt+V):
import { Agent } from "@mastra/core/agent";
import { createTool } from "@mastra/core/tools";
import { z } from "zod";
const LAGER: Record<string, number> = { citybike: 4, trekkingrad: 0, lastenrad: 1 };
const lagerbestand = createTool({
id: "lagerbestand",
description: "Gibt zurück, wie viele Räder eines Modells (citybike, trekkingrad, lastenrad) im Lager sind.",
inputSchema: z.object({ modell: z.string().describe("Name des Modells, z. B. citybike") }),
outputSchema: z.object({ modell: z.string(), anzahl: z.number().nullable() }),
execute: async ({ modell }) => {
console.log(` [Werkzeug] lagerbestand(${modell})`);
return { modell, anzahl: LAGER[modell.toLowerCase()] ?? null };
},
});
const agent = new Agent({
id: "verkauf",
name: "Verkauf",
instructions:
"Du arbeitest im Verkauf eines Fahrradladens und antwortest kurz auf Deutsch. " +
"Sieh den Bestand immer mit dem Werkzeug lagerbestand nach.",
// Ollama über die OpenAI-kompatible Schnittstelle
model: { id: "ollama/qwen3:4b-instruct", url: "http://localhost:11434/v1" },
tools: { lagerbestand },
});
const antwort = await agent.generate("Habt ihr ein Trekkingrad oder ein Lastenrad da?");
console.log(antwort.text);
createTool– beschreibt ein Werkzeug. AusdescriptionundinputSchemaerfährt das Modell, wofür das Werkzeug da ist und welche Angaben es braucht.outputSchemalegt fest, was zurückkommt.model–idbesteht aus einem frei wählbaren Anbieternamen und dem Modellnamen.urlzeigt auf die Schnittstelle von Ollama. Ein API-Schlüssel ist nicht nötig.generate– schickt die Frage an den Agenten. Er ruft Werkzeuge auf, so oft er sie braucht, und liefert am Ende die Antwort intext.console.logim Werkzeug – zeigt, wann das Modell das Werkzeug aufruft.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm ausführen
npx startet das Programm tsx aus dem Projektordner.
npx tsx agent.ts
Prüfen: Nach einigen Sekunden erscheint etwa Folgendes. Der letzte Satz ist bei jedem Lauf etwas anders formuliert:
[Werkzeug] lagerbestand(trekkingrad)
[Werkzeug] lagerbestand(lastenrad)
Wir haben kein Trekkingrad im Lager, aber ein Lastenrad.
Der Agent hat das Werkzeug für beide Modelle aufgerufen und die Ergebnisse in einem Satz zusammengefasst.
Beispiel 2: Ein Workflow
11. Programm anlegen
Ein Workflow erzeugt einen Werbetext für ein Fahrrad in zwei festen Schritten. Der erste Schritt bereitet die Angaben als Stichpunkte auf und braucht dafür kein Sprachmodell. Der zweite gibt die Stichpunkte an einen Agenten, der daraus den Text schreibt. Ein zweiter Lauf zeigt, dass Mastra unvollständige Angaben gar nicht erst annimmt.
nano workflow.ts
Füge diesen Inhalt ein:
import { Agent } from "@mastra/core/agent";
import { createStep, createWorkflow } from "@mastra/core/workflows";
import { z } from "zod";
const texter = new Agent({
id: "texter",
name: "Texter",
instructions:
"Du schreibst kurze Produkttexte für einen Fahrradladen auf Deutsch. " +
"Verwende nur die Angaben, die du bekommst.",
model: { id: "ollama/qwen3:4b-instruct", url: "http://localhost:11434/v1" },
});
// Schritt 1: Angaben als Stichpunkte aufbereiten (ohne Sprachmodell)
const aufbereiten = createStep({
id: "aufbereiten",
inputSchema: z.object({
name: z.string(),
merkmale: z.array(z.string()).min(1),
preis: z.number().positive(),
}),
outputSchema: z.object({ stichpunkte: z.string() }),
execute: async ({ inputData }) => {
const preis = inputData.preis.toLocaleString("de-DE", { style: "currency", currency: "EUR" });
const zeilen = [inputData.name, ...inputData.merkmale, `Preis: ${preis}`];
return { stichpunkte: zeilen.map((zeile) => `- ${zeile}`).join("\n") };
},
});
// Schritt 2: Der Agent schreibt aus den Stichpunkten einen Text
const schreiben = createStep({
id: "schreiben",
inputSchema: z.object({ stichpunkte: z.string() }),
outputSchema: z.object({ text: z.string() }),
execute: async ({ inputData }) => {
const antwort = await texter.generate(
`Schreibe zwei Sätze Werbetext aus diesen Angaben:\n${inputData.stichpunkte}`,
);
return { text: antwort.text };
},
});
const produkttext = createWorkflow({
id: "produkttext",
inputSchema: aufbereiten.inputSchema,
outputSchema: schreiben.outputSchema,
})
.then(aufbereiten)
.then(schreiben)
.commit();
// Erster Lauf mit vollständigen Angaben
const lauf = await produkttext.createRun();
const ergebnis = await lauf.start({
inputData: {
name: "Lastenrad Elbe",
merkmale: ["Elektromotor", "Kindersitzbank für zwei Kinder", "Regenverdeck"],
preis: 3490,
},
});
console.log("Status:", ergebnis.status);
if (ergebnis.status === "success") {
console.log(ergebnis.result.text);
}
// Zweiter Lauf ohne Merkmale: Mastra prüft die Eingabe und lehnt sie ab
try {
const lauf2 = await produkttext.createRun();
await lauf2.start({ inputData: { name: "Citybike Hansa", merkmale: [], preis: 899 } });
} catch (fehler) {
console.log("Abgelehnt:", (fehler as Error).message);
}
createStep– ein Schritt mit eigenem Ein- und Ausgabeschema.executeist normaler TypeScript-Code und kann, muss aber kein Sprachmodell aufrufen.z.array(…).min(1)undz.number().positive()– Regeln für die Eingabe: mindestens ein Merkmal und ein Preis über null..then(…)– hängt Schritte aneinander. Die Ausgabe vonaufbereitenpasst zur Eingabe vonschreiben. Passen die Schemas nicht zusammen, meldet TypeScript schon beim Prüfen der Typen einen Fehler..commit()– schließt den Aufbau des Workflows ab.createRunundstart– starten einen Lauf. Das Ergebnis enthält denstatusund bei Erfolg unterresultdie Ausgabe des letzten Schritts.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm ausführen
npx tsx workflow.ts
Prüfen: Die Ausgabe sieht etwa so aus. Der Werbetext ändert sich von Lauf zu Lauf:
Status: success
Das Lastenrad Elbe mit Elektromotor ist die perfekte Lösung für Familien – mit Sitzbank für zwei Kinder und praktischem Regenverdeck. Preis: 3.490,00 €.
Abgelehnt: Invalid input data:
- merkmale: Too small: expected array to have >=1 items
Im ersten Lauf hat der Agent alle Angaben und den Preis im deutschen Format übernommen. Der zweite Lauf hat das Sprachmodell gar nicht erst erreicht, weil die Liste der Merkmale leer war. Kleine Modelle bilden dabei gelegentlich holprige Wörter.
13. Typen prüfen
tsx führt den Code nur aus und prüft die Typen nicht. Das übernimmt der TypeScript-Compiler tsc. --noEmit prüft nur, ohne JavaScript-Dateien zu schreiben.
npx tsc --noEmit --strict --module nodenext --target es2022 --skipLibCheck --types node agent.ts workflow.ts
Prüfen: Der Befehl gibt nichts aus. Bei Fehlern nennt er Datei, Zeile und Grund.
Wie geht es weiter?
- Projektvorlage und Studio:
npm create mastra@latestlegt ein vollständiges Projekt an. Darin startetnpm run devdas Mastra Studio, eine Weboberfläche im Browser, in der man mit Agenten chattet, Workflows startet und jeden Schritt nachverfolgt. - Gedächtnis: Mit den Paketen
@mastra/memoryund@mastra/libsqlmerkt sich ein Agent frühere Gespräche in einer SQLite-Datei. - Verzweigungen im Workflow: Neben
.then()gibt es.parallel()für gleichzeitige Schritte,.branch()für Wenn-dann-Abzweigungen und Schleifen. Workflows können außerdem anhalten und auf eine Freigabe durch den Menschen warten. - Andere Anbieter: Mit einer Modellangabe wie
model: "anthropic/…"und dem passenden Schlüssel in einer Umgebungsvariable wechselt man zu einem Cloud-Anbieter. - Dokumentation: https://mastra.ai/docs
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt node_modules.
rm -rf ~/agent-mastra
2. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
3. Node.js und npm entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. das Vercel AI SDK, Express oder Next.js.
sudo apt purge nodejs npm
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://mastra.ai/docs
- Lizenz: Mastra steht unter der Apache-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.
Spring Boot
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Spring Boot ist ein Framework für Java, mit dem man Webanwendungen, REST-Schnittstellen und Hintergrunddienste schnell aufsetzt. Es bringt einen eingebauten Webserver mit und richtet vieles selbst ein. Eine fertige Anwendung ist eine einzelne .jar-Datei, die sich mit java -jar starten lässt.
Vorbemerkungen
- Keine Installation im engeren Sinn: Spring Boot wird nicht auf dem System installiert, sondern gehört als Abhängigkeit zu jedem Projekt. Aus den Ubuntu-Paketquellen kommt nur das Java-Entwicklungspaket (JDK).
- Projekt anlegen mit Spring Initializr: Der offizielle Dienst https://start.spring.io erzeugt ein fertiges Projektgerüst. Diese Anleitung ruft ihn mit
curlauf, im Browser geht es genauso. - Maven Wrapper: Das Projekt enthält das Skript
./mvnw. Es lädt beim ersten Aufruf automatisch das Build-Werkzeug Maven in der passenden Version herunter. Ein systemweites Maven ist nicht nötig. - Versionen: Spring Boot 4.1.1 und Java 25. Java 25 ist die aktuelle Version mit Langzeitunterstützung (LTS) und das Standard-JDK von Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von JDK und Hilfsprogrammen kennt.
sudo apt update
2. JDK und Hilfsprogramme installieren
default-jdk– Java-Entwicklungspaket (Compiler und Laufzeitumgebung) in der Standardversion von Ubuntu. Ist es schon vorhanden (z. B. aus der IntelliJ-IDEA-Anleitung), meldetaptdas nur.curl– lädt das Projektgerüst von Spring Initializr herunterunzip– entpackt es
sudo apt install default-jdk curl unzip
Prüfen: Die Ausgabe nennt eine Java-Version ab 25, z. B. openjdk version "25…".
java -version
Ist zusätzlich eine neuere Java-Version installiert (z. B. 26), wird diese angezeigt. Das ist in Ordnung: Sie kann Projekte für Java 25 ebenfalls übersetzen.
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im Ordner ~/hallo angelegt.
cd ~
4. Projektgerüst herunterladen
Fordert bei Spring Initializr ein fertiges Projekt als ZIP-Datei an. Die Angaben bedeuten:
type=maven-project– Build mit Maven (Alternative:gradle-project)bootVersion,javaVersion– Spring-Boot- und Java-VersiongroupId,artifactId,packageName– Namen für Projekt und Java-Paket. DiegroupIdist üblicherweise eine umgedrehte Domain.dependencies=web,actuator– die gewünschten Bausteine:webfür Webanwendungen und REST-Schnittstellen mit eingebautem Webserver (Tomcat),actuatorfür Betriebsinformationen wie den Gesundheitszustand
curl https://start.spring.io/starter.zip -d type=maven-project -d bootVersion=4.1.1 -d javaVersion=25 -d groupId=de.beispiel -d artifactId=hallo -d packageName=de.beispiel.hallo -d dependencies=web,actuator -o hallo.zip
Prüfen: Die Datei ist ein ZIP-Archiv.
file hallo.zip
5. Projekt entpacken
Entpackt das Archiv in den Ordner ~/hallo.
unzip hallo.zip -d hallo
6. ZIP-Datei löschen
Das Archiv wird nicht mehr gebraucht.
rm hallo.zip
7. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/hallo
Prüfen: Unter anderem werden pom.xml (Projektbeschreibung für Maven), mvnw (Maven Wrapper) und der Ordner src angezeigt.
ls
Eine REST-Schnittstelle schreiben
8. Controller anlegen
Ein Controller beantwortet HTTP-Anfragen. Die Klasse liegt neben der von Initializr erzeugten Startklasse HalloApplication.java, damit Spring Boot sie automatisch findet. Die Anmerkungen (Annotationen) steuern das Verhalten:
@RestController– die Klasse liefert Daten (hier JSON), keine HTML-Seiten@GetMapping("/hallo")– die Methode beantwortetGET-Anfragen an/hallo@RequestParam(defaultValue = "Welt")– liest den Parameternameaus der Adresse, ohne Angabe gilt „Welt“
Spring Boot wandelt die zurückgegebene Map automatisch in JSON um.
nano src/main/java/de/beispiel/hallo/HalloController.java
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
package de.beispiel.hallo;
import java.util.Map;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
// Eine REST-Schnittstelle: Die Klasse beantwortet HTTP-Anfragen
@RestController
public class HalloController {
// GET /hallo?name=... liefert eine Begrüßung als JSON
@GetMapping("/hallo")
public Map<String, String> hallo(@RequestParam(defaultValue = "Welt") String name) {
return Map.of("gruss", "Hallo " + name + "!");
}
}
9. Anwendung nur lokal erreichbar machen
Ohne weitere Angabe ist der eingebaute Webserver aus dem ganzen Netz erreichbar. Diese Zeilen in der Einstellungsdatei beschränken ihn auf den eigenen Rechner und legen den Port 8080 ausdrücklich fest.
nano src/main/resources/application.properties
Springe mit Strg+Ende ans Ende der Datei und füge in eigenen Zeilen an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
server.address=127.0.0.1
server.port=8080
Prüfen: Die Datei enthält drei Zeilen: den Anwendungsnamen und die beiden neuen Einstellungen.
cat src/main/resources/application.properties
Starten und testen
10. Anwendung im Entwicklungsmodus starten
spring-boot:run übersetzt das Projekt und startet die Anwendung direkt. Beim ersten Aufruf lädt der Maven Wrapper Maven und alle Bibliotheken herunter (etwa 70 MB, nach ~/.m2). Das dauert eine Weile, spätere Starts gehen schnell. Das Terminal bleibt belegt, solange die Anwendung läuft.
./mvnw spring-boot:run
Prüfen: Die Ausgabe endet mit Zeilen wie Tomcat started on port 8080 und Started HalloApplication in … seconds.
11. REST-Schnittstelle aufrufen
Öffne ein zweites Terminal und frage die neue Schnittstelle ab.
curl "http://localhost:8080/hallo?name=Thorsten"
Prüfen: Die Antwort lautet {"gruss":"Hallo Thorsten!"}. Ohne ?name=… kommt {"gruss":"Hallo Welt!"}.
12. Gesundheitszustand abfragen
Der Baustein Actuator stellt unter /actuator/health den Zustand der Anwendung bereit. Überwachungswerkzeuge fragen diese Adresse regelmäßig ab. Weitere Actuator-Endpunkte sind aus Sicherheitsgründen zunächst abgeschaltet.
curl http://localhost:8080/actuator/health
Prüfen: Die Antwort enthält "status":"UP".
13. Anwendung beenden
Wechsle in das erste Terminal und drücke Strg+C.
Fertige Anwendung bauen
14. JAR-Datei erzeugen
package übersetzt das Projekt, führt die mitgelieferten Tests aus und packt alles, einschließlich Webserver und Bibliotheken, in eine einzige Datei. Die Warnungen zu Mockito und Java agent während der Tests sind harmlos.
./mvnw package
Prüfen: Die Ausgabe endet mit BUILD SUCCESS, und im Ordner target liegt die Datei hallo-0.0.1-SNAPSHOT.jar (etwa 22 MB).
ls -lh target/*.jar
15. JAR-Datei starten
So wird die Anwendung auch auf einem Server gestartet. Außer Java wird dort nichts gebraucht.
java -jar target/hallo-0.0.1-SNAPSHOT.jar
Prüfen: Im zweiten Terminal liefert curl http://localhost:8080/hallo wieder {"gruss":"Hallo Welt!"}. Mit Strg+C beendest du die Anwendung.
Wie geht es weiter?
- Entwicklungsumgebung: IntelliJ IDEA öffnet das Projekt direkt über die Datei
pom.xml. In VS Code helfen die Erweiterungen „Extension Pack for Java“ und „Spring Boot Extension Pack“, in Eclipse die „Spring Tools“ aus dem Eclipse Marketplace. - Weitere Bausteine: Auf https://start.spring.io findest du alle verfügbaren Abhängigkeiten, z. B.
data-jpaundpostgresqlfür den Zugriff auf PostgreSQL,securityfür Anmeldung und Rechte oderdevtoolsfür automatischen Neustart bei Codeänderungen. - KI-Anbindung: Mit dem Projekt Spring AI lassen sich Sprachmodelle und Vektordatenbanken wie pgvector, Qdrant oder Milvus einbinden.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner mit Quellcode und gebauter JAR-Datei. Achtung: Eigene Änderungen am Projekt gehen verloren.
rm -rf ~/hallo
2. Maven-Downloads entfernen
Der Maven Wrapper hat Maven nach ~/.m2/wrapper und alle Bibliotheken nach ~/.m2/repository geladen. Behalte den Ordner, wenn du weitere Java-Projekte mit Maven hast, sonst müssen sie alles neu herunterladen.
rm -rf ~/.m2
3. Optional: JDK entfernen
Nur ausführen, wenn kein anderes Programm Java braucht (z. B. IntelliJ IDEA oder Eclipse). curl und unzip brauchen viele andere Programme, sie bleiben deshalb installiert.
sudo apt purge default-jdk
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/hallo
Quellen und Lizenz
- Offizielle Dokumentation: https://spring.io/projects/spring-boot
- Lizenz: Spring Boot steht unter der Apache-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.
Quarkus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Quarkus ist ein Java-Framework für Webanwendungen und Schnittstellen, das auf schnellen Start und wenig Speicherbedarf ausgelegt ist. Es verwendet bekannte Java-Standards wie Jakarta REST für Routen und CDI für Dependency Injection. Im Entwicklungsmodus übersetzt Quarkus geänderten Code bei der nächsten Anfrage selbst neu, ohne dass man den Server neu startet.
Vorbemerkungen
- Installation pro Projekt: Wie Spring Boot gehört Quarkus als Abhängigkeit zu jedem Projekt. Aus den Ubuntu-Paketquellen kommt nur das Java-Entwicklungspaket (JDK).
- Projekt anlegen mit code.quarkus.io: Der offizielle Dienst https://code.quarkus.io erzeugt ein fertiges Projektgerüst. Diese Anleitung ruft ihn mit
curlauf, im Browser geht es genauso. - Maven Wrapper: Das Projekt enthält das Skript
./mvnw. Es lädt beim ersten Aufruf das Build-Werkzeug Maven in der passenden Version herunter. Ein systemweites Maven ist nicht nötig. Maven legt alle Bibliotheken in~/.m2ab, für dieses Projekt rund 200 MB. - Port 8000: Quarkus lauscht ohne Angabe auf Port 8080. Das Beispiel legt Port 8000 fest, weil 8080 oft schon belegt ist, etwa von Apache aus der Tileserver-Anleitung. Port 8000 darf nicht von einem anderen Programm belegt sein.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu FastAPI, Gin, NestJS und Express. Die Notizen liegen nur im Arbeitsspeicher.
- Version: Getestet mit Quarkus 3.39.5 und Java 25 aus Ubuntu 26.04. Quarkus 3.39 braucht Java 17 oder neuer, empfohlen ist Java 25.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. JDK und Hilfsprogramme installieren
default-jdk– Java-Entwicklungspaket (Compiler und Laufzeitumgebung) in der Standardversion von Ubuntu. Ist es schon vorhanden (z. B. aus der Spring-Boot-Anleitung), meldetaptdas nur.curl– lädt das Projektgerüst von code.quarkus.io herunterunzip– entpackt es
sudo apt install default-jdk curl unzip
Prüfen: Die Ausgabe nennt eine Java-Version ab 25, z. B. openjdk version "25…". Ist zusätzlich eine neuere Java-Version installiert (z. B. 26), wird diese angezeigt. Das ist in Ordnung.
java -version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projektgerüst herunterladen
Die Werte in der Adresse legen das Projekt fest:
g=de.beispiel– die Gruppe, zugleich das Java-Paket für den Codea=meinquarkus– der Name des Projekts und des Ordnersj=25– die Java-Versione=rest-jackson– die Erweiterung für Schnittstellen mit JSON (Quarkus REST mit der JSON-Bibliothek Jackson)
curl -o meinquarkus.zip "https://code.quarkus.io/d?g=de.beispiel&a=meinquarkus&j=25&e=rest-jackson"
Prüfen: Die Datei meinquarkus.zip ist rund 20 KB groß.
ls -lh meinquarkus.zip
5. Projekt entpacken
Entpackt das Gerüst in den Ordner meinquarkus.
unzip meinquarkus.zip
6. ZIP-Datei löschen
Sie wird nicht mehr gebraucht.
rm meinquarkus.zip
7. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinquarkus
Prüfen: Die Ausgabe enthält mvnw, pom.xml und src.
ls
Das Gerüst enthält schon ein Beispiel src/main/java/de/beispiel/GreetingResource.java, das unter /hello einen Text liefert, und Tests dafür. Die Dateien in src/main/docker braucht diese Anleitung nicht.
8. Port und Adresse festlegen
In application.properties stehen die Einstellungen der Anwendung. Die Datei ist noch leer.
nano src/main/resources/application.properties
Füge diesen Inhalt ein:
# Nur vom eigenen Rechner aus erreichbar, Port 8000 statt 8080
quarkus.http.host=127.0.0.1
quarkus.http.port=8000
Ohne quarkus.http.host wäre die fertige Anwendung (Schritt 17) aus dem ganzen Netz erreichbar. Nur der Entwicklungsmodus lauscht von sich aus lediglich auf localhost.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Schnittstelle schreiben
In Quarkus heißt eine Klasse mit Routen Resource. Die Datei ist neu, nano startet mit einer leeren Seite.
nano src/main/java/de/beispiel/NotizResource.java
Füge diesen Inhalt ein (Strg+Umschalt+V):
package de.beispiel;
import java.net.URI;
import java.util.List;
import java.util.Map;
import java.util.concurrent.CopyOnWriteArrayList;
import jakarta.ws.rs.DefaultValue;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.NotFoundException;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.QueryParam;
import jakarta.ws.rs.core.Response;
@Path("/")
public class NotizResource {
// So sieht eine gespeicherte Notiz aus
public record Notiz(int id, String titel) {}
// So sieht eine neue Notiz aus, die man schickt: nur ein Titel
public record NotizNeu(String titel) {}
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
private final List<Notiz> notizen = new CopyOnWriteArrayList<>();
// GET /hallo?name=... liefert eine Begrüßung als JSON
@GET
@Path("hallo")
public Map<String, String> hallo(@QueryParam("name") @DefaultValue("Welt") String name) {
return Map.of("gruss", "Hallo " + name + "!");
}
// GET /notizen liefert alle Notizen
@GET
@Path("notizen")
public List<Notiz> alle() {
return notizen;
}
// GET /notizen/1 liefert eine Notiz oder 404
@GET
@Path("notizen/{id}")
public Notiz eine(@PathParam("id") int id) {
return notizen.stream()
.filter(n -> n.id() == id)
.findFirst()
.orElseThrow(() -> new NotFoundException(Response.status(404)
.entity(Map.of("fehler", "Notiz nicht gefunden")).build()));
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
@POST
@Path("notizen")
public synchronized Response anlegen(NotizNeu daten) {
if (daten == null || daten.titel() == null || daten.titel().isEmpty()) {
return Response.status(400).entity(Map.of("fehler", "Feld \"titel\" fehlt")).build();
}
Notiz notiz = new Notiz(notizen.size() + 1, daten.titel());
notizen.add(notiz);
return Response.created(URI.create("/notizen/" + notiz.id())).entity(notiz).build();
}
}
- Annotationen –
@Pathlegt die Adresse fest,@GETund@POSTdie Methode.{id}ist ein Platzhalter. - Parameter –
@QueryParam("name")liest Werte aus der Adresse (?name=…),@DefaultValuegibt einen Vorgabewert.@PathParam("id")liest den Platzhalter und wandelt ihn in eine Zahl um. Ein Parameter ohne Annotation wieNotizNeu datenwird aus dem mitgeschickten JSON gefüllt. - Records –
NotizundNotizNeusind kurze Java-Klassen nur für Daten. Jackson macht aus ihnen JSON und umgekehrt. - Rückgabewerte – Listen, Maps und Records werden als JSON gesendet. Mit
Responsesetzt man zusätzlich Status und Kopfzeilen, z. B.Response.created(…)für Status201mitLocation. NotFoundException– bricht mit Status404und der mitgegebenen Antwort ab.CopyOnWriteArrayListundsynchronized– Quarkus bearbeitet Anfragen gleichzeitig und verwendet dafür ein einziges Objekt dieser Klasse. Beides verhindert, dass sich zwei Anfragen beim Anlegen in die Quere kommen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Starten und testen
10. Entwicklungsmodus starten
quarkus:dev übersetzt das Projekt und startet es mit Live Coding. Beim ersten Aufruf lädt ./mvnw Maven und alle Bibliotheken herunter, das dauert ein bis zwei Minuten. Das Terminal bleibt belegt.
./mvnw quarkus:dev
Beim ersten Start fragt Quarkus: Do you agree to contribute anonymous build time data to the Quarkus community? (y/n and enter). Gib n ein und drücke Enter, wenn du keine Nutzungsdaten senden möchtest.
Prüfen: Unter dem Quarkus-Schriftzug steht Listening on: http://127.0.0.1:8000 und Profile dev activated. Live Coding activated. Darunter zeigt Quarkus eine Zeile mit Tasten, z. B. [h] for more options.
11. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: http://localhost:8000/notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Quarkus ergänzt die Adresse aus Response.created selbst zu einer vollständigen Adresse.
12. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:8000/hello | Hello from Quarkus REST (Beispiel aus dem Gerüst) |
curl http://localhost:8000/gibtsnicht | Text 404 - Resource Not Found mit einer Liste aller Adressen (Status 404) |
Die Liste aller Adressen bei unbekannten Adressen gibt es nur im Entwicklungsmodus, als Hilfe beim Entwickeln. Die fertige Anwendung antwortet nur mit Resource not found. Auch /notizen/abc ergibt 404 ohne Inhalt, weil abc keine Zahl für int id ist.
13. Dev UI ansehen
Öffne http://localhost:8000/q/dev-ui im Browser. Die Oberfläche gibt es nur im Entwicklungsmodus. Sie zeigt unter anderem die installierten Erweiterungen, unter Endpoints alle Adressen und unter Configuration alle Einstellungen, die man in application.properties setzen kann.
14. Live Coding ausprobieren
Ändere in NotizResource.java das Wort Hallo in der Methode hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:8000/hallo liefert {"gruss":"Servus Welt!"}. Die Anfrage dauert etwas länger, weil Quarkus erst jetzt neu übersetzt. Im ersten Terminal erscheinen Restarting quarkus due to changes in NotizResource… und Live reload total time: …. Die Notizen aus Schritt 11 sind danach verloren, weil sie nur im Arbeitsspeicher lagen.
15. Entwicklungsmodus beenden
Wechsle in das erste Terminal und drücke q oder Strg+C.
16. Anwendung paketieren
package übersetzt das Projekt, führt die Tests aus und legt die fertige Anwendung im Ordner target/quarkus-app ab. Die Tests starten die Anwendung dafür kurz auf Port 8081.
./mvnw package
Prüfen: Die Ausgabe enthält Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 und endet mit BUILD SUCCESS. Der Ordner target/quarkus-app enthält die Datei quarkus-run.jar und die Unterordner app, lib und quarkus. Zum Betrieb braucht man den ganzen Ordner, nicht nur die JAR-Datei.
ls target/quarkus-app
17. Fertige Anwendung starten
Startet die Anwendung ohne Maven, nur mit Java. So läuft sie später auf einem Server.
java -jar target/quarkus-app/quarkus-run.jar
Prüfen: Die Ausgabe enthält Listening on: http://127.0.0.1:8000 und Profile prod activated. Laut der Angabe started in …s dauert der Start nur etwa eine halbe Sekunde, weil Quarkus viel Arbeit schon beim Paketieren erledigt. curl http://localhost:8000/notizen liefert []. Beende die Anwendung mit Strg+C.
Wie geht es weiter?
- Erweiterungen:
./mvnw quarkus:list-extensionslistet alle Erweiterungen,./mvnw quarkus:add-extension -Dextensions="…"fügt eine hinzu. - Eingaben prüfen: Mit der Erweiterung
hibernate-validatorschreibt man Regeln wie@NotBlankan die Felder und@Validan den Parameter. Quarkus antwortet dann bei ungültigen Eingaben selbst mit400. - Datenbank: Mit
hibernate-orm-panacheundjdbc-postgresqlspricht Quarkus PostgreSQL an. Die Verbindung steht inapplication.properties. - Tests:
./mvnw testführt die Tests aus. Im Entwicklungsmodus startet die Taste r die Tests und wiederholt sie nach jeder Änderung. - Betrieb: Auf einem Server kopiert man den Ordner
target/quarkus-apphin, startetjava -jar quarkus-run.jarüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt.
Deinstallieren
1. Anwendung beenden
Läuft ./mvnw quarkus:dev oder java -jar … noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt übersetzter Anwendung.
rm -rf ~/meinquarkus
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinquarkus
3. Heruntergeladene Bibliotheken entfernen (optional)
Maven und alle Bibliotheken liegen in ~/.m2. Der Befehl löscht den ganzen Ordner. Das betrifft auch andere Java-Projekte wie Spring Boot, die ihre Bibliotheken dann beim nächsten Build wieder aus dem Internet laden.
rm -rf ~/.m2
4. JDK entfernen (optional)
Nur ausführen, wenn kein anderes Programm Java braucht, z. B. IntelliJ IDEA oder Keycloak.
sudo apt purge default-jdk
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://quarkus.io/guides/
- Lizenz: Quarkus steht unter der Apache-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.
Ktor
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ktor ist ein Framework von JetBrains für Webanwendungen und Schnittstellen in Kotlin. Routen schreibt man als kurze Kotlin-Blöcke (get("/…") { … }), Fähigkeiten wie JSON, Anmeldung oder Protokollierung schaltet man als Plugins einzeln zu. Ktor arbeitet mit Kotlin-Coroutinen und kann dadurch viele Anfragen gleichzeitig bearbeiten, ohne für jede einen eigenen Thread zu blockieren.
Vorbemerkungen
- Installation pro Projekt: Ktor gehört als Abhängigkeit zu jedem Projekt. Aus den Ubuntu-Paketquellen kommt nur das Java-Entwicklungspaket (JDK). Den Kotlin-Compiler bringt das Build-Werkzeug Gradle selbst mit, der Snap aus der Kotlin-Anleitung ist nicht nötig.
- Projekt anlegen mit start.ktor.io: Der offizielle Generator https://start.ktor.io erzeugt ein fertiges Projektgerüst. Diese Anleitung ruft ihn mit
curlauf, so wie es auch das Kommandozeilenwerkzeug von Ktor tut. Im Browser geht es genauso. - Gradle Wrapper: Das Projekt enthält das Skript
./gradlew. Es lädt beim ersten Aufruf Gradle in der passenden Version herunter. Gradle legt sich selbst, den Kotlin-Compiler und alle Bibliotheken in~/.gradleab, zusammen rund 650 MB. - Port 8000: Die Vorlage lauscht auf Port 8080 und ist aus dem ganzen Netz erreichbar. Schritt 9 ändert das auf Port 8000 und nur den eigenen Rechner, weil 8080 oft schon belegt ist, etwa von Apache aus der Tileserver-Anleitung.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Quarkus, Gin, FastAPI und Express. Die Notizen liegen nur im Arbeitsspeicher.
- Version: Getestet mit Ktor 3.6.0, Kotlin 2.4.0, Gradle 9.5.1 und Java 25 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. JDK und Hilfsprogramme installieren
default-jdk– Java-Entwicklungspaket in der Standardversion von Ubuntu. Ist es schon vorhanden (z. B. aus der Kotlin-Anleitung), meldetaptdas nur.curl– lädt das Projektgerüst von start.ktor.io herunterunzip– entpackt es
sudo apt install default-jdk curl unzip
Prüfen: Der Ordner /usr/lib/jvm/java-25-openjdk-amd64 existiert. Gradle sucht sich dort das JDK, das Schritt 8 festlegt, auch wenn java -version eine andere Version anzeigt.
ls -d /usr/lib/jvm/java-25-openjdk-amd64
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projektgerüst herunterladen
Schickt die Wünsche als JSON an den Generator und speichert das Ergebnis als meinktor.zip:
project_name– der Name des Projektscompany_website– daraus bildet Ktor das Kotlin-Paket, hierde.beispielengine– der Webserver, hier Nettybuild_system– Gradle mit Build-Skripten in Kotlinfeatures– die Plugins: Content Negotiation wählt das Format der Antwort, kotlinx.serialization wandelt Kotlin-Klassen in JSON umconfigurationOption– Einstellungen wie der Port stehen im CodeaddWrapper– legt./gradlewbei
curl -o meinktor.zip -X POST https://start.ktor.io/project/generate -H "Content-Type: application/json" -d '{"settings":{"project_name":"meinktor","company_website":"beispiel.de","engine":"NETTY","build_system":"GRADLE_KTS","ktor_version":"3.6.0","kotlin_version":"2.4.0","build_system_args":{"version_catalog":""}},"features":["io.ktor/server-content-negotiation","io.ktor/server-kotlinx-serialization"],"addDefaultRoutes":true,"configurationOption":"CODE","addWrapper":true}'
Prüfen: Die Datei meinktor.zip ist rund 50 KB groß. Ist sie nur wenige Bytes groß, enthält sie eine Fehlermeldung des Generators. cat meinktor.zip zeigt sie an. Meist hat sich dann die Ktor- oder Kotlin-Version geändert. Die aktuellen Werte liefert curl https://start.ktor.io/project/settings.
ls -lh meinktor.zip
5. Projekt entpacken
Die Dateien liegen im ZIP ohne eigenen Ordner. -d meinktor entpackt sie deshalb in einen neuen Ordner meinktor.
unzip meinktor.zip -d meinktor
6. ZIP-Datei löschen
Sie wird nicht mehr gebraucht.
rm meinktor.zip
7. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinktor
Prüfen: Die Ausgabe enthält build.gradle.kts, gradlew und src.
ls
Der Code liegt in src/main/kotlin: main.kt startet den Server, Application.kt schaltet die Teile zusammen, Serialization.kt richtet JSON ein und Routing.kt enthält die Routen.
8. Java-Version festlegen
Die Vorlage verlangt Java 21. Ubuntu liefert Java 25. Ohne Änderung würde Gradle ein zusätzliches JDK 21 aus dem Internet laden.
nano build.gradle.kts
Ändere die Zeile jvmToolchain(21) in:
jvmToolchain(25)
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Port und Adresse festlegen
nano src/main/kotlin/main.kt
Ändere die beiden Zeilen port = 8080, und host = "0.0.0.0", so, dass sie lauten:
port = 8000,
host = "127.0.0.1",
0.0.0.0 hieße: aus dem ganzen Netz erreichbar. 127.0.0.1 beschränkt den Server auf den eigenen Rechner.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Routen schreiben
nano src/main/kotlin/Routing.kt
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
package de.beispiel
import io.ktor.http.*
import io.ktor.server.application.*
import io.ktor.server.request.*
import io.ktor.server.response.*
import io.ktor.server.routing.*
import kotlinx.serialization.Serializable
// So sieht eine gespeicherte Notiz aus
@Serializable
data class Notiz(val id: Int, val titel: String)
// So sieht eine neue Notiz aus, die man schickt: nur ein Titel
@Serializable
data class NotizNeu(val titel: String = "")
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
private val notizen = mutableListOf<Notiz>()
fun Application.configureRouting() {
routing {
// GET /hallo?name=... liefert eine Begrüßung als JSON
get("/hallo") {
val name = call.request.queryParameters["name"] ?: "Welt"
call.respond(mapOf("gruss" to "Hallo $name!"))
}
// GET /notizen liefert alle Notizen
get("/notizen") {
val alle = synchronized(notizen) { notizen.toList() }
call.respond(alle)
}
// GET /notizen/1 liefert eine Notiz oder 404
get("/notizen/{id}") {
val id = call.parameters["id"]?.toIntOrNull()
val notiz = synchronized(notizen) { notizen.find { it.id == id } }
if (notiz == null) {
call.respond(HttpStatusCode.NotFound, mapOf("fehler" to "Notiz nicht gefunden"))
} else {
call.respond(notiz)
}
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
post("/notizen") {
val daten = runCatching { call.receive<NotizNeu>() }.getOrNull()
if (daten == null || daten.titel.isEmpty()) {
call.respond(HttpStatusCode.BadRequest, mapOf("fehler" to "Feld \"titel\" fehlt"))
return@post
}
val notiz = synchronized(notizen) {
Notiz(notizen.size + 1, daten.titel).also { notizen.add(it) }
}
call.response.header(HttpHeaders.Location, "/notizen/${notiz.id}")
call.respond(HttpStatusCode.Created, notiz)
}
}
}
@Serializable data class– Datenklassen, die kotlinx.serialization in JSON umwandeln kann und umgekehrt.titel: String = ""sorgt dafür, dass{}nicht als Fehler gilt, sondern einen leeren Titel ergibt, den die Route selbst prüft.routing { … }– enthält alle Routen.getundpostverbinden Adresse und Methode mit einem Block.{id}ist ein Platzhalter.call– die laufende Anfrage samt Antwort.call.request.queryParametersliest Werte aus der Adresse (?name=…),call.parametersdie Platzhalter,call.receive<NotizNeu>()den mitgeschickten JSON-Inhalt.call.respondantwortet mit Status und JSON.runCatching { … }.getOrNull()– liefertnullstatt eines Fehlers, wenn der Inhalt kein passendes JSON ist.synchronized(notizen)– Ktor bearbeitet Anfragen gleichzeitig. So liest oder ändert immer nur eine Anfrage die Liste.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Test anpassen
Die Vorlage enthält einen Test, der prüft, ob die Startseite / mit Status 200 antwortet. Die gibt es nach Schritt 10 nicht mehr. Der Test soll stattdessen /hallo aufrufen.
nano src/test/kotlin/ServerTest.kt
Ändere in der Zeile mit client.get("/") die Adresse in "/hallo":
assertEquals(HttpStatusCode.OK, client.get("/hallo").status)
testApplication startet die Anwendung für den Test ohne echten Netzwerk-Port, client.get schickt eine Anfrage an sie.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Projekt bauen
Übersetzt den Code, führt den Test aus und erzeugt die fertigen Programmdateien. Beim ersten Aufruf lädt ./gradlew Gradle, den Kotlin-Compiler und alle Bibliotheken herunter, das dauert ein bis zwei Minuten.
./gradlew build
Prüfen: Die Ausgabe endet mit BUILD SUCCESSFUL. Steht dort BUILD FAILED mit There were failing tests, fehlt die Änderung aus Schritt 11. Bei Tippfehlern im Code nennt die Ausgabe Datei und Zeile.
Starten und testen
13. Server starten
Übersetzt geänderten Code und startet den Server. Das Terminal bleibt belegt, solange er läuft.
./gradlew run
Prüfen: Die Ausgabe enthält Application started in … und Responding at http://127.0.0.1:8000. Die Fortschrittsanzeige von Gradle bleibt bei > :run stehen, solange der Server läuft.
14. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}.
15. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl -i http://localhost:8000/gibtsnicht | HTTP/1.1 404 Not Found ohne Inhalt |
Für unbekannte Adressen sendet Ktor nur den Status. Eigene Fehlerseiten oder JSON-Fehler für alle Routen richtet das Plugin Status Pages ein.
16. Server beenden
Wechsle in das erste Terminal und drücke Strg+C. Änderungen am Code wirken erst nach einem neuen ./gradlew run. Die Notizen gehen dabei verloren, weil sie nur im Arbeitsspeicher liegen.
17. Fertige Anwendung starten
Schritt 12 hat auch die Datei build/libs/meinktor-all.jar erzeugt. Sie enthält die Anwendung samt Ktor, Kotlin und allen Bibliotheken, rund 30 MB. Zum Starten braucht man nur Java, weder Gradle noch den Quelltext. --enable-native-access=ALL-UNNAMED erlaubt dem Webserver Netty, Systembibliotheken zu laden. Ohne den Schalter warnt Java beim Start mit WARNING: A restricted method in java.lang.System has been called.
java --enable-native-access=ALL-UNNAMED -jar build/libs/meinktor-all.jar
Prüfen: Die Ausgabe enthält Responding at http://127.0.0.1:8000, curl http://localhost:8000/notizen liefert []. Beende die Anwendung mit Strg+C.
Wie geht es weiter?
- Plugins: Der Generator auf https://start.ktor.io zeigt alle Plugins mit Beschreibung, etwa Status Pages für Fehlerantworten, Authentication für die Anmeldung oder CORS für Zugriffe von fremden Webseiten. Man trägt sie in
build.gradle.ktsein und schaltet sie mitinstall(…)ein, wieContentNegotiationinSerialization.kt. - Automatischer Neustart: Ktor kann geänderten Code im Entwicklungsmodus neu laden, ohne dass man den Server neu startet. Die Ktor-Dokumentation beschreibt dazu den Entwicklungsmodus und das Auto-Reload.
- Datenbank: Mit der Bibliothek Exposed von JetBrains spricht Ktor z. B. PostgreSQL an.
- Entwicklungsumgebung: IntelliJ IDEA öffnet den Projektordner direkt als Gradle-Projekt und kann den Server mit einem Klick starten.
- Betrieb: Auf einem Server kopiert man nur
meinktor-all.jarhin, startet es über einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt.
Deinstallieren
1. Anwendung beenden
Läuft ./gradlew run oder java -jar … noch in einem Terminal, beende es dort mit Strg+C.
2. Gradle-Hintergrundprozess beenden
Gradle lässt nach dem ersten Aufruf einen Hintergrundprozess (Daemon) laufen, damit spätere Aufrufe schneller starten. Er beendet sich nach drei Stunden ohne Arbeit selbst. Dieser Befehl beendet ihn sofort.
~/meinktor/gradlew --stop
Prüfen: Die Ausgabe lautet Stopping Daemon(s) und 1 Daemon stopped.
3. Projekt entfernen
Löscht den Projektordner samt übersetzter Anwendung.
rm -rf ~/meinktor
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinktor
4. Gradle und Bibliotheken entfernen (optional)
Gradle, der Kotlin-Compiler und alle Bibliotheken liegen in ~/.gradle. Der Befehl löscht den ganzen Ordner. Das betrifft alle Gradle-Projekte, die beim nächsten Build wieder alles aus dem Internet laden.
rm -rf ~/.gradle
5. JDK entfernen (optional)
Nur ausführen, wenn kein anderes Programm Java braucht, z. B. Kotlin, IntelliJ IDEA oder Keycloak.
sudo apt purge default-jdk
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://ktor.io/docs/home.html
- Lizenz: Ktor steht unter der Apache-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.
Django
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Django ist ein Web-Framework für Python. Es bringt vieles schon mit, was Webanwendungen brauchen: Datenbankzugriff über Python-Klassen statt SQL, Benutzerverwaltung, Formulare, Schutz vor typischen Angriffen und eine fertige Verwaltungsoberfläche (Admin), mit der sich Daten ohne eigenen Code pflegen lassen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Django 5.2. Das ist die aktuelle Version mit Langzeitunterstützung (LTS), sie bekommt bis April 2028 Sicherheitskorrekturen. Die neueren Versionen 6.x gibt es nur über
pip, siehe Abschnitt am Ende. - Datenbank: Für den Anfang verwendet Django SQLite. Die Daten liegen dann in einer einzelnen Datei im Projektordner, ein Datenbankserver ist nicht nötig. Später lässt sich auf PostgreSQL umstellen.
- Projekt und App: Ein Django-Projekt ist die gesamte Website mit ihren Einstellungen. Es besteht aus einer oder mehreren Apps, die jeweils einen Bereich abdecken, hier eine App
notizen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von Django aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Django installieren
Installiert Django und den Befehl django-admin. Die benötigten Hilfsbibliotheken (python3-asgiref, python3-sqlparse) installiert apt automatisch mit.
sudo apt install python3-django
Prüfen: Die Ausgabe ist die Versionsnummer, z. B. 5.2.9.
django-admin --version
Erstes Projekt
3. Projektordner anlegen
Ein eigener Ordner für das Projekt.
mkdir ~/meinprojekt
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/meinprojekt
5. Projekt anlegen
Erzeugt das Grundgerüst. Der Punkt am Ende bedeutet: direkt in diesen Ordner, ohne zusätzlichen Unterordner. Es entstehen die Datei manage.py (das Werkzeug für alle weiteren Befehle) und der Ordner meinprojekt mit den Einstellungen (settings.py) und den Adressen (urls.py).
django-admin startproject meinprojekt .
Prüfen: Es werden manage.py und meinprojekt angezeigt.
ls
6. Sprache und Zeitzone einstellen
Stellt die Oberfläche auf Deutsch und die Zeitzone auf Mitteleuropa um. Das betrifft vor allem die Verwaltungsoberfläche und die Anzeige von Datum und Uhrzeit.
nano meinprojekt/settings.py
Suche mit Strg+W nach LANGUAGE_CODE und drücke Enter. Ändere diese Zeile und die Zeile TIME_ZONE zwei Zeilen darunter, sodass sie lauten:
LANGUAGE_CODE = 'de-de'
TIME_ZONE = 'Europe/Berlin'
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Ausgabe zeigt LANGUAGE_CODE = 'de-de' und TIME_ZONE = 'Europe/Berlin'.
grep -E "^(LANGUAGE_CODE|TIME_ZONE)" meinprojekt/settings.py
7. App anlegen
Erzeugt die App notizen als eigenen Ordner mit Dateien für Datenmodelle (models.py), Seitenlogik (views.py) und Verwaltungsoberfläche (admin.py).
python3 manage.py startapp notizen
8. App im Projekt anmelden
Django berücksichtigt eine App erst, wenn sie in der Liste INSTALLED_APPS in settings.py steht. notizen kommt ans Ende der Liste.
nano meinprojekt/settings.py
Suche mit Strg+W nach staticfiles und drücke Enter. Der Cursor steht in der letzten Zeile der Liste INSTALLED_APPS. Drücke Ende und Enter und tippe darunter die neue Zeile, eingerückt mit vier Leerzeichen:
'notizen',
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die letzte Zeile der Liste lautet 'notizen',.
grep -A 8 '^INSTALLED_APPS' meinprojekt/settings.py
Daten, Verwaltung und eine Seite
9. Datenmodell anlegen
Ein Modell ist eine Python-Klasse, aus der Django eine Datenbanktabelle macht. Jedes Feld wird zu einer Spalte. Die Texte in Anführungszeichen (z. B. "Titel") sind die Beschriftungen in der Verwaltungsoberfläche. auto_now_add trägt beim Anlegen automatisch Datum und Uhrzeit ein. Meta legt den Namen in Einzahl und Mehrzahl sowie die Sortierung fest (neueste zuerst).
nano notizen/models.py
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from django.db import models
class Notiz(models.Model):
titel = models.CharField("Titel", max_length=200)
text = models.TextField("Text", blank=True)
erstellt = models.DateTimeField("Erstellt", auto_now_add=True)
class Meta:
verbose_name = "Notiz"
verbose_name_plural = "Notizen"
ordering = ["-erstellt"]
def __str__(self):
return self.titel
10. Migration erzeugen
Eine Migration ist eine Datei, die beschreibt, wie die Datenbank an das Modell angepasst wird. Django erzeugt sie selbst aus dem Modell. Bei jeder späteren Änderung am Modell wiederholst du diesen und den nächsten Schritt.
python3 manage.py makemigrations notizen
Prüfen: Die Ausgabe enthält + Create model Notiz.
11. Datenbank anlegen
Führt alle Migrationen aus: die eigenen und die der mitgelieferten Apps (Benutzer, Sitzungen, Verwaltung). Dabei entsteht die Datenbankdatei db.sqlite3.
python3 manage.py migrate
Prüfen: Die letzten Zeilen enden jeweils mit OK, darunter Applying notizen.0001_initial... OK.
12. Notizen in der Verwaltungsoberfläche anzeigen
Meldet das Modell bei der Verwaltungsoberfläche an. list_display legt die Spalten der Übersicht fest, search_fields die Felder, in denen die Suche sucht.
nano notizen/admin.py
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from django.contrib import admin
from .models import Notiz
@admin.register(Notiz)
class NotizAdmin(admin.ModelAdmin):
list_display = ["titel", "erstellt"]
search_fields = ["titel", "text"]
13. Administrator anlegen
Legt ein Benutzerkonto mit vollen Rechten für die Verwaltungsoberfläche an. Der Befehl fragt nach Benutzername, E-Mail-Adresse (darf leer bleiben) und zweimal nach dem Passwort. Die Eingabe des Passworts wird nicht angezeigt.
python3 manage.py createsuperuser
Prüfen: Die Ausgabe endet mit Superuser created successfully.
14. Eine eigene Seite schreiben
Eine View ist eine Funktion, die eine Anfrage bekommt und eine Antwort zurückgibt. Diese hier liefert alle Notizen als JSON, also als einfache REST-Schnittstelle. Für HTML-Seiten würde man stattdessen eine Vorlage (Template) verwenden.
nano notizen/views.py
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from django.http import JsonResponse
from .models import Notiz
def liste(request):
notizen = Notiz.objects.values("id", "titel", "erstellt")
return JsonResponse({"notizen": list(notizen)})
15. Adresse für die Seite festlegen
Ersetzt die Adressliste des Projekts. Neben der Verwaltungsoberfläche unter /admin/ ist die neue View jetzt unter /notizen/ erreichbar.
nano meinprojekt/urls.py
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from django.contrib import admin
from django.urls import path
from notizen import views
urlpatterns = [
path("admin/", admin.site.urls),
path("notizen/", views.liste),
]
16. Projekt prüfen
Django untersucht Einstellungen, Modelle und Adressen auf Fehler, ohne den Server zu starten.
python3 manage.py check
Prüfen: Die Ausgabe lautet System check identified no issues (0 silenced).
Starten und testen
17. Entwicklungsserver starten
Startet den eingebauten Webserver auf http://127.0.0.1:8000. Er ist nur vom eigenen Rechner aus erreichbar und lädt geänderte Python-Dateien automatisch neu. Das Terminal bleibt dabei belegt. Für den echten Betrieb ist er nicht gedacht.
python3 manage.py runserver
Prüfen: Die Ausgabe enthält Starting development server at http://127.0.0.1:8000/. Die gelbe Warnung darunter erinnert nur daran, dass dieser Server nicht für den echten Betrieb gedacht ist.
18. Notiz in der Verwaltungsoberfläche anlegen
Öffne http://127.0.0.1:8000/admin/ im Browser und melde dich mit dem Konto aus Schritt 13 an. Die Oberfläche heißt „Django-Systemverwaltung“. Unter Notizen klickst du auf Hinzufügen, gibst einen Titel und einen Text ein und klickst auf Sichern.
Prüfen: Die Notiz erscheint in der Übersicht mit Titel und Erstellungszeit.
19. Eigene Seite abrufen
Öffne ein zweites Terminal und frage die View aus Schritt 14 ab.
curl http://127.0.0.1:8000/notizen/
Prüfen: Die Antwort enthält die angelegte Notiz, z. B. {"notizen": [{"id": 1, "titel": "Erste Notiz", "erstellt": "…"}]}.
20. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Wie geht es weiter?
- PostgreSQL statt SQLite: Mit dem Paket
python3-psycopg(überapt) und einer angepassten EinstellungDATABASESinsettings.pyverwendet Django eine PostgreSQL-Datenbank. - Betrieb mit nginx: Für den echten Betrieb startet man Django mit einem Anwendungsserver wie Gunicorn (Paket
gunicorn) und setzt nginx davor. Insettings.pymüssen dannDEBUG = Falsegesetzt undALLOWED_HOSTSsowieSECRET_KEYangepasst werden. - REST-Schnittstellen: Das Django REST Framework (Paket
python3-djangorestframework) erleichtert umfangreichere Schnittstellen. - Entwicklungsumgebung: VS Code mit der Python-Erweiterung oder PyCharm unterstützen Django-Projekte.
Alternative: neueste Version über pip
Die aktuelle Version Django 6.1 bekommst du nur über pip in einer virtuellen Umgebung, genau wie in der LangGraph-Anleitung beschrieben. Im Projektordner:
python3 -m venv .venv
source .venv/bin/activate
pip install django
Solange die virtuelle Umgebung aktiv ist, verwenden django-admin und python3 manage.py diese Version. Sie bekommt aber keine Updates über apt, und du musst sie selbst mit pip install -U django aktuell halten.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt Datenbank db.sqlite3. Achtung: Alle darin gespeicherten Daten gehen verloren.
rm -rf ~/meinprojekt
2. Django entfernen
Entfernt das Paket.
sudo apt purge python3-django
3. Nicht mehr benötigte Pakete entfernen
Entfernt die Hilfsbibliotheken, die nur für Django installiert wurden.
sudo apt autoremove
Prüfen: Der Befehl wird nicht mehr gefunden.
django-admin --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.djangoproject.com/
- Lizenz: Django steht unter der BSD-3-Clause.
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.
FastAPI
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
FastAPI ist ein schlankes Python-Framework für Schnittstellen (APIs). Man beschreibt Adressen als normale Python-Funktionen und die erwarteten Daten mit Typangaben. FastAPI prüft daraufhin alle Eingaben selbst, wandelt Antworten in JSON um und erzeugt eine Dokumentation, in der man die Schnittstelle im Browser ausprobieren kann.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält FastAPI (Version 0.118) und den Server Uvicorn als Pakete. Die neueste Version (0.141) gibt es über
pip, siehe Abschnitt „Alternative: neueste Version über pip“. - Uvicorn: FastAPI selbst ist nur das Framework. Ausgeliefert werden die Anfragen von Uvicorn, einem Server für asynchrones Python (ASGI).
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, Laravel, ASP.NET Core und Axum und Actix-web. Die Notizen liegen nur im Arbeitsspeicher.
- Verhältnis zu Django: Django bringt Datenbank, Verwaltungsoberfläche und HTML-Vorlagen mit. FastAPI konzentriert sich auf Schnittstellen und lässt die Wahl der Datenbank offen.
- Version: Getestet mit FastAPI 0.118, Uvicorn 0.38 und Pydantic 2.12 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. FastAPI und Uvicorn installieren
python3-fastapi bringt das Framework samt Pydantic für die Prüfung der Daten mit, python3-uvicorn den Server.
sudo apt install python3-fastapi python3-uvicorn
Prüfen: Die Ausgabe nennt die Versionen von FastAPI und Uvicorn, z. B. 0.118.0 0.38.0.
python3 -c "import fastapi, uvicorn; print(fastapi.__version__, uvicorn.__version__)"
Erstes Projekt
3. Projektordner anlegen
mkdir ~/hallo-fastapi
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo-fastapi
5. Anwendung schreiben
Legt die Datei main.py an. Die wichtigsten Bausteine:
app = FastAPI(…)– die Anwendung.titleerscheint als Überschrift der Dokumentation.- Modelle (
class … (BaseModel)) – beschreiben, wie die Daten aussehen.NotizNeuist das, was man beim Anlegen schickt,Notizdie gespeicherte Notiz mit Nummer. Pydantic prüft jede Anfrage dagegen. - Routen (
@app.get,@app.post) – legen fest, welche Funktion welche Adresse und Methode beantwortet. Parameter der Funktion füllt FastAPI selbst:nameaus der Adresse (?name=…),notiz_idaus dem Pfad unddatenaus dem mitgeschickten JSON. - Rückgabetyp (
-> Notiz) – FastAPI wandelt das Ergebnis danach in JSON um und nimmt nur die Felder des Modells auf. HTTPExceptionbricht mit einem Fehlerstatus ab, hier404.status_code=201setzt den Status für eine erfolgreich angelegte Notiz.
nano main.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from fastapi import FastAPI, HTTPException, Response
from pydantic import BaseModel
app = FastAPI(title="Notizen")
# So sieht eine neue Notiz aus, die man schickt: nur ein Titel
class NotizNeu(BaseModel):
titel: str
# So sieht eine gespeicherte Notiz aus: mit Nummer
class Notiz(NotizNeu):
id: int
# Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
notizen: list[Notiz] = []
# GET /hallo?name=... liefert eine Begrüßung als JSON
@app.get("/hallo")
def hallo(name: str = "Welt"):
return {"gruss": f"Hallo {name}!"}
# GET /notizen liefert alle Notizen
@app.get("/notizen")
def alle_notizen() -> list[Notiz]:
return notizen
# GET /notizen/1 liefert eine Notiz oder 404
@app.get("/notizen/{notiz_id}")
def eine_notiz(notiz_id: int) -> Notiz:
for notiz in notizen:
if notiz.id == notiz_id:
return notiz
raise HTTPException(status_code=404, detail="Notiz nicht gefunden")
# POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
@app.post("/notizen", status_code=201)
def notiz_anlegen(daten: NotizNeu, response: Response) -> Notiz:
notiz = Notiz(id=len(notizen) + 1, titel=daten.titel)
notizen.append(notiz)
response.headers["Location"] = f"/notizen/{notiz.id}"
return notiz
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Starten und testen
6. Server im Entwicklungsmodus starten
main:app bedeutet: das Objekt app in der Datei main.py. --reload startet den Server bei jeder gespeicherten Änderung neu. --host 127.0.0.1 macht ihn nur vom eigenen Rechner aus erreichbar, --port 8000 legt den Port fest. Das Ubuntu-Paket bringt keinen eigenen Befehl uvicorn mit, deshalb wird der Server über python3 -m gestartet. Das Terminal bleibt belegt, hier erscheint zu jeder Anfrage eine Zeile.
python3 -m uvicorn main:app --reload --host 127.0.0.1 --port 8000
Prüfen: Die Ausgabe enthält Uvicorn running on http://127.0.0.1:8000 und endet mit Application startup complete.
7. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht location: /notizen/1, die letzte Zeile ist {"titel":"Erste Notiz","id":1}. Im ersten Terminal erscheint "POST /notizen HTTP/1.1" 201 Created.
8. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"titel":"Erste Notiz","id":1}] |
curl http://localhost:8000/notizen/1 | {"titel":"Erste Notiz","id":1} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"detail":"Notiz nicht gefunden"} (Status 404) |
curl http://localhost:8000/gibtsnicht | {"detail":"Not Found"} (Status 404) |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"detail":[{"type":"missing","loc":["body","titel"],"msg":"Field required",…}]} (Status 422) |
curl http://localhost:8000/notizen/abc | {"detail":[{"type":"int_parsing","loc":["path","notiz_id"],…}]} (Status 422) |
Die letzten beiden Fehler hat niemand programmiert: FastAPI erkennt am Modell NotizNeu, dass titel fehlt, und an notiz_id: int, dass abc keine Zahl ist. Es antwortet dann mit Status 422 Unprocessable Content und nennt genau, welches Feld nicht passt. Die anderen Anleitungen prüfen das von Hand und antworten mit 400.
9. Dokumentation im Browser ausprobieren
Öffne http://localhost:8000/docs im Browser. FastAPI erzeugt diese Seite selbst aus dem Code. Sie listet alle Routen: „Hallo“, „Alle Notizen“, „Notiz Anlegen“ und „Eine Notiz“. Die Namen stammen aus den Funktionsnamen.
- Klicke auf POST /notizen.
- Klicke auf Try it out. Im Feld darunter steht ein Beispiel
{"titel": "string"}. Änderestringin einen eigenen Titel. - Klicke auf Execute.
Prüfen: Unter „Server response“ steht der Code 201 und die neue Notiz als JSON.
Die Seite lädt ihre Skripte und Stylesheets von cdn.jsdelivr.net und das Symbol von fastapi.tiangolo.com. Ohne Internetverbindung bleibt sie leer. Die Beschreibung der Schnittstelle als Datei liefert http://localhost:8000/openapi.json, auch ohne Internet.
10. Automatischen Neustart ausprobieren
Ändere in main.py das Wort Hallo in der Funktion hallo z. B. in Servus und speichere die Datei. Im ersten Terminal erscheint StatReload detected changes in 'main.py'. Reloading..., danach startet der Server neu.
Prüfen: curl http://localhost:8000/hallo liefert jetzt {"gruss":"Servus Welt!"}. Die Notizen aus Schritt 7 und 9 sind durch den Neustart verloren, weil sie nur im Arbeitsspeicher lagen.
11. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Wie geht es weiter?
- Datenbank: FastAPI legt sich nicht fest. Für PostgreSQL oder SQLite verwendet man meist SQLAlchemy oder SQLModel (vom Autor von FastAPI). Beide gibt es über
pip. - Asynchrone Routen: Schreibt man
async defstattdef, kann eine Route auf andere Dienste warten (Datenbank, andere APIs), ohne den Server zu blockieren. - Mehr Prüfungen: Pydantic kennt Einschränkungen wie
titel: str = Field(min_length=1, max_length=200)oder eigene Typen für E-Mail-Adressen. - Betrieb: Auf einem Server startet man Uvicorn ohne
--reloadüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt. Mit--workers 4verteilt Uvicorn die Anfragen auf mehrere Prozesse.
Alternative: neueste Version über pip
Wer die neueste Version von FastAPI braucht, installiert sie in einer virtuellen Umgebung im Projektordner. Das Paket python3-venv muss dafür installiert sein.
python3 -m venv .venv
source .venv/bin/activate
pip install "fastapi[standard]"
[standard] bringt Uvicorn und den Befehl fastapi mit. Solange die Umgebung aktiv ist, startet fastapi dev main.py den Server im Entwicklungsmodus auf http://127.0.0.1:8000. Diese Version bekommt keine Updates über apt, du hältst sie selbst mit pip install -U "fastapi[standard]" aktuell.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner.
rm -rf ~/hallo-fastapi
2. FastAPI und Uvicorn entfernen
Nur ausführen, wenn kein anderes Programm sie braucht.
sudo apt purge python3-fastapi python3-uvicorn
3. Nicht mehr benötigte Pakete entfernen
Entfernt die Pakete, die nur für FastAPI und Uvicorn mitinstalliert wurden (z. B. python3-starlette, python3-pydantic). Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Der Befehl meldet ModuleNotFoundError: No module named 'fastapi'.
python3 -c "import fastapi"
Quellen und Lizenz
- Offizielle Dokumentation: https://fastapi.tiangolo.com/
- Lizenz: FastAPI steht unter der MIT.
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.
Flask
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Flask ist ein kleines Python-Framework für Webanwendungen und Schnittstellen. Es liefert nur das Nötigste: Routen, Zugriff auf die Anfrage, Antworten als JSON und HTML-Vorlagen mit Jinja2. Alles Weitere, etwa Datenbank oder Anmeldung, wählt man selbst dazu.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Flask 3.1.3. Das ist zugleich die neueste Version, eine Installation über
pipist nicht nötig. - Eingebauter Server: Zum Entwickeln startet
flask runeinen Server auf http://127.0.0.1:5000, nur vom eigenen Rechner aus erreichbar. Port 5000 darf nicht von einem anderen Programm belegt sein. - Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu FastAPI, Express, Laravel und Ruby on Rails. Die Notizen liegen nur im Arbeitsspeicher. Dazu kommt eine HTML-Seite, die sie auflistet.
- Verhältnis zu Django und FastAPI: Django bringt Datenbank, Verwaltungsoberfläche und Anmeldung fertig mit. FastAPI prüft Eingaben anhand von Typangaben und erzeugt eine Dokumentation der Schnittstelle. Flask macht beides nicht, ist dafür schnell verstanden und eignet sich für Webseiten ebenso wie für Schnittstellen.
- Version: Getestet mit Flask 3.1.3 und Werkzeug 3.1.5 unter Python 3.14 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Flask installieren
python3-flask bringt das Framework, die Vorlagensprache Jinja2, die Hilfsbibliothek Werkzeug (Anfragen, Entwicklungsserver) und den Befehl flask mit.
sudo apt install python3-flask
Prüfen: Die Ausgabe nennt drei Zeilen, darunter Flask 3.1.3.
flask --version
Erstes Projekt
3. Projektordner anlegen
-p legt auch gleich den Unterordner templates an. Dort sucht Flask nach HTML-Vorlagen.
mkdir -p ~/hallo-flask/templates
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo-flask
5. Anwendung schreiben
Legt die Datei app.py an. Die wichtigsten Bausteine:
app = Flask(__name__)– die Anwendung.__name__sagt Flask, wo die Datei liegt, damit es den Ordnertemplatesdaneben findet.- Routen (
@app.get,@app.post) – legen fest, welche Funktion welche Adresse und Methode beantwortet.<int:notiz_id>im Pfad nimmt nur ganze Zahlen an und übergibt sie der Funktion. request– die laufende Anfrage.request.argsenthält die Werte aus der Adresse (?name=…),request.get_json()den mitgeschickten JSON-Inhalt.silent=TrueliefertNonestatt eines Fehlers, wenn kein JSON ankommt.- Rückgabewerte – gibt eine Funktion ein Dictionary oder eine Liste zurück, macht Flask daraus JSON. Mit einem Tupel setzt man zusätzlich Status und Kopfzeilen, z. B.
notiz, 201, {"Location": …}. render_template– füllt eine HTML-Vorlage aus dem Ordnertemplatesmit Daten.@app.errorhandler(404)– beantwortet alle unbekannten Adressen mit JSON statt mit der HTML-Fehlerseite von Flask.
nano app.py
Füge diesen Inhalt ein (Strg+Umschalt+V):
from flask import Flask, render_template, request
app = Flask(__name__)
# Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
notizen = []
# GET /hallo?name=... liefert eine Begrüßung als JSON
@app.get("/hallo")
def hallo():
name = request.args.get("name", "Welt")
return {"gruss": f"Hallo {name}!"}
# GET /notizen liefert alle Notizen
@app.get("/notizen")
def alle_notizen():
return notizen
# GET /notizen/1 liefert eine Notiz oder 404
@app.get("/notizen/<int:notiz_id>")
def eine_notiz(notiz_id):
for notiz in notizen:
if notiz["id"] == notiz_id:
return notiz
return {"fehler": "Notiz nicht gefunden"}, 404
# POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
@app.post("/notizen")
def notiz_anlegen():
daten = request.get_json(silent=True) or {}
titel = daten.get("titel")
if not titel:
return {"fehler": 'Feld "titel" fehlt'}, 400
notiz = {"id": len(notizen) + 1, "titel": titel}
notizen.append(notiz)
return notiz, 201, {"Location": f"/notizen/{notiz['id']}"}
# GET / zeigt die Notizen als HTML-Seite
@app.get("/")
def startseite():
return render_template("notizen.html", notizen=notizen)
# Alle anderen unbekannten Adressen: 404 als JSON
@app.errorhandler(404)
def nicht_gefunden(fehler):
return {"fehler": "Nicht gefunden"}, 404
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. HTML-Vorlage schreiben
Die Vorlage für die Startseite. Jinja2 ersetzt {{ … }} durch Werte und führt Anweisungen in {% … %} aus, hier eine Bedingung und eine Schleife über alle Notizen.
nano templates/notizen.html
Füge diesen Inhalt ein:
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Notizen</title>
</head>
<body>
<h1>Notizen</h1>
{% if notizen %}
<ul>
{% for notiz in notizen %}
<li>{{ notiz.id }}: {{ notiz.titel }}</li>
{% endfor %}
</ul>
{% else %}
<p>Noch keine Notizen.</p>
{% endif %}
</body>
</html>
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Routen anzeigen
Lädt die Anwendung und listet alle Routen. So siehst du, ob app.py fehlerfrei ist. --app app bedeutet: die Anwendung in der Datei app.py.
flask --app app routes
Prüfen: Die Tabelle enthält die Adressen /notizen (zweimal, mit GET und POST), /notizen/<int:notiz_id>, /hallo und /. Die Zeile /static/<path:filename> legt Flask selbst an, für Dateien im Ordner static.
Starten und testen
8. Server im Entwicklungsmodus starten
--debug schaltet den Entwicklungsmodus ein: Flask startet bei jeder gespeicherten Änderung neu und zeigt bei Fehlern im Browser eine Seite zur Fehlersuche. Das Terminal bleibt belegt, hier erscheint zu jeder Anfrage eine Zeile.
flask --app app run --debug
Prüfen: Die Ausgabe enthält Running on http://127.0.0.1:5000 und Debugger is active!.
Die Fehlerseite im Entwicklungsmodus erlaubt es, Python-Befehle auf dem Rechner auszuführen. Der Server darf deshalb mit --debug nie aus dem Netz erreichbar sein.
9. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:5000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 CREATED, weiter unten steht Location: /notizen/1. Darunter folgt die neue Notiz mit "id": 1 und "titel": "Erste Notiz". Im Entwicklungsmodus rückt Flask JSON-Antworten zur besseren Lesbarkeit über mehrere Zeilen ein. Im ersten Terminal erscheint "POST /notizen HTTP/1.1" 201 -.
10. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung. Die Tabelle zeigt die Antworten der Übersicht halber in einer Zeile.
| Aufruf | Antwort |
|---|---|
curl http://localhost:5000/notizen | [{"id": 1, "titel": "Erste Notiz"}] |
curl http://localhost:5000/notizen/1 | {"id": 1, "titel": "Erste Notiz"} |
curl "http://localhost:5000/hallo?name=Thorsten" | {"gruss": "Hallo Thorsten!"} |
curl http://localhost:5000/notizen/7 | {"fehler": "Notiz nicht gefunden"} (Status 404) |
curl http://localhost:5000/notizen/abc | {"fehler": "Nicht gefunden"} (Status 404) |
curl http://localhost:5000/gibtsnicht | {"fehler": "Nicht gefunden"} (Status 404) |
curl -X POST http://localhost:5000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler": "Feld \"titel\" fehlt"} (Status 400) |
/notizen/abc landet beim allgemeinen 404, weil <int:notiz_id> nur Zahlen annimmt und die Adresse damit zu keiner Route passt.
11. HTML-Seite ansehen
Öffne http://localhost:5000/ im Browser.
Prüfen: Die Seite zeigt die Überschrift „Notizen“ und darunter 1: Erste Notiz.
Lege zum Ausprobieren eine Notiz mit HTML im Titel an:
curl -X POST http://localhost:5000/notizen -H "Content-Type: application/json" -d '{"titel": "<b>fett</b>"}'
Prüfen: Nach dem Neuladen steht auf der Seite wörtlich 2: <b>fett</b>, nicht fett gedruckt. Jinja2 maskiert Werte in {{ … }} selbst, damit niemand über Eingaben fremdes HTML oder JavaScript in die Seite schmuggeln kann.
12. Automatischen Neustart ausprobieren
Ändere in app.py das Wort Hallo in der Funktion hallo z. B. in Servus und speichere die Datei. Im ersten Terminal erscheint Detected change in '…/app.py', reloading, danach startet der Server neu.
Prüfen: curl http://localhost:5000/hallo liefert jetzt {"gruss": "Servus Welt!"}. Die Notizen aus Schritt 9 und 11 sind durch den Neustart verloren, weil sie nur im Arbeitsspeicher lagen.
13. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Wie geht es weiter?
- Datenbank: Für SQLite reicht das Modul
sqlite3, das zu Python gehört. Bequemer wird es mit dem Paketpython3-flask-sqlalchemy, das Tabellen als Python-Klassen beschreibt und auch PostgreSQL anspricht. - Formulare: In einer Route mit
methods=["GET", "POST"]liestrequest.formdie Felder eines HTML-Formulars. Vorlagen können mit{% extends "basis.html" %}ein gemeinsames Grundgerüst teilen. - Größere Anwendungen: Mit Blueprints teilt man die Routen auf mehrere Dateien auf.
- Betrieb: Der eingebaute Server ist nur zum Entwickeln gedacht, das sagt auch die Warnung beim Start. Auf einem Server liefert z. B. Gunicorn (Paket
gunicorn) die Anwendung mitgunicorn --bind 127.0.0.1:8000 app:appaus. Gestartet wird es über einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage), davor sitzt nginx, der auch HTTPS übernimmt.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner.
rm -rf ~/hallo-flask
2. Flask entfernen
Nur ausführen, wenn kein anderes Programm Flask braucht.
sudo apt purge python3-flask
3. Nicht mehr benötigte Pakete entfernen
Entfernt die Pakete, die nur für Flask mitinstalliert wurden (z. B. python3-werkzeug und python3-itsdangerous). Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Der Befehl meldet ModuleNotFoundError: No module named 'flask'.
python3 -c "import flask"
Quellen und Lizenz
- Offizielle Dokumentation: https://flask.palletsprojects.com/
- Lizenz: Flask steht unter der BSD-3-Clause.
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.
ASP.NET Core
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
ASP.NET Core ist das Web-Framework von Microsoft für die Plattform .NET. Damit baut man in C# Webanwendungen, REST-Schnittstellen und Echtzeitdienste. Es ist quelloffen, läuft unter Linux genauso wie unter Windows und bringt mit Kestrel einen eigenen, schnellen Webserver mit.
Vorbemerkungen
-
Installation über apt: Ubuntu 26.04 liefert .NET 10 selbst, die aktuelle Version mit Langzeitunterstützung (LTS) bis November 2028. Das .NET SDK enthält ASP.NET Core bereits, ein Paketarchiv von Microsoft ist nicht nötig.
-
Vorlagen: Neue Projekte legt man mit
dotnet newaus Vorlagen an. Die wichtigsten für Webanwendungen:Vorlage Inhalt webLeeres Projekt mit Minimal API: Endpunkte werden direkt in Program.csfestgelegt. Wird in dieser Anleitung verwendet.webapiREST-Schnittstelle mit Beispiel-Endpunkt und OpenAPI-Beschreibung mvcWebanwendung nach dem Muster Model-View-Controller webappWebanwendung mit Razor Pages (eine Datei pro Seite) blazorInteraktive Weboberfläche in C# statt JavaScript -
Nur HTTP: Auf dem Entwicklungsrechner läuft die Anwendung hier über einfaches HTTP an
127.0.0.1. HTTPS übernimmt im echten Betrieb meist ein vorgeschalteter Webserver wie nginx.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des .NET SDK aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. .NET SDK installieren
Installiert den Befehl dotnet, den C#-Compiler, die Laufzeitumgebungen für .NET und ASP.NET Core sowie die Projektvorlagen. Ist es schon vorhanden (z. B. aus der Anleitung Microsoft Visual Studio), meldet apt das nur.
sudo apt install dotnet-sdk-10.0
Prüfen: In der Liste steht Microsoft.AspNetCore.App 10.0…, also die Laufzeitumgebung für ASP.NET Core.
dotnet --list-runtimes
3. Optional: Nutzungsstatistik abschalten
Die Befehlszeile dotnet kann anonyme Nutzungsdaten an Microsoft senden. Diese Zeile in ~/.bashrc schaltet das für alle künftigen Terminals ab. Danach ein neues Terminal öffnen.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
export DOTNET_CLI_TELEMETRY_OPTOUT=1
Erstes Projekt
4. Projekt anlegen
Erzeugt aus der Vorlage web ein leeres Projekt im Ordner ~/HalloWeb. Beim allerersten Aufruf von dotnet erscheint einmalig ein Begrüßungstext.
dotnet new web -o ~/HalloWeb
5. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/HalloWeb
Prüfen: Es werden unter anderem Program.cs (der Programmcode), HalloWeb.csproj (die Projektbeschreibung) und appsettings.json (Einstellungen) angezeigt.
ls
6. Programmcode schreiben
Ersetzt Program.cs durch eine kleine REST-Schnittstelle für Notizen. Die wichtigsten Bausteine:
WebApplication.CreateBuilderundBuild– richten die Anwendung mit Webserver, Protokollierung und Einstellungen einMapGet,MapPost– legen fest, welche Funktion eine Anfrage an eine Adresse beantwortet. Parameter wienameliest ASP.NET Core automatisch aus der Adresse, Objekte wieeingabeaus dem mitgeschickten JSON.- Rückgabewerte werden automatisch in JSON umgewandelt.
Results.Createdantwortet zusätzlich mit dem HTTP-Status201 Created. record– eine kurze Schreibweise für einfache Datenklassen
Die Notizen liegen nur im Arbeitsspeicher und sind nach einem Neustart weg. Für dauerhafte Speicherung verwendet man eine Datenbank, siehe „Wie geht es weiter?“.
nano Program.cs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
var notizen = new List<Notiz>();
// GET /hallo?name=... liefert eine Begrüßung als JSON
app.MapGet("/hallo", (string? name) => new { gruss = $"Hallo {name ?? "Welt"}!" });
// GET /notizen liefert alle Notizen
app.MapGet("/notizen", () => notizen);
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
app.MapPost("/notizen", (NeueNotiz eingabe) =>
{
var notiz = new Notiz(notizen.Count + 1, eingabe.Titel, DateTime.Now);
notizen.Add(notiz);
return Results.Created($"/notizen/{notiz.Id}", notiz);
});
app.Run();
// Datentypen: "record" ist eine kurze Schreibweise für einfache Datenklassen
record NeueNotiz(string Titel);
record Notiz(int Id, string Titel, DateTime Erstellt);
7. Projekt übersetzen
Übersetzt das Projekt und meldet Fehler im Code, ohne die Anwendung zu starten. Beim ersten Mal dauert das einige Sekunden länger.
dotnet build
Prüfen: Die Ausgabe endet mit 0 Warnung(en) und 0 Fehler.
Starten und testen
8. Anwendung starten
dotnet run übersetzt das Projekt bei Bedarf und startet es. Ohne weitere Angabe würde die Anwendung auf einem zufällig bei der Projektanlage gewählten Port laufen (festgelegt in Properties/launchSettings.json). --urls legt stattdessen Adresse und Port fest: nur der eigene Rechner, Port 5000. Das Terminal bleibt belegt, solange die Anwendung läuft.
dotnet run --urls http://127.0.0.1:5000
Prüfen: Die Ausgabe enthält Now listening on: http://127.0.0.1:5000 und Hosting environment: Development.
9. Begrüßung abrufen
Öffne ein zweites Terminal und frage den ersten Endpunkt ab.
curl "http://localhost:5000/hallo?name=Thorsten"
Prüfen: Die Antwort lautet {"gruss":"Hallo Thorsten!"}.
10. Notiz anlegen
Schickt eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort an.
curl -i -X POST http://localhost:5000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, darunter steht Location: /notizen/1. Die letzte Zeile enthält die Notiz mit "id":1 und dem Erstellungszeitpunkt.
11. Alle Notizen abrufen
Fragt die Liste ab.
curl http://localhost:5000/notizen
Prüfen: Die Antwort ist eine Liste mit der Notiz aus dem vorigen Schritt.
12. Anwendung beenden
Wechsle in das erste Terminal und drücke Strg+C.
Tipp: Statt dotnet run kannst du beim Entwickeln dotnet watch run --urls http://127.0.0.1:5000 verwenden. Dann übernimmt die laufende Anwendung Änderungen am Code sofort, ohne dass du sie neu starten musst.
Fertige Anwendung erstellen
13. Anwendung veröffentlichen
publish übersetzt das Projekt in der optimierten Einstellung Release und legt alles, was zum Betrieb nötig ist, in den Ordner veroeffentlicht. Auf dem Zielrechner muss dafür nur die ASP.NET-Core-Laufzeitumgebung installiert sein (Paket aspnetcore-runtime-10.0), nicht das ganze SDK.
dotnet publish -c Release -o veroeffentlicht
Prüfen: Im Ordner liegen unter anderem HalloWeb (das Startprogramm) und HalloWeb.dll.
ls veroeffentlicht
14. Veröffentlichte Anwendung starten
Startet die fertige Anwendung so, wie sie auch auf einem Server laufen würde.
./veroeffentlicht/HalloWeb --urls http://127.0.0.1:5000
Prüfen: Die Ausgabe enthält jetzt Hosting environment: Production. Im zweiten Terminal liefert curl http://localhost:5000/hallo die Antwort {"gruss":"Hallo Welt!"}. Mit Strg+C beendest du die Anwendung.
Wie geht es weiter?
- Datenbank: Entity Framework Core bildet C#-Klassen auf Tabellen ab. Für PostgreSQL fügst du mit
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQLden passenden Treiber hinzu. - Betrieb: Auf einem Server lässt man die veröffentlichte Anwendung als systemd-Dienst laufen und setzt nginx als Reverse Proxy davor, der auch HTTPS übernimmt.
- Entwicklungsumgebung: VS Code mit dem C# Dev Kit, siehe Microsoft Visual Studio, oder JetBrains Rider.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt übersetzter und veröffentlichter Dateien.
rm -rf ~/HalloWeb
2. Einstellung zur Nutzungsstatistik entfernen
Nur nötig, wenn du Schritt 3 ausgeführt hast.
nano ~/.bashrc
Suche mit Strg+W nach DOTNET_CLI_TELEMETRY_OPTOUT und drücke Enter. Lösche die Zeile export DOTNET_CLI_TELEMETRY_OPTOUT=1 mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
3. Optional: .NET SDK entfernen
Nur ausführen, wenn kein anderes Projekt .NET braucht.
sudo apt purge dotnet-sdk-10.0
sudo apt autoremove
4. Optional: Zwischenspeicher entfernen
~/.dotnet enthält Einstellungen des Befehls dotnet, ~/.nuget heruntergeladene Bibliotheken. Andere .NET-Projekte laden sie bei Bedarf neu.
rm -rf ~/.dotnet ~/.nuget
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/HalloWeb
Quellen und Lizenz
- Offizielle Dokumentation: https://learn.microsoft.com/aspnet/core/
- Lizenz: ASP.NET Core steht unter der MIT.
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.
Axum und Actix-web
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Axum und Actix-web sind die beiden verbreitetsten Web-Frameworks für die Programmiersprache Rust. Mit ihnen baut man sehr schnelle und speichersichere Webserver und REST-Schnittstellen. Das Ergebnis ist ein einzelnes, eigenständiges Programm ohne Laufzeitumgebung.
Vorbemerkungen
-
Die beiden Frameworks im Vergleich:
Axum Actix-web Lizenz MIT MIT oder Apache 2.0 (nach Wahl) Herkunft Vom Tokio-Projekt, das auch die Grundlage für asynchrones Rust liefert Eigenständiges Projekt, eines der ältesten Rust-Web-Frameworks Routen festlegen Zentral im Router, Funktionen bleiben gewöhnlicheasync fnÜber Makros wie #[get("/pfad")]direkt an der FunktionLaufzeit Tokio, gemeinsam für den ganzen Server Eigenes System auf Tokio-Basis, ein Arbeitsbereich pro Prozessorkern Besonderheit Passt nahtlos zu anderen Tokio- und Tower-Bausteinen Sehr ausgereift, eigenes Ökosystem an Erweiterungen Beide sind schnell genug für praktisch jeden Einsatz. Die Wahl ist vor allem eine Frage des Geschmacks.
-
Installation: Den Rust-Compiler
rustcund das Build-Werkzeugcargoliefert Ubuntu 26.04 in Version 1.93. Das genügt für beide Frameworks (Axum braucht mindestens 1.80, Actix-web mindestens 1.88). Die Frameworks selbst werden pro Projekt voncargoaus dem Paketverzeichnis crates.io geladen. -
Gleiches Beispiel: Beide Projekte bekommen dieselbe kleine Notiz-Schnittstelle wie in der ASP.NET-Core-Anleitung, damit man sie gut vergleichen kann.
-
Versionen: Axum 0.8, Actix-web 4.15, Tokio 1.53.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Rust und Cargo aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Rust und Cargo installieren
Installiert den Compiler rustc und das Build-Werkzeug cargo, das Projekte anlegt, Abhängigkeiten lädt und übersetzt. Den C-Compiler gcc, den Rust zum Zusammenfügen (Linken) der Programme braucht, installiert apt automatisch mit.
sudo apt install rustc cargo
Prüfen: Die Ausgabe nennt die Version, z. B. cargo 1.93.1.
cargo --version
Hast du Rust zusätzlich über rustup installiert (Befehle im Ordner ~/.cargo/bin), wird dessen neuere Version angezeigt. Das ist in Ordnung, beide Wege funktionieren.
Axum
3. Projekt anlegen
cargo new legt ein neues Rust-Programm im Ordner ~/hallo-axum an: die Projektbeschreibung Cargo.toml und den Quellcode src/main.rs.
cargo new ~/hallo-axum
4. In den Projektordner wechseln
Die Befehle bis Schritt 10 beziehen sich auf diesen Ordner.
cd ~/hallo-axum
5. Abhängigkeiten hinzufügen
cargo add trägt Bibliotheken (in Rust Crates genannt) in Cargo.toml ein:
axum– das Web-Frameworktokiomit allen Funktionen (full) – die Laufzeitumgebung für asynchrone Programme, auf der Axum aufbautserdemitderive– wandelt eigene Datentypen in JSON um und zurückserde_json– für JSON-Werte ohne eigenen Datentyp
cargo add axum tokio serde serde_json --features tokio/full,serde/derive
Prüfen: Im Abschnitt [dependencies] stehen die vier Crates mit ihren Versionen.
cat Cargo.toml
6. Programmcode schreiben
Ersetzt src/main.rs. Die wichtigsten Bausteine:
#[derive(Serialize, Deserialize)]– erzeugt automatisch den Code zum Umwandeln in und aus JSON- Handler – gewöhnliche
async fn. Was sie brauchen, geben sie als Parameter an:Queryliest Werte aus der Adresse,Jsonaus dem mitgeschickten Inhalt,Stategreift auf gemeinsame Daten zu. Arc<Mutex<…>>– eine Liste, die sich alle gleichzeitig laufenden Anfragen sicher teilen könnenRouter– legt zentral fest, welcher Handler welche Adresse und Methode beantwortetTcpListener::bind("127.0.0.1:3000")– der Server ist nur vom eigenen Rechner aus erreichbar, auf Port 3000
nano src/main.rs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
use std::sync::{Arc, Mutex};
use axum::{
extract::{Query, State},
http::StatusCode,
routing::get,
Json, Router,
};
use serde::{Deserialize, Serialize};
// Datentypen: Serialize/Deserialize wandeln automatisch in JSON um und zurück
#[derive(Clone, Serialize)]
struct Notiz {
id: usize,
titel: String,
}
#[derive(Deserialize)]
struct NeueNotiz {
titel: String,
}
#[derive(Deserialize)]
struct Name {
name: Option<String>,
}
// Gemeinsamer Zustand: die Notizliste, sicher für gleichzeitige Zugriffe
type Notizen = Arc<Mutex<Vec<Notiz>>>;
// GET /hallo?name=... liefert eine Begrüßung als JSON
async fn hallo(Query(abfrage): Query<Name>) -> Json<serde_json::Value> {
let name = abfrage.name.unwrap_or_else(|| "Welt".to_string());
Json(serde_json::json!({ "gruss": format!("Hallo {name}!") }))
}
// GET /notizen liefert alle Notizen
async fn liste(State(notizen): State<Notizen>) -> Json<Vec<Notiz>> {
Json(notizen.lock().unwrap().clone())
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
async fn anlegen(
State(notizen): State<Notizen>,
Json(eingabe): Json<NeueNotiz>,
) -> (StatusCode, Json<Notiz>) {
let mut liste = notizen.lock().unwrap();
let notiz = Notiz { id: liste.len() + 1, titel: eingabe.titel };
liste.push(notiz.clone());
(StatusCode::CREATED, Json(notiz))
}
#[tokio::main]
async fn main() {
let notizen: Notizen = Arc::new(Mutex::new(Vec::new()));
// Router: welche Funktion beantwortet welche Adresse und Methode
let app = Router::new()
.route("/hallo", get(hallo))
.route("/notizen", get(liste).post(anlegen))
.with_state(notizen);
// Nur vom eigenen Rechner aus erreichbar, Port 3000
let listener = tokio::net::TcpListener::bind("127.0.0.1:3000").await.unwrap();
println!("Axum läuft auf http://127.0.0.1:3000");
axum::serve(listener, app).await.unwrap();
}
7. Übersetzen und starten
cargo run lädt beim ersten Mal alle Crates herunter (nach ~/.cargo/registry), übersetzt sie und startet das Programm. Das dauert beim ersten Mal etwa eine halbe Minute, danach nur noch Sekunden. Das Terminal bleibt belegt, solange der Server läuft.
cargo run
Prüfen: Die letzte Zeile lautet Axum läuft auf http://127.0.0.1:3000.
8. Schnittstelle testen
Öffne ein zweites Terminal und lege eine Notiz an.
curl -i -X POST http://localhost:3000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, die letzte {"id":1,"titel":"Erste Notiz"}. Außerdem liefern:
curl http://localhost:3000/notizen→[{"id":1,"titel":"Erste Notiz"}]curl "http://localhost:3000/hallo?name=Thorsten"→{"gruss":"Hallo Thorsten!"}
Fehlt beim Anlegen die Angabe Content-Type: application/json, antwortet Axum mit 415 Unsupported Media Type.
9. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
10. Fertiges Programm erstellen
--release übersetzt mit allen Optimierungen. Das Ergebnis ist ein einzelnes Programm von etwa 2 MB, das ohne Rust oder weitere Dateien auf jedem vergleichbaren Linux-System läuft.
cargo build --release
Prüfen: Das Programm liegt unter target/release/hallo-axum und lässt sich direkt starten:
./target/release/hallo-axum
Mit Strg+C beendest du es wieder.
Actix-web
11. Projekt anlegen
Legt das zweite Projekt im Ordner ~/hallo-actix an.
cargo new ~/hallo-actix
12. In den Projektordner wechseln
Die Befehle bis Schritt 18 beziehen sich auf diesen Ordner.
cd ~/hallo-actix
13. Abhängigkeiten hinzufügen
Actix-web bringt seine Laufzeitumgebung selbst mit, deshalb ist tokio hier nicht nötig.
cargo add actix-web serde serde_json --features serde/derive
14. Programmcode schreiben
Ersetzt src/main.rs. Die Unterschiede zu Axum:
#[get("/hallo")],#[post("/notizen")]– die Adresse steht als Makro direkt über der Funktionweb::Query,web::Json,web::Data– entsprechenQuery,JsonundStatebei Axumimpl Responder– die Funktion gibt „irgendetwas Beantwortbares“ zurück, hier eineHttpResponsemit Status und JSONHttpServer::new(move || App::new() …)– Actix-web startet mehrere Arbeitsbereiche (einen pro Prozessorkern) und baut für jeden eine eigeneApp. Die gemeinsame Notizliste reichtweb::Dataan alle weiter.bind(("127.0.0.1", 8081))– nur vom eigenen Rechner aus erreichbar, auf Port 8081
Hinweis: Das Makro #[get("/notizen")] macht aus der Funktion liste einen gleichnamigen Datentyp. Eine Variable darf deshalb im selben Programm nicht ebenfalls liste heißen. Im Code unten heißt sie darum alle.
nano src/main.rs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
use std::sync::Mutex;
use actix_web::{get, post, web, App, HttpResponse, HttpServer, Responder};
use serde::{Deserialize, Serialize};
// Datentypen: Serialize/Deserialize wandeln automatisch in JSON um und zurück
#[derive(Clone, Serialize)]
struct Notiz {
id: usize,
titel: String,
}
#[derive(Deserialize)]
struct NeueNotiz {
titel: String,
}
#[derive(Deserialize)]
struct Name {
name: Option<String>,
}
// Gemeinsamer Zustand: die Notizliste, sicher für gleichzeitige Zugriffe
struct Notizen(Mutex<Vec<Notiz>>);
// GET /hallo?name=... liefert eine Begrüßung als JSON
#[get("/hallo")]
async fn hallo(abfrage: web::Query<Name>) -> impl Responder {
let name = abfrage.name.clone().unwrap_or_else(|| "Welt".to_string());
HttpResponse::Ok().json(serde_json::json!({ "gruss": format!("Hallo {name}!") }))
}
// GET /notizen liefert alle Notizen
#[get("/notizen")]
async fn liste(notizen: web::Data<Notizen>) -> impl Responder {
HttpResponse::Ok().json(notizen.0.lock().unwrap().clone())
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
#[post("/notizen")]
async fn anlegen(notizen: web::Data<Notizen>, eingabe: web::Json<NeueNotiz>) -> impl Responder {
let mut alle = notizen.0.lock().unwrap();
let notiz = Notiz { id: alle.len() + 1, titel: eingabe.titel.clone() };
alle.push(notiz.clone());
HttpResponse::Created().json(notiz)
}
#[actix_web::main]
async fn main() -> std::io::Result<()> {
let notizen = web::Data::new(Notizen(Mutex::new(Vec::new())));
println!("Actix-web läuft auf http://127.0.0.1:8081");
// Für jeden Arbeits-Thread wird eine App mit denselben Routen gebaut;
// die Notizliste teilen sich alle über web::Data
HttpServer::new(move || {
App::new()
.app_data(notizen.clone())
.service(hallo)
.service(liste)
.service(anlegen)
})
// Nur vom eigenen Rechner aus erreichbar, Port 8081
.bind(("127.0.0.1", 8081))?
.run()
.await
}
15. Übersetzen und starten
Lädt die Crates, übersetzt und startet den Server. Crates, die schon für Axum geladen wurden, holt cargo aus dem Zwischenspeicher.
cargo run
Prüfen: Die letzte Zeile lautet Actix-web läuft auf http://127.0.0.1:8081.
16. Schnittstelle testen
Im zweiten Terminal dieselbe Anfrage wie bei Axum, nur mit Port 8081.
curl -i -X POST http://localhost:8081/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die Antworten sind identisch mit denen von Axum: HTTP/1.1 201 Created und {"id":1,"titel":"Erste Notiz"}. Auch /notizen und /hallo?name=… verhalten sich gleich.
17. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
18. Fertiges Programm erstellen
Übersetzt mit allen Optimierungen. Das Programm ist mit etwa 7 MB etwas größer als bei Axum, weil Actix-web mehr Funktionen fest einbaut (z. B. Komprimierung).
cargo build --release
Prüfen: Das Programm liegt unter target/release/hallo-actix.
ls -lh target/release/hallo-actix
Wie geht es weiter?
- Datenbank: Die Crate
sqlxgreift asynchron auf PostgreSQL oder SQLite zu und prüft SQL-Abfragen schon beim Übersetzen. - Betrieb: Das fertige Programm lässt sich als systemd-Dienst starten (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage). Davor setzt man nginx, der auch HTTPS übernimmt.
- Entwicklungsumgebung: VS Code mit der Erweiterung „rust-analyzer“, Neovim mit rust-analyzer oder JetBrains RustRover.
Deinstallieren
1. Projekte entfernen
Löscht beide Projektordner samt übersetzter Programme.
rm -rf ~/hallo-axum ~/hallo-actix
2. Heruntergeladene Crates entfernen
cargo hat die Crates in ~/.cargo/registry zwischengespeichert. Achtung: Hast du Rust über rustup installiert, liegt in ~/.cargo auch die Rust-Installation selbst. Lösche dann nur diesen Unterordner, nicht ganz ~/.cargo.
rm -rf ~/.cargo/registry
3. Optional: Rust und Cargo entfernen
Nur ausführen, wenn du Rust aus den Ubuntu-Paketen nicht mehr brauchst.
sudo apt purge rustc cargo
sudo apt autoremove
Prüfen: Die Projektordner existieren nicht mehr.
ls ~/hallo-axum ~/hallo-actix
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.rs/axum/latest/axum/
- Lizenz: Axum und Actix-web steht unter der MIT / Apache-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.
Gin
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Gin ist das meistgenutzte Webframework für Go. Es ergänzt den Webserver aus der Go-Standardbibliothek um Routen mit Platzhaltern, bequeme JSON-Antworten, die Prüfung eingehender Daten und fertige Bausteine für Protokoll und Fehlerbehandlung. Das Ergebnis ist ein einziges ausführbares Programm, das ohne weitere Laufzeitumgebung auf dem Server läuft.
Vorbemerkungen
- Go aus den Paketquellen: Go kommt als Paket
golang-goaus Ubuntu 26.04 (Go 1.26). Gin selbst ist eine Bibliothek, diegoin jedes Projekt einzeln aus dem Internet lädt. Das Ubuntu-Paketgolang-github-gin-gonic-gin-deventhält nur die alte Version 1.8 und wird hier nicht verwendet. - Port 8000: Gin würde ohne Angabe auf Port 8080 lauschen. Das Beispiel legt Port 8000 fest, weil 8080 oft schon belegt ist, etwa von Apache aus der Tileserver-Anleitung. Port 8000 darf nicht von einem anderen Programm belegt sein.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, FastAPI, Flask und Axum und Actix-web. Die Notizen liegen nur im Arbeitsspeicher.
- Version: Getestet mit Gin 1.12.0 und Go 1.26.0 aus Ubuntu 26.04. Gin 1.12 braucht Go 1.25 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Go installieren
Ist Go aus der Go-Anleitung schon installiert, meldet apt das nur.
sudo apt install golang-go
Prüfen: Die Ausgabe lautet go version go1.26.0 linux/amd64 oder nennt eine neuere Version 1.26.
go version
Erstes Projekt
3. Projektordner anlegen
mkdir ~/hallo-gin
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo-gin
5. Modul anlegen
Legt die Datei go.mod an. Sie enthält den Namen des Projekts und später die Liste der Bibliotheken.
go mod init hallo-gin
Prüfen: Die Ausgabe lautet go: creating new go.mod: module hallo-gin.
6. Gin herunterladen
Lädt Gin und alle Bibliotheken, die Gin selbst braucht, nach ~/go/pkg/mod und trägt sie in go.mod ein. Die Prüfsummen landen in go.sum. So bekommt jeder, der das Projekt später übersetzt, genau dieselben Versionen.
go get github.com/gin-gonic/gin
Prüfen: Die Ausgabe enthält eine Zeile go: added github.com/gin-gonic/gin v1.12.0 oder eine neuere Version. go.mod enthält danach die Zeile go 1.25.0, die Mindestversion, die Gin verlangt.
7. Anwendung schreiben
Legt die Datei main.go an. Die wichtigsten Bausteine:
- Strukturen (
type Notiz struct) – beschreiben, wie die Daten aussehen. Die Angaben in Backticks wie`json:"titel"`legen den Feldnamen im JSON fest.`binding:"required"`machttitelbeim Anlegen zur Pflicht. gin.Default()– erzeugt den Router samt Protokoll jeder Anfrage im Terminal und einem Schutz, der bei einem Programmfehler mit Status500antwortet, statt den Server abstürzen zu lassen.SetTrustedProxies(nil)– Gin soll keine Kopfzeilen wieX-Forwarded-Forauswerten, die jeder Aufrufer fälschen kann. Ohne diese Zeile warnt Gin beim Start.- Routen (
r.GET,r.POST) – verbinden Adresse und Methode mit einer Funktion.:idist ein Platzhalter,c.Param("id")liest ihn als Text. c(der Kontext) – enthält die Anfrage und baut die Antwort.c.DefaultQueryliest Werte aus der Adresse (?name=…),c.ShouldBindJSONden mitgeschickten JSON-Inhalt samt Prüfung,c.JSONantwortet mit Status und JSON.gin.Hist eine Kurzschreibweise für ein beliebiges JSON-Objekt.sync.Mutex– Gin bearbeitet Anfragen gleichzeitig. Die Sperre sorgt dafür, dass immer nur eine Anfrage die Liste der Notizen liest oder ändert.r.NoRoute– beantwortet alle unbekannten Adressen mit JSON.
nano main.go
Füge diesen Inhalt ein (Strg+Umschalt+V):
package main
import (
"net/http"
"strconv"
"sync"
"github.com/gin-gonic/gin"
)
// Notiz ist eine gespeicherte Notiz; die json-Angaben legen die Feldnamen im JSON fest
type Notiz struct {
ID int `json:"id"`
Titel string `json:"titel"`
}
// NotizNeu ist das, was man beim Anlegen schickt; titel ist Pflicht
type NotizNeu struct {
Titel string `json:"titel" binding:"required"`
}
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
var (
notizen = []Notiz{}
sperre sync.Mutex // Anfragen laufen gleichzeitig, die Liste darf nur einer auf einmal ändern
)
func main() {
r := gin.Default()
// Keinem Proxy vertrauen: Die Adresse des Aufrufers kommt direkt aus der Verbindung
r.SetTrustedProxies(nil)
// GET /hallo?name=... liefert eine Begrüßung als JSON
r.GET("/hallo", func(c *gin.Context) {
name := c.DefaultQuery("name", "Welt")
c.JSON(http.StatusOK, gin.H{"gruss": "Hallo " + name + "!"})
})
// GET /notizen liefert alle Notizen
r.GET("/notizen", func(c *gin.Context) {
sperre.Lock()
defer sperre.Unlock()
c.JSON(http.StatusOK, notizen)
})
// GET /notizen/1 liefert eine Notiz oder 404
r.GET("/notizen/:id", func(c *gin.Context) {
id, err := strconv.Atoi(c.Param("id"))
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{"fehler": "Nummer ist keine Zahl"})
return
}
sperre.Lock()
defer sperre.Unlock()
for _, n := range notizen {
if n.ID == id {
c.JSON(http.StatusOK, n)
return
}
}
c.JSON(http.StatusNotFound, gin.H{"fehler": "Notiz nicht gefunden"})
})
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
r.POST("/notizen", func(c *gin.Context) {
var daten NotizNeu
if err := c.ShouldBindJSON(&daten); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"fehler": `Feld "titel" fehlt`})
return
}
sperre.Lock()
defer sperre.Unlock()
n := Notiz{ID: len(notizen) + 1, Titel: daten.Titel}
notizen = append(notizen, n)
c.Header("Location", "/notizen/"+strconv.Itoa(n.ID))
c.JSON(http.StatusCreated, n)
})
// Alle anderen Adressen: 404 als JSON
r.NoRoute(func(c *gin.Context) {
c.JSON(http.StatusNotFound, gin.H{"fehler": "Nicht gefunden"})
})
// Nur vom eigenen Rechner aus erreichbar, Port 8000
r.Run("127.0.0.1:8000")
}
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Quelltext prüfen
go vet übersetzt den Code und sucht nach typischen Fehlern. Tippfehler oder fehlende Klammern fallen so auf, bevor der Server startet.
go vet ./...
Prüfen: Der Befehl gibt nichts aus. Meldet er Fehler, nennt er Datei und Zeile.
Starten und testen
9. Server starten
go run . übersetzt das Projekt und startet es sofort. Beim ersten Mal dauert das einige Sekunden, weil Go auch Gin und alle Bibliotheken übersetzt. Das Terminal bleibt belegt, hier erscheint zu jeder Anfrage eine Zeile mit Status, Dauer und Adresse.
go run .
Prüfen: Die Ausgabe listet die vier Routen, z. B. [GIN-debug] GET /hallo, und endet mit [GIN-debug] Listening and serving HTTP on 127.0.0.1:8000. Die Warnung Running in "debug" mode erklärt Schritt 13.
10. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Im ersten Terminal erscheint eine Zeile mit 201 und POST "/notizen".
11. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl http://localhost:8000/notizen/abc | {"fehler":"Nummer ist keine Zahl"} (Status 400) |
curl http://localhost:8000/gibtsnicht | {"fehler":"Nicht gefunden"} (Status 404) |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
Den fehlenden Titel erkennt ShouldBindJSON an der Angabe binding:"required" in der Struktur NotizNeu. Dieselbe Antwort kommt, wenn der Inhalt gar kein gültiges JSON ist.
12. Änderung mit Neustart ausprobieren
Go ist eine übersetzte Sprache. Änderungen am Code wirken erst, wenn das Programm neu übersetzt und gestartet wird. Ändere in main.go das Wort Hallo in der Route /hallo z. B. in Servus und speichere die Datei. Drücke im ersten Terminal Strg+C und starte den Server neu:
go run .
Prüfen: curl http://localhost:8000/hallo liefert jetzt {"gruss":"Servus Welt!"}. Die Notizen aus Schritt 10 sind durch den Neustart verloren, weil sie nur im Arbeitsspeicher lagen. Diesmal startet der Server fast sofort, weil Go übersetzte Bibliotheken in ~/.cache/go-build aufbewahrt.
13. Eigenständiges Programm erzeugen
Beende den Server mit Strg+C. go build übersetzt das Projekt in eine einzige Programmdatei hallo-gin, die Gin und alle Bibliotheken enthält. Auf einem Server braucht sie weder Go noch den Quelltext.
go build
Prüfen: Die Datei hallo-gin ist rund 30 MB groß.
ls -lh hallo-gin
14. Programm im Release-Modus starten
Im Debug-Modus schreibt Gin beim Start Hinweise und die Liste aller Routen ins Terminal. GIN_MODE=release schaltet das ab, so wie man das Programm später auf einem Server betreibt. Das Protokoll der einzelnen Anfragen bleibt.
GIN_MODE=release ./hallo-gin
Prüfen: Das Terminal bleibt leer, bis die erste Anfrage kommt. curl http://localhost:8000/notizen liefert [], im Terminal erscheint eine Zeile mit 200 und GET "/notizen".
15. Server beenden
Drücke im ersten Terminal Strg+C.
Wie geht es weiter?
- Gruppen:
api := r.Group("/api")fasst Routen unter einem gemeinsamen Anfang zusammen.api.GET("/notizen", …)ist dann unter/api/notizenerreichbar. - Mehr Prüfungen: Die Angabe
bindingkennt weitere Regeln, z. B.`binding:"required,max=200"`oderemail. Den genauen Grund lieferterr.Error(). - Datenbank: Für PostgreSQL gibt es die Bibliothek
github.com/jackc/pgx/v5, für SQLitemodernc.org/sqlite. Beide lädt man mitgo getwie Gin in Schritt 6. - Automatischer Neustart: Werkzeuge wie
air(go install github.com/air-verse/air@latest) beobachten die Dateien und starten den Server bei jeder Änderung neu. Dafür muss~/go/binim Suchpfad stehen, siehe Go-Anleitung. - Betrieb: Auf einem Server kopiert man nur die Datei
hallo-ginhin und startet sie mitGIN_MODE=releaseüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage). Davor setzt man nginx, der auch HTTPS übernimmt.
Deinstallieren
1. Server beenden
Läuft go run . oder ./hallo-gin noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt Programmdatei.
rm -rf ~/hallo-gin
3. Heruntergeladene Bibliotheken löschen (optional)
Gin und seine Bibliotheken liegen weiter in ~/go/pkg/mod. Dieser Befehl löscht den ganzen Ordner. Das betrifft alle Go-Projekte, die ihre Bibliotheken dann beim nächsten Übersetzen neu laden.
go clean -modcache
4. Go entfernen (optional)
Nur ausführen, wenn du Go nicht mehr brauchst. Die weiteren Schritte zum vollständigen Entfernen stehen in der Go-Anleitung.
sudo apt purge golang-go
Prüfen: Die Shell meldet, dass der Befehl go nicht gefunden wurde.
go version
Quellen und Lizenz
- Offizielle Dokumentation: https://gin-gonic.com/docs/
- Lizenz: Gin steht unter der MIT.
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.
Express.js
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Express ist das bekannteste Web-Framework für Node.js. Es ist bewusst klein gehalten: Es kümmert sich um Adressen (Routen), Anfragen und Antworten und lässt sich über Middleware beliebig erweitern. Damit baut man in JavaScript Webserver und REST-Schnittstellen.
Vorbemerkungen
- Installation pro Projekt: Express wird mit
npmin jedes Projekt einzeln installiert. Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. Ubuntu enthält zwar auch ein Paketnode-express(Version 5.1), es hinkt der aktuellen Version aber hinterher und wird inpackage.jsonnicht vermerkt. Ein Projekt, das darauf aufbaut, lässt sich deshalb nicht ohne Weiteres auf einen anderen Rechner übertragen. - Version: Express 5.2. Gegenüber Express 4, das noch in vielen Beispielen im Netz steht, gibt es kleine Änderungen, etwa bei Mustern in Adressen und der Behandlung von Fehlern in
async-Funktionen. - Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu ASP.NET Core und Axum und Actix-web.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen von Node.js und npm aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt den Server aus, npm lädt Express herunter. Ist beides schon vorhanden (z. B. aus der Docusaurus-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer beginnt mit v18 oder höher, z. B. v22.22.1. Express 5 braucht mindestens Node.js 18.
node --version
Erstes Projekt
3. Projektordner anlegen
Ein eigener Ordner für das Projekt.
mkdir ~/hallo-express
4. In den Projektordner wechseln
Alle weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/hallo-express
5. Projekt anlegen
Legt die Datei package.json an. Darin hält npm fest, welche Pakete das Projekt braucht. -y übernimmt alle Vorgaben, ohne nachzufragen.
npm init -y
6. Moderne Modul-Schreibweise einschalten
Erlaubt im Code die Schreibweise import … from …, die heute in JavaScript üblich ist.
npm pkg set type=module
7. Express installieren
Lädt Express mit seinen Abhängigkeiten in den Ordner node_modules (etwa 4 MB) und trägt es in package.json ein.
npm install express
Prüfen: Die Ausgabe zeigt express@5.2.1 (oder eine neuere 5er-Version).
npm ls
8. Server schreiben
Legt die Datei server.js an. Die wichtigsten Bausteine:
- Middleware (
app.use) – Funktionen, die jede Anfrage der Reihe nach durchläuft, bevor eine Route sie beantwortet.express.json()liest mitgeschickte JSON-Inhalte inreq.bodyein. Die eigene Middleware darunter schreibt jede Anfrage ins Terminal und reicht sie mitnext()weiter. - Routen (
app.get,app.post) – legen fest, welche Funktion welche Adresse und Methode beantwortet.reqenthält die Anfrage (z. B.req.queryfür Werte aus der Adresse), mitreswird geantwortet. res.json()wandelt ein Objekt in JSON um,res.status()setzt den HTTP-Status, z. B.201 Createdoder400 Bad Request.- Die letzte Middleware fängt alle Adressen ab, für die es keine Route gibt, und antwortet mit
404als JSON. app.listen(3000, '127.0.0.1', …)– nur vom eigenen Rechner aus erreichbar, auf Port 3000. Ohne die Adresse wäre der Server aus dem ganzen Netz erreichbar.
nano server.js
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import express from 'express'
const app = express()
// Middleware: läuft vor jeder Anfrage. express.json() liest JSON-Inhalte ein
app.use(express.json())
// Eigene Middleware: protokolliert jede Anfrage im Terminal
app.use((req, res, next) => {
console.log(`${new Date().toLocaleTimeString('de-DE')} ${req.method} ${req.url}`)
next()
})
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
const notizen = []
// GET /hallo?name=... liefert eine Begrüßung als JSON
app.get('/hallo', (req, res) => {
res.json({ gruss: `Hallo ${req.query.name ?? 'Welt'}!` })
})
// GET /notizen liefert alle Notizen
app.get('/notizen', (req, res) => {
res.json(notizen)
})
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
app.post('/notizen', (req, res) => {
if (!req.body?.titel) {
return res.status(400).json({ fehler: 'Feld "titel" fehlt' })
}
const notiz = { id: notizen.length + 1, titel: req.body.titel }
notizen.push(notiz)
res.status(201).location(`/notizen/${notiz.id}`).json(notiz)
})
// Alles andere: 404 als JSON statt der Standard-HTML-Seite
app.use((req, res) => {
res.status(404).json({ fehler: 'Nicht gefunden' })
})
// Nur vom eigenen Rechner aus erreichbar, Port 3000
app.listen(3000, '127.0.0.1', () => {
console.log('Express läuft auf http://127.0.0.1:3000')
})
9. Startbefehle festlegen
Trägt zwei Kurzbefehle in package.json ein:
npm start– startet den Server normalnpm run dev– startet ihn mit--watch: Node.js startet den Server bei jeder gespeicherten Änderung anserver.jsautomatisch neu
npm pkg set scripts.start="node server.js" scripts.dev="node --watch server.js"
Starten und testen
10. Server im Entwicklungsmodus starten
Das Terminal bleibt belegt, solange der Server läuft. Hier erscheinen auch die Zeilen der Protokoll-Middleware.
npm run dev
Prüfen: Die letzte Zeile lautet Express läuft auf http://127.0.0.1:3000.
11. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:3000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Im ersten Terminal erscheint eine Zeile wie 22:18:41 POST /notizen.
12. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:3000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl "http://localhost:3000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl -X POST http://localhost:3000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:3000/gibtsnicht | {"fehler":"Nicht gefunden"} (Status 404) |
13. Automatischen Neustart ausprobieren
Ändere in server.js das Wort Hallo in der Route /hallo z. B. in Servus und speichere die Datei. Im ersten Terminal erscheint Restarting 'server.js', danach startet der Server neu.
Prüfen: curl http://localhost:3000/hallo liefert jetzt {"gruss":"Servus Welt!"}. Die Notizen aus Schritt 11 sind durch den Neustart verloren, weil sie nur im Arbeitsspeicher lagen.
14. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Wie geht es weiter?
- Betrieb: Auf einem Server startet man die Anwendung mit
npm startüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt. Setze dort die UmgebungsvariableNODE_ENV=production, damit Express Fehlermeldungen knapper ausgibt. - Datenbank: Das Paket
pgverbindet Node.js mit PostgreSQL, Werkzeuge wie Prisma oder Drizzle bilden Tabellen auf JavaScript-Objekte ab. - HTML-Seiten: Mit
express.static('public')liefert Express Dateien aus einem Ordner aus. Für dynamische Seiten gibt es Vorlagensysteme wie EJS oder Pug. - Sicherheit: Die Middleware
helmetsetzt sinnvolle Sicherheits-Kopfzeilen,express-rate-limitbremst zu viele Anfragen.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt node_modules.
rm -rf ~/hallo-express
2. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (z. B. Antora, Docusaurus, VitePress, Starlight oder Excalidraw).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr.
ls ~/hallo-express
Quellen und Lizenz
- Offizielle Dokumentation: https://expressjs.com/
- Lizenz: Express steht unter der MIT.
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.
NestJS
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
NestJS (kurz Nest) ist ein Framework für Server-Anwendungen mit Node.js und TypeScript. Es baut auf Express auf und gibt größeren Projekten eine feste Ordnung: Controller nehmen Anfragen entgegen, Services enthalten die eigentliche Arbeit, Module fassen beides zusammen. Welche Methode welche Adresse beantwortet, steht als Decorator (@Get, @Post) direkt im Code.
Vorbemerkungen
- Installation pro Projekt: Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. Nest selbst und sein Befehlszeilenwerkzeug (Nest CLI) lädt
npmin jedes Projekt einzeln. - Einstellung für npm: Das npm 9.2 aus Ubuntu 26.04 bricht die Installation eines neuen Nest-Projekts mit
Cannot read properties of null (reading 'edgesOut')ab. Ursache ist, dass eine Testbibliothek des Projekts TypeScript 5 erwartet, das Projekt aber TypeScript 6 verwendet. Neuere npm-Versionen melden das nur als Warnung. Schritt 6 stellt npm für das Projekt so ein, dass es diesen Widerspruch übergeht. - Port 8000: Nest lauscht ohne Angabe auf Port 3000. Das Beispiel legt Port 8000 fest, weil 3000 oft schon belegt ist, etwa von Martin. Port 8000 darf nicht von einem anderen Programm belegt sein.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, FastAPI, Flask und Gin. Die Notizen liegen nur im Arbeitsspeicher.
- Version: Getestet mit NestJS 12.1 (Nest CLI 12.0.7), TypeScript 6, Node.js 22.22.1 und npm 9.2.0 aus Ubuntu 26.04. Nest 12 braucht Node.js 20 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt den Server aus, npm lädt Nest und alle Bibliotheken herunter. Ist beides schon vorhanden (z. B. aus der Express-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer beginnt mit v20 oder höher, z. B. v22.22.1.
node --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
npx lädt die Nest CLI nur für diesen einen Aufruf herunter, ohne sie dauerhaft zu installieren. new meinnest legt den Ordner meinnest mit einem fertigen Projekt samt Git-Repository an. --package-manager npm beantwortet die Frage nach dem Paketmanager im Voraus. --skip-install lässt die Bibliotheken zunächst weg, sie folgen nach der Einstellung in Schritt 6.
npx @nestjs/cli@latest new meinnest --package-manager npm --skip-install
Fragt npm Need to install the following packages: @nestjs/cli@… Ok to proceed? (y), bestätige mit Enter.
Prüfen: Die Ausgabe listet viele Zeilen CREATE meinnest/…, darunter CREATE meinnest/src/main.ts, und endet mit Thanks for installing Nest.
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinnest
6. npm für das Projekt einstellen
Eine Datei .npmrc im Projektordner gilt nur für dieses Projekt. legacy-peer-deps=true sagt npm, dass es nicht auf Versionsangaben achten soll, die eine Bibliothek an ihre Nachbarn stellt (Peer-Abhängigkeiten). So kommt das npm aus Ubuntu über den Widerspruch aus den Vorbemerkungen hinweg. Die Datei ist neu, nano startet mit einer leeren Seite.
nano .npmrc
Füge diese Zeile ein:
legacy-peer-deps=true
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Bibliotheken installieren
Lädt Nest, TypeScript, die Nest CLI und die Testwerkzeuge in den Ordner node_modules.
npm install
Prüfen: Die Ausgabe enthält added 348 packages (die Zahl kann abweichen). Die Meldung über vulnerabilities betrifft Werkzeuge für die Entwicklung. npm audit fix --force solltest du nicht ausführen, es kann Bibliotheken auf unpassende Versionen ändern.
8. Service erzeugen
Ein Service enthält die eigentliche Arbeit, hier das Verwalten der Notizen. npx nest ruft die Nest CLI aus node_modules auf. --flat legt die Datei direkt in src statt in einem eigenen Unterordner an, --no-spec lässt die Testdatei weg. Nest trägt den Service selbst in src/app.module.ts ein.
npx nest generate service notizen --flat --no-spec
Prüfen: Die Ausgabe lautet CREATE src/notizen.service.ts und UPDATE src/app.module.ts.
9. Controller erzeugen
Ein Controller nimmt Anfragen entgegen und gibt sie an den Service weiter.
npx nest generate controller notizen --flat --no-spec
Prüfen: Die Ausgabe lautet CREATE src/notizen.controller.ts und UPDATE src/app.module.ts.
10. Service ausfüllen
nano src/notizen.service.ts
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
import { Injectable, NotFoundException } from '@nestjs/common';
export interface Notiz {
id: number;
titel: string;
}
@Injectable()
export class NotizenService {
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg
private readonly notizen: Notiz[] = [];
alle(): Notiz[] {
return this.notizen;
}
eine(id: number): Notiz {
const notiz = this.notizen.find((n) => n.id === id);
if (!notiz) {
throw new NotFoundException('Notiz nicht gefunden');
}
return notiz;
}
anlegen(titel: string): Notiz {
const notiz = { id: this.notizen.length + 1, titel };
this.notizen.push(notiz);
return notiz;
}
}
interface Notiz– beschreibt, wie eine Notiz aussieht. TypeScript prüft damit beim Übersetzen, dass überall die richtigen Felder verwendet werden.@Injectable()– erlaubt Nest, den Service selbst zu erzeugen und an Controller weiterzugeben.NotFoundException– bricht ab. Nest macht daraus eine Antwort mit Status404und der Meldung als JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Controller ausfüllen
nano src/notizen.controller.ts
Ersetze den ganzen Inhalt wie in Schritt 10 und füge ein:
import {
BadRequestException,
Body,
Controller,
Get,
Param,
ParseIntPipe,
Post,
Res,
} from '@nestjs/common';
import type { Response } from 'express';
import type { Notiz } from './notizen.service.js';
import { NotizenService } from './notizen.service.js';
// Alle Routen dieser Klasse beginnen mit /notizen
@Controller('notizen')
export class NotizenController {
// Nest übergibt den Service selbst (Dependency Injection)
constructor(private readonly notizenService: NotizenService) {}
// GET /notizen liefert alle Notizen
@Get()
alle(): Notiz[] {
return this.notizenService.alle();
}
// GET /notizen/1 liefert eine Notiz oder 404
@Get(':id')
eine(@Param('id', ParseIntPipe) id: number): Notiz {
return this.notizenService.eine(id);
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
@Post()
anlegen(
@Body('titel') titel: unknown,
@Res({ passthrough: true }) res: Response,
): Notiz {
if (typeof titel !== 'string' || titel === '') {
throw new BadRequestException('Feld "titel" fehlt');
}
const notiz = this.notizenService.anlegen(titel);
res.location(`/notizen/${notiz.id}`);
return notiz;
}
}
- Decorators –
@Controller('notizen')legt den gemeinsamen Anfang der Adressen fest,@Get()und@Post()die Methode,@Get(':id')einen Platzhalter. - Parameter-Decorators – füllen die Parameter der Methoden:
@Param('id')aus der Adresse,@Body('titel')aus dem mitgeschickten JSON.ParseIntPipewandelt die Nummer in eine Zahl um und antwortet selbst mit400, wenn das nicht geht. - Rückgabewert – Nest wandelt ihn in JSON um. Bei
@Post()setzt Nest den Status201von selbst. @Res({ passthrough: true })– gibt Zugriff auf die Express-Antwort, hier für die KopfzeileLocation.passthroughsorgt dafür, dass Nest den Rückgabewert trotzdem als JSON sendet.import type–Notizist nur ein Typ, der nach dem Übersetzen verschwindet. Ohnetypebricht das Übersetzen mit dem FehlerTS1272ab.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Begrüßung ergänzen
Der Controller der Vorlage in src/app.controller.ts beantwortet schon die Startseite / mit Hello World!. Er bekommt zusätzlich die Route /hallo.
nano src/app.controller.ts
Ändere in der ersten Zeile { Controller, Get } in { Controller, Get, Query }. Drücke dann Strg+W, gib getHello() ein und drücke Enter. Setze den Cursor in die Zeile mit der schließenden Klammer } direkt unter return this.appService.getHello();, drücke Ende und dann Enter und füge ein:
// GET /hallo?name=... liefert eine Begrüßung als JSON
@Get('hallo')
hallo(@Query('name') name = 'Welt') {
return { gruss: `Hallo ${name}!` };
}
Die Klasse sieht danach so aus:
@Controller()
export class AppController {
constructor(private readonly appService: AppService) {}
@Get()
getHello(): string {
return this.appService.getHello();
}
// GET /hallo?name=... liefert eine Begrüßung als JSON
@Get('hallo')
hallo(@Query('name') name = 'Welt') {
return { gruss: `Hallo ${name}!` };
}
}
@Query('name') liest den Wert aus ?name=…. Fehlt er, gilt der Vorgabewert 'Welt'.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Adresse und Port festlegen
In src/main.ts startet der Server. Ohne Angabe wäre er auf Port 3000 aus dem ganzen Netz erreichbar.
nano src/main.ts
Ersetze die Zeile
await app.listen(process.env.PORT ?? 3000);
durch diese beiden Zeilen:
// Nur vom eigenen Rechner aus erreichbar, Port 8000
await app.listen(8000, '127.0.0.1');
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Starten und testen
14. Server im Entwicklungsmodus starten
start:dev übersetzt den TypeScript-Code, startet den Server und beobachtet danach alle Dateien in src. Das Terminal bleibt belegt.
npm run start:dev
Prüfen: Die Ausgabe enthält Found 0 errors. Watching for file changes., danach je eine Zeile Mapped {…} route für /, /hallo, /notizen (zweimal) und /notizen/:id und am Ende Nest application successfully started. Meldet sie Found 2 errors, stehen darüber Datei und Zeile, z. B. ein vergessenes import type aus Schritt 11.
15. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}.
16. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"message":"Notiz nicht gefunden","error":"Not Found","statusCode":404} |
curl http://localhost:8000/notizen/abc | {"message":"Validation failed (numeric string is expected)","error":"Bad Request","statusCode":400} |
curl http://localhost:8000/gibtsnicht | {"message":"Cannot GET /gibtsnicht","error":"Not Found","statusCode":404} |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"message":"Feld \"titel\" fehlt","error":"Bad Request","statusCode":400} |
Alle Fehler haben dieselbe Form, weil Nest jede Exception mit demselben Filter in JSON umwandelt, auch die Fehler, die gar nicht im eigenen Code entstehen (unbekannte Adresse, keine Zahl).
17. Automatischen Neustart ausprobieren
Ändere in src/app.controller.ts das Wort Hallo in der Methode hallo z. B. in Servus und speichere die Datei. Im ersten Terminal erscheint File change detected. Starting incremental compilation..., danach startet der Server neu.
Prüfen: curl http://localhost:8000/hallo liefert jetzt {"gruss":"Servus Welt!"}. Die Notizen aus Schritt 15 sind durch den Neustart verloren, weil sie nur im Arbeitsspeicher lagen.
18. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
19. Für den Betrieb übersetzen
Übersetzt den TypeScript-Code einmalig nach JavaScript in den Ordner dist.
npm run build
Prüfen: Im Ordner dist liegen main.js, app.module.js, notizen.controller.js und notizen.service.js.
ls dist/*.js
20. Übersetzte Fassung starten
start:prod startet dist/main.js direkt mit Node.js, ohne TypeScript und ohne Beobachtung der Dateien. So läuft die Anwendung später auf einem Server.
npm run start:prod
Prüfen: Die letzte Zeile lautet Nest application successfully started, curl http://localhost:8000/notizen liefert []. Beende den Server mit Strg+C.
Wie geht es weiter?
- Tests:
npm testführt die Tests mit Vitest aus. Die Vorlage bringt einen Test fürAppControllermit. - Eingaben prüfen: Mit
npm install class-validator class-transformerundapp.useGlobalPipes(new ValidationPipe())inmain.tsbeschreibt man Eingaben als Klassen mit Regeln wie@IsNotEmpty(). Nest prüft dann jede Anfrage selbst. - Ganze Ressource erzeugen:
npx nest generate resource aufgabenlegt Modul, Controller, Service und Klassen für Ein- und Ausgabe mit allen Methoden zum Lesen, Anlegen, Ändern und Löschen in einem eigenen Ordner an. - Datenbank: Nest arbeitet mit TypeORM (
@nestjs/typeorm), Prisma oder MikroORM zusammen, z. B. mit PostgreSQL. - Betrieb: Auf einem Server startet man
node dist/mainüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt.
Deinstallieren
1. Server beenden
Läuft npm run start:dev oder npm run start:prod noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt node_modules.
rm -rf ~/meinnest
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinnest
3. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf, auch die Nest CLI aus Schritt 4. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
4. Node.js und npm entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. Express oder Docusaurus.
sudo apt purge nodejs npm
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.nestjs.com/
- Lizenz: NestJS steht unter der MIT.
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.
Next.js
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Next.js ist ein Framework für Webanwendungen mit React. Seiten und Schnittstellen liegen im selben Projekt: Jede Datei page.tsx im Ordner app wird zu einer Seite, jede Datei route.ts zu einer Adresse der Schnittstelle. Seiten werden auf dem Server erzeugt und als fertiges HTML ausgeliefert, Formulare können mit Server Actions direkt Code auf dem Server aufrufen.
Vorbemerkungen
- Installation pro Projekt: Aus den Ubuntu-Paketquellen kommen nur Node.js und npm. Next.js, React und alle Werkzeuge lädt
npmin jedes Projekt einzeln, zusammen rund 600 MB im Ordnernode_modules. - Port 8000: Next.js lauscht ohne Angabe auf Port 3000. Das Beispiel legt Port 8000 fest, weil 3000 oft schon belegt ist, etwa von Martin. Port 8000 darf nicht von einem anderen Programm belegt sein.
- Gleiches Beispiel: Die Schnittstelle unter
/apientspricht der Notiz-Schnittstelle aus den Anleitungen zu Express, NestJS und FastAPI. Dazu kommt eine Seite, die die Notizen anzeigt und über ein Formular neue anlegt. Die Notizen liegen nur im Arbeitsspeicher. - Schriften von Google: Die Vorlage verwendet die Schrift Geist über
next/font/google. Next.js lädt sie beim Entwickeln und Bauen einmal von Google herunter und liefert sie danach selbst aus. Die Besucher der Seite verbinden sich also nicht mit Google. - Version: Getestet mit Next.js 16.3.6, React 19.2, Node.js 22.22.1 und npm 9.2.0 aus Ubuntu 26.04. Next.js 16 braucht Node.js 20.9 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt den Server aus, npm lädt Next.js und alle Bibliotheken herunter. Ist beides schon vorhanden (z. B. aus der Express-Anleitung), meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Versionsnummer ist v20.9 oder höher, z. B. v22.22.1.
node --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
npx lädt das Werkzeug create-next-app nur für diesen einen Aufruf herunter. Es legt den Ordner meinnext mit einem fertigen Projekt samt Git-Repository an und installiert alle Bibliotheken. --yes übernimmt für alle Fragen die Vorgaben: TypeScript, Tailwind CSS für die Gestaltung, ESLint zur Code-Prüfung und den App Router (Seiten im Ordner app). --use-npm legt npm als Paketmanager fest.
npx create-next-app@latest meinnext --yes --use-npm
Fragt npm Need to install the following packages: create-next-app@… Ok to proceed? (y), bestätige mit Enter.
Prüfen: Die Ausgabe enthält added 371 packages (die Zahl kann abweichen) und endet mit Success! Created meinnext at /home/…/meinnext. Die Warnung npm WARN deprecated eslint@9… kannst du übergehen.
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinnext
Im Projektordner liegen auch AGENTS.md und CLAUDE.md. Sie enthalten Hinweise für KI-Assistenten und sind für diese Anleitung nicht wichtig.
6. Port und Adresse festlegen
In package.json stehen unter scripts die Befehle, die npm run … ausführt.
nano package.json
Ändere die Zeilen "dev": "next dev", und "start": "next start", so, dass sie lauten:
"dev": "next dev -H 127.0.0.1 -p 8000",
"start": "next start -H 127.0.0.1 -p 8000",
-H 127.0.0.1 beschränkt den Server auf den eigenen Rechner, -p 8000 legt den Port fest. dev ist der Entwicklungsserver, start startet die fertig gebaute Anwendung.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Sprache und Titel anpassen
app/layout.tsx ist das Grundgerüst, das jede Seite umschließt.
nano app/layout.tsx
Ändere title: "Create Next App", in title: "Notizen", und lang="en" in lang="de". Der Titel erscheint im Browser-Tab, die Sprachangabe hilft Suchmaschinen und Vorleseprogrammen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Ordner für die Notizen anlegen
Code, der keine Seite und keine Route ist, legt man üblicherweise in einen eigenen Ordner lib.
mkdir lib
9. Notizen verwalten
nano lib/notizen.ts
Füge diesen Inhalt ein (Strg+Umschalt+V):
export type Notiz = { id: number; titel: string };
// Notizen nur im Arbeitsspeicher: Nach einem Neustart sind sie weg.
// globalThis sorgt dafür, dass Seite und API dieselbe Liste sehen.
const speicher = globalThis as unknown as { notizen?: Notiz[] };
const notizen: Notiz[] = (speicher.notizen ??= []);
export function alleNotizen(): Notiz[] {
return notizen;
}
export function findeNotiz(id: number): Notiz | undefined {
return notizen.find((n) => n.id === id);
}
export function legeNotizAn(titel: string): Notiz {
const notiz = { id: notizen.length + 1, titel };
notizen.push(notiz);
return notiz;
}
Next.js übersetzt Seiten und Routen getrennt. Ohne globalThis könnte jede ihre eigene Kopie der Liste bekommen. So hängt die Liste an einem Objekt, das es im Server-Prozess nur einmal gibt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Ordner für die Schnittstelle anlegen
Beim App Router bestimmen Ordner die Adresse: app/api/hallo wird zu /api/hallo. Ein Ordner in eckigen Klammern wie [id] ist ein Platzhalter. Die Anführungszeichen verhindern, dass die Shell die Klammern selbst auswertet.
mkdir -p app/api/hallo "app/api/notizen/[id]"
11. Route für die Begrüßung schreiben
Eine Datei route.ts beantwortet Anfragen an ihren Ordner. Der Name der exportierten Funktion ist die Methode, hier GET.
nano app/api/hallo/route.ts
Füge diesen Inhalt ein:
import type { NextRequest } from "next/server";
// GET /api/hallo?name=... liefert eine Begrüßung als JSON
export function GET(request: NextRequest) {
const name = request.nextUrl.searchParams.get("name") ?? "Welt";
return Response.json({ gruss: `Hallo ${name}!` });
}
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Route für alle Notizen schreiben
nano app/api/notizen/route.ts
Füge diesen Inhalt ein:
import { alleNotizen, legeNotizAn } from "@/lib/notizen";
// GET /api/notizen liefert alle Notizen
export function GET() {
return Response.json(alleNotizen());
}
// POST /api/notizen legt eine Notiz an; der Inhalt kommt als JSON
export async function POST(request: Request) {
const daten = await request.json().catch(() => null);
const titel = daten?.titel;
if (typeof titel !== "string" || titel === "") {
return Response.json({ fehler: 'Feld "titel" fehlt' }, { status: 400 });
}
const notiz = legeNotizAn(titel);
return Response.json(notiz, {
status: 201,
headers: { Location: `/api/notizen/${notiz.id}` },
});
}
@/lib/notizen–@/steht für den Projektordner. So muss man keine Pfade wie../../../libzählen.Response.json(…)– die Antwortklasse, die auch Browser kennen. Status und Kopfzeilen gibt man als zweiten Wert mit.request.json().catch(() => null)– liefertnullstatt eines Fehlers, wenn kein gültiges JSON ankommt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Route für eine Notiz schreiben
nano "app/api/notizen/[id]/route.ts"
Füge diesen Inhalt ein:
import type { NextRequest } from "next/server";
import { findeNotiz } from "@/lib/notizen";
// GET /api/notizen/1 liefert eine Notiz oder 404
export async function GET(_request: NextRequest, ctx: RouteContext<"/api/notizen/[id]">) {
const { id } = await ctx.params;
const notiz = findeNotiz(Number(id));
if (!notiz) {
return Response.json({ fehler: "Notiz nicht gefunden" }, { status: 404 });
}
return Response.json(notiz);
}
ctx.params enthält den Platzhalter [id] als Text. Seit Next.js 15 muss man ihn mit await abwarten. RouteContext<…> ist ein Typ, den Next.js aus der Ordnerstruktur selbst erzeugt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Startseite schreiben
app/page.tsx ist die Seite unter /. Sie zeigt die Notizen und ein Formular.
nano app/page.tsx
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
import { revalidatePath } from "next/cache";
import { alleNotizen, legeNotizAn } from "@/lib/notizen";
// Die Seite bei jedem Aufruf neu erzeugen, weil sich die Notizen ändern
export const dynamic = "force-dynamic";
// Server Action: läuft auf dem Server, wenn das Formular abgeschickt wird
async function notizAnlegen(formData: FormData) {
"use server";
const titel = formData.get("titel");
if (typeof titel === "string" && titel !== "") {
legeNotizAn(titel);
revalidatePath("/");
}
}
export default function Startseite() {
const notizen = alleNotizen();
return (
<main className="mx-auto max-w-xl p-8">
<h1 className="mb-4 text-2xl font-bold">Notizen</h1>
{notizen.length === 0 ? (
<p>Noch keine Notizen.</p>
) : (
<ul className="mb-4 list-disc pl-6">
{notizen.map((n) => (
<li key={n.id}>
{n.id}: {n.titel}
</li>
))}
</ul>
)}
<form action={notizAnlegen} className="flex gap-2">
<input name="titel" placeholder="Neue Notiz" className="flex-1 border px-2 py-1" />
<button type="submit" className="border px-3 py-1">
Anlegen
</button>
</form>
</main>
);
}
- Server Component – die Funktion
Startseiteläuft auf dem Server. Sie liest die Notizen direkt auslib/notizen.ts, ohne Umweg über die Schnittstelle. Der Browser bekommt fertiges HTML. dynamic = "force-dynamic"– ohne diese Zeile würde Next.js die Seite beim Bauen einmal erzeugen und danach immer dieselbe, leere Liste zeigen.- Server Action –
"use server"machtnotizAnlegenzu einer Funktion, die der Browser beim Abschicken des Formulars auf dem Server aufruft.formDataenthält die Felder des Formulars.revalidatePath("/")sorgt dafür, dass die Seite danach mit der neuen Notiz neu erzeugt wird. className– Klassen von Tailwind CSS, z. B.p-8für Innenabstand undborderfür einen Rahmen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Starten und testen
15. Entwicklungsserver starten
Startet Next.js im Entwicklungsmodus mit dem Bundler Turbopack. Seiten und Routen werden erst übersetzt, wenn sie zum ersten Mal aufgerufen werden. Das Terminal bleibt belegt, hier erscheint zu jeder Anfrage eine Zeile mit Methode, Adresse, Status und Dauer.
npm run dev
Prüfen: Die Ausgabe enthält Next.js 16.3.6 (Turbopack), Local: http://127.0.0.1:8000 und Ready in ….
16. Notiz über die Schnittstelle anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht location: /api/notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Im ersten Terminal erscheint POST /api/notizen 201 in ….
17. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/api/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/api/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/api/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/api/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:8000/api/gibtsnicht | HTML-Seite „This page could not be found.“ (Status 404) |
Für unbekannte Adressen liefert Next.js eine eigene Fehlerseite. Eine Datei app/not-found.tsx ersetzt sie durch eine selbst gestaltete Seite.
18. Seite im Browser ansehen
Öffne http://localhost:8000 im Browser.
Prüfen: Die Seite zeigt die Überschrift „Notizen“ und darunter 1: Erste Notiz aus Schritt 16. Seite und Schnittstelle greifen auf dieselbe Liste zu.
19. Notiz über das Formular anlegen
Gib im Feld „Neue Notiz“ einen Titel ein, z. B. Aus dem Formular, und klicke auf Anlegen.
Prüfen: Die Liste zeigt sofort 2: Aus dem Formular, ohne dass die Seite sichtbar neu lädt. curl http://localhost:8000/api/notizen liefert jetzt beide Notizen.
20. Änderung ohne Neustart ausprobieren
Ändere in app/api/hallo/route.ts das Wort Hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:8000/api/hallo liefert sofort {"gruss":"Servus Welt!"}. Die Notizen bleiben dabei erhalten, weil Next.js nur den geänderten Code austauscht und der Server-Prozess weiterläuft. Änderungen an page.tsx zeigt ein geöffneter Browser sogar ohne Neuladen an.
21. Entwicklungsserver beenden
Wechsle in das erste Terminal und drücke Strg+C.
22. Für den Betrieb bauen
Übersetzt und optimiert das ganze Projekt in den Ordner .next und prüft dabei auch die TypeScript-Typen.
npm run build
Prüfen: Die Ausgabe enthält ✓ Compiled successfully und endet mit einer Liste der Routen. Vor /, /api/hallo, /api/notizen und /api/notizen/[id] steht ƒ, das heißt: Sie werden bei jeder Anfrage auf dem Server erzeugt. Nur /_not-found ist mit ○ als feste Seite vorab erzeugt.
23. Gebaute Anwendung starten
Startet die gebaute Fassung aus .next. So läuft die Anwendung später auf einem Server.
npm start
Prüfen: Die Ausgabe enthält Local: http://127.0.0.1:8000 und Ready in …. http://localhost:8000 zeigt „Noch keine Notizen.“, weil der Arbeitsspeicher leer ist. Beende den Server mit Strg+C.
Wie geht es weiter?
- Weitere Seiten: Ein Ordner
app/infomit einer Dateipage.tsxergibt die Seite/info. Verlinkt wird mit<Link href="/info">ausnext/link, dann wechselt der Browser die Seite ohne komplettes Neuladen. - Interaktive Teile: Komponenten mit
"use client"in der ersten Zeile laufen im Browser und könnenuseStateoder Klick-Ereignisse verwenden. - Datenbank: Statt der Liste im Arbeitsspeicher liest man in Server Components und Server Actions direkt aus einer Datenbank, z. B. PostgreSQL mit einer Bibliothek wie
pgoder Prisma. - Code prüfen:
npm run lintprüft den Code mit ESLint. - Dokumentation im Projekt: Next.js legt seine Dokumentation passend zur installierten Version in
node_modules/next/dist/docsab. - Betrieb: Auf einem Server startet man
npm startüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt.
Deinstallieren
1. Server beenden
Läuft npm run dev oder npm start noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt node_modules und .next.
rm -rf ~/meinnext
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinnext
3. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf, auch create-next-app aus Schritt 4. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
4. Node.js und npm entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. Express, NestJS oder Docusaurus.
sudo apt purge nodejs npm
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://nextjs.org/docs
- Lizenz: Next.js steht unter der MIT.
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.
Laravel
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Laravel ist das meistgenutzte Web-Framework für PHP. Es bringt fast alles mit, was eine Webanwendung braucht: Routen, Datenbankzugriff über Objekte (Eloquent), Migrationen für Tabellen, Vorlagen (Blade), Anmeldung, Warteschlangen und das Befehlszeilenwerkzeug artisan, das Code-Gerüste erzeugt und Aufgaben erledigt.
Vorbemerkungen
- Installation pro Projekt: Laravel wird mit Composer in jedes Projekt einzeln installiert. Aus den Ubuntu-Paketquellen kommen nur PHP, seine Erweiterungen und Composer.
- Datenbank: Neue Projekte verwenden SQLite. Die Datenbank ist eine Datei im Projektordner, ein Datenbankserver ist nicht nötig. Anders als bei Express bleiben die Notizen deshalb auch nach einem Neustart erhalten.
- Kein Webserver nötig: Zum Entwickeln startet
php artisan serveeinen eingebauten Server auf http://127.0.0.1:8000, nur vom eigenen Rechner aus erreichbar. Port 8000 darf nicht von einem anderen Programm belegt sein. - Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, ASP.NET Core und Axum und Actix-web. Bei Laravel liegen alle Adressen der Schnittstelle unter
/api. - Version: Getestet mit Laravel 13.33 (Projektvorlage 13.10), PHP 8.5 und Composer 2.9 unter Ubuntu 26.04. Laravel 13 braucht PHP 8.3 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und Composer installieren
php-cliführt PHP im Terminal aus, auch den Entwicklungsserver.php-sqlite3verbindet PHP mit SQLite.xml,mbstring,curl,intlundzipbraucht Laravel für XML, Umlaute, Anfragen an andere Server, Sprachen und das Entpacken von Paketen.unzipundcomposerladen und entpacken Laravel und alle Bibliotheken.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install php-cli php-sqlite3 php-xml php-mbstring php-curl php-intl php-zip unzip composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
Lädt die Projektvorlage laravel/laravel samt aller Bibliotheken in den Ordner meinlaravel. Danach erzeugt Laravel selbst einen geheimen Schlüssel in der Datei .env, legt die SQLite-Datei database/database.sqlite an und erstellt darin die Grundtabellen für Benutzer, Zwischenspeicher und Warteschlangen.
composer create-project laravel/laravel meinlaravel
Prüfen: Die Ausgabe enthält Application key set successfully. und endet mit drei Zeilen … DONE, z. B. 0001_01_01_000000_create_users_table … DONE.
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinlaravel
Prüfen: Die Ausgabe lautet Laravel Framework 13.33.0 oder nennt eine neuere Version.
php artisan --version
6. Unterstützung für Schnittstellen einrichten
Neue Projekte sind für Webseiten eingerichtet. Dieser Befehl legt zusätzlich die Datei routes/api.php an. Alle Routen darin sind unter /api erreichbar und brauchen keinen Schutz gegen gefälschte Formulare (CSRF-Token), den Laravel sonst für jede POST-Anfrage verlangt. Außerdem installiert er das Paket Sanctum für die Anmeldung per Token. --without-migration-prompt verhindert eine Rückfrage, die Tabellen legt Schritt 12 an.
php artisan install:api --without-migration-prompt
Prüfen: Die Ausgabe endet mit API scaffolding installed. Den Hinweis auf HasApiTokens brauchst du erst, wenn sich Benutzer per Token anmelden sollen.
7. Migration für die Notizen anlegen
Eine Migration beschreibt in PHP, wie eine Tabelle aussieht. Laravel erkennt am Namen create_notizen_table, dass eine Tabelle notizen entstehen soll, und legt eine passende Vorlage im Ordner database/migrations an. Der Dateiname beginnt mit Datum und Uhrzeit, damit Migrationen in der richtigen Reihenfolge laufen.
php artisan make:migration create_notizen_table
Prüfen: Die Ausgabe lautet Migration [database/migrations/…_create_notizen_table.php] created successfully.
8. Spalte für den Titel ergänzen
Die Vorlage enthält nur eine laufende Nummer (id) und die Zeitstempel created_at und updated_at. Das Sternchen * im Befehl steht für Datum und Uhrzeit im Dateinamen, so musst du sie nicht abtippen.
nano database/migrations/*_create_notizen_table.php
Drücke Strg+W, gib $table->id(); ein und drücke Enter. Drücke Ende und dann Enter für eine neue Zeile und füge ein:
$table->string('titel');
Der Block sieht danach so aus:
Schema::create('notizen', function (Blueprint $table) {
$table->id();
$table->string('titel');
$table->timestamps();
});
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Model anlegen
Ein Model steht in Laravel für eine Tabelle. Über die Klasse Notiz liest und schreibt man später Notizen, ohne SQL zu schreiben.
php artisan make:model Notiz
Prüfen: Die Ausgabe lautet Model [app/Models/Notiz.php] created successfully.
10. Model ausfüllen
nano app/Models/Notiz.php
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Notiz extends Model
{
// Tabellenname festlegen, sonst sucht Laravel nach "notizs"
protected $table = 'notizen';
// Nur dieses Feld darf per Notiz::create() gefüllt werden
protected $fillable = ['titel'];
// Diese Felder erscheinen im JSON
protected $visible = ['id', 'titel'];
}
$table– Laravel bildet den Tabellennamen sonst nach englischen Regeln aus dem Klassennamen und käme aufnotizs.$fillable– schützt davor, dass jemand über die Schnittstelle andere Spalten wieidmitschickt und überschreibt.$visible– ohne diese Zeile stünden auchcreated_atundupdated_atim JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Routen schreiben
In routes/api.php legt man fest, welche Funktion welche Adresse und Methode beantwortet.
nano routes/api.php
Ersetze den ganzen Inhalt wie in Schritt 10 und füge ein:
<?php
use App\Models\Notiz;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
// GET /api/hallo?name=... liefert eine Begrüßung als JSON
Route::get('/hallo', function (Request $request) {
return ['gruss' => 'Hallo ' . $request->query('name', 'Welt') . '!'];
});
// GET /api/notizen liefert alle Notizen aus der Datenbank
Route::get('/notizen', function () {
return Notiz::orderBy('id')->get();
});
// POST /api/notizen legt eine Notiz an; der Inhalt kommt als JSON
Route::post('/notizen', function (Request $request) {
if (! $request->filled('titel')) {
return response()->json(['fehler' => 'Feld "titel" fehlt'], 400);
}
$notiz = Notiz::create(['titel' => $request->input('titel')]);
return response()->json($notiz, 201)->header('Location', '/api/notizen/' . $notiz->id);
});
// Alle anderen Adressen unter /api: 404 als JSON
Route::fallback(function () {
return response()->json(['fehler' => 'Nicht gefunden'], 404);
});
Route::getundRoute::post– verbinden Adresse und Methode mit einer Funktion.$requestenthält die Anfrage:query()liest Werte aus der Adresse,input()undfilled()lesen den mitgeschickten JSON-Inhalt.- Gibt eine Funktion ein Array oder Model zurück, wandelt Laravel es selbst in JSON um. Mit
response()->json(…, 201)setzt man zusätzlich den HTTP-Status. Notiz::orderBy('id')->get()liest alle Notizen,Notiz::create()speichert eine neue.Route::fallback– beantwortet alle übrigen Adressen unter/apimit404als JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Tabellen anlegen
Führt alle Migrationen aus, die noch nicht gelaufen sind: die Tabelle notizen und die Tabelle von Sanctum aus Schritt 6.
php artisan migrate
Prüfen: Die Ausgabe enthält …_create_notizen_table … DONE und …_create_personal_access_tokens_table … DONE.
13. Routen anzeigen
Listet alle Routen unter /api auf. So siehst du, ob Laravel die Datei aus Schritt 11 fehlerfrei gelesen hat.
php artisan route:list --path=api
Prüfen: Die Liste enthält GET|HEAD api/hallo, GET|HEAD api/notizen, POST api/notizen und GET|HEAD api/{fallbackPlaceholder} und endet mit Showing [4] routes.
Starten und testen
14. Entwicklungsserver starten
Das Terminal bleibt belegt, solange der Server läuft. Hier erscheint zu jeder Anfrage eine Zeile mit Uhrzeit, Adresse und Dauer.
php artisan serve
Prüfen: Die Ausgabe lautet Server running on [http://127.0.0.1:8000]. Unter http://127.0.0.1:8000 zeigt der Browser die Willkommensseite von Laravel.
Ist Port 8000 schon belegt, etwa von einem zweiten php artisan serve in einem anderen Terminal, weicht Laravel ohne Rückfrage auf 8001 aus. Achte deshalb auf die Portnummer in der Ausgabe.
15. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /api/notizen/1, die letzte Zeile ist {"titel":"Erste Notiz","id":1}.
16. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/api/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl "http://localhost:8000/api/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:8000/api/gibtsnicht | {"fehler":"Nicht gefunden"} (Status 404) |
17. Änderung ohne Neustart ausprobieren
PHP liest den Code bei jeder Anfrage neu. Ein Neustart des Servers ist deshalb nicht nötig. Ändere in routes/api.php das Wort Hallo in der Route /hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:8000/api/hallo liefert sofort {"gruss":"Servus Welt!"}.
Nur Änderungen an der Datei .env erfordern einen Neustart. php artisan serve erkennt sie selbst und startet neu.
18. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Prüfen: Startest du den Server mit php artisan serve erneut, liefert curl http://localhost:8000/api/notizen weiterhin die Notiz aus Schritt 15. Sie liegt in database/database.sqlite.
Wie geht es weiter?
- Validierung: Statt
filled()prüft$request->validate(['titel' => 'required|max:200'])Eingaben mit Regeln. Schickt der AufrufAccept: application/jsonmit, antwortet Laravel bei Fehlern mit Status 422 und einer Liste der Fehler. - Controller: Bei mehr als ein paar Routen gehört der Code in Controller-Klassen.
php artisan make:controller NotizController --api --model=Notizerzeugt eine Klasse mit allen Methoden zum Lesen, Anlegen, Ändern und Löschen. - Webseiten: Routen in
routes/web.phpliefern HTML aus Blade-Vorlagen im Ordnerresources/views. - Andere Datenbank: Mit dem Paket
php-pgsqlund den EinträgenDB_CONNECTION=pgsql,DB_HOST,DB_DATABASE,DB_USERNAMEundDB_PASSWORDin.envverwendet Laravel PostgreSQL. - Betrieb: Auf einem Server liefert nginx mit PHP-FPM den Ordner
publicaus, wie in den Anleitungen zu Bolt CMS oder Contao. Setze dort in.envdie WerteAPP_ENV=productionundAPP_DEBUG=false, sonst zeigt Laravel Besuchern bei Fehlern Code und Einstellungen. - Aktualisieren:
composer updateim Projektordner holt neue Versionen innerhalb von Laravel 13. Danachphp artisan migrate, falls neue Migrationen dazugekommen sind.
Deinstallieren
1. Server beenden
Läuft php artisan serve noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt Bibliotheken und SQLite-Datenbank.
rm -rf ~/meinlaravel
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinlaravel
3. Composer-Zwischenspeicher leeren (optional)
Composer bewahrt heruntergeladene Pakete in ~/.cache/composer auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle PHP-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
composer clear-cache
4. PHP-Pakete entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. die CMS-Anleitungen mit PHP.
sudo apt purge php-sqlite3 composer
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://laravel.com/docs
- Lizenz: Laravel steht unter der MIT.
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.
Phoenix
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Phoenix ist das bekannteste Webframework für die Programmiersprache Elixir. Elixir läuft auf der virtuellen Maschine von Erlang (BEAM), die für Telefonanlagen entwickelt wurde und sehr viele gleichzeitige Verbindungen mit leichtgewichtigen Prozessen bewältigt. Phoenix nutzt das für Schnittstellen, Webseiten und mit LiveView für Oberflächen, die sich ohne eigenes JavaScript live aktualisieren.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Elixir 1.18 und Erlang/OTP 27. Phoenix selbst kommt über Hex, den Paketmanager von Elixir, in jedes Projekt einzeln. Hex und der Projektgenerator landen in
~/.mix, heruntergeladene Pakete in~/.hex. - Nur eine Schnittstelle: Phoenix kann Datenbank (Ecto), HTML-Seiten, LiveView, E-Mail-Versand und Übersetzungen gleich mit einrichten. Dieses Beispiel schaltet all das ab und baut nur eine JSON-Schnittstelle. Dafür braucht es weder Datenbank noch Node.js.
- Port 4000: Der Entwicklungsserver lauscht auf http://127.0.0.1:4000, nur vom eigenen Rechner aus erreichbar. Port 4000 darf nicht von einem anderen Programm belegt sein.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, Gin, Ktor und FastAPI. Wie bei Laravel liegen alle Adressen unter
/api. Die Notizen liegen nur im Arbeitsspeicher, verwaltet von einem eigenen Elixir-Prozess. - Version: Getestet mit Phoenix 1.8.15, Elixir 1.18.3, Erlang/OTP 27 und Hex 2.5.1 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Elixir und Erlang-Entwicklungsdateien installieren
elixir zieht die nötigen Teile von Erlang mit und bringt die Befehle elixir, iex (interaktive Konsole) und mix (Build-Werkzeug) mit. erlang-dev enthält Header-Dateien von Erlang, die Phoenix beim Übersetzen einliest. Ohne das Paket bricht das Übersetzen mit error parsing file /usr/lib/erlang/lib/public_key-…/include/OTP-PUB-KEY.hrl ab.
sudo apt install elixir erlang-dev
Prüfen: Die letzte Zeile lautet Elixir 1.18.3 (compiled with Erlang/OTP 27).
elixir --version
3. Hex installieren
Installiert den Paketmanager Hex für den eigenen Benutzer. --force beantwortet die Rückfrage, ob Hex wirklich installiert werden soll, mit Ja.
mix local.hex --force
Prüfen: Die Ausgabe lautet * creating /home/…/.mix/archives/hex-2.5.1 oder nennt eine neuere Version.
4. Projektgenerator von Phoenix installieren
Lädt den Generator phx_new von Hex und installiert ihn als Erweiterung von mix. Er stellt den Befehl mix phx.new bereit. Auch hier beantwortet --force die Rückfrage.
mix archive.install hex phx_new --force
Prüfen: Die Ausgabe endet mit * creating /home/…/.mix/archives/phx_new-1.8.15 oder nennt eine neuere Version.
Erstes Projekt
5. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
6. Projekt anlegen
Legt den Ordner meinphoenix mit einem fertigen Projekt samt Git-Repository an. Die Schalter lassen alles weg, was eine reine Schnittstelle nicht braucht:
--no-ecto– keine Datenbank--no-htmlund--no-assets– keine HTML-Seiten, kein CSS und JavaScript--no-dashboard– keine Übersichtsseite zu Laufzeitdaten--no-mailerund--no-gettext– kein E-Mail-Versand, keine Übersetzungen
--install lädt die Abhängigkeiten gleich herunter und übersetzt sie, ohne vorher zu fragen.
mix phx.new meinphoenix --no-ecto --no-html --no-assets --no-dashboard --no-mailer --no-gettext --install
Prüfen: Die Ausgabe listet viele Zeilen * creating meinphoenix/…, dann * running mix deps.get und * running mix deps.compile und endet mit dem Hinweis Start your Phoenix app with: $ mix phx.server. Die Hinweise von Git zu init.defaultBranch kannst du übergehen.
7. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinphoenix
Der Code liegt in lib. lib/meinphoenix ist für die eigentliche Arbeit gedacht, lib/meinphoenix_web für alles rund um HTTP wie Router und Controller. Die Datei AGENTS.md enthält Hinweise für KI-Assistenten und ist für diese Anleitung nicht wichtig.
8. Notizen-Speicher schreiben
In Elixir gibt es keine veränderlichen Variablen, auf die mehrere Anfragen gleichzeitig zugreifen. Einen Zustand wie die Liste der Notizen hält man stattdessen in einem eigenen Prozess. Ein Agent ist die einfachste Form dafür: Er bewahrt einen Wert auf, andere Prozesse lesen oder ändern ihn über Funktionsaufrufe, immer schön nacheinander. Die Datei ist neu, nano startet mit einer leeren Seite.
nano lib/meinphoenix/notizen.ex
Füge diesen Inhalt ein (Strg+Umschalt+V):
defmodule Meinphoenix.Notizen do
# Ein Agent ist ein eigener kleiner Prozess, der einen Wert verwaltet.
# Hier: die Liste der Notizen, nur im Arbeitsspeicher.
use Agent
def start_link(_) do
Agent.start_link(fn -> [] end, name: __MODULE__)
end
def alle do
Agent.get(__MODULE__, &Enum.reverse/1)
end
def finde(id) do
Agent.get(__MODULE__, fn notizen -> Enum.find(notizen, &(&1.id == id)) end)
end
def lege_an(titel) do
Agent.get_and_update(__MODULE__, fn notizen ->
notiz = %{id: length(notizen) + 1, titel: titel}
{notiz, [notiz | notizen]}
end)
end
end
name: __MODULE__– der Agent ist unter dem Namen des Moduls erreichbar, man braucht sich keine Prozessnummer zu merken.Agent.getliest den Wert,Agent.get_and_updateliefert ein Ergebnis und ändert den Wert in einem Schritt.- Neue Notizen kommen vorne an die Liste (
[notiz | notizen]), das ist in Elixir am schnellsten.alledreht die Liste deshalb für die Ausgabe um.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Speicher beim Start mitstarten
application.ex legt fest, welche Prozesse beim Start der Anwendung laufen. Ein Supervisor überwacht sie und startet einen abgestürzten Prozess neu.
nano lib/meinphoenix/application.ex
Suche die Zeile {Phoenix.PubSub, name: Meinphoenix.PubSub}, und füge darunter zwei Zeilen ein:
# Die Liste der Notizen
Meinphoenix.Notizen,
Die Liste children sieht danach so aus:
children = [
MeinphoenixWeb.Telemetry,
{DNSCluster, query: Application.get_env(:meinphoenix, :dns_cluster_query) || :ignore},
{Phoenix.PubSub, name: Meinphoenix.PubSub},
# Die Liste der Notizen
Meinphoenix.Notizen,
# Start a worker by calling: Meinphoenix.Worker.start_link(arg)
# {Meinphoenix.Worker, arg},
# Start to serve requests, typically the last entry
MeinphoenixWeb.Endpoint
]
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Routen eintragen
Der Router enthält schon den Bereich scope "/api". Die pipeline :api davor sorgt dafür, dass dort nur JSON angenommen wird.
nano lib/meinphoenix_web/router.ex
Ergänze unter pipe_through :api eine Leerzeile und die vier Routen, sodass der Bereich so aussieht:
scope "/api", MeinphoenixWeb do
pipe_through :api
get "/hallo", NotizController, :hallo
get "/notizen", NotizController, :index
get "/notizen/:id", NotizController, :show
post "/notizen", NotizController, :create
end
Jede Zeile verbindet Methode und Adresse mit einer Funktion im Controller. :id ist ein Platzhalter.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Controller schreiben
Die Datei ist neu, nano startet mit einer leeren Seite.
nano lib/meinphoenix_web/controllers/notiz_controller.ex
Füge diesen Inhalt ein:
defmodule MeinphoenixWeb.NotizController do
use MeinphoenixWeb, :controller
alias Meinphoenix.Notizen
# GET /api/hallo?name=... liefert eine Begrüßung als JSON
def hallo(conn, params) do
name = Map.get(params, "name", "Welt")
json(conn, %{gruss: "Hallo #{name}!"})
end
# GET /api/notizen liefert alle Notizen
def index(conn, _params) do
json(conn, Notizen.alle())
end
# GET /api/notizen/1 liefert eine Notiz oder 404
def show(conn, %{"id" => id}) do
with {nummer, ""} <- Integer.parse(id),
%{} = notiz <- Notizen.finde(nummer) do
json(conn, notiz)
else
_ -> conn |> put_status(404) |> json(%{fehler: "Notiz nicht gefunden"})
end
end
# POST /api/notizen legt eine Notiz an; der Inhalt kommt als JSON
def create(conn, %{"titel" => titel}) when is_binary(titel) and titel != "" do
notiz = Notizen.lege_an(titel)
conn
|> put_status(201)
|> put_resp_header("location", "/api/notizen/#{notiz.id}")
|> json(notiz)
end
def create(conn, _params) do
conn |> put_status(400) |> json(%{fehler: ~s(Feld "titel" fehlt)})
end
end
conn– die Verbindung. Sie enthält die Anfrage und sammelt alles für die Antwort.json(conn, …)sendet eine Map oder Liste als JSON.params– alle Werte der Anfrage in einer Map: aus der Adresse (name,id) und aus dem mitgeschickten JSON (titel).- Mustervergleich –
creategibt es zweimal. Elixir nimmt die erste Fassung, deren Muster passt: Enthältparamseinen nicht leeren Texttitel, wird angelegt, sonst greift die zweite Fassung mit400. with– führt Schritte nacheinander aus, solange jeder passt. Istidkeine Zahl oder die Notiz nicht vorhanden, springt es zuelse.|>– der Pipe-Operator gibt das Ergebnis links als ersten Wert an die Funktion rechts weiter. So liest sichput_status,put_resp_headerundjsonvon oben nach unten.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Routen anzeigen
Übersetzt das Projekt und listet alle Routen. So siehst du, ob Router und Controller fehlerfrei sind.
mix phx.routes
Prüfen: Vor der Liste steht Generated meinphoenix app. Die Liste enthält GET /api/hallo, GET /api/notizen, GET /api/notizen/:id und POST /api/notizen, jeweils mit MeinphoenixWeb.NotizController.
Starten und testen
13. Server starten
iex -S mix phx.server startet den Server und öffnet zugleich die interaktive Elixir-Konsole IEx. Nur mix phx.server würde den Server ohne Konsole starten. Das Terminal zeigt zu jeder Anfrage einige Zeilen mit Adresse, Controller, Parametern und Dauer.
iex -S mix phx.server
Prüfen: Die Ausgabe enthält Running MeinphoenixWeb.Endpoint with Bandit … at 127.0.0.1:4000 (http) und endet mit der Eingabeaufforderung iex(1)>.
14. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:4000/api/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht location: /api/notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Im ersten Terminal erscheinen POST /api/notizen, Processing with MeinphoenixWeb.NotizController.create/2 und Sent 201 in ….
15. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:4000/api/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:4000/api/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:4000/api/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:4000/api/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl http://localhost:4000/api/notizen/abc | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:4000/api/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:4000/api/gibtsnicht | HTML-Seite mit dem Titel Phoenix.Router.NoRouteError at GET /api/gibtsnicht (Status 404) |
Für Adressen ohne Route zeigt Phoenix im Entwicklungsmodus eine ausführliche Fehlerseite. Öffne http://localhost:4000/api/gibtsnicht im Browser: Sie listet alle vorhandenen Routen. Im Betrieb antwortet Phoenix stattdessen mit JSON aus lib/meinphoenix_web/controllers/error_json.ex.
16. In der Konsole nachsehen
Die Konsole im ersten Terminal läuft im selben Programm wie der Server. Gib dort ein und drücke Enter:
Meinphoenix.Notizen.alle()
Prüfen: Die Ausgabe lautet [%{id: 1, titel: "Erste Notiz"}]. Das ist dieselbe Liste, die auch curl sieht. Mit Meinphoenix.Notizen.lege_an("Aus IEx") legst du eine Notiz direkt an, curl http://localhost:4000/api/notizen zeigt sie danach ebenfalls.
17. Änderung ohne Neustart ausprobieren
Phoenix übersetzt geänderten Code im Entwicklungsmodus bei der nächsten Anfrage neu. Ändere in notiz_controller.ex das Wort Hallo in der Funktion hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:4000/api/hallo liefert {"gruss":"Servus Welt!"}, im ersten Terminal erscheint Compiling 1 file (.ex). Die Notizen bleiben erhalten. Nur der Code des Controllers wird ausgetauscht, der Agent mit der Liste läuft weiter.
18. Server beenden
Drücke im ersten Terminal zweimal Strg+C. Nach dem ersten Mal zeigt Erlang ein Menü (BREAK: (a)bort …), das zweite Mal beendet das Programm.
19. Tests ausführen
Das Projekt bringt Tests für die Fehlerantworten mit. mix test übersetzt das Projekt in der Testumgebung und führt alle Tests aus.
mix test
Prüfen: Die Ausgabe endet mit 2 tests, 0 failures.
Wie geht es weiter?
- Datenbank: Ohne
--no-ectorichtetmix phx.newdie Datenbankschicht Ecto mit PostgreSQL ein.mix phx.gen.jsonerzeugt dann Schema, Migration, Controller und Tests für eine ganze Ressource. - Webseiten und LiveView: Ohne
--no-htmlund--no-assetsbekommt das Projekt HTML-Vorlagen, Tailwind CSS und LiveView. Dafür lädt Phoenix beim ersten Start die Werkzeuge esbuild und Tailwind herunter. - Formatieren:
mix formatbringt alle Dateien in die übliche Schreibweise von Elixir. - Betrieb:
MIX_ENV=prod mix releasebaut ein eigenständiges Paket samt Erlang-Laufzeit im Ordner_build/prod/rel. Auf dem Server braucht es die UmgebungsvariablenSECRET_KEY_BASE(erzeugt mitmix phx.gen.secret) undPHX_HOST. Gestartet wird über einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage), davor sitzt nginx, der auch HTTPS übernimmt.
Deinstallieren
1. Server beenden
Läuft iex -S mix phx.server noch in einem Terminal, beende es dort mit zweimal Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt übersetzter Abhängigkeiten.
rm -rf ~/meinphoenix
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinphoenix
3. Hex und Projektgenerator entfernen (optional)
Hex und phx_new liegen in ~/.mix, heruntergeladene Pakete in ~/.hex. Die Befehle löschen beide Ordner. Das betrifft alle Elixir-Projekte.
rm -rf ~/.mix
rm -rf ~/.hex
4. Elixir und Erlang entfernen
Nur ausführen, wenn kein anderes Programm sie braucht.
sudo apt purge elixir erlang-dev
Der nächste Befehl entfernt die Erlang-Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Shell meldet, dass der Befehl elixir nicht gefunden wurde.
elixir --version
Quellen und Lizenz
- Offizielle Dokumentation: https://hexdocs.pm/phoenix/overview.html
- Lizenz: Phoenix steht unter der MIT.
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.
Symfony
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Symfony ist ein PHP-Framework aus vielen einzelnen Bausteinen (Komponenten), die auch andere Projekte wie Laravel, Drupal oder Composer verwenden. Ein neues Projekt startet sehr klein. Weitere Fähigkeiten wie Datenbankzugriff, Vorlagen oder Anmeldung holt man mit Composer dazu, und das Werkzeug Symfony Flex richtet sie dabei gleich passend ein.
Vorbemerkungen
- Installation pro Projekt: Symfony wird mit Composer in jedes Projekt einzeln installiert. Aus den Ubuntu-Paketquellen kommen nur PHP, seine Erweiterungen und Composer.
- Datenbank: Das Projekt verwendet SQLite über Doctrine, die übliche Datenbankschicht von Symfony. Die Datenbank ist eine Datei im Projektordner, ein Datenbankserver ist nicht nötig.
- Kein Webserver nötig: Zum Entwickeln reicht der Server, der in PHP eingebaut ist. Er läuft auf http://127.0.0.1:8000, nur vom eigenen Rechner aus erreichbar. Port 8000 darf nicht von einem anderen Programm belegt sein. Das Symfony-Befehlszeilenwerkzeug (Symfony CLI), das Symfony nach dem Anlegen empfiehlt, braucht man dafür nicht.
- Ohne Docker: Einige Vorlagen von Symfony Flex legen Docker-Dateien für die Datenbank an. Schritt 6 schaltet das ab.
- Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Laravel, Ruby on Rails, Flask und Express.
- Version: Getestet mit Symfony 8.1.7, Doctrine ORM 3, PHP 8.5 und Composer 2.9 unter Ubuntu 26.04. Symfony 8 braucht PHP 8.4 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und Composer installieren
php-cliführt PHP im Terminal aus, auch den Entwicklungsserver.php-sqlite3verbindet PHP mit SQLite.xml,mbstring,intl,curlundzipbraucht Symfony für Konfiguration, Umlaute, Sprachen, Downloads und das Entpacken von Paketen.unzipundcomposerladen und entpacken Symfony und alle Bibliotheken.
Sind Pakete schon vorhanden, etwa aus der Laravel-Anleitung, meldet apt das nur.
sudo apt install php-cli php-sqlite3 php-xml php-mbstring php-intl php-curl php-zip unzip composer
Prüfen: Die erste Zeile beginnt mit Composer version 2, die zweite nennt PHP version 8.5.
composer --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
Lädt die kleinste Projektvorlage symfony/skeleton in den Ordner meinsymfony. Sie enthält nur den Kern: Routen, Controller, Konfiguration und die Konsole bin/console.
composer create-project symfony/skeleton meinsymfony
Prüfen: Die Ausgabe beginnt mit Creating a "symfony/skeleton" project at "./meinsymfony", weiter unten stehen Executing script cache:clear [OK] und Executing script assets:install public [OK].
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinsymfony
Prüfen: Die Ausgabe lautet Symfony v8.1.7 (env: dev, debug: true) oder nennt eine neuere Version. env: dev heißt: Das Projekt läuft im Entwicklungsmodus mit ausführlichen Fehlermeldungen.
php bin/console --version
Im Projektordner liegen auch die Dateien AGENTS.md und CLAUDE.md. Sie enthalten Hinweise für KI-Assistenten und sind für diese Anleitung nicht wichtig.
6. Docker-Vorlagen abschalten
Trägt in composer.json ein, dass Symfony Flex beim Installieren weiterer Pakete keine Docker-Dateien anlegen soll. Ohne diese Einstellung fragt Composer in Schritt 7 danach oder legt compose.yaml mit einem PostgreSQL-Container an. --json sorgt dafür, dass false als Wahrheitswert und nicht als Text eingetragen wird.
composer config --json extra.symfony.docker false
Prüfen: Die Ausgabe enthält "docker": false.
grep docker composer.json
7. Doctrine installieren
symfony/orm-pack ist ein Sammelpaket: Doctrine ORM für den Zugriff auf die Datenbank über PHP-Objekte und Doctrine Migrations für die Tabellen. Flex legt dabei die Konfiguration config/packages/doctrine.yaml und den Ordner migrations an.
composer require symfony/orm-pack
Prüfen: Die Ausgabe enthält Configuring doctrine/doctrine-bundle und Configuring doctrine/doctrine-migrations-bundle und endet mit dem Hinweis Modify your DATABASE_URL config in .env. Das erledigt der nächste Schritt.
8. SQLite als Datenbank einstellen
In der Datei .env hat Doctrine eine Verbindung zu PostgreSQL eingetragen. Statt .env zu ändern, legt man eigene Einstellungen in .env.local ab. Symfony liest sie zusätzlich und sie überschreiben gleichnamige Werte aus .env. Die Datei ist neu, nano startet mit einer leeren Seite.
nano .env.local
Füge diesen Inhalt ein:
# SQLite-Datei im Ordner var statt PostgreSQL
DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
%kernel.project_dir% ersetzt Symfony durch den Projektordner. Die Datenbank wird also ~/meinsymfony/var/data.db.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Entity schreiben
Eine Entity ist eine PHP-Klasse, deren Objekte Doctrine in einer Tabelle speichert. Die Attribute in #[…] beschreiben Tabelle und Spalten. Den Ordner src/Entity hat Flex in Schritt 7 schon angelegt, src/Controller gibt es seit Schritt 4.
nano src/Entity/Notiz.php
Füge diesen Inhalt ein:
<?php
namespace App\Entity;
use Doctrine\ORM\Mapping as ORM;
// Jede Notiz ist eine Zeile in der Tabelle "notizen"
#[ORM\Entity]
#[ORM\Table(name: 'notizen')]
class Notiz
{
// Laufende Nummer, vergibt die Datenbank
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column]
private ?int $id = null;
// Titel mit höchstens 255 Zeichen
#[ORM\Column(length: 255)]
private string $titel;
public function __construct(string $titel)
{
$this->titel = $titel;
}
public function getId(): ?int
{
return $this->id;
}
// Die Notiz als Array, daraus wird JSON
public function alsArray(): array
{
return ['id' => $this->id, 'titel' => $this->titel];
}
}
#[ORM\Table(name: 'notizen')]– ohne diese Zeile hieße die Tabelle wie die Klasse, alsonotiz.#[ORM\GeneratedValue]– die Nummer vergibt die Datenbank beim Speichern. Vorher ist$idnochnull.alsArray()– die Felder sindprivate. Die Methode gibt sie für die JSON-Antwort gezielt heraus.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Migration erzeugen
Doctrine vergleicht die Entities mit der (noch leeren) Datenbank und schreibt die nötigen SQL-Befehle in eine neue Datei im Ordner migrations.
php bin/console doctrine:migrations:diff
Prüfen: Die Ausgabe nennt die neue Datei migrations/Version….php. Darin steht der Befehl CREATE TABLE notizen (id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, titel VARCHAR(255) NOT NULL).
grep CREATE migrations/Version*.php
11. Tabelle anlegen
Führt alle Migrationen aus, die noch nicht gelaufen sind. Dabei entsteht die Datei var/data.db. -n beantwortet die Sicherheitsfrage, ob wirklich migriert werden soll, mit Ja.
php bin/console doctrine:migrations:migrate -n
Prüfen: Die Ausgabe endet mit [OK] Successfully migrated to version: DoctrineMigrations\Version….
12. Controller schreiben
Ein Controller beantwortet Anfragen. In Symfony steht die Adresse direkt als Attribut #[Route] über der Methode. Die Datei config/routes.yaml liest alle Controller im Ordner src/Controller selbst ein.
nano src/Controller/NotizController.php
Füge diesen Inhalt ein:
<?php
namespace App\Controller;
use App\Entity\Notiz;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Attribute\Route;
class NotizController extends AbstractController
{
// GET /hallo?name=... liefert eine Begrüßung als JSON
#[Route('/hallo', methods: ['GET'])]
public function hallo(Request $request): JsonResponse
{
$name = $request->query->get('name', 'Welt');
return $this->json(['gruss' => "Hallo $name!"]);
}
// GET /notizen liefert alle Notizen aus der Datenbank
#[Route('/notizen', methods: ['GET'])]
public function alle(EntityManagerInterface $em): JsonResponse
{
$notizen = $em->getRepository(Notiz::class)->findBy([], ['id' => 'ASC']);
return $this->json(array_map(fn (Notiz $n) => $n->alsArray(), $notizen));
}
// GET /notizen/1 liefert eine Notiz oder 404
#[Route('/notizen/{id}', methods: ['GET'], requirements: ['id' => '\d+'])]
public function eine(int $id, EntityManagerInterface $em): JsonResponse
{
$notiz = $em->find(Notiz::class, $id);
if ($notiz === null) {
return $this->json(['fehler' => 'Notiz nicht gefunden'], 404);
}
return $this->json($notiz->alsArray());
}
// POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
#[Route('/notizen', methods: ['POST'])]
public function anlegen(Request $request, EntityManagerInterface $em): JsonResponse
{
$daten = json_decode($request->getContent(), true);
$titel = $daten['titel'] ?? '';
if (!is_string($titel) || $titel === '') {
return $this->json(['fehler' => 'Feld titel fehlt'], 400);
}
$notiz = new Notiz($titel);
$em->persist($notiz);
$em->flush();
return $this->json($notiz->alsArray(), 201, ['Location' => '/notizen/'.$notiz->getId()]);
}
}
- Parameter der Methoden – Symfony füllt sie selbst:
Requestist die laufende Anfrage,EntityManagerInterfaceder Zugang zu Doctrine,int $idkommt aus dem Platzhalter{id}der Adresse. requirements: ['id' => '\d+']– die Route passt nur, wenn{id}aus Ziffern besteht.$request->query->get()liest Werte aus der Adresse,$request->getContent()den mitgeschickten JSON-Inhalt als Text, denjson_decodein ein Array verwandelt.$em->find()sucht eine Notiz nach Nummer,getRepository(…)->findBy()liest mehrere.persist()merkt eine neue Notiz zum Speichern vor,flush()schreibt alle vorgemerkten Änderungen in die Datenbank.$this->json()macht aus einem Array eine JSON-Antwort. Status und Kopfzeilen sind optional.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Routen anzeigen
Listet alle Routen. So siehst du, ob Symfony den Controller fehlerfrei gelesen hat.
php bin/console debug:router
Prüfen: Die Tabelle enthält app_notiz_hallo (GET /hallo), app_notiz_alle (GET /notizen), app_notiz_eine (GET /notizen/{id}) und app_notiz_anlegen (POST /notizen). Die Namen bildet Symfony aus Controller und Methode. Die Route _preview_error bringt Symfony selbst mit, um Fehlerseiten anzusehen.
Starten und testen
14. Entwicklungsserver starten
Startet den in PHP eingebauten Server. -t public macht den Ordner public zum Stammverzeichnis. Dort liegt index.php, über die alle Anfragen in Symfony landen. Das Terminal bleibt belegt, solange der Server läuft. Im Entwicklungsmodus schreibt Symfony zu jeder Anfrage viele Zeilen mit Details hinein.
php -S 127.0.0.1:8000 -t public
Prüfen: Die erste Zeile lautet PHP 8.5.4 Development Server (http://127.0.0.1:8000) started.
15. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}.
16. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:8000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:8000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:8000/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:8000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld titel fehlt"} (Status 400) |
curl http://localhost:8000/gibtsnicht | HTML-Fehlerseite, die erste Zeile beginnt mit <!-- No route found for (Status 404) |
Für Adressen ohne passende Route antwortet Symfony selbst. Im Entwicklungsmodus ist das eine ausführliche HTML-Fehlerseite. Öffne zum Vergleich http://localhost:8000/gibtsnicht im Browser. Die Seite zeigt den Fehler und den Weg der Anfrage durch den Code.
Die Meldung bei fehlendem Titel steht bewusst ohne Anführungszeichen: $this->json() würde " im Text als " ausgeben. Das ist gültiges JSON, aber schlecht lesbar.
17. Änderung ohne Neustart ausprobieren
PHP liest den Code bei jeder Anfrage neu, und im Entwicklungsmodus erneuert Symfony seinen Zwischenspeicher selbst. Ändere in src/Controller/NotizController.php das Wort Hallo in der Methode hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:8000/hallo liefert sofort {"gruss":"Servus Welt!"}.
18. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Prüfen: Startest du den Server wie in Schritt 14 erneut, liefert curl http://localhost:8000/notizen weiterhin die Notiz aus Schritt 15. Sie liegt in var/data.db.
Wie geht es weiter?
- Code erzeugen lassen:
composer require --dev symfony/maker-bundleinstalliert die Befehlemake:….php bin/console make:entityfragt Felder ab und schreibt die Entity samt Repository,make:controllerlegt einen Controller an. - Webseiten:
composer require twiginstalliert die Vorlagensprache Twig. Vorlagen liegen dann im Ordnertemplates, ein Controller gibt sie mit$this->render('….html.twig', […])aus. - Eingaben prüfen und JSON umwandeln: Mit
composer require serializer validatorwandelt Symfony JSON direkt in Objekte um und prüft sie mit Regeln wie#[Assert\NotBlank]. Für größere Schnittstellen gibt es API Platform. - Andere Datenbank: Mit dem Paket
php-pgsqlund einer passendenDATABASE_URLin.env.localverwendet Doctrine PostgreSQL. Die Vorlage dafür steht schon in.env. - Betrieb: Auf einem Server liefert nginx mit PHP-FPM den Ordner
publicaus, wie in den Anleitungen zu Bolt CMS oder Contao. Dort gehörtAPP_ENV=prodin.env.local, sonst zeigt Symfony Besuchern bei Fehlern Code und Einstellungen. - Aktualisieren:
composer updateim Projektordner holt neue Versionen innerhalb von Symfony 8.1. Danachphp bin/console doctrine:migrations:migrate, falls neue Migrationen dazugekommen sind.
Deinstallieren
1. Server beenden
Läuft php -S noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt Bibliotheken und SQLite-Datenbank.
rm -rf ~/meinsymfony
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinsymfony
3. Composer-Zwischenspeicher leeren (optional)
Composer bewahrt heruntergeladene Pakete in ~/.cache/composer auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle PHP-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
composer clear-cache
4. PHP-Pakete entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. Laravel oder die CMS-Anleitungen mit PHP.
sudo apt purge php-sqlite3 composer
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Shell meldet, dass der Befehl composer nicht gefunden wurde.
composer --version
Quellen und Lizenz
- Offizielle Dokumentation: https://symfony.com/doc/current/index.html
- Lizenz: Symfony steht unter der MIT.
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.
Ruby on Rails
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ruby on Rails (kurz Rails) ist das bekannteste Web-Framework für die Programmiersprache Ruby. Es folgt festen Namensregeln: Wer Klassen, Dateien und Tabellen so benennt, wie Rails es erwartet, muss kaum etwas einstellen. Generatoren erzeugen Models, Migrationen und Controller, Active Record liest und schreibt die Datenbank ohne SQL.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Rails 7.2 samt Ruby 3.3 und allen Bibliotheken (Gems) als Pakete. Neue Projekte verwenden nur diese lokal installierten Gems. Die neueste Version (Rails 8.1) gibt es über
gem, siehe Abschnitt „Alternative: neueste Version über gem“. - Ohne empfohlene Pakete: Das Paket
railsempfiehlt über Umwege Node.js-Pakete und den Browser Chromium (als Snap) für automatische Browsertests. Für eine Schnittstelle braucht man beides nicht. Mit--no-install-recommendskommen rund 90 statt über 200 Pakete auf den Rechner. - Datenbank: Neue Projekte verwenden SQLite. Die Datenbank ist eine Datei im Ordner
storage, ein Datenbankserver ist nicht nötig. Die Notizen bleiben deshalb auch nach einem Neustart erhalten. - Port 3000: Der Entwicklungsserver lauscht auf http://127.0.0.1:3000. Läuft dort schon ein anderes Programm, etwa Martin oder Express, bricht Rails mit
Address already in useab. Starte den Server dann mitbin/rails server -p 3001und schreibe in allen Adressen dieser Anleitung3001statt3000. - Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, Laravel, FastAPI, ASP.NET Core und Axum und Actix-web.
- Version: Getestet mit Rails 7.2.3, Ruby 3.3.8, Bundler 2.6 und dem Webserver Puma 6.6 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Rails installieren
rails zieht Ruby, Bundler, den Webserver Puma und die Anbindung an SQLite (ruby-sqlite3) mit. --no-install-recommends lässt Node.js und Chromium weg.
sudo apt install --no-install-recommends rails
Prüfen: Die Ausgabe lautet Rails 7.2.3.
rails --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
Legt den Ordner meinrails mit einem fertigen Projekt an. Die Schalter bedeuten:
--api– ein schlankes Projekt nur für Schnittstellen, ohne HTML-Vorlagen, Stylesheets und Browser-Sitzungen.--skip-brakemanund--skip-rubocop– lassen zwei Prüfwerkzeuge weg. Ubuntu hat sie nicht als Paket. Da Rails nur lokal installierte Gems verwendet, würde das Anlegen sonst mitCould not find gem 'brakeman' in locally installed gemsscheitern.--skip-ciund--skip-docker– lassen Dateien für GitHub Actions und Docker weg.
rails new meinrails --api --skip-brakeman --skip-rubocop --skip-ci --skip-docker
Prüfen: Die Ausgabe endet mit run bundle binstubs bundler. Weiter oben stehen run bundle install --local --quiet ohne Fehlermeldung darunter und Writing lockfile to /home/…/meinrails/Gemfile.lock. Für diesen Schritt fragt Bundler kurz bei rubygems.org nach (Fetching gem metadata), installiert aber nichts von dort.
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt. Rails hat hier auch schon ein Git-Repository angelegt.
cd ~/meinrails
Prüfen: Die Ausgabe lautet Rails 7.2.3. bin/rails ist das Werkzeug des Projekts für alle weiteren Aufgaben.
bin/rails --version
6. Mehrzahl von „Notiz“ festlegen
Rails bildet aus dem Namen eines Models die Namen von Tabelle, Controller und Adressen, und zwar nach englischen Regeln. Aus Notiz würde notizs. Eine eigene Regel in der Datei für Wortformen (Inflections) sagt Rails, dass die Mehrzahl notizen heißt. Die Regel muss vor Schritt 7 stehen, weil der Generator sie schon braucht.
nano config/initializers/inflections.rb
Die Datei enthält nur Kommentare. Drücke Alt+/ (ans Ende der Datei) und füge diese Zeilen ein:
# Deutsche Mehrzahl für "Notiz", sonst bildet Rails "notizs"
ActiveSupport::Inflector.inflections(:en) do |inflect|
inflect.irregular "notiz", "notizen"
end
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Model und Migration erzeugen
Ein Model steht für eine Tabelle, eine Migration beschreibt, wie die Tabelle angelegt wird. titel:string ergänzt eine Textspalte titel. Die laufende Nummer id und die Zeitstempel created_at und updated_at fügt Rails selbst hinzu.
bin/rails generate model Notiz titel:string
Prüfen: Die Ausgabe enthält create db/migrate/…_create_notizen.rb und create app/models/notiz.rb. Steht dort create_notizs, fehlt die Regel aus Schritt 6. Lösche die Dateien dann mit bin/rails destroy model Notiz, korrigiere Schritt 6 und wiederhole diesen Schritt.
8. Tabelle anlegen
Führt die Migration aus. Rails legt dabei die Datei storage/development.sqlite3 an und darin die Tabelle notizen.
bin/rails db:migrate
Prüfen: Die Ausgabe enthält create_table(:notizen) und endet mit CreateNotizen: migrated.
9. Pflichtfeld im Model festlegen
Das Model soll keine Notiz ohne Titel speichern.
nano app/models/notiz.rb
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
class Notiz < ApplicationRecord
# Ohne Titel wird keine Notiz gespeichert
validates :titel, presence: true
end
validates … presence: true lässt save scheitern, wenn titel fehlt oder leer ist. Die Spalten muss man im Model nicht aufzählen, Rails liest sie aus der Datenbank.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Controller für die Notizen schreiben
Ein Controller beantwortet Anfragen. Rails findet ihn über seinen Namen: Adressen unter /notizen landen in der Klasse NotizenController in der Datei notizen_controller.rb. Die Datei ist neu, nano startet mit einer leeren Seite.
nano app/controllers/notizen_controller.rb
Füge diesen Inhalt ein:
class NotizenController < ApplicationController
# Gibt es die gesuchte Notiz nicht, antworten wir mit 404
rescue_from ActiveRecord::RecordNotFound do
render json: { fehler: "Notiz nicht gefunden" }, status: :not_found
end
# GET /notizen liefert alle Notizen
def index
render json: Notiz.order(:id).as_json(only: [:id, :titel])
end
# GET /notizen/1 liefert eine Notiz
def show
notiz = Notiz.find(params[:id])
render json: notiz.as_json(only: [:id, :titel])
end
# POST /notizen legt eine Notiz an; der Inhalt kommt als JSON
def create
notiz = Notiz.new(titel: params[:titel])
if notiz.save
render json: notiz.as_json(only: [:id, :titel]), status: :created, location: notiz
else
render json: { fehler: notiz.errors.full_messages }, status: :unprocessable_entity
end
end
end
- Methoden
index,showundcreate– die üblichen Namen für „alle zeigen“, „eine zeigen“ und „anlegen“. Welche Adresse zu welcher Methode führt, legt Schritt 12 fest. params– enthält alle Werte der Anfrage: aus der Adresse (:id) und aus dem mitgeschickten JSON (titel). Es wird nurtitelübernommen. Schickt jemand eine eigeneidmit, bleibt sie unbeachtet.Notiz.find– sucht nach der Nummer. Gibt es sie nicht, löst es einen Fehler aus, denrescue_fromin eine Antwort mit404verwandelt.as_json(only: …)– nimmt nuridundtitelin das JSON auf, ohne die Zeitstempel.location: notiz– setzt die KopfzeileLocationauf die Adresse der neuen Notiz.errors.full_messages– die Gründe, warumsavegescheitert ist, hier aus Schritt 9.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Controller für die Begrüßung schreiben
Ein zweiter, kleiner Controller für die Adresse /hallo.
nano app/controllers/hallo_controller.rb
Füge diesen Inhalt ein:
class HalloController < ApplicationController
# GET /hallo?name=... liefert eine Begrüßung als JSON
def index
name = params.fetch(:name, "Welt")
render json: { gruss: "Hallo #{name}!" }
end
end
params.fetch(:name, "Welt") nimmt den Wert aus ?name=… oder, wenn er fehlt, Welt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Routen festlegen
In config/routes.rb steht, welche Adresse und Methode zu welchem Controller führt.
nano config/routes.rb
Ersetze den ganzen Inhalt wie in Schritt 9 und füge ein:
Rails.application.routes.draw do
# GET /hallo beantwortet die Methode index im HalloController
get "hallo", to: "hallo#index"
# Adressen für Notizen: alle lesen, eine lesen, eine anlegen
resources :notizen, only: [:index, :show, :create]
end
resources :notizen erzeugt mit einer Zeile die üblichen Adressen für eine Sammlung. only: beschränkt sie auf die drei Methoden aus Schritt 10. Ohne only: kämen Ändern und Löschen dazu, für die es im Controller noch keine Methoden gibt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Routen anzeigen
Zeigt die Routen, die zu Controllern mit notizen im Namen führen. So siehst du, ob Rails die Datei aus Schritt 12 fehlerfrei gelesen hat.
bin/rails routes -c notizen
Prüfen: Die Liste enthält drei Zeilen: GET /notizen → notizen#index, POST /notizen → notizen#create und GET /notizen/:id → notizen#show. Ohne -c notizen erscheinen zusätzlich viele Routen, die Rails selbst für E-Mail-Empfang und Datei-Uploads mitbringt.
Starten und testen
14. Entwicklungsserver starten
Startet Puma im Entwicklungsmodus, nur vom eigenen Rechner aus erreichbar. Das Terminal bleibt belegt, hier erscheinen zu jeder Anfrage Controller, Parameter und die ausgeführten SQL-Befehle.
bin/rails server
Prüfen: Die Ausgabe enthält Listening on http://127.0.0.1:3000 und endet mit Use Ctrl-C to stop. Steht dort stattdessen Address already in use, ist Port 3000 belegt, siehe Vorbemerkungen.
15. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:3000/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht location: http://localhost:3000/notizen/1, die letzte Zeile ist {"id":1,"titel":"Erste Notiz"}. Im ersten Terminal erscheint Processing by NotizenController#create und Completed 201 Created.
16. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:3000/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl http://localhost:3000/notizen/1 | {"id":1,"titel":"Erste Notiz"} |
curl "http://localhost:3000/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl http://localhost:3000/notizen/7 | {"fehler":"Notiz nicht gefunden"} (Status 404) |
curl -X POST http://localhost:3000/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":["Titel can't be blank"]} (Status 422) |
curl http://localhost:3000/gibtsnicht | langes JSON mit "status":404 und No route matches [GET] \"/gibtsnicht\" |
Die Meldung Titel can't be blank stammt aus der Regel in Schritt 9. Rails formuliert sie auf Englisch, solange keine deutschen Texte eingerichtet sind. Bei unbekannten Adressen antwortet Rails im Entwicklungsmodus selbst, mit einer ausführlichen Fehlerbeschreibung zur Fehlersuche.
17. Änderung ohne Neustart ausprobieren
Rails lädt geänderten Code im Entwicklungsmodus bei der nächsten Anfrage neu. Ändere in app/controllers/hallo_controller.rb das Wort Hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:3000/hallo liefert sofort {"gruss":"Servus Welt!"}.
Änderungen in config/initializers (wie in Schritt 6) werden erst nach einem Neustart des Servers wirksam.
18. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Prüfen: Die letzten Zeilen lauten - Goodbye! und Exiting. Startest du den Server mit bin/rails server erneut, liefert curl http://localhost:3000/notizen weiterhin die Notiz aus Schritt 15. Sie liegt in storage/development.sqlite3.
Wie geht es weiter?
- Konsole:
bin/rails consoleöffnet Ruby mit geladenem Projekt. Dort liefert z. B.Notiz.countdie Zahl der Notizen undNotiz.create(titel: "Aus der Konsole")legt eine an. Beenden mitexit. - Gerüst erzeugen:
bin/rails generate scaffold Aufgabe titel:string erledigt:booleanerzeugt Model, Migration, Controller mit allen Methoden (auch Ändern und Löschen), Routen und Tests auf einmal. Danachbin/rails db:migrate. - Tests: Der Generator aus Schritt 7 hat unter
test/schon Dateien angelegt.bin/rails testführt alle Tests aus. - Webseiten: Ohne
--apiangelegte Projekte liefern HTML-Seiten aus Vorlagen im Ordnerapp/views. - Andere Datenbank: Mit dem Paket
ruby-pg, dem Eintraggem "pg"imGemfileund passenden Angaben inconfig/database.ymlverwendet Rails PostgreSQL.rails new … --database=postgresqlrichtet das gleich beim Anlegen ein. - Betrieb: Auf einem Server startet man Puma mit
RAILS_ENV=productionüber einen systemd-Dienst (siehe die Dienstdatei in der Qdrant-Anleitung als Vorlage) und setzt nginx davor, der auch HTTPS übernimmt. Vorher müssen mitRAILS_ENV=production bin/rails db:migratedie Tabellen der Produktionsdatenbank angelegt werden.
Alternative: neueste Version über gem
Wer Rails 8 braucht, installiert es mit gem in das eigene Home-Verzeichnis. Die Gems kommen dann von rubygems.org und nicht aus Ubuntu. Beim Anlegen eines Projekts übersetzt Bundler einige Gems (z. B. Puma und bootsnap) aus dem Quellcode. Dafür braucht es ruby-dev und build-essential.
sudo apt install ruby-dev build-essential
gem install --user-install rails
Der Befehl rails landet dann in ~/.local/share/gem/ruby/3.3.0/bin. Diesen Ordner musst du in die Variable PATH aufnehmen, sonst startet weiter die Version aus Ubuntu. rails new braucht mit dieser Version die --skip-Schalter aus Schritt 4 nicht, lädt aber alle fehlenden Gems aus dem Internet (getestet mit Rails 8.1.4). Diese Version bekommt keine Updates über apt, du hältst sie selbst mit gem update --user-install rails aktuell.
Deinstallieren
1. Server beenden
Läuft bin/rails server noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt SQLite-Datenbank.
rm -rf ~/meinrails
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinrails
3. Rails entfernen
Nur ausführen, wenn kein anderes Programm Rails braucht.
sudo apt purge rails
4. Nicht mehr benötigte Pakete entfernen
Entfernt die Pakete, die nur für Rails mitinstalliert wurden, z. B. ruby-rails, puma und ruby-sqlite3. Ruby selbst bleibt, wenn ein anderes Programm es braucht, etwa Jekyll oder Asciidoctor. Der Befehl entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Shell meldet, dass der Befehl rails nicht gefunden wurde.
rails --version
Quellen und Lizenz
- Offizielle Dokumentation: https://guides.rubyonrails.org/
- Lizenz: Ruby on Rails steht unter der MIT.
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.
C
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
C ist eine schlanke, maschinennahe Programmiersprache, in der Betriebssysteme, Treiber und viele Grundprogramme von Linux geschrieben sind. Wer C lernt, versteht, wie Speicher und Prozessor tatsächlich arbeiten.
Vorbemerkungen
- Compiler: C-Quelltext wird vor dem Start in ein ausführbares Programm übersetzt. Unter Ubuntu ist dafür der GCC (GNU Compiler Collection) üblich, in Ubuntu 26.04 in Version 15. Als Alternative gibt es Clang (Version 21), das oft verständlichere Fehlermeldungen ausgibt.
- Paket
build-essential: Dieses Sammelpaket enthält alles, was man zum Übersetzen braucht:gcc,g++,makeund die Header-Dateien der C-Standardbibliothek. Es ist auch die Grundlage für die Anleitung C++. - Editor: Zum Schreiben reicht jeder Texteditor, z. B. GNU nano, Vim oder Visual Studio Code mit der Erweiterung „C/C++“.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Compiler und Build-Werkzeuge installieren
Installiert GCC, make und die Header-Dateien der Standardbibliothek. Ohne diese Dateien kennt der Compiler z. B. printf nicht.
sudo apt install build-essential
Prüfen: Die Versionsnummer von GCC wird angezeigt, z. B. gcc (Ubuntu 15.2.0-…) 15.2.0.
gcc --version
3. Debugger installieren
gdb lässt ein Programm Zeile für Zeile ablaufen und zeigt dabei die Werte der Variablen. Das hilft enorm bei der Fehlersuche, gerade bei Abstürzen durch falsche Speicherzugriffe.
sudo apt install gdb
Prüfen:
gdb --version
4. Optional: Clang installieren
Ein zweiter Compiler ist nützlich, um zu prüfen, ob der eigene Code nicht nur mit GCC funktioniert. Der Befehl heißt danach clang.
sudo apt install clang
Prüfen:
clang --version
Erstes Programm
5. Arbeitsordner anlegen
Ein eigener Ordner hält die Übungsdateien zusammen.
mkdir -p ~/c-uebung
6. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/c-uebung
7. Quelltext anlegen
Legt die Datei hallo.c an. Das Programm gibt einen Gruß aus und addiert in einer Schleife die Zahlen von 1 bis 10.
nano hallo.c
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
#include <stdio.h>
int main(void)
{
const char *name = "Ubuntu";
int summe = 0;
for (int i = 1; i <= 10; i++) {
summe += i;
}
printf("Hallo %s!\n", name);
printf("Summe von 1 bis 10: %d\n", summe);
return 0;
}
8. Programm übersetzen
Erzeugt aus hallo.c die ausführbare Datei hallo. Die Schalter bedeuten:
-Wall -Wextra– Warnungen bei verdächtigem Code einschalten; für Einsteiger sehr zu empfehlen.-g– Informationen für den Debugger einbauen.-o hallo– Name der erzeugten Datei.
gcc -Wall -Wextra -g -o hallo hallo.c
Prüfen: Der Befehl gibt nichts aus, und im Ordner liegt jetzt die Datei hallo.
ls -l hallo
9. Programm starten
Das ./ sagt der Shell, dass das Programm im aktuellen Ordner liegt.
./hallo
Prüfen: Die Ausgabe lautet:
Hallo Ubuntu!
Summe von 1 bis 10: 55
10. Optional: Mit dem Debugger untersuchen
Startet gdb mit dem Programm. Innerhalb von gdb setzt break main einen Haltepunkt am Anfang von main, run startet, next geht eine Zeile weiter, print summe zeigt den Wert der Variablen und quit beendet den Debugger.
gdb ./hallo
Mehrere Dateien mit make übersetzen
Sobald ein Projekt aus mehreren Dateien besteht, ist es mühsam, gcc jedes Mal von Hand aufzurufen. make liest die Bauanleitung aus einer Datei Makefile und übersetzt nur, was sich geändert hat.
11. Makefile anlegen
Legt ein einfaches Makefile für hallo.c an. Wichtig: Die eingerückten Zeilen müssen mit einem Tabulator beginnen, nicht mit Leerzeichen. Sonst bricht make mit missing separator ab.
nano Makefile
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V). Beim Einfügen bleiben die Tabulatoren erhalten. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Willst du den Inhalt lieber abtippen und hast in ~/.nanorc die Einstellungen aus der Anleitung GNU nano, schalte vorher zwei davon für diese Sitzung ab. Alt+O sorgt dafür, dass die Taste Tab einen echten Tabulator statt Leerzeichen einfügt. Alt+I verhindert, dass nano die Einrückung in die nächste Zeile übernimmt und so auch clean: einrückt. Drücke dann vor $(CC) und vor rm jeweils Tab.
CFLAGS = -Wall -Wextra -g
hallo: hallo.c
$(CC) $(CFLAGS) -o hallo hallo.c
clean:
rm -f hallo
Prüfen: Vor $(CC) und rm steht ^I, das Zeichen für einen Tabulator.
cat -A Makefile
12. Mit make bauen
Löscht zuerst die alte Programmdatei und übersetzt dann neu.
make clean && make
Prüfen: make zeigt den ausgeführten Befehl an (cc ist unter Ubuntu ein anderer Name für gcc), und ./hallo läuft wie in Schritt 9. Ein zweiter Aufruf von make meldet „hallo“ ist bereits aktuell, weil sich nichts geändert hat.
Wie geht es weiter?
- Größere Projekte: Für Projekte mit vielen Dateien und Bibliotheken ist CMake verbreitet; ein Beispiel steht in der Anleitung C++.
- Speicherfehler finden: Der Schalter
-fsanitize=addressbeim Übersetzen lässt das Programm bei falschen Speicherzugriffen sofort mit einer genauen Meldung abbrechen. Das Paketvalgrindleistet Ähnliches ohne neues Übersetzen. - Handbuchseiten: Zu fast jeder Funktion der Standardbibliothek gibt es eine Beschreibung im Terminal, z. B.
man 3 printf. Dafür das Paketmanpages-devinstallieren.
Deinstallieren
1. Übungsordner entfernen
Löscht die Beispieldateien.
rm -rf ~/c-uebung
2. Debugger und Clang entfernen
Entfernt die Zusatzwerkzeuge aus dieser Anleitung.
sudo apt purge gdb clang
3. Optional: Compiler entfernen
Nur ausführen, wenn nichts anderes den Compiler braucht. Auch die Anleitung C++ sowie Programme, die bei der Installation Code übersetzen (z. B. Treiber über DKMS oder Python-Pakete mit C-Erweiterungen), sind darauf angewiesen.
sudo apt purge build-essential
4. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt Pakete auf, die nur für die entfernten Programme installiert wurden, z. B. gcc und make.
sudo apt autoremove
Prüfen: Die Meldung lautet gdb: Befehl nicht gefunden bzw. command not found.
gdb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://gcc.gnu.org/onlinedocs/
- Lizenz: GCC steht unter der GPL-3.0-or-later.
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.
C++
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
C++ erweitert C um Klassen, Vorlagen (Templates) und eine umfangreiche Standardbibliothek. Die Sprache wird überall dort eingesetzt, wo hohe Geschwindigkeit zählt: in Spielen, Browsern, Datenbanken, Grafikprogrammen und eingebetteten Systemen.
Vorbemerkungen
- Compiler: Unter Ubuntu übersetzt meist
g++aus der GNU Compiler Collection (Version 15 in Ubuntu 26.04) den Quelltext. Alternativ gibt esclang++(Version 21). - Sprachstandard: C++ erscheint etwa alle drei Jahre in einer neuen Fassung (C++17, C++20, C++23 …). Diese Anleitung nutzt C++23, weil es die bequeme Ausgabefunktion
std::printlnmitbringt. Der Standard wird beim Übersetzen mit-std=c++23gewählt. - CMake: Größere C++-Projekte beschreibt man nicht mit handgeschriebenen Compiler-Aufrufen, sondern mit CMake. CMake erzeugt daraus die eigentlichen Bauanweisungen und wird von den meisten Entwicklungsumgebungen direkt verstanden.
- Grundlagen aus C: Das Paket
build-essentialist dasselbe wie in der Anleitung C. Wer die schon durchgearbeitet hat, kann Schritt 2 überspringen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Compiler und Build-Werkzeuge installieren
Installiert g++, gcc, make und die Header-Dateien der Standardbibliotheken.
sudo apt install build-essential
Prüfen: Die Versionsnummer wird angezeigt, z. B. g++ (Ubuntu 15.2.0-…) 15.2.0.
g++ --version
3. CMake installieren
Installiert das Build-System CMake.
sudo apt install cmake
Prüfen:
cmake --version
4. Debugger installieren
Mit gdb lässt sich ein Programm schrittweise ausführen, um Fehler zu finden.
sudo apt install gdb
Prüfen:
gdb --version
5. Optional: Clang und Hilfswerkzeuge installieren
clang bringt den Compiler clang++ mit, clang-format rückt Quelltext einheitlich ein und clangd liefert Editoren wie Visual Studio Code oder Neovim Autovervollständigung und Fehlerhinweise.
sudo apt install clang clang-format clangd
Prüfen:
clang++ --version
Erstes Programm
6. Arbeitsordner anlegen
Ein eigener Ordner für die Übungsdateien.
mkdir -p ~/cpp-uebung
7. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/cpp-uebung
8. Quelltext anlegen
Legt die Datei main.cpp an. Das Programm speichert einige Namen in einem std::vector, gibt sie nacheinander aus und zählt sie.
nano main.cpp
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
#include <print>
#include <string>
#include <vector>
int main()
{
std::vector<std::string> sprachen{"C", "C++", "Java", "Python"};
for (const auto& sprache : sprachen) {
std::println("Ich lerne {}", sprache);
}
std::println("Anzahl: {}", sprachen.size());
}
9. Programm übersetzen
Übersetzt main.cpp nach dem Standard C++23 mit eingeschalteten Warnungen in die Datei hallo.
g++ -std=c++23 -Wall -Wextra -g -o hallo main.cpp
Prüfen: Es erscheint keine Fehlermeldung. Meldet der Compiler print: No such file or directory, fehlt der Schalter -std=c++23.
10. Programm starten
./hallo
Prüfen: Die Ausgabe lautet:
Ich lerne C
Ich lerne C++
Ich lerne Java
Ich lerne Python
Anzahl: 4
Projekt mit CMake bauen
11. CMake-Beschreibung anlegen
Die Datei CMakeLists.txt sagt CMake, wie das Projekt heißt, welcher Sprachstandard gilt und aus welchen Quelldateien das Programm entsteht.
nano CMakeLists.txt
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
cmake_minimum_required(VERSION 3.28)
project(hallo LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(hallo main.cpp)
12. Build-Ordner einrichten
CMake prüft den Compiler und legt im Unterordner build alle Bauanweisungen ab. So bleiben die erzeugten Dateien vom Quelltext getrennt.
cmake -S . -B build
Prüfen: Die letzte Zeile lautet -- Build files have been written to: …/cpp-uebung/build.
13. Projekt bauen
Übersetzt das Projekt. Nach Änderungen am Quelltext genügt es, diesen Befehl erneut auszuführen.
cmake --build build
Prüfen: Die Meldung [100%] Built target hallo erscheint.
14. Programm starten
Das fertige Programm liegt im Build-Ordner.
./build/hallo
Prüfen: Die Ausgabe ist dieselbe wie in Schritt 10.
Wie geht es weiter?
- Entwicklungsumgebung: Visual Studio Code mit den Erweiterungen „C/C++“ und „CMake Tools“ öffnet CMake-Projekte direkt. Auch CLion von JetBrains arbeitet mit CMake.
- Bibliotheken: Viele verbreitete C++-Bibliotheken gibt es als Pakete mit der Endung
-dev, z. B.libboost-all-devfür Boost oderlibfmt-dev. CMake findet sie überfind_package(...). - Speicherfehler finden: Die Schalter
-fsanitize=address,undefinedmachen falsche Speicherzugriffe und undefiniertes Verhalten beim Ausführen sichtbar.
Deinstallieren
1. Übungsordner entfernen
Löscht Quelltext und Build-Ordner.
rm -rf ~/cpp-uebung
2. Zusatzwerkzeuge entfernen
Entfernt CMake, den Debugger und die Clang-Werkzeuge.
sudo apt purge cmake gdb clang clang-format clangd
3. Optional: Compiler entfernen
Nur ausführen, wenn nichts anderes den Compiler braucht, z. B. die Anleitung C oder Treiber, die über DKMS übersetzt werden.
sudo apt purge build-essential
4. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt Pakete auf, die nur für die entfernten Programme installiert wurden.
sudo apt autoremove
Prüfen: Die Meldung lautet cmake: Befehl nicht gefunden bzw. command not found.
cmake --version
Quellen und Lizenz
- Offizielle Dokumentation: https://gcc.gnu.org/onlinedocs/
- Lizenz: GCC (g++) steht unter der GPL-3.0-or-later.
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.
Java
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Java ist eine objektorientierte Programmiersprache, deren Programme auf einer virtuellen Maschine laufen und dadurch ohne Änderung unter Linux, Windows und macOS funktionieren. Sie ist in Unternehmensanwendungen, Android-Apps und Serverprogrammen weit verbreitet.
Vorbemerkungen
- JDK und JRE: Zum Programmieren braucht man das JDK (Java Development Kit) mit Compiler
javac. Die JRE (Java Runtime Environment) allein kann Programme nur ausführen. Das JDK enthält die Laufzeitumgebung bereits. - OpenJDK 25: Ubuntu 26.04 liefert OpenJDK 25, die aktuelle Version mit Langzeitunterstützung (LTS). Das Paket
default-jdkverweist darauf und wird bei künftigen Ubuntu-Versionen automatisch auf die dann aktuelle LTS-Version umgestellt. Ältere und neuere Versionen (z. B.openjdk-21-jdk,openjdk-26-jdk) lassen sich zusätzlich installieren. - Kompakte Quelldateien: Seit Java 25 darf ein kleines Programm ohne Klassendeklaration und ohne
public staticgeschrieben werden. Das senkt die Einstiegshürde deutlich; die Anleitung zeigt beide Schreibweisen. - Entwicklungsumgebung: Für größere Projekte eignen sich IntelliJ IDEA, Eclipse IDE oder Visual Studio Code mit dem „Extension Pack for Java“.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. JDK installieren
Installiert OpenJDK 25 mit Compiler javac, Laufzeitumgebung java und weiteren Werkzeugen wie jshell.
sudo apt install default-jdk
Prüfen: Die Ausgabe beginnt mit openjdk version "25…".
java -version
Prüfen: Auch der Compiler ist vorhanden.
javac -version
3. Optional: Build-Werkzeug Maven installieren
Maven lädt benötigte Bibliotheken automatisch herunter und baut Projekte nach einem festen Schema. Es wird z. B. für Spring Boot gebraucht.
sudo apt install maven
Prüfen:
mvn -version
4. Optional: Zwischen mehreren Java-Versionen wechseln
Nur nötig, wenn mehrere JDKs installiert sind. Der Befehl zeigt eine nummerierte Liste; die Eingabe der Nummer legt fest, welche Version der Befehl java startet. Für javac gibt es den gleichen Befehl mit javac am Ende.
sudo update-alternatives --config java
Erstes Programm
5. Arbeitsordner anlegen
Ein eigener Ordner für die Übungsdateien.
mkdir -p ~/java-uebung
6. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/java-uebung
7. Kompakte Quelldatei anlegen
Legt Hallo.java in der kurzen Schreibweise ab Java 25 an. Die Klasse IO liest eine Zeile von der Tastatur und gibt Text aus.
nano Hallo.java
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
void main() {
String name = IO.readln("Wie heißt du? ");
IO.println("Hallo " + name + "!");
}
8. Quelldatei direkt starten
Bei einzelnen Dateien kann java den Quelltext selbst übersetzen und sofort ausführen. Ein getrennter Aufruf von javac ist nicht nötig.
java Hallo.java
Prüfen: Das Programm fragt nach einem Namen. Nach der Eingabe von z. B. Thorsten erscheint Hallo Thorsten!.
Klassische Schreibweise mit javac
9. Klasse anlegen
So sehen Java-Programme in Büchern, älteren Projekten und größeren Anwendungen aus: Jede Datei enthält eine Klasse, deren Name dem Dateinamen entspricht.
nano Rechner.java
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
public class Rechner {
public static void main(String[] args) {
int summe = 0;
for (int i = 1; i <= 10; i++) {
summe += i;
}
System.out.println("Summe von 1 bis 10: " + summe);
}
}
10. Quelltext übersetzen
javac erzeugt die Datei Rechner.class mit dem Bytecode für die virtuelle Maschine.
javac Rechner.java
Prüfen: Im Ordner liegt jetzt Rechner.class.
ls
11. Programm starten
Beim Start wird nur der Klassenname angegeben, ohne .class.
java Rechner
Prüfen: Die Ausgabe lautet Summe von 1 bis 10: 55.
12. Optional: Mit JShell ausprobieren
jshell nimmt einzelne Java-Anweisungen entgegen und zeigt das Ergebnis sofort. Ideal zum Ausprobieren, z. B. Math.sqrt(2) oder "Java".repeat(3). Beenden mit /exit.
jshell
Wie geht es weiter?
- Projekte mit Maven:
mvn archetype:generatelegt ein vollständiges Projekt mit Ordnerstruktur und Testrahmen an. Gradle ist die verbreitete Alternative. - Webanwendungen: Die Anleitung Spring Boot baut darauf auf.
- Dokumentation: Die Beschreibung aller Klassen der Standardbibliothek steht als Javadoc auf den Seiten von Oracle bzw. OpenJDK; das Paket
openjdk-25-docinstalliert sie lokal.
Deinstallieren
1. Übungsordner entfernen
Löscht die Beispieldateien.
rm -rf ~/java-uebung
2. Maven entfernen
Nur nötig, wenn Maven installiert wurde.
sudo apt purge maven
3. JDK entfernen
Entfernt das Verweispaket und OpenJDK 25. Programme wie IntelliJ IDEA oder Eclipse bringen meist ein eigenes JDK mit und laufen weiter.
sudo apt purge default-jdk default-jdk-headless openjdk-25-jdk openjdk-25-jdk-headless
4. Laufzeitumgebung und Abhängigkeiten entfernen
Räumt die Laufzeitumgebung (openjdk-25-jre…) und weitere nur für Java installierte Pakete auf.
sudo apt autoremove
5. Heruntergeladene Maven-Bibliotheken löschen
Maven speichert Bibliotheken im Ordner ~/.m2. Wird Maven nicht mehr gebraucht, kann er weg.
rm -rf ~/.m2
Prüfen: Die Meldung lautet javac: Befehl nicht gefunden bzw. command not found.
javac -version
Quellen und Lizenz
- Offizielle Dokumentation: https://openjdk.org/
- Lizenz: OpenJDK steht unter der GPL-2.0 with Classpath Exception.
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.
Python
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Python ist eine leicht lesbare Programmiersprache, die sich gleichermaßen für kleine Skripte, Datenanalyse, Webanwendungen und künstliche Intelligenz eignet. Wegen ihrer klaren Syntax ist sie auch eine beliebte erste Programmiersprache.
Vorbemerkungen
- Bereits vorinstalliert: Ubuntu 26.04 bringt Python 3.14 mit, weil viele Systemprogramme darauf aufbauen. Der Befehl heißt
python3. Es fehlen nur die Werkzeuge, um zusätzliche Pakete zu installieren. - Systempython nicht entfernen: Das Paket
python3darf nicht deinstalliert werden, sonst funktionieren Teile von Ubuntu nicht mehr (u. a. Paketverwaltung und Desktop-Werkzeuge). - Virtuelle Umgebungen: Ubuntu verhindert, dass
pipPakete aus dem Internet direkt in das Systempython schreibt. Ein Versuch endet mit der Meldungexternally-managed-environment. Stattdessen legt man pro Projekt eine virtuelle Umgebung (venv) an: einen Ordner mit eigenem Python und eigenen Paketen, der das System nicht berührt. - Pakete aus apt: Viele verbreitete Bibliotheken gibt es auch als Ubuntu-Paket mit dem Präfix
python3-, z. B.python3-requests. Diese sind für das ganze System verfügbar, aber oft etwas älter als die Fassung auf PyPI.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Vorhandenes Python prüfen
Zeigt, welche Python-Version bereits installiert ist.
python3 --version
Prüfen: Die Ausgabe lautet Python 3.14.….
3. pip und venv installieren
python3-venv erstellt virtuelle Umgebungen, python3-pip installiert Pakete aus dem Python-Paketverzeichnis PyPI. python3-dev enthält Header-Dateien, die manche Pakete zum Übersetzen von C-Erweiterungen brauchen.
sudo apt install python3-venv python3-pip python3-dev
Prüfen:
pip3 --version
4. Optional: Befehl python einrichten
Viele Anleitungen im Internet schreiben python statt python3. Dieses kleine Paket legt den Befehl python als Verweis auf python3 an.
sudo apt install python-is-python3
Prüfen: Die Ausgabe ist dieselbe wie bei python3 --version.
python --version
Erstes Programm
5. Arbeitsordner anlegen
Ein eigener Ordner für das Übungsprojekt.
mkdir -p ~/python-uebung
6. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/python-uebung
7. Skript anlegen
Legt hallo.py an. Das Skript nummeriert eine Liste von Programmiersprachen und gibt das heutige Datum im deutschen Format aus.
nano hallo.py
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
from datetime import date
sprachen = ["C", "C++", "Java", "Python", "C#", "JavaScript"]
for nummer, sprache in enumerate(sprachen, start=1):
print(f"{nummer}. {sprache}")
print(f"Heute ist der {date.today():%d.%m.%Y}.")
8. Skript ausführen
Python übersetzt nichts vorab, sondern führt den Quelltext direkt aus.
python3 hallo.py
Prüfen: Es erscheinen sechs nummerierte Zeilen von 1. C bis 6. JavaScript und danach das heutige Datum.
Virtuelle Umgebung und Pakete
9. Virtuelle Umgebung anlegen
Erstellt im Projektordner den Unterordner .venv mit einer eigenen Python-Installation.
python3 -m venv .venv
10. Virtuelle Umgebung aktivieren
Sorgt dafür, dass python und pip im aktuellen Terminal aus .venv kommen. Das muss in jedem neuen Terminal wiederholt werden.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv), und der folgende Befehl zeigt einen Pfad innerhalb von ~/python-uebung/.venv.
which python
11. Paket installieren
Installiert als Beispiel die Bibliothek requests für HTTP-Anfragen. Sie landet nur in dieser virtuellen Umgebung, sudo ist deshalb nicht nötig.
pip install requests
Prüfen: Die installierte Version wird angezeigt.
python -c "import requests; print(requests.__version__)"
12. Abhängigkeiten festhalten
Schreibt alle installierten Pakete mit Versionsnummer in requirements.txt. Mit dieser Datei lässt sich die Umgebung auf einem anderen Rechner per pip install -r requirements.txt genauso wieder aufbauen.
pip freeze > requirements.txt
13. Virtuelle Umgebung verlassen
Schaltet wieder auf das Systempython um. (.venv) verschwindet aus der Eingabeaufforderung.
deactivate
Wie geht es weiter?
- Interaktiv ausprobieren:
python3ohne Dateiname startet eine Eingabezeile, in der jede Anweisung sofort ausgeführt wird. Beenden mitexit()oder Strg+D. - Programme mit Kommandozeile: Werkzeuge, die als Befehl genutzt werden sollen (z. B.
mkdocs), installiert man am besten mitpipx(sudo apt install pipx). Jedes bekommt automatisch eine eigene virtuelle Umgebung. - Webanwendungen: Die Anleitung Django baut auf dieser Grundlage auf.
- Editor: Visual Studio Code mit der Erweiterung „Python“ erkennt
.venvim Projektordner automatisch.
Deinstallieren
1. Übungsordner entfernen
Löscht das Skript und die virtuelle Umgebung samt installierter Pakete.
rm -rf ~/python-uebung
2. Zusatzpakete entfernen
Entfernt die Werkzeuge aus dieser Anleitung. Das vorinstallierte python3 bleibt erhalten und darf nicht entfernt werden.
sudo apt purge python3-venv python3-pip python3-dev python-is-python3
3. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt Pakete auf, die nur für die entfernten Werkzeuge installiert wurden.
sudo apt autoremove
Prüfen: pip3 ist nicht mehr vorhanden (Befehl nicht gefunden), python3 --version funktioniert aber weiterhin.
pip3 --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.python.org/3/
- Lizenz: Python steht unter der PSF License.
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.
C#
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
C# (gesprochen „C Sharp“) ist die wichtigste Programmiersprache der Plattform .NET von Microsoft. Mit ihr entstehen Kommandozeilenprogramme, Webanwendungen, Desktop-Programme und Spiele (z. B. mit Unity), und sie läuft heute genauso unter Linux wie unter Windows.
Vorbemerkungen
- .NET SDK: Zum Programmieren in C# braucht man das .NET SDK. Es enthält den Befehl
dotnet, den C#-Compiler, die Laufzeitumgebung und Projektvorlagen. - Installation über apt: Ubuntu 26.04 liefert .NET 10 in den eigenen Paketquellen. Das ist die aktuelle Version mit Langzeitunterstützung (LTS) bis November 2028 und bringt C# 14 mit. Ein Paketarchiv von Microsoft ist nicht nötig.
- Zwei Arbeitsweisen: Seit .NET 10 lässt sich eine einzelne
.cs-Datei direkt mitdotnet runstarten, ganz ohne Projektdatei. Für richtige Programme legt man ein Projekt mitdotnet newan. Diese Anleitung zeigt beides. - Entwicklungsumgebung: Visual Studio Code mit der Erweiterung „C# Dev Kit“ oder JetBrains Rider. Das klassische Visual Studio gibt es nur für Windows, siehe Microsoft Visual Studio.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version des .NET SDK kennt.
sudo apt update
2. .NET SDK installieren
Installiert das SDK mitsamt Laufzeitumgebungen. Ist es schon vorhanden (z. B. aus der Anleitung ASP.NET Core), meldet apt das nur.
sudo apt install dotnet-sdk-10.0
Prüfen: Die Ausgabe beginnt mit 10.0..
dotnet --version
3. Optional: Nutzungsstatistik abschalten
Die Befehlszeile dotnet kann anonyme Nutzungsdaten an Microsoft senden. Diese Zeile in ~/.bashrc schaltet das für alle künftigen Terminals ab. Danach ein neues Terminal öffnen.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
export DOTNET_CLI_TELEMETRY_OPTOUT=1
Einzelne Datei ausführen
4. Arbeitsordner anlegen
Ein eigener Ordner für die Übungsdateien.
mkdir -p ~/csharp-uebung
5. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/csharp-uebung
6. Quelltext anlegen
Legt hallo.cs an. Die Anweisungen stehen direkt in der Datei, eine Klasse mit Main-Methode ist nicht nötig. Sum() und Max() stammen aus LINQ, den Abfragefunktionen von .NET.
nano hallo.cs
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
var zahlen = new[] { 3, 1, 4, 1, 5 };
Console.WriteLine($"Hallo aus C# {Environment.Version}!");
Console.WriteLine($"Summe: {zahlen.Sum()}, größte Zahl: {zahlen.Max()}");
7. Datei ausführen
dotnet übersetzt die Datei im Hintergrund und startet sie. Der erste Aufruf dauert einige Sekunden, weitere Aufrufe gehen schneller.
dotnet run hallo.cs
Prüfen: Die Ausgabe lautet:
Hallo aus C# 10.0.…!
Summe: 14, größte Zahl: 5
Konsolenprojekt anlegen
8. Projekt erzeugen
Erzeugt aus der Vorlage console ein Projekt im Unterordner Rechner. Darin liegen die Projektdatei Rechner.csproj und der Quelltext Program.cs.
dotnet new console -o Rechner
9. In den Projektordner wechseln
dotnet run und dotnet build arbeiten mit dem Projekt im aktuellen Ordner.
cd Rechner
10. Quelltext ersetzen
Überschreibt die Vorlage mit einem kleinen Programm, das eine Klasse Konto anlegt und benutzt. Klassen stehen in dieser Schreibweise unterhalb der Anweisungen.
nano Program.cs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
var konto = new Konto("Thorsten");
konto.Einzahlen(100m);
konto.Abheben(30m);
Console.WriteLine($"{konto.Inhaber}: {konto.Stand:C}");
class Konto(string inhaber)
{
public string Inhaber { get; } = inhaber;
public decimal Stand { get; private set; }
public void Einzahlen(decimal betrag) => Stand += betrag;
public void Abheben(decimal betrag)
{
if (betrag > Stand)
throw new InvalidOperationException("Nicht genug Guthaben");
Stand -= betrag;
}
}
11. Projekt starten
Übersetzt das Projekt und startet es.
dotnet run
Prüfen: Die Ausgabe lautet Thorsten: 70,00 € (Währungsformat abhängig von der Spracheinstellung des Systems).
12. Optional: Fertiges Programm erzeugen
Erstellt eine optimierte Fassung im Ordner bin/Release/net10.0/publish. Das Programm dort lässt sich auf jedem Rechner mit .NET-10-Laufzeitumgebung per ./Rechner starten.
dotnet publish -c Release
Prüfen:
./bin/Release/net10.0/publish/Rechner
Wie geht es weiter?
- Bibliotheken: Pakete aus dem Verzeichnis NuGet fügt man mit
dotnet add package <Name>zum Projekt hinzu. - Tests: Die Vorlage
xunitlegt ein Testprojekt an;dotnet testführt die Tests aus. - Webanwendungen: Die Anleitung ASP.NET Core baut darauf auf.
- Weitere Vorlagen:
dotnet new listzeigt alle installierten Projektvorlagen.
Deinstallieren
1. Übungsordner entfernen
Löscht die Beispieldatei und das Projekt.
rm -rf ~/csharp-uebung
2. .NET SDK entfernen
Nur ausführen, wenn .NET auch nicht mehr für ASP.NET Core gebraucht wird.
sudo apt purge dotnet-sdk-10.0
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Laufzeitumgebungen und weitere nur für .NET installierte Pakete.
sudo apt autoremove
4. Zwischenspeicher im Benutzerordner löschen
dotnet legt heruntergeladene NuGet-Pakete und Einstellungen in ~/.nuget und ~/.dotnet ab.
rm -rf ~/.nuget ~/.dotnet
5. Optional: Eintrag für die Nutzungsstatistik entfernen
Nur nötig, wenn Schritt 3 der Installation ausgeführt wurde. Löscht die Zeile wieder aus ~/.bashrc.
nano ~/.bashrc
Suche mit Strg+W nach DOTNET_CLI_TELEMETRY_OPTOUT und drücke Enter. Lösche die Zeile export DOTNET_CLI_TELEMETRY_OPTOUT=1 mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Meldung lautet dotnet: Befehl nicht gefunden bzw. command not found.
dotnet --version
Quellen und Lizenz
- Offizielle Dokumentation: https://learn.microsoft.com/dotnet/csharp/
- Lizenz: .NET SDK und C# Compiler steht unter der MIT.
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.
JavaScript
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
JavaScript ist die Programmiersprache des Webs: Jeder Browser führt sie aus, um Webseiten interaktiv zu machen. Mit Node.js läuft JavaScript auch außerhalb des Browsers, etwa für Kommandozeilenwerkzeuge, Webserver und Build-Werkzeuge.
Vorbemerkungen
- Browser oder Node.js: Zum Ausprobieren reicht die Entwicklerkonsole jedes Browsers (in Firefox und Chromium mit F12). Für Programme auf dem Rechner und für fast alle Werkzeuge der Webentwicklung braucht man aber Node.js. Diese Anleitung richtet Node.js ein.
- Versionen: Ubuntu 26.04 liefert Node.js 22 (LTS) und npm 9. Für die Anleitungen in diesem Buch reicht das aus.
- npm: Der Paketmanager
npmlädt Bibliotheken aus dem npm-Verzeichnis und speichert sie pro Projekt im Ordnernode_modules. Welche Pakete ein Projekt braucht, steht in der Dateipackage.json. - Grundlage für andere Anleitungen: Node.js wird u. a. für Express.js, Yjs und Automerge, Docusaurus, VitePress und Astro Starlight gebraucht.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Installiert die JavaScript-Laufzeitumgebung node und den Paketmanager npm.
sudo apt install nodejs npm
Prüfen: Die Ausgabe beginnt mit v22..
node --version
Prüfen: Auch npm meldet seine Version.
npm --version
Erstes Programm
3. Arbeitsordner anlegen
Ein eigener Ordner für das Übungsprojekt.
mkdir -p ~/js-uebung
4. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/js-uebung
5. Skript anlegen
Legt hallo.js an. Das Skript filtert aus einer Liste alle Namen mit mehr als zwei Zeichen heraus und gibt sie zusammen mit der Node.js-Version aus.
nano hallo.js
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
const sprachen = ['C', 'C++', 'Java', 'Python', 'C#', 'JavaScript'];
const lang = sprachen.filter((s) => s.length > 2);
console.log(`Hallo aus Node.js ${process.version}!`);
console.log('Lange Namen:', lang.join(', '));
6. Skript ausführen
node liest die Datei und führt sie sofort aus, ein Übersetzungsschritt ist nicht nötig.
node hallo.js
Prüfen: Die Ausgabe lautet:
Hallo aus Node.js v22.…!
Lange Namen: C++, Java, Python, JavaScript
Projekt mit npm
7. Projekt anlegen
Erzeugt die Datei package.json mit Standardwerten. Sie beschreibt das Projekt und listet später die benötigten Pakete auf.
npm init -y
Prüfen: Die Datei package.json wird im Terminal angezeigt.
8. Moderne Modulschreibweise einschalten
Stellt das Projekt auf ES-Module um. Dann können Dateien andere Dateien und Pakete mit import … from … einbinden, so wie es auch im Browser üblich ist.
npm pkg set type=module
9. Paket installieren
Installiert als Beispiel die Bibliothek dayjs zum Rechnen mit Datum und Uhrzeit. Sie landet in node_modules, und package.json erhält einen Eintrag unter dependencies.
npm install dayjs
Prüfen: Das Paket erscheint in der Liste.
npm ls
10. Skript mit dem Paket anlegen
Legt datum.js an. Das Skript bindet dayjs ein und rechnet aus, welches Datum in 100 Tagen ist.
nano datum.js
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
import dayjs from 'dayjs';
const heute = dayjs();
const spaeter = heute.add(100, 'day');
console.log(`Heute: ${heute.format('DD.MM.YYYY')}`);
console.log(`In 100 Tagen: ${spaeter.format('DD.MM.YYYY')}`);
11. Skript ausführen
node datum.js
Prüfen: Es erscheinen zwei Zeilen mit dem heutigen Datum und dem Datum in 100 Tagen.
12. Optional: Bei Änderungen automatisch neu starten
Mit --watch startet Node.js das Skript bei jedem Speichern neu. Das ist praktisch während der Entwicklung. Beenden mit Strg+C.
node --watch datum.js
Wie geht es weiter?
- Interaktiv ausprobieren:
nodeohne Dateiname öffnet eine Eingabezeile für einzelne Anweisungen. Beenden mit.exit. - Neuere Node.js-Version: Wer eine aktuellere Version als 22 braucht, kann mit dem Versionsverwalter
nvmweitere Versionen im eigenen Benutzerordner installieren, ohne die Ubuntu-Pakete zu verändern. - TypeScript: TypeScript ergänzt JavaScript um Typangaben und findet so viele Fehler schon beim Schreiben. Es wird pro Projekt mit
npm install --save-dev typescripteingebunden. - Webserver: Die Anleitung Express.js baut darauf auf.
- Editor: Visual Studio Code unterstützt JavaScript und TypeScript ohne zusätzliche Erweiterung.
Deinstallieren
1. Übungsordner entfernen
Löscht das Projekt samt node_modules.
rm -rf ~/js-uebung
2. Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (siehe Vorbemerkungen).
sudo apt purge nodejs npm
3. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt Pakete auf, die nur für Node.js und npm installiert wurden.
sudo apt autoremove
4. Zwischenspeicher von npm löschen
npm speichert heruntergeladene Pakete in ~/.npm.
rm -rf ~/.npm
Prüfen: Die Meldung lautet node: Befehl nicht gefunden bzw. command not found.
node --version
Quellen und Lizenz
- Offizielle Dokumentation: https://nodejs.org/docs/
- Lizenz: Node.js steht unter der MIT.
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.
Go
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Go ist eine von Google entwickelte, bewusst einfach gehaltene Programmiersprache, die schnell übersetzt und eigenständige Programme ohne Abhängigkeiten erzeugt. Sie ist besonders beliebt für Netzwerkdienste, Kommandozeilenwerkzeuge und Cloud-Software wie Docker oder Kubernetes.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Go 1.26 im Paket
golang-go. Das Paket enthält den Befehlgo, der übersetzt, testet, formatiert und Abhängigkeiten verwaltet. - Module: Jedes Go-Projekt ist ein Modul mit einer Datei
go.mod. Darin stehen der Name des Moduls und die benötigten Bibliotheken. Fremde Bibliotheken lädtgoselbst aus dem Internet; ein eigener Paketmanager ist nicht nötig. - Ordner
~/go: Heruntergeladene Bibliotheken landen in~/go/pkg/mod, mitgo installinstallierte Programme in~/go/bin. - Neuere Version: Wer eine neuere Version als die von Ubuntu braucht, kann Go zusätzlich von der offiziellen Downloadseite nach
/usr/local/goentpacken. Für den Einstieg reicht die apt-Version.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Go installieren
Installiert den Go-Compiler mit allen Werkzeugen und der Standardbibliothek.
sudo apt install golang-go
Prüfen: Die Ausgabe lautet z. B. go version go1.26… linux/amd64. Steht dort eine andere Version, liegt noch eine ältere Installation in /usr/local/go, die im Suchpfad zuerst gefunden wird.
go version
3. Ordner für installierte Programme in den Suchpfad aufnehmen
Programme, die später mit go install installiert werden, liegen in ~/go/bin. Damit die Shell sie findet, kommt dieser Ordner in den Suchpfad. Danach ein neues Terminal öffnen.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an (im Terminal mit Strg+Umschalt+V). Speichere mit Strg+O und Enter und beende nano mit Strg+X:
export PATH="$PATH:$HOME/go/bin"
Prüfen: Im neuen Terminal enthält die Ausgabe /go/bin.
echo $PATH
Erstes Programm
4. Projektordner anlegen
Ein eigener Ordner für das Übungsprojekt.
mkdir -p ~/hallo-go
5. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/hallo-go
6. Modul anlegen
Erzeugt die Datei go.mod. Der Name beispiel/hallo ist frei wählbar; bei veröffentlichten Projekten nimmt man meist die Adresse des Repositorys, z. B. github.com/name/projekt.
go mod init beispiel/hallo
Prüfen: Die Meldung lautet go: creating new go.mod: module beispiel/hallo.
7. Quelltext anlegen
Legt main.go an. Das Programm nummeriert eine Liste und gibt sie danach in einer Zeile aus. Go rückt mit Tabulatoren ein; das Werkzeug gofmt sorgt später automatisch dafür.
nano main.go
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
package main
import (
"fmt"
"strings"
)
func main() {
sprachen := []string{"Go", "Rust", "PHP", "Kotlin", "TypeScript"}
for i, s := range sprachen {
fmt.Printf("%d. %s\n", i+1, s)
}
fmt.Println("Alle:", strings.Join(sprachen, ", "))
}
8. Programm starten
go run . übersetzt das Modul im aktuellen Ordner in einen temporären Ordner und startet es sofort.
go run .
Prüfen: Die Ausgabe lautet:
1. Go
2. Rust
3. PHP
4. Kotlin
5. TypeScript
Alle: Go, Rust, PHP, Kotlin, TypeScript
9. Eigenständiges Programm erzeugen
go build erzeugt die Datei hallo (benannt nach dem letzten Teil des Modulnamens). Sie enthält alles Nötige und läuft auch auf Rechnern ohne Go.
go build
Prüfen: Das Programm liefert dieselbe Ausgabe wie in Schritt 8.
./hallo
10. Quelltext prüfen und formatieren
go vet sucht nach typischen Fehlern, gofmt -l . listet Dateien auf, die nicht einheitlich formatiert sind. Mit gofmt -w . werden sie korrigiert.
go vet ./... && gofmt -l .
Prüfen: Beide Befehle geben nichts aus – der Code ist in Ordnung.
Wie geht es weiter?
- Bibliotheken:
go get <Adresse>fügt eine Bibliothek zugo.modhinzu, z. B.go get github.com/google/uuid.go mod tidyräumt nicht mehr benutzte Einträge auf. - Tests: Dateien mit der Endung
_test.goenthalten Tests;go test ./...führt alle aus. - Andere Systeme: Go übersetzt ohne weitere Werkzeuge auch für andere Plattformen, z. B.
GOOS=windows GOARCH=amd64 go buildfür Windows. - Editor: Visual Studio Code mit der Erweiterung „Go“ bietet Autovervollständigung über das Werkzeug
gopls, das die Erweiterung auf Nachfrage selbst installiert. In Neovim lässt sichgoplsebenfalls einbinden.
Deinstallieren
1. Übungsprojekt entfernen
Löscht den Projektordner.
rm -rf ~/hallo-go
2. Heruntergeladene Bibliotheken löschen
Go legt Bibliotheken schreibgeschützt ab, damit sie nicht versehentlich verändert werden. Deshalb nicht mit rm, sondern mit diesem Befehl entfernen. Er muss vor Schritt 4 laufen, solange go noch installiert ist.
go clean -modcache
3. Zwischenspeicher und Go-Ordner löschen
Entfernt die Übersetzungszwischenstände und den nun leeren Ordner ~/go samt ~/go/bin.
rm -rf ~/go ~/.cache/go-build
4. Go entfernen
Entfernt das Paket golang-go.
sudo apt purge golang-go
5. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt die eigentlichen Versionspakete (z. B. golang-1.26-go) auf, die mit golang-go installiert wurden.
sudo apt autoremove
6. Suchpfad-Eintrag entfernen
Löscht die Zeile aus Schritt 3 der Installation wieder aus ~/.bashrc.
nano ~/.bashrc
Suche mit Strg+W nach go/bin und drücke Enter. Lösche die Zeile export PATH="$PATH:$HOME/go/bin" mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Die Meldung lautet go: Befehl nicht gefunden bzw. command not found.
go version
Quellen und Lizenz
- Offizielle Dokumentation: https://go.dev/doc/
- Lizenz: Go steht unter der BSD-3-Clause.
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.
Rust
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Rust ist eine Programmiersprache für schnelle und zugleich sichere Programme: Der Compiler verhindert schon beim Übersetzen typische Fehler wie ungültige Speicherzugriffe oder gleichzeitige Schreibzugriffe mehrerer Threads. Rust wird für Systemprogramme, Kommandozeilenwerkzeuge, Webdienste und WebAssembly eingesetzt.
Vorbemerkungen
- Compiler und Cargo: Der Compiler heißt
rustc. Im Alltag ruft man ihn aber fast nie selbst auf, sondern nutzt Cargo: Cargo legt Projekte an, lädt Bibliotheken (in Rust Crates genannt) von crates.io, übersetzt, testet und erstellt Dokumentation. - Installation über apt: Ubuntu 26.04 liefert Rust 1.93. Dazu gibt es passende Pakete für die Werkzeuge Clippy (findet verbesserungswürdigen Code) und rustfmt (formatiert Quelltext einheitlich). Für die Anleitung Axum und Actix-web genügt diese Version.
- Alternative rustup: Rust erscheint alle sechs Wochen in einer neuen Version. Wer immer die neueste Version oder mehrere Versionen nebeneinander braucht, installiert Rust mit dem Werkzeug rustup (ebenfalls als apt-Paket vorhanden) in den eigenen Benutzerordner. Beide Wege sollte man nicht mischen; siehe Schritt 4.
- Ordner
~/.cargo: Hier speichert Cargo heruntergeladene Crates und mitcargo installinstallierte Programme (~/.cargo/bin).
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Rust und Cargo installieren
Installiert Compiler und Cargo. Den C-Compiler gcc, den Rust zum Zusammenfügen (Linken) der Programme braucht, installiert apt automatisch mit.
sudo apt install rustc cargo
Prüfen: Die Ausgabe nennt die Version, z. B. rustc 1.93.1.
rustc --version
3. Clippy und rustfmt installieren
Installiert die beiden Werkzeuge, die danach als cargo clippy und cargo fmt aufgerufen werden.
sudo apt install rust-clippy rustfmt
Prüfen:
cargo clippy --version
4. Prüfen, welches Rust gefunden wird
Ist Rust zusätzlich über rustup installiert, liegen dessen Befehle in ~/.cargo/bin und haben meist Vorrang. Dieser Befehl zeigt, welcher cargo tatsächlich benutzt wird.
which cargo
Prüfen: /usr/bin/cargo bedeutet: die Version aus apt. ~/.cargo/bin/cargo bedeutet: die Version aus rustup. Beides funktioniert, die Versionsnummern unterscheiden sich dann aber von denen in dieser Anleitung.
Erstes Programm
5. Projekt anlegen
cargo new erzeugt den Ordner ~/hallo-rust mit der Projektbeschreibung Cargo.toml, dem Quelltext src/main.rs und einem leeren Git-Repository.
cargo new ~/hallo-rust
6. In den Projektordner wechseln
Cargo-Befehle arbeiten immer mit dem Projekt im aktuellen Ordner.
cd ~/hallo-rust
7. Quelltext ersetzen
Überschreibt das vorgegebene „Hello, world!“. Das Programm enthält eine eigene Funktion lange_namen und einen Test dafür, der mit #[test] markiert ist.
nano src/main.rs
Die Datei hat schon Inhalt aus der Vorlage, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
fn lange_namen<'a>(namen: &[&'a str], mindestens: usize) -> Vec<&'a str> {
namen.iter().copied().filter(|n| n.len() >= mindestens).collect()
}
fn main() {
let sprachen = ["Go", "Rust", "PHP", "Kotlin", "TypeScript"];
for (i, s) in sprachen.iter().enumerate() {
println!("{}. {s}", i + 1);
}
println!("Lange Namen: {}", lange_namen(&sprachen, 4).join(", "));
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn filtert_kurze_namen() {
assert_eq!(lange_namen(&["Go", "Rust", "C"], 3), vec!["Rust"]);
}
}
8. Programm übersetzen und starten
cargo run übersetzt das Projekt in den Ordner target/debug und startet es.
cargo run
Prüfen: Nach der Meldung Running target/debug/hallo-rust erscheint:
1. Go
2. Rust
3. PHP
4. Kotlin
5. TypeScript
Lange Namen: Rust, Kotlin, TypeScript
9. Tests ausführen
Übersetzt das Projekt mit den Tests und führt sie aus.
cargo test
Prüfen: Die Ausgabe enthält test tests::filtert_kurze_namen ... ok und test result: ok. 1 passed.
10. Code prüfen lassen
Clippy kennt Hunderte Regeln für besseren Rust-Code und schlägt konkrete Änderungen vor.
cargo clippy
Prüfen: Es erscheinen keine Warnungen (warning: …).
11. Fertiges Programm erstellen
Übersetzt mit allen Optimierungen. Das Ergebnis ist deutlich schneller als die Debug-Fassung und liegt in target/release.
cargo build --release
Prüfen:
./target/release/hallo-rust
Wie geht es weiter?
- Crates hinzufügen:
cargo add <Name>trägt eine Bibliothek inCargo.tomlein, z. B.cargo add rand. Beim nächsten Übersetzen lädt Cargo sie herunter. - Dokumentation offline:
cargo doc --openerzeugt die Dokumentation des eigenen Projekts und aller benutzten Crates und öffnet sie im Browser. - Lernmaterial: Das kostenlose Buch „The Rust Programming Language“ gibt es online auf rust-lang.org; es ist selbst mit mdBook erstellt.
- Editor: Visual Studio Code mit der Erweiterung „rust-analyzer“. Das gleichnamige Werkzeug gibt es auch für Neovim.
- Webanwendungen: Die Anleitung Axum und Actix-web baut darauf auf.
Deinstallieren
1. Übungsprojekt entfernen
Löscht den Projektordner samt target mit allen übersetzten Dateien.
rm -rf ~/hallo-rust
2. Rust-Pakete entfernen
Nur ausführen, wenn Rust auch nicht mehr für andere Projekte gebraucht wird.
sudo apt purge rustc cargo rust-clippy rustfmt
3. Nicht mehr benötigte Abhängigkeiten entfernen
Räumt Bibliotheken auf, die nur für Rust installiert wurden.
sudo apt autoremove
4. Zwischenspeicher von Cargo löschen
Entfernt heruntergeladene Crates. Gelöscht werden bewusst nur diese beiden Unterordner und nicht ganz ~/.cargo: In ~/.cargo/bin liegen Programme, die mit cargo install oder rustup installiert wurden, auf diesem Rechner z. B. mdbook.
rm -rf ~/.cargo/registry ~/.cargo/git
Prüfen: Der Befehl meldet rustc: Befehl nicht gefunden bzw. command not found. Erscheint stattdessen eine Version, stammt sie aus rustup in ~/.cargo/bin.
rustc --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.rust-lang.org/learn
- Lizenz: Rust steht unter der MIT / Apache-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.
PHP
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
PHP ist eine weit verbreitete Skriptsprache für die Webentwicklung. Auf dem Entwicklungsrechner dient sie dazu, serverseitige Skripte auszuführen und dynamische Webanwendungen lokal zu testen.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketversionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. PHP (CLI) installieren
Installiert den PHP-Kommandozeileninterpreter. Damit kannst du PHP-Skripte direkt im Terminal ausführen oder den integrierten Webserver starten.
sudo apt install php-cli
Prüfen: Die Versionsnummer wird angezeigt (unter Ubuntu 26.04 ist dies PHP 8.5).
php -v
3. PHP-FPM für Webserver installieren
Installiert PHP-FPM (FastCGI Process Manager). Dieser Dienst verarbeitet PHP-Anfragen im Hintergrund für Webserver wie nginx.
sudo apt install php-fpm
4. Prüfen, ob der PHP-FPM-Dienst läuft
PHP-FPM läuft als Hintergrunddienst (systemd). Hier siehst du, ob er aktiv ist.
systemctl status php8.5-fpm
Prüfen: In der Ausgabe steht Active: active (running). Mit der Taste q verlässt du die Anzeige.
5. Häufig benötigte Erweiterungen installieren
Die meisten modernen PHP-Projekte und Frameworks (wie Laravel oder Symfony) benötigen zusätzliche Module für Netzwerkabfragen, Textverarbeitung, XML, ZIP-Archive und SQLite-Datenbanken.
sudo apt install php-curl php-mbstring php-xml php-zip php-sqlite3
Prüfen: Listet alle aktiven PHP-Module auf.
php -m
PHP testen
6. Skript auf der Kommandozeile ausführen
Prüft mit einem kurzen Einzeiler, ob der PHP-Interpreter Code fehlerfrei ausführt.
php -r 'echo "PHP funktioniert!\n";'
Prüfen: Im Terminal wird PHP funktioniert! ausgegeben.
7. Integrierten Entwicklungsserver testen
PHP bringt einen schlanken Webserver mit. Damit kannst du Webseiten sofort lokal im Browser testen, ohne einen externen Server konfigurieren zu müssen.
php -S 127.0.0.1:8000
Prüfen: Im Browser unter http://localhost:8000 ist der Server erreichbar. Zum Beenden des Servers drückst du im Terminal Strg + C.
Erstes Programm
8. Arbeitsordner anlegen
Ein eigener Ordner für die Übungsdateien.
mkdir -p ~/php-uebung
9. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/php-uebung
10. Skript anlegen
Legt hallo.php an. Jede PHP-Datei beginnt mit <?php. declare(strict_types=1) sorgt dafür, dass PHP die angegebenen Typen (hier string) streng prüft, statt Werte stillschweigend umzuwandeln. Variablen beginnen in PHP immer mit $.
nano hallo.php
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<?php
declare(strict_types=1);
function begruessung(string $name): string
{
return "Hallo $name!";
}
$sprachen = ['Go', 'Rust', 'PHP', 'Kotlin', 'TypeScript'];
echo begruessung('Ubuntu'), PHP_EOL;
echo 'PHP-Version: ', PHP_VERSION, PHP_EOL;
foreach ($sprachen as $i => $sprache) {
printf("%d. %s\n", $i + 1, $sprache);
}
11. Skript ausführen
Der Interpreter php liest die Datei und führt sie sofort aus.
php hallo.php
Prüfen: Die Ausgabe beginnt mit Hallo Ubuntu! und PHP-Version: 8.5.…, danach folgen fünf nummerierte Zeilen.
12. Syntax prüfen
php -l untersucht eine Datei auf Syntaxfehler, ohne sie auszuführen. Praktisch vor dem Hochladen auf einen Server.
php -l hallo.php
Prüfen: Die Meldung lautet No syntax errors detected in hallo.php.
Bibliotheken mit Composer
Composer ist der Paketmanager für PHP. Er lädt Bibliotheken aus dem Verzeichnis Packagist in den Projektordner vendor und erzeugt eine Datei, die sie automatisch einbindet.
13. Composer installieren
Installiert Composer aus den Ubuntu-Paketquellen.
sudo apt install composer
Prüfen: Die Ausgabe nennt die Version, z. B. Composer version 2.9.5.
composer --version
14. Bibliothek hinzufügen
Installiert als Beispiel ramsey/uuid, eine Bibliothek zum Erzeugen eindeutiger Kennungen. Composer legt dabei composer.json (gewünschte Pakete), composer.lock (genau installierte Versionen) und den Ordner vendor an.
composer require ramsey/uuid
Prüfen: Die Ausgabe enthält Using version ^4.… for ramsey/uuid.
15. Skript mit der Bibliothek anlegen
Legt uuid.php an. Die Zeile mit vendor/autoload.php bindet alle über Composer installierten Bibliotheken ein; use macht die Klasse unter ihrem kurzen Namen verfügbar.
nano uuid.php
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<?php
declare(strict_types=1);
require __DIR__ . '/vendor/autoload.php';
use Ramsey\Uuid\Uuid;
$id = Uuid::uuid4();
echo "Neue ID: $id", PHP_EOL;
echo 'Version: ', $id->getFields()->getVersion(), PHP_EOL;
16. Skript ausführen
php uuid.php
Prüfen: Es erscheint eine zufällige Kennung wie Neue ID: d227883a-79b7-4e80-825f-e60098dc7e3e und darunter Version: 4. Bei jedem Aufruf ist die Kennung eine andere.
Zusammenspiel mit nginx (optional)
Wenn du nginx nach der nginx-Anleitung eingerichtet hast, kannst du PHP über PHP-FPM anbinden.
17. PHP in der nginx-Konfiguration aktivieren
Ergänzt in der bestehenden Konfiguration /etc/nginx/sites-available/dev die Startdatei index.php und den location ~ \.php$-Block für PHP-FPM.
sudo nano /etc/nginx/sites-available/dev
Die Datei hat schon Inhalt, der vollständig ersetzt wird. Lösche ihn zuerst: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K schneidet alles Markierte aus. Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
server {
listen 127.0.0.1:8081;
server_name localhost;
root /var/www/dev;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
}
18. nginx-Konfiguration testen
Stellt sicher, dass die neue Konfiguration fehlerfrei ist.
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful.
19. nginx neu laden
Aktiviert die geänderte Konfiguration im Webserver.
sudo systemctl reload nginx
20. PHP-Testdatei anlegen
Erstellt eine PHP-Informationsseite im Entwicklungsordner /var/www/dev.
nano /var/www/dev/info.php
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<?php phpinfo(); ?>
21. Testseite aufrufen
Fragt die PHP-Testseite über nginx ab.
curl -s http://localhost:8081/info.php | head -n 10
Prüfen: Im Browser siehst du unter http://localhost:8081/info.php die ausführliche PHP-Konfiguration.
Optional: Autostart ausschalten
Auf einem Entwicklungsrechner muss PHP-FPM nicht zwingend bei jedem Rechnerstart im Hintergrund laufen.
Autostart ausschalten:
sudo systemctl disable php8.5-fpm
Bei Bedarf von Hand starten und stoppen:
sudo systemctl start php8.5-fpm
sudo systemctl stop php8.5-fpm
Deinstallieren
1. Testdatei entfernen
Löscht die PHP-Testdatei aus dem Entwicklungsverzeichnis, falls sie angelegt wurde.
rm -f /var/www/dev/info.php
2. Übungsordner entfernen
Löscht die Beispielskripte und den Ordner vendor.
rm -rf ~/php-uebung
3. Composer entfernen
Entfernt Composer sowie seinen Zwischenspeicher und seine Einstellungen im Benutzerordner.
sudo apt purge composer
rm -rf ~/.cache/composer ~/.config/composer
4. PHP und Erweiterungen entfernen
purge entfernt die Pakete sowie deren Konfigurationsdateien unter /etc/php.
sudo apt purge "php*"
5. Nicht mehr benötigte Pakete entfernen
Entfernt Abhängigkeiten und Bibliotheken, die nur für PHP installiert wurden.
sudo apt autoremove
Prüfen: Der PHP-Befehl ist nicht mehr vorhanden.
php -v
Quellen und Lizenz
- Offizielle Dokumentation: https://www.php.net/docs.php
- Lizenz: PHP steht unter der PHP License 3.01.
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.
Kotlin
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Kotlin ist eine moderne Programmiersprache von JetBrains, die auf der Java-Plattform läuft und mit Java-Code direkt zusammenarbeitet. Sie ist die bevorzugte Sprache für Android-Apps und wird zunehmend auch für Serveranwendungen, z. B. mit Spring Boot, eingesetzt.
Vorbemerkungen
- Warum nicht apt? Ubuntu 26.04 enthält zwar ein Paket
kotlin, aber in der sehr alten Version 1.3 von 2019. Viele heutige Sprachmerkmale und Bibliotheken funktionieren damit nicht. Diese Anleitung installiert deshalb den Compiler als Snap, die JetBrains selbst veröffentlicht und aktuell hält (derzeit Kotlin 2.4). - Java wird gebraucht: Kotlin übersetzt Programme in Bytecode für die Java Virtual Machine. Zum Übersetzen und Ausführen braucht man deshalb ein JDK. Das kommt wie in der Anleitung Java aus apt.
- Kommandozeile oder Gradle: Für einzelne Dateien und zum Lernen reicht der Kommandozeilen-Compiler
kotlinc. Größere Projekte baut man mit Gradle, das meist von der Entwicklungsumgebung mitgebracht wird. Auch das Gradle-Paket von Ubuntu ist stark veraltet und wird hier nicht verwendet. - Entwicklungsumgebung: IntelliJ IDEA stammt ebenfalls von JetBrains und unterstützt Kotlin ohne Erweiterung am besten. Neue Kotlin-Projekte legt man dort mit dem Assistenten an; er richtet Gradle automatisch ein.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. JDK installieren
Installiert OpenJDK 25, das Kotlin zum Übersetzen und Ausführen braucht. Ist es aus der Anleitung Java schon vorhanden, meldet apt das nur.
sudo apt install default-jdk
Prüfen: Die Ausgabe beginnt mit openjdk version "25…".
java -version
3. Kotlin-Compiler als Snap installieren
Installiert die Befehle kotlinc (Compiler) und kotlin (startet Programme und Skripte). Der Schalter --classic ist nötig, weil der Compiler auf das JDK und auf Dateien außerhalb der Snap-Umgebung zugreifen muss.
sudo snap install kotlin --classic
Prüfen: Die Ausgabe nennt die Version, z. B. info: kotlinc-jvm 2.4.20 (JRE 25…).
kotlinc -version
Erstes Programm
4. Arbeitsordner anlegen
Ein eigener Ordner für die Übungsdateien.
mkdir -p ~/kotlin-uebung
5. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/kotlin-uebung
6. Quelltext anlegen
Legt hallo.kt an. Eine data class ist eine Klasse, die nur Daten hält; Kotlin erzeugt dafür Vergleich, Textausgabe und Kopierfunktion automatisch. sortedBy und maxBy arbeiten mit einer kurzen Funktion in geschweiften Klammern, in der it für das jeweilige Element steht.
nano hallo.kt
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
data class Sprache(val name: String, val jahr: Int)
fun main() {
val sprachen = listOf(
Sprache("Java", 1995),
Sprache("Kotlin", 2016),
Sprache("Go", 2009),
)
for (s in sprachen.sortedBy { it.jahr }) {
println("${s.name} (${s.jahr})")
}
val neueste = sprachen.maxBy { it.jahr }
println("Am neuesten: ${neueste.name}")
}
7. Programm übersetzen
Übersetzt den Quelltext in die Datei hallo.jar. Der Schalter -include-runtime packt die Kotlin-Standardbibliothek mit hinein, damit das Programm später mit dem gewöhnlichen Befehl java läuft. Das Übersetzen dauert einige Sekunden.
kotlinc hallo.kt -include-runtime -d hallo.jar
Prüfen: Im Ordner liegt jetzt hallo.jar.
ls -l hallo.jar
8. Programm starten
Startet das Programm mit der Java-Laufzeitumgebung. Kotlin selbst muss auf dem Zielrechner nicht installiert sein.
java -jar hallo.jar
Prüfen: Die Sprachen erscheinen nach Erscheinungsjahr sortiert:
Java (1995)
Go (2009)
Kotlin (2016)
Am neuesten: Kotlin
Kotlin-Skripte
9. Skript anlegen
Dateien mit der Endung .main.kts sind Skripte: Die Anweisungen stehen direkt in der Datei, eine Funktion main ist nicht nötig. Das eignet sich für kleine Hilfsprogramme.
nano rechnen.main.kts
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
val zahlen = (1..10).toList()
println("Summe: ${zahlen.sum()}")
println("Gerade Zahlen: ${zahlen.filter { it % 2 == 0 }}")
10. Skript ausführen
Der Befehl kotlin übersetzt das Skript im Hintergrund und führt es sofort aus.
kotlin rechnen.main.kts
Prüfen: Die Ausgabe lautet:
Summe: 55
Gerade Zahlen: [2, 4, 6, 8, 10]
Wie geht es weiter?
- Projekte mit Gradle: In IntelliJ IDEA über File → New → Project → Kotlin ein Projekt mit „Gradle“ als Build-System anlegen. Das Projekt enthält dann ein Startskript
./gradlew, das die passende Gradle-Version selbst herunterlädt;./gradlew runstartet das Programm. - Interaktiv ausprobieren:
kotlincohne weitere Angaben öffnet eine Eingabezeile für einzelne Anweisungen. Beenden mit:quit. - Aktualisierungen: Snaps werden automatisch im Hintergrund aktualisiert. Wer bei einer Hauptversion bleiben möchte, wechselt den Kanal, z. B.
sudo snap refresh kotlin --channel=2.4/stable. - Serveranwendungen: Spring Boot unterstützt Kotlin als gleichwertige Alternative zu Java.
Deinstallieren
1. Übungsordner entfernen
Löscht die Beispieldateien.
rm -rf ~/kotlin-uebung
2. Kotlin-Snap entfernen
Entfernt den Compiler. --purge löscht dabei auch die automatische Sicherung, die snap sonst beim Entfernen anlegt.
sudo snap remove --purge kotlin
3. Optional: JDK entfernen
Nur ausführen, wenn Java auch nicht mehr gebraucht wird, z. B. für die Anleitungen Java oder Spring Boot. Die genauen Schritte stehen im Abschnitt „Deinstallieren“ der Anleitung Java.
sudo apt purge default-jdk default-jdk-headless openjdk-25-jdk openjdk-25-jdk-headless
sudo apt autoremove
Prüfen: Die Meldung lautet kotlinc: Befehl nicht gefunden bzw. command not found.
kotlinc -version
Quellen und Lizenz
- Offizielle Dokumentation: https://kotlinlang.org/docs/home.html
- Lizenz: Kotlin steht unter der Apache-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.
TypeScript
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
TypeScript ist JavaScript mit Typangaben: Man legt fest, welche Art von Werten Variablen und Funktionen erwarten, und der Compiler meldet Fehler, bevor das Programm überhaupt läuft. Heraus kommt gewöhnliches JavaScript, das in jedem Browser und in Node.js läuft.
Vorbemerkungen
- Grundlage: TypeScript baut auf JavaScript auf und braucht Node.js mit npm. Die Anleitung installiert beides aus den Ubuntu-Paketquellen (Node.js 22).
- Pro Projekt über npm: Ubuntu enthält zwar das Paket
node-typescript, aber nur in Version 5.2 von 2023. Üblich und empfohlen ist, TypeScript pro Projekt mit npm zu installieren. Dann legt jedes Projekt seine TypeScript-Version selbst fest, und alle Beteiligten übersetzen mit derselben. Aktuell ist TypeScript 7, dessen Compiler für deutlich kürzere Übersetzungszeiten neu geschrieben wurde. - Compiler
tsc: Er prüft die Typen und erzeugt aus.ts-Dateien.js-Dateien. Die Einstellungen stehen in der Dateitsconfig.json. - Direkt ausführen: Node.js kann
.ts-Dateien auch ohne Übersetzen starten, indem es die Typangaben einfach entfernt. Die Typen prüft dabei aber niemand; dafür bleibttsczuständig.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen aus den Ubuntu-Paketquellen kennt.
sudo apt update
2. Node.js und npm installieren
Installiert die Laufzeitumgebung und den Paketmanager. Sind sie aus einer anderen Anleitung schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe beginnt mit v22..
node --version
Erstes Projekt
3. Projektordner anlegen
Ein eigener Ordner für das Übungsprojekt, mit Unterordner src für den Quelltext.
mkdir -p ~/hallo-ts/src
4. In den Ordner wechseln
Alle folgenden Befehle beziehen sich auf diesen Ordner.
cd ~/hallo-ts
5. npm-Projekt anlegen
Erzeugt package.json und stellt das Projekt auf ES-Module (import … from …) um.
npm init -y && npm pkg set type=module
6. TypeScript installieren
Installiert den Compiler und die Typbeschreibungen für Node.js (z. B. für process) als Entwicklungsabhängigkeit (--save-dev). Sie werden nur beim Entwickeln gebraucht, nicht im fertigen Programm.
npm install --save-dev typescript @types/node
Prüfen: npx startet den Compiler aus node_modules des Projekts. Die Ausgabe lautet z. B. Version 7.0.2.
npx tsc --version
7. Compiler-Einstellungen anlegen
Legt tsconfig.json an. Die wichtigsten Angaben:
rootDir/outDir– TypeScript-Quelltext liegt insrc, das erzeugte JavaScript landet indist.module: nodenext– Module so behandeln, wie Node.js es tut.strict– alle strengen Prüfungen einschalten; für neue Projekte dringend empfohlen.
nano tsconfig.json
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
{
"compilerOptions": {
"target": "es2023",
"module": "nodenext",
"rootDir": "src",
"outDir": "dist",
"strict": true,
"types": ["node"]
}
}
8. Quelltext anlegen
Legt src/hallo.ts an. Das interface beschreibt, wie ein Eintrag aussehen muss; die Funktion beschreibe nimmt nur solche Einträge an und gibt garantiert einen Text zurück.
nano src/hallo.ts
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
interface Sprache {
name: string;
jahr: number;
}
const sprachen: Sprache[] = [
{ name: 'Go', jahr: 2009 },
{ name: 'Rust', jahr: 2015 },
{ name: 'TypeScript', jahr: 2012 },
];
function beschreibe(s: Sprache): string {
return `${s.name} erschien ${s.jahr}.`;
}
for (const s of sprachen) {
console.log(beschreibe(s));
}
console.log(`Node.js ${process.version}`);
9. Übersetzen
tsc liest tsconfig.json, prüft alle Typen und schreibt das Ergebnis nach dist.
npx tsc
Prüfen: Der Befehl gibt nichts aus, und die Datei dist/hallo.js ist entstanden.
ls dist
10. Programm starten
Führt das erzeugte JavaScript mit Node.js aus.
node dist/hallo.js
Prüfen: Die Ausgabe lautet:
Go erschien 2009.
Rust erschien 2015.
TypeScript erschien 2012.
Node.js v22.…
11. Typprüfung ausprobieren
Ändert absichtlich die Jahreszahl von Rust in einen Text ('2015' statt 2015) und übersetzt erneut.
nano src/hallo.ts
Suche mit Strg+W nach 2015 und drücke Enter. Setze die Zahl in Anführungszeichen. Ändere die gefundene Zeile so, dass sie lautet:
{ name: 'Rust', jahr: '2015' },
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Dann erneut übersetzen:
npx tsc
Prüfen: Der Compiler bricht ab mit src/hallo.ts(8,19): error TS2322: Type 'string' is not assignable to type 'number'. Genau solche Fehler würden in reinem JavaScript erst beim Ausführen – oder gar nicht – auffallen.
12. Fehler wieder beheben
Stellt die Zahl wieder her.
nano src/hallo.ts
Suche mit Strg+W nach 2015 und drücke Enter. Entferne die Anführungszeichen wieder. Ändere die gefundene Zeile so, dass sie lautet:
{ name: 'Rust', jahr: 2015 },
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Dann erneut übersetzen:
npx tsc
Prüfen: Der Befehl läuft wieder ohne Meldung durch.
13. Optional: Direkt ausführen
Node.js entfernt die Typangaben und startet den Quelltext ohne dist. Je nach Node.js-Version erscheint dazu ein Hinweis ExperimentalWarning: Type Stripping…, der sich ignorieren lässt.
node src/hallo.ts
Wie geht es weiter?
- Laufend prüfen:
npx tsc --watchübersetzt bei jedem Speichern neu und zeigt Fehler sofort an. - Skripte in package.json: Mit
npm pkg set scripts.build=tscgenügt künftignpm run build. - Webentwicklung: Werkzeuge wie Vite, VitePress, Astro Starlight und Docusaurus verstehen TypeScript ohne weitere Einrichtung. Auch Express.js lässt sich mit TypeScript nutzen.
- Editor: Visual Studio Code ist selbst in TypeScript geschrieben und zeigt Typfehler schon beim Tippen an.
Deinstallieren
1. Übungsprojekt entfernen
Löscht das Projekt samt node_modules. Weil TypeScript nur in diesem Projekt installiert war, ist es damit vollständig entfernt.
rm -rf ~/hallo-ts
2. Optional: Node.js und npm entfernen
Nur ausführen, wenn kein anderes Programm Node.js braucht (siehe Anleitung JavaScript).
sudo apt purge nodejs npm
sudo apt autoremove
Prüfen: Der Projektordner existiert nicht mehr (Datei oder Verzeichnis nicht gefunden).
ls ~/hallo-ts
Quellen und Lizenz
- Offizielle Dokumentation: https://www.typescriptlang.org/docs/
- Lizenz: TypeScript steht unter der Apache-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.
Ruby
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ruby ist eine Skriptsprache, die auf gut lesbaren Code ausgelegt ist: Alles ist ein Objekt, Blöcke mit do … end machen Schleifen und Rückrufe kurz, und vieles liest sich fast wie englischer Text. Bekannt wurde Ruby vor allem durch das Webframework Ruby on Rails. Ruby wird aber auch für Werkzeuge wie Jekyll und Asciidoctor und für kleine Skripte verwendet.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Ruby 3.3 im Paket
ruby. Es bringt den Interpreterruby, die interaktive Konsoleirbund den Paketmanagergemmit. - Gems und Bundler: Bibliotheken heißen in Ruby Gems und kommen von https://rubygems.org. In Projekten legt man die benötigten Gems in einer Datei
Gemfilefest und installiert sie mit Bundler. Bundler steckt im eigenen Paketbundler, das auch die Dateien zum Übersetzen von Gems mit C-Anteilen mitbringt. - Gems im Projektordner: Ohne
sudodarfgemnicht in die Systemordner schreiben. Diese Anleitung installiert Gems deshalb in den Projektordner. So bleibt das System sauber, und jedes Projekt hat genau seine Versionen. - Neuere Ruby-Versionen: Wer Ruby 3.4 oder neuer braucht, kann es mit Versionsverwaltern wie
rbenvodermiseim Home-Ordner übersetzen. Für den Einstieg reicht die Version von Ubuntu. - Version: Getestet mit Ruby 3.3.8, RubyGems 3.6 und Bundler 2.6 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Ruby installieren
Installiert Ruby mit irb, gem und den mitgelieferten Standardbibliotheken.
sudo apt install ruby
Prüfen: Die Ausgabe beginnt mit ruby 3.3.8.
ruby --version
3. Bundler installieren
Installiert Bundler für Projekte mit eigenen Gems. apt zieht dabei ruby-dev mit, die Dateien zum Übersetzen von Gems mit C-Anteilen.
sudo apt install bundler
Prüfen: Die Ausgabe lautet Bundler version 2.6.7 oder nennt eine neuere Version.
bundle --version
Erstes Programm
4. Arbeitsordner anlegen
Ein eigener Ordner für die Übungen.
mkdir ~/hallo-ruby
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo-ruby
6. Skript anlegen
nano hallo.rb
Füge diesen Inhalt ein (Strg+Umschalt+V):
# Ein kleines Ruby-Programm: Begrüßung und eine Liste
name = ARGV.first || "Welt"
puts "Hallo #{name}!"
sprachen = ["Ruby", "Python", "Go"]
sprachen.each_with_index do |sprache, i|
puts "#{i + 1}. #{sprache} hat #{sprache.length} Buchstaben"
end
ARGVenthält die Werte, die man beim Aufruf hinter den Dateinamen schreibt.|| "Welt"nimmt"Welt", wenn keiner angegeben ist.#{…}setzt einen Wert in einen Text ein. Das funktioniert nur in doppelten Anführungszeichen.each_with_index do |sprache, i| … endist ein Block: Ruby führt ihn für jedes Element der Liste einmal aus und übergibt Element und Position.sprache.lengthzeigt, dass auch ein Text ein Objekt mit Methoden ist.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Skript ausführen
ruby hallo.rb
Prüfen: Die Ausgabe lautet:
Hallo Welt!
1. Ruby hat 4 Buchstaben
2. Python hat 6 Buchstaben
3. Go hat 2 Buchstaben
Mit ruby hallo.rb Thorsten lautet die erste Zeile Hallo Thorsten!.
8. Interaktive Konsole ausprobieren
irb (Interactive Ruby) führt jede eingegebene Zeile sofort aus und zeigt das Ergebnis. Das eignet sich zum Ausprobieren von Methoden.
irb
Gib nacheinander ein und drücke jeweils Enter:
"ruby".upcase
[3, 1, 2].sort
Prüfen: Nach => zeigt irb die Ergebnisse "RUBY" und [1, 2, 3]. Beende irb mit exit.
Projekt mit Gems
9. Gemfile anlegen
bundle init legt eine leere Datei Gemfile an. Darin stehen später alle Gems des Projekts.
bundle init
Prüfen: Die Ausgabe lautet Writing new Gemfile to /home/…/hallo-ruby/Gemfile.
10. Gems im Projektordner ablegen
Stellt Bundler für dieses Projekt so ein, dass es Gems in den Unterordner vendor/bundle installiert. --local speichert die Einstellung in .bundle/config im Projektordner, sie gilt also nur hier.
bundle config set --local path vendor/bundle
11. Gem hinzufügen
bundle add trägt das Gem rainbow in das Gemfile ein und installiert es. Rainbow färbt Text im Terminal ein.
bundle add rainbow
Prüfen: Die Ausgabe enthält Installing rainbow 3.1.1 oder eine neuere Version. Im Gemfile steht jetzt die Zeile gem "rainbow", "~> 3.1", und die Datei Gemfile.lock hält die genaue Version fest.
cat Gemfile
12. Skript mit dem Gem anlegen
nano farbe.rb
Füge diesen Inhalt ein:
require "rainbow"
puts Rainbow("Hallo in Grün!").green
puts Rainbow("Und fett in Rot").red.bright
require lädt das Gem. Die Methoden green, red und bright hängt man aneinander, jede gibt wieder einen Text zurück.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Skript mit Bundler ausführen
bundle exec startet das Skript so, dass Ruby die Gems aus vendor/bundle findet, und zwar genau in den Versionen aus Gemfile.lock. Ein einfaches ruby farbe.rb würde mit cannot load such file -- rainbow abbrechen.
bundle exec ruby farbe.rb
Prüfen: Die erste Zeile erscheint grün, die zweite hell in Rot. Leitet man die Ausgabe in eine Datei um, lässt Rainbow die Farben weg.
Wie geht es weiter?
- Formatieren und Prüfen: Das Gem
rubocopprüft Ruby-Code auf Fehler und Stil. Man fügt es mitbundle add rubocop --group developmenthinzu und startet es mitbundle exec rubocop. - Tests: Ruby bringt
minitestmit. Beliebt ist auchrspec, das Tests fast wie Sätze formuliert. - Webanwendungen: Ruby on Rails ist das große Framework für Webanwendungen. Kleiner ist Sinatra, bei dem eine Route nur eine Zeile braucht.
- Dokumentation:
ri String#upcasezeigt die Beschreibung einer Methode im Terminal an, wenn das Paketriinstalliert ist.
Deinstallieren
1. Übungsordner entfernen
Löscht den Übungsordner samt der Gems in vendor/bundle.
rm -rf ~/hallo-ruby
2. Ruby und Bundler entfernen
Nur ausführen, wenn kein anderes Programm Ruby braucht, z. B. Jekyll, Asciidoctor oder Ruby on Rails.
sudo apt purge ruby bundler
3. Nicht mehr benötigte Pakete entfernen
Entfernt die Pakete, die nur für Ruby und Bundler mitinstalliert wurden, z. B. ruby3.3 und ruby-dev. Der Befehl entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
4. Zwischenspeicher von Bundler entfernen (optional)
Bundler speichert in ~/.bundle/cache das Verzeichnis der verfügbaren Gems von rubygems.org, damit spätere Aufrufe schneller sind. Der Befehl löscht den Ordner ~/.bundle. Bundler legt ihn beim nächsten Aufruf in einem Projekt neu an.
rm -rf ~/.bundle
Prüfen: Die Shell meldet, dass der Befehl ruby nicht gefunden wurde.
ruby --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.ruby-lang.org/de/documentation/
- Lizenz: Ruby steht unter der 2-Clause BSDL / Ruby License.
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.
Crystal
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Crystal ist eine übersetzte Programmiersprache mit einer Schreibweise, die stark an Ruby erinnert. Anders als Ruby prüft Crystal alle Typen schon beim Übersetzen, erkennt sie aber fast immer selbst, sodass man sie selten hinschreiben muss. Heraus kommen schnelle Programme in Maschinencode, gebaut mit LLVM.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Crystal 1.18. Mit den empfohlenen Entwicklerbibliotheken, die Teile der Standardbibliothek brauchen (z. B. für XML, YAML oder verschlüsselte Verbindungen), sind das 14 Pakete.
- Ohne shards: Der Paketmanager
shards, mit dem man fremde Bibliotheken einbindet, ist nicht in den Ubuntu-Paketquellen. Diese Anleitung kommt ohne ihn aus, weil sie nur die Standardbibliothek verwendet. Sie enthält schon vieles, etwa JSON, HTTP und Tests. - Version: Getestet mit Crystal 1.18.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Crystal installieren
sudo apt install crystal
Prüfen: Die erste Zeile lautet Crystal 1.18.2 (2025-11-25).
crystal --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/crystal-uebung
4. In den Ordner wechseln
cd ~/crystal-uebung
5. Quelltext anlegen
nano lager.cr
Füge diesen Inhalt ein (Strg+Umschalt+V):
record Fahrrad, modell : String, preis : Int32, anzahl : Int32 do
def status
anzahl > 0 ? "#{anzahl} auf Lager" : "ausverkauft"
end
end
bestand = [
Fahrrad.new("Citybike", 699, 4),
Fahrrad.new("Trekkingrad", 899, 0),
Fahrrad.new("Lastenrad", 3490, 1),
]
bestand.each_with_index(1) do |rad, nummer|
puts "#{nummer}. #{rad.modell.ljust(12)} #{rad.preis.to_s.rjust(5)} Euro, #{rad.status}"
end
lieferbar = bestand.select { |rad| rad.anzahl > 0 }.map(&.modell)
puts "Sofort lieferbar: #{lieferbar.join(", ")}"
puts "Lagerwert: #{bestand.sum { |rad| rad.preis * rad.anzahl }} Euro"
record– legt kurz einen unveränderlichen Datentyp mit festen Feldern an.StringundInt32sind die Typen der Felder. Imdo-Block stehen eigene Methoden.def status– eine Methode ohne Klammern. Der letzte Ausdruck ist das Ergebnis."#{…}"– setzt Werte in einen Text ein.ljustundrjustfüllen auf eine feste Breite auf.each_with_index(1)– geht die Liste durch und zählt dabei ab 1.select,map,sum– filtern, umformen, zusammenzählen.&.modellist die Kurzform für{ |rad| rad.modell }.- Typen erkennen –
bestandist ohne Angabe einArray(Fahrrad). Crystal weiß das und prüft jeden Zugriff.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen und starten
crystal run übersetzt und startet in einem Schritt.
crystal run lager.cr
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
7. Eigenständiges Programm erzeugen
--release schaltet die Optimierungen ein. Das Übersetzen dauert dadurch etwas länger.
crystal build --release lager.cr
Prüfen: Im Ordner liegt das Programm lager, knapp 1 MB groß. Es liefert dieselbe Ausgabe wie in Schritt 6.
./lager
Ein Projekt mit Tests
8. In das Home-Verzeichnis wechseln
cd ~
9. Projekt anlegen
crystal init app legt den Ordner umsatz mit der Projektbeschreibung shard.yml, dem Quelltext in src und Tests in spec an. Außerdem richtet es ein Git-Repository ein und übernimmt Name und E-Mail aus den Git-Einstellungen.
crystal init app umsatz
Prüfen: Die Meldungen nennen unter anderem create … src/umsatz.cr und create … spec/umsatz_spec.cr.
10. In den Projektordner wechseln
cd ~/umsatz
11. Modul schreiben
Das Modul enthält die eigentliche Rechnung. Das Programm, das Dateien liest, kommt in eine eigene Datei. So können die Tests das Modul laden, ohne das Programm zu starten.
nano src/umsatz.cr
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
require "json"
module Umsatz
VERSION = "0.1.0"
# Zählt den Umsatz je Modell zusammen.
# Jede Zeile hat die Form "Modell;Anzahl;Preis".
def self.summen(zeilen : Array(String)) : Hash(String, Int32)
ergebnis = Hash(String, Int32).new(0)
zeilen.each do |zeile|
modell, anzahl, preis = zeile.split(';')
ergebnis[modell] += anzahl.to_i * preis.to_i
end
ergebnis
end
end
def self.summen– eine Methode des Moduls, aufrufbar alsUmsatz.summen.- Typangaben –
zeilen : Array(String)und: Hash(String, Int32)legen Parameter und Ergebnis fest. Hier sind sie zur Dokumentation hingeschrieben, Crystal prüft sie beim Übersetzen. Hash(String, Int32).new(0)– ein Wörterbuch, das für fehlende Schlüssel 0 liefert. Deshalb funktioniert+=sofort.modell, anzahl, preis = …– verteilt die drei Teile der Zeile auf drei Variablen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm schreiben
nano src/cli.cr
Die Datei ist neu. Füge diesen Inhalt ein:
require "./umsatz"
if ARGV.size != 1
STDERR.puts "Aufruf: umsatz DATEI"
exit 1
end
tabelle = Umsatz.summen(File.read_lines(ARGV[0]))
tabelle.to_a.sort_by { |_, betrag| -betrag }.each do |modell, betrag|
puts "#{modell.ljust(12)} #{betrag.to_s.rjust(5)} Euro"
end
File.write("umsatz.json", tabelle.to_json)
puts "Gespeichert: umsatz.json"
ARGV– die Argumente beim Aufruf.exit 1beendet mit dem Rückgabewert 1.File.read_lines– liest eine Datei als Liste von Zeilen.sort_by { |_, betrag| -betrag }– sortiert nach dem Umsatz, das Minus kehrt die Reihenfolge um.to_json– kommt ausrequire "json"im Modul und schreibt das Wörterbuch als JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Test schreiben
nano spec/umsatz_spec.cr
Lösche den bisherigen Inhalt und füge diesen ein:
require "./spec_helper"
describe Umsatz do
it "zählt den Umsatz je Modell zusammen" do
summen = Umsatz.summen(["A;2;10", "B;1;50", "A;1;10"])
summen["A"].should eq(30)
summen["B"].should eq(50)
summen.size.should eq(2)
end
end
describe fasst Tests zusammen, it beschreibt einen Test, should eq prüft einen Wert. Die Datei spec_helper.cr aus der Vorlage lädt das Modul.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Tests ausführen
crystal spec
Prüfen: Die letzte Zeile lautet 1 examples, 0 failures, 0 errors, 0 pending.
15. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Programm bauen
-o umsatz legt den Namen des Programms fest.
crystal build --release src/cli.cr -o umsatz
17. Programm starten
./umsatz verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}.
18. Typprüfung ausprobieren (optional)
Ändere in src/cli.cr den Aufruf Umsatz.summen(File.read_lines(ARGV[0])) in Umsatz.summen(File.read(ARGV[0])). File.read liefert einen einzigen Text statt einer Liste von Zeilen. Übersetze dann neu wie in Schritt 16.
Prüfen: Crystal bricht ab mit Error: expected argument #1 to 'Umsatz.summen' to be Array(String), not String. Der Fehler fällt also schon beim Übersetzen auf, nicht erst, wenn das Programm läuft. Mache die Änderung danach wieder rückgängig.
Wie geht es weiter?
- Code formatieren:
crystal tool formatbringt alle Dateien in die übliche Form,crystal tool format --checkprüft nur. - Webserver: Die Standardbibliothek enthält
HTTP::Server. Ein kleiner Webdienst braucht damit keine fremden Bibliotheken. - Fremde Bibliotheken: Dafür braucht man
shards. Es ist nicht bei Ubuntu enthalten, lässt sich aber aus dem Quelltext unter https://github.com/crystal-lang/shards bauen. Bibliotheken trägt man dann inshard.ymlunterdependenciesein. - Dokumentation: Sprachbeschreibung und Referenz unter https://crystal-lang.org/reference/, die Standardbibliothek unter https://crystal-lang.org/api/.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/crystal-uebung ~/umsatz
2. Zwischenspeicher entfernen
Crystal legt übersetzte Zwischenstände in ~/.cache/crystal ab.
rm -rf ~/.cache/crystal
3. Crystal entfernen
sudo apt purge crystal
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Crystal mitinstalliert wurden, z. B. LLVM 19 und die Entwicklerbibliotheken. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl crystal wird nicht mehr gefunden.
crystal --version
Quellen und Lizenz
- Offizielle Dokumentation: https://crystal-lang.org/reference/
- Lizenz: Crystal steht unter der Apache-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.
Elixir
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Elixir ist eine funktionale Programmiersprache, die auf der virtuellen Maschine von Erlang (BEAM) läuft. Programme bestehen aus vielen leichtgewichtigen Prozessen, die sich Nachrichten schicken und von Supervisoren überwacht werden. Elixir eignet sich deshalb besonders für Server mit vielen gleichzeitigen Verbindungen. Das bekannteste Webframework ist Phoenix.
Vorbemerkungen
- Aus den Paketquellen: Ubuntu 26.04 enthält Elixir 1.18 und Erlang/OTP 27. Das Paket
elixirzieht die nötigen Teile von Erlang selbst mit und bringt die Befehleelixir,iex(interaktive Konsole) undmix(Build-Werkzeug) mit. - Hex: Bibliotheken für Elixir kommen von https://hex.pm. Den Paketmanager Hex installiert
mixeinmalig für den eigenen Benutzer nach~/.mix, heruntergeladene Pakete landen in~/.hex. - Unveränderliche Daten: In Elixir ändert man Werte nicht, sondern erzeugt neue. Schleifen schreibt man als Rekursion oder mit Funktionen aus dem Modul
Enum. Das Beispiel zeigt beides. - Version: Getestet mit Elixir 1.18.3, Erlang/OTP 27 und Hex 2.5.1 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Elixir installieren
Installiert Elixir samt den nötigen Erlang-Paketen.
sudo apt install elixir
Prüfen: Die letzte Zeile lautet Elixir 1.18.3 (compiled with Erlang/OTP 27).
elixir --version
Erstes Programm
3. Arbeitsordner anlegen
Ein eigener Ordner für die Übungen.
mkdir ~/hallo-elixir
4. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo-elixir
5. Skript anlegen
Dateien mit der Endung .exs sind Elixir-Skripte. Sie werden beim Start übersetzt und sofort ausgeführt.
nano hallo.exs
Füge diesen Inhalt ein (Strg+Umschalt+V):
# Ein kleines Elixir-Skript: Begrüßung und eine Liste
name = List.first(System.argv()) || "Welt"
IO.puts("Hallo #{name}!")
["Elixir", "Erlang", "Go"]
|> Enum.with_index(1)
|> Enum.each(fn {sprache, nr} ->
IO.puts("#{nr}. #{sprache} hat #{String.length(sprache)} Buchstaben")
end)
System.argv()enthält die Werte, die man beim Aufruf hinter den Dateinamen schreibt.|| "Welt"nimmt"Welt", wenn keiner angegeben ist.#{…}setzt einen Wert in einen Text ein.|>ist der Pipe-Operator: Er gibt das Ergebnis links als ersten Wert an die Funktion rechts weiter. Die Liste läuft so von oben nach unten durchEnum.with_index(Nummern ab 1 anhängen) undEnum.each(für jedes Element etwas tun).fn {sprache, nr} -> … endist eine namenlose Funktion.{sprache, nr}zerlegt dabei jedes Paar aus Wert und Nummer in zwei Variablen (Mustervergleich).
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Skript ausführen
elixir hallo.exs
Prüfen: Die Ausgabe lautet:
Hallo Welt!
1. Elixir hat 6 Buchstaben
2. Erlang hat 6 Buchstaben
3. Go hat 2 Buchstaben
Mit elixir hallo.exs Thorsten lautet die erste Zeile Hallo Thorsten!.
7. Interaktive Konsole ausprobieren
iex (Interactive Elixir) führt jede eingegebene Zeile sofort aus und zeigt das Ergebnis.
iex
Gib nacheinander ein und drücke jeweils Enter:
String.upcase("elixir")
Enum.map([1, 2, 3], fn x -> x * x end)
Prüfen: iex zeigt die Ergebnisse "ELIXIR" und [1, 4, 9]. Mit h String.upcase zeigt iex die Beschreibung einer Funktion an. Beende iex mit zweimal Strg+C.
Projekt mit mix
8. Projekt anlegen
mix new legt ein Projekt mit Quellordner lib, Testordner test und der Projektdatei mix.exs an.
mix new rechner
Prüfen: Die Ausgabe endet mit Your Mix project was created successfully.
9. In den Projektordner wechseln
cd ~/hallo-elixir/rechner
10. Modul schreiben
nano lib/rechner.ex
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
defmodule Rechner do
@moduledoc """
Kleine Rechenfunktionen für Listen von Zahlen.
"""
@doc """
Addiert alle Zahlen einer Liste.
## Beispiele
iex> Rechner.summe([1, 2, 3])
6
iex> Rechner.summe([])
0
"""
def summe([]), do: 0
def summe([kopf | rest]), do: kopf + summe(rest)
@doc """
Berechnet den Durchschnitt. Eine leere Liste ergibt einen Fehler-Tupel.
## Beispiele
iex> Rechner.durchschnitt([2, 4, 6])
{:ok, 4.0}
iex> Rechner.durchschnitt([])
{:error, :leere_liste}
"""
def durchschnitt([]), do: {:error, :leere_liste}
def durchschnitt(zahlen), do: {:ok, summe(zahlen) / length(zahlen)}
end
- Mehrere Fassungen einer Funktion:
summegibt es zweimal. Elixir nimmt die erste, deren Muster passt:[]für die leere Liste, sonst[kopf | rest], das die Liste in erstes Element und Rest zerlegt. So entsteht eine Schleife durch Rekursion. - Tupel mit
:okund:error: Statt eine Ausnahme auszulösen, geben Elixir-Funktionen oft{:ok, wert}oder{:error, grund}zurück. Wörter mit Doppelpunkt wie:oksind Atome, feste Namen. - Dokumentation mit Beispielen: Die Zeilen mit
iex>in@docsind zugleich Tests (Doctests), siehe nächster Schritt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Test schreiben
nano test/rechner_test.exs
Ersetze den ganzen Inhalt wie in Schritt 10 und füge ein:
defmodule RechnerTest do
use ExUnit.Case
# Führt die Beispiele aus der Dokumentation als Tests aus
doctest Rechner
test "summe mit negativen Zahlen" do
assert Rechner.summe([5, -2, -3]) == 0
end
end
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Tests ausführen
mix test übersetzt das Projekt und führt alle Tests mit dem eingebauten Testwerkzeug ExUnit aus.
mix test
Prüfen: Die Ausgabe endet mit 4 doctests, 1 test, 0 failures. Die vier Doctests sind die Beispiele aus Schritt 10.
13. Projekt in iex laden
iex -S mix startet die Konsole mit übersetztem Projekt. So lassen sich eigene Funktionen direkt aufrufen.
iex -S mix
Gib ein und drücke Enter:
Rechner.summe([10, 20, 30])
Prüfen: Die Ausgabe lautet 60. Beende iex mit zweimal Strg+C.
Bibliotheken von Hex
14. Hex installieren
Installiert den Paketmanager Hex für den eigenen Benutzer. --force beantwortet die Rückfrage mit Ja. Ohne diesen Schritt fragt mix beim ersten Laden einer Bibliothek selbst Shall I install Hex?.
mix local.hex --force
Prüfen: Die Ausgabe lautet * creating /home/…/.mix/archives/hex-2.5.1 oder nennt eine neuere Version.
15. Bibliothek eintragen
Abhängigkeiten stehen in mix.exs in der Funktion deps. Als Beispiel dient jason, die übliche Bibliothek für JSON.
nano mix.exs
Ersetze in defp deps do die beiden Kommentarzeilen, die mit # {:dep_from beginnen, durch diese Zeile:
{:jason, "~> 1.4"}
Die Funktion sieht danach so aus:
defp deps do
[
{:jason, "~> 1.4"}
]
end
"~> 1.4" bedeutet: Version 1.4 oder neuer, aber unter 2.0.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Bibliothek herunterladen
Lädt jason in den Ordner deps und hält die genaue Version in mix.lock fest.
mix deps.get
Prüfen: Die Ausgabe enthält New: jason 1.4.5 (oder eine neuere 1.x) und * Getting jason (Hex package).
17. Bibliothek verwenden
Starte die Konsole mit dem Projekt. Beim ersten Mal übersetzt mix auch jason.
iex -S mix
Gib nacheinander ein und drücke jeweils Enter:
Jason.encode!(%{summe: Rechner.summe([1, 2, 3]), zahlen: [1, 2, 3]})
Jason.decode!(~s({"titel": "Notiz"}))
Prüfen: Die erste Zeile liefert den JSON-Text "{\"summe\":6,\"zahlen\":[1,2,3]}", die zweite die Map %{"titel" => "Notiz"}. %{…} schreibt in Elixir eine Map, ~s(…) einen Text, in dem Anführungszeichen nicht maskiert werden müssen. Beende iex mit zweimal Strg+C.
Wie geht es weiter?
- Formatieren:
mix formatbringt alle Dateien des Projekts in die übliche Schreibweise. - Prozesse: Mit
spawn,sendundreceivestartet man eigene Prozesse und schickt ihnen Nachrichten. Für dauerhaft laufende Prozesse gibt esGenServerundAgent, wie in der Phoenix-Anleitung. - Webanwendungen: Phoenix baut auf Elixir auf. Dafür braucht es zusätzlich das Paket
erlang-dev. - Lernen: Die offizielle Einführung auf https://elixir-lang.org („Getting Started“) erklärt die Sprache Schritt für Schritt.
Deinstallieren
1. Übungsordner entfernen
Löscht den Übungsordner samt Projekt.
rm -rf ~/hallo-elixir
2. Hex entfernen (optional)
Hex liegt in ~/.mix, heruntergeladene Pakete in ~/.hex. Die Befehle löschen beide Ordner. Das betrifft alle Elixir-Projekte.
rm -rf ~/.mix
rm -rf ~/.hex
3. Elixir entfernen
Nur ausführen, wenn kein anderes Programm Elixir braucht, z. B. Phoenix.
sudo apt purge elixir
4. Nicht mehr benötigte Pakete entfernen
Entfernt die Erlang-Pakete, die nur für Elixir mitinstalliert wurden. Der Befehl entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Shell meldet, dass der Befehl elixir nicht gefunden wurde.
elixir --version
Quellen und Lizenz
- Offizielle Dokumentation: https://elixir-lang.org/docs.html
- Lizenz: Elixir steht unter der Apache-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.
Erlang
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Erlang ist eine funktionale Programmiersprache, die bei Ericsson für Telefonvermittlungen entwickelt wurde. Ein Erlang-Programm besteht aus vielen kleinen, voneinander getrennten Prozessen, die sich Nachrichten schicken. Stürzt einer ab, laufen die anderen weiter. Deshalb steckt Erlang heute in Diensten, die nie ausfallen dürfen, etwa im Messenger WhatsApp oder im Nachrichtenvermittler RabbitMQ.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Erlang/OTP 27 und das Bauwerkzeug rebar3. OTP (Open Telecom Platform) ist die Standardbibliothek von Erlang.
- Ohne grafische Werkzeuge: Das Paket
erlanginstalliert auch grafische Hilfsprogramme mit den Bibliotheken von wxWidgets und GTK. Für die Kommandozeile genügterlang-nox. rebar3 empfiehlt das volle Paket, deshalb installiert die Anleitung mit--no-install-recommends. So sind es 40 statt 49 Pakete. - Verwandt mit Elixir: Elixir läuft auf derselben virtuellen Maschine (BEAM) und kann alle Erlang-Bibliotheken nutzen.
- Version: Getestet mit Erlang/OTP 27 und rebar3 3.26.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Erlang und rebar3 installieren
sudo apt install --no-install-recommends erlang-nox rebar3
Prüfen: Die Ausgabe lautet rebar 3.26.0 on Erlang/OTP 27 Erts ….
rebar3 version
Erste Schritte
3. Konsole starten
erl startet die Erlang-Konsole. Die Eingabezeile lautet 1>.
erl
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter. Jede Eingabe endet mit einem Punkt.
lists:map(fun(X) -> X * X end, [1, 2, 3, 4]).
Preis = 699.
Prüfen: Die Antworten lauten [1,4,9,16] und 699. Variablen beginnen mit einem Großbuchstaben und lassen sich nur einmal belegen: Preis = 899. meldet danach einen Fehler. Beende die Konsole mit q().
Ein Modul
5. Übungsordner anlegen
mkdir ~/erlang-uebung
6. In den Ordner wechseln
cd ~/erlang-uebung
7. Modul anlegen
Der Dateiname muss zum Modulnamen passen.
nano lager.erl
Füge diesen Inhalt ein (Strg+Umschalt+V):
-module(lager).
-export([start/0, bestand/0, lagerwert/1]).
bestand() ->
[{"Citybike", 699, 4}, {"Trekkingrad", 899, 0}, {"Lastenrad", 3490, 1}].
status(0) -> "ausverkauft";
status(Anzahl) -> integer_to_list(Anzahl) ++ " auf Lager".
lagerwert(Raeder) ->
lists:sum([Preis * Anzahl || {_, Preis, Anzahl} <- Raeder]).
start() ->
[io:format("~-12s ~5w Euro, ~s~n", [Modell, Preis, status(Anzahl)])
|| {Modell, Preis, Anzahl} <- bestand()],
io:format("Lagerwert: ~w Euro~n", [lagerwert(bestand())]).
-export– nennt die Funktionen, die von außen aufrufbar sind. Die Zahl hinter dem Schrägstrich ist die Anzahl der Parameter.- Tupel –
{"Citybike", 699, 4}fasst feste Werte zusammen. Eine Liste von Tupeln ist der Bestand. - Mustervergleich –
statushat zwei Klauseln. Ist die Anzahl 0, greift die erste, sonst die zweite. Klauseln werden mit;getrennt, die letzte endet mit.. - Listenbeschreibung –
[Preis * Anzahl || {_, Preis, Anzahl} <- Raeder]nimmt jedes Tupel auseinander und bildet daraus einen Wert._steht für einen Wert, der nicht gebraucht wird. io:format– gibt formatiert aus.~sist ein Text,~wein beliebiger Wert,~nein Zeilenumbruch,~-12sein Text linksbündig auf 12 Zeichen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Modul übersetzen
erlc übersetzt das Modul für die virtuelle Maschine von Erlang und legt die Datei lager.beam an.
erlc lager.erl
9. Modul ausführen
-noshell startet Erlang ohne Konsole, -s lager start ruft lager:start() auf, -s init stop beendet Erlang danach.
erl -noshell -s lager start -s init stop
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3490 Euro, 1 auf Lager
Lagerwert: 6286 Euro
Prozesse und Nachrichten
10. Modul mit Prozessen anlegen
Drei Kassen laufen als eigene Prozesse. Das Hauptprogramm schickt ihnen 30 Verkäufe als Nachrichten und sammelt am Ende die Summen ein.
nano kasse.erl
Füge diesen Inhalt ein:
-module(kasse).
-export([start/0]).
%% Eine Kasse ist ein eigener Prozess, der Verkäufe als Nachrichten empfängt.
kasse(Name, Summe) ->
receive
{verkauf, Betrag} ->
kasse(Name, Summe + Betrag);
{abschluss, Absender} ->
Absender ! {summe, Name, Summe}
end.
start() ->
Ich = self(),
Kassen = [spawn(fun() -> kasse(Name, 0) end) || Name <- ["Kasse 1", "Kasse 2", "Kasse 3"]],
%% 30 Verkäufe: drei Räder und 27 Fahrradschlösser, reihum auf die Kassen verteilt
Verkaeufe = [699, 899, 3490 | lists:duplicate(27, 49)],
[lists:nth((N rem 3) + 1, Kassen) ! {verkauf, Betrag} || {N, Betrag} <- lists:enumerate(Verkaeufe)],
[Kasse ! {abschluss, Ich} || Kasse <- Kassen],
Summen = [receive {summe, Name, Summe} -> {Name, Summe} end || _ <- Kassen],
[io:format("~s: ~w Euro~n", [Name, Summe]) || {Name, Summe} <- lists:sort(Summen)],
io:format("Gesamt: ~w Euro~n", [lists:sum([S || {_, S} <- Summen])]).
spawn– startet eine Funktion als neuen Prozess und liefert seine Kennung. Erlang-Prozesse sind keine Prozesse des Betriebssystems, sondern sehr leicht: Hunderttausende gleichzeitig sind kein Problem.!– schickt einem Prozess eine Nachricht. Der Absender wartet nicht.receive– wartet auf eine passende Nachricht. Die Kasse ruft sich danach selbst mit der neuen Summe auf und wartet weiter. So hält ein Prozess seinen Zustand, ohne Variablen zu verändern.self()– die Kennung des eigenen Prozesses, damit die Kassen wissen, wem sie die Summe schicken.lists:enumerate– nummeriert die Verkäufe von 1 an.N rem 3verteilt sie reihum auf die drei Kassen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Übersetzen und ausführen
erlc kasse.erl
erl -noshell -s kasse start -s init stop
Prüfen: Die Ausgabe lautet:
Kasse 1: 3931 Euro
Kasse 2: 1140 Euro
Kasse 3: 1340 Euro
Gesamt: 6411 Euro
Ein Kommandozeilenprogramm mit rebar3
12. In das Home-Verzeichnis wechseln
cd ~
13. Projekt anlegen
Die Vorlage escript erzeugt ein Projekt für ein Kommandozeilenprogramm. Ein escript ist eine einzelne ausführbare Datei, die Erlang zum Starten braucht, sonst nichts.
rebar3 new escript umsatz
Prüfen: rebar3 meldet unter anderem Writing umsatz/src/umsatz.erl und Writing umsatz/rebar.config.
14. In den Projektordner wechseln
cd ~/umsatz
15. Programm schreiben
Das Programm liest eine CSV-Datei, deren Name beim Aufruf angegeben wird, und zählt den Umsatz je Modell zusammen. Die Tests stehen in derselben Datei.
nano src/umsatz.erl
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
-module(umsatz).
-export([main/1, summen/1]).
%% Aufruf: umsatz DATEI
main([Datei]) ->
{ok, Inhalt} = file:read_file(Datei),
Zeilen = string:split(string:trim(Inhalt), "\n", all),
Summen = summen([zerlegen(Z) || Z <- Zeilen]),
[io:format("~-12s ~5w Euro~n", [Modell, Betrag])
|| {Modell, Betrag} <- lists:reverse(lists:keysort(2, maps:to_list(Summen)))],
erlang:halt(0);
main(_) ->
io:format("Aufruf: umsatz DATEI~n"),
erlang:halt(1).
%% "Citybike;2;699" -> {"Citybike", 2, 699}
zerlegen(Zeile) ->
[Modell, Anzahl, Preis] = string:split(Zeile, ";", all),
{binary_to_list(Modell), binary_to_integer(Anzahl), binary_to_integer(Preis)}.
%% Zählt den Umsatz je Modell in einer Map zusammen
summen(Verkaeufe) ->
lists:foldl(
fun({Modell, Anzahl, Preis}, Map) ->
maps:update_with(Modell, fun(Alt) -> Alt + Anzahl * Preis end, Anzahl * Preis, Map)
end,
#{},
Verkaeufe).
-ifdef(TEST).
-include_lib("eunit/include/eunit.hrl").
summen_test() ->
?assertEqual(#{"A" => 30, "B" => 50}, summen([{"A", 2, 10}, {"B", 1, 50}, {"A", 1, 10}])).
leer_test() ->
?assertEqual(#{}, summen([])).
-endif.
main/1– der Startpunkt eines escripts. Er bekommt die Argumente als Liste. Die erste Klausel passt genau auf ein Argument, die zweite auf alles andere und zeigt dann die Bedienung an.{ok, Inhalt} = …– ein Mustervergleich: Liefertfile:read_fileetwas anderes, etwa{error, enoent}für eine fehlende Datei, bricht das Programm mit einer Fehlermeldung ab.- Binärtexte –
file:read_fileliefert den Inhalt als Binärtext.binary_to_listundbinary_to_integerwandeln ihn um. - Maps –
#{}ist eine leere Map.maps:update_witherhöht einen vorhandenen Eintrag oder legt ihn mit dem Startwert an. -ifdef(TEST)– die Tests werden nur beim Testen übersetzt. Funktionen, deren Name auf_testendet, erkennt EUnit als Tests.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Tests ausführen
rebar3 eunit
Prüfen: Die Ausgabe endet mit 2 tests, 0 failures.
17. Programm bauen
escriptize übersetzt das Projekt und packt es in die Datei _build/default/bin/umsatz.
rebar3 escriptize
Prüfen: Die Meldung lautet Building escript for umsatz....
18. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
19. Programm starten
_build/default/bin/umsatz verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Ohne Dateinamen zeigt das Programm Aufruf: umsatz DATEI.
Wie geht es weiter?
- OTP-Anwendungen:
rebar3 new app NAMElegt eine Anwendung mit Supervisor an. Ein Supervisor startet abgestürzte Prozesse automatisch neu. Das ist der übliche Aufbau für Serverdienste in Erlang. - Bibliotheken: Pakete von https://hex.pm trägt man in
rebar.configunterdepsein, z. B.{deps, [jsx]}.für JSON. rebar3 lädt sie beim nächsten Bauen selbst. - Interaktiv mit dem Projekt:
rebar3 shellstartet die Konsole mit allen Modulen des Projekts. - Fehler finden:
rebar3 dialyzersucht anhand der Typen nach Widersprüchen im Code. - Dokumentation: Einführung und Referenz unter https://www.erlang.org/docs.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/erlang-uebung ~/umsatz
2. Erlang und rebar3 entfernen
Wird Erlang noch für Elixir gebraucht, lass erlang-nox im Befehl weg.
sudo apt purge rebar3 erlang-nox
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die übrigen Erlang-Pakete, die mitinstalliert wurden. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl erl wird nicht mehr gefunden.
erl -version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.erlang.org/docs
- Lizenz: Erlang/OTP steht unter der Apache-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.
Dart
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Dart ist eine Programmiersprache von Google mit einer Syntax, die an Java, C# und JavaScript erinnert. Sie ist typsicher und schützt vor dem häufigen Fehler, versehentlich mit null zu arbeiten (Null-Sicherheit). Dart-Programme laufen im Entwicklungsmodus sofort ohne Übersetzen und lassen sich für den Betrieb in eigenständige Programme übersetzen. Bekannt ist Dart vor allem als Sprache des Oberflächen-Frameworks Flutter.
Vorbemerkungen
- Keine Pakete von Ubuntu: Dart ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung bindet das offizielle Paketarchiv von Google ein, das auf https://dart.dev genannt wird. Dart wird danach mit
aptverwaltet und aktualisiert. Den Snapfluttergibt es auch, er enthält aber das ganze Flutter-Framework. - Das Dart SDK: Das Paket
dartbringt einen einzigen Befehldartmit. Er startet Programme, legt Projekte an, verwaltet Pakete, prüft, formatiert, testet und übersetzt Code. - Pakete von pub.dev: Bibliotheken kommen von https://pub.dev und landen in
~/.pub-cache. - Nutzungsdaten: Das SDK sendet ab Werk anonyme Nutzungsdaten an Google. Schritt 7 zeigt, wie man das abschaltet.
- Version: Getestet mit Dart 3.13.4 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme für die nächsten Schritte kennt.
sudo apt update
2. Hilfsprogramm installieren
wget lädt Dateien aus dem Internet herunter. Es ist meist schon vorhanden, dann meldet apt das nur.
sudo apt install wget
3. Schlüssel von Google einrichten
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Google stammen und nicht verändert wurden. Es ist derselbe Schlüssel, mit dem Google auch Chrome signiert. wget speichert ihn mit -O direkt im Ordner für Paketschlüssel. Der Schlüssel liegt als Text vor, apt liest ihn mit der Endung .asc ohne Umwandlung.
sudo wget -O /usr/share/keyrings/dart.asc https://dl-ssl.google.com/linux/linux_signing_key.pub
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /usr/share/keyrings/dart.asc
4. Paketarchiv eintragen
Legt eine Datei an, die apt mitteilt, wo die Dart-Pakete liegen und mit welchem Schlüssel sie geprüft werden.
sudo nano /etc/apt/sources.list.d/dart.sources
Füge diesen Inhalt ein (im Terminal mit Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://storage.googleapis.com/download.dartlang.org/linux/debian
Suites: stable
Components: main
Architectures: amd64
Signed-By: /usr/share/keyrings/dart.asc
5. Paketlisten erneut aktualisieren
Jetzt liest apt auch das neue Paketarchiv ein.
sudo apt update
Prüfen: In der Ausgabe erscheinen Zeilen mit storage.googleapis.com/download.dartlang.org, ohne Fehlermeldung. Die Zeile Ign: … stable InRelease ist normal, apt holt stattdessen Release und Release.gpg.
6. Dart installieren
sudo apt install dart
Prüfen: Die Ausgabe beginnt mit Dart SDK version: 3.13.4 (stable) oder nennt eine neuere Version.
dart --version
7. Nutzungsdaten abschalten (optional)
Beim ersten Aufruf eines dart-Befehls weist das SDK darauf hin, dass es Nutzungsdaten sendet. Dieser Befehl schaltet das für deinen Benutzer ab.
dart --disable-analytics
Prüfen: Die Ausgabe lautet Analytics reporting disabled. In order to enable it, run: dart --enable-analytics.
Erstes Projekt
8. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
9. Projekt anlegen
dart create legt ein Projekt aus einer Vorlage an und lädt die benötigten Pakete. -t console wählt die Vorlage für ein Kommandozeilenprogramm. Dart erwartet Projektnamen in Kleinbuchstaben mit Unterstrich, deshalb hallo_dart.
dart create -t console hallo_dart
Prüfen: Die Ausgabe endet mit Created project hallo_dart in hallo_dart! und dem Hinweis auf dart run.
10. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/hallo_dart
Die wichtigsten Dateien: pubspec.yaml beschreibt das Projekt und seine Pakete, bin/hallo_dart.dart ist das Hauptprogramm, lib/hallo_dart.dart enthält Funktionen, die andere Dateien verwenden, und test/hallo_dart_test.dart die Tests.
11. Funktionen schreiben
nano lib/hallo_dart.dart
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
/// Liefert eine Begrüßung für [name].
String begruessung(String name) => 'Hallo $name!';
/// Berechnet den Durchschnitt oder `null` bei einer leeren Liste.
double? durchschnitt(List<int> zahlen) {
if (zahlen.isEmpty) {
return null;
}
final summe = zahlen.reduce((a, b) => a + b);
return summe / zahlen.length;
}
- Typen stehen vor dem Namen:
String begruessung(String name)nimmt einen Text und gibt einen Text zurück.=>ist die Kurzform für eine Funktion, die nur einen Wert zurückgibt. $namesetzt einen Wert in einen Text ein.double?– das Fragezeichen erlaubtnullals Ergebnis. Ohne?würde Dartreturn null;beim Prüfen ablehnen. So sieht jeder, der die Funktion benutzt, dass er mit „kein Ergebnis“ rechnen muss.final– eine Variable, die nach der ersten Zuweisung nicht mehr geändert wird. Den Typ ermittelt Dart selbst.- Kommentare mit
///sind Dokumentation, die Editoren beim Überfahren mit der Maus anzeigen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Hauptprogramm schreiben
nano bin/hallo_dart.dart
Ersetze den ganzen Inhalt wie in Schritt 11 und füge ein:
import 'package:hallo_dart/hallo_dart.dart';
void main(List<String> arguments) {
// Erster Wert nach dem Programmnamen oder "Welt"
final name = arguments.isNotEmpty ? arguments.first : 'Welt';
print(begruessung(name));
final zahlen = [2, 4, 9];
final ergebnis = durchschnitt(zahlen);
print('Durchschnitt von $zahlen: $ergebnis');
// ?? nimmt den rechten Wert, wenn links null steht
print('Durchschnitt von []: ${durchschnitt([]) ?? 'keiner'}');
}
import 'package:hallo_dart/…' lädt die Funktionen aus dem Ordner lib. main ist der Startpunkt, arguments enthält die Werte vom Aufruf. ${…} setzt einen ganzen Ausdruck in einen Text ein.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Programm ausführen
dart run startet das Hauptprogramm aus bin, ohne es vorher in eine Datei zu übersetzen.
dart run
Prüfen: Die Ausgabe lautet:
Hallo Welt!
Durchschnitt von [2, 4, 9]: 5.0
Durchschnitt von []: keiner
Mit dart run bin/hallo_dart.dart Thorsten lautet die erste Zeile Hallo Thorsten!.
14. Code prüfen
dart analyze prüft das ganze Projekt auf Fehler, Warnungen und Stilregeln aus analysis_options.yaml, ohne es auszuführen.
dart analyze
Prüfen: Die Ausgabe endet mit No issues found!. dart format . bringt alle Dateien in die übliche Schreibweise.
15. Tests anpassen
Der Test aus der Vorlage prüft eine Funktion, die es nach Schritt 11 nicht mehr gibt.
nano test/hallo_dart_test.dart
Ersetze den ganzen Inhalt wie in Schritt 11 und füge ein:
import 'package:hallo_dart/hallo_dart.dart';
import 'package:test/test.dart';
void main() {
test('begruessung', () {
expect(begruessung('Dart'), 'Hallo Dart!');
});
test('durchschnitt', () {
expect(durchschnitt([2, 4, 9]), 5.0);
expect(durchschnitt([]), isNull);
});
}
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Tests ausführen
dart test
Prüfen: Die letzte Zeile lautet 00:00 +2: All tests passed!.
Pakete und eigenständiges Programm
17. Paket hinzufügen
dart pub add trägt ein Paket in pubspec.yaml ein und lädt es herunter. intl formatiert Datum, Uhrzeit und Zahlen für verschiedene Sprachen.
dart pub add intl
Prüfen: Die Ausgabe enthält + intl 0.20.3 (oder eine neuere Version) und endet mit Changed 2 dependencies!. Das zweite Paket clock braucht intl selbst.
18. Datum auf Deutsch ausgeben
Eine zweite Programmdatei im Ordner bin:
nano bin/datum.dart
Füge diesen Inhalt ein:
import 'package:intl/date_symbol_data_local.dart';
import 'package:intl/intl.dart';
Future<void> main() async {
// Deutsche Monats- und Tagesnamen laden
await initializeDateFormatting('de_DE');
final jetzt = DateTime(2026, 9, 27, 11, 30);
print(DateFormat.yMMMMEEEEd('de_DE').format(jetzt));
print(DateFormat('dd.MM.yyyy HH:mm', 'de_DE').format(jetzt));
}
initializeDateFormatting lädt die deutschen Namen. Die Funktion arbeitet asynchron, deshalb wartet await auf sie und main ist mit async markiert. Für die aktuelle Zeit schreibt man DateTime.now().
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
dart run bin/datum.dart
Prüfen: Die Ausgabe lautet:
Sonntag, 27. September 2026
27.09.2026 11:30
19. Eigenständiges Programm erzeugen
dart compile exe übersetzt das Hauptprogramm in Maschinencode. Die Datei hallo läuft danach auch auf Rechnern ohne Dart SDK.
dart compile exe bin/hallo_dart.dart -o hallo
Prüfen: Die Ausgabe lautet Generated: /home/…/hallo_dart/hallo. Die Datei ist rund 6 MB groß und startet ohne dart:
./hallo Ubuntu
Die erste Zeile lautet Hallo Ubuntu!.
Wie geht es weiter?
- Klassen: Dart ist objektorientiert. Eine Klasse mit Konstruktor schreibt man kurz als
class Notiz { final String titel; Notiz(this.titel); }. - Webserver:
dart create -t server-shelf meinserverlegt ein Projekt mit dem Webserver-Paketshelfan. - Oberflächen: Flutter baut mit Dart Oberflächen für Android, iOS, Web und Desktop. Es bringt ein eigenes Dart SDK mit.
- Editor: Für Visual Studio Code und VSCodium gibt es die Erweiterung „Dart“ (
Dart-Code.dart-code), die Vervollständigung, Fehleranzeige und Debugger nachrüstet.
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt Programmdatei.
rm -rf ~/hallo_dart
2. Dart entfernen
sudo apt purge dart
3. Paketarchiv und Schlüssel entfernen
Ohne diese Dateien sucht apt nicht mehr bei Google nach Dart-Updates.
sudo rm /etc/apt/sources.list.d/dart.sources /usr/share/keyrings/dart.asc
4. Paketlisten aktualisieren
Damit apt das entfernte Paketarchiv auch aus seinen Listen streicht.
sudo apt update
5. Heruntergeladene Pakete und Einstellungen entfernen
Dart legt Pakete von pub.dev in ~/.pub-cache ab (für dieses Projekt rund 90 MB), die Einstellung zu den Nutzungsdaten in ~/.dart-tool und Daten des Analysewerkzeugs in ~/.dartServer.
rm -rf ~/.pub-cache ~/.dart-tool ~/.dartServer
Prüfen: Die Shell meldet, dass der Befehl dart nicht gefunden wurde.
dart --version
Quellen und Lizenz
- Offizielle Dokumentation: https://dart.dev/guides
- Lizenz: Dart steht unter der BSD-3-Clause.
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.
R
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
R ist eine Programmiersprache für Statistik und Datenanalyse. Sie bringt Funktionen für Tabellen, Kennzahlen, statistische Tests und Diagramme schon mit und wird in Wissenschaft, Marktforschung und Datenjournalismus viel verwendet. Mehr als 20 000 Zusatzpakete auf CRAN, dem zentralen Paketarchiv von R, erweitern sie für fast jedes Fachgebiet.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert R 4.5 im Paket
r-base. Es enthält den Interpreter, die wichtigsten Standardpakete und die Compiler, die manche Pakete von CRAN beim Installieren brauchen. Zusammen sind das rund 40 Pakete. - Zusatzpakete auf zwei Wegen: Viele beliebte Pakete gibt es als Ubuntu-Paket mit dem Namen
r-cran-…, etwar-cran-ggplot2. Sie werden mitaptinstalliert und aktualisiert. Alle übrigen installiert R selbst von CRAN in eine persönliche Bibliothek im Home-Ordner. - Empfohlene Pakete weglassen:
r-cran-ggplot2empfiehlt sehr viele weitere Pakete. Im Test kamen dadurch rund 875 Pakete zusätzlich auf den Rechner. Mit--no-install-recommendssind es nur 17. - Version: Getestet mit R 4.5.2 und ggplot2 4.0.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. R installieren
sudo apt install r-base
Prüfen: Die erste Zeile lautet R version 4.5.2 ….
R --version
Erste Schritte
3. R im Terminal starten
Startet die interaktive Konsole von R. Die Eingabezeile beginnt mit >.
R
4. Etwas ausrechnen
Gib in der Konsole nacheinander ein und drücke jeweils Enter:
mean(c(12, 15, 24, 31, 38, 41))
summary(c(12, 15, 24, 31, 38, 41))
Prüfen: Der Mittelwert lautet 26.83333. summary zeigt Kleinstwert, Quartile, Mittelwert und Größtwert. R schreibt Kommazahlen mit Punkt.
5. Konsole beenden
q() beendet R. Auf die Frage Save workspace image? [y/n/c]: antwortest du mit n. Bei y legt R die Dateien .RData und .Rhistory im aktuellen Ordner an und lädt beim nächsten Start dort alle alten Variablen wieder.
q()
Ein Skript auswerten
6. Übungsordner anlegen
mkdir ~/r-uebung
7. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/r-uebung
8. Skript anlegen
Das Skript wertet ausgedachte Verkaufszahlen eines Fahrradladens aus und zeichnet ein Balkendiagramm.
nano auswertung.R
Füge diesen Inhalt ein (Strg+Umschalt+V):
# Verkaufte Fahrräder pro Monat (Beispielwerte)
monate <- c("Jan", "Feb", "Mär", "Apr", "Mai", "Jun")
verkauf <- data.frame(
monat = factor(monate, levels = monate),
citybike = c(12, 15, 24, 31, 38, 41),
lastenrad = c(3, 4, 6, 9, 11, 10)
)
print(verkauf)
cat("\nDurchschnitt Citybikes:", mean(verkauf$citybike), "\n")
cat("Summe Lastenräder:", sum(verkauf$lastenrad), "\n")
cat("Bester Monat Citybikes:", as.character(verkauf$monat[which.max(verkauf$citybike)]), "\n\n")
# Linearer Trend: Wie viele Citybikes kommen pro Monat hinzu?
verkauf$nummer <- seq_len(nrow(verkauf))
trend <- lm(citybike ~ nummer, data = verkauf)
cat("Zuwachs pro Monat:", round(coef(trend)[["nummer"]], 1), "\n")
# Diagramm als PNG-Datei
png("verkauf.png", width = 800, height = 500)
barplot(t(as.matrix(verkauf[, c("citybike", "lastenrad")])), names.arg = verkauf$monat,
beside = TRUE, legend.text = c("Citybike", "Lastenrad"), args.legend = list(x = "topleft"),
main = "Verkaufte Räder")
invisible(dev.off())
<-– weist einen Wert zu, wie=in anderen Sprachen.c(…)– fasst Werte zu einem Vektor zusammen. Rechnungen wiemeanodersumgelten dann für alle Werte auf einmal.data.frame– eine Tabelle mit benannten Spalten.verkauf$citybikeist die Spaltecitybike.factor(…, levels = monate)– legt die Reihenfolge der Monate fest. Ohne diese Angabe sortiert R sie alphabetisch.lm– berechnet eine Regressionsgerade.citybike ~ nummerheißt: Citybikes in Abhängigkeit von der Monatsnummer.png…dev.off()– leitet das Diagramm in eine Datei um und schließt sie am Ende.invisibleunterdrückt eine Meldung vondev.off.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Skript ausführen
Rscript führt ein Skript aus, ohne die Konsole zu öffnen.
Rscript auswertung.R
Prüfen: Die Ausgabe lautet:
monat citybike lastenrad
1 Jan 12 3
2 Feb 15 4
3 Mär 24 6
4 Apr 31 9
5 Mai 38 11
6 Jun 41 10
Durchschnitt Citybikes: 26.83333
Summe Lastenräder: 43
Bester Monat Citybikes: Jun
Zuwachs pro Monat: 6.3
Im Ordner liegt jetzt verkauf.png mit dem Balkendiagramm. Öffne es zum Ansehen im Dateimanager.
Diagramme mit ggplot2
10. ggplot2 installieren
ggplot2 ist das bekannteste Paket für Diagramme in R. --no-install-recommends lässt die vielen empfohlenen Zusatzpakete weg, siehe Vorbemerkungen.
sudo apt install --no-install-recommends r-cran-ggplot2
11. Skript anlegen
nano diagramm.R
Füge diesen Inhalt ein:
library(ggplot2)
monate <- c("Jan", "Feb", "Mär", "Apr", "Mai", "Jun")
verkauf <- data.frame(
monat = factor(rep(monate, 2), levels = monate),
modell = rep(c("Citybike", "Lastenrad"), each = 6),
anzahl = c(12, 15, 24, 31, 38, 41, 3, 4, 6, 9, 11, 10)
)
diagramm <- ggplot(verkauf, aes(x = monat, y = anzahl, fill = modell)) +
geom_col(position = "dodge") +
labs(title = "Verkaufte Räder im ersten Halbjahr", x = "Monat", y = "Anzahl", fill = "Modell") +
theme_minimal()
ggsave("verkauf-ggplot.png", diagramm, width = 8, height = 5, dpi = 100)
cat("Gespeichert: verkauf-ggplot.png\n")
- Lange Form: ggplot2 erwartet eine Zeile pro Wert. Statt zweier Spalten
citybikeundlastenradgibt es deshalb eine Spaltemodell.repwiederholt Werte, damit die Tabelle zwölf Zeilen bekommt. aes(…)– ordnet Spalten den Teilen des Diagramms zu: Monat nach rechts, Anzahl nach oben, Modell als Farbe.+– baut das Diagramm schichtweise auf: Balken (geom_col,dodgestellt sie nebeneinander), Beschriftungen (labs) und Gestaltung (theme_minimal).ggsave– speichert das Diagramm, hier 8 × 5 Zoll mit 100 Punkten je Zoll, also 800 × 500 Pixel.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Skript ausführen
Rscript diagramm.R
Prüfen: Die Ausgabe lautet Gespeichert: verkauf-ggplot.png. Das Bild zeigt farbige Balken für beide Modelle nebeneinander und rechts eine Legende.
Pakete von CRAN installieren
Nicht jedes Paket gibt es bei Ubuntu. Solche Pakete installiert R selbst in die persönliche Bibliothek. Als Beispiel dient fortunes, eine Sammlung von Zitaten aus der R-Gemeinschaft.
13. Persönliche Bibliothek anlegen
Legt den Ordner ~/R/x86_64-pc-linux-gnu-library/4.5 an. R verwendet ihn nur, wenn er beim Start schon existiert. Deshalb ist das ein eigener Schritt vor der Installation.
Rscript -e 'dir.create(Sys.getenv("R_LIBS_USER"), recursive = TRUE)'
14. Paket installieren
R lädt das Paket von cloud.r-project.org, einem weltweiten Spiegel von CRAN, und installiert es in die persönliche Bibliothek. Dafür sind keine Administratorrechte nötig.
Rscript -e 'install.packages("fortunes")'
Prüfen: Die letzten Zeilen nennen den Ordner downloaded_packages. Der nächste Befehl gibt ein zufälliges Zitat aus.
Rscript -e 'library(fortunes); fortune()'
Wie geht es weiter?
- Daten einlesen:
read.csv("datei.csv")liest eine CSV-Datei als Tabelle ein. Für Dateien aus deutschen Programmen mit Semikolon und Komma als Dezimalzeichen gibt esread.csv2. - tidyverse: Die Pakete
r-cran-dplyr,r-cran-tidyrundr-cran-readrmachen das Umformen und Filtern von Tabellen bequemer. Auch hier lohnt--no-install-recommends. - Berichte: Mit Quarto mischt man Text und R-Code in einem Dokument und erzeugt daraus HTML oder PDF samt Diagrammen.
- Entwicklungsumgebung: RStudio (Posit) ist die verbreitetste Oberfläche für R. Alternativ gibt es eine R-Erweiterung für Visual Studio Code.
- Dokumentation: In der Konsole öffnet
?meandie Hilfe zu einer Funktion. Handbücher gibt es unter https://cran.r-project.org/manuals.html.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/r-uebung
2. Persönliche Bibliothek entfernen
Löscht alle Pakete, die R selbst von CRAN installiert hat.
rm -rf ~/R
3. R und ggplot2 entfernen
r-base-core ist der eigentliche Interpreter. Mit ihm werden auch alle r-cran-…-Pakete entfernt, die ihn brauchen.
sudo apt purge r-base r-base-core r-cran-ggplot2
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für R mitinstalliert wurden, z. B. die Compiler und Bibliotheken für Fortran. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
5. Verlauf und Arbeitsbereich löschen (optional)
Nur nötig, wenn du beim Beenden der Konsole mit y geantwortet hast. Dann liegen .Rhistory und .RData in dem Ordner, in dem du R gestartet hast. Der Befehl löscht sie im Home-Ordner.
rm -f ~/.Rhistory ~/.RData
Prüfen: Der Befehl R wird nicht mehr gefunden.
R --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.r-project.org/other-docs.html
- Lizenz: R steht unter der GPL-2.0 / GPL-3.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.
GNU Octave
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
GNU Octave ist eine Programmiersprache und Umgebung für numerische Berechnungen: Matrizen, Gleichungssysteme, Statistik, Signalverarbeitung und Diagramme. Die Sprache ist weitgehend mit MATLAB verträglich, sodass viele MATLAB-Skripte unverändert laufen. Octave ist frei und wird an Hochschulen gern als Ersatz für MATLAB verwendet.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Octave 11.1. Mit allen empfohlenen Paketen wären das 108 Pakete, darunter Java, gnuplot und die Dokumentation. Die Anleitung installiert mit
--no-install-recommendsnur den Kern samt grafischer Oberfläche, das sind 56 Pakete. - Schrift nicht vergessen: Für Diagramme braucht Octave die Schrift FreeSans aus dem Paket
fonts-freefont-otf. Ohne sie bricht jeder Versuch, ein Diagramm zu zeichnen, mitunable to load fontab. Weil sie nur empfohlen ist, wird sie hier ausdrücklich mitinstalliert. - Drei Startarten:
octaveöffnet die grafische Oberfläche mit Editor, Variablenanzeige und Konsole.octave --no-guistartet ohne Oberfläche, kann aber Diagramme zeichnen.octave-cliist die reine Kommandozeilenfassung ohne Grafik. - Version: Getestet mit GNU Octave 11.1.0 aus Ubuntu 26.04. Die grafische Oberfläche wurde nicht geöffnet, getestet wurden Skripte im Terminal.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Octave und die Schrift installieren
sudo apt install --no-install-recommends octave fonts-freefont-otf
Prüfen: Die erste Zeile lautet GNU Octave (x86_64-pc-linux-gnu) version 11.1.0.
octave-cli --version
Erste Schritte
3. Konsole starten
octave-cli startet die Konsole im Terminal. Die Eingabezeile lautet >>.
octave-cli
4. Mit Matrizen rechnen
Gib nacheinander ein und drücke jeweils Enter:
A = [1 2; 3 4]
A * A
A .* A
Prüfen: A * A ist das Matrixprodukt [7 10; 15 22], A .* A multipliziert Element für Element und ergibt [1 4; 9 16]. Ein Semikolon am Zeilenende unterdrückt die Ausgabe. Beende die Konsole mit exit.
Ein Gleichungssystem lösen
5. Übungsordner anlegen
mkdir ~/octave-uebung
6. In den Ordner wechseln
cd ~/octave-uebung
7. Skript anlegen
Octave-Skripte haben die Endung .m, wie bei MATLAB.
nano gleichung.m
Füge diesen Inhalt ein (Strg+Umschalt+V):
% Ein Laden verkauft Citybikes und Lastenräder.
% Am Montag: 3 Citybikes und 1 Lastenrad für zusammen 5587 Euro.
% Am Dienstag: 1 Citybike und 2 Lastenräder für zusammen 7679 Euro.
% Welche Preise haben die beiden Räder?
A = [3 1;
1 2];
b = [5587; 7679];
preise = A \ b;
printf("Citybike: %.0f Euro, Lastenrad: %.0f Euro\n", preise(1), preise(2));
- Matrix – Werte einer Zeile werden mit Leerzeichen getrennt, Zeilen mit
;oder einem Zeilenumbruch.bist ein Spaltenvektor. A \ b– löst das GleichungssystemA · x = b. Der Rückstrich ist der übliche Weg in Octave und MATLAB und rechnet genauer als die Umkehrmatrixinv(A) * b.printf– gibt formatiert aus.%.0fist eine Zahl ohne Nachkommastellen.- Kommentare beginnen mit
%.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Skript ausführen
octave-cli gleichung.m
Prüfen: Die Ausgabe lautet Citybike: 699 Euro, Lastenrad: 3490 Euro.
Daten auswerten und ein Diagramm zeichnen
9. Skript anlegen
nano verkauf.m
Füge diesen Inhalt ein:
% Verkaufte Fahrräder im ersten Halbjahr (Beispielwerte)
monate = {"Jan", "Feb", "Mär", "Apr", "Mai", "Jun"};
citybike = [12 15 24 31 38 41];
lastenrad = [ 3 4 6 9 11 10];
% Rechnen mit ganzen Vektoren
gesamt = citybike + lastenrad;
printf("Verkauft insgesamt: %d Räder\n", sum(gesamt));
printf("Durchschnitt Citybikes: %.1f pro Monat\n", mean(citybike));
[~, bester] = max(gesamt);
printf("Bester Monat: %s\n", monate{bester});
% Linearer Trend: Gerade durch die Citybike-Zahlen legen
nummer = 1:6;
koeff = polyfit(nummer, citybike, 1);
printf("Trend Citybikes: %+.1f pro Monat\n", koeff(1));
printf("Prognose Juli: %.0f Citybikes\n", polyval(koeff, 7));
% Diagramm als PNG speichern, ohne ein Fenster zu öffnen
h = figure("visible", "off");
bar(nummer, [citybike; lastenrad]');
hold on;
plot(nummer, polyval(koeff, nummer), "k--", "linewidth", 2);
set(gca, "xticklabel", monate);
legend("Citybike", "Lastenrad", "Trend Citybike", "location", "northwest");
title("Verkaufte Räder");
print(h, "-dpng", "verkauf.png");
printf("Diagramm gespeichert: verkauf.png\n");
- Zellfeld –
{"Jan", "Feb", …}speichert Texte unterschiedlicher Länge. Ein Element liest man mit geschweiften Klammern:monate{bester}. - Rechnen mit Vektoren –
citybike + lastenradaddiert Monat für Monat,sumundmeangelten für den ganzen Vektor. [~, bester] = max(…)–maxliefert den größten Wert und seine Position.~verwirft den Wert, gebraucht wird nur die Position.polyfit(x, y, 1)– legt eine Gerade durch die Punkte.koeff(1)ist die Steigung,polyvalberechnet Werte auf der Geraden, hier die Prognose für Monat 7.figure("visible", "off")– zeichnet das Diagramm unsichtbar.print(h, "-dpng", …)speichert es als Bild.barundplot– Balken für beide Modelle, dazu mithold ondie gestrichelte Trendlinie ("k--": schwarz, gestrichelt).
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Skript ausführen
Für Diagramme startet die Anleitung octave --no-gui statt octave-cli. Nur diese Fassung kann mit der Qt-Grafik zeichnen.
octave --no-gui verkauf.m
Prüfen: Die Ausgabe lautet:
Verkauft insgesamt: 204 Räder
Durchschnitt Citybikes: 26.8 pro Monat
Bester Monat: Jun
Trend Citybikes: +6.3 pro Monat
Prognose Juli: 49 Citybikes
Diagramm gespeichert: verkauf.png
Davor kann die Meldung qt.qpa.plugin: Could not find the Qt platform plugin "wayland" stehen. Sie ist harmlos: Octave weicht dann auf die X11-Anbindung aus, die Ubuntu auch unter Wayland bereitstellt.
11. Diagramm ansehen
Öffne verkauf.png im Dateimanager. Es zeigt blaue und orangefarbene Balken für die beiden Modelle und eine gestrichelte Trendlinie über den Citybikes.
Ohne Bildschirm, z. B. auf einem Server
octave --no-gui braucht für Diagramme eine grafische Sitzung. Ohne sie, etwa per SSH auf einem Server, zeichnet Octave nur mit gnuplot. Dafür installiert man sudo apt install --no-install-recommends gnuplot-nox und schreibt am Anfang des Skripts graphics_toolkit("gnuplot");. Octave warnt dann, dass gnuplot nicht mehr weiterentwickelt wird, das Bild entsteht aber trotzdem.
Wie geht es weiter?
- Grafische Oberfläche:
octaveohne weitere Angabe öffnet die Oberfläche mit Editor, Dateibrowser, Variablen und Befehlsverlauf. - Zusatzpakete: Viele Pakete aus Octave Forge gibt es bei Ubuntu, z. B.
sudo apt install octave-statisticsfür Statistik oderoctave-signalfür Signalverarbeitung. In Octave lädtpkg load statisticsein installiertes Paket. - Daten einlesen:
csvread("datei.csv")liest Zahlen aus einer CSV-Datei,importdataauch Dateien mit Überschriften. - Eigene Funktionen: Eine Datei
quadrat.mmitfunction y = quadrat(x) … endstellt die Funktionquadratin allen Skripten desselben Ordners bereit. - Dokumentation: In Octave zeigt
help polyfitdie Hilfe zu einer Funktion. Das Handbuch steht unter https://docs.octave.org.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/octave-uebung
2. Octave entfernen
sudo apt purge octave fonts-freefont-otf
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Rechenbibliotheken und Qt-Pakete, die nur für Octave mitinstalliert wurden. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
4. Einstellungen entfernen (optional)
Octave speichert Einstellungen in ~/.config/octave und den Befehlsverlauf in ~/.local/share/octave.
rm -rf ~/.config/octave ~/.local/share/octave
Prüfen: Der Befehl octave wird nicht mehr gefunden.
octave --version
Quellen und Lizenz
- Offizielle Dokumentation: https://octave.org/doc/v9.2.0/
- Lizenz: GNU Octave steht unter der GPL-3.0-or-later.
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.
Swift
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Swift ist eine Programmiersprache von Apple, die schnelle, übersetzte Programme mit einer gut lesbaren Schreibweise verbindet. Bekannt ist sie vor allem für Apps auf iPhone und Mac, sie läuft aber auch unter Linux, etwa für Kommandozeilenprogramme und Serverdienste.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Swift 6.1 im Paket
swiftlang. Es enthält den Compilerswiftc, den Paketmanager (swift build,swift run), die interaktive Konsole (REPL), den Debugger LLDB und das Formatierwerkzeugswift format. Das Paket ist groß: Der Download dauert eine Weile, installiert belegt es rund 2,4 GB. - Rückfrage bei der Installation: Ein älteres Paket
python3-swiftclient(ein Werkzeug für den Cloud-Speicher OpenStack Swift) bringt ebenfalls einen Befehlswiftmit. Deshalb fragt die Installation, ob/usr/bin/swiftauf die Programmiersprache zeigen soll. Siehe Schritt 3. - Ohne Apple-Bibliotheken: Die Oberflächenbibliotheken für iPhone und Mac (SwiftUI, UIKit, AppKit) gibt es unter Linux nicht. Die Standardbibliothek und Foundation sind aber vorhanden.
- Pakete: Bibliotheken kommen als Git-Repositorys, meist von GitHub. Der Paketmanager lädt sie selbst.
gitmuss dafür installiert sein. - Version: Getestet mit Swift 6.1.3 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Swift und Git installieren
git braucht der Paketmanager, um Bibliotheken herunterzuladen. Ist es schon vorhanden, meldet apt das nur.
sudo apt install swiftlang git
3. Rückfrage zum Befehl swift beantworten
Während der Installation erscheint ein blauer Dialog mit der Frage „Möchten Sie den empfohlenen symbolischen Link /usr/bin/swift erstellen?“. Wähle Ja und drücke Enter. Nur wer das Werkzeug python3-swiftclient für OpenStack braucht, antwortet mit Nein und übersetzt dann ausschließlich mit swiftc.
Prüfen: Die Ausgabe beginnt mit Swift version 6.1.3.
swift --version
Erstes Programm
4. Projektordner anlegen
mkdir ~/lager
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt. Der Name des Ordners wird zum Namen des Projekts.
cd ~/lager
6. Projekt anlegen
Legt ein Projekt für ein ausführbares Programm an: die Beschreibung Package.swift und den Quelltext Sources/main.swift.
swift package init --type executable
Prüfen: Die Ausgabe beginnt mit Creating executable package: lager und endet mit Creating Sources/main.swift.
7. Quelltext schreiben
Ersetzt das mitgelieferte „Hello, world!“ durch ein kleines Programm, das den Lagerbestand eines Fahrradladens auswertet.
nano Sources/main.swift
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein (Strg+Umschalt+V):
struct Fahrrad {
let modell: String
let preis: Double
var aufLager: Int
}
let bestand = [
Fahrrad(modell: "Citybike", preis: 699, aufLager: 4),
Fahrrad(modell: "Trekkingrad", preis: 899, aufLager: 0),
Fahrrad(modell: "Lastenrad", preis: 3490, aufLager: 1),
]
for rad in bestand {
let status = rad.aufLager > 0 ? "\(rad.aufLager) auf Lager" : "ausverkauft"
print("\(rad.modell): \(Int(rad.preis)) Euro, \(status)")
}
let verfuegbar = bestand.filter { $0.aufLager > 0 }.map(\.modell)
print("Sofort lieferbar:", verfuegbar.joined(separator: ", "))
let gesamtwert = bestand.reduce(0) { $0 + $1.preis * Double($1.aufLager) }
print("Lagerwert: \(Int(gesamtwert)) Euro")
struct– fasst zusammengehörige Werte zu einem eigenen Typ zusammen.letist unveränderlich,varveränderlich."\(…)"– setzt einen Wert direkt in einen Text ein.filter,map,reduce– bearbeiten alle Elemente einer Liste.$0und$1sind die Parameter der kurzen Funktion in den geschweiften Klammern.\.modellholt aus jedem Fahrrad nur das Modell.- Typen: Swift erkennt die meisten Typen selbst, prüft sie aber streng. Deshalb muss
aufLagermitDouble(…)umgewandelt werden, bevor es mit dem Preis malgenommen wird.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Programm übersetzen und starten
swift run übersetzt das Projekt im Ordner .build und startet es. Beim ersten Mal dauert das einige Sekunden.
swift run
Prüfen: Nach den Meldungen des Compilers lautet die Ausgabe:
Citybike: 699 Euro, 4 auf Lager
Trekkingrad: 899 Euro, ausverkauft
Lastenrad: 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
9. Code prüfen
swift format lint meldet Stellen, die vom üblichen Stil abweichen, z. B. eine falsche Einrückung oder zu lange Zeilen. -r durchsucht den Ordner mit allen Unterordnern. Mit swift format -i -r Sources korrigiert es die Stellen selbst.
swift format lint -r Sources
Prüfen: Der Befehl gibt nichts aus. swift format rückt mit zwei Leerzeichen ein. Mit vier Leerzeichen eingerückter Code führt zu Warnungen wie [Indentation] unindent by 2 spaces.
Eine Bibliothek verwenden
Als Beispiel dient swift-argument-parser von Apple. Damit versteht das Programm Optionen auf der Kommandozeile und bekommt eine Hilfe.
10. Paketbeschreibung anpassen
nano Package.swift
Lösche den bisherigen Inhalt und füge diesen ein:
// swift-tools-version: 6.1
import PackageDescription
let package = Package(
name: "lager",
dependencies: [
.package(url: "https://github.com/apple/swift-argument-parser.git", from: "1.5.0")
],
targets: [
.executableTarget(
name: "lager",
dependencies: [.product(name: "ArgumentParser", package: "swift-argument-parser")]
)
]
)
- Erste Zeile: Der Kommentar
swift-tools-versionist Pflicht. Er sagt, welche Version des Paketmanagers die Datei mindestens braucht. dependencies– die Bibliothek mit ihrer Git-Adresse.from: "1.5.0"erlaubt jede Version ab 1.5.0 bis vor 2.0.executableTarget– das Programm. Es benutzt das ProduktArgumentParseraus der Bibliothek.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Alte Programmdatei entfernen
Programme mit dem Kennzeichen @main dürfen keine Datei namens main.swift haben, denn diese legt den Startpunkt bereits fest.
rm Sources/main.swift
12. Neues Programm schreiben
nano Sources/Lager.swift
Füge diesen Inhalt ein:
import ArgumentParser
@main
struct Lager: ParsableCommand {
static let configuration = CommandConfiguration(
abstract: "Zeigt den Lagerbestand eines Fahrradladens.")
@Option(name: [.customShort("p"), .long], help: "Nur Räder bis zu diesem Preis anzeigen.")
var hoechstpreis: Int?
@Flag(help: "Ausverkaufte Räder weglassen.")
var nurLieferbar = false
func run() {
let bestand: [(modell: String, preis: Int, aufLager: Int)] = [
("Citybike", 699, 4),
("Trekkingrad", 899, 0),
("Lastenrad", 3490, 1),
]
for rad in bestand {
if let grenze = hoechstpreis, rad.preis > grenze { continue }
if nurLieferbar && rad.aufLager == 0 { continue }
print("\(rad.modell): \(rad.preis) Euro, \(rad.aufLager) auf Lager")
}
}
}
@main– kennzeichnet den Startpunkt des Programms.ParsableCommandmacht aus dem Typ ein Kommandozeilenprogramm, dessen Methoderunausgeführt wird.@Option– eine Option mit Wert, hier--hoechstpreisbzw. kurz-p.Int?bedeutet: Die Angabe darf fehlen.@Flag– ein Schalter ohne Wert. AusnurLieferbarwird automatisch--nur-lieferbar.if let– prüft, ob ein Höchstpreis angegeben wurde, und gibt ihm für den Vergleich den Namengrenze.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Hilfe anzeigen
Beim ersten Aufruf lädt der Paketmanager die Bibliothek von GitHub und übersetzt sie, das dauert etwa eine Viertelminute. Alles nach dem Programmnamen lager geht an das Programm statt an swift run.
swift run lager --help
Prüfen: Am Ende der Ausgabe steht:
OVERVIEW: Zeigt den Lagerbestand eines Fahrradladens.
USAGE: lager [--hoechstpreis <hoechstpreis>] [--nur-lieferbar]
OPTIONS:
-p, --hoechstpreis <hoechstpreis>
Nur Räder bis zu diesem Preis anzeigen.
--nur-lieferbar Ausverkaufte Räder weglassen.
-h, --help Show help information.
Im Projektordner liegt jetzt die Datei Package.resolved. Darin hält der Paketmanager fest, welche Version der Bibliothek er genau verwendet.
14. Mit Optionen aufrufen
swift run lager -p 900 --nur-lieferbar
Prüfen: Die Ausgabe lautet Citybike: 699 Euro, 4 auf Lager. Das Trekkingrad ist ausverkauft, das Lastenrad zu teuer.
Eigenständiges Programm erzeugen
15. Optimiert übersetzen
-c release übersetzt mit allen Optimierungen. --static-swift-stdlib baut die Swift-Bibliotheken in das Programm ein. Ohne diese Angabe läuft es nur auf Rechnern, auf denen Swift installiert ist.
swift build -c release --static-swift-stdlib
16. Programm direkt starten
.build/release/lager --nur-lieferbar
Prüfen: Die Ausgabe nennt Citybike und Lastenrad. Die Datei ist rund 23 MB groß, weil sie die Swift-Bibliotheken enthält, und lässt sich auf andere Rechner mit Ubuntu kopieren.
ls -lh .build/release/lager
Wie geht es weiter?
- Interaktive Konsole:
swift replstartet eine Konsole, in der man Swift-Zeilen direkt ausprobiert. Beenden mit:quit. - Tests:
swift package init --type executablelegt keine Tests an. Ein Projekt mit--type librarybringt einen OrdnerTestsmit,swift testführt die Tests aus. - Serverdienste: Webframeworks wie Vapor oder Hummingbird werden wie swift-argument-parser in
Package.swifteingetragen. - Editor: Das Paket enthält
sourcekit-lsp. Die Erweiterung „Swift“ für Visual Studio Code nutzt es für Autovervollständigung und Fehleranzeige. Auch Neovim kann es einbinden. - Dokumentation: https://www.swift.org/documentation
Deinstallieren
1. Projekt entfernen
Löscht den Projektordner samt übersetzter Dateien und heruntergeladener Bibliotheken.
rm -rf ~/lager
2. Zwischenspeicher und Einstellungen entfernen
Der Paketmanager hebt Bibliotheken in ~/.cache/org.swift.swiftpm auf und legt Einstellungen in ~/.swiftpm ab.
rm -rf ~/.swiftpm ~/.cache/org.swift.swiftpm ~/.cache/org.swift.foundation.URLCache
3. Swift entfernen
Entfernt Swift samt der Verknüpfung /usr/bin/swift.
sudo apt purge swiftlang
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Bibliotheken, die nur für Swift mitinstalliert wurden. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl swift wird nicht mehr gefunden.
swift --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.swift.org/documentation/
- Lizenz: Swift steht unter der Apache-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.
Lua
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Lua ist eine kleine, schnelle Skriptsprache aus Brasilien, die sich leicht in andere Programme einbauen lässt. Deshalb steckt sie in vielen Anwendungen als Erweiterungssprache, etwa in Neovim, im Satzprogramm LuaTeX, im Webserver OpenResty und in Spielen. Der Interpreter ist nur wenige hundert Kilobyte groß.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 bietet Lua 5.4 im Paket
lua5.4und das neue Lua 5.5 im Paketlua5.5. Die Anleitung verwendet 5.4, denn dafür gibt es bei Ubuntu fertige Bibliotheken als Pakete, etwa für JSON oder Dateizugriffe. Für 5.5 fehlen sie noch. - Bibliotheken über apt: Pakete wie
lua-cjsonoderlua-filesystemsind für Lua 5.1, 5.3 und 5.4 gebaut. Sie werden mitaptinstalliert und aktualisiert. - LuaRocks: Der Paketmanager LuaRocks ist bei Ubuntu nur in Version 3.8 enthalten und auf Lua 5.1 oder 5.3 ausgelegt. Er zieht deshalb ein zweites Lua nach sich. Für den Einstieg reichen die Bibliotheken aus
apt. - Neovim: Neovim bringt seine eigene Lua-Umgebung (LuaJIT) mit. Für die Konfiguration von Neovim muss Lua nicht installiert werden.
- Version: Getestet mit Lua 5.4.8 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Lua installieren
Das Paket bringt den Interpreter lua5.4 und den Übersetzer luac5.4 mit. Ubuntu richtet dazu die kurzen Befehle lua und luac ein.
sudo apt install lua5.4
Prüfen: Die Ausgabe beginnt mit Lua 5.4.8.
lua -v
Erste Schritte
3. Interaktive Konsole starten
-i startet eine Konsole, in der jede Zeile sofort ausgeführt wird. Die Eingabezeile beginnt mit >.
lua -i
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter:
x = 6 * 7
print("Ergebnis: " .. x)
Prüfen: Die Ausgabe lautet Ergebnis: 42. .. hängt Texte aneinander. Beende die Konsole mit Strg+D.
Ein eigenes Modul
5. Übungsordner anlegen
mkdir ~/lua-uebung
6. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/lua-uebung
7. Modul anlegen
Ein Modul ist eine Lua-Datei, die eine Tabelle mit Funktionen zurückgibt. Andere Dateien laden es mit require.
nano lager.lua
Füge diesen Inhalt ein (Strg+Umschalt+V):
-- Modul mit Funktionen rund um den Lagerbestand
local lager = {}
function lager.lieferbar(bestand)
local ergebnis = {}
for _, rad in ipairs(bestand) do
if rad.anzahl > 0 then
table.insert(ergebnis, rad.modell)
end
end
return ergebnis
end
function lager.wert(bestand)
local summe = 0
for _, rad in ipairs(bestand) do
summe = summe + rad.preis * rad.anzahl
end
return summe
end
return lager
- Tabellen – der einzige zusammengesetzte Datentyp von Lua. Sie dienen als Liste, als Wörterbuch und, wie hier, als Modul mit Funktionen.
local– die Variable gilt nur in dieser Datei bzw. in diesem Block. Ohnelocalwäre sie überall sichtbar.ipairs– geht eine Liste der Reihe nach durch und liefert Position und Wert._ist der übliche Name für einen Wert, den man nicht braucht.return lager– gibt die Tabelle an den zurück, der das Modul lädt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Hauptprogramm anlegen
nano auswertung.lua
Füge diesen Inhalt ein:
local lager = require("lager")
local bestand = {
{ modell = "Citybike", preis = 699, anzahl = 4 },
{ modell = "Trekkingrad", preis = 899, anzahl = 0 },
{ modell = "Lastenrad", preis = 3490, anzahl = 1 },
}
for i, rad in ipairs(bestand) do
local status = rad.anzahl > 0 and (rad.anzahl .. " auf Lager") or "ausverkauft"
print(string.format("%d. %-12s %5d Euro %s", i, rad.modell, rad.preis, status))
end
print("Sofort lieferbar: " .. table.concat(lager.lieferbar(bestand), ", "))
print("Lagerwert: " .. lager.wert(bestand) .. " Euro")
require("lager")– sucht die Dateilager.luaunter anderem im aktuellen Ordner und lädt sie.- Listen beginnen bei 1: Anders als in vielen Sprachen hat das erste Element einer Liste in Lua die Position 1.
a and b or c– die übliche Kurzform für „wenn a, dann b, sonst c“.string.format– gibt Werte formatiert aus.%-12sfüllt einen Text linksbündig auf 12 Zeichen auf,%5deine Zahl rechtsbündig auf 5 Stellen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm ausführen
lua auswertung.lua
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro 4 auf Lager
2. Trekkingrad 899 Euro ausverkauft
3. Lastenrad 3490 Euro 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
10. Syntax prüfen
luac -p übersetzt die Dateien nur zur Probe und meldet Syntaxfehler mit Datei und Zeile, ohne das Programm auszuführen.
luac -p auswertung.lua lager.lua
Prüfen: Der Befehl gibt nichts aus. Fehlt z. B. eine schließende Klammer, meldet er etwa ')' expected (to close '(' at line 1).
Bibliotheken aus apt
11. Bibliotheken für JSON und Dateien installieren
lua-cjson– liest und schreibt JSONlua-filesystem– listet Ordner auf und fragt Dateieigenschaften ab
sudo apt install lua-cjson lua-filesystem
12. Programm anlegen
Das Programm speichert den Bestand als JSON-Datei, liest ihn wieder ein und listet alle Lua-Dateien im Ordner mit ihrer Größe auf.
nano json.lua
Füge diesen Inhalt ein:
local cjson = require("cjson")
local lfs = require("lfs")
-- Bestand als JSON-Datei speichern
local bestand = {
{ modell = "Citybike", preis = 699, anzahl = 4 },
{ modell = "Lastenrad", preis = 3490, anzahl = 1 },
}
local datei = assert(io.open("bestand.json", "w"))
datei:write(cjson.encode(bestand))
datei:close()
-- Datei wieder einlesen
datei = assert(io.open("bestand.json", "r"))
local gelesen = cjson.decode(datei:read("a"))
datei:close()
print("Gelesen: " .. #gelesen .. " Einträge, erstes Modell: " .. gelesen[1].modell)
-- Alle Lua-Dateien im Ordner sammeln, sortieren und mit Größe auflisten
local namen = {}
for name in lfs.dir(".") do
if name:match("%.lua$") then
table.insert(namen, name)
end
end
table.sort(namen)
for _, name in ipairs(namen) do
print(string.format("%-16s %4d Bytes", name, lfs.attributes(name, "size")))
end
require("lfs")– das Paketlua-filesystemheißt beim Ladenlfs.assert(io.open(…))–io.openliefert bei einem Fehlernilund eine Meldung.assertbricht dann mit dieser Meldung ab.datei:write(…)– der Doppelpunkt ruft eine Methode auf und übergibtdateiselbst als ersten Wert.#gelesen– die Länge einer Liste.name:match("%.lua$")– ein Lua-Muster, ähnlich einem regulären Ausdruck: Der Name endet auf.lua.%maskiert den Punkt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Programm ausführen
lua json.lua
Prüfen: Die Ausgabe lautet:
Gelesen: 2 Einträge, erstes Modell: Citybike
auswertung.lua 548 Bytes
json.lua 861 Bytes
lager.lua 427 Bytes
Die Größen können um ein paar Bytes abweichen, wenn du beim Einfügen Leerzeilen anders gesetzt hast.
14. JSON-Datei ansehen
cat bestand.json
Prüfen: Die Datei enthält beide Räder in einer Zeile, z. B. [{"preis":699,"modell":"Citybike","anzahl":4},…]. Die Reihenfolge der Felder kann sich bei jedem Lauf ändern, denn Lua-Tabellen merken sich keine Reihenfolge ihrer Schlüssel.
Wie geht es weiter?
- Weitere Bibliotheken:
apt search lua-listet alle Lua-Pakete von Ubuntu, z. B.lua-socketfür Netzwerkverbindungen,lua-lpegfür Textzerlegung oderlua-penlightmit vielen Hilfsfunktionen. - Lua 5.5:
sudo apt install lua5.5installiert die neue Version zusätzlich. Sie startet mitlua5.5, die alte weiterhin mitlua5.4. Auf welche Version der kurze Befehlluazeigt, legst du mitsudo update-alternatives --config lua-interpreterfest. Die Bibliotheken ausaptfunktionieren nur mit 5.4. - Lua einbetten: Mit
liblua5.4-devlässt sich Lua in eigene Programme in C einbauen. Das ist der ursprüngliche Zweck der Sprache. - Editor: Für Visual Studio Code und Neovim gibt es den Sprachserver lua-language-server mit Autovervollständigung und Fehleranzeige.
- Dokumentation: Das Handbuch zu Lua 5.4 steht unter https://www.lua.org/manual/5.4/.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/lua-uebung
2. Lua und Bibliotheken entfernen
sudo apt purge lua5.4 lua-cjson lua-filesystem
3. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl lua wird nicht mehr gefunden.
lua -v
Quellen und Lizenz
- Offizielle Dokumentation: https://www.lua.org/docs.html
- Lizenz: Lua steht unter der MIT.
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.
Tcl
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Tcl (Tool Command Language, gesprochen wie „tickle“) ist eine kleine Skriptsprache, in der alles ein Befehl mit Wörtern ist. Sie ist leicht in andere Programme einzubauen und steckt deshalb in vielen Werkzeugen, etwa in Programmen für den Chipentwurf, in Testautomaten und in der Datenbank SQLite, deren Tests in Tcl geschrieben sind. Mit Tk gehört außerdem eine einfache Bibliothek für grafische Oberflächen dazu.
Vorbemerkungen
- Meist schon installiert: Ubuntu 26.04 bringt Tcl 8.6 oft schon mit, weil Systemprogramme wie
usb-modeswitches brauchen. Der Befehl heißttclsh. Die neue Version 9.0 gibt es zusätzlich im Pakettcl9.0mit dem Befehltclsh9.0. Die Beispiele dieser Anleitung laufen mit beiden Versionen. - tcllib: Die Standardbibliothek von Tcl ist klein. Die Sammlung tcllib ergänzt viele Pakete, etwa für CSV und JSON. Sie kommt als einziges zusätzliches Paket dazu.
- Tcl nicht entfernen: Weil
usb-modeswitchvon Tcl abhängt, entfernt die Deinstallation am Ende nur tcllib. Ohneusb-modeswitchfunktionieren manche USB-Modems und -Sticks nicht mehr. - Version: Getestet mit Tcl 8.6.17 und 9.0.3 sowie tcllib 2.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Tcl und tcllib installieren
Ist Tcl schon vorhanden, installiert apt nur tcllib.
sudo apt install tcl tcllib
Prüfen: Die Ausgabe lautet 8.6.17 oder eine neuere Version 8.6.
echo 'puts [info patchlevel]' | tclsh
Erste Schritte
3. Konsole starten
Die Eingabezeile ist ein %.
tclsh
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter:
set preis 699
expr {$preis * 4}
puts "Vier Citybikes kosten [expr {$preis * 4}] Euro"
Prüfen: Die Antworten lauten 699, 2796 und Vier Citybikes kosten 2796 Euro. $preis liest den Wert einer Variablen, eckige Klammern führen einen Befehl aus und setzen sein Ergebnis ein. Beende die Konsole mit exit.
Ein einzelnes Skript
5. Übungsordner anlegen
mkdir ~/tcl-uebung
6. In den Ordner wechseln
cd ~/tcl-uebung
7. Skript anlegen
nano lager.tcl
Füge diesen Inhalt ein (Strg+Umschalt+V):
# Lagerbestand eines Fahrradladens
set bestand {
{Citybike 699 4}
{Trekkingrad 899 0}
{Lastenrad 3490 1}
}
proc status {anzahl} {
if {$anzahl > 0} {
return "$anzahl auf Lager"
}
return "ausverkauft"
}
set nummer 0
set wert 0
set lieferbar {}
foreach rad $bestand {
lassign $rad modell preis anzahl
incr nummer
puts [format "%d. %-12s %5d Euro, %s" $nummer $modell $preis [status $anzahl]]
incr wert [expr {$preis * $anzahl}]
if {$anzahl > 0} {
lappend lieferbar $modell
}
}
puts "Sofort lieferbar: [join $lieferbar {, }]"
puts "Lagerwert: $wert Euro"
- Alles ist ein Befehl – jede Zeile beginnt mit einem Befehl wie
set,procoderputs, danach folgen seine Wörter. - Listen – der Bestand ist eine Liste aus Listen, geschrieben in geschweiften Klammern. Leerzeichen trennen die Elemente.
- Geschweifte Klammern – schützen ihren Inhalt vor dem sofortigen Auswerten. Deshalb stehen der Rumpf von
procund die Bedingung vonifdarin. lassign– verteilt die Elemente einer Liste auf Variablen.incrundlappend– erhöhen eine Zahl bzw. hängen ein Element an eine Liste an.expr {…}– rechnet. Die geschweiften Klammern gehören dazu und machen die Rechnung schneller und sicherer.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Skript ausführen
tclsh lager.tcl
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
Namensraum, tcllib und Tests
9. Projektordner anlegen
mkdir ~/umsatz-tcl
10. In den Projektordner wechseln
cd ~/umsatz-tcl
11. Funktion in einem Namensraum anlegen
nano umsatz.tcl
Füge diesen Inhalt ein:
package require csv
namespace eval umsatz {
namespace export summen
# Zählt den Umsatz je Modell zusammen.
# Jede Zeile hat die Form "Modell;Anzahl;Preis".
proc summen {zeilen} {
set ergebnis [dict create]
foreach zeile $zeilen {
lassign [csv::split $zeile ";"] modell anzahl preis
dict incr ergebnis $modell [expr {$anzahl * $preis}]
}
return $ergebnis
}
}
package require csv– lädt das CSV-Paket aus tcllib.csv::splitzerlegt eine Zeile und beachtet dabei auch Anführungszeichen.namespace eval– legt den Namensraumumsatzan. Die Funktion heißt von außenumsatz::summen.dict– ein Wörterbuch.dict increrhöht einen Eintrag und legt ihn an, falls es ihn noch nicht gibt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Hauptprogramm anlegen
nano main.tcl
Füge diesen Inhalt ein:
package require json::write
source [file join [file dirname [info script]] umsatz.tcl]
if {$argc != 1} {
puts stderr "Aufruf: tclsh main.tcl DATEI"
exit 1
}
set kanal [open [lindex $argv 0]]
set zeilen [split [string trim [read $kanal]] "\n"]
close $kanal
set tabelle [umsatz::summen $zeilen]
foreach {modell betrag} [lsort -stride 2 -index 1 -integer -decreasing $tabelle] {
puts [format "%-12s %5d Euro" $modell $betrag]
}
set felder {}
dict for {modell betrag} $tabelle {
lappend felder $modell $betrag
}
json::write indented 0
set aus [open umsatz.json w]
puts $aus [json::write object {*}$felder]
close $aus
puts "Gespeichert: umsatz.json"
source– lädt die Dateiumsatz.tclaus demselben Ordner wie das Skript.$argcund$argv– Anzahl und Liste der Argumente beim Aufruf.open,read,close– öffnen, lesen und schließen eine Datei.split … "\n"zerlegt den Inhalt in Zeilen.lsort -stride 2 -index 1– sortiert das Wörterbuch paarweise nach dem zweiten Wert, dem Umsatz, absteigend.json::write object– aus tcllib, baut ein JSON-Objekt.{*}breitet die Liste in einzelne Wörter aus.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Programm starten
tclsh main.tcl verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}.
15. Tests anlegen
Tcl bringt das Testpaket tcltest schon mit.
nano umsatz.test
Füge diesen Inhalt ein:
package require tcltest
namespace import tcltest::*
source [file join [file dirname [info script]] umsatz.tcl]
test summen-1 {Umsatz je Modell zusammenzählen} -body {
umsatz::summen {A;2;10 B;1;50 A;1;10}
} -result {A 30 B 50}
test summen-2 {leere Eingabe} -body {
umsatz::summen {}
} -result {}
cleanupTests
test NAME BESCHREIBUNG -body … -result …– führt den Rumpf aus und vergleicht sein Ergebnis mit dem erwarteten Wert. Ein Wörterbuch ist dabei einfach eine Liste aus Schlüsseln und Werten.cleanupTests– gibt am Ende die Zusammenfassung aus.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Tests ausführen
tclsh umsatz.test
Prüfen: Die Ausgabe lautet umsatz.test: Total 2 Passed 2 Skipped 0 Failed 0.
Wie geht es weiter?
- Grafische Oberflächen:
sudo apt install tkinstalliert Tk. Mitwishstatttclshund wenigen Zeilen wiebutton .b -text Hallo -command exit; pack .bentsteht ein Fenster. - Tcl 9.0:
sudo apt install tcl9.0installiert die neue Version zusätzlich. Sie startet mittclsh9.0,tclshbleibt bei 8.6. - Weitere Pakete: Eine Übersicht über die mehr als 100 Module von tcllib steht unter https://core.tcl-lang.org/tcllib.
- Dokumentation: Handbuch und Einführungen unter https://www.tcl-lang.org/doc/. In der Konsole zeigt
info commandsalle verfügbaren Befehle.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/tcl-uebung ~/umsatz-tcl
2. tcllib entfernen
Tcl selbst bleibt installiert, weil Systemprogramme es brauchen.
sudo apt purge tcllib
Prüfen: Das CSV-Paket wird nicht mehr gefunden, die Meldung lautet can't find package csv.
echo 'package require csv' | tclsh
Quellen und Lizenz
- Offizielle Dokumentation: https://www.tcl.tk/doc/
- Lizenz: Tcl steht unter der Tcl/Tk License (BSD-Stil).
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.
Haskell
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Haskell ist eine rein funktionale Programmiersprache: Programme bestehen aus Funktionen ohne Nebenwirkungen, Werte ändern sich nach dem Anlegen nicht mehr, und ein strenges Typsystem findet viele Fehler schon beim Übersetzen. Haskell wird in Forschung und Lehre viel genutzt, aber auch für Compiler, Finanzsoftware und Werkzeuge wie Pandoc.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert den Compiler GHC 9.10 im Paket
ghcund das Bauwerkzeug cabal im Paketcabal-install. Zusammen sind das sieben Pakete mit knapp 1 GB. - GHC und cabal:
ghcübersetzt einzelne Dateien,ghciist die interaktive Konsole,runghcführt eine Datei direkt aus.cabalverwaltet Projekte und lädt Bibliotheken von Hackage, dem zentralen Paketarchiv. - Paketverzeichnis von Hackage: Bevor cabal ein Projekt anlegen oder bauen kann, lädt es mit
cabal updatedas Verzeichnis aller Pakete auf Hackage. Im Test belegte es 1,2 GB in~/.cache/cabal. - GHCup: Auf der Website von Haskell wird oft GHCup empfohlen, ein Installationsprogramm für neuere Versionen. Für den Einstieg reicht die Fassung aus
apt. - Version: Getestet mit GHC 9.10.3 und cabal-install 3.12.1 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. GHC und cabal installieren
sudo apt install ghc cabal-install
Prüfen: Die Ausgabe lautet The Glorious Glasgow Haskell Compilation System, version 9.10.3.
ghc --version
Erste Schritte
3. Interaktive Konsole starten
Die Eingabezeile beginnt mit ghci>.
ghci
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter:
map (*2) [1..5]
sum [1..100]
Prüfen: Die Ausgaben lauten [2,4,6,8,10] und 5050. map wendet eine Funktion auf jedes Element an, [1..5] ist die Liste von 1 bis 5. Beende die Konsole mit :quit.
Ein einzelnes Programm
5. Übungsordner anlegen
mkdir ~/haskell-uebung
6. In den Ordner wechseln
cd ~/haskell-uebung
7. Quelltext anlegen
nano lager.hs
Füge diesen Inhalt ein (Strg+Umschalt+V):
-- Lagerbestand eines Fahrradladens
import Data.List (intercalate)
data Fahrrad = Fahrrad
{ modell :: String
, preis :: Int
, anzahl :: Int
}
bestand :: [Fahrrad]
bestand =
[ Fahrrad "Citybike" 699 4
, Fahrrad "Trekkingrad" 899 0
, Fahrrad "Lastenrad" 3490 1
]
status :: Fahrrad -> String
status rad
| anzahl rad > 0 = show (anzahl rad) ++ " auf Lager"
| otherwise = "ausverkauft"
zeile :: Fahrrad -> String
zeile rad = modell rad ++ ": " ++ show (preis rad) ++ " Euro, " ++ status rad
lagerwert :: [Fahrrad] -> Int
lagerwert raeder = sum [preis r * anzahl r | r <- raeder]
main :: IO ()
main = do
mapM_ (putStrLn . zeile) bestand
let lieferbar = [modell r | r <- bestand, anzahl r > 0]
putStrLn ("Sofort lieferbar: " ++ intercalate ", " lieferbar)
putStrLn ("Lagerwert: " ++ show (lagerwert bestand) ++ " Euro")
data Fahrrad– ein eigener Datentyp mit drei benannten Feldern. Die Feldnamen sind zugleich Funktionen:preis radliefert den Preis.- Typangaben –
status :: Fahrrad -> Stringheißt: Die Funktion bekommt ein Fahrrad und liefert einen Text. GHC würde die Typen auch selbst erkennen, ausgeschrieben sind sie aber eine gute Dokumentation. - Wächter
|– wählen je nach Bedingung einen Fall aus.otherwisegilt, wenn keiner der vorigen zutrifft. - Listenbeschreibung –
[preis r * anzahl r | r <- raeder]bildet aus jedem Radrden Wert seiner Räder. Hinter einem Komma können Bedingungen folgen, wie beilieferbar. main– der Startpunkt. Ein- und Ausgaben stehen in einemdo-Block.mapM_führtputStrLn . zeilefür jedes Rad aus, der Punkt verkettet zwei Funktionen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Programm direkt ausführen
runghc übersetzt und startet die Datei in einem Schritt.
runghc lager.hs
Prüfen: Die Ausgabe lautet:
Citybike: 699 Euro, 4 auf Lager
Trekkingrad: 899 Euro, ausverkauft
Lastenrad: 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
9. Eigenständiges Programm erzeugen
-O2 schaltet die Optimierungen ein, -Wall alle Warnungen. GHC legt neben dem Programm lager noch Zwischendateien mit den Endungen .o und .hi an.
ghc -O2 -Wall lager.hs
Prüfen: GHC meldet Linking lager ohne Warnungen. Das Programm liefert dieselbe Ausgabe wie in Schritt 8.
./lager
Ein Projekt mit cabal
10. Paketverzeichnis von Hackage laden
Ohne dieses Verzeichnis kann cabal weder Projekte anlegen noch bauen. Der Download dauert etwa eine Viertelminute, belegt aber 1,2 GB.
cabal update
Prüfen: Die Ausgabe endet mit The index-state is set to … und dem aktuellen Datum.
11. Projektordner anlegen
mkdir ~/lager-hs
12. In den Projektordner wechseln
cd ~/lager-hs
13. Projekt anlegen
--non-interactive übernimmt alle Vorgaben, ohne nachzufragen. --exe legt ein ausführbares Programm an. Name und E-Mail-Adresse für die Projektbeschreibung übernimmt cabal aus den Einstellungen von Git, falls vorhanden.
cabal init --non-interactive --exe --package-name=lager-hs
Prüfen: Im Ordner liegen die Projektbeschreibung lager-hs.cabal und das Programm app/Main.hs. Die Warnung No synopsis given ist harmlos.
14. Bibliothek eintragen
Das Programm soll die Bibliothek containers verwenden. Sie gehört zum Lieferumfang von GHC und muss nicht heruntergeladen werden, cabal muss aber von ihr wissen.
nano lager-hs.cabal
Suche die Zeile, die mit build-depends: beginnt, und ergänze am Ende , containers:
build-depends: base ^>=4.20.2.0, containers
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm schreiben
nano app/Main.hs
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
module Main where
import qualified Data.Map.Strict as Map
-- Verkäufe als Liste von (Modell, Anzahl)
verkaeufe :: [(String, Int)]
verkaeufe =
[ ("Citybike", 2)
, ("Lastenrad", 1)
, ("Citybike", 3)
, ("Trekkingrad", 1)
, ("Citybike", 1)
]
main :: IO ()
main = do
let summen = Map.fromListWith (+) verkaeufe
mapM_ (\(modell, anzahl) -> putStrLn (modell ++ ": " ++ show anzahl)) (Map.toList summen)
putStrLn ("Meistverkauft: " ++ fst (Map.foldrWithKey bester ("", 0) summen))
where
bester modell anzahl (bisher, hoechst)
| anzahl > hoechst = (modell, anzahl)
| otherwise = (bisher, hoechst)
import qualified … as Map– lädt das Modul so, dass alle seine Funktionen mitMap.beginnen. Das verhindert Verwechslungen mit gleichnamigen Funktionen für Listen.Map.fromListWith (+)– baut aus der Liste ein Wörterbuch. Kommt ein Modell mehrfach vor, werden die Anzahlen addiert.\(modell, anzahl) -> …– eine namenlose Funktion, die ein Paar auseinandernimmt.where– definiert die Hilfsfunktionbester, die beim Durchlaufen des Wörterbuchs das Modell mit der höchsten Anzahl behält.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Projekt bauen und starten
cabal run übersetzt das Projekt im Ordner dist-newstyle und startet es.
cabal run
Prüfen: Nach den Meldungen des Compilers lautet die Ausgabe:
Citybike: 6
Lastenrad: 1
Trekkingrad: 1
Meistverkauft: Citybike
Das Wörterbuch hält die Modelle alphabetisch sortiert.
Wie geht es weiter?
- Bibliotheken von Hackage: Ein Paketname unter
build-depends, der nicht zu GHC gehört, z. B.split, wird beim nächstencabal runautomatisch heruntergeladen und übersetzt. Viele Bibliotheken gibt es auch als Ubuntu-Paket mit dem Namenlibghc-…-dev, die cabal ebenfalls findet. - Code verbessern:
sudo apt install hlintinstalliert ein Werkzeug, das Vereinfachungen vorschlägt, z. B.hlint app/Main.hs. - Editor: Für Visual Studio Code gibt es die Erweiterung „Haskell“. Sie braucht den Haskell Language Server, der meist über GHCup installiert wird.
- Dokumentation: Einstieg und Bücher unter https://www.haskell.org/documentation/, Bibliotheken unter https://hackage.haskell.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/haskell-uebung ~/lager-hs
2. Daten von cabal entfernen
Löscht das Paketverzeichnis von Hackage, heruntergeladene Bibliotheken und die Einstellungen von cabal.
rm -rf ~/.cache/cabal ~/.config/cabal ~/.local/state/cabal
3. GHC und cabal entfernen
sudo apt purge ghc cabal-install
4. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl ghc wird nicht mehr gefunden.
ghc --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.haskell.org/documentation/
- Lizenz: GHC steht unter der BSD-3-Clause.
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.
Perl
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Perl ist eine Skriptsprache, die besonders stark im Bearbeiten von Text ist: Dateien durchsuchen, Daten umformen, Berichte erzeugen. Sie ist seit über 35 Jahren ein fester Bestandteil von Linux und steckt in vielen Systemwerkzeugen. Mit CPAN gibt es ein riesiges Archiv an Zusatzmodulen.
Vorbemerkungen
- Schon installiert: Ubuntu 26.04 bringt Perl 5.40 von Haus aus mit, weil viele Systemprogramme es brauchen. Diese Anleitung ergänzt die Dokumentation und Zusatzmodule.
- Module auf zwei Wegen: Viele Module von CPAN gibt es bei Ubuntu als Paket mit dem Namen
lib…-perl, etwalibtext-csv-perlfür das ModulText::CSV. Sie werden mitaptinstalliert. Alle übrigen installiert das Werkzeugcpanmvon CPAN in den Ordner~/perl5, ohne Administratorrechte. - Perl nicht entfernen: Das Paket
perlselbst darf nicht deinstalliert werden, sonst funktionieren grundlegende Teile von Ubuntu nicht mehr. Die Deinstallation am Ende entfernt nur, was diese Anleitung hinzufügt. - Version: Getestet mit Perl 5.40.1 und cpanminus 1.7048 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Dokumentation und Module installieren
perl-doc– die Dokumentation, aufrufbar mitperldoclibtext-csv-perl– liest und schreibt CSV-Dateiencpanminus– das Werkzeugcpanmzum Installieren von Modulen aus CPANliblocal-lib-perl– richtet einen eigenen Modulordner im Home-Ordner ein
sudo apt install perl-doc libtext-csv-perl cpanminus liblocal-lib-perl
Im Test kamen dabei 67 Pakete auf den Rechner, fast alles kleine Perl-Module, die cpanm braucht. Für JSON ist kein Zusatzpaket nötig: Das Modul JSON::PP gehört schon zu Perl.
Prüfen: Die zweite Zeile beginnt mit This is perl 5, version 40.
perl -v
3. Dokumentation ausprobieren
perldoc -f erklärt eine eingebaute Funktion, hier push. Beende die Anzeige mit q.
perldoc -f push
Ein Skript mit CSV und JSON
4. Übungsordner anlegen
mkdir ~/perl-uebung
5. In den Ordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/perl-uebung
6. CSV-Datei anlegen
Ausgedachte Verkäufe eines Fahrradladens, mit Semikolon getrennt, wie es Tabellenprogramme mit deutschen Einstellungen schreiben.
nano verkauf.csv
Füge diesen Inhalt ein (Strg+Umschalt+V):
datum;modell;anzahl;preis
2026-09-01;Citybike;2;699
2026-09-02;Lastenrad;1;3490
2026-09-02;Citybike;3;699
2026-09-05;Trekkingrad;1;899
2026-09-08;Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
7. Skript anlegen
Das Skript zählt Stück und Umsatz je Modell zusammen, gibt sie nach Umsatz sortiert aus und speichert die Umsätze als JSON.
nano auswertung.pl
Füge diesen Inhalt ein:
#!/usr/bin/perl
use strict;
use warnings;
use utf8;
use open qw(:std :encoding(UTF-8));
use Text::CSV;
use JSON::PP;
my $csv = Text::CSV->new({ sep_char => ';', binary => 1, auto_diag => 1 });
open(my $datei, '<:encoding(UTF-8)', 'verkauf.csv') or die "verkauf.csv: $!";
$csv->header($datei);
my (%stueck, %umsatz);
while (my $zeile = $csv->getline_hr($datei)) {
$stueck{ $zeile->{modell} } += $zeile->{anzahl};
$umsatz{ $zeile->{modell} } += $zeile->{anzahl} * $zeile->{preis};
}
close($datei);
for my $modell (sort { $umsatz{$b} <=> $umsatz{$a} } keys %umsatz) {
printf "%-12s %2d Stück %6d Euro\n", $modell, $stueck{$modell}, $umsatz{$modell};
}
my $json = JSON::PP->new->canonical->pretty;
open(my $aus, '>', 'umsatz.json') or die "umsatz.json: $!";
print {$aus} $json->encode(\%umsatz);
close($aus);
print "Gespeichert: umsatz.json\n";
use strict; use warnings;– verlangen, dass jede Variable mitmyangelegt wird, und melden verdächtige Stellen. Diese zwei Zeilen gehören an den Anfang jedes Skripts.use utf8unduse open …– der Quelltext und alle Ein- und Ausgaben verwenden UTF-8. Ohne diese Zeilen würde das „ü“ in „Stück“ falsch ausgegeben.- Sigillen – das Zeichen vor dem Namen zeigt die Art der Variablen:
$für einen einzelnen Wert,@für eine Liste,%für ein Wörterbuch (Hash). $csv->header– liest die Kopfzeile,getline_hrdanach jede Zeile als Hash mit den Spaltennamen als Schlüssel.+=– ein Hash-Eintrag, den es noch nicht gibt, zählt als 0. Deshalb kann man ohne Vorbereitung aufaddieren.sort { $umsatz{$b} <=> $umsatz{$a} }– sortiert die Modelle absteigend nach Umsatz.<=>vergleicht Zahlen.JSON::PP– gehört zum Lieferumfang von Perl.canonicalsortiert die Schlüssel,prettyrückt ein.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Syntax prüfen
perl -c übersetzt das Skript nur zur Probe, ohne es auszuführen.
perl -c auswertung.pl
Prüfen: Die Ausgabe lautet auswertung.pl syntax OK.
9. Skript ausführen
perl auswertung.pl
Prüfen: Die Ausgabe lautet:
Citybike 6 Stück 4144 Euro
Lastenrad 1 Stück 3490 Euro
Trekkingrad 1 Stück 899 Euro
Gespeichert: umsatz.json
10. JSON-Datei ansehen
cat umsatz.json
Prüfen: Die Datei enthält die drei Modelle alphabetisch sortiert, z. B. "Citybike" : 4144.
Module von CPAN
Als Beispiel dient Text::Table::Tiny, das Tabellen mit Rahmen im Terminal zeichnet. Es ist nicht als Ubuntu-Paket erhältlich.
11. Eigenen Modulordner einrichten
perl -Mlocal::lib gibt Befehle aus, die Perl und cpanm auf den Ordner ~/perl5 umstellen. Damit das in jedem neuen Terminal gilt, kommt der Aufruf in die Datei ~/.bashrc.
nano ~/.bashrc
Gehe mit Strg+End ans Ende der Datei und füge diese Zeile hinzu:
eval "$(perl -Mlocal::lib)"
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Einstellungen im aktuellen Terminal laden
source liest die geänderte Datei sofort ein. Beim ersten Mal legt local::lib den Ordner ~/perl5 an und meldet Attempting to create directory /home/…/perl5.
source ~/.bashrc
Prüfen: Die Ausgabe beginnt mit /home/ und endet mit /perl5/lib/perl5.
echo $PERL5LIB
13. Modul von CPAN installieren
cpanm lädt das Modul samt allen Abhängigkeiten von CPAN, führt deren Tests aus und installiert sie nach ~/perl5.
cpanm Text::Table::Tiny
Prüfen: Die Ausgabe endet mit Successfully installed Text-Table-Tiny-1.03 und 4 distributions installed. Die drei weiteren sind Abhängigkeiten.
14. Skript mit dem neuen Modul anlegen
nano tabelle.pl
Füge diesen Inhalt ein:
#!/usr/bin/perl
use strict;
use warnings;
use utf8;
use open qw(:std :encoding(UTF-8));
use Text::Table::Tiny qw(generate_table);
my @zeilen = (
[ 'Modell', 'Preis', 'Auf Lager' ],
[ 'Citybike', 699, 4 ],
[ 'Trekkingrad', 899, 0 ],
[ 'Lastenrad', 3490, 1 ],
);
print generate_table(rows => \@zeilen, header_row => 1, style => 'boxrule'), "\n";
[ … ]– eine Liste in eckigen Klammern ist eine Referenz auf eine Liste. So entsteht eine Liste von Zeilen.\@zeilen– übergibt eine Referenz auf die Liste, nicht ihre Kopie.header_row => 1– die erste Zeile ist die Überschrift.style => 'boxrule'zeichnet Rahmen aus Linienzeichen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Skript ausführen
perl tabelle.pl
Prüfen: Die Ausgabe lautet:
┌─────────────┬───────┬───────────┐
│ Modell │ Preis │ Auf Lager │
├─────────────┼───────┼───────────┤
│ Citybike │ 699 │ 4 │
│ Trekkingrad │ 899 │ 0 │
│ Lastenrad │ 3490 │ 1 │
└─────────────┴───────┴───────────┘
Wie geht es weiter?
- Einzeiler: Perl ist im Terminal sehr nützlich.
perl -ne 'print if /Citybike/' verkauf.csvgibt alle Zeilen mit „Citybike“ aus,perl -pi -e 's/Citybike/Stadtrad/g' datei.txtersetzt ein Wort direkt in einer Datei. - Module suchen:
apt searchmit dem Modulnamen findet Ubuntu-Pakete, z. B.apt search libdatetime. Alle Module von CPAN sind unter https://metacpan.org beschrieben. - Code aufräumen:
sudo apt install perltidyformatiert Skripte einheitlich,libperl-critic-perlbringtperlcriticmit, das Verbesserungen vorschlägt. - Webanwendungen: Die Frameworks Mojolicious (
libmojolicious-perl) und Dancer2 (libdancer2-perl) gibt es als Ubuntu-Pakete. - Dokumentation:
perldoc perlintroist eine kurze Einführung,perldoc perlfunclistet alle eingebauten Funktionen.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/perl-uebung
2. Eintrag in ~/.bashrc entfernen
nano ~/.bashrc
Suche mit Strg+W nach local::lib und drücke Enter. Lösche die Zeile eval "$(perl -Mlocal::lib)" mit Strg+K. Speichere mit Strg+O und Enter und beende nano mit Strg+X. Öffne danach ein neues Terminal.
3. Module von CPAN und Zwischenspeicher entfernen
~/perl5 enthält die mit cpanm installierten Module, ~/.cpanm heruntergeladene Dateien und Protokolle.
rm -rf ~/perl5 ~/.cpanm
4. Zusätzliche Pakete entfernen
Entfernt nur die Pakete aus Schritt 2 der Installation. Perl selbst bleibt erhalten.
sudo apt purge perl-doc libtext-csv-perl cpanminus liblocal-lib-perl
5. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl cpanm wird nicht mehr gefunden, perl -v funktioniert weiterhin.
cpanm --version
Quellen und Lizenz
- Offizielle Dokumentation: https://perldoc.perl.org/
- Lizenz: Perl steht unter der Artistic License 1.0 / GPL-1.0-or-later.
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.
Fortran
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Fortran ist die älteste noch verbreitete Programmiersprache und wurde für Berechnungen in Wissenschaft und Technik geschaffen. Heutiges Fortran hat mit den Lochkarten der 1950er-Jahre wenig gemein: Es bietet Module, Rechnen mit ganzen Feldern auf einmal und Parallelisierung. Wettermodelle, Strömungs- und Klimasimulationen und viele Rechenbibliotheken sind in Fortran geschrieben.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert den GNU-Fortran-Compiler gfortran 15 und den Fortran Package Manager fpm als Pakete. Zusammen sind das sechs Pakete.
- fpm: Er legt Projekte an, übersetzt sie, führt Tests aus und lädt Bibliotheken aus Git-Repositorys. Die Version aus Ubuntu meldet sich als
0.8.0, alpha, obwohl das Paket die Nummer 0.12.0 trägt. Das ist nur eine falsche Angabe im Programm. - Git:
fpm newlegt für jedes neue Projekt ein Git-Repository an und übernimmt Name und E-Mail aus den Git-Einstellungen in die Projektdatei. - Version: Getestet mit gfortran 15.2.0 und fortran-fpm 0.12.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. gfortran, fpm und Git installieren
Ist git schon vorhanden, meldet apt das nur.
sudo apt install gfortran fortran-fpm git
Prüfen: Die erste Zeile lautet GNU Fortran (Ubuntu 15.2.0-16ubuntu1) 15.2.0.
gfortran --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/fortran-uebung
4. In den Ordner wechseln
cd ~/fortran-uebung
5. Quelltext anlegen
Die Endung .f90 steht für Fortran in freier Schreibweise, wie es seit Fortran 90 üblich ist.
nano lager.f90
Füge diesen Inhalt ein (Strg+Umschalt+V):
program lager
implicit none
character(len=12) :: modell(3) = [character(len=12) :: "Citybike", "Trekkingrad", "Lastenrad"]
integer :: preis(3) = [699, 899, 3490]
integer :: anzahl(3) = [4, 0, 1]
integer :: i
do i = 1, size(modell)
if (anzahl(i) > 0) then
print '(A12, I6, " Euro", I4, " auf Lager")', modell(i), preis(i), anzahl(i)
else
print '(A12, I6, " Euro", " ausverkauft")', modell(i), preis(i)
end if
end do
print '(A, I0, A)', "Lagerwert: ", sum(preis * anzahl), " Euro"
print '(A, A)', "Teuerstes Modell: ", trim(modell(maxloc(preis, dim=1)))
end program lager
implicit none– jede Variable muss angelegt werden. Ohne diese Zeile würde Fortran nach altem Brauch Variablen, die mitibisnbeginnen, als ganze Zahlen annehmen. Das verursacht leicht Fehler.- Felder –
preis(3)ist ein Feld mit drei Werten. Die Zählung beginnt bei 1. - Rechnen mit ganzen Feldern –
preis * anzahlmultipliziert die Felder Element für Element,sumaddiert das Ergebnis. Eine Schleife ist dafür nicht nötig. maxloc– liefert die Position des größten Werts.trimentfernt die Leerzeichen, mit denen ein Text auf 12 Zeichen aufgefüllt ist.- Ausgabeformat –
'(A12, I6, …)'legt fest, wie die Werte erscheinen:A12ist ein Text mit 12 Zeichen,I6eine ganze Zahl mit 6 Stellen,I0eine ganze Zahl ohne führende Leerzeichen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen
-Wall schaltet die Warnungen ein, -o lager legt den Namen des Programms fest.
gfortran -Wall -o lager lager.f90
Prüfen: Der Befehl gibt nichts aus.
7. Programm starten
./lager
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro 4 auf Lager
Trekkingrad 899 Euro ausverkauft
Lastenrad 3490 Euro 1 auf Lager
Lagerwert: 6286 Euro
Teuerstes Modell: Lastenrad
Ein Projekt mit fpm
8. In das Home-Verzeichnis wechseln
fpm new legt den Projektordner im aktuellen Ordner an.
cd ~
9. Projekt anlegen
Legt den Ordner statistik mit der Projektdatei fpm.toml, einem Modul in src, einem Hauptprogramm in app und einem Test in test an.
fpm new statistik
Prüfen: Die letzte Zeile lautet Leeres Git-Repository in /home/…/statistik/.git/ initialisiert. Hinweise von Git zum Namen des Hauptzweigs davor sind harmlos.
10. In den Projektordner wechseln
cd ~/statistik
11. Modul schreiben
Ein Modul fasst Funktionen zusammen, die andere Programmteile mit use einbinden.
nano src/statistik.f90
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
module statistik
implicit none
private
public :: mittelwert, standardabweichung
integer, parameter, public :: dp = kind(1.0d0)
contains
pure function mittelwert(werte) result(m)
real(dp), intent(in) :: werte(:)
real(dp) :: m
m = sum(werte) / size(werte)
end function mittelwert
pure function standardabweichung(werte) result(s)
real(dp), intent(in) :: werte(:)
real(dp) :: s
s = sqrt(sum((werte - mittelwert(werte))**2) / (size(werte) - 1))
end function standardabweichung
end module statistik
privateundpublic– nur die ausdrücklich freigegebenen Namen sind außerhalb des Moduls sichtbar.dp = kind(1.0d0)– die Art für Kommazahlen mit doppelter Genauigkeit (etwa 15 Stellen).real(dp)verwendet sie.pure function– eine Funktion ohne Nebenwirkungen. Der Compiler darf sie deshalb besser optimieren.werte(:)– ein Feld beliebiger Länge.intent(in)sagt, dass die Funktion es nur liest.werte - mittelwert(werte)– zieht den Mittelwert von jedem Element ab.**2quadriert.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Hauptprogramm schreiben
nano app/main.f90
Lösche den bisherigen Inhalt und füge diesen ein:
program main
use statistik, only: dp, mittelwert, standardabweichung
implicit none
! Tageshöchsttemperaturen einer Woche in Grad Celsius (Beispielwerte)
real(dp), parameter :: temperatur(7) = [18.5_dp, 21.0_dp, 19.5_dp, 23.0_dp, 24.5_dp, 20.0_dp, 17.5_dp]
print '(A, F6.2, A)', "Mittelwert: ", mittelwert(temperatur), " Grad"
print '(A, F6.2, A)', "Standardabweichung: ", standardabweichung(temperatur), " Grad"
print '(A, I0)', "Tage über dem Mittel: ", count(temperatur > mittelwert(temperatur))
end program main
use statistik, only: …– bindet nur die genannten Namen aus dem Modul ein.18.5_dp– die Endung_dpmacht die Zahl zu einer Zahl doppelter Genauigkeit.count(temperatur > …)– der Vergleich liefert für jedes Element wahr oder falsch,countzählt die wahren.F6.2– eine Kommazahl mit 6 Zeichen, davon 2 Nachkommastellen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Projekt übersetzen und starten
fpm run übersetzt Modul und Hauptprogramm im Ordner build und startet das Programm.
fpm run
Prüfen: Nach Project compiled successfully. lautet die Ausgabe:
Mittelwert: 20.57 Grad
Standardabweichung: 2.47 Grad
Tage über dem Mittel: 3
14. Test schreiben
nano test/check.f90
Lösche den bisherigen Inhalt und füge diesen ein:
program check
use statistik, only: dp, mittelwert, standardabweichung
implicit none
real(dp), parameter :: werte(4) = [2.0_dp, 4.0_dp, 4.0_dp, 6.0_dp]
real(dp), parameter :: genauigkeit = 1.0e-12_dp
if (abs(mittelwert(werte) - 4.0_dp) > genauigkeit) error stop "Mittelwert falsch"
if (abs(standardabweichung(werte) - sqrt(8.0_dp / 3.0_dp)) > genauigkeit) error stop "Standardabweichung falsch"
print '(A)', "Alle Tests bestanden."
end program check
- Kommazahlen vergleichen – wegen Rundungen prüft man nicht auf Gleichheit, sondern ob die Abweichung kleiner als eine Genauigkeit ist.
error stop– beendet das Programm mit einer Fehlermeldung. fpm wertet den Test dann als fehlgeschlagen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Tests ausführen
fpm test
Prüfen: Die letzte Zeile lautet Alle Tests bestanden.
16. Optimiert übersetzen
Ohne weitere Angabe übersetzt fpm mit Prüfungen zur Fehlersuche. --profile release schaltet stattdessen die Optimierungen ein. Für große Berechnungen ist das deutlich schneller.
fpm run --profile release
Wie geht es weiter?
- Programm installieren:
fpm installkopiert das Programm nach~/.local/bin, sodass es überall alsstatistikaufrufbar ist. - Bibliotheken: In
fpm.tomllassen sich unter[dependencies]Git-Repositorys eintragen, z. B. die Standardbibliothek stdlib von Fortran-Lang. fpm lädt und übersetzt sie selbst. Rechenbibliotheken wie BLAS und LAPACK gibt es als Ubuntu-Pakete (libopenblas-dev,liblapack-dev). - Parallel rechnen: gfortran beherrscht OpenMP. Mit
-fopenmpverteilen Anweisungen wie!$omp parallel doSchleifen auf alle Prozessorkerne. - Editor: Der Sprachserver fortls bringt Autovervollständigung in Visual Studio Code und Neovim.
- Dokumentation: Einstieg, Übersicht über Bibliotheken und fpm unter https://fortran-lang.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/fortran-uebung ~/statistik
2. gfortran und fpm entfernen
git bleibt installiert, weil es meist auch für anderes gebraucht wird.
sudo apt purge gfortran fortran-fpm
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für gfortran mitinstalliert wurden, z. B. gfortran-15. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl gfortran wird nicht mehr gefunden.
gfortran --version
Quellen und Lizenz
- Offizielle Dokumentation: https://gcc.gnu.org/wiki/GFortran
- Lizenz: GFortran steht unter der GPL-3.0-or-later.
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.
Zig
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zig ist eine junge Systemprogrammiersprache, die als moderne Alternative zu C gedacht ist. Sie erzeugt schnelle, kleine Programme ohne versteckte Speicherzugriffe und ohne Laufzeitumgebung. Den Speicher verwaltet man ausdrücklich selbst, Zig hilft aber dabei, Fehler zu finden. Außerdem kann der Zig-Compiler auch C-Code übersetzen und für andere Betriebssysteme bauen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 bietet zwei Versionen an: Zig 0.14 über das Paket
zigund Zig 0.15 im Paketzig0.15. Die Anleitung verwendet 0.15. - Noch vor Version 1.0: Zig ändert seine Standardbibliothek noch mit fast jeder Version. Gerade bei der Ausgabe von Text unterscheidet sich 0.15 deutlich von 0.14. Viele Beispiele im Netz passen deshalb nicht zur installierten Version. Der Code in dieser Anleitung ist für 0.15 geschrieben.
- Befehlsname: Das Paket
zig0.15stellt den Befehlzig0.15bereit. Schritt 3 legt eine Verknüpfung an, damit er wie üblichzigheißt. - Zwischenspeicher: Zig legt Übersetzungsergebnisse in
~/.cache/zigund im Projektordner unter.zig-cacheab. - Version: Getestet mit Zig 0.15.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Zig installieren
Zig bringt seinen eigenen Compiler auf Basis von LLVM mit. Deshalb kommen etwa zehn Pakete auf den Rechner.
sudo apt install zig0.15
3. Ordner für eigene Befehle anlegen
~/.local/bin ist bei Ubuntu für Programme gedacht, die nur dem eigenen Benutzer gehören. -p meldet keinen Fehler, wenn es den Ordner schon gibt.
mkdir -p ~/.local/bin
4. Verknüpfung zig anlegen
ln -s legt eine Verknüpfung an. Danach startet zig den Befehl zig0.15.
ln -s /usr/bin/zig0.15 ~/.local/bin/zig
5. Suchpfad neu einlesen
Ubuntu nimmt ~/.local/bin beim Anmelden in den Suchpfad auf, aber nur, wenn der Ordner dann schon existiert. Hast du ihn gerade erst angelegt, liest dieser Befehl die Einstellung neu ein.
source ~/.profile
Prüfen: Die Ausgabe lautet 0.15.2.
zig version
Ein einzelnes Programm
6. Übungsordner anlegen
mkdir ~/zig-uebung
7. In den Ordner wechseln
cd ~/zig-uebung
8. Quelltext anlegen
nano lager.zig
Füge diesen Inhalt ein (Strg+Umschalt+V):
const std = @import("std");
const Fahrrad = struct {
modell: []const u8,
preis: u32,
anzahl: u32,
};
const bestand = [_]Fahrrad{
.{ .modell = "Citybike", .preis = 699, .anzahl = 4 },
.{ .modell = "Trekkingrad", .preis = 899, .anzahl = 0 },
.{ .modell = "Lastenrad", .preis = 3490, .anzahl = 1 },
};
pub fn main() !void {
var puffer: [1024]u8 = undefined;
var stdout_writer = std.fs.File.stdout().writer(&puffer);
const aus = &stdout_writer.interface;
var wert: u32 = 0;
for (bestand, 1..) |rad, nummer| {
if (rad.anzahl > 0) {
try aus.print("{d}. {s:<12} {d:>5} Euro, {d} auf Lager\n", .{ nummer, rad.modell, rad.preis, rad.anzahl });
} else {
try aus.print("{d}. {s:<12} {d:>5} Euro, ausverkauft\n", .{ nummer, rad.modell, rad.preis });
}
wert += rad.preis * rad.anzahl;
}
try aus.print("Lagerwert: {d} Euro\n", .{wert});
try aus.flush();
}
constundvar–constist unveränderlich,varveränderlich. Zig verlangtconst, wo nichts verändert wird.- Typen –
u32ist eine vorzeichenlose ganze Zahl mit 32 Bit.[]const u8ist ein Stück Speicher aus Bytes, so stellt Zig Texte dar. [_]Fahrrad{ … }– ein Feld fester Länge._lässt Zig die Länge selbst zählen.- Ausgabe mit Puffer – Zig 0.15 schreibt zuerst in einen eigenen Puffer (
puffer) und gibt ihn mitflushaus. Ohneflusham Ende erscheint unter Umständen nichts. !voidundtry– die Funktion kann einen Fehler liefern.trygibt einen Fehler sofort an den Aufrufer weiter.for (bestand, 1..) |rad, nummer|– geht das Feld durch und zählt dabei ab 1 mit.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm übersetzen und starten
zig run übersetzt und startet in einem Schritt. Beim ersten Mal übersetzt Zig auch Teile der Standardbibliothek, das dauert einige Sekunden.
zig run lager.zig
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Lagerwert: 6286 Euro
10. Formatierung prüfen
zig fmt bringt Quelltext in die einheitliche Form von Zig. --check prüft nur und nennt Dateien, die abweichen.
zig fmt --check lager.zig
Prüfen: Der Befehl gibt nichts aus. Ohne --check korrigiert zig fmt die Datei selbst.
Ein Projekt mit Tests
11. Projektordner anlegen
Der Name des Ordners wird zum Namen des Projekts und des Programms.
mkdir ~/lager
12. In den Projektordner wechseln
cd ~/lager
13. Projekt anlegen
Legt die Bauanleitung build.zig, die Projektbeschreibung build.zig.zon und zwei Quelldateien an: src/root.zig für die Bibliothek und src/main.zig für das Programm.
zig init
Prüfen: Die Meldungen nennen created src/main.zig und created src/root.zig.
14. Bibliothek mit Tests schreiben
nano src/root.zig
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
//! Funktionen rund um den Lagerbestand
const std = @import("std");
pub const Fahrrad = struct {
modell: []const u8,
preis: u32,
anzahl: u32,
};
/// Summe aus Preis mal Anzahl über alle Räder
pub fn lagerwert(bestand: []const Fahrrad) u32 {
var summe: u32 = 0;
for (bestand) |rad| summe += rad.preis * rad.anzahl;
return summe;
}
/// Liefert die Modelle, die auf Lager sind. Der Aufrufer gibt die Liste wieder frei.
pub fn lieferbar(allocator: std.mem.Allocator, bestand: []const Fahrrad) !std.ArrayList([]const u8) {
var liste: std.ArrayList([]const u8) = .empty;
errdefer liste.deinit(allocator);
for (bestand) |rad| {
if (rad.anzahl > 0) try liste.append(allocator, rad.modell);
}
return liste;
}
const beispiel = [_]Fahrrad{
.{ .modell = "Citybike", .preis = 699, .anzahl = 4 },
.{ .modell = "Lastenrad", .preis = 3490, .anzahl = 0 },
};
test "lagerwert" {
try std.testing.expectEqual(@as(u32, 2796), lagerwert(&beispiel));
}
test "lieferbar" {
var liste = try lieferbar(std.testing.allocator, &beispiel);
defer liste.deinit(std.testing.allocator);
try std.testing.expectEqual(@as(usize, 1), liste.items.len);
try std.testing.expectEqualStrings("Citybike", liste.items[0]);
}
pub– macht einen Namen außerhalb der Datei sichtbar.- Allocator – Zig hat keine automatische Speicherverwaltung. Funktionen, die Speicher brauchen, bekommen einen
Allocatorübergeben. So sieht man schon an der Schnittstelle, wo Speicher angefordert wird. std.ArrayList– eine Liste, die wächst.appendfügt hinzu und kann scheitern, wenn kein Speicher mehr frei ist. Deshalb stehttrydavor.errdefer– gibt die Liste nur frei, wenn die Funktion mit einem Fehler endet.deferim Test gibt sie in jedem Fall am Ende frei.test "…"– Tests stehen direkt neben dem Code.std.testing.allocatormeldet Speicher, der nicht freigegeben wurde, als Fehler.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm schreiben
nano src/main.zig
Lösche den bisherigen Inhalt und füge diesen ein:
const std = @import("std");
const lager = @import("lager");
const bestand = [_]lager.Fahrrad{
.{ .modell = "Citybike", .preis = 699, .anzahl = 4 },
.{ .modell = "Trekkingrad", .preis = 899, .anzahl = 0 },
.{ .modell = "Lastenrad", .preis = 3490, .anzahl = 1 },
};
pub fn main() !void {
// Speicherverwaltung, die beim Beenden vergessene Freigaben meldet
var debug_allocator: std.heap.DebugAllocator(.{}) = .init;
defer _ = debug_allocator.deinit();
const allocator = debug_allocator.allocator();
var puffer: [1024]u8 = undefined;
var stdout_writer = std.fs.File.stdout().writer(&puffer);
const aus = &stdout_writer.interface;
var liste = try lager.lieferbar(allocator, &bestand);
defer liste.deinit(allocator);
try aus.print("Sofort lieferbar:", .{});
for (liste.items) |modell| try aus.print(" {s}", .{modell});
try aus.print("\nLagerwert: {d} Euro\n", .{lager.lagerwert(&bestand)});
try aus.flush();
}
@import("lager")– lädt die Bibliothek aussrc/root.zig. Den Namenlagerhatzig initinbuild.zignach dem Projektordner vergeben.DebugAllocator– eine Speicherverwaltung für die Entwicklung. Sie prüft beim Beenden (deinit), ob aller Speicher freigegeben wurde.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Programm bauen und starten
zig build run
Prüfen: Die Ausgabe lautet:
Sofort lieferbar: Citybike Lastenrad
Lagerwert: 6286 Euro
17. Tests ausführen
--summary all zeigt an, wie viele Tests gelaufen sind.
zig build test --summary all
Prüfen: Die Zusammenfassung lautet Build Summary: 5/5 steps succeeded; 2/2 tests passed.
18. Vergessene Freigabe ausprobieren (optional)
Öffne src/main.zig, lösche die Zeile defer liste.deinit(allocator); und ändere in der Zeile darüber var liste in const liste. Zig verlangt das, weil die Liste ohne deinit nie mehr verändert wird. Starte danach erneut:
zig build run
Prüfen: Nach der normalen Ausgabe meldet der DebugAllocator error(gpa): memory address … leaked und zeigt, wo der Speicher angefordert wurde. Mache die Änderung danach wieder rückgängig.
19. Klein und schnell übersetzen
-Doptimize=ReleaseSmall optimiert auf geringe Größe. Das Programm landet in zig-out/bin.
zig build -Doptimize=ReleaseSmall
Prüfen: Das Programm ist nur rund 20 KB groß und statically linked, braucht also keine weiteren Bibliotheken.
file zig-out/bin/lager
Wie geht es weiter?
- Für andere Systeme bauen:
zig build -Dtarget=x86_64-windowserzeugt eine Windows-Dateilager.exe,-Dtarget=aarch64-linuxein Programm für ARM-Rechner wie den Raspberry Pi. - C-Code übersetzen:
zig ccist ein vollständiger C-Compiler und kann z. B.gccbeim Übersetzen fremder Projekte ersetzen. - Bibliotheken:
zig fetch --save <Adresse>trägt ein Paket aus einem Git-Repository inbuild.zig.zonein. - Editor: Der Sprachserver ZLS bringt Autovervollständigung in Visual Studio Code und Neovim. Seine Version muss zur Zig-Version passen.
- Dokumentation: Die Sprachbeschreibung für 0.15 steht unter https://ziglang.org/documentation/0.15.2/.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/zig-uebung ~/lager
2. Zwischenspeicher entfernen
rm -rf ~/.cache/zig
3. Verknüpfung entfernen
rm ~/.local/bin/zig
4. Zig entfernen
sudo apt purge zig0.15 zig0.15-dev
5. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Zig mitinstalliert wurden, z. B. LLVM 20. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl zig wird nicht mehr gefunden.
zig version
Quellen und Lizenz
- Offizielle Dokumentation: https://ziglang.org/learn/
- Lizenz: Zig steht unter der MIT.
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.
D
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
D ist eine Systemprogrammiersprache, die die Geschwindigkeit von C und C++ mit dem Komfort moderner Sprachen verbinden will. Sie übersetzt in schnellen Maschinencode, hat aber eine automatische Speicherverwaltung, Bereichs- und Bibliotheksfunktionen im Stil funktionaler Sprachen und eingebaute Tests direkt im Quelltext.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert den Compiler LDC 1.41, der auf LLVM aufbaut, und den Paketmanager dub. Zusammen sind das sechs Pakete. Daneben gibt es
gdcaus der GNU Compiler Collection. Der Referenzcompiler DMD ist nicht in den Paketquellen. - Befehle: Der Compiler heißt
ldc2.dublegt Projekte an, baut sie, führt Tests aus und lädt Bibliotheken vom Paketverzeichnis https://code.dlang.org. - Standardbibliothek: Die Standardbibliothek Phobos wird fest in jedes Programm eingebunden. Die fertigen Programme brauchen deshalb keine weiteren Bibliotheken.
- Version: Getestet mit LDC 1.41.0 und dub 1.40.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. LDC und dub installieren
sudo apt install ldc dub
Prüfen: Die erste Zeile lautet LDC - the LLVM D compiler (1.41.0):.
ldc2 --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/d-uebung
4. In den Ordner wechseln
cd ~/d-uebung
5. Quelltext anlegen
nano lager.d
Füge diesen Inhalt ein (Strg+Umschalt+V):
import std.stdio;
import std.algorithm : filter, map, sum;
import std.array : join;
struct Fahrrad
{
string modell;
int preis;
int anzahl;
string status() const
{
import std.conv : to;
return anzahl > 0 ? anzahl.to!string ~ " auf Lager" : "ausverkauft";
}
}
void main()
{
auto bestand = [
Fahrrad("Citybike", 699, 4),
Fahrrad("Trekkingrad", 899, 0),
Fahrrad("Lastenrad", 3490, 1),
];
foreach (i, rad; bestand)
writefln("%d. %-12s %5d Euro, %s", i + 1, rad.modell, rad.preis, rad.status);
auto lieferbar = bestand.filter!(r => r.anzahl > 0).map!(r => r.modell);
writeln("Sofort lieferbar: ", lieferbar.join(", "));
writeln("Lagerwert: ", bestand.map!(r => r.preis * r.anzahl).sum, " Euro");
}
import– bindet Module der Standardbibliothek ein.: filter, map, sumholt nur die genannten Funktionen.struct– fasst Felder und Methoden zusammen.consthinterstatus()sagt, dass die Methode das Fahrrad nicht verändert.anzahl.to!string– wandelt die Zahl in Text um. Das!übergibt den Zieltyp als sogenannten Template-Parameter.~– hängt Texte aneinander.foreach (i, rad; bestand)– geht die Liste durch und liefert dabei die Position mit, beginnend bei 0.- Ketten –
bestand.filter!(…).map!(…)filtert und formt um.r => r.anzahl > 0ist eine kurze namenlose Funktion. Aufrufe ohne Argumente dürfen ohne Klammern stehen, deshalbrad.statusund.sum.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm direkt ausführen
-run übersetzt das Programm und startet es gleich.
ldc2 -run lager.d
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
7. Eigenständiges Programm erzeugen
-O schaltet die Optimierungen ein. Es entstehen das Programm lager und die Zwischendatei lager.o.
ldc2 -O lager.d
Prüfen: Das Programm liefert dieselbe Ausgabe wie in Schritt 6 und ist rund 1 MB groß.
./lager
Ein Projekt mit dub
8. In das Home-Verzeichnis wechseln
cd ~
9. Projekt anlegen
-n übernimmt alle Vorgaben, ohne nachzufragen. Es entstehen die Projektbeschreibung dub.json und das Programm source/app.d.
dub init umsatz-d -n
Prüfen: Die letzte Zeile lautet Package successfully created in umsatz-d.
10. In den Projektordner wechseln
cd ~/umsatz-d
11. Modul mit Test anlegen
nano source/umsatz.d
Die Datei ist neu. Füge diesen Inhalt ein:
module umsatz;
import std.algorithm : splitter;
import std.array : array;
import std.conv : to;
/// Zählt den Umsatz je Modell zusammen.
/// Jede Zeile hat die Form "Modell;Anzahl;Preis".
int[string] summen(string[] zeilen)
{
int[string] ergebnis;
foreach (zeile; zeilen)
{
auto teile = zeile.splitter(';').array;
ergebnis[teile[0]] += teile[1].to!int * teile[2].to!int;
}
return ergebnis;
}
unittest
{
auto s = summen(["A;2;10", "B;1;50", "A;1;10"]);
assert(s["A"] == 30);
assert(s["B"] == 50);
assert(s.length == 2);
}
module umsatz;– der Name des Moduls. Andere Dateien laden es mitimport umsatz;.int[string]– ein assoziatives Feld, also ein Wörterbuch von Text auf Zahl.ergebnis[name] += …legt fehlende Einträge mit 0 an.///– ein Kommentar für die Dokumentation.unittest– ein Test direkt neben dem Code. Er wird nur übersetzt, wenn man Tests ausführt.assertbricht ab, wenn eine Bedingung nicht stimmt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Hauptprogramm schreiben
nano source/app.d
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
import std.stdio;
import std.algorithm : sort;
import std.array : array;
import std.file : readText;
import std.string : lineSplitter;
import umsatz;
int main(string[] args)
{
if (args.length != 2)
{
stderr.writeln("Aufruf: umsatz-d DATEI");
return 1;
}
auto tabelle = summen(readText(args[1]).lineSplitter.array);
auto modelle = tabelle.keys;
modelle.sort!((a, b) => tabelle[a] > tabelle[b]);
foreach (modell; modelle)
writefln("%-12s %5d Euro", modell, tabelle[modell]);
return 0;
}
int main(string[] args)–args[0]ist der Programmname,args[1]der Dateiname. Der Rückgabewert wird zum Rückgabewert des Programms.readTextundlineSplitter– lesen die ganze Datei und zerlegen sie in Zeilen.tabelle.keys– die Schlüssel des Wörterbuchs.sort!sortiert sie nach dem Umsatz, absteigend.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Tests ausführen
dub test
Prüfen: Die Ausgabe endet mit 1 modules passed unittests.
14. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm starten
dub run baut das Projekt und startet es. Alles nach -- geht an das Programm.
dub run -- verkauf.csv
Prüfen: Nach den Meldungen von dub lautet die Ausgabe:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
16. Optimiert bauen
-b release baut mit Optimierungen und ohne Prüfungen zur Fehlersuche. Das Programm umsatz-d liegt danach im Projektordner.
dub build -b release
Prüfen: Ohne Dateiname meldet das Programm Aufruf: umsatz-d DATEI.
./umsatz-d
Wie geht es weiter?
- Bibliotheken:
dub add NAMEträgt eine Bibliothek von https://code.dlang.org indub.jsonein. dub lädt sie beim nächsten Bauen selbst nach~/.dub. - Mit C zusammenarbeiten: D kann Funktionen aus C-Bibliotheken direkt aufrufen. Mit
extern(C)deklariert man sie, oder man bindet eine C-Headerdatei mitimportüber ImportC ein. - Zur Übersetzungszeit rechnen: Mit
enumundstatic ifberechnet D Werte schon beim Übersetzen, statt erst beim Programmlauf. - Editor: Der Sprachserver serve-d bringt Autovervollständigung in Visual Studio Code (Erweiterung „code-d“) und Neovim.
- Dokumentation: Eine Einführung mit Beispielen zum Ausprobieren unter https://tour.dlang.org, die Referenz unter https://dlang.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/d-uebung ~/umsatz-d
2. Zwischenspeicher von dub entfernen
rm -rf ~/.dub
3. LDC und dub entfernen
sudo apt purge ldc dub
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für LDC mitinstalliert wurden, z. B. LLVM 19 und die Standardbibliothek Phobos. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl ldc2 wird nicht mehr gefunden.
ldc2 --version
Quellen und Lizenz
- Offizielle Dokumentation: https://dlang.org/documentation.html
- Lizenz: DMD / LDC steht unter der Boost Software License 1.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.
Nim
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Nim ist eine übersetzte Programmiersprache mit einer Schreibweise, die an Python erinnert: Blöcke werden durch Einrückung gebildet, Typen erkennt der Compiler meist selbst. Nim übersetzt zuerst nach C und lässt dann gcc ein schnelles, kleines Programm daraus machen. Makros erlauben es, die Sprache selbst zu erweitern.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Nim 2.2 in einem einzigen Paket. Es enthält den Compiler
nim, den Paketmanagernimbleund das Formatierwerkzeugnimpretty. - Braucht einen C-Compiler: Nim erzeugt C-Code. Deshalb muss
gccinstalliert sein. Ist C schon eingerichtet, ist es vorhanden. - Ordner im Home-Verzeichnis: Nim legt übersetzte Zwischenstände in
~/.cache/nimab, nimble seine Daten und heruntergeladene Pakete in~/.nimble. - Version: Getestet mit Nim 2.2.4 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Nim und gcc installieren
Ist gcc schon vorhanden, meldet apt das nur.
sudo apt install nim gcc
Prüfen: Die erste Zeile lautet Nim Compiler Version 2.2.4 [Linux: amd64].
nim --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/nim-uebung
4. In den Ordner wechseln
cd ~/nim-uebung
5. Quelltext anlegen
nano lager.nim
Füge diesen Inhalt ein (Strg+Umschalt+V). Die Einrückung mit zwei Leerzeichen gehört zur Sprache:
import std/[strformat, sequtils, strutils]
type
Fahrrad = object
modell: string
preis: int
anzahl: int
proc status(rad: Fahrrad): string =
if rad.anzahl > 0: &"{rad.anzahl} auf Lager"
else: "ausverkauft"
let bestand = @[
Fahrrad(modell: "Citybike", preis: 699, anzahl: 4),
Fahrrad(modell: "Trekkingrad", preis: 899, anzahl: 0),
Fahrrad(modell: "Lastenrad", preis: 3490, anzahl: 1),
]
for i, rad in bestand:
echo &"{i + 1}. {rad.modell:<12} {rad.preis:>5} Euro, {rad.status}"
let lieferbar = bestand.filterIt(it.anzahl > 0).mapIt(it.modell)
echo "Sofort lieferbar: ", lieferbar.join(", ")
echo "Lagerwert: ", bestand.mapIt(it.preis * it.anzahl).foldl(a + b), " Euro"
import std/[…]– lädt mehrere Module der Standardbibliothek auf einmal.object– ein eigener Typ mit Feldern. Angelegt wird er mitFahrrad(modell: …, preis: …).proc– definiert eine Funktion. Der letzte Ausdruck ist das Ergebnis, einreturnist nicht nötig. Man kann sie auch wie eine Eigenschaft aufrufen:rad.statusstattstatus(rad).&"…"– setzt Werte in geschweiften Klammern in einen Text ein.:<12füllt linksbündig auf 12 Zeichen auf,:>5rechtsbündig auf 5.@[…]– eine Folge (seq), also eine Liste, die wachsen kann.letlegt einen unveränderlichen Wert an.filterIt,mapIt,foldl– filtern, umformen und zusammenfassen.itsteht für das jeweilige Element,a + binfoldlfür das Zusammenzählen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen und starten
nim r übersetzt und startet in einem Schritt. --hints:off blendet die vielen Hinweise des Compilers aus.
nim r --hints:off lager.nim
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
7. Eigenständiges Programm erzeugen
nim c übersetzt nur, -d:release schaltet die Optimierungen ein.
nim c -d:release --hints:off lager.nim
Prüfen: Im Ordner liegt das Programm lager, rund 100 KB groß. Es braucht außer der C-Bibliothek nichts.
./lager
Ein Projekt mit nimble
8. Projektordner anlegen
Der Name des Ordners wird zum Namen des Pakets. Bindestriche ersetzt nimble durch Unterstriche, weil sie in Modulnamen von Nim nicht erlaubt sind. Deshalb heißt der Ordner hier gleich umsatz_nim.
mkdir ~/umsatz_nim
9. In den Projektordner wechseln
cd ~/umsatz_nim
10. Projekt anlegen
-y beantwortet alle Fragen mit der Vorgabe. Es entsteht ein Bibliotheksprojekt mit der Beschreibung umsatz_nim.nimble, der Bibliothek in src und einem Test in tests. Den Namen des Autors übernimmt nimble aus den Git-Einstellungen.
nimble init -y
Prüfen: Die letzte Zeile lautet Success: Package umsatz_nim created successfully.
11. Beispielmodul entfernen
Die Vorlage enthält ein Untermodul, das hier nicht gebraucht wird.
rm -r src/umsatz_nim
12. Programm in der Projektbeschreibung eintragen
nano umsatz_nim.nimble
Füge unter der Zeile srcDir = "src" diese Zeile ein:
bin = @["umsatz"]
Damit baut nimble zusätzlich zur Bibliothek das Programm umsatz aus src/umsatz.nim.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Bibliothek schreiben
nano src/umsatz_nim.nim
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
import std/[tables, strutils]
proc summen*(zeilen: seq[string]): CountTable[string] =
## Zählt den Umsatz je Modell zusammen.
## Jede Zeile hat die Form "Modell;Anzahl;Preis".
for zeile in zeilen:
let teile = zeile.split(';')
result.inc(teile[0], parseInt(teile[1]) * parseInt(teile[2]))
*hinter dem Namen – machtsummenaußerhalb des Moduls sichtbar.##– ein Kommentar für die Dokumentation.CountTable– eine Tabelle, die für jeden Schlüssel eine Zahl führt.incerhöht sie und legt fehlende Einträge an.result– der Rückgabewert, den Nim in jeder Funktion schon bereitstellt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Programm schreiben
nano src/umsatz.nim
Die Datei ist neu. Füge diesen Inhalt ein:
import std/[os, strformat, strutils, tables]
import umsatz_nim
if paramCount() != 1:
quit("Aufruf: umsatz DATEI", 1)
var tabelle = summen(readFile(paramStr(1)).strip.splitLines)
tabelle.sort() # absteigend nach Umsatz
for modell, betrag in tabelle:
echo &"{modell:<12} {betrag:>5} Euro"
paramCountundparamStr– Anzahl und Inhalt der Argumente beim Aufruf.quitbeendet das Programm mit einer Meldung und dem Rückgabewert 1.readFile(…).strip.splitLines– liest die Datei, entfernt den Zeilenumbruch am Ende und zerlegt sie in Zeilen.sort– ordnet eineCountTablenach den Zahlen, die größte zuerst.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Test schreiben
nano tests/test1.nim
Lösche den bisherigen Inhalt und füge diesen ein:
import std/[unittest, tables]
import umsatz_nim
test "Umsatz je Modell zusammenzählen":
let s = summen(@["A;2;10", "B;1;50", "A;1;10"])
check s["A"] == 30
check s["B"] == 50
check s.len == 2
test legt einen benannten Test an, check prüft eine Bedingung und meldet bei einem Fehler beide Seiten des Vergleichs.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Tests ausführen
nimble test
Prüfen: Die Ausgabe enthält [OK] Umsatz je Modell zusammenzählen und endet mit Success: All tests passed.
17. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Programm bauen
nimble build -d:release
Prüfen: Die Meldung lautet Building umsatz_nim/umsatz using c backend, und im Projektordner liegt das Programm umsatz.
19. Programm starten
./umsatz verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Wie geht es weiter?
- Bibliotheken:
nimble install NAMElädt Pakete aus dem Verzeichnis https://nimble.directory nach~/.nimble. In der.nimble-Datei trägt man sie unterrequiresein. - Code formatieren:
nimpretty datei.nimbringt den Quelltext in die übliche Form. - Nach JavaScript übersetzen:
nim js datei.nimerzeugt JavaScript für den Browser statt eines Programms. - Editor: Der Sprachserver nimlangserver bringt Autovervollständigung in Visual Studio Code (Erweiterung „Nim“) und Neovim.
- Dokumentation: Lernpfad, Handbuch und Bibliotheksreferenz unter https://nim-lang.org/documentation.html.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/nim-uebung ~/umsatz_nim
2. Zwischenspeicher und Daten von nimble entfernen
rm -rf ~/.cache/nim ~/.nimble
3. Nim entfernen
gcc bleibt installiert, weil es meist auch für anderes gebraucht wird.
sudo apt purge nim
Prüfen: Der Befehl nim wird nicht mehr gefunden.
nim --version
Quellen und Lizenz
- Offizielle Dokumentation: https://nim-lang.org/documentation.html
- Lizenz: Nim steht unter der MIT.
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.
OCaml
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
OCaml ist eine funktionale Programmiersprache mit einem strengen, aber unauffälligen Typsystem: Der Compiler erkennt die Typen fast immer selbst und findet trotzdem viele Fehler vor dem ersten Start. OCaml übersetzt in schnellen Maschinencode. Eingesetzt wird es etwa für Compiler, Werkzeuge zur Programmprüfung und im Finanzhandel.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert OCaml 5.4 im Paket
ocaml, das Bauwerkzeug dune im Paketocaml-duneund viele Bibliotheken als Pakete mit dem Namenlib…-ocaml-dev. Diese Anleitung kommt damit vollständig aus. - opam: Viele Anleitungen im Netz verwenden opam, den Paketmanager der OCaml-Gemeinschaft. Er lädt Compiler und Bibliotheken in den Home-Ordner und übersetzt sie dort. Er ist bei Ubuntu ebenfalls als Paket erhältlich, für den Einstieg aber nicht nötig.
- Bausteine:
ocamlist die interaktive Konsole,ocamloptder Compiler für Maschinencode,ocamlfindfindet installierte Bibliotheken,dunebaut Projekte. - Version: Getestet mit OCaml 5.4.0, dune 3.20.2 und yojson 3.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. OCaml, dune und die JSON-Bibliothek installieren
ocaml– Compiler und Konsoleocaml-dune– das Bauwerkzeugduneocaml-findlib– das Werkzeugocamlfind, über das dune die Bibliotheken findetlibyojson-ocaml-dev– die Bibliothek yojson zum Lesen und Schreiben von JSON
sudo apt install ocaml ocaml-dune ocaml-findlib libyojson-ocaml-dev
Prüfen: Die Ausgabe lautet The OCaml toplevel, version 5.4.0.
ocaml -version
Erste Schritte
3. Konsole starten
Die Eingabezeile beginnt mit #.
ocaml
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter. In der Konsole endet jede Eingabe mit zwei Semikolons.
let quadrat x = x * x;;
List.map quadrat [1; 2; 3; 4];;
Prüfen: Die Antworten lauten val quadrat : int -> int = <fun> und - : int list = [1; 4; 9; 16]. OCaml hat selbst erkannt, dass quadrat eine ganze Zahl bekommt und liefert. Beende die Konsole mit #quit;;.
Ein einzelnes Programm
5. Übungsordner anlegen
mkdir ~/ocaml-uebung
6. In den Ordner wechseln
cd ~/ocaml-uebung
7. Quelltext anlegen
nano lager.ml
Füge diesen Inhalt ein (Strg+Umschalt+V):
type fahrrad = { modell : string; preis : int; anzahl : int }
let bestand =
[
{ modell = "Citybike"; preis = 699; anzahl = 4 };
{ modell = "Trekkingrad"; preis = 899; anzahl = 0 };
{ modell = "Lastenrad"; preis = 3490; anzahl = 1 };
]
let status rad =
match rad.anzahl with
| 0 -> "ausverkauft"
| n -> string_of_int n ^ " auf Lager"
let lagerwert raeder =
List.fold_left (fun summe rad -> summe + (rad.preis * rad.anzahl)) 0 raeder
let () =
List.iter
(fun rad -> Printf.printf "%-12s %5d Euro, %s\n" rad.modell rad.preis (status rad))
bestand;
let lieferbar =
bestand |> List.filter (fun rad -> rad.anzahl > 0) |> List.map (fun rad -> rad.modell)
in
Printf.printf "Sofort lieferbar: %s\n" (String.concat ", " lieferbar);
Printf.printf "Lagerwert: %d Euro\n" (lagerwert bestand)
type fahrrad = { … }– ein Verbund mit drei benannten Feldern. Listen schreibt man mit eckigen Klammern und trennt die Elemente mit Semikolons.match … with– unterscheidet Fälle nach dem Wert.nfängt alle übrigen Zahlen ab und gibt ihnen einen Namen.^– hängt Texte aneinander.List.fold_left– geht die Liste durch und sammelt dabei einen Wert auf, hier die Summe, beginnend bei 0.|>– reicht ein Ergebnis an die nächste Funktion weiter. So liest sich die Kette von links nach rechts: filtern, dann die Modellnamen herausziehen.let () = …– der Startpunkt des Programms. Befehle mit Nebenwirkungen wie Ausgaben trennt man mit;.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Programm direkt ausführen
ocaml mit einem Dateinamen führt die Datei aus, ohne ein Programm zu erzeugen.
ocaml lager.ml
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
9. In Maschinencode übersetzen
ocamlopt erzeugt ein eigenständiges Programm. Daneben legt es Zwischendateien mit den Endungen .cmi, .cmx und .o an.
ocamlopt -o lager lager.ml
Prüfen: Das Programm liefert dieselbe Ausgabe wie in Schritt 8.
./lager
Ein Projekt mit dune
10. In das Home-Verzeichnis wechseln
cd ~
11. Projekt anlegen
Legt den Ordner umsatz mit drei Teilen an: einer Bibliothek in lib, einem Programm in bin und einem Test in test. Jeder Teil hat eine Datei dune, die beschreibt, was dort gebaut wird.
dune init project umsatz
Prüfen: Die Meldung lautet Success: initialized project component named umsatz.
12. In den Projektordner wechseln
cd ~/umsatz
13. Bibliothek schreiben
nano lib/umsatz.ml
Die Datei ist neu. Füge diesen Inhalt ein:
(* Verkäufe zusammenzählen *)
type verkauf = { modell : string; anzahl : int; preis : int }
(* Liefert eine Liste von (Modell, Umsatz), nach Umsatz absteigend sortiert *)
let umsatz_je_modell verkaeufe =
let tabelle = Hashtbl.create 8 in
List.iter
(fun v ->
let bisher = Option.value (Hashtbl.find_opt tabelle v.modell) ~default:0 in
Hashtbl.replace tabelle v.modell (bisher + (v.anzahl * v.preis)))
verkaeufe;
Hashtbl.to_seq tabelle |> List.of_seq
|> List.sort (fun (_, a) (_, b) -> compare b a)
let als_json umsaetze =
`Assoc (List.map (fun (modell, betrag) -> (modell, `Int betrag)) umsaetze)
- Modul aus Dateinamen: Die Datei
umsatz.mlwird automatisch zum ModulUmsatz. Hashtbl– eine Tabelle zum schnellen Nachschlagen.find_optliefertSome wertoderNone.Option.value … ~default:0macht daraus eine Zahl.(_, a)– nimmt ein Paar auseinander,_steht für einen Wert, der nicht gebraucht wird.`Assocund`Int– so beschreibt yojson ein JSON-Objekt und eine Zahl.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Bibliothek mit yojson verbinden
nano lib/dune
Ersetze den Inhalt durch:
(library
(name umsatz)
(libraries yojson))
(libraries yojson) sagt dune, dass die Bibliothek yojson verwendet. dune findet sie über ocamlfind unter den installierten Ubuntu-Paketen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm schreiben
nano bin/main.ml
Ersetze den Inhalt durch:
open Umsatz
let verkaeufe =
[
{ modell = "Citybike"; anzahl = 2; preis = 699 };
{ modell = "Lastenrad"; anzahl = 1; preis = 3490 };
{ modell = "Citybike"; anzahl = 3; preis = 699 };
{ modell = "Trekkingrad"; anzahl = 1; preis = 899 };
{ modell = "Citybike"; anzahl = 1; preis = 649 };
]
let () =
let umsaetze = umsatz_je_modell verkaeufe in
List.iter (fun (modell, betrag) -> Printf.printf "%-12s %5d Euro\n" modell betrag) umsaetze;
Yojson.Safe.to_file "umsatz.json" (als_json umsaetze);
print_endline "Gespeichert: umsatz.json"
open Umsatz macht alle Namen aus der Bibliothek direkt verfügbar, sodass man umsatz_je_modell statt Umsatz.umsatz_je_modell schreiben kann. Die Datei bin/dune verweist schon auf die Bibliothek.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Programm bauen und starten
dune exec umsatz baut das Projekt im Ordner _build und startet das Programm.
dune exec umsatz
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}.
17. Test schreiben
nano test/test_umsatz.ml
Ersetze den Inhalt durch:
open Umsatz
let () =
let ergebnis =
umsatz_je_modell
[
{ modell = "A"; anzahl = 2; preis = 10 };
{ modell = "B"; anzahl = 1; preis = 50 };
{ modell = "A"; anzahl = 1; preis = 10 };
]
in
assert (ergebnis = [ ("B", 50); ("A", 30) ]);
print_endline "Alle Tests bestanden."
assert bricht das Programm ab, wenn die Bedingung nicht stimmt. Hier wird geprüft, dass A zusammengezählt wird (30) und B mit dem größeren Umsatz vorne steht.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
18. Test mit der Bibliothek verbinden
Anders als das Programm kennt der Test die Bibliothek noch nicht. Ohne diesen Schritt meldet dune Unbound module Umsatz.
nano test/dune
Ersetze den Inhalt durch:
(test
(name test_umsatz)
(libraries umsatz))
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
19. Test ausführen
dune test
Prüfen: Die Ausgabe lautet Alle Tests bestanden. Stimmt das Ergebnis nicht, meldet dune Assertion failed mit Datei und Zeile.
Wie geht es weiter?
- Bessere Konsole:
sudo apt install utopinstalliertutop, eine Konsole mit Farben, Verlauf und Autovervollständigung. - Code formatieren: Nach
sudo apt install ocamlformatund einer leeren Datei.ocamlformatim Projektordner bringtdune fmtden Code in eine einheitliche Form. - Weitere Bibliotheken:
apt search ocaml-devlistet die Bibliotheken von Ubuntu. Eingetragen werden sie in der Dateiduneunterlibraries. - opam: Für neuere Versionen oder Bibliotheken, die Ubuntu nicht hat, richtet
sudo apt install opamund danachopam initeine eigene Umgebung im Home-Ordner ein. - Editor: Mit dem Sprachserver ocaml-lsp und der Erweiterung „OCaml Platform“ für Visual Studio Code gibt es Typanzeige und Autovervollständigung.
- Dokumentation: Einführung und Bibliotheken unter https://ocaml.org/docs.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/ocaml-uebung ~/umsatz
2. Zwischenspeicher von dune entfernen
dune hebt Übersetzungsergebnisse in ~/.cache/dune auf, um spätere Builds zu beschleunigen.
rm -rf ~/.cache/dune
3. OCaml und Bibliotheken entfernen
sudo apt purge ocaml ocaml-dune ocaml-findlib libyojson-ocaml-dev
4. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl ocaml wird nicht mehr gefunden.
ocaml -version
Quellen und Lizenz
- Offizielle Dokumentation: https://ocaml.org/docs
- Lizenz: OCaml steht unter der LGPL-2.1 with linking exception.
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.
Clojure
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Clojure ist ein moderner Lisp-Dialekt, der auf der virtuellen Maschine von Java läuft. Programme bestehen aus Ausdrücken in Klammern und arbeiten bevorzugt mit unveränderlichen Daten wie Listen, Vektoren und Wörterbüchern. Weil Clojure alle Java-Bibliotheken nutzen kann, wird es gern für Datenverarbeitung und Serverdienste eingesetzt.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Clojure 1.12 im Paket
clojureund das Bauwerkzeug Leiningen im Paketleiningen. Beide brauchen Java. Ist noch keines installiert, bringtaptdas Standard-Java von Ubuntu mit. - Zwei Wege: Der Befehl
clojurevon Ubuntu startet Skripte und eine Konsole. Bibliotheken nimmt er aus Ubuntu-Paketen wielibdata-json-clojure. Leiningen verwaltet dagegen Projekte und lädt Bibliotheken samt Clojure selbst aus den Online-Archiven Maven Central und Clojars. - Nicht die offizielle CLI: Auf https://clojure.org wird ein eigenes Werkzeug
cljmit Projektdateien namensdeps.ednbeschrieben. Der Befehlclojurevon Ubuntu ist ein einfacheres Startskript und kenntdeps.ednnicht. - Ordner
~/.m2: Leiningen speichert heruntergeladene Bibliotheken in~/.m2/repository. Den Ordner verwendet auch Maven, das Bauwerkzeug für Java. - Version: Getestet mit Clojure 1.12.0, Leiningen 2.11.2 und OpenJDK 26 unter Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Clojure, Leiningen und die JSON-Bibliothek installieren
clojure– die Sprache und der Befehlclojureleiningen– das Bauwerkzeugleinlibdata-json-clojure– die Bibliothek clojure.data.json zum Lesen und Schreiben von JSON
sudo apt install clojure leiningen libdata-json-clojure
Prüfen: Die Ausgabe beginnt mit Leiningen 2.11.2 on Java.
lein version
Erste Schritte
3. Einen Ausdruck auswerten
-e wertet einen Ausdruck aus und gibt das Ergebnis aus. In Clojure steht die Funktion am Anfang der Klammer: (inc 1) ergibt 2.
clojure -e '(map inc [1 2 3])'
Prüfen: Die Ausgabe lautet (2 3 4). map hat inc (um eins erhöhen) auf jedes Element des Vektors angewendet.
4. Konsole ausprobieren (optional)
clojure ohne weitere Angabe startet eine Konsole mit der Eingabezeile user=>. Beende sie mit Strg+D.
clojure
Ein Programm mit Namensraum
5. Ordner anlegen
Clojure sucht den Namensraum laden.lager in der Datei laden/lager.clj. Der Ordner src nimmt alle Quelldateien auf.
mkdir -p ~/clojure-uebung/src/laden
6. In den Übungsordner wechseln
cd ~/clojure-uebung
7. Quelltext anlegen
nano src/laden/lager.clj
Füge diesen Inhalt ein (Strg+Umschalt+V):
(ns laden.lager
(:require [clojure.string :as str]
[clojure.data.json :as json]))
(def bestand
[{:modell "Citybike" :preis 699 :anzahl 4}
{:modell "Trekkingrad" :preis 899 :anzahl 0}
{:modell "Lastenrad" :preis 3490 :anzahl 1}])
(defn status [{:keys [anzahl]}]
(if (pos? anzahl)
(str anzahl " auf Lager")
"ausverkauft"))
(defn lagerwert [raeder]
(reduce + (map #(* (:preis %) (:anzahl %)) raeder)))
(defn -main [& _args]
(doseq [rad bestand]
(println (format "%-12s %5d Euro, %s" (:modell rad) (:preis rad) (status rad))))
(println "Sofort lieferbar:" (str/join ", " (->> bestand (filter #(pos? (:anzahl %))) (map :modell))))
(println "Lagerwert:" (lagerwert bestand) "Euro")
(spit "bestand.json" (json/write-str bestand))
(println "Gespeichert: bestand.json"))
ns– legt den Namensraum fest und lädt andere mit:require.:as strgibt ihnen einen kurzen Namen.- Datenstrukturen –
[…]ist ein Vektor,{…}ein Wörterbuch (Map).:modellist ein Schlüsselwort, das man auch als Funktion verwenden kann:(:preis rad)liefert den Preis. defn– definiert eine Funktion.{:keys [anzahl]}nimmt das übergebene Wörterbuch auseinander und holtanzahlheraus.#(* (:preis %) (:anzahl %))– eine kurze namenlose Funktion.%ist ihr Parameter.->>– reicht ein Ergebnis von Schritt zu Schritt weiter: erst filtern, dann die Modellnamen herausziehen.-main– der Startpunkt, wenn das Programm mit-mgestartet wird.spitschreibt einen Text in eine Datei.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Programm starten
-cp nennt die Orte, an denen Clojure nach Quelltexten und Bibliotheken sucht, getrennt durch Doppelpunkte: den Ordner src und die JSON-Bibliothek aus dem Ubuntu-Paket. -m laden.lager startet die Funktion -main dieses Namensraums.
clojure -cp src:/usr/share/java/data.json.jar -m laden.lager
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
Gespeichert: bestand.json
Die Datei bestand.json enthält den Bestand als JSON-Liste.
Ein Projekt mit Leiningen
9. In das Home-Verzeichnis wechseln
cd ~
10. Projekt anlegen
Legt den Ordner lager-clj aus der Vorlage app an: die Projektdatei project.clj, das Programm in src/lager_clj/core.clj und einen Test in test. Bindestriche im Namen werden in Ordnernamen zu Unterstrichen.
lein new app lager-clj
Prüfen: Die Meldung lautet Generating a project called lager-clj based on the 'app' template.
11. In den Projektordner wechseln
cd ~/lager-clj
12. Abhängigkeiten eintragen
Die Vorlage trägt noch Clojure 1.11.1 ein. Leiningen lädt die angegebenen Versionen selbst herunter, unabhängig vom Clojure aus Ubuntu.
nano project.clj
Ersetze die Zeile, die mit :dependencies beginnt, durch diese zwei Zeilen:
:dependencies [[org.clojure/clojure "1.12.0"]
[org.clojure/data.json "2.5.1"]]
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Programm schreiben
nano src/lager_clj/core.clj
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
(ns lager-clj.core
(:require [clojure.data.json :as json])
(:gen-class))
(defn umsatz-je-modell
"Zählt den Umsatz je Modell zusammen."
[verkaeufe]
(reduce (fn [summen {:keys [modell anzahl preis]}]
(update summen modell (fnil + 0) (* anzahl preis)))
{}
verkaeufe))
(def verkaeufe
[{:modell "Citybike" :anzahl 2 :preis 699}
{:modell "Lastenrad" :anzahl 1 :preis 3490}
{:modell "Citybike" :anzahl 3 :preis 699}
{:modell "Trekkingrad" :anzahl 1 :preis 899}
{:modell "Citybike" :anzahl 1 :preis 649}])
(defn -main [& _args]
(let [summen (umsatz-je-modell verkaeufe)]
(doseq [[modell betrag] (sort-by val > summen)]
(println (format "%-12s %5d Euro" modell betrag)))
(spit "umsatz.json" (json/write-str summen))
(println "Gespeichert: umsatz.json")))
reduce– geht die Verkäufe durch und baut dabei ein Wörterbuch der Summen auf, beginnend mit{}.update … (fnil + 0) …– erhöht den Eintrag eines Modells.fnilsetzt 0 ein, wenn es den Eintrag noch nicht gibt.- Unveränderliche Daten –
updateverändert das Wörterbuch nicht, sondern liefert ein neues.reducegibt es an den nächsten Schritt weiter. (:gen-class)– nötig, damit Leiningen später eine eigenständige JAR-Datei mit Startpunkt erzeugen kann.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Programm starten
Beim ersten Mal lädt Leiningen Clojure 1.12.0, data.json und weitere Bibliotheken nach ~/.m2 und meldet das mit Retrieving ….
lein run
Prüfen: Die Ausgabe endet mit:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
15. Test schreiben
nano test/lager_clj/core_test.clj
Lösche den bisherigen Inhalt und füge diesen ein:
(ns lager-clj.core-test
(:require [clojure.test :refer [deftest is]]
[lager-clj.core :refer [umsatz-je-modell]]))
(deftest zusammenzaehlen
(is (= {"A" 30 "B" 50}
(umsatz-je-modell [{:modell "A" :anzahl 2 :preis 10}
{:modell "B" :anzahl 1 :preis 50}
{:modell "A" :anzahl 1 :preis 10}]))))
deftest legt einen Test an, is prüft eine Bedingung. Wörterbücher vergleicht = nach Inhalt, die Reihenfolge der Einträge spielt keine Rolle.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Tests ausführen
lein test
Prüfen: Die Ausgabe endet mit Ran 1 tests containing 1 assertions. und 0 failures, 0 errors.
17. Eigenständige JAR-Datei erzeugen
lein uberjar packt das Programm samt Clojure und allen Bibliotheken in eine einzige Datei. Sie läuft auf jedem Rechner mit Java, auch ohne Clojure.
lein uberjar
18. JAR-Datei starten
java -jar target/uberjar/lager-clj-0.1.0-SNAPSHOT-standalone.jar
Prüfen: Die Ausgabe gleicht der aus Schritt 14. Die Datei ist rund 5 MB groß.
Wie geht es weiter?
- Weitere Bibliotheken:
apt search clojurelistet die Clojure-Bibliotheken von Ubuntu. In Leiningen-Projekten trägt man Bibliotheken von https://clojars.org oder Maven Central unter:dependenciesein. - Interaktiv entwickeln:
lein replstartet eine Konsole, in der der Projektcode geladen ist. Editoren verbinden sich damit, etwa Visual Studio Code mit der Erweiterung „Calva“ oder Emacs mit CIDER. - Java nutzen: Java-Klassen ruft man direkt auf, z. B.
(java.time.LocalDate/now)für das heutige Datum. - Dokumentation: Einführung und Referenz unter https://clojure.org/guides/getting_started, Beispiele zu jeder Funktion unter https://clojuredocs.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/clojure-uebung ~/lager-clj
2. Heruntergeladene Bibliotheken entfernen
Leiningen hat Clojure und die Bibliotheken unter ~/.m2/repository abgelegt, vor allem in org/clojure und nrepl. Verwendest du Maven für Java-Projekte, lass den Ordner stehen, sonst lädt Maven seine Bibliotheken erneut herunter. Andernfalls entfernt dieser Befehl ihn ganz:
rm -rf ~/.m2
3. Clojure und Leiningen entfernen
sudo apt purge clojure leiningen libdata-json-clojure
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Clojure und Leiningen mitinstalliert wurden. War vorher kein Java installiert, gehört auch das mitgebrachte Java dazu. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl lein wird nicht mehr gefunden.
lein version
Quellen und Lizenz
- Offizielle Dokumentation: https://clojure.org/guides/getting_started
- Lizenz: Clojure steht unter der EPL-1.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.
Pascal (Free Pascal)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Pascal wurde um 1970 als gut lesbare Lehrsprache entworfen und lebt heute vor allem als Object Pascal weiter, bekannt durch Delphi. Free Pascal ist ein freier Compiler dafür. Er übersetzt schnell, erzeugt eigenständige Programme ohne weitere Abhängigkeiten und versteht auch Delphi-Code. Mit der Entwicklungsumgebung Lazarus entstehen damit auch grafische Anwendungen.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Free Pascal 3.2.2. Das Paket
fpcwürde den Compiler mit allen Bibliotheken installieren, auch denen für grafische Oberflächen. Das sind 139 Pakete. Für Konsolenprogramme genügenfp-compilerund die Free Component Libraryfp-units-fcl, zusammen 7 Pakete. - Units: Pascal-Programme werden in Units aufgeteilt. Eine Unit hat einen öffentlichen Teil (
interface) und einen inneren Teil (implementation). - Sprachmodus: Free Pascal kennt mehrere Schreibweisen. Diese Anleitung verwendet den Modus
objfpcmit Klassen und langen Zeichenketten, wie er auch in Lazarus üblich ist. - Version: Getestet mit Free Pascal 3.2.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Compiler und Grundbibliotheken installieren
fp-compiler– der Compilerfpcmit der Laufzeitbibliothekfp-units-fcl– die Free Component Library mit Klassen für Listen, Dateien, JSON und vieles mehr
sudo apt install fp-compiler fp-units-fcl
Prüfen: Die Ausgabe lautet 3.2.2.
fpc -iV
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/pascal-uebung
4. In den Ordner wechseln
cd ~/pascal-uebung
5. Quelltext anlegen
nano lager.pas
Füge diesen Inhalt ein (Strg+Umschalt+V):
program Lager;
{$mode objfpc}{$H+}
uses
SysUtils;
type
TFahrrad = record
Modell: string;
Preis: Integer;
Anzahl: Integer;
end;
const
Bestand: array[1..3] of TFahrrad = (
(Modell: 'Citybike'; Preis: 699; Anzahl: 4),
(Modell: 'Trekkingrad'; Preis: 899; Anzahl: 0),
(Modell: 'Lastenrad'; Preis: 3490; Anzahl: 1)
);
function Status(const Rad: TFahrrad): string;
begin
if Rad.Anzahl > 0 then
Result := IntToStr(Rad.Anzahl) + ' auf Lager'
else
Result := 'ausverkauft';
end;
var
I, Wert: Integer;
begin
Wert := 0;
for I := Low(Bestand) to High(Bestand) do
begin
WriteLn(Format('%d. %-12s %5d Euro, %s', [I, Bestand[I].Modell, Bestand[I].Preis, Status(Bestand[I])]));
Wert := Wert + Bestand[I].Preis * Bestand[I].Anzahl;
end;
WriteLn('Lagerwert: ', Wert, ' Euro');
end.
{$mode objfpc}{$H+}– schaltet den Sprachmodus mit Klassen ein.{$H+}machtstringzu einer Zeichenkette beliebiger Länge.uses SysUtils– bindet die Unit mitIntToStr,Formatund weiteren Hilfsfunktionen ein.record– fasst mehrere Felder zu einem Typ zusammen. Typnamen beginnen nach Brauch mitT.- Feld mit eigenen Grenzen –
array[1..3]beginnt bei 1.LowundHighliefern die Grenzen. :=und=–:=weist zu,=vergleicht. Blöcke stehen zwischenbeginundend, Anweisungen enden mit;.Result– der Rückgabewert einer Funktion.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen
-O2 schaltet die Optimierungen ein.
fpc -O2 lager.pas
Prüfen: Die letzten Zeilen lauten Linking lager und 40 lines compiled, 0.1 sec.
7. Programm starten
./lager
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Lagerwert: 6286 Euro
Das Programm ist rund 500 KB groß und braucht keine weiteren Bibliotheken.
Eine Unit mit einer Klasse
8. Unit anlegen
Die Unit enthält eine Klasse, die Verkäufe je Modell zusammenzählt und als JSON ausgeben kann. Der Dateiname muss zum Namen der Unit passen.
nano umsatz.pas
Füge diesen Inhalt ein:
unit Umsatz;
{$mode objfpc}{$H+}
interface
uses
Classes, SysUtils, fpjson;
type
{ Zählt Verkäufe je Modell zusammen }
TUmsatzListe = class
private
FSummen: TStringList;
public
constructor Create;
destructor Destroy; override;
procedure Verkauf(const Modell: string; Anzahl, Preis: Integer);
function Summe(const Modell: string): Integer;
function AlsJson: TJSONObject;
property Modelle: TStringList read FSummen;
end;
implementation
constructor TUmsatzListe.Create;
begin
inherited Create;
FSummen := TStringList.Create;
end;
destructor TUmsatzListe.Destroy;
begin
FSummen.Free;
inherited Destroy;
end;
procedure TUmsatzListe.Verkauf(const Modell: string; Anzahl, Preis: Integer);
begin
FSummen.Values[Modell] := IntToStr(Summe(Modell) + Anzahl * Preis);
end;
function TUmsatzListe.Summe(const Modell: string): Integer;
begin
Result := StrToIntDef(FSummen.Values[Modell], 0);
end;
function TUmsatzListe.AlsJson: TJSONObject;
var
I: Integer;
begin
Result := TJSONObject.Create;
for I := 0 to FSummen.Count - 1 do
Result.Add(FSummen.Names[I], Summe(FSummen.Names[I]));
end;
end.
interfaceundimplementation– oben steht, was andere Programmteile sehen, unten der eigentliche Code.class– eine Klasse mit Feldern, Methoden und einerproperty.privateverbirgt das FeldFSummennach außen.TStringList– eine Liste von Texten aus der UnitClasses. ÜberValues['Name']lassen sich Einträge der FormName=Wertlesen und setzen.- Speicher selbst freigeben – Objekte entstehen mit
Createund müssen mitFreewieder freigegeben werden. Derdestructorgibt die innere Liste frei. fpjson– die JSON-Unit der Free Component Library.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Hauptprogramm anlegen
nano auswertung.pas
Füge diesen Inhalt ein:
program Auswertung;
{$mode objfpc}{$H+}
uses
Classes, SysUtils, fpjson, Umsatz;
var
Liste: TUmsatzListe;
Json: TJSONObject;
Datei: TStringList;
I: Integer;
begin
Liste := TUmsatzListe.Create;
try
Liste.Verkauf('Citybike', 2, 699);
Liste.Verkauf('Lastenrad', 1, 3490);
Liste.Verkauf('Citybike', 3, 699);
Liste.Verkauf('Trekkingrad', 1, 899);
Liste.Verkauf('Citybike', 1, 649);
Liste.Modelle.Sort;
for I := 0 to Liste.Modelle.Count - 1 do
WriteLn(Format('%-12s %5d Euro', [Liste.Modelle.Names[I], Liste.Summe(Liste.Modelle.Names[I])]));
Json := Liste.AlsJson;
Datei := TStringList.Create;
try
Datei.Text := Json.FormatJSON;
Datei.SaveToFile('umsatz.json');
WriteLn('Gespeichert: umsatz.json');
finally
Datei.Free;
Json.Free;
end;
finally
Liste.Free;
end;
end.
uses …, Umsatz– bindet die eigene Unit ein.fpcfindetumsatz.pasim selben Ordner und übersetzt sie mit.try … finally– der Teil nachfinallyläuft immer, auch nach einem Fehler. So wird jedes Objekt sicher freigegeben.Liste.Modelle.Sort– sortiert die Modelle alphabetisch, bevor sie ausgegeben werden.FormatJSON– liefert das JSON-Objekt als eingerückten Text.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm übersetzen
fpc -O2 auswertung.pas
Prüfen: Die Meldungen nennen Compiling auswertung.pas und Compiling umsatz.pas. Neben dem Programm entstehen Zwischendateien mit den Endungen .o und .ppu.
11. Programm starten
./auswertung
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält die drei Modelle mit ihren Umsätzen, z. B. "Citybike" : 4144.
12. Vergessene Freigaben finden (optional)
-gh baut eine Speicherprüfung ein. Sie meldet sich beim Beenden nur, wenn Objekte nicht freigegeben wurden. Lösche zum Ausprobieren in auswertung.pas die Zeile Json.Free; und übersetze neu:
fpc -gh auswertung.pas
./auswertung
Prüfen: Nach der normalen Ausgabe erscheint Heap dump by heaptrc unit und eine Zeile wie 9 unfreed memory blocks : 621. Mit der Zeile Json.Free; bleibt die Prüfung stumm. Füge sie danach wieder ein.
Wie geht es weiter?
- Lazarus:
sudo apt install lazarusinstalliert die Entwicklungsumgebung Lazarus mit einem Formulareditor für grafische Programme, ähnlich wie Delphi. Sie bringt das vollständige Free Pascal samt aller Bibliotheken mit. - Weitere Bibliotheken: Das Paket
fpcinstalliert alle Units von Free Pascal, etwa für Datenbanken, Netzwerk und Grafik. - Ordnung im Projektordner:
-FUliblegt die Zwischendateien im Unterordnerlibab,-FEbindas fertige Programm inbin. Die Ordner müssen vorher existieren. - Delphi-Code: Mit
{$mode delphi}übersetzt Free Pascal Quelltext in der Schreibweise von Delphi. - Dokumentation: Handbücher zu Sprache und Bibliotheken unter https://www.freepascal.org/docs.html, ein deutschsprachiges Forum und Wiki unter https://www.lazarusforum.de.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/pascal-uebung
2. Free Pascal entfernen
sudo apt purge fp-compiler fp-units-fcl
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Free Pascal mitinstalliert wurden, z. B. fp-compiler-3.2.2. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl fpc wird nicht mehr gefunden.
fpc -iV
Quellen und Lizenz
- Offizielle Dokumentation: https://www.freepascal.org/docs.html
- Lizenz: Free Pascal steht unter der GPL-2.0 / LGPL-2.0 with linking exception.
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.
Ada
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Ada ist eine Programmiersprache für Software, die zuverlässig funktionieren muss. Sie steckt in Flugzeugen, Zügen, Satelliten und Medizingeräten. Typen mit festgelegten Wertebereichen, Prüfungen zur Laufzeit und Vor- und Nachbedingungen an Funktionen fangen Fehler früh ab. Die Schreibweise ist ausführlich und erinnert an Pascal.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert den Ada-Compiler GNAT 14, einen Teil der GNU Compiler Collection, und das Bauwerkzeug gprbuild. Zusammen sind das 16 Pakete.
- Sprachstand: GNAT 14 übersetzt ohne Zusatzschalter nach dem Standard Ada 2012. Der Schalter
-gnat2022schaltet Ada 2022 ein. - Bauwerkzeuge:
gnatmakeübersetzt kleine Programme direkt. Für Projekte beschreibt eine Datei mit der Endung.gprQuellordner, Ausgabeordner und Schalter.gprbuildbaut danach. - Alire: Für Bibliotheken gibt es den Paketmanager Alire (Paket
alire). Für den Einstieg ist er nicht nötig. - Version: Getestet mit GNAT 14.3.0 und gprbuild 2025.0 aus Ubuntu 26.04. gprbuild nennt sich in seiner Versionsausgabe
GPRBUILD Pro 18.0w. Das ist eine ungenaue Angabe des Pakets.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. GNAT und gprbuild installieren
sudo apt install gnat gprbuild
Prüfen: Die erste Zeile lautet GNAT 14.3.0.
gnat --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/ada-uebung
4. In den Ordner wechseln
cd ~/ada-uebung
5. Quelltext anlegen
Ada-Dateien mit einem Programm oder dem Rumpf eines Pakets enden auf .adb. Der Dateiname muss zum Namen der Prozedur passen, klein geschrieben.
nano lager.adb
Füge diesen Inhalt ein (Strg+Umschalt+V):
with Ada.Text_IO; use Ada.Text_IO;
with Ada.Strings.Unbounded; use Ada.Strings.Unbounded;
procedure Lager is
function "+" (S : String) return Unbounded_String renames To_Unbounded_String;
type Fahrrad is record
Modell : Unbounded_String;
Preis : Positive;
Anzahl : Natural;
end record;
type Bestandsliste is array (Positive range <>) of Fahrrad;
Bestand : constant Bestandsliste :=
((Modell => +"Citybike", Preis => 699, Anzahl => 4),
(Modell => +"Trekkingrad", Preis => 899, Anzahl => 0),
(Modell => +"Lastenrad", Preis => 3490, Anzahl => 1));
Wert : Natural := 0;
begin
for Rad of Bestand loop
Put (To_String (Rad.Modell));
Set_Col (14);
Put (Rad.Preis'Image & " Euro,");
if Rad.Anzahl > 0 then
Put_Line (Rad.Anzahl'Image & " auf Lager");
else
Put_Line (" ausverkauft");
end if;
Wert := Wert + Rad.Preis * Rad.Anzahl;
end loop;
Put_Line ("Lagerwert:" & Wert'Image & " Euro");
end Lager;
withunduse–withbindet ein Paket ein,useerlaubt seine Namen ohne Vorsilbe, alsoPut_LinestattAda.Text_IO.Put_Line.- Zeichenketten – ein normaler
Stringhat in Ada eine feste Länge.Unbounded_Stringkann beliebig lang sein. Die Funktion"+"ist eine Abkürzung für die Umwandlung. PositiveundNatural– vordefinierte Wertebereiche: ganze Zahlen ab 1 bzw. ab 0. Ein negativer Lagerbestand ist damit gar nicht möglich.array (Positive range <>)– ein Feld, dessen Länge erst beim Anlegen feststeht.'Image– ein Attribut, das eine Zahl in Text umwandelt. Für positive Zahlen beginnt der Text mit einem Leerzeichen.:=und=–:=weist zu,=vergleicht.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen
gnatmake übersetzt die Datei, findet benötigte Pakete selbst und erzeugt das Programm lager. -q unterdrückt die Fortschrittsmeldungen.
gnatmake -q lager.adb
Prüfen: Der Befehl gibt nichts aus. Neben dem Programm liegen die Zwischendateien lager.ali und lager.o.
7. Programm starten
./lager
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3490 Euro, 1 auf Lager
Lagerwert: 6286 Euro
Ein Projekt mit geprüften Wertebereichen
Das Projekt berechnet einen Preis nach Rabatt. Der Rabatt darf nur zwischen 0 und 50 Prozent liegen. Ada prüft das selbst.
8. Projektordner anlegen
mkdir -p ~/rabatt/src
9. In den Projektordner wechseln
cd ~/rabatt
10. Projektdatei anlegen
nano rabatt.gpr
Füge diesen Inhalt ein:
project Rabatt is
for Source_Dirs use ("src");
for Object_Dir use "obj";
for Exec_Dir use "bin";
for Main use ("haupt.adb");
package Compiler is
for Default_Switches ("Ada") use ("-gnatwa", "-gnata", "-gnat2022");
end Compiler;
end Rabatt;
Source_Dirs,Object_Dir,Exec_Dir– Quelltexte liegen insrc, Zwischendateien inobj, das fertige Programm inbin. gprbuild legt die beiden Ausgabeordner selbst an.Main– die Datei mit dem Hauptprogramm.- Schalter –
-gnatwaschaltet fast alle Warnungen ein,-gnataprüft Vor- und Nachbedingungen zur Laufzeit,-gnat2022erlaubt Ada 2022.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Paketspezifikation anlegen
Die Spezifikation (Endung .ads) beschreibt, was ein Paket nach außen anbietet.
nano src/preise.ads
Füge diesen Inhalt ein:
package Preise is
-- Ein Rabatt liegt immer zwischen 0 und 50 Prozent
subtype Prozent is Natural range 0 .. 50;
-- Preis in Cent, damit keine Rundungsfehler entstehen
subtype Cent is Natural;
function Nach_Rabatt (Preis : Cent; Rabatt : Prozent) return Cent
with Post => Nach_Rabatt'Result <= Preis;
function Als_Text (Betrag : Cent) return String;
end Preise;
subtype Prozent is Natural range 0 .. 50– ein eigener Wertebereich. Jede Zuweisung eines Werts außerhalb davon löst zur Laufzeit den FehlerConstraint_Erroraus.with Post => …– eine Nachbedingung: Der Preis nach Rabatt ist nie höher als vorher. Mit-gnataprüft das Programm das bei jedem Aufruf.- Kommentare beginnen mit
--.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Paketrumpf anlegen
Der Rumpf (Endung .adb) enthält den Code zu den Funktionen der Spezifikation.
nano src/preise.adb
Füge diesen Inhalt ein:
package body Preise is
function Nach_Rabatt (Preis : Cent; Rabatt : Prozent) return Cent is
begin
return Preis - Preis * Rabatt / 100;
end Nach_Rabatt;
function Als_Text (Betrag : Cent) return String is
-- 'Image liefert eine Zahl mit führendem Leerzeichen, z. B. " 699"
Euro : constant String := Natural'Image (Betrag / 100);
-- 100 addieren, damit der Cent-Teil immer zwei Ziffern hat: 5 -> " 105"
Rest : constant String := Natural'Image (Betrag mod 100 + 100);
begin
return Euro (Euro'First + 1 .. Euro'Last) & "," & Rest (Rest'Last - 1 .. Rest'Last) & " Euro";
end Als_Text;
end Preise;
- Ganzzahlrechnung –
/teilt ganze Zahlen ohne Rest,modliefert den Rest. Aus 59 415 Cent werden so 594 Euro und 15 Cent. - Ausschnitte –
Euro (Euro'First + 1 .. Euro'Last)schneidet das führende Leerzeichen ab,Rest (Rest'Last - 1 .. Rest'Last)nimmt die letzten zwei Ziffern.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Hauptprogramm anlegen
nano src/haupt.adb
Füge diesen Inhalt ein:
with Ada.Text_IO; use Ada.Text_IO;
with Ada.Command_Line;
with Preise; use Preise;
procedure Haupt is
Preis : constant Cent := 69_900;
Rabatt : Prozent;
begin
if Ada.Command_Line.Argument_Count /= 1 then
Put_Line ("Aufruf: haupt RABATT");
return;
end if;
Rabatt := Prozent'Value (Ada.Command_Line.Argument (1));
Put_Line ("Listenpreis: " & Als_Text (Preis));
Put_Line ("Rabatt: " & Rabatt'Image & " %");
Put_Line ("Endpreis: " & Als_Text (Nach_Rabatt (Preis, Rabatt)));
exception
when Constraint_Error =>
Put_Line ("Ungültiger Rabatt: erlaubt sind 0 bis 50 Prozent.");
end Haupt;
69_900– Unterstriche in Zahlen dienen nur der Lesbarkeit.Prozent'Value (…)– wandelt den Text des ersten Arguments in eine Zahl um. Ist er keine Zahl oder liegt er außerhalb von 0 bis 50, löst das einenConstraint_Erroraus.exception … when– fängt den Fehler am Ende der Prozedur ab und gibt eine verständliche Meldung aus./=– bedeutet „ungleich“.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Projekt bauen
-P nennt die Projektdatei.
gprbuild -q -P rabatt.gpr
Prüfen: Der Befehl gibt nichts aus, auch keine Warnungen. Das Programm liegt in bin/haupt.
15. Mit gültigem Rabatt starten
bin/haupt 15
Prüfen: Die Ausgabe lautet:
Listenpreis: 699,00 Euro
Rabatt: 15 %
Endpreis: 594,15 Euro
16. Mit ungültigem Rabatt starten
bin/haupt 75
Prüfen: Die Ausgabe lautet Ungültiger Rabatt: erlaubt sind 0 bis 50 Prozent. Dasselbe erscheint bei einer Eingabe wie abc.
17. Nachbedingung ausprobieren (optional)
Ändere in src/preise.adb in der Funktion Nach_Rabatt das Minus in ein Plus (return Preis + Preis * Rabatt / 100;), baue neu und starte erneut mit bin/haupt 15. Der Preis wäre jetzt höher als vorher, und das Programm bricht mit raised ADA.ASSERTIONS.ASSERTION_ERROR : failed postcondition from preise.ads:10 ab. Mache die Änderung danach wieder rückgängig.
18. Zwischendateien entfernen
gprclean löscht alles, was gprbuild erzeugt hat, in obj und bin.
gprclean -q -P rabatt.gpr
Wie geht es weiter?
- Beweisen statt testen: Mit SPARK, einer Teilmenge von Ada, lassen sich Eigenschaften wie „kein Überlauf möglich“ mathematisch nachweisen. Das Werkzeug dafür heißt GNATprove.
- Bibliotheken: Alire (
sudo apt install alire, Befehlalr) legt Projekte an und lädt Bibliotheken aus seinem Verzeichnis https://alire.ada.dev. - Nebenläufigkeit: Ada hat eingebaute Tasks und geschützte Objekte für Programme, die mehrere Dinge gleichzeitig tun.
- Editor: Die Erweiterung „Ada & SPARK“ für Visual Studio Code bringt Autovervollständigung und Fehleranzeige.
- Dokumentation: Ein Lernpfad mit Beispielen zum Ausprobieren unter https://learn.adacore.com, der Sprachstandard unter https://ada-lang.io.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/ada-uebung ~/rabatt
2. GNAT und gprbuild entfernen
sudo apt purge gnat gprbuild
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Ada mitinstalliert wurden, z. B. gnat-14 und gcc-14. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl gnat wird nicht mehr gefunden.
gnat --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.adacore.com/
- Lizenz: GNAT Ada steht unter der GPL-3.0 with GCC Runtime Library Exception.
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.
COBOL
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
COBOL (Common Business Oriented Language) wurde 1959 für die Datenverarbeitung in Unternehmen entworfen. Die Sprache liest sich fast wie Englisch, rechnet mit Dezimalzahlen ohne Rundungsfehler und verarbeitet große Dateien Satz für Satz. Bis heute laufen in Banken, Versicherungen und Behörden viele Kernsysteme in COBOL.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert den freien Compiler GnuCOBOL 3.2. Er übersetzt COBOL zunächst in C und lässt dann gcc daraus ein Programm erzeugen. Zusammen mit den Abhängigkeiten sind das sechs Pakete.
- Feste Spalten: COBOL-Quelltext hat traditionell ein festes Format. Die Spalten 1 bis 6 sind für Zeilennummern reserviert, Spalte 7 für Sonderzeichen wie
*für Kommentare. Der eigentliche Code steht in den Spalten 8 bis 72, alles ab Spalte 73 wird ignoriert. Die Beispiele sind deshalb mit sieben Leerzeichen eingerückt. - Harmlose Warnung: Beim Übersetzen meldet gcc jedes Mal
warning: ‘_FORTIFY_SOURCE’ redefined. GnuCOBOL gibt eine Sicherheitseinstellung mit, die Ubuntu bei gcc schon in anderer Stufe voreingestellt hat. Das Programm ist trotzdem in Ordnung. - Version: Getestet mit GnuCOBOL 3.2.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. GnuCOBOL installieren
sudo apt install gnucobol
Prüfen: Die erste Zeile lautet cobc (GnuCOBOL) 3.2.0.
cobc --version
Ein erstes Programm
3. Übungsordner anlegen
mkdir ~/cobol-uebung
4. In den Ordner wechseln
cd ~/cobol-uebung
5. Quelltext anlegen
nano lager.cob
Füge diesen Inhalt ein (Strg+Umschalt+V). Die Einrückung muss erhalten bleiben:
IDENTIFICATION DIVISION.
PROGRAM-ID. LAGER.
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SPECIAL-NAMES.
DECIMAL-POINT IS COMMA.
DATA DIVISION.
WORKING-STORAGE SECTION.
01 BESTAND.
05 RAD OCCURS 3 TIMES.
10 MODELL PIC X(12).
10 PREIS PIC 9(5).
10 ANZAHL PIC 9(3).
01 I PIC 9.
01 WERT PIC 9(7) VALUE 0.
01 AUS-PREIS PIC ZZ.ZZ9.
01 AUS-ANZAHL PIC ZZ9.
01 AUS-WERT PIC Z.ZZZ.ZZ9.
PROCEDURE DIVISION.
MOVE "Citybike" TO MODELL(1)
MOVE 699 TO PREIS(1)
MOVE 4 TO ANZAHL(1)
MOVE "Trekkingrad" TO MODELL(2)
MOVE 899 TO PREIS(2)
MOVE 0 TO ANZAHL(2)
MOVE "Lastenrad" TO MODELL(3)
MOVE 3490 TO PREIS(3)
MOVE 1 TO ANZAHL(3)
PERFORM VARYING I FROM 1 BY 1 UNTIL I > 3
MOVE PREIS(I) TO AUS-PREIS
IF ANZAHL(I) > 0
MOVE ANZAHL(I) TO AUS-ANZAHL
DISPLAY MODELL(I) AUS-PREIS " Euro," AUS-ANZAHL
" auf Lager"
ELSE
DISPLAY MODELL(I) AUS-PREIS " Euro, ausverkauft"
END-IF
COMPUTE WERT = WERT + PREIS(I) * ANZAHL(I)
END-PERFORM
MOVE WERT TO AUS-WERT
DISPLAY "Lagerwert: " AUS-WERT " Euro"
STOP RUN.
- Divisions – ein COBOL-Programm hat vier Teile:
IDENTIFICATION(Name),ENVIRONMENT(Umgebung, z. B. Dateien und Zahlenformat),DATA(alle Variablen) undPROCEDURE(die Anweisungen). DECIMAL-POINT IS COMMA– Zahlen werden wie in Deutschland mit Komma als Dezimalzeichen und Punkt als Tausendertrennzeichen geschrieben.PIC– beschreibt das Format einer Variablen.X(12)sind zwölf beliebige Zeichen,9(5)fünf Ziffern. Druckformate wieZZ.ZZ9unterdrücken führende Nullen (Z) und setzen Tausenderpunkte.- Stufennummern –
01beginnt einen Datensatz,05und10sind Unterfelder.OCCURS 3 TIMESmacht daraus eine Tabelle mit drei Einträgen. MOVE,COMPUTE,PERFORM VARYING– Wert übertragen, rechnen, Schleife mit Zähler.MOVE PREIS(I) TO AUS-PREISbringt die Zahl dabei in das Druckformat.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen
-x erzeugt ein ausführbares Programm statt eines Moduls zum Nachladen.
cobc -x lager.cob
Prüfen: Außer der harmlosen Warnung zu _FORTIFY_SOURCE erscheint keine Meldung, und im Ordner liegt das Programm lager.
7. Programm starten
./lager
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3.490 Euro, 1 auf Lager
Lagerwert: 6.286 Euro
Eine Datei verarbeiten
Das zweite Programm liest Verkäufe aus einer Datei, rechnet Beträge mit Cent genau aus, schlägt die Umsatzsteuer auf und schreibt einen Bericht in eine neue Datei.
8. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699,00
Lastenrad;1;3490,00
Citybike;3;699,00
Trekkingrad;1;899,00
Fahrradschloss;4;49,90
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Programm anlegen
nano bericht.cob
Füge diesen Inhalt ein:
IDENTIFICATION DIVISION.
PROGRAM-ID. BERICHT.
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SPECIAL-NAMES.
DECIMAL-POINT IS COMMA.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT VERKAUFSDATEI ASSIGN TO "verkauf.csv"
ORGANIZATION IS LINE SEQUENTIAL.
SELECT BERICHTSDATEI ASSIGN TO "bericht.txt"
ORGANIZATION IS LINE SEQUENTIAL.
DATA DIVISION.
FILE SECTION.
FD VERKAUFSDATEI.
01 VERKAUFSSATZ PIC X(80).
FD BERICHTSDATEI.
01 BERICHTSZEILE PIC X(60).
WORKING-STORAGE SECTION.
01 DATEIENDE PIC X VALUE "N".
01 FELDER.
05 F-MODELL PIC X(20).
05 F-ANZAHL PIC X(5).
05 F-PREIS PIC X(12).
01 ANZAHL PIC 9(3).
01 PREIS PIC 9(5)V99.
01 BETRAG PIC 9(7)V99.
01 NETTO PIC 9(7)V99 VALUE 0.
01 STEUER PIC 9(7)V99.
01 BRUTTO PIC 9(7)V99.
01 POSTEN PIC 99 VALUE 0.
01 AUS-POSTEN PIC Z9.
01 ZEILE.
05 Z-MODELL PIC X(16).
05 Z-ANZAHL PIC ZZ9.
05 FILLER PIC X(3) VALUE " x ".
05 Z-PREIS PIC Z.ZZ9,99.
05 FILLER PIC X(3) VALUE " = ".
05 Z-BETRAG PIC ZZZ.ZZ9,99.
01 SUMMENZEILE.
05 S-TEXT PIC X(33).
05 S-BETRAG PIC ZZZ.ZZ9,99.
PROCEDURE DIVISION.
OPEN INPUT VERKAUFSDATEI
OPEN OUTPUT BERICHTSDATEI
PERFORM UNTIL DATEIENDE = "J"
READ VERKAUFSDATEI
AT END
MOVE "J" TO DATEIENDE
NOT AT END
PERFORM POSTEN-VERARBEITEN
END-READ
END-PERFORM
COMPUTE STEUER ROUNDED = NETTO * 0,19
COMPUTE BRUTTO = NETTO + STEUER
MOVE "Summe netto" TO S-TEXT
MOVE NETTO TO S-BETRAG
WRITE BERICHTSZEILE FROM SUMMENZEILE
MOVE "zzgl. 19 % Umsatzsteuer" TO S-TEXT
MOVE STEUER TO S-BETRAG
WRITE BERICHTSZEILE FROM SUMMENZEILE
MOVE "Summe brutto" TO S-TEXT
MOVE BRUTTO TO S-BETRAG
WRITE BERICHTSZEILE FROM SUMMENZEILE
CLOSE VERKAUFSDATEI BERICHTSDATEI
MOVE POSTEN TO AUS-POSTEN
DISPLAY AUS-POSTEN " Posten, Bericht in bericht.txt"
STOP RUN.
POSTEN-VERARBEITEN.
UNSTRING VERKAUFSSATZ DELIMITED BY ";"
INTO F-MODELL F-ANZAHL F-PREIS
END-UNSTRING
COMPUTE ANZAHL = FUNCTION NUMVAL(F-ANZAHL)
COMPUTE PREIS = FUNCTION NUMVAL(F-PREIS)
COMPUTE BETRAG = ANZAHL * PREIS
ADD BETRAG TO NETTO
ADD 1 TO POSTEN
MOVE F-MODELL TO Z-MODELL
MOVE ANZAHL TO Z-ANZAHL
MOVE PREIS TO Z-PREIS
MOVE BETRAG TO Z-BETRAG
WRITE BERICHTSZEILE FROM ZEILE.
SELECT … ASSIGN TO– verbindet einen Namen im Programm mit einer Datei.LINE SEQUENTIALbedeutet: eine Textdatei mit einem Satz pro Zeile.FD– beschreibt den Aufbau eines Satzes der Datei, hier eine Zeile mit bis zu 80 bzw. 60 Zeichen.PIC 9(5)V99– eine Zahl mit fünf Stellen vor und zwei nach dem Komma.Vmarkiert das gedachte Komma. COBOL rechnet damit genau, ohne die Rundungsfehler von Gleitkommazahlen.READ … AT END– liest den nächsten Satz. Am Dateiende wirdDATEIENDEauf „J“ gesetzt und die Schleife beendet.UNSTRING … DELIMITED BY ";"– zerlegt die Zeile an den Semikolons.FUNCTION NUMVALwandelt den Text in eine Zahl um und beachtet dabei das Komma als Dezimalzeichen.COMPUTE … ROUNDED– rechnet die Umsatzsteuer und rundet auf zwei Nachkommastellen.PERFORM POSTEN-VERARBEITEN– ruft den gleichnamigen Abschnitt (Paragraph) am Ende auf.WRITE … FROM– schreibt eine aufbereitete Zeile in die Berichtsdatei.FILLERsind feste Textstücke ohne eigenen Namen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Programm übersetzen
cobc -x bericht.cob
Prüfen: Außer der Warnung zu _FORTIFY_SOURCE erscheint keine Meldung. Ist eine Zeile länger als 72 Zeichen, schneidet COBOL sie ab und meldet einen Fehler wie continuation character expected.
11. Programm starten
./bericht
Prüfen: Die Ausgabe lautet 5 Posten, Bericht in bericht.txt.
12. Bericht ansehen
cat bericht.txt
Prüfen: Der Bericht lautet:
Citybike 2 x 699,00 = 1.398,00
Lastenrad 1 x 3.490,00 = 3.490,00
Citybike 3 x 699,00 = 2.097,00
Trekkingrad 1 x 899,00 = 899,00
Fahrradschloss 4 x 49,90 = 199,60
Summe netto 8.083,60
zzgl. 19 % Umsatzsteuer 1.535,88
Summe brutto 9.619,48
Wie geht es weiter?
- Freies Format: Mit
cobc -x -free datei.cobgelten die festen Spalten nicht mehr, und Zeilen dürfen beliebig lang sein. In älterem Code und in Unternehmen ist das feste Format aber üblich. - Programme aufteilen: Unterprogramme stehen in eigenen Dateien und werden mit
CALL "NAME" USING …aufgerufen.cobc -x haupt.cob unter.cobübersetzt beide zusammen. - Weitergeben: Die Programme brauchen zur Laufzeit die Bibliothek
libcob. Auf einem anderen Rechner mit Ubuntu genügt dafür das Paketlibcob4t64. - Editor: Für Visual Studio Code gibt es Erweiterungen für COBOL, die Syntax hervorheben und die Spalte 72 markieren.
- Dokumentation: Handbuch und Beispiele unter https://gnucobol.sourceforge.io.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/cobol-uebung
2. GnuCOBOL entfernen
sudo apt purge gnucobol gnucobol3
3. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für GnuCOBOL mitinstalliert wurden, z. B. libcob4t64. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl cobc wird nicht mehr gefunden.
cobc --version
Quellen und Lizenz
- Offizielle Dokumentation: https://gnucobol.sourceforge.io/
- Lizenz: GnuCOBOL steht unter der GPL-3.0 / LGPL-3.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.
Assembler (NASM)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Assembler ist die Programmiersprache, die dem Prozessor am nächsten ist: Jede Zeile entspricht einem Maschinenbefehl. Man arbeitet direkt mit Registern, Speicheradressen und Systemaufrufen. Heute schreibt man ganze Programme selten in Assembler, aber er hilft zu verstehen, was ein Compiler erzeugt, und wird für besonders zeitkritische Teile, Betriebssysteme und die Fehlersuche gebraucht. Diese Anleitung verwendet den Netwide Assembler (NASM) für 64-Bit-Prozessoren von Intel und AMD (x86-64).
Vorbemerkungen
- Nur für x86-64: Assembler ist an den Prozessor gebunden. Die Beispiele laufen auf Rechnern mit Intel- oder AMD-Prozessor unter 64-Bit-Linux, nicht auf ARM-Rechnern wie dem Raspberry Pi.
- Installation über apt: Ubuntu 26.04 liefert NASM 3.01. Zum Verbinden der übersetzten Teile (Linken) dienen
ldaus den GNU Binutils undgcc, zur Fehlersuchegdb. Ist C schon eingerichtet, ist davon alles vorhanden. - Intel-Schreibweise: NASM schreibt Befehle als
mov ziel, quelle. Der GNU-Assembler und viele Ausgaben von Linux-Werkzeugen verwenden dagegen die umgekehrte AT&T-Schreibweise. - Version: Getestet mit NASM 3.01, GNU Binutils 2.46 und gcc 15 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. NASM, gcc und gdb installieren
Sind gcc und gdb schon vorhanden, meldet apt das nur.
sudo apt install nasm gcc gdb
Prüfen: Die Ausgabe lautet NASM version 3.01.
nasm -v
Ein Programm nur mit Systemaufrufen
3. Übungsordner anlegen
mkdir ~/asm-uebung
4. In den Ordner wechseln
cd ~/asm-uebung
5. Quelltext anlegen
Das Programm gibt einen Text aus und beendet sich. Es benutzt keine Bibliothek, sondern bittet den Linux-Kern direkt per Systemaufruf darum.
nano hallo.asm
Füge diesen Inhalt ein (Strg+Umschalt+V):
; Gibt einen Text aus und beendet sich – nur mit Systemaufrufen von Linux
section .data
text db "Hallo aus Assembler!", 10 ; 10 = Zeilenumbruch
laenge equ $ - text ; Länge des Texts in Bytes
section .text
global _start
_start:
mov rax, 1 ; Systemaufruf 1: write
mov rdi, 1 ; Ausgabekanal 1: Standardausgabe
mov rsi, text ; Adresse des Texts
mov rdx, laenge ; Anzahl der Bytes
syscall
mov rax, 60 ; Systemaufruf 60: exit
xor rdi, rdi ; Rückgabewert 0
syscall
- Abschnitte –
section .dataenthält Daten,section .textden Code. db– legt Bytes im Speicher ab, hier den Text.equ $ - textberechnet beim Übersetzen die Länge:$ist die aktuelle Adresse.- Register –
rax,rdi,rsi,rdxsind 64-Bit-Speicherplätze im Prozessor. Für einen Systemaufruf stehen inraxseine Nummer und inrdi,rsi,rdxdie Werte, die er braucht. syscall– übergibt an den Linux-Kern.write(Nummer 1) schreibt die Bytes,exit(Nummer 60) beendet das Programm.xor rdi, rdi– setzt ein Register auf 0, ein üblicher Kniff, weil der Befehl kürzer ist alsmov rdi, 0._start– an dieser Stelle beginnt das Programm.globalmacht den Namen für den Linker sichtbar.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Übersetzen
-f elf64 erzeugt eine Objektdatei im 64-Bit-Format von Linux, hier hallo.o.
nasm -f elf64 hallo.asm
7. Linken
ld macht aus der Objektdatei ein ausführbares Programm.
ld -o hallo hallo.o
8. Programm starten
./hallo
Prüfen: Die Ausgabe lautet Hallo aus Assembler!. Das Programm ist knapp 9 KB groß, und file hallo meldet statically linked.
Eine Assembler-Funktion für C
Häufiger als ganze Programme schreibt man einzelne Funktionen in Assembler und ruft sie aus C auf. Die Funktion hier berechnet den Lagerwert aus zwei Listen mit Preisen und Anzahlen.
9. Funktion in Assembler anlegen
nano lagerwert.asm
Füge diesen Inhalt ein:
; long lagerwert(const int *preis, const int *anzahl, long n)
; Summe aus preis[i] * anzahl[i] für i = 0 … n-1
; Die Parameter kommen nach der System-V-Aufrufkonvention in rdi, rsi, rdx,
; das Ergebnis geht in rax zurück.
section .text
global lagerwert
lagerwert:
xor rax, rax ; Summe = 0
xor rcx, rcx ; i = 0
.schleife:
cmp rcx, rdx ; i < n ?
jge .fertig
movsxd r8, dword [rdi + rcx*4] ; preis[i] laden (4 Byte, mit Vorzeichen erweitern)
movsxd r9, dword [rsi + rcx*4] ; anzahl[i] laden
imul r8, r9 ; preis[i] * anzahl[i]
add rax, r8 ; zur Summe addieren
inc rcx ; i++
jmp .schleife
.fertig:
ret
section .note.GNU-stack noalloc noexec nowrite progbits
- Aufrufkonvention – Linux legt fest, in welchen Registern eine Funktion ihre Parameter bekommt (
rdi,rsi,rdx, …) und wo sie das Ergebnis abliefert (rax). Nur deshalb kann C die Funktion aufrufen. - Schleife –
cmpvergleicht,jgespringt bei „größer oder gleich“ zum Ende,jmpspringt zurück an den Anfang. Namen mit Punkt wie.schleifegelten nur innerhalb der Funktion. [rdi + rcx*4]– liest aus dem Speicher: die Startadresse der Liste plus Position mal 4, denn einintbelegt 4 Bytes.dwordsagt, dass 4 Bytes gelesen werden.movsxderweitert sie auf 64 Bit.ret– kehrt zum Aufrufer zurück.- Letzte Zeile – kennzeichnet, dass der Code keinen ausführbaren Stapelspeicher braucht. Ohne sie können manche Linker eine Warnung ausgeben oder den Stapel ausführbar machen, was ein Sicherheitsrisiko wäre.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Hauptprogramm in C anlegen
nano lager.c
Füge diesen Inhalt ein:
#include <stdio.h>
long lagerwert(const int *preis, const int *anzahl, long n);
int main(void) {
const char *modell[] = {"Citybike", "Trekkingrad", "Lastenrad"};
int preis[] = {699, 899, 3490};
int anzahl[] = {4, 0, 1};
for (int i = 0; i < 3; i++)
printf("%-12s %5d Euro, %d auf Lager\n", modell[i], preis[i], anzahl[i]);
printf("Lagerwert: %ld Euro\n", lagerwert(preis, anzahl, 3));
return 0;
}
Die Zeile long lagerwert(…); sagt dem C-Compiler, wie die Assembler-Funktion aufgerufen wird. Ihren Code findet erst der Linker.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Funktion übersetzen
-g -F dwarf schreibt Informationen für den Debugger mit hinein, damit gdb später die Zeilen des Quelltexts zeigen kann.
nasm -f elf64 -g -F dwarf lagerwert.asm
12. Alles zusammen übersetzen und linken
gcc übersetzt lager.c und verbindet es mit lagerwert.o und der C-Bibliothek.
gcc -g -Wall -o lager lager.c lagerwert.o
13. Programm starten
./lager
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, 0 auf Lager
Lastenrad 3490 Euro, 1 auf Lager
Lagerwert: 6286 Euro
14. In die Register schauen
gdb hält das Programm an der Marke .fertig an, kurz bevor die Funktion zurückkehrt, und zeigt zwei Register. -batch führt die Befehle nach -ex der Reihe nach aus und beendet gdb danach.
gdb -q -batch -ex 'break lagerwert.fertig' -ex run -ex 'info registers rax rcx' ./lager
Prüfen: Die letzten Zeilen lauten:
rax 0x188e 6286
rcx 0x3 3
rax enthält das Ergebnis 6286, hexadezimal 0x188e, und rcx den Zähler, der bei 3 stehen geblieben ist.
Wie geht es weiter?
- Sehen, was der Compiler erzeugt:
gcc -O2 -S -masm=intel lager.cschreibt den Assemblercode zulager.cin die Dateilager.s.objdump -d -M intel lagerwert.ozeigt die Maschinenbefehle einer Objektdatei. - Schritt für Schritt: In gdb ohne
-batchgehtstepieinen Maschinenbefehl weiter,layout asmzeigt den Code undlayout regsdie Register laufend an. - Systemaufrufe: Die Nummern aller Systemaufrufe stehen in
/usr/include/x86_64-linux-gnu/asm/unistd_64.h. - Andere Prozessoren: Für ARM-Rechner gibt es eigene Assembler-Werkzeuge, z. B. im Paket
binutils-aarch64-linux-gnu. - Dokumentation: Das Handbuch zu NASM steht unter https://www.nasm.us/docs.html.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/asm-uebung
2. NASM entfernen
gcc und gdb bleiben installiert, weil sie meist auch für anderes gebraucht werden.
sudo apt purge nasm
Prüfen: Der Befehl nasm wird nicht mehr gefunden.
nasm -v
Quellen und Lizenz
- Offizielle Dokumentation: https://www.nasm.us/docs.php
- Lizenz: NASM steht unter der 2-Clause BSD.
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.
Prolog (SWI-Prolog)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Prolog ist eine Sprache der Logikprogrammierung. Statt Schritt für Schritt vorzuschreiben, wie etwas berechnet wird, beschreibt man Fakten und Regeln. Prolog sucht dann selbst alle Antworten auf eine Frage. Das eignet sich für Wissensbasen, Planungs- und Rätselaufgaben, Sprachverarbeitung und Regelwerke. SWI-Prolog ist die verbreitetste freie Umsetzung.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert SWI-Prolog 9.2. Das Paket
swi-prolog-noxenthält die Sprache ohne grafische Werkzeuge. Mit--no-install-recommendssind das nur 4 Pakete, mit Empfehlungen 25. - Andere Denkweise: Ein Prolog-Programm wird nicht gestartet, sondern befragt. Man lädt die Datei und stellt Anfragen wie
lieferbar(X)., auf die Prolog alle passenden Werte fürXsucht. - Schreibweise: Namen von Fakten und Werten beginnen mit einem Kleinbuchstaben (
citybike), Variablen mit einem Großbuchstaben (Name). Jede Aussage endet mit einem Punkt. - Version: Getestet mit SWI-Prolog 9.2.9 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. SWI-Prolog installieren
sudo apt install --no-install-recommends swi-prolog-nox
Prüfen: Die Ausgabe lautet SWI-Prolog version 9.2.9 for x86_64-linux.
swipl --version
Eine Wissensbasis
3. Übungsordner anlegen
mkdir ~/prolog-uebung
4. In den Ordner wechseln
cd ~/prolog-uebung
5. Fakten und Regeln anlegen
Prolog-Dateien haben die Endung .pl.
nano laden.pl
Füge diesen Inhalt ein (Strg+Umschalt+V):
% Fakten: modell(Name, Art, Preis)
modell(citybike, stadt, 699).
modell(trekkingrad, touren, 899).
modell(lastenrad, transport, 3490).
modell(rennrad, sport, 1899).
% Fakten: lager(Name, Anzahl)
lager(citybike, 4).
lager(trekkingrad, 0).
lager(lastenrad, 1).
lager(rennrad, 2).
% Regel: Ein Modell ist lieferbar, wenn mindestens eins auf Lager ist.
lieferbar(Name) :-
lager(Name, Anzahl),
Anzahl > 0.
% Regel: passend für ein Budget und lieferbar
empfehlung(Budget, Name, Preis) :-
modell(Name, _, Preis),
Preis =< Budget,
lieferbar(Name).
% Regel: Lagerwert aller Räder
lagerwert(Summe) :-
findall(Wert, (modell(Name, _, Preis), lager(Name, Anzahl), Wert is Preis * Anzahl), Werte),
sum_list(Werte, Summe).
- Fakten –
modell(citybike, stadt, 699).ist eine Aussage, die einfach gilt. - Regeln –
lieferbar(Name) :- lager(Name, Anzahl), Anzahl > 0.liest sich: „Name ist lieferbar, wenn es ein Lager mit Name und Anzahl gibt und die Anzahl größer als 0 ist.“:-bedeutet „wenn“, das Komma „und“. _– eine Variable, deren Wert nicht interessiert.is– rechnet.Wert is Preis * Anzahlweist das Ergebnis zu.=<heißt „kleiner oder gleich“.findall– sammelt alle Lösungen in einer Liste.sum_listaddiert sie.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Wissensbasis laden
swipl mit Dateinamen lädt die Datei und öffnet die Eingabe für Anfragen. Die Eingabezeile lautet ?-.
swipl laden.pl
7. Fragen stellen
Gib die folgende Anfrage ein und drücke Enter. Der Punkt am Ende gehört dazu.
lieferbar(X).
Prolog antwortet mit X = citybike. Drücke ; für die nächste Antwort, bis keine mehr kommt: X = lastenrad und X = rennrad. Der Punkt hinter der letzten Antwort zeigt, dass es keine weiteren gibt. Mit Enter statt ; beendet man die Suche vorzeitig.
Probiere weitere Anfragen aus:
empfehlung(1000, Name, Preis).
lagerwert(Summe).
lieferbar(trekkingrad).
Prüfen:
- Bei
empfehlungantwortet Prolog mitName = citybike, Preis = 699und wartet, weil es noch weitere Lösungen geben könnte. Drücke ;, um weiterzusuchen. Es folgtfalse., denn das Rennrad liegt mit 1899 Euro über dem Budget und das Trekkingrad ist nicht auf Lager. Mit Enter statt ; nimmt man die erste Antwort. lagerwert(Summe).antwortetSumme = 10084.lieferbar(trekkingrad).antwortetfalse.Die Aussage gilt nicht, weil kein Trekkingrad auf Lager ist.
Beende Prolog mit halt.
8. Anfragen ohne Eingabe stellen
-g stellt eine Anfrage direkt beim Start, -t halt beendet Prolog danach. -q lässt die Begrüßung weg. forall geht alle Lösungen durch, format gibt sie aus.
swipl -q -s laden.pl -g "forall(empfehlung(1000, N, P), format('~w für ~w Euro~n', [N, P]))" -t halt
Prüfen: Die Ausgabe lautet citybike für 699 Euro.
Rätsel lösen mit Constraints
Die Bibliothek CLP(FD) rechnet mit ganzen Zahlen, deren Werte noch nicht feststehen. Man beschreibt nur die Bedingungen, Prolog findet die passenden Werte.
9. Programm anlegen
nano werkstatt.pl
Füge diesen Inhalt ein:
:- use_module(library(clpfd)).
% Wie viele Citybikes (699 Euro) und Lastenräder (3490 Euro)
% ergeben zusammen genau einen Rechnungsbetrag?
rechnung(Betrag, Citybikes, Lastenraeder) :-
[Citybikes, Lastenraeder] ins 0..20,
699 * Citybikes + 3490 * Lastenraeder #= Betrag,
label([Citybikes, Lastenraeder]).
% Drei Reparaturen auf die Tage Montag (1) bis Freitag (5) verteilen:
% - jede an einem anderen Tag
% - die Bremse vor der Schaltung
% - der Reifen nicht am Montag
% - die Werkstatt nimmt nur dienstags (2) und donnerstags (4) Schaltungen an
plan(Bremse, Schaltung, Reifen) :-
Tage = [Bremse, Schaltung, Reifen],
Tage ins 1..5,
all_different(Tage),
Bremse #< Schaltung,
Reifen #\= 1,
Schaltung in 2 \/ 4,
label(Tage).
tag(1, montag).
tag(2, dienstag).
tag(3, mittwoch).
tag(4, donnerstag).
tag(5, freitag).
zeige_plaene :-
forall(plan(B, S, R),
( tag(B, TB), tag(S, TS), tag(R, TR),
format("Bremse: ~w, Schaltung: ~w, Reifen: ~w~n", [TB, TS, TR]) )).
:- use_module(library(clpfd)).– lädt die Bibliothek beim Laden der Datei.ins 0..20undin 2 \/ 4– legen fest, welche Werte möglich sind: 0 bis 20 bzw. nur 2 oder 4.#=,#<,#\=– Bedingungen zwischen Zahlen: gleich, kleiner, ungleich. Anders alsisfunktionieren sie in beide Richtungen.all_different– alle Werte der Liste müssen verschieden sein.label– probiert konkrete Werte aus, die alle Bedingungen erfüllen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Rechnung zerlegen
Welche Mischung aus Citybikes und Lastenrädern ergibt genau 9077 Euro?
swipl -q -s werkstatt.pl -g "rechnung(9077, C, L), format('~w Citybikes und ~w Lastenräder~n', [C, L])" -t halt
Prüfen: Die Ausgabe lautet 3 Citybikes und 2 Lastenräder.
11. Dieselbe Regel rückwärts verwenden
Diesmal sind die Stückzahlen bekannt und der Betrag gesucht. Die Regel bleibt dieselbe.
swipl -q -s werkstatt.pl -g "rechnung(Betrag, 3, 2), writeln(Betrag)" -t halt
Prüfen: Die Ausgabe lautet 9077. Für einen Betrag ohne passende Mischung, etwa 5000, findet Prolog keine Lösung und meldet bei einer Anfrage false.
12. Alle Wochenpläne ausgeben
swipl -q -s werkstatt.pl -g zeige_plaene -t halt
Prüfen: Prolog findet zehn Pläne, die alle Bedingungen erfüllen. Der erste lautet Bremse: montag, Schaltung: dienstag, Reifen: mittwoch, der letzte Bremse: mittwoch, Schaltung: donnerstag, Reifen: freitag.
Wie geht es weiter?
- Fehlersuche:
trace.vor einer Anfrage zeigt Schritt für Schritt, wie Prolog nach Lösungen sucht. - Listen:
[Kopf | Rest]zerlegt eine Liste in ihr erstes Element und den Rest. Darauf bauen die meisten Prolog-Programme auf, z. B.member/2,append/3undlength/2. - Daten und Web: SWI-Prolog bringt Bibliotheken für CSV (
library(csv)), JSON (library(http/json)) und einen eingebauten Webserver mit. - Zusatzpakete:
pack_install(Name).installiert Erweiterungen aus der Paketliste unter https://www.swi-prolog.org/pack/list. - Dokumentation: Handbuch und Einführungen unter https://www.swi-prolog.org. Das freie Buch „Learn Prolog Now!“ ist ein bewährter Einstieg.
Deinstallieren
1. Übungsordner entfernen
rm -rf ~/prolog-uebung
2. SWI-Prolog entfernen
sudo apt purge swi-prolog-nox swi-prolog-core swi-prolog-core-packages
3. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
4. Einstellungen und Verlauf entfernen (optional)
SWI-Prolog kann einen Befehlsverlauf und Einstellungen in diesen Ordnern ablegen.
rm -rf ~/.local/share/swi-prolog ~/.config/swi-prolog
Prüfen: Der Befehl swipl wird nicht mehr gefunden.
swipl --version
Quellen und Lizenz
- Offizielle Dokumentation: https://www.swi-prolog.org/
- Lizenz: SWI-Prolog steht unter der Simplified BSD.
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.
Common Lisp (SBCL)
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Common Lisp ist eine der ältesten noch genutzten Programmiersprachen und zugleich sehr wandelbar. Programme bestehen aus Ausdrücken in Klammern, die selbst wieder Daten sind. Deshalb lässt sich die Sprache mit Makros um eigene Sprachmittel erweitern. Typisch ist das interaktive Arbeiten: Man ändert ein laufendes Programm Stück für Stück, ohne es neu zu starten. SBCL (Steel Bank Common Lisp) ist der verbreitetste freie Compiler und erzeugt schnellen Maschinencode.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert SBCL 2.6 und viele Lisp-Bibliotheken als Pakete mit dem Namen
cl-…, etwacl-ppcrefür reguläre Ausdrücke odercl-yasonfür JSON. Sie liegen unter/usr/share/common-lispund werden über ASDF geladen, das Bauwerkzeug von Common Lisp, das in SBCL eingebaut ist. - Ein Packfehler: Das Paket
cl-yasonbraucht die Bibliothek alexandria, zieht das Paketcl-alexandriaaber nicht selbst mit. Ohne sie meldet ASDFComponent :ALEXANDRIA not found. Die Anleitung installiert es deshalb ausdrücklich. - Quicklisp: Viele Anleitungen im Netz verwenden Quicklisp, einen Paketmanager, der Bibliotheken aus dem Internet lädt. Er ist nicht in den Ubuntu-Paketquellen. Für den Einstieg reichen die Bibliotheken aus
apt. - Version: Getestet mit SBCL 2.6.0 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. SBCL und Bibliotheken installieren
sbcl– der Compiler samt Konsolecl-ppcre– reguläre Ausdrücke, hier zum Zerlegen von Zeilencl-yasonundcl-alexandria– JSON samt der fehlenden Abhängigkeit
sudo apt install sbcl cl-ppcre cl-yason cl-alexandria
Prüfen: Die Ausgabe lautet SBCL 2.6.0.debian.
sbcl --version
Erste Schritte
3. Konsole starten
Die Eingabezeile ist ein Sternchen *.
sbcl
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter. In Lisp steht die Funktion immer am Anfang der Klammer:
(+ 1 2 3)
(mapcar (lambda (x) (* x x)) (list 1 2 3 4))
Prüfen: Die Antworten lauten 6 und (1 4 9 16). mapcar wendet die namenlose Funktion (lambda) auf jedes Element der Liste an. Beende die Konsole mit (exit).
Ein Skript
5. Übungsordner anlegen
mkdir ~/lisp-uebung
6. In den Ordner wechseln
cd ~/lisp-uebung
7. Skript anlegen
nano lager.lisp
Füge diesen Inhalt ein (Strg+Umschalt+V):
;;;; Lagerbestand eines Fahrradladens
(defstruct fahrrad modell preis anzahl)
(defparameter *bestand*
(list (make-fahrrad :modell "Citybike" :preis 699 :anzahl 4)
(make-fahrrad :modell "Trekkingrad" :preis 899 :anzahl 0)
(make-fahrrad :modell "Lastenrad" :preis 3490 :anzahl 1)))
(defun status (rad)
(if (plusp (fahrrad-anzahl rad))
(format nil "~D auf Lager" (fahrrad-anzahl rad))
"ausverkauft"))
(defun lagerwert (raeder)
(loop for rad in raeder
sum (* (fahrrad-preis rad) (fahrrad-anzahl rad))))
(dolist (rad *bestand*)
(format t "~12A ~5D Euro, ~A~%" (fahrrad-modell rad) (fahrrad-preis rad) (status rad)))
(format t "Sofort lieferbar: ~{~A~^, ~}~%"
(mapcar #'fahrrad-modell (remove-if-not #'plusp *bestand* :key #'fahrrad-anzahl)))
(format t "Lagerwert: ~D Euro~%" (lagerwert *bestand*))
defstruct– legt eine Struktur mit benannten Feldern an. Lisp erzeugt dazu von selbstmake-fahrradzum Anlegen undfahrrad-preisusw. zum Lesen.defparameter– eine globale Variable. Die Sternchen im Namen sind Brauch für globale Variablen.defun– definiert eine Funktion.pluspprüft, ob eine Zahl größer als 0 ist.loop … sum– eine Schleife, die gleich mitzählt.format– gibt formatiert aus.tschreibt ins Terminal,nilliefert den Text zurück.~Aist ein beliebiger Wert,~Deine ganze Zahl,~%ein Zeilenumbruch.~{~A~^, ~}gibt eine Liste mit Kommas dazwischen aus.#'– verweist auf eine Funktion, damit man sie an eine andere Funktion übergeben kann, wie beiremove-if-not.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Skript ausführen
--script führt die Datei aus und beendet SBCL danach.
sbcl --script lager.lisp
Prüfen: Die Ausgabe lautet:
Citybike 699 Euro, 4 auf Lager
Trekkingrad 899 Euro, ausverkauft
Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
Ein Projekt mit ASDF
ASDF findet Projekte von selbst, wenn sie im Ordner ~/common-lisp liegen. Das Projekt liest Verkäufe aus einer Datei, zählt den Umsatz je Modell zusammen und schreibt ihn als JSON.
9. Projektordner anlegen
mkdir -p ~/common-lisp/umsatz
10. In den Projektordner wechseln
cd ~/common-lisp/umsatz
11. Systembeschreibung anlegen
Die Datei mit der Endung .asd beschreibt das Projekt für ASDF.
nano umsatz.asd
Füge diesen Inhalt ein:
(defsystem "umsatz"
:description "Zählt Umsätze je Modell zusammen"
:depends-on ("cl-ppcre" "yason")
:components ((:file "umsatz"))
:build-operation "program-op"
:build-pathname "umsatz"
:entry-point "umsatz:main")
:depends-on– die Bibliotheken, die ASDF vorher lädt. Sie kommen aus den Ubuntu-Paketen.:components– die Quelldateien, hier nurumsatz.lisp.:build-operation "program-op"– beim Bauen entsteht ein eigenständiges Programm namensumsatz, das mit der Funktionumsatz:mainstartet.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm anlegen
nano umsatz.lisp
Füge diesen Inhalt ein:
(defpackage :umsatz
(:use :cl)
(:export #:main #:summen))
(in-package :umsatz)
(defun zeile-zerlegen (zeile)
"\"Citybike;2;699\" -> (\"Citybike\" 2 699)"
(destructuring-bind (modell anzahl preis) (cl-ppcre:split ";" zeile)
(list modell (parse-integer anzahl) (parse-integer preis))))
(defun summen (verkaeufe)
"Liefert eine Hash-Tabelle Modell -> Umsatz."
(let ((tabelle (make-hash-table :test #'equal)))
(loop for (modell anzahl preis) in verkaeufe
do (incf (gethash modell tabelle 0) (* anzahl preis)))
tabelle))
(defun main ()
(let ((datei (second sb-ext:*posix-argv*)))
(unless datei
(format t "Aufruf: umsatz DATEI~%")
(sb-ext:exit :code 1))
(let* ((zeilen (with-open-file (ein datei)
(loop for zeile = (read-line ein nil) while zeile collect zeile)))
(tabelle (summen (mapcar #'zeile-zerlegen zeilen)))
(liste (loop for modell being the hash-keys of tabelle using (hash-value betrag)
collect (cons modell betrag))))
(dolist (eintrag (sort liste #'> :key #'cdr))
(format t "~12A ~5D Euro~%" (car eintrag) (cdr eintrag)))
(with-open-file (aus "umsatz.json" :direction :output :if-exists :supersede)
(yason:encode tabelle aus))
(format t "Gespeichert: umsatz.json~%"))))
defpackageundin-package– ein Paket ist ein eigener Namensraum.:exportmachtmainundsummenvon außen alsumsatz:mainundumsatz:summenerreichbar.destructuring-bind– zerlegt die Liste auscl-ppcre:splitin drei Namen.- Hash-Tabelle –
(gethash modell tabelle 0)liest einen Eintrag oder liefert 0.incferhöht ihn.:test #'equalsorgt dafür, dass Texte nach ihrem Inhalt verglichen werden. sb-ext:*posix-argv*– die Argumente beim Aufruf. Das erste ist der Programmname, das zweite der Dateiname.with-open-file– öffnet eine Datei und schließt sie am Ende des Blocks sicher wieder.yason:encode– schreibt die Hash-Tabelle als JSON-Objekt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Programm bauen
SBCL lädt ASDF, übersetzt das Projekt samt Bibliotheken und speichert das Ergebnis als Programm. --non-interactive beendet SBCL danach. Die vielen Zeilen mit ; am Anfang sind Meldungen des Compilers.
sbcl --non-interactive --eval '(require :asdf)' --eval '(asdf:make "umsatz")'
Prüfen: Im Ordner liegt das Programm umsatz. Es ist rund 37 MB groß, weil es das ganze Lisp-System enthält, und läuft auch auf Rechnern ohne SBCL.
15. Programm starten
./umsatz verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}.
16. Projekt in der Konsole ausprobieren
So arbeitet man in Lisp meist: Man lädt das Projekt in die Konsole und ruft einzelne Funktionen auf. Starte dazu sbcl und gib ein:
(require :asdf)
(asdf:load-system "umsatz")
(gethash "A" (umsatz:summen (list (list "A" 2 10) (list "B" 1 50) (list "A" 1 10))))
Prüfen: Die letzte Antwort lautet 30 und T. Das zweite Ergebnis T bedeutet, dass der Eintrag gefunden wurde. Beende die Konsole mit (exit).
Wie geht es weiter?
- Bequemer arbeiten: Emacs mit SLIME (Paket
slime) oder SLY verbindet den Editor mit einer laufenden Lisp-Konsole. Man schickt einzelne Funktionen per Tastendruck an Lisp und sieht das Ergebnis sofort. - Weitere Bibliotheken:
apt search cl-listet die Lisp-Bibliotheken von Ubuntu. Eingetragen werden sie in der.asd-Datei unter:depends-on. - Makros: Mit
defmacroschreibt man eigene Sprachmittel, etwa eine eigene Schleifenform. Das ist die bekannteste Besonderheit von Lisp. - Dokumentation: Das Nachschlagewerk zum Sprachstandard heißt HyperSpec, ein freies Lehrbuch ist „Practical Common Lisp“. Eine Übersicht bietet https://lisp-lang.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/lisp-uebung ~/common-lisp/umsatz
Ist ~/common-lisp danach leer, entfernt rmdir auch diesen Ordner. Liegen dort noch andere Projekte, meldet der Befehl nur, dass der Ordner nicht leer ist.
rmdir ~/common-lisp
2. Zwischenspeicher von ASDF entfernen
ASDF legt übersetzte Dateien in ~/.cache/common-lisp ab.
rm -rf ~/.cache/common-lisp
3. SBCL und Bibliotheken entfernen
sudo apt purge sbcl cl-ppcre cl-yason cl-alexandria
4. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl sbcl wird nicht mehr gefunden.
sbcl --version
Quellen und Lizenz
- Offizielle Dokumentation: http://www.sbcl.org/manual/
- Lizenz: SBCL steht unter der Public Domain / BSD-Stil.
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.
Racket
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Racket ist eine Programmiersprache aus der Familie von Lisp und Scheme. Sie ist bekannt für ihren Einsatz in der Lehre, etwa mit dem Buch „How to Design Programs“, und dafür, dass man mit ihr leicht eigene kleine Sprachen baut. Jede Racket-Datei beginnt deshalb mit einer Zeile #lang, die sagt, in welcher Sprache sie geschrieben ist. Racket bringt eine umfangreiche Standardbibliothek mit, unter anderem für JSON, Webserver und Tests.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Racket 8.18. Die Pakete sind groß, installiert rund 440 MB.
- Ohne grafische Oberfläche: Racket empfiehlt GTK-Bibliotheken für die Entwicklungsumgebung DrRacket und für Grafik, außerdem die Dokumentation. Diese Anleitung arbeitet im Terminal und installiert mit
--no-install-recommends, das sind 2 statt 9 Pakete. DrRacket startet dann nicht. - Befehle:
racketführt Programme aus und startet die Konsole.racoist das Werkzeug für alles andere: Tests (raco test), eigenständige Programme (raco exe) und Pakete (raco pkg). - Version: Getestet mit Racket 8.18 (Chez-Scheme-Fassung „cs“) aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Racket installieren
sudo apt install --no-install-recommends racket
Prüfen: Die Ausgabe lautet Welcome to Racket v8.18 [cs].
racket --version
Erste Schritte
3. Konsole starten
Die Eingabezeile ist ein >.
racket
4. Etwas ausprobieren
Gib nacheinander ein und drücke jeweils Enter:
(+ 1 2 3)
(map (lambda (x) (* x x)) (list 1 2 3 4))
Prüfen: Die Antworten lauten 6 und '(1 4 9 16). Das Hochkomma zeigt, dass das Ergebnis eine Liste ist. Beende die Konsole mit Strg+D.
Ein einzelnes Programm
5. Übungsordner anlegen
mkdir ~/racket-uebung
6. In den Ordner wechseln
cd ~/racket-uebung
7. Quelltext anlegen
nano lager.rkt
Füge diesen Inhalt ein (Strg+Umschalt+V):
#lang racket
(struct fahrrad (modell preis anzahl))
(define bestand
(list (fahrrad "Citybike" 699 4)
(fahrrad "Trekkingrad" 899 0)
(fahrrad "Lastenrad" 3490 1)))
(define (status rad)
(if (> (fahrrad-anzahl rad) 0)
(format "~a auf Lager" (fahrrad-anzahl rad))
"ausverkauft"))
(for ([rad bestand] [nummer (in-naturals 1)])
(printf "~a. ~a ~a Euro, ~a\n"
nummer
(~a (fahrrad-modell rad) #:min-width 12)
(~a (fahrrad-preis rad) #:min-width 5 #:align 'right)
(status rad)))
(define lieferbar
(map fahrrad-modell (filter (λ (rad) (> (fahrrad-anzahl rad) 0)) bestand)))
(printf "Sofort lieferbar: ~a\n" (string-join lieferbar ", "))
(printf "Lagerwert: ~a Euro\n"
(for/sum ([rad bestand]) (* (fahrrad-preis rad) (fahrrad-anzahl rad))))
#lang racket– die Datei ist in der vollen Sprache Racket geschrieben.struct– legt einen Datentyp mit Feldern an. Racket erzeugt dazu von selbst den Konstruktorfahrradund Zugriffsfunktionen wiefahrrad-preis.define– legt einen Wert oder eine Funktion an.(define (status rad) …)ist eine Funktion mit dem Parameterrad.formit zwei Folgen – geht Bestand undin-naturals 1(1, 2, 3, …) gleichzeitig durch.~a– wandelt einen Wert in Text um.#:min-widthund#:alignsind benannte Argumente zum Auffüllen.λ– eine namenlose Funktion, gleichbedeutend mitlambda.for/sum– eine Schleife, die die Ergebnisse gleich addiert.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
8. Programm ausführen
racket lager.rkt
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
Module, Tests und ein eigenständiges Programm
9. Projektordner anlegen
mkdir ~/umsatz-rkt
10. In den Projektordner wechseln
cd ~/umsatz-rkt
11. Modul mit Tests anlegen
Jede Racket-Datei ist ein Modul. Die Tests stehen in einem Untermodul in derselben Datei.
nano umsatz.rkt
Füge diesen Inhalt ein:
#lang racket
(provide summen)
;; Zählt den Umsatz je Modell zusammen.
;; Jede Zeile hat die Form "Modell;Anzahl;Preis".
(define (summen zeilen)
(for/fold ([tabelle (hash)])
([zeile zeilen])
(match-define (list modell anzahl preis) (string-split zeile ";"))
(hash-update tabelle modell
(λ (alt) (+ alt (* (string->number anzahl) (string->number preis))))
0)))
(module+ test
(require rackunit)
(define s (summen '("A;2;10" "B;1;50" "A;1;10")))
(check-equal? (hash-ref s "A") 30)
(check-equal? (hash-ref s "B") 50)
(check-equal? (hash-count s) 2))
provide– machtsummenfür andere Dateien sichtbar.for/fold– eine Schleife, die einen Wert mitführt, hier die Tabelle. Sie beginnt mit der leeren Tabelle(hash)und liefert am Ende die gefüllte.- Unveränderliche Tabelle –
hash-updateverändert die Tabelle nicht, sondern liefert eine neue mit dem erhöhten Eintrag. Fehlt der Eintrag, beginnt er bei 0. match-define– zerlegt die Liste ausstring-splitin drei Namen.module+ test– ein Untermodul nur für Tests. Es wird ausgeführt, wenn manraco testaufruft, nicht beim normalen Laden.check-equal?ausrackunitvergleicht zwei Werte.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Tests ausführen
raco test umsatz.rkt
Prüfen: Die Ausgabe endet mit 3 tests passed.
13. Hauptprogramm anlegen
nano main.rkt
Füge diesen Inhalt ein:
#lang racket
(require json "umsatz.rkt")
(module+ main
(define datei
(command-line #:args (datei) datei))
(define tabelle (summen (file->lines datei)))
(for ([eintrag (sort (hash->list tabelle) > #:key cdr)])
(printf "~a ~a Euro\n"
(~a (car eintrag) #:min-width 12)
(~a (cdr eintrag) #:min-width 5 #:align 'right)))
(with-output-to-file "umsatz.json" #:exists 'replace
(λ () (write-json (for/hasheq ([(modell betrag) tabelle])
(values (string->symbol modell) betrag)))))
(displayln "Gespeichert: umsatz.json"))
require– lädt die JSON-Bibliothek und das eigene Modul.module+ main– dieser Teil läuft nur, wenn die Datei als Programm gestartet wird.command-line– wertet die Argumente aus. Fehlt der Dateiname, meldet Racket das selbst.file->lines– liest eine Datei als Liste von Zeilen.write-json– erwartet Schlüssel als Symbole.string->symbolwandelt die Modellnamen deshalb um.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
15. Programm starten
racket main.rkt verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}. Ohne Dateiname meldet das Programm expects 1 <datei> on the command line, given 0 arguments.
16. Eigenständiges Programm erzeugen
raco exe übersetzt das Programm samt Modulen in eine einzige Datei umsatz, rund 13 MB groß. Sie verwendet die installierte Racket-Laufzeit.
raco exe -o umsatz main.rkt
Prüfen: Die Ausgabe gleicht der aus Schritt 15.
./umsatz verkauf.csv
17. Für andere Rechner zusammenpacken (optional)
raco distribute legt den Ordner paket an, der zusätzlich die Racket-Laufzeit enthält, zusammen rund 58 MB. Den ganzen Ordner kann man auf einen Rechner ohne Racket kopieren und dort paket/bin/umsatz starten.
raco distribute paket umsatz
Wie geht es weiter?
- Entwicklungsumgebung: Mit
sudo apt install racketsamt Empfehlungen kommen GTK und die Dokumentation dazu. Dann startetdrracketdie grafische Entwicklungsumgebung mit Editor, Konsole und Schritt-für-Schritt-Ausführung. - Lehrsprachen:
#lang htdp/bslund weitere Lehrsprachen gehören zum Buch „How to Design Programs“, das unter https://htdp.org frei lesbar ist. - Pakete:
raco pkg install NAMElädt Pakete aus dem Verzeichnis https://pkgs.racket-lang.org. - Eigene Sprachen: Mit Makros (
define-syntax) und#langlassen sich eigene Sprachen bauen. Das Buch „Beautiful Racket“ zeigt das an Beispielen. - Dokumentation: Leitfaden und Referenz unter https://docs.racket-lang.org.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/racket-uebung ~/umsatz-rkt
2. Racket entfernen
sudo apt purge racket racket-common
3. Nicht mehr benötigte Abhängigkeiten entfernen
apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
4. Einstellungen entfernen (optional)
Racket kann Einstellungen und mit raco pkg installierte Pakete in diesem Ordner ablegen.
rm -rf ~/.local/share/racket
Prüfen: Der Befehl racket wird nicht mehr gefunden.
racket --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.racket-lang.org/
- Lizenz: Racket steht unter der MIT / Apache-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.
Impressum
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Angaben gemäß § 5 DDG (Digitale-Dienste-Gesetz)
- Thorsten Klöhn
- Gerhardstraße 2
- 22926 Ahrensburg
Vertreten durch:
Thorsten Klöhn
Kontakt:
- Telefon: 04102-2 17 40 07
- E-Mail: thorstenkloehn@gmail.com
Haftungsausschluss:
Haftung für Inhalte
Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte können wir jedoch keine Gewähr übernehmen. Als Diensteanbieter sind wir gemäß § 7 Abs. 1 DDG für eigene Inhalte auf diesen Seiten nach den allgemeinen Gesetzen verantwortlich. Nach §§ 8 bis 10 DDG sind wir als Diensteanbieter jedoch nicht verpflichtet, übermittelte oder gespeicherte fremde Informationen zu überwachen oder nach Umständen zu forschen, die auf eine rechtswidrige Tätigkeit hinweisen. Verpflichtungen zur Entfernung oder Sperrung der Nutzung von Informationen nach den allgemeinen Gesetzen bleiben hiervon unberührt. Eine diesbezügliche Haftung ist jedoch erst ab dem Zeitpunkt der Kenntnis einer konkreten Rechtsverletzung möglich. Bei Bekanntwerden von entsprechenden Rechtsverletzungen werden wir diese Inhalte umgehend entfernen.
Haftung für Links
Unser Angebot enthält Links zu externen Webseiten Dritter, auf deren Inhalte wir keinen Einfluss haben. Deshalb können wir für diese fremden Inhalte auch keine Gewähr übernehmen. Für die Inhalte der verlinkten Seiten ist stets der jeweilige Anbieter oder Betreiber der Seiten verantwortlich. Die verlinkten Seiten wurden zum Zeitpunkt der Verlinkung auf mögliche Rechtsverstöße überprüft. Rechtswidrige Inhalte waren zum Zeitpunkt der Verlinkung nicht erkennbar. Eine permanente inhaltliche Kontrolle der verlinkten Seiten ist jedoch ohne konkrete Anhaltspunkte einer Rechtsverletzung nicht zumutbar. Bei Bekanntwerden von Rechtsverletzungen werden wir derartige Links umgehend entfernen.
Urheberrecht und Lizenzierung
Die durch den Betreiber erstellten didaktischen Inhalte, Texte und Projektvorschläge auf diesen Seiten sind lizenziert unter einer Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0).
Ausgenommen von dieser freien Lizenz sind die rechtlichen Pflichtangaben (Impressum, Datenschutzerklärung) sowie etwaige geschützte Marken, Namen oder Komponenten Dritter.
Soweit die Inhalte auf dieser Seite nicht vom Betreiber erstellt wurden, werden die Urheberrechte Dritter beachtet. Insbesondere werden Inhalte Dritter als solche gekennzeichnet. Sollten Sie trotzdem auf eine Urheberrechtsverletzung aufmerksam werden, bitten wir um einen entsprechenden Hinweis. Bei Bekanntwerden von Rechtsverletzungen werden wir derartige Inhalte umgehend entfernen.
Datenschutz
Ausführliche Informationen zur Erhebung und zum Schutz personenbezogener Daten finden Sie in unserer separaten Datenschutzerklärung.
Der Nutzung von im Rahmen der Impressumspflicht veröffentlichten Kontaktdaten durch Dritte zur Übersendung von nicht ausdrücklich angeforderter Werbung und Informationsmaterialien wird hiermit ausdrücklich widersprochen. Die Betreiber der Seiten behalten sich ausdrücklich rechtliche Schritte im Falle der unverlangten Zusendung von Werbeinformationen, etwa durch Spam-Mails, vor.
Quelle für die Abschnitte „Haftung für Inhalte“, „Haftung für Links“, den Hinweis auf Urheberrechte Dritter und den Widerspruch gegen Werbung: e-recht24.de
Stand: September 2026
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.
Datenschutz
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Verantwortliche Stelle im Sinne der Datenschutzgesetze, insbesondere der EU-Datenschutzgrundverordnung (DSGVO), ist:
- Thorsten Klöhn
- Gerhardstraße 2
- 22926 Ahrensburg
- Telefon: 04102-2 17 40 07
- e-Mail: thorstenkloehn@gmail.com
Ihre Betroffenenrechte
Unter den oben angegebenen Kontaktdaten der verantwortlichen Stelle können Sie jederzeit folgende Rechte ausüben:
- Auskunft über Ihre bei uns gespeicherten Daten und deren Verarbeitung (Art. 15 DSGVO),
- Berichtigung unrichtiger personenbezogener Daten (Art. 16 DSGVO),
- Löschung Ihrer bei uns gespeicherten Daten (Art. 17 DSGVO),
- Einschränkung der Datenverarbeitung, sofern wir Ihre Daten aufgrund gesetzlicher Pflichten noch nicht löschen dürfen (Art. 18 DSGVO),
- Widerspruch gegen die Verarbeitung Ihrer Daten bei uns (Art. 21 DSGVO) und
- Datenübertragbarkeit, sofern Sie in die Datenverarbeitung eingewilligt haben oder einen Vertrag mit uns abgeschlossen haben (Art. 20 DSGVO).
Sofern Sie uns eine Einwilligung erteilt haben, können Sie diese jederzeit mit Wirkung für die Zukunft widerrufen.
Sie können sich jederzeit mit einer Beschwerde an eine Aufsichtsbehörde wenden, z. B. an die zuständige Aufsichtsbehörde des Bundeslands Ihres Wohnsitzes oder an die für uns als verantwortliche Stelle zuständige Behörde. Für uns ist das Unabhängige Landeszentrum für Datenschutz Schleswig-Holstein (ULD) zuständig.
Eine Liste der Aufsichtsbehörden (für den nichtöffentlichen Bereich) mit Anschrift finden Sie unter: https://www.bfdi.bund.de/DE/Infothek/Anschriften_Links/anschriften_links-node.html.
Hosting bei GitHub Pages
Diese Website wird bei GitHub Pages gehostet. Anbieter ist die GitHub Inc., 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107, USA (nachfolgend „GitHub“); für Nutzer aus der EU/EWR ist GitHub B.V., Prins Bernhardplein 200, 1097 JB Amsterdam, Niederlande, verantwortlich.
Beim Besuch dieser Website erfasst GitHub automatisch Informationen in sogenannten Server-Logfiles, die Ihr Browser übermittelt, u. a. IP-Adresse, Datum und Uhrzeit der Anfrage, Browsertyp und Betriebssystem. Nach eigenen Angaben speichert GitHub die IP-Adresse der Besucher von GitHub-Pages-Seiten zu Sicherheitszwecken. Wir selbst erhalten keinen Zugriff auf diese Logdaten und werten sie nicht aus.
Rechtsgrundlage ist Art. 6 Abs. 1 lit. f DSGVO. Unser berechtigtes Interesse liegt in der sicheren und zuverlässigen Bereitstellung dieses Angebots.
Die Verarbeitung durch GitHub kann auch in den USA erfolgen. GitHub hat sich dem EU-U.S. Data Privacy Framework (DPF) unterworfen, für das die Europäische Kommission am 10. Juli 2023 einen Angemessenheitsbeschluss erlassen hat. Weitere Informationen zum Datenschutz bei GitHub finden Sie unter: https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement.
Diese Seite wird über die eigene Domain installieren.wissen-ahrensburg.de bereitgestellt. Alle Dateien der Website, auch Schriften, Skripte und der Suchindex, werden von GitHub Pages ausgeliefert. Es findet keine Einbindung von Drittanbieter-CDNs, Google Fonts, Analyse- oder Tracking-Diensten statt.
Cookies und Speicherung im Browser
Diese Website setzt keine Cookies. Wenn Sie das Farbschema ändern oder die Seitenleiste ein- oder ausblenden, speichert Ihr Browser diese Einstellung lokal (Local Storage), damit sie beim nächsten Seitenaufruf erhalten bleibt. Diese Angaben verlassen Ihren Rechner nicht und werden nicht an uns oder Dritte übertragen. Die Speicherung ist für die von Ihnen gewünschte Funktion unbedingt erforderlich (§ 25 Abs. 2 Nr. 2 TDDDG). Sie können die gespeicherten Einstellungen jederzeit über die Einstellungen Ihres Browsers löschen.
Kontakt per E-Mail
Wenn Sie uns eine E-Mail schreiben, verwenden wir Ihre Angaben (z. B. E-Mail-Adresse, Name und Inhalt der Nachricht) ausschließlich, um Ihre Anfrage zu beantworten. Rechtsgrundlage ist Art. 6 Abs. 1 lit. f DSGVO; unser berechtigtes Interesse liegt in der Beantwortung Ihrer Anfrage. Die Daten werden gelöscht, sobald sie dafür nicht mehr erforderlich sind und keine gesetzlichen Aufbewahrungspflichten entgegenstehen.
Änderung unserer Datenschutzbestimmungen
Wir behalten uns vor, diese Datenschutzerklärung anzupassen, damit sie stets den aktuellen rechtlichen Anforderungen entspricht oder um Änderungen unserer Leistungen in der Datenschutzerklärung umzusetzen, z.B. bei der Einführung neuer Services. Für Ihren erneuten Besuch gilt dann die neue Datenschutzerklärung.
Fragen zum Datenschutz
Wenn Sie Fragen zum Datenschutz haben, schreiben Sie uns bitte eine E-Mail oder wenden Sie sich direkt an die oben genannte verantwortliche Person:
- E-Mail: thorstenkloehn@gmail.com
Die Datenschutzerklärung wurde in Teilen erstellt mit dem Muster der activeMind AG (Experten für Datenschutz und Informationssicherheit).
Stand: September 2026
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.