Aller au contenu

Cette page est une traduction automatique de la page en anglais, qui fait foi. Lire la page en anglais

La page en anglais a changé depuis la traduction de ces sections :

Paramètres de l’instance

Les paramètres qui définissent la façon dont votre instance est exploitée : mode d’inscription, longueur des publications, langue par défaut, qui peut voir les fils, nom de l’instance, description, conditions, règles, thème et émojis personnalisés.

Configuration Paramètres de l’instance
Quoi Comment le déploiement est construit : rôles, adaptateurs, points de terminaison, noms d’hôte, secrets Comment l’instance est exploitée : mode d’inscription, limite de longueur des publications, langue par défaut, qui peut voir les fils, nom de l’instance, description et conditions
Où Variables d’environnement MY_* et fichier de configuration (référence de configuration) La base de données. Chaque modification est conservée comme une révision
Modification Prend effet au redémarrage du processus Prend effet immédiatement avec my instance set, les écrans d’administration du client web ou l’API client (écrans d’administration et API client)
Si non défini La valeur par défaut du schéma (le serveur ne démarre pas si la clé est obligatoire) La valeur par défaut définie dans le code
  • Aucune clé n’est dans les deux. Aucune ne remplace l’autre. Vous ne pouvez pas donner un paramètre d’instance par une variable d’environnement ou le fichier de configuration, et vous ne pouvez pas stocker une valeur de configuration dans la base de données.
  • Une valeur fixée par déploiement et qui change la structure du processus relève de la configuration ; une valeur qui change pendant que l’instance fonctionne est un paramètre d’instance.
Clé Type Par défaut Description
registration_mode open / approval / invite / closed approval Le mode d’inscription (inscription). Tant qu’un arrêt du service est annoncé et après sa fermeture, et sur un serveur d’une seule personne, la valeur effective est closed. La valeur stockée ne change pas, et annuler l’annonce ou désactiver single_user la rétablit. GET /instance et NodeInfo affichent la valeur effective
max_status_length entier 1-100000 500 La longueur maximale d’une publication, en caractères
default_locale balise de langue BCP 47 en La locale par défaut. C’est la locale initiale de l’interface des nouveaux utilisateurs, et la valeur de repli lorsqu’aucun catalogue ne correspond à la préférence d’un utilisateur
local_timeline_visibility off / signed_in / everyone everyone Qui peut voir le fil local (GET /api/v1/timelines/local) : personne, les utilisateurs connectés, ou tout le monde. off répond 404 et signed_in répond 401 aux visiteurs non connectés ; dans les deux cas la navigation le masque. Sauf si la valeur est everyone, la page d’accueil n’affiche aucun exemple de publication. Sur un serveur d’une seule personne, il se lit comme off
federated_timeline_visibility off / signed_in / everyone signed_in Qui peut voir le fil fédéré (GET /api/v1/timelines/federated). Les valeurs signifient la même chose que pour le fil local, et il se lit aussi comme off sur un serveur d’une seule personne
preview_image ID de média (vide = non défini) vide L’image d’aperçu de lien (og:image) pour les pages sans image propre, sous « Aperçus de liens » dans Paramètres → Général. Lorsqu’elle n’est pas définie, la miniature, puis le logo, puis l’image fournie sont utilisés (aperçus de liens)
contact_account nom d’utilisateur d’un compte local (vide = non défini) vide Le compte pour contacter les opérateurs. Voir contact et miniature
contact_email adresse e-mail (vide = non définie) vide L’adresse e-mail pour contacter les opérateurs. C’est aussi le Reply-To et la signature des e-mails que le serveur envoie
thumbnail ID de média (vide = non défini) vide Une image qui représente l’instance (miniature), sur les pages À propos et d’accueil, et dans les aperçus de liens lorsque preview_image n’est pas défini
remote_media_policy none / avatars / all none S’il faut conserver des copies des médias distants. none : le proxy de médias relaie chaque requête. avatars : les avatars, les en-têtes et les émojis personnalisés sont mis en cache dans le stockage de blobs pendant remote_media_cache_ttl_seconds. all : tous les médias distants le sont. La taille totale du cache est limitée par la configuration remote_media_cache_max_bytes
remote_media_cache_ttl_seconds entier 60-31536000 (secondes) 86400 Combien de temps les médias distants récupérés peuvent être conservés. C’est aussi le Cache-Control: max-age des réponses du proxy de médias, de sorte que les CDN et les navigateurs mettent en cache pendant ce temps
remote_media_cache_max_bytes entier à partir de 1 (octets) 1073741824 La limite de taille des copies de médias distants que le proxy de médias conserve. Le nettoyage horaire supprime les copies expirées, puis les moins récemment consultées au-delà de cette limite
authorized_fetch true / false false Authorized Fetch (mode sécurisé). Lorsque true, un GET ActivityPub sans signature HTTP vérifiable reçoit 401 pour les objets et les collections, et un document minimal qui porte la clé pour l’acteur d’un utilisateur. L’acteur de l’instance renvoie toujours son document entier, afin que tout serveur puisse récupérer la clé pour vérifier une signature
federation_mode off / inbound / outbound / both both Le sens de la fédération. off : aucune fédération. inbound : vous suivez et lisez des comptes distants, mais les publications, profils et réactions locaux ne sont pas envoyés, et les abonnements venant de l’extérieur sont refusés (Reject). outbound : vous acceptez les abonnements venant de l’extérieur et livrez les publications locales, mais les publications et réactions distantes ne sont pas reçues. both : envoyer et recevoir. Un changement prend effet aussitôt et exige la permission manage_settings
federation_scope open / allowlist open Avec quels serveurs ce serveur fédère. open : tout serveur qu’aucune action de domaine ne suspend. allowlist : uniquement les domaines de la liste d’autorisation et leurs sous-domaines ; tout autre serveur est traité comme suspendu, et les GET ActivityPub exigent une signature d’un serveur autorisé quoi que dise authorized_fetch. Passer à allowlist met fin définitivement aux abonnements avec les serveurs qu’il coupe ; voir fédérer uniquement avec des serveurs autorisés. Un changement prend effet aussitôt et exige la permission manage_settings
dynamic_client_registration true / false true Enregistrement dynamique de clients (RFC 7591). Tant que true, POST /oauth/register accepte l’enregistrement de clients publics sans authentification. Lorsque false, le point de terminaison refuse chaque requête avec 403 (access_denied) ; les clients déjà enregistrés continuent de fonctionner. Un job périodique supprime les clients enregistrés dynamiquement qui ne sont pas utilisés, selon la configuration dynamic_client_unredeemed_retention et dynamic_client_idle_retention. Un changement prend effet aussitôt et exige manage_settings
domain_actions_visibility off / signed_in / everyone off Qui peut voir la liste des domaines visés par des actions (GET /api/v1/instance/domain_actions) : personne, les utilisateurs connectés, ou tout le monde (modération)
domain_actions_rationale_visibility off / signed_in / everyone off Qui peut voir les commentaires publics de cette liste. Une personne qui ne peut pas voir la liste ne les voit jamais
appeal_window_days entier 20-365 (jours) 180 Combien de jours après une mesure la personne concernée peut contester (modération). Le changer change aussi la date limite des mesures déjà prises
session_origins_retention_days entier 90-3650 (jours) 180 Combien de jours après une connexion conserver l’adresse IP et le User-Agent de la connexion (modération)
registration_origins_retention_days entier 90-3650 (jours) 180 Combien de jours après l’inscription conserver l’adresse IP de l’inscription
reports_retention_days entier 180-3650 (jours) 365 Combien de jours après la dernière résolution conserver un signalement. Un signalement auquel renvoie une mesure est conservé aussi longtemps que la mesure
moderation_actions_retention_days entier 180-3650 (jours) 365 Combien de jours après la fin d’une mesure (la levée, l’expiration, ou l’examen d’une contestation, le plus tardif des trois) conserver les mesures contre les comptes et les contestations
audit_log_retention_days entier 365-3650 (jours) 730 Combien de jours après son enregistrement conserver une ligne du journal d’audit
remote_status_retention_days entier 1-3650 (jours) 90 Combien de jours une publication distante est conservée après sa publication lorsque rien sur cette instance n’y renvoie (une réponse locale, un boost, un favori, un marque-page, une notification, ou une discussion avec une publication locale)
remote_status_max_retention_days entier 0-3650 (jours) 0 Le plus grand nombre de jours qu’une publication distante est conservée après sa publication, même lorsque cette instance y renvoie. Les réponses, boosts, favoris et marque-pages locaux restent et l’affichent comme supprimée. 0 ne fixe aucune limite
relay_status_retention_days entier 1-3650 (jours) 7 Combien de jours est conservée une publication distante que seul un relais a apportée, lorsque rien sur cette instance n’y renvoie et qu’aucun compte local ne suit son auteur
oauth_client_rate_limits paires client_id=requests séparées par des virgules vide Plafonds sur les requêtes de l’API cliente des clients OAuth, pour retenir un client qui surcharge le serveur : les requêtes que tous ses utilisateurs ensemble peuvent faire en 5 minutes. Un changement met jusqu’à une minute à s’appliquer
search_indexing allow / deny deny Si les moteurs de recherche peuvent indexer l’instance. Même avec allow, seuls les profils des comptes indexable et les publications public sont indexés (moteurs de recherche et robots d’IA)
ai_usage allow / deny_training / deny deny La déclaration aux services d’IA. deny_training refuse l’entraînement ; deny refuse l’entraînement et l’utilisation par l’IA (recherche par IA, assistants, agents)
indexable_default true / false false La valeur par défaut de indexable pour les nouveaux comptes. La changer ne change pas les comptes existants
auto_delete_default_enabled true / false false Si les nouveaux comptes démarrent avec la suppression automatique de leurs anciennes publications activée. Avec les autres clés auto_delete_default_*, c’est la politique que reçoit un nouveau compte (suppression automatique des anciennes publications)
auto_delete_default_min_age_days entier 1-3650 (jours) 30 Combien de jours après sa publication la politique d’un nouveau compte supprime une publication
auto_delete_default_keep_pinned, auto_delete_default_keep_bookmarked, auto_delete_default_keep_favourited true / false true Si la politique d’un nouveau compte conserve les publications que son auteur a épinglées, mises en marque-page ou en favori
auto_delete_default_keep_media, auto_delete_default_keep_polls true / false false Si la politique d’un nouveau compte conserve les publications avec des médias ou un sondage
auto_delete_default_keep_articles true / false true Si la politique d’un nouveau compte conserve les articles
auto_delete_default_keep_public, auto_delete_default_keep_local, auto_delete_default_keep_unlisted, auto_delete_default_keep_private true / false false Si la politique d’un nouveau compte conserve les publications de cette visibilité
auto_delete_default_keep_direct true / false true Si la politique d’un nouveau compte conserve les publications directes
auto_delete_default_keep_min_boosts, auto_delete_default_keep_min_favourites entier 0-1000000 0 La politique d’un nouveau compte conserve une publication boostée ou mise en favori au moins ce nombre de fois. 0 ne fixe aucun seuil
auto_delete_max_age_days entier 0-3650 (jours) 0 Le plus grand nombre de jours après sa publication qu’une publication locale est conservée (maximum). 0 ne fixe aucun maximum
auto_delete_max_allow_pinned true / false true Si les publications épinglées peuvent encore être conservées sous le maximum
auto_delete_max_kept_pins entier 1-5 5 Combien d’épingles conservent des publications sous le maximum, les plus récemment épinglées d’abord. 5, le plus grand nombre d’épingles d’un compte, conserve toutes les publications épinglées
auto_delete_max_allow_bookmarked, auto_delete_max_allow_favourited, auto_delete_max_allow_media, auto_delete_max_allow_polls true / false false Si les publications que l’auteur a mises en marque-page ou en favori, ou avec des médias ou un sondage, peuvent encore être conservées sous le maximum
auto_delete_max_allow_articles true / false true Si les articles peuvent encore être conservés sous le maximum
auto_delete_max_allow_visibilities true / false false Si les publications peuvent encore être conservées selon leur visibilité sous le maximum
auto_delete_max_allow_thresholds true / false false Si les publications peuvent encore être conservées selon leurs boosts et favoris sous le maximum
auto_delete_grace_days entier 0-365 (jours) 30 Combien de jours un compte auquel le maximum s’applique pour la première fois conserve ses propres paramètres après en avoir été informé. Un changement ne déplace pas les dates des comptes déjà informés
search_visibilities public / local / public,local public Quelles publications couvre la recherche en texte intégral d’un serveur doté d’un backend de recherche. Les publications unlisted, private et direct ne sont jamais couvertes, et seuls les comptes avec indexable le sont. Omettre une visibilité retire ses publications de l’index. En ajouter une ne trouve que ses nouvelles publications, jusqu’à ce que vous reconstruisiez l’index. Cela ne fait rien avec search = none
security_contact URI https: ou mailto: (vide = non défini) vide Où signaler les problèmes de sécurité de ce serveur : sa configuration et son exploitation, ses comptes et ses données. Lorsqu’il est défini, le serveur sert /.well-known/security.txt (RFC 9116). C’est votre contact, pas celui du logiciel : transmettez le signalement d’une vulnérabilité du logiciel lui-même au projet comme le décrit sa politique de sécurité
require_media_description true / false false Si chaque fichier de média (image, vidéo ou audio) joint à une publication locale exige une description. Lorsque true, une publication ou une modification avec un fichier dont la description est absente ou ne contient que des espaces est rejetée avec 422. Il est publié comme limits.require_media_description dans GET /api/v1/instance, et le client web rend le champ de description obligatoire. Il est distinct du paramètre par utilisateur require_media_description, qui ne vérifie qu’avant l’envoi
link_cards true / false true S’il faut afficher des cartes pour les liens dans les publications. Lorsque true, le serveur récupère la page liée pour construire une carte. Lorsque false, il cesse de récupérer et masque aussi les cartes déjà construites. Pour l’arrêter seulement sur certains domaines, voir domaines de cartes de lien
link_cards_ignore_robots_txt true / false false Si les récupérations de cartes de lien ignorent robots.txt. Lorsque false, le serveur obéit au robots.txt des sites liés, si bien qu’un site qui interdit my-linkcard ou * n’obtient aucune carte (aperçus de liens). /about/crawler indique aux sites liés lequel c’est. Lorsque true, le serveur ne récupère ni n’utilise robots.txt, et un site lié ne peut plus refuser ces récupérations avec lui ; le serveur se nomme toujours my-linkcard. N’activez-le que si trop de cartes manquent. Les cartes construites pendant qu’il était activé sont vérifiées à leur prochaine récupération après sa désactivation. Les directives d’une page et les domaines de cartes de lien s’appliquent dans les deux cas
ux_measurement true / false false Si le client web envoie des échantillons de sa rapidité de réponse, et si ce serveur les conserve (mesures d’expérience utilisateur). Les échantillons ne portent aucun compte, aucune adresse ni aucune URL. Lorsque false, le serveur n’en prend aucun, et ux_measurement dans GET /api/v1/instance dit au client de ne pas en envoyer
ux_measurement_share entier 1-100 (pourcentage) 10 La part des sessions de navigateur dont le client web envoie des échantillons tant que ux_measurement vaut true. Chaque session est tirée une fois, au démarrage du client web ; un petit serveur peut mesurer chaque session avec 100
oauth_metadata_document_clients true / false true S’il faut accepter les clients Client ID Metadata Document. Lorsque true, pour une demande d’autorisation dont le client_id est une URL https, le serveur récupère les métadonnées à cette URL et les traite comme le client (sans enregistrement préalable). La récupération ne suit aucune redirection, lit au plus 5 Ko et réutilise la réponse au plus 24 heures selon ses directives de cache. Lorsque false, il cesse de récupérer et refuse les demandes d’autorisation, les échanges de jetons et les actualisations de ces clients
finance_visibility private / totals / breakdown private Quelle part des coûts d’exploitation (enregistrés sur /admin/finance/costs, et définie sur /admin/finance/publication) publier. private : rien n’est publié (GET /api/v1/instance/cost_totals renvoie 404). totals : uniquement le total par période et par devise. breakdown : les totaux et une ventilation par fournisseur et par catégorie, affichés à tout le monde sur les pages d’information (/about et /about/costs) et dans l’API. breakdown révèle chez quel fournisseur (par exemple, quel cloud) vous fonctionnez. À chaque niveau, les noms des éléments, les mémos et les paiements individuels restent privés. Les périodes jusqu’à celle qui contient aujourd’hui (UTC) comprise sont publiées
finance_viewer_item_names true / false false Si les utilisateurs avec la permission view_finance voient les noms des éléments de coût et les noms de services des coûts importés sur l’écran des finances (/finance, GET /api/v1/finance/cost_totals). Les totaux et la ventilation par fournisseur et par catégorie sont toujours affichés, quel que soit ce paramètre
finance_viewer_item_memos true / false false Si les utilisateurs avec view_finance voient les mémos des éléments de coût sur l’écran des finances. Si l’un des paramètres, nom ou mémo, vaut true, chaque période affiche des lignes d’éléments (fournisseur, catégorie et montant de cette période, plus le nom et le mémo lorsqu’ils sont activés). Les personnes avec manage_finance voient tout dans tous les cas
finance_viewer_income totals / plans totals Si les utilisateurs avec view_finance ne voient que les totaux des revenus (totals) ou aussi le nombre d’abonnés par formule (plans). Le montant par formule et qui a payé ne sont jamais affichés. Si income_visibility vaut plans, les nombres publiés sont affichés quelle que soit cette valeur. Les revenus se lisent sur l’écran des finances du client web (/finance) et dans GET /api/v1/finance/income_totals
income_visibility private / totals / plans private Quelle part des revenus des soutiens (le montant après les frais du fournisseur de paiement) publier. Il se choisit séparément de finance_visibility. private : rien n’est publié (GET /api/v1/instance/income_totals renvoie 404). totals : uniquement le total des revenus par période et par devise. plans : aussi le nombre actuel d’abonnés par formule, affiché à tout le monde. Pour une formule avec peu d’abonnés, le nombre peut permettre de deviner qui s’abonne. Le solde (revenus moins coûts) n’est affiché que lorsque ni cette valeur ni finance_visibility n’est private ; sinon le solde révélerait le côté que vous avez masqué. À chaque niveau, les paiements individuels, les abonnés, le montant par formule, ainsi que les montants bruts et les frais restent privés. Les périodes jusqu’à celle qui contient aujourd’hui (UTC) comprise sont publiées
funding_meter_visibility off / percent / amounts off Ce que publie la jauge de financement : jusqu’où les revenus de ce mois (après les frais du fournisseur de paiement) vont vers l’objectif mensuel, affichés sur la page À propos, sur la liste des soutiens (/about/supporters) et dans GET /api/v1/instance (funding_meter). Elle se définit avec l’objectif sur /admin/finance/publication, qui ne propose que les choix que les visibilités actuelles autorisent et en dit la raison. off : rien. percent : uniquement le pourcentage, arrondi à l’inférieur à 1 %, si le mois est couvert, et si des coûts estimés sont dans l’objectif. Il ne peut être choisi que tant que finance_visibility et income_visibility sont tous deux private. amounts : aussi les revenus et l’objectif. Il ne peut être choisi que tant qu’aucun des deux n’est private. Tant qu’un seul des deux est publié, la jauge ne peut pas être affichée : les montants publiés et le pourcentage révéleraient le côté masqué. Changer l’une ou l’autre visibilité de sorte que la valeur choisie ne soit plus autorisée met la jauge sur off, et ce changement est enregistré et audité comme tout autre. Le mois est le mois calendaire contenant aujourd’hui (UTC), et seuls les revenus dans la devise de l’objectif comptent
funding_meter_target_amount décimal supérieur à zéro, ou vide vide L’objectif mensuel de la jauge de financement, dans l’unité principale de funding_meter_target_currency (1650 yens, 12.50 dollars), avec pas plus de décimales que la devise n’en a. Vide : l’objectif est les coûts de ce mois, qui doivent être dans une seule devise ; dans un mois dont les coûts sont dans plusieurs devises, ou sont nuls, la jauge n’est pas affichée
funding_meter_target_currency code ISO 4217, ou vide vide La devise de funding_meter_target_amount, comme JPY. Vide : la devise des coûts de ce mois
funding_meter_rail true / false false Si le client web affiche aussi la jauge de financement dans la colonne de droite de la mise en page large, en plus de la page À propos, tant que funding_meter_visibility n’est pas off
supporter_list_visibility off / signed_in / everyone off Qui peut voir la liste des soutiens (GET /api/v1/instance/supporters et /about/supporters). off : personne (l’API répond 404 et /about n’a aucun lien). signed_in : uniquement les personnes connectées à ce serveur (l’API répond 401 sinon). everyone : tout le monde. La liste n’affiche que les comptes et les formules des abonnés actifs qui ont choisi d’y figurer ; les montants, la facturation mensuelle ou annuelle, les dates et les nombres ne sont jamais affichés. La page de la liste et la réponse de l’API sont toujours noindex, noarchive, quel que soit search_indexing
user_app_registration true / false true Si les utilisateurs connectés peuvent enregistrer leurs propres applications OAuth (publiques ou confidentielles) avec l’API cliente (POST /api/v1/oauth_apps). Lorsque false, l’enregistrement répond 403. Lister, modifier et supprimer les applications enregistrées, réémettre les secrets, émettre un jeton pour soi-même et l’autorisation par d’autres utilisateurs continuent de fonctionner
voice_room_starters everyone / permitted permitted Qui peut ouvrir des salons de chat vocal, tant que la configuration voice n’est pas off (configuration). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission start_voice_rooms, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir
voice_public_summary true / false false Si la page d’un salon de chat vocal dont la visibilité est local affiche son nom, sa description, son hôte et s’il est encore ouvert aux visiteurs non connectés à ce serveur et aux utilisateurs distants, et dans son aperçu de lien. Les participants ne sont jamais affichés. Lorsque false, ces visiteurs voient seulement que le salon est destiné aux utilisateurs locaux de ce serveur
event_creators everyone / permitted everyone Qui peut créer des événements (événements). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission create_events, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir
public_counts true / false true Si la page d’accueil (/, hors connexion) et GET /api/v1/instance/overview affichent combien de membres compte le serveur, combien de publications publiques ses utilisateurs ont faites chacun des 7 derniers jours, et quand le serveur a démarré. Seules les publications publiques des utilisateurs de ce serveur comptent ; les nombres sont actualisés toutes les quelques minutes. Lorsque false, l’API les omet
landing_fediverse_explanation true / false true Si la page d’accueil (/, hors connexion) explique comment fonctionne le fédivers : qu’un compte ici suit et est suivi par des personnes d’autres serveurs
landing_features true / false true Si la page d’accueil montre ce que fait le logiciel sur ce serveur, avec un exemple de chaque fonctionnalité activée (salons vocaux, événements, articles, recherche, traduction, soutiens)
featured_accounts noms d’utilisateur de 20 comptes locaux au plus, séparés par des espaces ou des virgules (vide = aucun) vide Les comptes que les suggestions de personnes à suivre affichent en premier, dans cet ordre, avant les personnes de ce serveur qui ont publié récemment. Un compte dont le titulaire a désactivé « Suggérer mon compte et le trouver par une partie de son nom » n’est pas suggéré. Voir suggestions
login_providers_only true / false false Si l’inscription et la connexion sont limitées aux fournisseurs de connexion tant qu’au moins un est activé : les mots de passe et les clés d’accès ne permettent plus de se connecter, et les utilisateurs sans fournisseur lié ne peuvent plus se connecter une fois leurs sessions terminées. Sans fournisseur activé, il ne s’applique pas. my instance set affiche combien d’utilisateurs actifs n’ont aucun lien avec un fournisseur activé. Voir limiter la connexion aux fournisseurs de connexion.
invite_creators everyone / permitted permitted Qui peut créer ses propres invitations en plus du personnel avec manage_invites (invitations des membres). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission create_invites, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir. En mode approval, une invitation utilisable approuve aussitôt le nouvel utilisateur ; everyone permet donc à chaque utilisateur de contourner l’examen
member_invite_max_active entier 0-100 5 Combien d’invitations utilisables (ni révoquées, ni expirées, ni épuisées) un membre peut détenir à la fois ; 0 n’en laisse créer aucune aux membres. Les invitations du personnel ne comptent pas
member_invite_max_uses entier 1-1000 10 Combien de personnes peuvent s’inscrire avec une même invitation qu’un membre crée
member_invite_max_lifetime_seconds entier 3600-31536000 (secondes) 2592000 (30 jours) Pendant combien de temps au plus une invitation qu’un membre crée peut fonctionner. L’abaisser ne raccourcit pas les invitations existantes
translation_providers ID de fournisseurs séparés par des virgules vide Les fournisseurs de traduction côté serveur qui sont activés, le premier essayé d’abord. Lorsqu’il est vide, rien n’est envoyé à aucun fournisseur. Un ID pour lequel ce serveur n’a pas de fournisseur ne fait rien. Les fournisseurs de traduction intégrés ont les ID libretranslate, deepl, google et aws, et un plugin de traduction l’ID plugin
translation_provider_visibilities paires provider=visibility|visibility séparées par des virgules vide Ce que chaque fournisseur peut recevoir. Un fournisseur non nommé reçoit les publications public, local et unlisted ; provider= sans rien après n’en reçoit aucune. private et direct ne vont qu’à un fournisseur nommé avec elles ; autoriser un fournisseur n’autorise donc pas le suivant
translation_browser booléen false Si les lecteurs peuvent utiliser la traduction intégrée à leur navigateur, qui n’envoie rien à ce serveur ni à un fournisseur. Avec aussi un fournisseur côté serveur activé, le fournisseur passe en premier, et le navigateur traduit ce que le serveur refuse : une publication ou une langue qu’aucun fournisseur ne prend, une limite mensuelle, ou un fournisseur en échec
translation_user_monthly_characters entier 0-1000000000000 50000 Combien de caractères les requêtes d’un utilisateur peuvent envoyer aux fournisseurs de traduction sur un mois UTC. À 0, rien n’est envoyé. Il n’existe pas de valeur illimitée : définissez un grand nombre
translation_server_monthly_characters entier 0-1000000000000 500000 Combien de caractères tout le serveur peut envoyer aux fournisseurs de traduction sur un mois UTC. À 0, rien n’est envoyé. Il n’existe pas de valeur illimitée : définissez un grand nombre
translation_retention_days entier 1-3650 (jours) 30 Combien de jours une traduction est conservée après avoir été faite. La lire ne prolonge pas cette durée, et elle disparaît avec la publication
translation_reports_to_server booléen false Si les modérateurs peuvent envoyer le texte d’un signalement, les publications signalées et le commentaire de l’auteur du signalement, aux fournisseurs côté serveur. Chaque fournisseur ne reçoit toujours que les visibilités que translation_provider_visibilities lui autorise, quel que soit le demandeur : une publication directe signalée ne va qu’à un fournisseur autorisé pour direct, et le commentaire compte comme private. La traduction du commentaire n’est jamais conservée, pas plus que celle d’une publication supprimée, et les caractères ne comptent que dans translation_server_monthly_characters. Lorsque false, rien d’un signalement n’atteint un fournisseur
event_records_retention_days entier 30-3650 (jours) 90 Combien de jours après la fin ou l’annulation d’un événement conserver qui y a répondu, qui a été approuvé, qui a été invité, et qui a voté sur ses dates candidates. Un événement dont la date n’a jamais été fixée se termine avec sa dernière date candidate. L’événement lui-même (ses paramètres, lieux, date et dates candidates, et annulation) est conservé. Les enregistrements d’un événement signalé sont conservés aussi longtemps que le signalement, et les gels s’appliquent comme aux autres enregistrements (conservation des enregistrements)
voice_participants_retention_days entier 30-3650 (jours) 90 Combien de jours après la fin d’un salon de chat vocal conserver les enregistrements de qui y a participé : les participations, les intervenants et auditeurs, les mains levées, les invitations et les retraits. Le salon lui-même (son nom, sa description, ses hôtes et comment il s’est terminé) est conservé. Les enregistrements d’un salon signalé sont conservés aussi longtemps que le signalement, et les gels s’appliquent comme aux autres enregistrements
hook_inbound_status_mode, hook_inbound_follow_mode, hook_signup_check_mode, hook_media_check_mode, hook_local_status_mode, hook_inbound_actor_mode, hook_local_profile_mode off, observe, enforce observe Jusqu’où chaque hook de décision agit tant qu’il a un plugin. off ne passe à enforce que par observe.
hook_inbound_status_on_failure, hook_inbound_follow_on_failure, hook_media_check_on_failure, hook_inbound_actor_on_failure pass, retry pass Ce que fait le hook lorsqu’il applique ses décisions et que son plugin échoue (détails).
hook_inbound_status_unfollowed_direct booléen false Si inbound.status envoie aussi les publications directes d’auteurs qu’aucun compte local ne suit (détails). La page d’information (/about) l’indique tant que le hook est utilisé.
hook_signup_check_on_failure pass, require_approval pass Ce que fait signup.check lorsqu’il applique ses décisions et que son plugin échoue.
hook_signup_check_reject booléen false Si un reject de signup.check refuse l’inscription tant qu’il applique ses décisions. Lorsque désactivé, la réponse est seulement enregistrée, comme en observe.
hook_local_status_account_age_days entier 0-3650 (jours) 7 local.status examine les publications et leurs modifications des comptes plus récents que cette durée ; 0 examine chaque compte. La page d’information (/about) l’indique tant que le hook est utilisé.
hook_local_profile_account_age_days entier 0-3650 (jours) 7 local.profile examine les modifications de profil des comptes plus récents que cette durée ; 0 examine chaque compte. La page d’information (/about) l’indique tant que le hook est utilisé.
hook_decisions_retention_days entier 30-3650 (jours) 90 Combien de jours conserver les décisions des hooks.
single_user booléen false Si le serveur est un serveur d’une seule personne. Il ne peut être activé que tant que le serveur a exactement un compte local, et désactivé à tout moment
max_drafts entier 1-10000 100 Combien de brouillons non programmés un utilisateur peut conserver sur le serveur. L’abaisser ne supprime aucun brouillon : un utilisateur au-dessus n’en enregistre plus de nouveau
max_scheduled_posts entier 1-10000 300 Combien de publications programmées d’un utilisateur peuvent attendre. L’abaisser n’annule aucune programmation
max_scheduled_posts_per_day entier 1-10000 25 Combien de publications programmées d’un utilisateur peuvent attendre pour un même jour UTC
scheduled_post_min_lead_minutes entier 1-1440 (minutes) 5 Combien de minutes à l’avance, au minimum, une publication peut être programmée
scheduled_post_max_lead_days entier 1-3660 (jours) 366 Combien de jours à l’avance, au maximum, une publication peut être programmée
article_authoring everyone / permission everyone Qui peut écrire de nouveaux articles : tout utilisateur local, ou uniquement les utilisateurs dont les rôles ont la permission create_articles
max_article_bytes entier 1000-100000 (octets) 100000 Le plus grand nombre d’octets du HTML que produit le corps d’un article
max_article_images entier 0-100 20 Le plus grand nombre d’images issues des propres téléversements de l’auteur dans le corps d’un article, en plus de sa couverture
  • Les valeurs sont normalisées avant d’être stockées (TRUE devient true, 0750 devient 750, ja_jp devient ja-JP, les ID de médias sont mis en minuscules). Une valeur invalide est rejetée et rien n’est écrit.
  • preview_image et thumbnail n’acceptent que le média d’une image qui existe (y compris une image encore en cours de traitement). Tant que le traitement n’est pas terminé, et à la place d’une image dont le traitement a échoué, preview_image retombe sur l’image par défaut. Une fois qu’un média a été défini dans une révision quelconque, le nettoyage des téléversements non rattachés ne le supprime pas.
  • contact_account n’accepte que le nom d’utilisateur d’un utilisateur local non supprimé (stocké en minuscules). contact_email n’accepte qu’une adresse de la forme alice@example.com.
  • featured_accounts n’accepte que les noms d’utilisateur d’utilisateurs locaux non supprimés ; un @ initial est ignoré, les noms sont mis en minuscules, un nom répété n’est conservé qu’une fois, et ils sont stockés séparés par des espaces simples.

