Temas en Proxmox: ¿qué sobrevive a las actualizaciones?

Sí, puedes hacer que Proxmox parezca una sala de control cyberpunk, una consola UniFi, Dracula, Tokyo Night o casi cualquier estilo visual que permita CSS. Solo ten en cuenta que los temas personalizados no son una función con soporte oficial en Proxmox, algo que empieza a importar en cuanto pasa la novedad inicial.

Un tema personalizado parece inofensivo porque altera colores, fondos, gráficas, logotipos y tipografía, sin tocar para nada el almacenamiento ni la red. Sin embargo, muchos temas del lado del servidor funcionan modificando archivos instalados por los paquetes de Proxmox. Cualquier actualización futura puede sustituir esos archivos, eliminar la personalización o romper supuestos que el tema hacía sobre la estructura anterior de la interfaz.

Los proyectos modernos de la comunidad gestionan ese ciclo de vida mucho mejor que antes, aunque pensar que "solo es CSS" sigue sin ser un plan operativo adecuado.

¿De verdad se puede cambiar el tema de Proxmox VE?

Sí, pero la palabra "tema" puede significar dos cosas muy distintas. Proxmox VE ya cuenta con un selector oficial de Color Theme. La interfaz web puede adaptarse a la preferencia del navegador o utilizar los estilos claro y oscuro compatibles de Proxmox. Esa es la opción segura, ya que vienen integrados con el producto.

Los temas comunitarios van bastante más lejos. Pueden sustituir la paleta de color al completo, rediseñar tarjetas y menús de navegación, alterar los colores de las gráficas y las fuentes, añadir marcas personalizadas y hacer que la interfaz parezca un producto totalmente diferente.

Un experimento reciente con temática cyberpunk demostró por qué esto sorprende a tantos administradores. Modificó tanto la interfaz habitual de Proxmox que la reacción generalizada fue: "No sabía que se pudiera hacer esto en Proxmox".

El creador comentó que construyó el diseño con ayuda de IA en aproximadamente una hora, tras probar primero el concepto sobre una instalación de Cockpit. Cambiar los colores básicos resultó sencillo. Lo complicado fue lograr que el encabezado y otras partes de la interfaz existente encajaran bien, lo que describe a la perfección el desafío. Cuando aplicas un tema a una interfaz de administración madura, estás adaptando el HTML de otra persona, componentes ExtJS, jerarquías de CSS, gráficas, espacios, iconos y ciclos de actualización, lo que exige mucho más que elegir un tono violeta neón.

Para entender el contexto general de la plataforma, en el Mr.PlanB Proxmox hub tratamos los aspectos que importan mucho más que la apariencia en cuanto el laboratorio pasa a ser infraestructura de verdad.

¿Admite Proxmox oficialmente los temas personalizados?

No. El equipo de Proxmox ha dejado claro en reiteradas ocasiones que el soporte oficial de personalización visual se limita a las opciones integradas en el sistema.

En un debate de soporte en 2025, un miembro del equipo de Proxmox respondió a una consulta sobre temas de terceros indicando que no existía soporte más allá del modo oscuro nativo. Otro colaborador con experiencia explicó el motivo: proyectos como PVEDiscordDark funcionan instalando archivos propios y parcheando los archivos web originales de PVE.

Por tanto, el tema depende de que la estructura interna de la interfaz web siga siendo compatible. Si Proxmox cambia el nombre de una clase, reubica una plantilla, modifica un componente JavaScript o actualiza el conjunto de herramientas de widgets, el tema puede romperse visual o funcionalmente.

Esto no significa que los temas de la comunidad sean malos, pero debes verlos como modificaciones personalizadas no soportadas. Muchos sistemas de código abierto funcionan igual: el código y los recursos están accesibles, por lo que puedes cambiar casi cualquier cosa, pero eso no convierte cada cambio en un punto de extensión oficial.

¿Por qué desaparecen a veces los temas personalizados tras actualizar?

Las actualizaciones de paquetes pueden sobrescribir los archivos que modificó el tema. Los proyectos de temas más antiguos para Proxmox a menudo obligaban a ejecutar el instalador de nuevo cada vez que se actualizaba pve-manager o paquetes similares de la interfaz. PVEDiscordDark, por ejemplo, documenta en sus instrucciones que es necesario relanzar el comando de instalación tras actualizar Proxmox porque los archivos implicados se reemplazan.

