{
  "$type": "site.standard.document",
  "bskyPostRef": {
    "cid": "bafyreid25ilfrtz2d66hm4aorgskeweebucvtxwa65psx74br5nbjfskj4",
    "uri": "at://did:plc:qnlvqxxf6yadvrhl226p2aiz/app.bsky.feed.post/3mmtrizxxypx2"
  },
  "coverImage": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreictddl2r5himrvjjay3cg66mwrwmc7hm2ledkgek5oj5tq56glz7u"
    },
    "mimeType": "image/png",
    "size": 301928
  },
  "description": "Homarr nos da la posibilidad de organizar nuestros servicios de forma cómoda gracias a su interfaz web, pudiendo tener nuestro propio dashboard.",
  "path": "/organiza-tu-homelab-con-homarr-dashboard/",
  "publishedAt": "2026-05-27T15:00:04.000Z",
  "site": "https://blog.runesoft.net",
  "tags": [
    "Homepage",
    "documentación oficial",
    "Portainer",
    "documentación oficial de integraciones",
    "guía para Immich",
    "Getting started | Homarr documentation",
    "Homelab Dashboard with Homarr"
  ],
  "textContent": "Uno de los servicios más simples y útiles para un homelab es un dashboard. Hommarr, al igual que Homepage, es otro gran candidato para este rol.\n\nPermite una gran configuración, todo desde la sencillez de la interfaz web, sin necesidad de manipular archivos de configuración.\n\nAdemás, acepta múltiples usuarios, por lo que cada miembro podría tener su propia página, o podrías hacer alguna pública, para que sea accesible sin necesidad de loguear.\n\n# Requisitos\n\nPara proceder con esta guía, necesitarás lo siguiente:\n\n  * Un entorno con Docker instalado y al menos 256MB de RAM disponibles.\n  * Un cliente web para poder realizar la configuración.\n\n\n\n# Instalar Homarr\n\nEsta aplicación acepta multitud de formas de instalarse, tienes todas en su documentación oficial. Pero de todas ellas, la que seguiremos en este post, al igual que en otros muchos servicios, es mediante Docker.\n\nLa forma más sencilla usando Docker, es mediante un fichero `docker-compose.yml`, que ya reúne todo lo necesario para que el contenedor funcione como se espera. Este fichero lo proveen en su documentación si lo prefieres, pero te dejo aquí el cómo lo he configurado yo utilizando claves en `.env` para ocultarlas adecuadamente.\n\nAdemás de esto, podemos lanzarlo como contenedor _standalone_ , o incluso usando los _stacks_ de Portainer.\n\n## Docker compose\n\nEsta es la vía más cómoda y sencilla. Lo primero que haremos será crear una carpeta para nuestra aplicación:\n\n\n    mkdir ~/homarr\n    cd ~/homarr\n\n\nDentro de esta, crearemos nuestro fichero `docker-compose.yml` con el siguiente contenido:\n\n\n    services:\n      homarr:\n        container_name: homarr\n        image: ghcr.io/homarr-labs/homarr:latest\n        restart: unless-stopped\n        volumes:\n          - /var/run/docker.sock:/var/run/docker.sock # Integracion Docker (opt)\n          - ./appdata:/appdata\n        env_file:\n          - .env\n        ports:\n          - '7575:7575'\n\n\nAhora deberemos generar la clave secreta de encriptado y depositarla en nuestro fichero `env`, para ello, ejecutamos:\n\n\n    echo \"SECRET_ENCRYPTION_KEY=$(openssl rand -hex 32)\" > .env\n\n\nAhora, tan solo tendremos que lanzar nuestro compose:\n\n\n    sudo docker compose up -d\n\n\n# Docker Standalone\n\nSimilar al _Docker Compose_ , pero sin un fichero que lo defina. Al igual que antes, deberemos generar nuestra ruta y la clave de encriptado:\n\n\n    export BASE_PATH=\"${HOME}/homarr2/data\"\n    mkdir -p \"$BASE_PATH\"\n    export SECRET_KEY=$(openssl rand -hex 32)\n\n\nAhora que ya tenemos nuestra ruta base y la clave generada, podremos ejecutar nuestro contenedor, lanzando el siguiente comando:\n\n\n    docker run \\\n      --name homarr2 \\\n      --restart unless-stopped \\\n      -p 7576:7575 \\\n      -v /var/run/docker.sock:/var/run/docker.sock \\\n      -v \"${BASE_PATH}:/appdata\" \\\n      -e \"SECRET_ENCRYPTION_KEY=${SECRET_KEY}\" \\\n      -d ghcr.io/homarr-labs/homarr:latest\n\n\n## Portainer Stack\n\nEste es, al fin y al cabo, igual al Docker compose pero haciendo uso de la interfaz de **Portainer**. Accedemos a nuestra instancia, nos vamos al menú de _Stacks_ , y ahí le damos a uno nuevo. Deberemos rellenarlo con lo siguiente:\n\n\n    services:\n      homarr:\n        container_name: homarr\n        image: ghcr.io/homarr-labs/homarr:latest\n        restart: unless-stopped\n        volumes:\n          - /var/run/docker.sock:/var/run/docker.sock # Integracion Docker (opt)\n          - ./appdata:/appdata\n        environment:\n          - SECRET_ENCRYPTION_KEY=${SECRET_KEY}\n        ports:\n          - '7575:7575'\n\n\nDe forma que quede de la siguiente manera:\n\nAdicionalmente, antes de darle a desplegar, deberemos proporcionar la variable de entorno pertinente con la clave de encriptado. Esta la podemos generar desde cualquier entorno Linux que dispongamos, por ejemplo, desde la terminal, y luego copiarla. El comando es:\n\n\n    openssl rand -hex 32\n\nY con esto lo introducimos como variable nueva de entorno llamada `SECRET_KEY`, como se indica en la siguiente imagen:\n\nAhora sí que podremos desplegarlo sin problema desde **Portaienr**.\n\n# Configuración inicial\n\nCon nuestro contenedor levantado sin problemas, tendremos que acceder a la dirección: `ip.server.homarr:7575` para realizar la configuración inicial. Debería aparecernos el siguiente formulario, en el que podremos elegir el idioma, el tema, y cómo queremos realizar dicha configuración:\n\nAl tratarse de una nueva instancia, le daremos a _Empezar de cero._ Entonces nos saldrá el formulario para dar de alta el primer usuario que además tendrá rol de administrador:\n\nTras darle a _Crear usuario_ , podremos elegir entre diferentes opciones de privacidad y comportamiento de Homarr, aquí seleccionar las que os convengan, en mi caso las he dejado como sigue:\n\nDándole a _Continuar_ , nos saldrá una lista de opciones. Le daremos a _Crea tu primer tablero_ para comenzar a crear nuestro dashboard personalizado:\n\n## Creando tableros\n\nLos tableros son los propios Dashboards en si, donde podremos crear nuestros links e integraciones que provee Homarr, y se puede gestionar todo ello desde su interfaz web. Si hemos seguido los pasos anteriores, nos habrá llevado a la siguiente página:\n\nAquí es donde se nos da la opción de crear nuestro nuevo tablero, haciendo clic en el botón de _Nuevo Tablero_ en la esquina superior derecha. Esto nos desplegará un pequeño formulario para nombrarlo, elegir cuántas columnas tendrá, y si será público:\n\nℹ️\n\nEl hacer un tablero público, significará que será visible sin necesidad de loguear con un usuario válido en Homarr.\n\nLas opciones anteriores se pueden modificar si fuera necesario aunque ya lo hayamos creado. Una vez rellenado, le damos a _Crear_ , y nos aparecerá en la lista:\n\nLe damos a _Abrir tablero_ , y desde la interfaz que nos sale, es desde donde se nos permitirá crear los diferentes _widgets_ y aplicaciones. Para ello, clicamos sobre el botón del lápiz en la parte superior derecha para activar el modo de edición, y entonces nos aparecerá un nuevo icono de un `+`, le clicamos y nos despliega una serie de opciones:\n\nSi de todas ellas, seleccionamos _Nuevo elemento_ , nos saldrá una inmensa lista con todas las opciones:\n\n## Integraciones\n\nHay algunas preconfiguradas ya para que extraigan información relevante, como el caso de los DNS como Pi-Hole o Adguard Home. Puedes ver todas las opciones en su documentación oficial de integraciones.\n\n### Estadísticas Docker\n\nPero hay una muy cómoda, que es la de Docker, que la podemos encontrar si buscamos _docker_ en la barra de búsqueda:\n\nCon tan solo agregarla, nos dará un widget con la información de los contenedores que estén activos en el anfitrion sobre el que está lanzado Homarr:\n\nAdemás de sus nombres y estadísticas de uso, también nos da la posibilidad de pararlos o reiniciarlos si fuera necesario, algo muy cómodo para un Dashboard.\n\n### Immich\n\nOtro muy bueno es el de Immich, que primero deberemos configurar nuestro token adecuadamente tal y como nos solicitan en su guía para Immich.\n\nY tendría el siguiente aspecto:\n\nTambién cuenta con otra integración de Immich que permite visualizar un álbum de imágenes concreto del usuario que hayamos usado para generar dicha integración.\n\n# Conclusión\n\nAhora podemos contar con otra opción más para gestionar nuestro dashboard del homelab, teniendo incluso estadísticas de nuestros servicios y otras integraciones muy cómodas; todo ello fácilmente actualizable desde su interfaz web, sin necesidad de manipular ficheros `yaml` o similares.\n\nEn este ámbito, como en muchos otros, hay diversas opciones para un propósito similar, es normal que a veces dudemos entre un servicio u otro, pero no te equivocarás en ninguno mientras cubra lo que necesites.\n\n# Referencias\n\n  * Documentación oficial: Getting started | Homarr documentation\n  * Anterior post (Inglés): Homelab Dashboard with Homarr\n\n\n\n# Vídeo\n\n0:00\n\n/1:49\n\n1×",
  "title": "Organiza tu Homelab con Homarr Dashboard",
  "updatedAt": "2026-05-27T15:00:04.536Z"
}