Les utilisateurs connectés voient des suggestions de personnes à suivre (sur le fil d’accueil vide après l’inscription, et avec GET /api/v1/accounts/suggestions). Les suggestions sont les comptes de featured_accounts dans leur ordre, puis les comptes de ce serveur qui ont publié une publication publique ou locale au cours des 30 derniers jours, celui qui a publié en dernier en premier. Le compte de l’utilisateur lui-même, les comptes que l’utilisateur suit, bloque ou met en sourdine, ou par lesquels il est bloqué, ainsi que les comptes suspendus ou désactivés sont omis.

Les nouveaux comptes sont suggérés et peuvent être trouvés par une partie de leur nom dans la recherche de comptes. Un utilisateur qui désactive « Suggérer mon compte et permettre de le trouver par une partie de son nom » dans les paramètres du profil sort des deux : la recherche ne trouve alors le compte que par son nom d’utilisateur complet, ou pour les personnes qui le suivent.

Suppression automatique des anciennes publications

Section intitulée « Suppression automatique des anciennes publications »

Les utilisateurs peuvent faire supprimer automatiquement leurs propres publications quelques jours après les avoir publiées (Paramètres, « Supprimer les anciennes publications »). La politique de chaque utilisateur lui est propre : si elle est activée, après combien de jours, et quelles publications elle conserve (les publications épinglées, mises en marque-page ou en favori, les publications avec des médias ou un sondage, les articles, les publications de certaines visibilités, et les publications comptant au moins un certain nombre de boosts ou de favoris). Supprimer une publication de cette manière revient à ce que son auteur la supprime : les serveurs auxquels elle a été envoyée reçoivent un Delete. Seules les publications des comptes locaux sont supprimées de cette manière, jamais les boosts.

