Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
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.