Esa misma duda apareció enseguida con el tema cyberpunk. Un usuario veterano recordó que experimentó con temas años atrás y los abandonó en parte porque cada actualización borraba los cambios.

Imagina que un tema edita un archivo dentro de /usr/share/pve-manager/ o /usr/share/javascript/proxmox-widget-toolkit/. Esas rutas pertenecen a paquetes instalados. Cuando APT instala una versión más reciente, restaura las versiones originales del proveedor, y tu tema desaparece, se desconfigura o se aplica sobre una estructura para la que nunca fue probado. Un tema que hoy se ve impecable sigue necesitando una estrategia clara de actualización.

¿Cómo logra ProxMorph que los temas sean más persistentes?

ProxMorph integra la persistencia de las actualizaciones directamente en su sistema de temas, para que no tengas que recordarlo manualmente. Actualmente es compatible con Proxmox VE 8.x y 9.x, Proxmox Backup Server 3.x y 4.x, y Proxmox Datacenter Manager 1.x. Ofrece 23 temas distribuidos en varias colecciones, como Catppuccin, Dracula, Nord, Gruvbox, Solarized, Tokyo Night, UniFi, GitHub Dark y Blue Slate.

El proceso de instalación importa más que la cantidad de temas disponibles. ProxMorph copia los archivos CSS dentro del conjunto de widgets de Proxmox, parchea el mapa de temas para que las nuevas opciones aparezcan en el selector nativo de Color Theme, inyecta el JavaScript o CSS necesario para gráficas y elementos específicos de la interfaz, e instala un hook en APT. Ese hook se encarga de volver a aplicar los parches locales después de cada actualización relevante de Proxmox. La actualización puede sobrescribir los archivos, pero el sistema de temas intenta parchear de inmediato las copias nuevas. Eso es mucho más práctico que pedirle al administrador que recuerde ejecutar un comando tras cada actualización.

Además, ProxMorph realiza una copia de seguridad de los archivos originales antes de modificarlos y proporciona un comando de desinstalación para restaurarlos. Valoro esas dos funciones por encima del acabado visual. Una personalización es mucho más fácil de justificar cuando ya sabes con certeza cómo se recupera tras las actualizaciones y cómo se retira si da problemas.

¿Forma parte ProxMorph del producto oficial de Proxmox?

No. Se integra dentro del selector nativo de temas de Proxmox, pero sigue siendo un proyecto independiente desarrollado por la comunidad. Una vez instalado, el tema aparece en el menú desplegable habitual de Color Theme, por lo que a ojos del usuario parece nativo. Por debajo, el instalador sigue modificando archivos del sistema.

Su documentación es muy transparente al respecto. Detalla con precisión qué cambia, dónde se copia el CSS, cómo se modifica el mapa de temas, qué plantillas de inicio se tocan, dónde reside el hook de actualización y dónde se guardan las copias de seguridad. Eso es justo lo que se espera de una utilidad de este tipo.

El instalador se ejecuta como root, así que no dejes que la idea de que "solo es un tema" te impida examinar el script. ProxMorph publica manifiestos SHA256 y procedencia de compilación para sus versiones, y su documentación recomienda expresamente revisar install.sh antes de lanzarlo. Es una recomendación sensata para cualquier script de la comunidad que pienses ejecutar en un hipervisor.

¿Conviene personalizar la interfaz de un servidor Proxmox en producción?

No necesariamente. El nivel de riesgo aceptable depende de cómo esté implementado el tema. La postura más conservadora sostiene que la consola de administración es una herramienta operativa de trabajo, por lo que cambiar su aspecto aporta poco valor al negocio y añade una pieza móvil extra. Varios administradores reaccionaron así: si el clúster es infraestructura crítica de producción, prefieren no alterar la interfaz.

La postura opuesta también tiene argumentos válidos. Un tema CSS dista mucho de modificar Ceph, corosync, módulos del kernel o el almacenamiento de las VMs. Hay organizaciones que utilizan marcas personalizadas, logotipos de arranque, esquemas de color o diferencias visuales entre entornos sin ningún problema.

