Parámetros del archivo .env
El archivo .env está en la raíz del proyecto y guarda la configuración de la instalación: dominio, credenciales de base de datos y correo, servicios externos y opciones que activan o desactivan funciones.
La columna Valor en .env.example muestra el valor con el que se crea una instalación nueva. Si una variable no está en tu .env, el sistema usa su propio valor por defecto, que puede ser distinto.
⚠️ Después de modificar cualquier valor, regenera la caché de configuración, o el cambio no se aplicará:
php artisan config:clear
php artisan config:cache
En instalaciones Docker, ejecútalo dentro del contenedor fpm.
Aplicación y dominio
| Parámetro |
Descripción |
Valor en .env.example |
APP_NAME |
Nombre de la aplicación. |
Facturador |
APP_ENV |
Entorno de Laravel. En servidores debe ser production; local solo en la PC de desarrollo (con local queda expuesta la ruta /_dusk/login/{id}). |
production |
APP_KEY |
Clave de cifrado de la aplicación. Se genera con php artisan key:generate; no la cambies en una instalación con datos. |
— |
APP_DEBUG |
Muestra el detalle de los errores. Mantener en false en producción. Ver Habilitar modo debug. |
false |
APP_URL_BASE |
Dominio base del sistema, sin http:// ni barra final. Las empresas se crean como subdominios de este dominio. |
— |
PREFIX_URL |
Subdominio del administrador. Si se define (por ejemplo admin), el administrador queda en admin.APP_URL_BASE. |
sin definir |
APP_URL |
URL completa de la aplicación. Normalmente se deja como http://${APP_URL_BASE}. |
http://${APP_URL_BASE} |
FORCE_HTTPS |
Genera las URL en https y redirige HTTP → HTTPS. Recomendado cuando el dominio tiene SSL. |
false |
LOG_CHANNEL |
Forma de guardar los logs de Laravel. daily crea un archivo por día. |
daily |
Base de datos
| Parámetro |
Descripción |
Valor en .env.example |
DB_CONNECTION |
Conexión de la base central. No cambiar. |
system |
DB_HOST |
Servidor de MariaDB/MySQL. En Docker es el nombre del servicio de base de datos. |
127.0.0.1 |
DB_PORT |
Puerto de la base de datos. |
3306 |
DB_DATABASE |
Nombre de la base de datos central. |
tenancy |
DB_USERNAME |
Usuario de la base de datos. |
root |
DB_PASSWORD |
Contraseña del usuario de la base de datos. |
— |
PREFIX_DATABASE |
Prefijo de las bases de datos de cada empresa (tenancy_...). |
tenancy |
LIMIT_UUID_LENGTH_32 |
Limita a 32 caracteres los nombres de base y de usuario de cada empresa. Necesario en MySQL; no en MariaDB. |
true |
TENANCY_DATABASE_AUTO_DELETE |
Al eliminar una empresa, elimina también su base de datos. |
true |
TENANCY_DATABASE_AUTO_DELETE_USER |
Al eliminar una empresa, elimina también su usuario de base de datos. |
true |
Caché, colas y sesiones
| Parámetro |
Descripción |
Valor en .env.example |
CACHE_DRIVER |
Dónde se guarda la caché. |
redis |
QUEUE_CONNECTION |
Dónde se guardan los trabajos en cola (envíos, descargas de reportes). |
database |
SESSION_DRIVER |
Dónde se guardan las sesiones de usuario. |
file |
SESSION_LIFETIME |
Minutos de inactividad antes de cerrar la sesión. |
120 |
TENANT_SESSION_LIFETIME_ENABLED |
Permite que cada empresa configure su propio tiempo de sesión. |
true |
BROADCAST_DRIVER |
Driver de eventos en tiempo real. |
log |
REDIS_HOST |
Servidor de Redis. |
127.0.0.1 |
REDIS_PASSWORD |
Contraseña de Redis. |
null |
REDIS_PORT |
Puerto de Redis dentro del servidor o contenedor. |
6379 |
REDIS_PUBLIC_PORT |
Puerto de Redis publicado hacia fuera del servidor. Es el que usa BuhoPrinter para conectarse. |
6379 |
SOCKET_SERVER |
URL del servidor de sockets. |
http://localhost:8070 |
PUSHER_APP_ID, PUSHER_APP_KEY, PUSHER_APP_SECRET, PUSHER_APP_CLUSTER |
Credenciales de Pusher, si se usa para eventos en tiempo real. |
— / mt1 |
MIX_PUSHER_APP_KEY, MIX_PUSHER_APP_CLUSTER |
Copia de las credenciales de Pusher para el frontend. |
— |
Correo
| Parámetro |
Descripción |
Valor en .env.example |
MAIL_DRIVER |
Protocolo de envío (smtp, sendmail). |
smtp |
MAIL_HOST |
Servidor SMTP. |
smtp.gmail.com |
MAIL_PORT |
Puerto SMTP (465 con SSL, 587 con TLS). |
465 |
MAIL_USERNAME |
Correo de la cuenta que envía. |
— |
MAIL_PASSWORD |
Contraseña de aplicación de esa cuenta. |
— |
MAIL_ENCRYPTION |
Cifrado (ssl, tls). |
ssl |
TEMPLATE_DOCUMENT_MAIL |
Plantilla del correo con el que se envían los comprobantes. |
default |
Para que cada empresa use su propio correo, ver Correo emisor por empresa.
SUNAT, PSE y validación
| Parámetro |
Descripción |
Valor en .env.example |
SUNAT_ALTERNATE_SERVER |
Usa el servidor alterno de SUNAT. Ver Servidor alterno de SUNAT. |
false |
PSE_TIMEOUT |
Segundos máximos de espera por cada llamada al PSE (firma y envío). |
30 |
EMISSION_SLOW_LOG_MS |
Registra en el log las emisiones que tarden más de estos milisegundos, con el tiempo de cada paso. 0 lo desactiva. |
0 |
SIGNATURE_NOTE_OSE |
Texto de la nota de firma que va en el XML. |
FACTURALO |
SIGNATURE_URI_OSE |
Identificador de la firma en el XML. |
signatureFACTURALOPERU |
APIPERUDEV_VALIDATOR_CPE |
Muestra en el listado de comprobantes el validador de CPE de APIPERU.DEV. |
true |
VALIDATOR_CPE |
Muestra en el listado de comprobantes el validador de CPE alternativo. |
false |
CHANGE_TO_REGISTERED_STATUS |
Muestra el botón Cambiar a estado registrado en los comprobantes en estado Registrado. Pese al nombre, el botón los marca como Aceptado sin enviarlos a SUNAT; úsalo solo si el comprobante ya fue aceptado por otra vía. |
false |
Consulta de RUC y DNI
| Parámetro |
Descripción |
Valor en .env.example |
API_SERVICE_URL |
URL del servicio de consulta de RUC y DNI. |
https://apiperu.dev |
API_SERVICE_TOKEN |
Token del servicio de consulta. Ver Configuración de APIPERU.DEV. |
false |
ALLOW_CLIENT_USE_OWN_APIPERU_TOKEN |
Permite que cada empresa configure su propio token de APIPERU. Esas empresas dejan de usar el token general. |
false |
Comprobantes y ventas
| Parámetro |
Descripción |
Valor en .env.example |
DOCUMENT_TYPE_03_FILTER |
En boletas, al buscar el cliente solo muestra clientes con DNI. |
false |
SELECT_FIRST_DOCUMENT_TYPE_03 |
En el formulario de nuevo comprobante, selecciona la boleta como tipo por defecto. |
false |
DELETE_DOCUMENT_TYPE_03 |
Permite eliminar boletas desde el listado de comprobantes. |
false |
ENABLED_DISCOUNT_GLOBAL |
Activa el descuento global en los comprobantes. |
true |
IMPORT_DOCUMENTS |
Muestra la opción de importar comprobantes. |
false |
IMPORT_DOCUMENTS_SECOND_FORMAT |
Activa el segundo formato de importación de comprobantes. |
false |
DOCUMENT_IMPORT_EXCEL |
Muestra la importación de comprobantes desde Excel. |
false |
INTERNAL_DISPATCH |
Muestra el botón para generar un comprobante desde una guía de remisión. |
false |
RECREATE_DOCUMENT |
Solo afecta al módulo de suscripciones. En el listado de comprobantes, el botón para recrear depende del permiso Recrear documentos del usuario. Ver Regeneración de comprobantes. |
false |
AUTO_PRINT |
Activa la impresión automática de comprobantes. |
false |
PDF
| Parámetro |
Descripción |
Valor en .env.example |
PDF_TEMPLATE |
Plantilla PDF por defecto. Ver Plantilla PDF personalizada. |
default |
PDF_TEMPLATE_FOOTER |
Agrega el pie de página de la plantilla al PDF. |
true |
PDF_NAME_REGULAR |
Nombre de una fuente personalizada para el texto normal del PDF. false usa la de la plantilla. |
false |
PDF_NAME_BOLD |
Nombre de una fuente personalizada para el texto en negrita del PDF. false usa la de la plantilla. |
false |
ENABLED_TEMPLATE_TICKET_80 |
Ajusta el ticket al ancho de papel de 80 mm. |
false |
Administrador, usuarios y límites del reseller
| Parámetro |
Descripción |
Valor en .env.example |
ADMIN_DELETE_CLIENT |
Permite eliminar empresas desde el administrador. |
true |
MULTI_USER_ENABLED |
Permite cambiar entre usuarios o empresas desde el menú del usuario. |
true |
PASSWORD_CHANGE |
Permite cambiar la contraseña al editar un usuario. |
true |
ITEMS_PER_PAGE |
Registros por página en las tablas principales. |
20 |
ITEMS_PER_PAGE_SIMPLE_D_TABLE |
Registros por página en las tablas simples. |
5 |
API_RATE_LIMIT |
Peticiones por minuto que admite la API por usuario. |
60 |
LIMITE_RESELLER |
Límite de consultas del reseller a los servicios extra (consulta de documentos, placa, licencia, etc.). |
999 |
LIMITE_ALMACENAMIENTO_GB |
Espacio total en GB para los archivos de todas las empresas. Al superarlo se bloquea el acceso a todas. 0 lo desactiva. |
0 |
LIMITE_DOCUMENTOS_MENSUAL |
Total de documentos tributarios que pueden emitir todas las empresas en el mes. Al llegar al límite se bloquea la emisión hasta el día 1. 0 lo desactiva. |
0 |
ENABLE_MARKETPLACE |
Activa el módulo Marketplace. |
false |
WhatsApp
| Parámetro |
Descripción |
Valor en .env.example |
BUHO_PROXY_URL, BUHO_PROXY_CLIENT_ID, BUHO_PROXY_CLIENT_SECRET |
Proxy del bot de WhatsApp. Solo se definen para apuntar a un proxy distinto del predeterminado (por ejemplo, uno de pruebas). En producción no hacen falta. |
sin definir |
EVOLUTION_API_URL, EVOLUTION_API_KEY |
Evolution API propio, para instalaciones que lo tienen en su mismo servidor. Si se definen ambas, el bot y QR Api se conectan directamente a ese Evolution en lugar del proxy. |
sin definir |
WHATSAPP_WEBHOOK_BASE_URL |
URL pública del webhook del bot. Solo para desarrollo local con un túnel (ngrok u otro). |
sin definir |
WHATSAPP_CLOUD_API_VERSION |
Versión de la API de WhatsApp Cloud. |
v14.0 |
Actualizaciones desde el panel (Git)
| Parámetro |
Descripción |
Valor en .env.example |
GIT_USER |
Usuario de GitLab para descargar actualizaciones. |
— |
GIT_TOKEN |
Token de GitLab. Va sin comillas. |
— |
GIT_PROJECT_TAGS_URL |
URL de las versiones (tags) del proyecto. |
— |
GIT_REMOTE_URL |
URL HTTPS para clonar, si no coincide con la que se deduce de GIT_PROJECT_TAGS_URL. |
sin definir |
GIT_FILESYSTEM_USER |
Usuario dueño de los archivos del proyecto. |
www-data |
GIT_AUTO_FIX_PERMISSIONS |
Corrige los permisos de los archivos después de actualizar. |
true |
Otros
| Parámetro |
Descripción |
Valor en .env.example |
URL_APIDOCS |
URL del servicio extra de documentación de la API. |
https://api.uio.la |
WIKI_PHARMACY |
Enlace a la guía del módulo de farmacia. |
${APP_URL}/legacy-docs/4.X/modulo-farmacia |
IS_CLIENT, TOKEN_SERVER, URL_SERVER |
Modo offline. Ya no se leen del .env: se configuran en la base de datos. Se mantienen solo por compatibilidad. |
— |