Skip to main content

​
Introducción

En esta guía encontrarás las instrucciones completas para instalar la aplicación Mozo en un servidor con cPanel. El proceso incluye la creación del dominio, la conexión SSH y la configuración posterior a la instalación.

​
Requisitos previos

Antes de comenzar la instalación, asegúrate de contar con:

Compilado Mozo

Acceso al repositorio de Gitlab que contiene el compilado de la aplicación Mozo.

Cuenta cPanel

Credenciales de acceso a una cuenta cPanel con privilegios de administrador.

​
Proceso de instalación

Sigue estos pasos para realizar una instalación completa de Mozo en tu servidor cPanel:

​
1. Creación del dominio

1

Acceder a cPanel

Inicia sesión en tu cuenta de cPanel con tus credenciales de administrador.
2

Crear nuevo dominio

Navega a la sección Dominios > Crear un Nuevo Dominio en el panel de control.
3

Configurar el dominio

En la interfaz de creación de dominio:
  1. Ingresa el nombre del dominio que deseas utilizar para Mozo
  2. IMPORTANTE: Desmarca la casilla que aparece en la configuración
  3. Agrega public_html/ en el campo de nombre de carpeta
Interfaz de creación de dominio
Es fundamental desmarcar la casilla y agregar public_html/ en el nombre de la carpeta para que la instalación funcione correctamente.

​
2. Conexión SSH a cPanel

1

Obtener credenciales de conexión

Localiza el Usuario y la Dirección IP de tu cuenta cPanel para establecer la conexión SSH.Datos de conexión SSH
El nombre de usuario es el mismo que utilizas para ingresar a tu cuenta de cPanel.
2

Establecer conexión SSH

  1. Abre una terminal o símbolo del sistema (cmd) en tu computadora
  2. Ejecuta el siguiente comando SSH reemplazando los valores correspondientes:
ssh [Usuario]@[DirecciónIP]
Por ejemplo:
ssh [email protected]
Conexión SSH establecida
3

Navegar al directorio del dominio

Una vez conectado mediante SSH, accede a la carpeta del dominio que creaste:
cd public_html/demo.mozo
Ubicación en directorio del dominio
Reemplaza “demo.mozo” con el nombre de tu dominio en caso de ser diferente.

​
3. Instalación del compilado

1

Clonar el repositorio

Ejecuta el siguiente comando para clonar el repositorio de Mozo:
git clone https://gitlab.buho.la/mozo/compilado.git
2

Ingresar credenciales

Cuando se solicite, ingresa tus credenciales de acceso a GitLab para autorizar la descarga.Descarga del repositorio Mozo

​
4. Configuración post-instalación

1

Organizar archivos

  1. Regresa a tu panel de cPanel y navega a la sección de Dominios
  2. Accede al administrador de archivos y dirígete a la ruta de tu dominio
  3. Mueve todo el contenido de la carpeta compilado al directorio raíz de tu dominio
Mover archivos del compilado
Una vez hayas movido todos los archivos, puedes eliminar la carpeta compilado vacía para mantener organizado tu directorio.
2

Configurar archivo .htaccess

  1. Crea un nuevo archivo en la raíz de tu dominio y nómbralo .htaccess
Crear archivo htaccess
  1. Edita el archivo y agrega la siguiente configuración:
# Archivo necesario cuando publiques la app en apache y que funcione el SPA
<IfModule mod_rewrite.c>
RewriteEngine On

    # Condición: si el archivo o directorio solicitado no existe
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d

    # Redirigir todas las peticiones al index.html
    RewriteRule ^ index.html [L]
</IfModule>
Editar archivo htaccess
Esta configuración es esencial para que la aplicación SPA (Single Page Application) funcione correctamente en el servidor Apache.
3

Configurar archivo config.json

  1. Abre el archivo config.json ubicado en la raíz de tu dominio
  2. Verifica que la ruta principal esté correctamente configurada para tu entorno
Configuración del archivo config.json
  1. Guarda los cambios realizados y cierra el editor

​
Verificación de la instalación

Una vez completados todos los pasos de instalación, accede a tu dominio a través del navegador para verificar que la aplicación Mozo está funcionando correctamente.

Verificar conexión API

Asegúrate de que la aplicación Mozo pueda conectarse correctamente a la API del sistema de facturación.

Prueba de funcionalidades

Realiza una prueba de las funciones principales para confirmar que la instalación se completó exitosamente.

​
Solución de problemas comunes

Verifica que la URL de la API en el archivo config.json sea correcta y accesible desde el servidor donde está instalada la aplicación Mozo.
Si experimentas errores de rutas o la aplicación muestra pantallas en blanco, confirma que el archivo .htaccess está correctamente configurado.
Si después de mover los archivos no los ves reflejados, intenta actualizar el administrador de archivos o verifica los permisos de lectura y escritura.

​
Recursos adicionales

Documentación de Mozo

Consulta la documentación completa de la aplicación Mozo para conocer todas sus funcionalidades.

Soporte técnico

Si encuentras dificultades durante la instalación, contacta con nuestro equipo de soporte técnico.