Esa diferenciación visual incluso puede ser útil en las operaciones diarias. Si producción usa un tono rojo oscuro, preproducción es azul y el clúster de laboratorio es violeta cyberpunk, resulta mucho más difícil equivocarse de entorno. Esto solo funciona si la personalización se mantiene predecible en el tiempo.

Recomiendo aplicar tres reglas básicas:

1. El tema debe poder desinstalarse con facilidad.
2. Los archivos originales deben ser totalmente recuperables.
3. Las actualizaciones de Proxmox no deben depender jamás de que el tema siga siendo compatible.

Si la interfaz web deja de responder tras una actualización, deberías sentirte cómodo administrando el host mediante SSH y retirando la modificación sin estrés.

Un chequeo como el Proxmox Health Check no evaluará tu combinación de colores, pero es un buen recordatorio de que conviene consolidar la salud operativa del clúster antes de dedicar tiempo a su aspecto visual.

¿Resulta más seguro aplicar temas en el navegador?

Sí, si lo único que buscas es un cambio de aspecto. Una propuesta habitual en la comunidad de Proxmox consiste en aplicar CSS personalizado mediante una extensión del navegador como Stylus, dejando intactos los archivos del servidor. La personalización reside exclusivamente en el cliente y Proxmox se mantiene inalterado. Si el tema falla, basta con desactivar la hoja de estilos. Si un administrador quiere neón cyberpunk y otro prefiere la interfaz estándar, ambos obtienen lo que desean.

Un tema del lado del navegador todavía puede romperse cuando Proxmox modifica su estructura DOM o sus clases CSS, pero cualquier error se limita al navegador y nunca afecta al servidor de administración. Por esa razón resulta especialmente adecuado para producción.

La desventaja es que el tema depende de cada navegador en lugar de acompañar al clúster, y algunos componentes dinámicos como las gráficas pueden requerir algo más que simple CSS. Los proyectos instalados en el servidor logran un acabado más completo y uniforme. Es una cuestión de equilibrar comodidad y cobertura frente a aislamiento.

¿Cuál es la forma más prudente de probar un tema personalizado?

Trátalo como cualquier otra modificación no crítica y asegúrate de que sea fácil de revertir. Una secuencia prudente sería:

1. Confirmar que el acceso por SSH funciona antes de alterar la interfaz web.
2. Hacer copia de seguridad de cualquier archivo que el tema vaya a modificar.
3. Leer el instalador en lugar de canalizar un script desconocido directamente a una shell de root.
4. Preferir una versión etiquetada o un commit específico en vez de una rama en desarrollo continuo.
5. Probar primero en un nodo secundario o en un entorno de laboratorio.
6. Aplicar el tema.
7. Verificar el inicio de sesión, la consola, las vistas de almacenamiento, las vistas de backup, las gráficas, las tareas y la visualización en pantallas móviles.
8. Ejecutar una actualización ordinaria de Proxmox.
9. Comprobar que la interfaz sigue funcionando correctamente tras actualizar.
10. Probar el proceso de desinstalación o reversión antes de olvidar cómo funciona.

Muchos usuarios suelen saltarse la prueba de actualización. No sabes realmente si un tema funciona hasta comprobar qué sucede cuando se reemplazan los paquetes que modificó.

Personalizar Proxmox es fácil, pero mantenerlo requiere trabajo

El experimento cyberpunk demuestra lo rápido que el CSS moderno con ayuda de IA puede generar un impacto visual notable. Eso simplifica la experimentación, pero el mantenimiento posterior sigue siendo necesario.

Los temas claro y oscuro oficiales de Proxmox cuentan con soporte pleno, por lo que cualquier añadido adicional debe considerarse una capa personalizada que tendrá que adaptarse a los cambios de la interfaz web.

Si solo buscas otros colores, el CSS en el cliente es la opción con menos riesgo. Si prefieres un tema uniforme y pulido en todo el sistema, un proyecto como ProxMorph resulta más interesante porque se integra en el selector nativo, documenta lo que altera, guarda copias de seguridad y reaplica parches automáticamente tras cada actualización.

Y si decides crear tu propia interfaz cyberpunk, adelante. Solo asegúrate de que el procedimiento para revertirla sea mucho menos emocionante que el propio tema.