Les clés auto_delete_default_* sont la politique avec laquelle chaque nouveau compte local démarre, quelle que soit la façon dont il est créé (le formulaire d’inscription, un fournisseur de connexion externe, une invitation ou my admin). Le compte la reçoit à sa création et en est ensuite propriétaire : modifier les clés plus tard ne change ni les comptes existants ni ceux qui ont reçu une valeur antérieure. L’écran des paramètres montre les valeurs comme étant celles de l’utilisateur. Avec les clés non définies, un nouveau compte démarre avec la suppression automatique désactivée, après 30 jours, en conservant les publications épinglées, mises en marque-page ou en favori, les articles et les publications directes. La valeur par défaut n’est pas montrée aux personnes extérieures à l’instance. Lorsqu’un maximum est défini, un nouveau compte reçoit la valeur par défaut ramenée au maximum, comme décrit ci-dessous, de sorte qu’il démarre dans cette limite.

Avec auto_delete_max_age_days supérieur à 0, aucune publication locale n’est conservée plus de ce nombre de jours après sa publication. Pour chaque compte local sans la permission keep_posts_longer :

  • La suppression automatique est toujours activée : un utilisateur ne peut pas la désactiver, et ne peut pas choisir plus de jours que le maximum (moins, c’est possible). L’écran des paramètres et PUT /api/v1/preferences/auto_delete refusent les deux.
  • Seules les exceptions que les clés auto_delete_max_allow_* autorisent conservent des publications. Par défaut, seules les publications épinglées le font, toutes ; avec auto_delete_max_kept_pins inférieur à 5, seules les épingles les plus récentes, en ce nombre, conservent leurs publications.
  • Les utilisateurs qui ont désactivé la suppression automatique, ou ne l’ont jamais définie, sont aussi soumis au maximum.

Activer le maximum, l’abaisser ou modifier les exceptions ne réécrit les paramètres de personne. À la place, chaque heure, la tâche content.auto_delete_statuses trouve les comptes dont les propres paramètres conservent des publications que le maximum ne conserve pas (parce que le maximum a été activé ou abaissé, ou que le compte a perdu keep_posts_longer). Elle en informe chacun une seule fois, avec une notification et un e-mail activés par défaut, et indique à partir de quand le maximum s’applique : auto_delete_grace_days après l’avis. D’ici là, les propres paramètres du compte restent en vigueur ; ensuite, ses publications suivent le maximum. Un compte qui rentre de nouveau dans le maximum (son utilisateur modifie ses paramètres, il obtient keep_posts_longer, ou le maximum disparaît ou augmente) n’est plus concerné, et une modification ultérieure l’en informe de nouveau avec un nouveau délai de grâce.

Activer le maximum informe en l’espace d’une heure chaque compte qu’il concerne. Les suppressions gardent leur rythme : au plus 100 publications d’un compte par heure, chacune envoyée comme un Delete aux serveurs auxquels la publication est parvenue ; un compte comptant beaucoup d’anciennes publications met donc des heures ou des jours à se vider. Un utilisateur qui modifie ses paramètres entre-temps arrête le reste.

keep_posts_longer est une permission de membre : donnez-la à un rôle pour permettre à ses titulaires de conserver leurs publications aussi longtemps qu’ils le choisissent et de désactiver la suppression automatique. Le rôle intégré admin l’a. Une formule de soutien peut la porter, de sorte que conserver ses publications plus longtemps peut être un avantage de la formule ; lorsque la souscription se termine, le maximum s’applique de nouveau après le délai de grâce.

Le maximum est public : GET /api/v1/instance le renvoie dans auto_delete_limit, et la page À propos l’affiche, afin que les gens le connaissent avant de s’inscrire. Les modifications de ces clés exigent manage_settings et sont enregistrées dans le journal d’audit comme tout autre paramètre. Dans le client web, elles se trouvent sur la page « Suppression des publications » de « Paramètres du serveur », qui demande confirmation avant d’enregistrer un maximum qui est activé ou rendu plus strict.

Les utilisateurs enregistrent des brouillons de publications sur le serveur, continuent de les écrire sur un autre appareil et les publient immédiatement ou à l’heure de leur choix. Seul leur auteur lit un brouillon ; les brouillons ne sont jamais fédérés, ne figurent pas dans l’export des données d’un compte et disparaissent avec le compte lorsqu’il est effacé. Les cinq réglages max_drafts et scheduled_post_* ci-dessus les bornent ; un enregistrement ou une programmation au-delà d’une limite est refusé avec un message qui la nomme.

  • Une publication programmée est publiée par la tâche content.publish_scheduled_draft à son heure ou peu après, y compris lorsque l’heure est plus lointaine que la limite de délai du service de file : la tâche revient et attend de nouveau. Définissez-les avec my instance set, par exemple my instance set max_scheduled_posts 100.
  • La publication est vérifiée lorsqu’elle est publiée, et pas seulement lorsqu’elle est programmée : un utilisateur qu’une mesure de modération empêche de publier à ce moment-là, ou dont la publication répond à une publication disparue ou la cite, n’obtient aucune publication. Le brouillon reste, et l’utilisateur reçoit une notification qui en explique la raison (scheduled_status_failed, que les utilisateurs peuvent désactiver dans leurs réglages de notification, et qui n’est jamais envoyée par e-mail). L’examen automatisé des publications locales, tant qu’il est utilisé, examine la publication lorsqu’elle est publiée.
  • Une publication est horodatée au moment de sa publication, et la suppression automatique des anciennes publications compte à partir de là.
  • Les fichiers médias qu’un brouillon joint sont conservés tant que le brouillon l’est ; supprimer le brouillon les rend non rattachés, et ils partent avec le nettoyage des téléversements non rattachés. La couverture du brouillon d’un article et les téléversements que son corps montre sont conservés de la même façon.
  • Les brouillons et les publications programmées incluent les articles, qui sont programmés et comptés comme des publications. Le brouillon d’un article peut ne pas avoir de titre pendant que son auteur écrit ; il est vérifié comme un nouvel article lorsqu’il est publié, et un utilisateur qui n’a plus le droit d’écrire de nouveaux articles à ce moment-là n’obtient aucun article.

Un article est une longue publication avec un titre, un résumé et une image de couverture, dont l’auteur écrit le corps en Markdown. Les articles sont des publications à tous les autres égards : ils ont une visibilité, peuvent être modifiés avec leur historique conservé, boostés, mis en favori, cités, recevoir des réponses, être signalés et supprimés, et la modération agit sur eux comme sur les publications. Le serveur rend le corps une seule fois, lorsqu’il est écrit : le HTML brut qu’il contient n’est pas rendu, et seules les images des propres téléversements de l’auteur s’affichent comme des images ; toute autre image devient un lien, de sorte que les lecteurs ne chargent jamais d’images depuis d’autres sites. Les fils, les notifications et la recherche montrent le titre, le résumé et la couverture ; le corps s’affiche là où l’article est ouvert.

  • Par défaut, chaque utilisateur local peut écrire des articles. Avec article_authoring défini sur permission, seuls les utilisateurs dont les rôles ont la permission create_articles peuvent en écrire de nouveaux ; les articles déjà écrits restent, et leurs auteurs peuvent toujours les modifier. Une mesure de modération qui empêche un compte de publier l’empêche aussi d’écrire et de modifier des articles. Une formule de soutien peut donner create_articles comme avantage.
  • max_article_bytes borne le HTML d’un corps, pas le Markdown : les serveurs qui reçoivent des articles comptent le HTML, et 100 000 octets, le maximum possible, est ce qu’ils conservent en entier. Un corps en japonais d’environ 30 000 caractères y tient. max_article_images borne les images d’un corps. L’éditeur montre les deux avant la publication de l’article.
  • Un article n’est jamais une publication directe, et n’a ni sondage, ni pièces jointes autres que ses images, ni avertissement de contenu : un article sensible montre son titre et son résumé et replie le corps et la couverture.
  • La suppression automatique des anciennes publications conserve les articles sauf si l’utilisateur le désactive (auto_delete_default_keep_articles pour les nouveaux comptes, auto_delete_max_allow_articles sous un maximum).
  • GET /api/v1/instance renvoie les limites dans limits.articles et le réglage de rédaction dans article_authoring. Définissez-les avec my instance set, par exemple my instance set article_authoring permission.

Les utilisateurs locaux planifient des événements avec une date, un fuseau horaire et jusqu’à trois lieux : un salon de chat vocal de ce serveur, un lieu de rendez-vous en personne et un lien. Au lieu d’une date, un organisateur peut proposer jusqu’à 20 dates candidates : les utilisateurs qui voient l’événement répondent à chacune par oui, peut-être ou non, et l’organisateur ou un co-organisateur en confirme ensuite une, ce qui fixe la date. D’ici là, personne ne répond s’il viendra. Les événements sont réservés aux utilisateurs de ce serveur : ils ne sont jamais fédérés, et les utilisateurs distants et les visiteurs qui ne sont pas connectés n’en voient aucun.

  • Qui peut en créer un est défini par event_creators. Un organisateur doit aussi pouvoir ouvrir des salons de chat vocal (voice_room_starters et le réglage de configuration voice) pour tenir un événement dans l’un d’eux.
  • Le salon de chat vocal d’un événement s’ouvre à son début, hébergé par l’organisateur, et attend jusqu’à 30 minutes le premier participant. Il prend le titre de l’événement et la visibilité de l’événement (chaque utilisateur local, les abonnés, les personnes que l’organisateur suit, les abonnés mutuels, ou les invités). Les co-organisateurs, les personnes qui ont répondu qu’elles viennent ou viendront peut-être, et les invités qui n’ont pas répondu sont invités au salon, afin qu’ils continuent de le voir lorsqu’un co-hôte le reprend. Le salon ne crée aucune publication de début, et la notification de début de l’événement est sa seule notification.
  • Un salon qui ne peut pas s’ouvrir (le chat vocal est désactivé, l’organisateur ne peut plus ouvrir de salons ou en héberge un autre, ou autant de salons sont ouverts que le réglage de configuration voice_max_open_rooms le permet) laisse l’événement tel quel : l’organisateur est notifié, et la page de l’événement indique que le salon n’a pas pu s’ouvrir. Le serveur le vérifie lorsque la date est fixée ou modifiée et aussi un jour avant le début, et notifie l’organisateur de ce qui garderait le salon fermé. L’organisateur est aussi notifié lorsque personne n’est venu dans le salon. Annuler l’événement, ou retirer son salon de chat vocal, termine le salon et conserve l’événement.
  • L’organisateur choisit qui voit l’événement : chaque utilisateur local, les abonnés de l’organisateur, les personnes que l’organisateur suit, les abonnés mutuels, ou uniquement les invités. Les invités et les personnes qui y ont répondu, ou ont répondu à ses dates candidates, le voient toujours, et un blocage entre un utilisateur et l’organisateur ou un co-organisateur le masque pour cet utilisateur.
  • L’adresse et le lien d’un événement ne sont montrés qu’aux participants que l’organisateur ou un co-organisateur a approuvés, sauf si l’organisateur les montre à toutes les personnes qui voient l’événement. Les liens doivent être http ou https, et le serveur ne les ouvre jamais.
  • Un utilisateur qui voit un événement peut l’enregistrer sous forme de fichier iCalendar (.ics) pour l’ajouter à son propre agenda. Le fichier ne nomme que les lieux que cet utilisateur voit ; une adresse réservée aux participants approuvés n’y apparaît donc jamais. Il n’existe aucune adresse d’abonnement au calendrier.
  • Un utilisateur crée au plus 10 événements par heure, et un événement envoie au plus 100 invitations par heure.
  • Les utilisateurs peuvent signaler un événement, et les modérateurs peuvent en annuler un ; suspendre ou supprimer un organisateur annule les événements de l’organisateur qui n’ont pas commencé (modération). Qui a répondu et qui a été invité est conservé pendant event_records_retention_days après l’événement, tout comme les votes sur ses dates candidates.
Clé Limite Description
name 100 caractères, une ligne (des espaces seuls ne sont pas autorisés) Le nom de l’instance (nom d’affichage). Voir nom et domaine
short_description 500 caractères Une courte description
description 20000 caractères La description
terms 100000 caractères Les conditions d’utilisation (Markdown)
privacy_policy 100000 caractères La politique de confidentialité (Markdown)
commerce_disclosure 100000 caractères Les mentions du vendeur pour les formules payantes, comme l’avis qu’exige la loi japonaise (Markdown ; soutiens)
preview_image_alt 1500 caractères Le texte alternatif de l’image preview_image (og:image:alt). Lorsqu’il n’est pas défini, « Image de {nom de l’instance} » est utilisé
thumbnail_alt 1500 caractères Le texte alternatif de l’image thumbnail
  • Chaque texte a une seule valeur. Un administrateur l’écrit une fois dans la langue qu’il veut, et les lecteurs de chaque locale voient la même valeur ; les lecteurs d’autres langues s’appuient sur la traduction automatique ou équivalent. Les libellés et les descriptions des champs d’administration sont traduits dans la langue de la personne comme tout autre texte d’écran ; seule la valeur qu’un administrateur écrit ne l’est pas.
  • Le serveur ne connaît pas la langue d’un texte ; le client web et les écrans rendus par le serveur produisent donc les textes avec dir="auto" et lang="" (la valeur HTML pour une langue inconnue) au lieu d’hériter de la langue de l’écran.
  • Définir un texte vide le supprime.
  • Outre la CLI, les textes peuvent être modifiés sur les écrans d’administration du client web (nom, courte description et description sur la page Général des « Paramètres du serveur », /admin/settings/general ; les conditions sur /admin/documents/terms, la politique de confidentialité sur /admin/documents/privacy-policy, et les mentions de commerce sur /admin/documents/commerce-disclosure, chacune une page de « Conditions et politiques », /admin/documents) et avec l’API cliente (GET /api/v1/admin/instance_texts, PUT /api/v1/admin/instance_texts/{key}). Les deux exigent la permission de rôle manage_settings, et les changements sont enregistrés dans le journal d’audit (text_changed).
  • Écrivez terms, privacy_policy et commerce_disclosure en Markdown (CommonMark plus les tableaux, le texte barré et les liens automatiques de GitHub Flavored Markdown). Un saut de ligne à l’intérieur d’un paragraphe reste un saut de ligne, et les titres # commencent un niveau en dessous du titre de la page (h2).
  • Le serveur les convertit en HTML et le nettoie (GET /api/v1/instance/documents/{kind} anonyme), et les pages du client web /about/terms, /about/privacy et /about/commerce les affichent. Le HTML brut, les images et les liens autres que http, https et mailto sont supprimés. Les pages ne demandent aucune connexion (ce sont des pages du client web ; elles exigent donc JavaScript). /about/commerce est l’URL à donner au fournisseur de paiement.
  • Un document que vous rédigez est lié depuis l’écran d’inscription, le pied de page de chaque écran rendu par le serveur et le client web (la troisième colonne, le menu, les paramètres et l’écran de connexion). Un document qui n’est pas rédigé n’est pas lié, et son API répond 404.
  • Tant que les conditions d’utilisation ou la politique de confidentialité sont rédigées, l’écran d’inscription les liste avant le bouton de création avec une case à cocher obligatoire, « J’ai lu et j’accepte les documents ci-dessus ». Le serveur refuse une inscription sans elle, y compris une inscription par un fournisseur de connexion. Sans l’un ni l’autre document, l’écran ne demande aucun accord.

Une instance a un domaine et un nom, séparément.

  • Le domaine est la configuration host (et account_domain, le domaine des identifiants). Il ne peut pas être modifié pendant que l’ instance fonctionne. Les identifiants (@alice@example.com), les URL, les ID ActivityPub et domain dans GET /api/v1/instance restent le domaine même lorsqu’il y a un nom.
  • Le nom est le texte name. Il apparaît partout où l’instance est nommée aux personnes : la barre latérale et « À propos de ce serveur » du client web, le titre de l’onglet du navigateur, les écrans de connexion, d’inscription, de confirmation d’e-mail, d’état du compte et de consentement à l’autorisation rendus par le serveur, les e-mails (confirmation de l’adresse e-mail et notifications aux modérateurs), og:site_name des aperçus de liens, name / short_name du Web App Manifest, metadata.nodeName de NodeInfo et name dans GET /api/v1/instance.
  • Le nom est le même dans toutes les langues. Lorsqu’il n’y a pas de nom, le domaine (host) est affiché à la place.
  • Une modification prend effet à partir de la requête suivante, sans redémarrage. Le titre de l’onglet et la barre latérale d’un client web ouvert se mettent à jour lorsque vous enregistrez sur l’écran d’administration.

Le contact des opérateurs (contact_account, contact_email) et l’image qui représente l’instance (thumbnail et le texte thumbnail_alt) apparaissent aux endroits ci-dessous. Ce qui n’est pas défini n’apparaît pas.

  • « À propos de ce serveur » du client web (/about). La miniature et le compte de contact apparaissent aussi sur le premier écran (/) pour les personnes qui ne sont pas connectées.
  • contact (account et email) et thumbnail (url, width, height, alt) dans GET /api/v1/instance.
  • metadata dans NodeInfo : maintainer selon la convention de Misskey (name est le nom d’affichage du compte de contact, ou son nom d’utilisateur s’il n’en a pas ; email est contact_email), staffAccounts selon la convention de Pleroma et Akkoma (l’ID d’acteur du compte de contact), thumbnail (url et alt), et nodeDescription à partir de la courte description short_description.

Lorsque le compte de contact est suspendu ou supprimé, le compte n’est pas affiché et seule l’adresse e-mail l’est. Modifiez-les sur la page Général de l’écran d’administration du client web (« Paramètres du serveur », /admin/settings/general), ou avec la CLI ou l’API cliente.

Un serveur de son seul opérateur, le chez-soi de l’opérateur dans le fédivers, est un serveur d’une seule personne : activez single_user. Dans le client web, un administrateur l’active et le désactive avec Serveur d’une seule personne sur la page Inscription des Paramètres du serveur, qui indique pourquoi le serveur a refusé lorsqu’il y a plus d’un compte local.

Fenêtre de terminal
my instance set single_user true
my instance set single_user false # back to a community server
  • Il ne peut être activé que tant qu’exactement un compte local compte. Tout compte local non supprimé compte, y compris ceux en attente d’approbation, désactivés, programmés pour suppression, suspendus ou limités, puisque chacun pourrait revenir comme une seconde personne. Un compte dont l’inscription a été rejetée ne compte pas. Avec tout autre nombre, my instance set échoue avec le décompte, et l’API d’administration répond 422 avec le type /api/v1/problems/single-user-requires-one-account. L’acteur de l’instance du serveur n’est pas un compte et ne compte jamais.
  • Il peut être désactivé à tout moment. L’activer ou le désactiver ne supprime rien et ne change la valeur stockée d’aucun autre paramètre : ce qu’il retient s’applique de nouveau tel quel une fois désactivé. Comme tout paramètre, le changement va dans le journal d’audit.

Tant qu’il est activé :

  • L’inscription est fermée. registration_mode se lit comme closed quelle que soit sa valeur stockée ; la page d’inscription, l’inscription par un fournisseur de connexion et my admin create ne créent donc aucun compte. Se connecter avec un fournisseur de connexion fonctionne toujours.
  • Seulement le fil d’accueil. local_timeline_visibility et federated_timeline_visibility se lisent comme off. Les fils de hashtags et de listes restent.
  • Ce dont une communauté a besoin est masqué. Les fils local et fédéré et leurs flux, les suggestions de comptes, les invitations des utilisateurs et des administrateurs, l’examen des inscriptions et les blocages d’inscription répondent 404 avec le type /api/v1/problems/single-user-mode.
  • Pas de nouvelles publications locales. Sur un serveur d’une seule personne, une publication pour les « Voisins » n’atteint que les abonnés ; une nouvelle publication ne peut donc pas être locale : l’API cliente répond 422 et l’omet de ce qu’un compte peut publier. Une visibilité par défaut « Voisins » se lit comme « Abonnés seulement » et ne peut pas être enregistrée, et un salon de chat vocal pour les personnes de ce serveur s’annonce dans une publication pour les abonnés. Les publications déjà locales restent locales.
  • Le serveur dit ce qu’il est. single_user dans GET /api/v1/instance vaut true, avec le mode d’inscription effectif et les fils, et le compte de l’opérateur comme single_user_account, et NodeInfo répond openRegistrations: false avec metadata.singleUser: true.
  • La page d’accueil est le profil de l’opérateur. Les personnes qui ne sont pas connectées et ouvrent l’adresse du serveur voient le profil de son unique compte, avec le moyen de se connecter et des liens vers la page À propos, les conditions d’utilisation et la politique de confidentialité que le serveur publie. Le client web masque ce que le serveur ne propose pas, dans sa navigation, ses menus et ses écrans d’administration : les fils local et fédéré, l’inscription, les comptes suggérés, les invitations, l’examen des inscriptions, les blocages d’inscription, la visibilité « Voisins », et les paramètres de l’inscription, des invitations, des fils publics, de la page d’accueil et des comptes suggérés.

La fédération, la modération, la recherche en texte intégral, le programme de soutien, les documents et les écrans d’administration fonctionnent comme sur n’importe quel serveur.

