Saltar al contenido
Facturador

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

  1. Acceso a su servidor (VPS, máquina virtual o equipo local) por SSH. Puede usar PuTTY o WinSCP.
  2. 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.
  3. Si el servidor tiene MySQL, Apache o Nginx instalados, deténgalos: ocupan los puertos que usarán los contenedores de Docker.
  4. Su usuario y contraseña (o token) de GitLab, para clonar el repositorio.

Pasos

  1. Ingrese al servidor por SSH y cambie al superusuario:

    sudo su
    
  2. 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
    
  3. Ingrese el dominio: el mismo que configuró en el DNS.

  4. Ingrese el número de servicio:

    • Si es la primera instalación en este servidor, presione Enter (se usa el número 1).

      Primer número de servicio

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

      Número de servicio siguiente

  5. En la primera instalación, el script actualiza el sistema y descarga los programas necesarios. Puede tardar varios minutos.

  6. 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.

  7. 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.

  8. 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

  1. Todos los contenedores deben estar en estado Up:

    docker ps
    
  2. 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.