Actualizar o migrar el sistema
¿Qué guía necesitas?
| Situación | Guía |
|---|---|
| Ya tienes Pro 9 y quieres la última versión | Actualización estándar (en esta página) |
| Tienes Pro 7 y quieres pasar a Pro 9 en el mismo servidor | Migrar de Pro 7 a Pro 9 |
| Quieres llevar toda la instalación Docker a un servidor nuevo | Migración de servidor con Docker |
| Quieres llevar bases de datos y archivos a un facturador ya instalado en otro servidor | Migración con respaldos SQL |
⚠️ Antes de cualquier actualización o migración, genera un respaldo de la base de datos y de la carpeta
storage. Ver Generar copias de seguridad.
📋 Pre Requisitos
Antes de comenzar, asegúrate de tener:
- ✅ Acceso SSH al servidor
- ✅ Credenciales válidas de GitLab (usuario y token)
- ✅ Permisos para ejecutar comandos Docker
- ✅ Un respaldo reciente de la base de datos y de
storage
1. Conexión al Servidor
1.1 Acceso por SSH
ssh [usuario]@[ip]
1.2 Verificar contenedores activos
docker ps
1.3 Acceder al contenedor FPM
docker exec -it [nombre_contenedor_fpm] /bin/bash
2. Preparación del Entorno
💡 Tip: Antes de actualizar, siempre revisa si tienes cambios locales para evitar conflictos.
2.1 Verificar estado del repositorio
git status
2.2 Guardar cambios locales (si los hay)
git stash
2.3 Verificar la URL del repositorio remoto
git remote -v
Si la URL no es correcta, actualízala:
git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro9.git
3. Actualización Estándar
Para usuarios que ya tienen Pro 9 instalado.
3.1 Descargar cambios
git pull origin main
ℹ️ Nota: Si se solicitan credenciales, ingresa tu usuario y token de GitLab.
3.2 Recuperar cambios guardados (si aplicaste stash)
git stash apply
3.3 Aplicar migraciones y optimizaciones
Puedes ejecutar los comandos individualmente:
php artisan migrate
php artisan tenancy:migrate
php artisan config:cache
php artisan cache:clear
php artisan optimize:clear
O ejecutarlos en una sola línea:
php artisan migrate && php artisan tenancy:migrate && php artisan config:cache && php artisan cache:clear && php artisan optimize:clear
4. Migración de Pro 7 a Pro 9
⚠️ Importante: Debes tener una suscripción activa para realizar esta migración. Si tu suscripción no está vigente, contacta al área comercial antes de continuar.
Pasar de Pro 7 a Pro 9 cambia la versión de PHP, las imágenes Docker y las dependencias, así que no basta con un git pull. Sigue la guía completa: