Personaliza el tema y la imagen de marca de Element Web.
Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.
Para una implementación autohospedada de Element Web, configure el nombre de la aplicación y el tema predeterminado en su archivo config.json, y luego use las brandingopciones documentadas para el logotipo de inicio de sesión, el fondo, el enlace del logotipo y los enlaces del pie de página. Para colores personalizados, defina un tema en setting_defaults.custom_themesy haga referencia default_themea su custom-nombre. Estas configuraciones personalizan Element, pero no lo convierten en un producto de marca blanca completo.
La configuración de Element separa la identidad del producto, los temas de color y los recursos de la página. Elige el cambio más pequeño que te permita alcanzar tu objetivo:
| Objetivo | Configuración | Lo que cambia |
|---|---|---|
| Mostrar el nombre de su servicio | brand | Nombre de la aplicación en varias cadenas y ubicaciones |
| Establece un tema de inicio claro, oscuro o personalizado. | default_theme | Tema de color predeterminado para la implementación |
| Cambiar la apariencia de inicio de sesión y bienvenida | branding | Logotipo de la página de autenticación, fondo, enlace al logotipo y enlaces al pie de página |
| Configura colores y fuentes personalizadas. | setting_defaults.custom_themes | Opciones de tema como marcadores de color y familias de fuentes |
Verificado: La documentación de Element indica que admite cierta personalización, pero no un cambio de marca completo ni una marca privada. Implicación práctica: los cambios brandno reemplazarán todos los logotipos, iconos, imágenes ni referencias de productos. Si necesita modificar todos los elementos visuales y textos, deberá mantener una versión personalizada y revisarla después de las actualizaciones. Comience por enumerar los elementos de la interfaz de usuario que sus usuarios necesitan ver antes de optar por un enfoque basado únicamente en la configuración.
Element Web se ejecuta config.jsonal iniciar. Realice una copia de seguridad del archivo actual y edítelo directamente para conservar la configuración necesaria, como el servidor de inicio predeterminado. Para un archivo tarball de lanzamiento, el archivo se encuentra en el directorio web desplegado; el paquete Debian utiliza /etc/element-web/config.json. Con Docker, monte su configuración en /app/config.json. La ubicación correcta depende de cómo instaló Element, así que verifique su método de despliegue antes de editar.
Agregue las siguientes claves al objeto JSON existente, combinándolas con cualquier configuración ya presente. No copie y pegue esto como reemplazo de toda la configuración:
{
"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" }
]
}
}
Reemplaza el nombre de ejemplo, los nombres de host y los recursos con los tuyos. brandCambia el nombre de la aplicación en varios lugares; permalink_prefixhace que los enlaces permanentes compartidos apunten a tu implementación de Element en lugar de matrix.to. Las entradas del logotipo y del fondo son URL cargadas por el navegador. Sírvelas a través de HTTPS desde una ubicación a la que tus usuarios puedan acceder y confirma que los controles de acceso, la política de seguridad de contenido y el almacenamiento en caché no las bloqueen. La documentación no especifica un tamaño de imagen universal para el logotipo de autenticación, así que previsualiza tu recurso real en lugar de asumir una dimensión fija.
Depende del despliegue: un archivo de configuración afecta a la instancia web de Element que lo sirve. No modifica el app.element.ioservicio oficial ni las aplicaciones móviles o de escritorio independientes de Element. Realice la edición en el host o contenedor que aloja su propia instancia.
Para un tema de color y fuente simple, Element documenta las definiciones de temas personalizados dentro de setting_defaults.custom_themes. El nombre interno del tema tiene el prefijo custom-; use ese nombre completo en default_theme. Este ejemplo muestra un tema personalizado compacto. Es un punto de partida, no una paleta completa:
{
"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"
}
}
]
}
}
Integra estas claves en tu JSON existente en lugar de crear un segundo setting_defaultsobjeto. Mantén el contraste entre texto, fondos y controles legible tanto en estado normal como resaltado. La referencia del tema del elemento incluye colores opcionales adicionales, matrices de colores para nombre de usuario y avatar, fuentes personalizadas y tokens de diseño compuesto. Agrega solo los valores que hayas revisado en la referencia actual; una paleta incompleta puede dejar algunas partes de la interfaz usando valores predeterminados.
Un error común: la configuración default_themeelige el tema predeterminado de la implementación; la documentación no lo describe como una política que bloquea la configuración de apariencia de todos los usuarios. Si necesita un tema de aplicación estricta, verifique ese comportamiento con la versión exacta de Element Web que utiliza, en lugar de asumir que el tema predeterminado es un bloqueo.
Para realizar una prueba de tema en tiempo de ejecución, las notas de Element describen cómo cargar una URL de tema JSON desde /devtoolsla sección "Temas personalizados". Considere esto como un flujo de trabajo de prueba o del lado del usuario, no como un sustituto de la implementación de la configuración prevista para todos los clientes. Para una implementación mantenible, mantenga la configuración y los recursos bajo control de versiones y repita esta verificación al actualizar Element Web.
El comportamiento descrito aquí se ajusta a la documentación oficial de configuración y temas de Element Web, revisada el 10 de octubre de 2026. Consulte las referencias correspondientes a su versión instalada antes de basarse en una configuración: Referencia de configuración de Element Web , Documentación de temas de Element Web y Documentación de instalación de Element Web .
Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.
Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.
Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.
Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.
Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.
Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.
Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.
Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.
Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.
Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.