Manual técnico
Este manual es para quienes instalan, actualizan y mantienen el facturador en un servidor: desarrolladores, soporte técnico y administradores de sistemas. Si buscas cómo usar el facturador en el día a día, revisa el Manual del facturador.
¿Primera vez con un servidor del facturador? Empieza por Cómo funciona el facturador por dentro: qué contenedores hay, dónde están las bases de datos y los archivos, y qué tareas corren solas.
¿Buscas algo puntual?
Usa el buscador (Ctrl K) y escribe el problema o la tarea, por ejemplo inodes, backup o cambio de dominio.
Instalar el facturador
- Instalación con Docker en Linux: la forma recomendada para producción.
- Instalación en Windows o con Valet en Linux: para un entorno local de desarrollo.
- Instalar o actualizar el SSL y SSL automático con Cloudflare.
Actualizar o mover el sistema
- Actualizar o migrar el sistema: empieza aquí; te dice qué guía seguir según tu caso.
- Migrar de Pro 7 a Pro 9.
- Migración de servidor con Docker o con respaldos SQL.
Operar el servidor
- Conexión remota por SSH, con PuTTY o con WinSCP.
- Iniciar los servicios Docker, generar copias de seguridad y restaurar la base de datos.
- Acceso a la base de datos.
- Revisión diaria del servidor: contenedores, disco, memoria, logs, colas y SSL en cinco minutos.
- Parámetros del archivo .env, cambio de dominio y tareas programadas (cron).
Algo dejó de funcionar
| Síntoma | Guía |
|---|---|
| No space left on device con disco libre | Limpieza de inodes |
| El disco está lleno | Incrementar espacio en disco y eliminar temporales |
| Error 500 o pantalla en blanco | Habilitar modo debug para ver el error y limpiar la caché de Laravel |
Errores de permisos en storage |
Permisos y propietarios de archivos |
| Los reportes no terminan de descargarse | Descargas de reportes en cola |
| SUNAT no responde o tarda mucho | Servidor alterno de SUNAT |
| Los contenedores no levantan | Errores de los contenedores |
Falla php artisan migrate |
Error al ejecutar migraciones |
| El sistema va lento o se queda sin memoria | Recursos del servidor y recursos de PHP |
Más
- Documentación de la API: integrar otros sistemas con el facturador.
- Plantilla PDF personalizada.
- Plugin de WooCommerce.
- Publicar la app móvil en Google Play.
- Configuración SSH para git.buho.la y repositorio espejo en GitLab.