Cómo instalar HomeDock OS en Linux: Método oficial

HomeDock OS | Linux | Docker

HomeDock OS: instalación self-hosted en Linux

Guía paso a paso para instalar HomeDock OS en Debian 12+, Ubuntu 22.02+ y otros sistemas Linux usando el instalador oficial.

¿Qué es HomeDock OS?


HomeDock OS es una plataforma self-hosted pensada para ejecutar y administrar servicios en tu propio servidor, máquina virtual o equipo dedicado. Su objetivo es facilitar la puesta en marcha de un entorno personal de aplicaciones, centralizando el acceso desde una interfaz web.

En Linux, HomeDock OS se instala mediante un script oficial que prepara las dependencias necesarias, configura Docker, crea un entorno Python y deja el sistema preparado para arrancar automáticamente mediante un servicio persistente.

Filosofía de HomeDock OS: convertir un servidor Linux en una plataforma sencilla para gestionar aplicaciones autoalojadas, reduciendo la complejidad técnica habitual de Docker, Python, servicios systemd y configuración inicial.

Características principales

Instalación automatizada

Un único comando prepara dependencias, Docker, entorno Python y servicio del sistema.

Orientado a self-hosting

Permite ejecutar servicios en hardware propio, VPS o máquina virtual.

Basado en Docker

Utiliza contenedores para desplegar aplicaciones y servicios de forma aislada.

Servicio persistente

Configura systemd para facilitar reinicio automático y arranque tras reboot.

Interfaz web

El acceso se realiza desde navegador usando el hostname o la IP del servidor.

Soporte SSL opcional

Puede detectar certificados SSL si se colocan en la ruta esperada del sistema.

Requisitos previos

Para una instalación self-hosted en Linux, la documentación oficial recomienda este método especialmente para servidores dedicados o máquinas virtuales cloud.

  • Sistema recomendado: Debian 12+ o Ubuntu 22.02+
  • También probado: Debian 13 Trixie
  • Permisos: usuario con sudo o acceso root
  • Conexión: acceso a Internet para descargar dependencias
  • Uso recomendado: servidor dedicado, VPS o máquina virtual
Recomendación: antes de instalar, utiliza un sistema limpio o revisa si ya tienes Docker y servicios similares configurados para evitar conflictos de puertos o dependencias.

Instalación rápida en Debian 12+ / Ubuntu 22.02+

Paso 1: Actualizar el sistema

Antes de lanzar el instalador, actualiza los repositorios y paquetes principales del sistema:

sudo apt update sudo apt upgrade -y

Paso 2: Ejecutar el instalador oficial

HomeDock OS proporciona un instalador rápido para Debian y Ubuntu:

curl -fsSL https://get.homedock.cloud | sudo bash

Este script se encarga automáticamente de:

  • Instalar dependencias necesarias como git, python3, venv, pip, docker y docker-compose
  • Crear un entorno virtual de Python
  • Configurar y habilitar un servicio persistente con systemd
  • Lanzar HomeDock OS desde la propia CLI para permitir reinicio y autoarranque posterior
Advertencia: el comando descarga y ejecuta un script remoto con privilegios elevados. En entornos productivos conviene revisar el script antes de ejecutarlo.

Acceso a la interfaz web

Cuando la instalación finalice, accede a HomeDock OS desde el navegador usando el hostname configurado o la IP del servidor:

http://IP_DEL_SERVIDOR

Las credenciales por defecto indicadas en la documentación son:

user / passwd
Importante: cambia la contraseña después del primer inicio de sesión y configura correctamente el hostname del servidor.

Indicaciones especiales para Ubuntu 23.x+

En versiones Ubuntu 23.x, la documentación indica que puede ser necesario actualizar las fuentes de repositorios antiguos antes de instalar. Esto aplica a versiones como Ubuntu 23.10 o similares.

Actualizar repositorios antiguos

sudo sed -i 's|http://archive.ubuntu.com/ubuntu|http://old-releases.ubuntu.com/ubuntu|g' /etc/apt/sources.list sudo sed -i 's|http://security.ubuntu.com/ubuntu|http://old-releases.ubuntu.com/ubuntu|g' /etc/apt/sources.list sudo apt update

Ejecutar instalación

curl -fsSL https://get.homedock.cloud | sudo bash
Precaución: esta sección está pensada para versiones Ubuntu 23.x. Si estás usando Debian 12+ o Ubuntu 22.02+, normalmente puedes usar directamente el instalador rápido.

Instalación en otras distribuciones Linux

Si utilizas Fedora, Arch, Alpine u otra distribución no probada oficialmente, puedes intentar usar el instalador estándar. El script incluye lógica de fallback para gestores de paquetes comunes y puede funcionar con advertencias.

Instalador estándar

curl -fsSL https://get.homedock.cloud | sudo bash

Si el instalador automático no funciona, puedes realizar una instalación manual.

Paso 1: Clonar el repositorio

git clone https://github.com/BansheeTech/HomeDockOS.git cd HomeDockOS

Paso 2: Instalar paquetes necesarios

El sistema debe incluir:

  • python3
  • python3-venv
  • python3-pip
  • docker
  • docker-compose
  • git

Ejemplo en Fedora

sudo dnf install git python3 python3-virtualenv python3-pip docker docker-compose

Paso 3: Crear entorno Python

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

Paso 4: Iniciar la aplicación

python3 homedock.py

Paso 5: Acceder a la interfaz

Accede desde el navegador usando el dominio configurado o la IP del servidor.

http://IP_DEL_SERVIDOR

Certificados SSL / HTTPS

HomeDock OS permite usar certificados SSL de forma opcional. Para ello, coloca los certificados en la ruta esperada:

/DATA/SSLCerts/fullchain.pem /DATA/SSLCerts/privkey.pem

Al iniciar, HomeDock OS detectará estos certificados y los aplicará automáticamente.

Consejo: si usas Let's Encrypt, puedes crear un hook de renovación que copie automáticamente los certificados renovados dentro de /DATA/SSLCerts.

Gestión básica tras la instalación

Comprobar contenedores Docker

docker ps

Comprobar servicios systemd relacionados

systemctl list-units --type=service | grep -i homedock

Ver logs del sistema

journalctl -u homedock -f

Reiniciar el servicio

sudo systemctl restart homedock

Comprobar estado

sudo systemctl status homedock --no-pager -l
Nota: el nombre exacto del servicio puede variar según la versión instalada. Si el comando no devuelve resultados, revisa los servicios disponibles con systemctl list-units.

Logs y soporte

Si necesitas revisar errores o enviar información al soporte, la documentación indica que en Linux los logs se encuentran en:

~/HomeDockOS/logs/*

También puedes acudir al soporte oficial o al servidor de Discord de HomeDock OS si necesitas ayuda adicional.

Casos de uso

  • Servidor doméstico: centralizar aplicaciones personales en un único equipo
  • VPS self-hosted: ejecutar servicios propios en una máquina cloud
  • Homelab: probar aplicaciones, contenedores y servicios web
  • Pequeñas oficinas: alojar herramientas internas sin depender de SaaS externos
  • Laboratorio Docker: aprender despliegue y administración de servicios contenerizados
  • Entorno con HTTPS: usar certificados propios o Let's Encrypt para acceso seguro

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Comenta...