1. ¿Qué es Homarr?

Homarr es una solución de gestión centralizada que actúa como un panel personalizable para organizar, acceder y controlar todas tus aplicaciones y servicios en un solo lugar. Con una interfaz intuitiva y moderna, Homarr permite a los usuarios integrar aplicaciones autohospedadas, servicios en la nube y herramientas diversas de forma eficiente.

 

2. Requisitos previos

  • Tener acceso a internet.
  • Contar con una instalación previa de Docker.
  • Opcional - Contar con una instalación previa de Portainer.

 

3. Instalación por Docker Run

Para poder comenzar con la instalación de Homarr, es necesario estar conectados a la instancia de Ubuntu Server que cuenta con Docker instalado previamente.

Para ello, se deberá de abrir una terminal de powershell desde la que se accederá por SSH especificando el usuario administrador de la máquina y la dirección IP.

$ ssh Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.

 

Especificaremos las credenciales respectivas para acceder.

 

A continuación, procederemos a reemplazar en el siguiente comando los valores que se adapten a nuestra instancia.

$ docker run \
--name homarr \
--restart unless-stopped \
-p 7575:7575 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /opt/docker/homarr/configs:/app/data/configs \
-v /opt/docker/homarr/data:/data \
-v /opt/docker/homarr/icons:/app/public/icons \
-d ghcr.io/ajnart/homarr:latest

Reemplazar -v /opt/docker/homarr/ por la ruta que se quiera utilizar.

 

Una vez ejecutado, ya se tendrá Homarr desplegado.

 

4. Instalación por Docker Compose


Abre tu navegador web y accede a la web de Portainer ingresando la IP de tu servidor seguido del puerto que se tenga configurado.

$ https://<IP-Host>:9443/

 

Inicia sesión con tu usuario y contraseña.


En el panel de Portainer, dirígete al menú y haz clic en Stacks, pulsa el botón Add Stack (Agregar Stack) y configura el stack con Docker Compose
-En el campo Name (Nombre), introduce homarr.

 

-En el campo Web editor, copia y pega el siguiente archivo docker-compose.yml:

version: '3.8'
services:
    homarr:
        container_name: homarr
        image: ghcr.io/ajnart/homarr:latest
        restart: unless-stopped
        ports:
            - "7575:7575"
        volumes:
            - /var/run/docker.sock:/var/run/docker.sock
            - /opt/docker/homarr/configs:/app/data/configs
            - /opt/docker/homarr/data:/data
            - /opt/docker/homarr/icons:/app/public/icons

Verifica las rutas del host. Si /opt/docker/homarr/ no existe en tu servidor, créalo antes de continuar.

$ sudo mkdir -p /opt/docker/homarr/configs

 

$ sudo mkdir -p /opt/docker/homarr/data

 

$ sudo mkdir -p /opt/docker/homarr/icons

 

$ sudo chown -R usuario:usuario /opt/docker/

 

Despliega el stack, para ello, baja hasta la parte inferior de la página y haz clic en Deploy the Stack (Desplegar el Stack). Portainer descargará automáticamente la imagen de Homarr y creará el contenedor.


Una vez que el stack se haya desplegado correctamente, ve al menú de Portainer y haz clic en Containers (contenedores) y busca el contenedor homarr y asegúrate de que su estado sea running (en ejecución).

 

5. Inicializar Homarr

Abre tu navegador y accede a la siguiente URL (modificando <IP-Host> con los datos correspondientes):

$ http://<IP-Host>:7575/

 

Asignaremos las credenciales que se prefieran para el dashboard.

Para finalizar, se pulsará sobre "Go to your dashboard".

Ya dispondríamos del dashboard.