Déploiement de Matrix Synapse avec Docker Compose et PostgreSQL
Configurez un serveur Synapse persistant avec Docker Compose, PostgreSQL, une configuration privée et des vérifications avant de l'exposer via HTTPS.
Pour un déploiement Element Web auto-hébergé, définissez le nom de l'application et le thème par défaut dans son fichier de configuration config.json, puis utilisez les brandingoptions documentées pour le logo de connexion, l'arrière-plan, le lien du logo et les liens du pied de page. Pour des couleurs personnalisées, définissez un thème dans les paramètres setting_defaults.custom_themeset indiquez default_themeson custom-nom. Ces paramètres personnalisent Element, mais ne le transforment pas en un produit entièrement personnalisable.
La configuration d'Element sépare l'identité du produit, les thèmes de couleurs et les ressources de la page. Choisissez la modification minimale qui répond à votre objectif :
| Objectif | Configuration | Ce qu'il change |
|---|---|---|
| Afficher le nom de votre service | brand | Nom de l'application dans différentes chaînes de caractères et à différents endroits |
| Choisissez un thème de démarrage clair, sombre ou personnalisé. | default_theme | Thème de couleurs par défaut pour le déploiement |
| Modifier l'identifiant et l'apparence de bienvenue | branding | Logo de la page d'authentification, arrière-plan, lien du logo et liens du pied de page |
| Définir des couleurs et des polices personnalisées | setting_defaults.custom_themes | Les options de thème, telles que les jetons de couleur et les familles de polices, sont des éléments importants. |
Vérifié : La documentation d’Element indique que la personnalisation est possible, mais pas le changement complet de marque ni l’utilisation d’une marque privée. Conséquence pratique : les modifications brandne remplaceront pas tous les logos, icônes, images ou références produits. Si vous souhaitez modifier tous les éléments visuels et textuels, prévoyez de maintenir une version personnalisée et de la vérifier après chaque mise à jour. Avant d’opter pour une configuration uniquement, commencez par lister précisément les éléments d’interface utilisateur que vos utilisateurs doivent voir.
Element Web est lu config.jsonau démarrage. Sauvegardez le fichier actuel et modifiez-le directement afin de conserver les paramètres nécessaires , comme le serveur d'accueil par défaut. Pour une archive tar.gz, le fichier se trouve dans le répertoire web déployé ; le paquet Debian utilise /etc/element-web/config.json`/etc/web.config .../app/config.json
Ajoutez les clés suivantes à l'objet JSON existant, en les combinant avec les paramètres déjà présents. Ne copiez pas ceci en remplacement de la configuration complète :
{
"brand": "Northstar Chat",
"default_theme": "dark",
"permalink_prefix": "https://chat.example.org",
"branding": {
"logo_link_url": "https://example.org",
"auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
"welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
"auth_footer_links": [
{ "text": "Help", "url": "https://example.org/help" },
{ "text": "Privacy", "url": "https://example.org/privacy" }
]
}
}
Remplacez le nom, les noms d'hôte et les ressources d'exemple par les vôtres. brandModifiez le nom de l'application à différents endroits ; permalink_prefixles permaliens partagés pointent désormais vers votre déploiement Element plutôt que vers l' matrix.toURL d'origine. Le logo et l'arrière-plan sont des URL chargées par le navigateur. Servez-les via HTTPS depuis un emplacement accessible à vos utilisateurs et assurez-vous que les contrôles d'accès, la politique de sécurité du contenu et la mise en cache ne les bloquent pas. La documentation ne spécifie pas de taille d'image universelle pour le logo d'authentification ; prévisualisez donc votre ressource plutôt que de supposer une dimension fixe.
Cela dépend du déploiement : un fichier de configuration affecte l’instance Element Web qui le héberge. Il ne modifie pas le app.element.ioservice officiel ni les applications mobiles ou de bureau Element. Effectuez la modification sur l’hôte ou le conteneur hébergeant votre instance.
Pour un thème de couleurs et de polices simple, Element documente les définitions de thèmes personnalisés dans `<template>` setting_defaults.custom_themes. Le nom interne du thème est préfixé par `<template> custom-` ; utilisez ce nom complet dans ` default_theme<template>`. Cet exemple présente un thème personnalisé compact. Il s'agit d'un point de départ, et non d'une palette complète.
{
"default_theme": "custom-Northstar",
"setting_defaults": {
"custom_themes": [
{
"name": "Northstar",
"is_dark": false,
"fonts": {
"general": "Inter, sans-serif",
"monospace": "'Courier New'"
},
"colors": {
"accent-color": "#3157A4",
"primary-color": "#3157A4",
"warning-color": "#B5473C",
"sidebar-color": "#202A3B",
"roomlist-background-color": "#F3F5F8",
"roomlist-text-color": "#202938",
"timeline-background-color": "#FFFFFF",
"timeline-text-color": "#202938"
}
}
]
}
}
Fusionnez ces clés avec votre JSON existant plutôt que de créer un second setting_defaultsobjet. Veillez à ce que le contraste entre le texte, les arrière-plans et les contrôles reste lisible, que l'élément soit en mode normal ou sélectionné. La documentation du thème d'Element inclut des couleurs optionnelles supplémentaires, des palettes de couleurs pour les noms d'utilisateur et les avatars, des polices personnalisées et des jetons de conception Compound. N'ajoutez que les valeurs que vous avez vérifiées dans la documentation actuelle ; une palette incomplète peut entraîner l'utilisation des valeurs par défaut pour certaines parties de l'interface.
Erreur fréquente : ce paramètre default_themedéfinit le thème par défaut du déploiement ; la documentation ne le décrit pas comme une politique qui verrouille les paramètres d’apparence de chaque utilisateur. Si vous avez besoin d’un thème imposé, vérifiez ce comportement avec la version exacte d’Element Web que vous utilisez au lieu de supposer que le thème par défaut est verrouillé.
Pour tester un thème en cours d'exécution, la documentation d'Element indique de charger une URL de thème JSON depuis /devtoolsla section « Thèmes personnalisés ». Il s'agit d'une méthode de test ou d'un processus côté utilisateur, et non d'un substitut au déploiement de la configuration prévue sur tous les clients. Pour un déploiement maintenable, conservez la configuration et les ressources sous contrôle de version et répétez cette vérification lors de la mise à jour d'Element Web.
Le comportement décrit ici suit la documentation officielle de configuration et de thèmes d'Element Web vérifiée le 10 octobre 2026. Consultez les références de votre version installée avant de vous fier à un paramètre : référence de configuration d'Element Web , documentation sur les thèmes d'Element Web et documentation d'installation d'Element Web .
Configurez un serveur Synapse persistant avec Docker Compose, PostgreSQL, une configuration privée et des vérifications avant de l'exposer via HTTPS.
Définissez un nom de marque, des couleurs personnalisées et des éléments de connexion pour votre déploiement Element Web tout en identifiant les éléments qui restent de marque Element.
Déterminez si Synapse a atteint sa limite de fichiers ouverts par processus, configurez un module systemd pour le service ou le processus approprié et vérifiez la limite en temps réel.
Déterminez si l'erreur est limitée à un navigateur ou à un événement, puis utilisez la clé de récupération d'Element ou un appareil de confiance sans risquer de perdre votre historique chiffré restant.
Utilisez les API d'historique et de purge multimédia de Synapse ou les paramètres de rétention pour supprimer les données obsolètes en toute sécurité, puis vérifiez l'achèvement de l'opération et la récupération de l'espace disque.
Installez la bibliothèque actuelle, connectez un compte Matrix dédié et exécutez un petit bot !echo avec une gestion des identifiants plus sûre et un test clair.
Configurez trois ponts Mautrix avec des enregistrements, des connexions et des tests distincts, et évitez ainsi les surprises liées au réseau Docker, aux politiques de compte et à la synchronisation.
Découvrez ce qui occupe l'espace de stockage de Synapse, définissez une durée de conservation des médias sécurisée et purgez le cache distant sans supprimer directement les fichiers du disque.
Consultez l'activité des appareils, désactivez les comptes Synapse inactifs confirmés via l'API d'administration et découvrez ce que supprime réellement l'option d'effacement.
Déterminez si la mémoire utilisée par PostgreSQL provient des requêtes, des tampons partagés, des connexions ou de la maintenance, puis apportez des modifications ciblées compatibles avec Synapse.