Cette page est une traduction automatique de la page en anglais, qui fait foi. Lire la page en anglais
Déployer avec Docker Compose
Comment faire tourner my sur une seule machine avec Docker Compose : la configuration la plus petite, un processus serveur sur SQLite avec les fichiers médias dans un volume nommé. PostgreSQL, le stockage objet et TLS sont des fichiers à superposer plus tard (fichiers Docker Compose).
Vous avez besoin de Docker et de Docker Compose v2.
Démarrer le serveur
Section intitulée « Démarrer le serveur »Les fichiers Compose se trouvent dans deploy/docker des sources. Prenez-les sur le tag de la version que vous exécutez, afin qu’ils correspondent à son image :
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 récupère l’image
ghcr.io/mycroblog/mydeMY_VERSION. Il n’existe pas de taglatest, la version doit donc être nommée : une version peut nécessiter des étapes qu’une mise à jour silencieuse ignorerait (les tags de l’image). Pour construire plutôt l’image à partir du checkout, ajoutez la surcharge :docker compose -f compose.yaml -f compose.build.yaml up -d --build. - Le service
schemaexécutemy schema applyde l’image du serveur, qui amène la base de données d’un volume nommé au schéma de cette version, puis se termine ; le serveur (role=all) démarre une fois qu’il a réussi. Le schéma est appliqué de nouveau à chaqueup: après une mise à jour, vous démarrez donc le serveur de la même façon. - Le serveur écoute sur
127.0.0.1:8080(le port estMY_HTTP_PORTdans.env). Il est prêt quandcurl localhost:8080/readyzrenvoie{"status":"ok"}. - La clé de chiffrement de clés (KEK) parvient au serveur depuis
secrets/kekcomme secret Docker/run/secrets/my_kek, jamais comme variable d’environnement (gérer la clé de chiffrement de clés). - Tous les autres paramètres de la référence de la configuration se définissent dans
.env, dont le modèle les décrit.
Créer un administrateur
Section intitulée « Créer un administrateur »Créez un administrateur, puis recherchez le compte avec WebFinger et récupérez son acteur. Le mot de passe est lu sur la première ligne de l’entrée standard.
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>Se connecter depuis un navigateur
Section intitulée « Se connecter depuis un navigateur »Avec le couple MY_HOST=localhost:8080 et MY_WEB_ORIGIN=http://localhost:8080 de example.env, la connexion, l’API client et les médias fonctionnent en HTTP simple sur http://localhost:8080 (les identifiants ActivityPub restent https://localhost:8080/...). Si vous changez MY_HTTP_PORT, changez le port de MY_HOST et de MY_WEB_ORIGIN en conséquence.
- Ouvrez
http://localhost:8080/logindans un navigateur (ou appuyez sur Se connecter dans la barre supérieure du client web) ; cela ouvre l’écran de connexion du serveur. - Sur l’écran de connexion, saisissez l’adresse e-mail et le mot de passe de l’administrateur que vous venez de créer.
- Vous revenez dans le client web, sur votre fil d’accueil.
- Le cookie de connexion est
Secure. Chrome et Firefox l’acceptent surhttp://localhost; Safari (WebKit) ne le fait pas, utilisez donc Chrome ou Firefox en local. - Les liens des hashtags et des mentions dans le corps des publications utilisent
https://, puisque ce sont les URL fédérées.
Passer en public
Section intitulée « Passer en public »- Définissez
MY_HOSTdans.envsur votre vrai domaine, supprimezMY_WEB_ORIGIN(il vaut par défauthttps://{MY_HOST}), et terminez le TLS devant le serveur : la couchecompose.caddy.yamlexécute Caddy pour cela (Fichiers Docker Compose), ou laissez le serveur servir lui-même le HTTPS (servir le HTTPS depuis le serveur).MY_HOSTest stocké dans la base de données au premier démarrage et ne peut pas être modifié par la suite. - Derrière un proxy inverse à vous, définissez
MY_TRUSTED_PROXIESdans.envafin que les limites de débit, comme celle de la connexion, s’appliquent par IP de client plutôt qu’au proxy (trusted_proxies). - Avant d’ouvrir le serveur aux utilisateurs, parcourez la liste de contrôle de production.
docker compose downarrête la pile.down -vsupprime aussi les volumes de données.
Pour tous les paramètres, voir la référence de la configuration ; pour l’exploitation au quotidien, voir exécuter le serveur.
Pour les LLM et les agents de programmation :llms.txt,llms-full.txt, llms-small.txt