Fenêtre de terminal
my instance list # all settings (and whether each is the default) and texts
my instance get registration_mode
my instance set registration_mode open
my instance set name "Example Social" # the same name in every locale
my instance set description - < description.txt # the value "-" reads standard input
my instance get name
my instance set name "" # delete the name
my instance history registration_mode # revision history (newest first, -limit sets the count)
my instance history description
my instance set -owner admin preview_image ./preview.png # upload the image as media of admin and use it as the preview image
my instance set preview_image 0192f3a4-7b1c-7d2e-9f00-1a2b3c4d5e6f # give the ID of media that is already uploaded
my instance set preview_image_alt "A blue bird mascot"
my instance set preview_image "" # back to the bundled default image
my instance set contact_account admin # the contact account
my instance set contact_email admin@example.com
my instance set -owner admin thumbnail ./thumbnail.png # the thumbnail
my instance set thumbnail_alt "A town by the sea"
  • Écrivez les options avant la clé et la valeur.
  • Avec -owner <username>, la valeur de preview_image ou de thumbnail est lue comme le chemin d’un fichier image et téléversée comme média de ce compte local. Le worker traite l’image avant son utilisation. Une image paysage de 1200x630 est recommandée.
  • Une modification enregistre une révision (instance_*_revisions) et met à jour la valeur courante (instance_settings / instance_texts) dans une seule transaction. Une modification depuis la CLI est enregistrée sans acteur (BY vaut cli dans l’historique).
  • Définir de nouveau la même valeur ajoute quand même une révision.
  • Codes de sortie : 0 en cas de succès, 1 pour une valeur rejetée ou une erreur de base de données (rien ne change), 2 pour des arguments incorrects.
  • Le restreindre conserve les relations d’abonnement, les publications importées et les enregistrements de livraison, et n’envoie aucun Undo ni Reject. Le flux s’arrête simplement, et revenir à both (ou à un autre mode) le reprend tel qu’il était.
  • Les publications et réactions faites pendant la restriction ne sont pas livrées rétroactivement lorsque vous élargissez de nouveau.
  • Côté distant, les abonnés des utilisateurs locaux ne reçoivent rien tant que le mode est inbound, et les abonnements des utilisateurs locaux ne sont pas mis à jour tant qu’il est outbound ou off.
  • Les suppressions (de publications ou de comptes) effectuées pendant que le mode est off ne sont pas envoyées. En inbound et outbound, le retrait de ce qui avait déjà été envoyé (Delete et similaires) va aux destinataires d’origine et aux abonnés de l’époque.
  • Les modifications sont enregistrées dans instance_setting_revisions et dans le journal d’audit (target_kind = setting).

Pour couper aussi les relations, utilisez la CLI my admin federation sever.

Fenêtre de terminal
my admin federation sever -direction in # end follows of local users by remote accounts
my admin federation sever -direction out # end follows of remote accounts by local users
my admin federation sever -direction both
  • Elle met fin aux abonnements en attente et actifs entre comptes locaux et distants comme des terminaisons par modération (follow_terminations, reason = moderation). Un changement de mode ne l’appelle jamais automatiquement.
  • Reject (in) ou Undo (out) n’est envoyé au côté distant que si le mode courant envoie ce sens. Dans un mode qui ne le fait pas (comme off), l’abonnement se termine du côté local uniquement et le côté distant n’en est pas informé.
  • On peut l’exécuter à répétition sans risque. Elle affiche sur la sortie standard le nombre d’abonnements auxquels elle a mis fin.

Chaque paramètre que la CLI peut changer peut aussi l’être sur les écrans d’administration du client web et avec l’API cliente. Les deux exigent la permission de rôle manage_settings (seul le rôle intégré admin l’a). Comme avec la CLI, un changement est conservé comme révision et enregistré par clé dans le journal d’audit (setting_changed, la cible est le paramètre et l’acteur est cet utilisateur). Consultez le journal d’audit sur l’écran de modération (« Journal d’audit », /moderation/audit-log).

  • Client web (« Paramètres du serveur », /admin/settings) : l’écran liste une page par sujet, en groupes. Chaque page a un formulaire et un bouton d’enregistrement, et l’enregistrement n’envoie que ce que vous avez changé sur cette page ; les paramètres des autres pages restent tels quels. Un choix dont chaque option change beaucoup dit ce que fait chacune sous le choix, avant que vous enregistriez, et un nombre indique ses bornes lorsqu’il est refusé.

    Page Sections et paramètres
    Général (/admin/settings/general) Nom et descriptions (name, short_description, description) ; Langue (default_locale, choisie parmi les langues de l’application) ; Contact (contact_account, contact_email) ; Images (thumbnail et le texte thumbnail_alt, preview_image et le texte preview_image_alt)
    Icône et logo (/admin/settings/branding) L’icône, le logo et le logo pour les fonds sombres (Logo et icône)
    Inscription (/admin/settings/registration) Qui peut s’inscrire (registration_mode, chaque mode avec ce qu’il fait) ; Serveur d’une seule personne (single_user) ; Invitations des membres (invite_creators, member_invite_max_active, member_invite_max_uses, member_invite_max_lifetime_seconds en heures) ; Fournisseurs de connexion uniquement (login_providers_only, qui demande d’abord confirmation, avec combien d’utilisateurs actifs ne pourraient plus se connecter et si vous en faites partie) ; Applications (user_app_registration, dynamic_client_registration, oauth_metadata_document_clients, oauth_client_rate_limits). Sur un serveur d’une seule personne, les sections de l’inscription et des invitations des membres indiquent que personne d’autre ne s’inscrit
    Publications et fonctionnalités (/admin/settings/content) Publications (max_status_length, require_media_description) ; Fils (local_timeline_visibility, federated_timeline_visibility) ; Cartes de lien (link_cards, link_cards_ignore_robots_txt) ; Brouillons et publications programmées (max_drafts, max_scheduled_posts, max_scheduled_posts_per_day, scheduled_post_min_lead_minutes, scheduled_post_max_lead_days) ; Articles (article_authoring, max_article_bytes, max_article_images) ; Événements (event_creators, event_records_retention_days) ; Page d’accueil et suggestions (public_counts, landing_fediverse_explanation, landing_features, featured_accounts)
    Chat vocal (/admin/settings/voice) Qui peut ouvrir des salons (voice_room_starters) ; Salons (voice_public_summary, voice_participants_retention_days)
    Suppression des publications (/admin/settings/auto-delete) Valeur par défaut pour les nouveaux comptes (les paramètres auto_delete_default_*) ; Maximum pour tout le monde (auto_delete_max_age_days, auto_delete_grace_days, les paramètres auto_delete_max_allow_*, auto_delete_max_kept_pins). Enregistrer un maximum qui est activé ou raccourci demande d’abord confirmation (Un maximum pour la conservation des publications)
    Fédération (/admin/settings/federation) Sens (federation_mode) ; Serveurs (federation_scope : enregistrer allowlist affiche d’abord les abonnements que la bascule mettrait fin et demande confirmation, voir fédérer uniquement avec des serveurs autorisés) ; Récupérations signées (authorized_fetch) ; Médias d’autres serveurs (remote_media_policy, remote_media_cache_ttl_seconds en minutes, remote_media_cache_max_bytes en MiB) ; Publications d’autres serveurs (remote_status_retention_days, remote_status_max_retention_days, relay_status_retention_days) ; Serveurs modérés (domain_actions_visibility, domain_actions_rationale_visibility)
    Recherche et robots d’exploration (/admin/settings/discovery) Moteurs de recherche (search_indexing, indexable_default) ; Contact de sécurité (security_contact) ; IA (ai_usage) ; Recherche en texte intégral (search_visibilities)
    Examen externe (/admin/settings/hooks) Une section pour chaque hook de décision : son mode (enforce n’est proposé que lorsqu’il n’est pas off), ce qu’il fait lorsque son plugin échoue, et ses autres paramètres ; Enregistrements des décisions (hook_decisions_retention_days). Voir Hooks de décision
    Contestations et enregistrements (/admin/settings/records) Contestations (appeal_window_days) ; Conservation des enregistrements (session_origins_retention_days, registration_origins_retention_days, reports_retention_days, moderation_actions_retention_days, audit_log_retention_days)

    Sur la page Général, une image est téléversée à l’enregistrement, et devient alors la miniature ou l’image d’aperçu de lien. Qui peut voir les coûts d’exploitation, les revenus et la liste des soutiens se définit sur les écrans « Coûts et revenus » et « Soutiens ». Les paramètres de traduction ont un écran à part, ci-dessous.

  • Client web (« Traduction », /admin/translation) : les fournisseurs de ce serveur, leur ordre et ce que chacun peut recevoir, la traduction du navigateur, les limites mensuelles et la durée de conservation des traductions, avec les caractères envoyés ce mois-ci et le taux de réussite du cache. Chaque processus du serveur ajoute son nombre de réussites du cache au taux au plus une fois par minute, si bien que les dernières requêtes peuvent mettre une minute à apparaître, et un processus qui s’arrête peut laisser sa dernière minute non comptée. Mettez à jour votre politique de confidentialité (modèle) avant d’activer un fournisseur côté serveur : le texte envoyé à un fournisseur ne peut pas être rappelé. Les clés d’API des fournisseurs et l’adresse d’un plugin de traduction se trouvent dans la configuration du déploiement ; aucun paramètre ni aucune réponse de l’API cliente ne les contient.

  • Limites de traduction. Ce qui compte, ce sont les caractères envoyés, en points de code : les marqueurs qui remplacent les mentions, les liens et autres ne comptent pas, ni une traduction que le serveur conserve déjà, une publication déjà dans la langue du lecteur, ou la traduction du navigateur. Chaque appel à un fournisseur compte, même un appel qui échoue, puisque le fournisseur peut avoir reçu le texte ; le nombre peut donc différer de ce qu’un fournisseur facture. Au-delà d’une limite, la requête est refusée avec un 429 et aucun fournisseur n’est appelé ; le client web utilise alors la traduction du navigateur du lecteur, lorsque vous l’autorisez et que le navigateur peut traduire la publication. Les mois sont en UTC.

  • API cliente : GET /api/v1/admin/settings renvoie chaque paramètre avec sa valeur actuelle, sa valeur par défaut, s’il est défini, et son type et ses valeurs acceptées (choix ou plage). PATCH /api/v1/admin/settings change des paramètres ensemble avec {"values": {"<key>": "<value>", ...}}. Toutes les valeurs sont des chaînes, normalisées et stockées comme avec la CLI. Si une seule clé est inconnue ou qu’une valeur est invalide, la réponse est un 422 qui nomme la clé et rien ne change. Les clés modifiées sont enregistrées comme révisions et dans le journal d’audit dans la même transaction.

  • Les invitations, qui fonctionnent dans les modes open, approval et invite, sont créées sur l’écran de modération (« Invitations », /moderation/invites, permission manage_invites ; voir codes d’invitation), et par les membres comme l’autorise invite_creators (invitations des membres).

Les règles de l’instance apparaissent dans rules de GET /api/v1/instance, et les signalements les citent par ID.

  • Une règle comporte une phrase d’une ligne (jusqu’à 300 caractères) et un complément facultatif (jusqu’à 1 000 caractères). Comme pour les textes, l’administrateur les écrit dans la langue qu’il souhaite et toutes les langues voient la même valeur (dir="auto" et lang=""). Il peut y avoir au plus 100 règles actives.
  • Chaque modification (une phrase révisée, un réordonnancement) est conservée comme une révision (instance_rule_revisions), et l’ID d’une règle ne change pas.
  • Une règle retirée disparaît de la liste des règles actives. Elle ne peut pas être rétablie, mais les signalements peuvent toujours y faire référence.
