umami

Umami se presenta como una plataforma de analítica centrada en la privacidad que reúne el tráfico, las campañas, el comportamiento, las conversiones y los ingresos en un solo lugar. El proyecto enfatiza que no utiliza cookies ni técnicas de vigilancia, y puede operarse ya sea de forma autoalojada o a través de una oferta de nube alojada. En el README se incluye un enlace a una demo pública, y los canales de soporte del proyecto incluyen GitHub, Twitter, LinkedIn y Discord. El código se publica bajo la licencia MIT. La instalación desde el código fuente requiere un servidor con Node.js 18.18 o posterior y una base de datos PostgreSQL (versión 12.14 o posterior). El flujo documentado consiste en clonar el repositorio, instalar las dependencias con pnpm, crear un archivo `.env` que contenga una cadena de conexión `DATABASE_URL`, ejecutar la compilación y luego iniciar la aplicación. El paso de compilación crea las tablas de la base de datos en la primera instalación y también genera un usuario de inicio de sesión con el nombre de usuario `admin` y la contraseña `umami`. Por defecto, la aplicación se inicia en `http://localhost:3000`, por lo que la documentación señala que normalmente será necesario proxyar las solicitudes desde un servidor web o cambiar el puerto para servirla directamente. Se documentan varias opciones de entorno. `API_URL` puede cambiar la URL base utilizada para las llamadas API internas de la interfaz de usuario; las rutas relativas se sirven bajo `BASE_PATH`, mientras que las URLs absolutas se proxyan a través de la ruta local `/api`. `TWO_FACTOR_ENCRYPTION_KEY`, una cadena hexadecimal de 64 caracteres generada, por ejemplo, con `openssl rand -hex 32`, habilita la autenticación de dos factores; hasta que se configure, la autenticación de dos factores no estará disponible y no podrá ser requerida. Para el despliegue en contenedores, el proyecto publica imágenes de Docker y proporciona un archivo Docker compose que ejecuta Umami junto con una base de datos PostgreSQL. Las actualizaciones se gestionan ya sea extrayendo el código fuente, reinstalando las dependencias y volviendo a compilar, o extrayendo nuevas imágenes y recreando los contenedores con Docker compose. Una guía detallada de inicio rápido está alojada en el sitio de documentación del proyecto.