Umami es una plataforma de analítica web de código abierto que se centra en la privacidad, brindándote una alternativa a soluciones como Google Analytics. En este tutorial, aprenderás cómo instalar Umami en tu servidor VPS con Ubuntu 24.04.
Requisitos previos
- Un servidor VPS con Ubuntu 24.04.
- Acceso SSH al servidor con privilegios de root o sudo.
- Node.js (versión 14.x o superior) y npm instalados.
- Un servidor web como Nginx o Apache instalado y configurado.
- Una base de datos PostgreSQL (recomendado) o MySQL/MariaDB.
Pasos de instalación
-
Instalar Node.js y npm
Si aún no tienes Node.js y npm, puedes instalarlos con los siguientes comandos:
sudo apt update sudo apt install nodejs npm -
Instalar PostgreSQL (o MySQL/MariaDB)
Si eliges PostgreSQL:
sudo apt install postgresql postgresql-contribSi prefieres MySQL/MariaDB:
sudo apt install mysql-server -
Crear la base de datos
**Para PostgreSQL:**
- Accede a la consola de PostgreSQL como usuario postgres:
sudo -u postgres psql- Crea la base de datos y el usuario:
CREATE DATABASE umami; CREATE USER umami WITH ENCRYPTED PASSWORD 'tu_contraseña_segura'; GRANT ALL PRIVILEGES ON DATABASE umami TO umami;- Sal de la consola de PostgreSQL:
\q**Para MySQL/MariaDB:**
- Accede a la consola de MySQL/MariaDB:
sudo mysql -u root -p- Crea la base de datos y el usuario:
CREATE DATABASE umami; CREATE USER 'umami'@'localhost' IDENTIFIED BY 'tu_contraseña_segura'; GRANT ALL PRIVILEGES ON umami.* TO 'umami'@'localhost'; FLUSH PRIVILEGES; exit -
Descargar y configurar Umami
- Crea un directorio para Umami y navega a él:
sudo mkdir /opt/umami cd /opt/umami- Descarga el código fuente de Umami desde GitHub:
sudo git clone https://github.com/umami-software/umami.git .- Instala las dependencias:
sudo npm install- Copia el archivo de configuración de ejemplo y edítalo:
sudo cp .env.example .env sudo nano .env- Configura las variables de entorno en el archivo `.env`:
DATABASE_URL=(ajusta según tu base de datos, por ejemplo: `postgresql://umami:tu_contraseña_segura@localhost:5432/umami`)HASH_SALT=(genera un valor aleatorio con `openssl rand -hex 32`)
-
Construir y ejecutar Umami
- Construye la aplicación:
sudo npm run build- Inicia el servidor de Umami:
sudo npm start- (Opcional) Configura un servicio systemd para que Umami se inicie automáticamente al arrancar el sistema. Consulta la documentación de Umami para más detalles.
-
Configurar el servidor web (Nginx o Apache)
Configura tu servidor web para actuar como proxy inverso hacia Umami, que se ejecuta en el puerto 3000. Consulta la documentación de Umami o de tu servidor web para obtener instrucciones específicas.
Conclusión
¡Felicidades! Has instalado Umami en tu servidor Ubuntu 24.04. Ahora puedes acceder a la interfaz web de Umami en tu navegador y comenzar a recopilar datos de análisis respetando la privacidad de tus usuarios.