Fenêtre de terminal
my instance rule create -hint "No harassment" "Be kind" # add at the end of the active rules
my instance rule edit <rule> "Always be kind" # change the sentence; the supplement changes only with -hint
my instance rule move <rule> 1 # move to position 1 and renumber the active rules 1, 2, ...
my instance rule retire <rule> # retire it
my instance rule list # active rules (-all includes retired ones)
  • L’API d’administration est /api/v1/admin/rules (lister, ajouter, obtenir, réviser, déplacer, retirer) et exige la permission de rôle manage_rules.
  • Sur l’écran d’administration du client web (« Règles », /admin/rules, manage_rules), la liste affiche les règles en vigueur dans l’ordre, et « Monter » et « Descendre » les réordonnent ; le filtre au-dessus de la liste affiche à la place les règles retirées. « Ajouter une règle » ouvre une page avec une phrase et un complément. Choisissez la phrase d’une règle pour ouvrir sa page, où vous la modifiez et la retirez (après une boîte de dialogue de confirmation). Chaque modification est enregistrée dans le journal d’audit (rule_added, rule_revised, rule_moved, rule_retired).
  • Les codes de sortie sont les mêmes que pour les paramètres (0 en cas de succès, 1 pour une valeur rejetée ou une erreur de base de données, 2 pour des arguments incorrects).

Les cartes de lien des publications (link_cards) proviennent d’un robot d’exploration : le serveur récupère la page liée et son image. Une règle arrête ce robot sur un domaine et ses sous-domaines, et ne touche à rien d’autre concernant le domaine. Elle a l’un de deux modes. Une règle est le choix de l’opérateur, et elle s’applique en plus de ce que les sites liés eux-mêmes refusent (aperçus de liens).

Mode Ce qu’il récupère Cartes qu’il a déjà
Arrêter la récupération (no_fetch) Rien du domaine, ni pages ni images, même lorsqu’une redirection y mène Masquées
Arrêter les images seulement (no_images) Les pages, mais aucune image du domaine Affichées sans leur image
  • Une règle ne porte que sur les cartes de lien. Le domaine reste fédéré, et les médias de ses publications sont récupérés comme d’habitude : pour couper un serveur, utilisez une action de domaine, qui arrête aussi ses cartes de lien. Une règle n’est ni listée avec les actions de domaine ni exportée avec elles.
  • Une règle couvre le domaine et ses sous-domaines, et une image est vérifiée par rapport aux hôtes de la page et de l’image. Toute règle qui couvre un hôte s’applique ; une règle sur un sous-domaine n’assouplit donc pas la règle de son parent. Un domaine s’écrit et se normalise comme pour une action de domaine : un nom d’hôte sans schéma ni port, dans n’importe quelle graphie d’un domaine internationalisé.
  • Un changement prend effet aussitôt, aussi sur les cartes que le serveur a déjà, et les images proxifiées de ces cartes cessent d’être servies tant que les images sont arrêtées.
  • Retirer une règle ramène les cartes que le serveur a déjà telles qu’elles étaient. Un lien qui a été ignoré obtient sa carte la prochaine fois qu’une publication en a besoin ; rien n’est récupéré de nouveau en masse. Une carte récupérée de nouveau alors que les images étaient arrêtées reste sans image jusqu’à sa prochaine récupération.
  • Sur l’écran d’administration du client web (« Domaines de cartes de lien », /admin/link-card-domains, manage_settings), « Ajouter une règle » définit une règle avec son mode et une note, et refuse un domaine qui a déjà une règle, avec un lien vers cette règle. La liste affiche les règles par domaine, 40 à la fois avec « Afficher plus » ; choisir un domaine ouvre la page de sa règle, où vous changez son mode et sa note, et la retirez (après une boîte de dialogue de confirmation).
  • L’API d’administration est /api/v1/admin/link_card_domains (lister, définir ; un DELETE avec le domaine le retire) et exige la permission de rôle manage_settings. Un serveur conserve au plus 1 000 règles, chacune avec une note de 5 000 caractères au plus.
  • Chaque changement est enregistré dans le journal d’audit (link_card_domain_fetch_stopped, link_card_domain_images_stopped, link_card_domain_rule_removed).

Le thème de tout le serveur est un ensemble de surcharges des jetons de conception du client web, avec une valeur claire et une valeur sombre pour chaque couleur. Il s’applique au client web de chaque spectateur et aux écrans que le serveur rend (connexion, inscription, conditions, etc.). Il n’y a pas de CSS personnalisé.

  • Vous pouvez surcharger ces jetons de conception ; l’espacement, les tailles des composants, les graisses de la typographie, les ombres et les couleurs des graphiques de données restent fixes :

    Jetons Type Surcharge
    color-surface, color-surface-raised, color-surface-raised-hover, color-surface-raised-pressed, color-surface-hover, color-surface-pressed, color-text, color-muted-text, color-accent, color-on-accent, color-accent-text, color-quote-bar couleur #rrggbb pour le clair et pour le sombre
    font-sans-override, font-mono-override famille de polices Noms de familles, séparés par des virgules (30 au plus), sans famille générique comme sans-serif ; mettez entre guillemets un nom contenant un mot qui commence par un chiffre, comme "M PLUS 1p"
    text-tagline, text-headline, text-heading, text-title, text-reading, text-body, text-caption longueur 0 ou rem / px, de 0,625rem à 3rem
    text-*--line-height des mêmes sept nombre 1 à 2,5
    radius-control, radius-overlay longueur 0 à 2rem
    duration-spin durée ms / s, 0 à 1000ms
  • Le client web dessine le texte avec ses propres polices : Noto Color Emoji pour les émojis, Noto Sans pour le latin, le grec et le cyrillique, et Noto Sans CJK dans les glyphes de la langue du texte pour le reste. Les polices de font-sans-override (texte) et font-mono-override (code) viennent juste après la police d’émojis, et les polices du client web dessinent les caractères qui manquent aux vôtres. Un thème ne peut pas remplacer ces polices.

  • Vous enregistrez un ensemble comme brouillon, le prévisualisez, puis le publiez ; le thème en vigueur ne change pas tant que vous ne publiez pas. Chaque enregistrement remplace tout le brouillon, et chaque publication est une nouvelle révision. Restaurer publie de nouveau l’ensemble qui était en vigueur avant l’actuel, et laisse le brouillon tel quel.

  • Dans le client web, Administration > Thème affiche le brouillon et le thème en vigueur. Modifier le brouillon affiche chaque couleur pour le clair et le sombre avec le contraste de chaque paire qu’elle forme, et n’enregistre pas une paire sous son minimum. Aperçu affiche le brouillon sur chaque écran de l’onglet de votre navigateur jusqu’à ce que vous appuyiez de nouveau dessus ; personne d’autre ne le voit. Publier et Restaurer le thème précédent se trouvent sur le même écran. L’icône et le logo se trouvent dans Paramètres du serveur > Icône et logo.

  • Lorsque vous enregistrez et lorsque vous publiez, le serveur vérifie la forme et la plage des valeurs et le contraste de chaque paire de jetons de couleur (les jetons que vous ne surchargez pas utilisent leurs valeurs par défaut ; WCAG 2.2 AA en clair comme en sombre). Si une vérification échoue, rien n’est enregistré ni publié.

  • Une surcharge d’un jeton qu’une nouvelle version renomme ou retire, ou dont la valeur ne convient plus au jeton, ne fait jamais échouer une mise à niveau. Elle reste dans l’ensemble enregistré mais ne s’applique plus : l’API d’administration la liste sous stale_tokens, my instance theme get la nomme, et le prochain enregistrement du brouillon l’abandonne.

  • La feuille de style de la révision publiée est servie à /theme/{revision ID}.css (immutable, mise en cache longtemps). La coquille HTML a un cache partagé (60 secondes plus 300 secondes de revalidation) ; il faut donc quelques minutes après la publication pour que tout le monde l’obtienne. Une page déjà ouverte garde l’ancien aspect jusqu’à son rechargement.

  • <meta name="theme-color"> (clair et sombre) dans la coquille et theme_color / background_color (clair) du Web App Manifest prennent la valeur du color-surface du thème. La version HTML de chaque e-mail que le serveur envoie à partir de là utilise les couleurs du thème publié, claires et sombres ; un brouillon n’atteint jamais l’e-mail.

  • Publier un ensemble sans jetons réinitialise le thème à la valeur par défaut, et la feuille de style n’est plus chargée.

  • Vous pouvez le modifier avec l’API cliente et avec la CLI. L’API cliente exige la permission de rôle manage_settings : GET /api/v1/admin/theme lit le brouillon et l’ensemble en vigueur, PUT /api/v1/admin/theme/draft enregistre le brouillon, GET /api/v1/admin/theme/draft/stylesheet renvoie la feuille de style du brouillon pour l’aperçu, et POST /api/v1/admin/theme/publish et POST /api/v1/admin/theme/restore publient. Les publications sont enregistrées dans le journal d’audit (setting_changed, cible theme).

Fenêtre de terminal
my instance theme get > theme.json # print the draft as the same JSON as the admin API (-published: the set in effect)
my instance theme set < theme.json # save the whole draft (if a check fails, it prints why and changes nothing)
my instance theme publish # publish the draft
my instance theme restore # publish again the set in effect before the current one
echo '{"tokens":[]}' | my instance theme set && my instance theme publish # back to the default
{
"tokens": [
{ "token": "color-accent", "light": "#ff8a80", "dark": "#ff8a80" },
{ "token": "radius-control", "value": "0.25rem" }
]
}

Outre la miniature et l’image d’aperçu, l’instance peut avoir sa propre icône, son logo et son logo sombre, chacun téléversé sous forme d’un SVG. Tant qu’aucun n’est défini, les images mycroblog intégrées sont utilisées, et en effacer un ramène l’image intégrée.

Image Forme Où elle apparaît
icon Carrée (à 1 % près) Le favicon, l’icône d’écran d’accueil d’iOS (apple-touch-icon), les icônes de l’application installée (Web App Manifest), la carte du serveur sur la page d’accueil et à côté de son nom dans le panneau latéral du client web, et partout où un client montre le serveur sous forme d’image carrée
logo De 1 à 8 fois plus large que haut L’en-tête du client web et le haut des pages de connexion, d’inscription et de consentement à la place du logotype intégré et du nom du serveur (le logo doit contenir le nom, qui est son texte alternatif), la version HTML de chaque e-mail, et l’image d’aperçu de lien lorsque preview_image n’est pas défini
logo_dark Comme logo Les fonds sombres ; sans lui, logo y est utilisé aussi
  • Le serveur assainit le SVG. Il le lit comme du XML et écrit un nouveau document à partir des seuls éléments autorisés (formes, groupes, defs, symbol, use, dégradés, clipPath, mask, pattern, style, title, desc) et attributs (géométrie, transformations, attributs de présentation, id, class, style). Les scripts, foreignObject, les images intégrées, les liens, les animations, les filtres (ombres et flous), les gestionnaires d’événements, les références à tout ce qui est hors du fichier et les URL data: sont retirés, et la réponse liste ce qui a été retiré. Seul le SVG assaini est stocké.
  • Un SVG est refusé (rien n’est enregistré) lorsqu’il n’est pas du XML bien formé en UTF-8, a un DOCTYPE ou des déclarations d’entités, n’a pas de viewBox, dépasse 256 KiB (128 KiB après assainissement), a plus de 5 000 éléments, est imbriqué sur plus de 32 niveaux, a plus de 200 éléments use, a une forme erronée pour son type, contient du text (convertissez d’abord le texte en contours dans votre éditeur), ou a du CSS qui pourrait charger quelque chose (@import, @font-face, url() autre que url(#id), échappements). @media (prefers-color-scheme: dark) dans un <style> est autorisé, afin qu’une icône puisse changer en mode sombre.
  • Certains endroits n’acceptent pas le SVG (l’écran d’accueil d’iOS, les favicons de Safari plus anciens, les aperçus de liens, les e-mails). Pour eux, le client qui téléverse le SVG dessine aussi des versions PNG à partir du SVG assaini et les envoie avec lui : 32, 48, 180, 192 et 512 px et une icône « maskable » de 512 px pour icon ; un logo d’e-mail de 96 px de haut et une image d’aperçu de lien de 1200 × 630 pour logo ; un logo d’e-mail de 96 px de haut pour logo_dark. Le serveur vérifie que chacun est un PNG de la bonne taille (1 MiB au plus ; l’icône de 180 px, l’icône maskable et l’aperçu de lien doivent être opaques) et l’écrit de nouveau sans métadonnées. Si un fichier est incorrect, rien n’est enregistré. Les versions opaques de l’icône sont dessinées sur une couleur de fond, #rrggbb, qui est par défaut le color-surface clair du thème. Le serveur ne vérifie pas que les versions PNG montrent la même image que le SVG.
  • Les fichiers sont stockés dans le stockage de blobs sous instance/brand/<revision>/ et servis à https://<host>/brand/<revision>/<version>.svg|.png avec Cache-Control: public, max-age=31536000, immutable, puisque le contenu d’une révision ne change jamais. Un SVG est servi avec Content-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandbox et X-Content-Type-Options: nosniff, de sorte que même ouvert seul il n’exécute rien et ne charge rien. Les fichiers des révisions antérieures restent, afin que les e-mails déjà envoyés conservent leur logo.
  • Avec une icône définie, la coquille HTML lie ses favicons PNG, son SVG et son apple-touch-icon de 180 px, le Web App Manifest liste ses icônes de 512 px, 192 px, maskable et SVG dans cet ordre (les autres serveurs du fédivers prennent la première comme icône de ce serveur), et /apple-touch-icon.png renvoie la version de 180 px. L’ETag de la coquille change avec les images, et le cache partagé de la coquille dure quelques minutes comme avec le thème. Une application installée prend une nouvelle icône sur Android lorsque Chrome vérifie ensuite le manifeste ; sur les ordinateurs, l’application garde son ancienne icône jusqu’à ce qu’elle soit installée de nouveau.
  • GET /api/v1/instance renvoie icon, logo et logo_dark avec l’URL du SVG, l’URL et la taille de chaque version PNG, et la révision ; chacun est omis tant que l’image intégrée est utilisée.
  • Définissez-les dans le client web sous Paramètres du serveur > Icône et logo (/admin/settings/branding, permission de rôle manage_settings). Choisissez un fichier SVG pour l’icône, le logo ou le logo pour les fonds sombres : le serveur le vérifie aussitôt, et le formulaire le montre tel que le serveur le conserverait, avec la liste de ce que le serveur a retiré. Si le serveur refuse le fichier, la raison s’affiche dessous avec la façon de la corriger. Pour l’icône, définissez là aussi la couleur de fond de ses versions opaques. Enregistrer dessine les versions PNG dans le navigateur et envoie chaque image choisie avec elles ; Utiliser l’image intégrée ramène une image à l’image intégrée lorsque vous enregistrez. Le client web conserve les images qu’il a affichées pour un usage hors ligne.
  • L’API cliente fait de même, avec la permission de rôle manage_settings : POST /api/v1/admin/instance/brand/sanitize vérifie un SVG et renvoie le SVG assaini avec les versions PNG à dessiner (il n’enregistre rien), PUT /api/v1/admin/instance/brand/{icon|logo|logo_dark} enregistre le SVG avec chaque version PNG (multipart/form-data, une partie par version), DELETE sur le même chemin en efface un, et GET /api/v1/admin/instance/brand renvoie les images actuelles avec la couleur de fond de l’icône. Chaque changement est conservé comme révision (instance_brand_revisions) et enregistré dans le journal d’audit (setting_changed, cible brand_icon, brand_logo ou brand_logo_dark).
  • La CLI ne peut pas les définir, puisque les versions PNG sont dessinées par le client, mais elle peut les afficher et effacer une image cassée :
Fenêtre de terminal
my instance brand show # each image with its revision, when and by whom it was set, and the URL of its SVG
my instance brand clear icon # back to the built-in icon (also logo, logo_dark)

Les émojis personnalisés locaux sont affichés comme des images lorsque quelqu’un écrit :shortcode: dans le corps ou l’avertissement de contenu d’une publication, ou dans le nom d’affichage, la bio ou les champs du profil. Ils parviennent aussi à Mastodon, Misskey, GoToSocial et Akkoma par la balise Emoji des Notes et des acteurs que vous envoyez.

  • Un shortcode compte de 2 à 30 lettres, chiffres ou _. Il est sensible à la casse et ne peut pas être modifié après l’enregistrement de l’émoji. Des alias (jusqu’à 10) et une catégorie (jusqu’à 64 caractères) servent à la recherche et au regroupement dans le sélecteur d’émojis.
  • L’image est PNG, GIF ou WebP, de custom_emoji_max_bytes au plus (256 KiB par défaut) et de 1 024 px au plus de chaque côté. Le serveur fabrique des dérivés qui tiennent dans des cases de 64, 128 et 256 px et ne conserve pas l’original. Un APNG devient une image fixe de sa première image. GoToSocial ne récupère par défaut pas les émojis de plus de 100 KiB ; de petites images sont donc recommandées.
  • Un émoji désactivé n’apparaît nulle part (publications, profils, fédération, sélecteur), et :shortcode: s’affiche de nouveau comme du texte. Un émoji configuré pour être masqué du sélecteur manque seulement au sélecteur et peut toujours être utilisé en l’écrivant. Un émoji venu d’un autre serveur ne peut qu’être désactivé ou copié comme un émoji de ce serveur.
  • Copier récupère l’image de l’émoji d’un autre serveur sous les mêmes limites que le proxy de médias (les images des domaines avec reject_media ne sont pas récupérées), exécute les mêmes vérifications que ci-dessus, et l’enregistre comme un nouvel émoji local. Le shortcode est celui de l’original ou celui que vous donnez. L’image est réduite à la case de 256 px, et une image qui ne peut pas être récupérée ou qui échoue aux vérifications ne laisse rien derrière elle.
  • La suppression ne peut pas être annulée. Les émojis des publications passées redeviennent aussi du texte, et enregistrer de nouveau le même shortcode crée un émoji différent. Les images que des serveurs fédérés ont copiées ne peuvent pas être supprimées.
  • L’écran d’administration (« Émojis personnalisés », /admin/custom-emojis), l’API cliente (/api/v1/admin/custom_emojis) et la CLI font les mêmes choses. Sur l’écran, « Enregistrer un émoji » ouvre le formulaire d’enregistrement (/admin/custom-emojis/new), qui avertit d’une image de plus de 100 KiB, et choisir un émoji dans la liste ouvre sa page (/admin/custom-emojis/{id}), où vous l’activez ou le désactivez, remplacez son image, changez sa catégorie, ses alias et sa visibilité dans le sélecteur, le supprimez après avoir saisi son shortcode, ou en copiez un d’un autre serveur. L’écran d’administration et l’API cliente exigent la permission de rôle manage_custom_emojis (seul le rôle intégré admin l’a). L’enregistrement, la copie, le remplacement de l’image, la modification des paramètres et des alias, l’activation et la désactivation, et la suppression sont enregistrés dans le journal d’audit (cible custom_emoji) quelle que soit la façon dont ils sont faits (une opération depuis la CLI est enregistrée comme une opération de la CLI).
Fenêtre de terminal
my admin emoji create -shortcode blobcat -category Cats -alias neko blobcat.png # register one
my admin emoji list -local # list local emoji, newest first
my admin emoji update -category Animals -alias cat -alias neko <emoji id> # change the category and aliases (aliases are replaced; -no-aliases removes them)
my admin emoji update -hidden <emoji id> # hide it from the picker (-hidden=false restores it)
my admin emoji replace-image <emoji id> blobcat2.png # replace the image
my admin emoji disable <emoji id> # disable it (remote emoji too)
my admin emoji enable <emoji id> # enable it again
my admin emoji list -remote -domain mastodon.example # list emoji of another server
my admin emoji copy [-shortcode <name>] <emoji id> # copy a remote emoji to local
my admin emoji delete <emoji id> # delete it
my admin emoji requests list [-state pending|approved|rejected|withdrawn|lapsed|all] # list creation requests (pending by default)
my admin emoji requests approve <request id> # approve a request
my admin emoji requests reject [-reason <text>] <request id> # reject a request (the requester sees the reason)
  • Un utilisateur avec la permission de rôle create_custom_emojis (une fonction utilisateur) peut demander la création d’un émoji depuis « Émojis personnalisés » dans les paramètres (/settings/custom-emojis), modifier les alias, la catégorie et la visibilité dans le sélecteur des émojis qu’il a créés, et les supprimer ; la page indique combien de demandes il lui reste ce mois-ci. Remplacer une image est aussi une demande, faite avec l’API cliente (POST /api/v1/custom_emoji_requests, kind image) ; la page des paramètres ne la propose pas. Une demande n’apparaît nulle part (sélecteur, publications, réactions, fédération) tant que quelqu’un avec manage_custom_emojis ne l’a pas approuvée. Approuvez-la ou rejetez-la sur la page « Demandes » de « Émojis personnalisés » de l’écran d’administration (/admin/custom-emojis/requests), avec l’API cliente (/api/v1/admin/custom_emoji_requests), ou avec la CLI ci-dessus. Les personnes avec manage_custom_emojis sont notifiées d’une demande (admin_custom_emoji_request), et le demandeur est notifié de l’approbation ou du rejet. La demande, le retrait, l’approbation et le rejet sont enregistrés dans le journal d’audit (cible custom_emoji_request).
  • Une demande de création en attente réserve son shortcode. Une demande ou un enregistrement avec le même shortcode n’est pas possible tant que celle en attente n’est pas rejetée ou retirée. L’image d’un émoji approuvé est copiée comme un téléversement de l’acteur de l’instance, de sorte qu’elle subsiste même si le compte du demandeur est supprimé.
  • Un créateur ne peut modifier ses émojis que tant qu’il détient create_custom_emojis. Les émojis restent si le rôle est retiré. Les administrateurs peuvent modifier et supprimer chaque émoji quel que soit le créateur.
  • Lorsque le rôle provient d’une formule de soutien, le nombre d’émojis qu’un utilisateur peut créer chaque mois est limité par la limite mensuelle d’émojis de la formule. Elle compte les demandes de création que l’utilisateur a soumises dans le mois calendaire en cours (UTC) qui sont approuvées ou en attente ; les demandes rejetées et retirées ne comptent pas, et supprimer un émoji ne libère pas de place. Une demande compte dans le mois où elle a été soumise, même si elle est approuvée le suivant. Le compte se réinitialise à 00:00 UTC le premier jour de chaque mois, et la page des paramètres indique à l’utilisateur quand, dans son propre fuseau horaire. Remplacer l’image d’un émoji, et les émojis que les administrateurs enregistrent, ne comptent pas. Un rôle qu’un administrateur a attribué à la main, et un serveur où les soutiens sont désactivés, n’ont aucune limite.

Pour les LLM et les agents de programmation :llms.txt,llms-full.txt, llms-small.txt

Mesure d’audience de ce site