Saltar al contenido
softperu.pe

Cambio de Dominio

Esta guía explica cómo cambiar el dominio en una instalación activa del sistema de facturación utilizando Docker.

📋 Pre Requisitos

Antes de comenzar, asegúrese de tener:

  • Acceso SSH al servidor.
  • Permisos de superusuario (root).
  • El nuevo dominio configurado en su proveedor de DNS y apuntando a la IP pública del servidor.
  • Backup reciente de la base de datos central y de los tenants.

⚠️ Importante: Este proceso requiere detener temporalmente los servicios. Planifique el cambio en un horario de baja demanda.

Pasos para el Cambio de Dominio

1. Conexión al Servidor

Conéctese mediante SSH y acceda como superusuario:

ssh usuario@servidor
sudo su -

2. Navegar a la Carpeta del Proyecto

Acceda a la carpeta del facturador:

cd /ruta/facturador

3. Actualizar Archivo de Configuración .env

Edite el archivo de entorno:

nano .env

Modifique el parámetro APP_URL_BASE con el nuevo dominio:

APP_URL_BASE=nuevodominio.com

4. Actualizar Configuración de Docker Compose

Edite el archivo docker-compose.yml:

nano docker-compose.yml

Busque y modifique el parámetro VIRTUAL_HOST:

VIRTUAL_HOST: nuevodominio.com, *.nuevodominio.com

5. Reiniciar Servicios Docker

5.1 Detener los servicios del proyecto

docker compose down

5.2 Reiniciar el proxy

docker restart proxy_proxy_1

5.3 Iniciar los servicios del proyecto

docker compose up -d

6. Limpiar Caché del Sistema

Acceda al contenedor PHP-FPM:

docker exec -ti [nombre_contenedor_fpm] bash

Dentro del contenedor, ejecute:

php artisan config:clear
php artisan config:cache
php artisan cache:clear
php artisan optimize:clear
exit

7. Actualizar Base de Datos (Tenants Registrados)

Si existen clientes o empresas registradas previamente, actualice la tabla hostnames:

  1. Acceda a la base de datos de administración (system).
  2. Localice la tabla hostnames.
  3. Actualice el campo fqdn sustituyendo el dominio anterior por el nuevo para cada subdominio de cliente.

8. Configurar SSL

Si utiliza certificados SSL para el nuevo dominio, aplique la renovación con Certbot:

👉 Consulte el manual de Instalación y Actualización SSL.