Instalación con Docker en Linux
Cómo instalar el facturador en un servidor Ubuntu 24.04 con el script de instalación. Es la forma recomendada para producción.
Antes de empezar
- Acceso a su servidor (VPS, máquina virtual o equipo local) por SSH. Puede usar PuTTY o WinSCP.
- Su dominio apuntando a la IP del servidor:
- Un registro A con la IP del servidor.
- Un registro CNAME con el nombre
*, para que funcionen los subdominios de cada empresa.
- Si el servidor tiene MySQL, Apache o Nginx instalados, deténgalos: ocupan los puertos que usarán los contenedores de Docker.
- Su usuario y contraseña (o token) de GitLab, para clonar el repositorio.
Pasos
-
Ingrese al servidor por SSH y cambie al superusuario:
sudo su -
Descargue y ejecute el script de instalación:
curl https://git.buho.la/-/snippets/81/raw/main/install.sh -o install.sh && chmod +x install.sh && ./install.sh -
Ingrese el dominio: el mismo que configuró en el DNS.
-
Ingrese el número de servicio:
-
Si es la primera instalación en este servidor, presione Enter (se usa el número 1).

-
Si el servidor ya tiene otros facturadores, ingrese el número siguiente al último instalado.

-
-
En la primera instalación, el script actualiza el sistema y descarga los programas necesarios. Puede tardar varios minutos.
-
Cuando lo pida, ingrese su usuario y contraseña de GitLab para clonar el repositorio. Si los datos están mal, la instalación falla y hay que volver a ejecutar el script.
-
Elija si desea instalar el SSL gratuito:
- s (sí): responda y a las dos preguntas que siguen. El script mostrará un código que debe agregar en su DNS como registro TXT con el nombre
_acme-challenge.[su dominio]. - n (no): la instalación continúa, pero los navegadores mostrarán una advertencia por falta de HTTPS. Puede instalarlo después con Instalar o actualizar el SSL.
El certificado gratuito dura 90 días y hay que renovarlo antes de que venza.
- s (sí): responda y a las dos preguntas que siguen. El script mostrará un código que debe agregar en su DNS como registro TXT con el nombre
-
Al terminar, el script muestra los datos de su facturador: ruta del proyecto, URL de acceso, correo y contraseña del administrador, contraseña de MySQL y clave SSH. También quedan guardados en un archivo de texto:
cat [su dominio].txt
Guarde estos datos
El archivo [su dominio].txt contiene las contraseñas del administrador y de MySQL. Cópielas en un lugar seguro.
Cómo verificar
-
Todos los contenedores deben estar en estado Up:
docker ps -
Abra la URL de acceso en el navegador e inicie sesión con el correo y la contraseña del administrador.
Si algo sale mal
| Síntoma | Qué hacer |
|---|---|
| Falla al clonar el repositorio | Revise su usuario y contraseña de GitLab y vuelva a ejecutar el script. |
| El dominio no abre | Compruebe que el registro A apunte a la IP del servidor, en whatsmydns.net. |
| Algún contenedor no está en Up | Errores de los contenedores. |