Skip to main content

​
Introducción

Esta guía explica el proceso para descargar e instalar el sistema facturador en máquinas con sistema operativo Ubuntu utilizando Docker. El proceso es simple y automatizado mediante un script de instalación.
Docker proporciona un entorno aislado y consistente que facilita la implementación y ejecución del facturador sin interferir con otras aplicaciones de tu servidor.

​
Requisitos previos

Antes de comenzar la instalación, asegúrate de cumplir con los siguientes requisitos:
Necesitas tener acceso a tu servidor, VPS, máquina virtual o entorno local mediante SSH. Puedes utilizar herramientas como Putty o WinSCP para facilitar la conexión remota.
Tu dominio debe estar correctamente configurado y apuntando a la IP de tu servidor:
  • Configura el registro A con la dirección IP de tu servidor
  • Añade un registro CNAME con valor ”*” para habilitar los subdominios que utilizará la aplicación
Si en tu servidor tienes servicios que están utilizando MySQL, Apache o Nginx, deberás detenerlos ya que ocupan los puertos que usará el facturador con los contenedores de Docker.

​
Proceso de instalación

Sigue estos pasos para instalar el facturador en tu servidor Linux:

​
1. Acceder como superusuario

Conéctate a tu servidor mediante SSH y obtén privilegios de superusuario: 
sudo su

​
2. Ejecutar el script de instalación

Ejecuta el siguiente comando en la terminal para descargar y ejecutar el script de instalación: 
curl https://gitlab.buho.la/-/snippets/14/raw/main/install.sh -o install.sh && chmod +x install.sh && ./install.sh

​
3. Configuración del sistema

Durante la ejecución del script, se te solicitará ingresar la siguiente información:
1

Configurar dominio

Ingresa el dominio que configuraste previamente en los registros DNS.
2

Número de servicio

  • Si es tu primera instalación, presiona Enter para utilizar el valor predeterminado (1)
  • Si ya tienes otros proyectos instalados, ingresa el número correlativo siguiente
Selección de número de servicio
3

Seleccionar versión

Elige la versión del facturador que deseas instalar:
  • Pro6 [1]
  • ProX [2]
Selección de versión del facturador
4

Clonar repositorio

El sistema te pedirá tus credenciales de acceso al repositorio. Verifica que ingreses correctamente usuario y contraseña para evitar errores durante la instalación.
5

Configurar SSL

Se te preguntará si deseas instalar un certificado SSL gratuito (Let’s Encrypt):
  • Si respondes “s” (Sí): Deberás confirmar dos preguntas adicionales con “y”. El sistema te mostrará un código que deberás añadir como registro TXT con el nombre _acme-challenge.tudominio.com en tu panel DNS.
  • Si respondes “n” (No): La instalación continuará sin SSL. Ten en cuenta que los navegadores modernos mostrarán advertencias por falta de HTTPS.
Los certificados SSL gratuitos deben renovarse cada 90 días. El sistema te notificará cuando sea necesario.

​
4. Finalización

Al completar la instalación, el sistema mostrará información importante sobre tu facturador:
  • Ruta del proyecto en el servidor
  • URL de acceso al facturador
  • Correo electrónico del administrador
  • Contraseña de acceso
  • Contraseña para acceder a MySQL
  • Clave SSH
Toda esta información se guarda automáticamente en un archivo de texto para futuras referencias. Puedes acceder a él en cualquier momento con el siguiente comando:
cat [tu-dominio].txt

​
Acceso al sistema

Una vez finalizada la instalación, puedes acceder al facturador a través de la URL proporcionada durante el proceso. Utiliza las credenciales indicadas para iniciar sesión como administrador.

​
Administración de Docker

Gestión de contenedores

Una vez instalado el sistema, puedes administrar los contenedores Docker con los comandos estándar como docker ps, docker logs y docker-compose.

Mantenimiento

Para actualizaciones y mantenimiento, asegúrate de realizar copias de seguridad regulares de tus datos y configuraciones.

​
Solución de problemas comunes

Si experimentas errores de permisos, asegúrate de estar ejecutando los comandos como superusuario (sudo su).
Verifica que no haya otros servicios utilizando los puertos 80, 443 o 3306 antes de la instalación.
Revisa la configuración de la base de datos en el archivo de credenciales y asegúrate de que el contenedor de MySQL esté funcionando correctamente.
Si elegiste instalar SSL pero no configuraste correctamente el registro TXT, puedes reintentar el proceso ejecutando el comando de renovación de certificados.

​
Recursos adicionales

Documentación Docker

Consulta la documentación oficial de Docker para aprender más sobre la gestión de contenedores.

Soporte técnico

Si necesitas ayuda adicional, contacta con nuestro equipo de soporte técnico.