Cómo instalar Homepage en Saplo (panel de control de inicio)

Quien instala más de una aplicación en un Box, tarde o temprano pierde el rumbo de dónde está n8n, dónde está el panel de Uptime Kuma y dónde está Grafana del cliente. La solución es una única página de inicio con una lista de enlaces que abres en lugar de buscar una pestaña en el navegador. Homepage hace exactamente eso, como un panel de control de código abierto que puedes instalar en tu propio Box sin base de datos y sin factura mensual. A continuación, te explicamos paso a paso cómo instalar Homepage en Saplo.

Por qué Homepage en lugar de marcadores del navegador

Los marcadores del navegador funcionan mientras el número de aplicaciones sea pequeño y las abras todas desde un único ordenador. El problema surge cuando:

• Las aplicaciones aumentan: una agencia con varios clientes y algunas herramientas internas (n8n, monitorización, panel CMS) alcanza rápidamente una docena de direcciones que hay que recordar o guardar.
• Más de una persona utiliza las herramientas: los marcadores del navegador privado no ayudarán al equipo, cada uno debe recibir la lista de direcciones por separado y, si se cambia el dominio, hay que volver a enviarla.

Homepage lo resuelve como un único contenedor Docker en tu Box: una página con enlaces que proporcionas a todos los miembros del equipo, sin límite en el número de aplicaciones y sin ningún coste aparte del propio Box.

Requisitos

Para instalar Homepage en Saplo, necesitas:

• Un Box con Docker activado (el motor lo activa automáticamente al instalar desde el catálogo, se requiere anidamiento en el contenedor, lo cual Saplo tiene por defecto),
• Un mínimo de 512 MB de RAM libre en el Box y 2 GB de espacio en disco, es decir, el plan Box S es suficiente,
• Un dominio o subdominio *.saploapp.pl incluido en el precio de cada plan, donde se alojará el panel de control,
• NO necesitas una base de datos separada, Homepage guarda toda la configuración en archivos YAML dentro del volumen de Docker.

Instalación paso a paso

1. En el panel de Saplo, ve al Catálogo de aplicaciones y selecciona Homepage (categoría "Negocios").
2. Indica la Box con un mínimo de 512 MB de RAM libre en la que se instalará el dashboard, y el Dominio o subdominio bajo el cual funcionará.
3. Confirma la instalación. El motor crea un contenedor a partir de la imagen oficial ghcr.io/gethomepage/homepage, lo expone exclusivamente al loopback de la Box y lo conecta a nginx, que lo sirve bajo el Dominio especificado con SSL gratuito. Solo el puerto 443 se expone al exterior, no el puerto 3000 sin procesar del contenedor.
4. Después de docker compose up, el motor también verifica si el dashboard responde realmente a HTTP en el endpoint /api/healthcheck, ya que el estado "contenedor en funcionamiento" no significa que el proceso interno no haya entrado en un bucle de reinicios un momento después.
5. Una vez finalizada la instalación, el panel de Homepage está disponible bajo el Dominio especificado, protegido por una contraseña generada automáticamente durante la instalación (guardada en el archivo SETUP en la Box).

Primera configuración

Homepage no tiene un asistente ni una cuenta de administrador, solo una autorización de una sola contraseña integrada, habilitada inmediatamente después de la instalación.

1. Accede a la dirección del dominio, por ejemplo, start.saploapp.pl, e inicia sesión con la contraseña del archivo HOMEPAGE-SETUP.txt en el Box.
2. Añade tus propios enlaces de aplicaciones manualmente en el archivo services.yaml en el volumen de configuración. Cada entrada es un nombre, una dirección y un icono opcional.
3. Los widgets de clima, el estado de los contenedores Docker o las estadísticas de otras herramientas se configuran en widgets.yaml, y los favoritos de sitios externos en bookmarks.yaml.
4. La apariencia y el diseño del panel (colores, número de columnas, fondo) se configuran en settings.yaml.
5. La integración con el socket Docker de Box está intencionadamente deshabilitada en Saplo, por lo que Homepage NO detecta automáticamente otros contenedores; cada aplicación se añade manualmente. Esta es la misma restricción que con cualquier otra receta en un Box compartido con otros clientes.

Homepage en Saplo vs. marcadores del navegador

Preguntas frecuentes

¿Homepage necesita una base de datos separada? No, toda la configuración reside en archivos YAML en el volumen de Docker, el motor de Saplo no implementa ningún contenedor de base de datos adicional para ello.

¿Homepage ve automáticamente otras aplicaciones en Box? No, la integración con el socket de Docker del host está desactivada intencionadamente por motivos de seguridad, ya que Box se comparte con otros clientes. Puedes añadir manualmente los enlaces a las aplicaciones en el archivo services.yaml.

¿Cómo cambio la contraseña del panel? Edita la variable HOMEPAGE_AUTH_PASSWORD en las opciones del contenedor en el panel de Saplo y reinicia la aplicación. La contraseña predeterminada es aleatoria y está guardada en el archivo HOMEPAGE-SETUP.txt en Box.

¿Tengo que instalar Docker yo mismo antes de configurar Homepage? No, el motor de Saplo instala Docker CE automáticamente con la primera instalación de cualquier aplicación en contenedor en un Box dado.

Si tienes varias aplicaciones en Box y quieres un único punto de inicio para todas ellas en lugar de buscar pestañas, escríbenos, te ayudaremos a elegir el Box adecuado para tu conjunto de herramientas.