Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Bereitstellung mit Docker Compose
So betreibst du my mit Docker Compose auf einer Maschine: das kleinste Setup, ein Serverprozess auf SQLite mit den
Mediendateien in einem benannten Volume. PostgreSQL, Objektspeicher und TLS kommen später als weitere Dateien obendrauf
(Docker-Compose-Dateien).
Du brauchst Docker und Docker Compose v2.
Den Server starten
Abschnitt betitelt „Den Server starten“Die Compose-Dateien liegen im Quellcode unter deploy/docker. Nimm sie aus dem Tag
des Releases, das du betreibst, damit sie zu seinem Image passen:
git clone --depth 1 --branch v0.1.0 https://github.com/mycroblog/my.gitcd my/deploy/dockercp example.env .env# Set MY_VERSION in .env to the same version, such as 0.1.0mkdir -m 700 secrets(umask 022; openssl rand -base64 32 > secrets/kek) # the key encryption key: back it up apart from the databasedocker compose up -d- Compose lädt das Image
ghcr.io/mycroblog/myin der VersionMY_VERSION. Es gibt keinen Taglatest, die Version muss also genannt werden: Ein Release kann Schritte erfordern, die ein stilles Update überspringen würde (die Tags des Images). Um das Image stattdessen aus dem Checkout zu bauen, füge die Override-Datei hinzu:docker compose -f compose.yaml -f compose.build.yaml up -d --build. - Der Dienst
schemaführtmy schema applydes Server-Images aus, das die Datenbank in einem benannten Volume auf das Schema dieses Releases bringt, und beendet sich; der Server (role=all) startet, sobald das gelungen ist. Das Schema wird bei jedemuperneut angewendet, nach einem Upgrade startest du den Server also auf dieselbe Weise. - Der Server lauscht auf
127.0.0.1:8080(der Port istMY_HTTP_PORTin.env). Er ist bereit, wenncurl localhost:8080/readyz{"status":"ok"}zurückgibt. - Der Key Encryption Key (KEK) erreicht den Server aus
secrets/kekals Docker-Secret/run/secrets/my_kek, nie als Umgebungsvariable (den Key Encryption Key verwalten). - Jede andere Einstellung der Konfigurationsreferenz setzt du in
.env, deren Vorlage sie beschreibt.
Einen Administrator anlegen
Abschnitt betitelt „Einen Administrator anlegen“Lege einen Administrator an und suche das Konto dann mit WebFinger heraus und rufe seinen Actor ab. Das Passwort wird aus der ersten Zeile der Standardeingabe gelesen.
docker compose exec -T my my admin create -username alice -email alice@example.com < password.txtcurl 'http://localhost:8080/.well-known/webfinger?resource=acct:alice@localhost:8080'curl -H 'Accept: application/activity+json' http://localhost:8080/ap/actors/<the UUID of the self link from WebFinger>Im Browser anmelden
Abschnitt betitelt „Im Browser anmelden“Mit dem Paar MY_HOST=localhost:8080 und MY_WEB_ORIGIN=http://localhost:8080 aus example.env funktionieren
Anmeldung, Client-API und Medien über einfaches HTTP unter http://localhost:8080 (ActivityPub-IDs bleiben
https://localhost:8080/...). Wenn du MY_HTTP_PORT änderst, ändere den Port von MY_HOST und MY_WEB_ORIGIN
entsprechend.
- Öffne
http://localhost:8080/loginin einem Browser (oder drücke Anmelden in der oberen Leiste des Web-Clients); das öffnet den Anmeldebildschirm des Servers. - Gib auf dem Anmeldebildschirm die E-Mail-Adresse und das Passwort des Administrators ein, den du oben angelegt hast.
- Du bist zurück im Web-Client, in deiner Home-Timeline.
- Das Anmelde-Cookie ist
Secure. Chrome und Firefox akzeptieren es aufhttp://localhost; Safari (WebKit) nicht, nutze lokal also Chrome oder Firefox. - Links von Hashtags und Erwähnungen in Beitragstexten verwenden
https://, da es die föderierten URLs sind.
Öffentlich gehen
Abschnitt betitelt „Öffentlich gehen“- Setze
MY_HOSTin.envauf deine echte Domain, entferneMY_WEB_ORIGIN(es ist standardmäßighttps://{MY_HOST}) und beende TLS vor dem Server: Die Ebenecompose.caddy.yamlstartet dafür Caddy (Docker-Compose-Dateien), oder lass den Server HTTPS selbst ausliefern (HTTPS vom Server ausliefern).MY_HOSTwird beim ersten Start in der Datenbank gespeichert und lässt sich später nicht mehr ändern. - Setze hinter einem eigenen Reverse-Proxy
MY_TRUSTED_PROXIESin.env, damit Ratenbegrenzungen wie die bei der Anmeldung pro Client-IP gelten statt für den Proxy (trusted_proxies). - Gehe die Checkliste für den Produktivbetrieb durch, bevor du den Server für Nutzer öffnest.
docker compose downstoppt den Stack.down -vlöscht außerdem die Daten-Volumes.
Alle Einstellungen findest du in der Konfigurationsreferenz; zum alltäglichen Betrieb siehe Den Server betreiben.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt