En este tutorial veremos cómo instalar Loops, una plataforma de vídeos cortos muy similar a TikTok, pero con una gran diferencia: está basada en ActivityPub, lo que le permite integrarse de forma nativa en el Fediverso.

Gracias a este enfoque descentralizado, los vídeos que publiques en tu instancia de Loops podrán ser vistos, compartidos e interactuados desde otras plataformas compatibles como Mastodon, Pleroma, Misskey y muchas más.

A lo largo de la guía te explicaré los requisitos previos, los pasos de instalación y la configuración básica para dejar tu propia instancia de Loops lista y funcionando.

Ten en cuenta que Loops todavía está en fase alpha, por lo que pueden existir errores o limitaciones. Para más información actualizada y soporte, puedes visitar su repositorio oficial en GitHub.

Requisitos para Loops

En este tutorial trabajaremos sobre un servidor con Ubuntu 24.04, con acceso a usuario root. A lo largo del proceso instalaremos el siguiente software:

Instalación de LAMP o LEMP

Lo primero es contar con un servidor LAMP o LEMP completamente configurado. Eso sí, ten en cuenta que no es necesario instalar MariaDB, ya que en el caso de Loops utilizaremos MySQL.

Instalación de servidor web LAMP en Ubuntu 24.04

A continuación vamos a instalar un servidor LAMP completo en Ubuntu 24.04 “Noble Numbat”.

_ voidNullDon T3rr0rZ0n3

Instalación de servidor web LEMP en Ubuntu 24.04

A continuación vamos a instalar un servidor LEMP completo en Ubuntu 24.04 “Noble Numbat”.

_ voidNullDon T3rr0rZ0n3

Para la instalación de PHP, además tenemos que instalar todas estas librerías que son necesarias para Loops:

apt install php8.3-tokenizer php-json php8.3-pdo php8.3-fileinfo php8.3-bcmath php8.3-mbstring php8.3-ctype php8.3-xml php8.3-gd php8.3-redis

Instalación de MySQL

Para la instalación de MySQL, seguiremos este otro tutorial que explica todo lo necesario:

Instalar MySQL 8.0 en Ubuntu 24.04

MySQL es uno de los sistemas de gestión de bases de datos más utilizados y más popular. Utiliza el concepto de bases de datos relacionales y tiene una arquitectura cliente/servidor. Se puede instalar en diferentes distribuciones de GNU/Linux.

_ voidNullDon T3rr0rZ0n3

Aprovecharemos para crear también la base de datos y guardar los datos de acceso para configurar más tarde:

CREATE DATABASE loops CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'loops_user'@'localhost' IDENTIFIED BY 'ContraseñaSegura';
GRANT ALL PRIVILEGES ON loops.* TO 'loops_user'@'localhost';
FLUSH PRIVILEGES;v

Recuerda configurar un nombre de usuario y una base de datos distintos a los que se muestran en este ejemplo. Además, asegúrate de establecer una contraseña fuerte y segura.

Instalación de Redis Server

Para instalar redis-server en el servidor simplemente tienes que ejecutar este comando para su instalación:

apt install redis-server

Instalación de FFmpeg

Para adaptar los videos a la plataforma de Loops, también es necesario instalar el paquete ffmpeg en el servidor:

apt install ffmpeg

Instalación de NodeJS

También será necesario instalar NodeJS, para ello seguiremos también este tutorial. En este caso recomendamos instalar la versión 22 de NodeJS.

Instalación de NodeJS en Ubuntu 24.04

En el siguiente tutorial os explicaremos la correcta instalación de NodeJS en Ubuntu 24.04

_ voidNullDon T3rr0rZ0n3

Instalación de Composer

Finalmente para instalar la aplicación, usaremos Composer, para ello lo instalaremos siguiendo este otro tutorial:

Instalación de composer en Ubuntu 24.04

Composer es una popular herramienta de gestión de dependencias para PHP, creada principalmente para facilitar la instalación y las actualizaciones de dependencias de un proyecto.

_ voidNullDon T3rr0rZ0n3

Instalación de Loops

Ahora sí, una vez instalado todo lo necesario, podemos comenzar con la instalación de Loops. El primer paso será descargar el repositorio en el directorio correspondiente:

cd /var/www/
git clone https://github.com/joinloops/loops-server.git
mv loops-server loops

Entramos dentro del directorio para instalar las dependencias de PHP:

cd /var/www/loops
composer install --no-dev --optimize-autoloader

El siguiente paso es instalar las dependencias de NodeJS:

npm install
npm run build

Copiamos el fichero de ejemplo de configuración:

cp .env.example .env

Generamos la llave de aplicación:

php artisan key:generate

Este comando automáticamente incluye la key en el fichero .env. Luego también añadimos el almacenamiento:

php artisan storage:link

Luego tendremos que editar el fichero .env y modificar todo a nuestras necesidades, a continuación os dejo algunos parámetros que se deben de configurar:

# De local a production
APP_ENV=production
# De true a false
APP_DEBUG=false
# Cambiamos localhost por el dominio
APP_URL=example.com

# Configuración de la base de datos
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=loops
DB_USERNAME=loops_user
DB_PASSWORD=ContraseñaSegura

# Configuración de Redis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_DB=0

# Cache & Sessions
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

# Configuración del correo SMTP
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"

# Añadimos también esto para el Video Processing
FFMPEG_BINARIES=/usr/bin/ffmpeg
FFPROBE_BINARIES=/usr/bin/ffprobe

Tras crear la configuración, podemos conectar la base de datos y lanzar las migraciones de la base de datos:

php artisan migrate

Por defecto el registro de Loops se encuentra desactivado, por ello es necesario registrar manualmente un usuario administrador:

php artisan create-admin-account

Configuración de las colas

Para que Loops funcione correctamente es necesario configurar las colas con Horizon. La forma más recomendable de gestionarlo es mediante Supervisor, que se encargará de ejecutar esta tarea de manera automática.

apt install supervidor

Y en la configuración añadimos lo siguiente:

nano /etc/supervisor/conf.d/loops-horizon.conf

[program:loops-horizon]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/loops/artisan horizon
autostart=true
autorestart=true
user=www
redirect_stderr=true
stdout_logfile=/var/www/loops/storage/logs/horizon.log
stopwaitsecs=3600

Guardamos el fichero de configuración para supervisor y modificamos los permisos del storage:

chown -R www:www /var/www/loops/storage

Releemos la configuración y configuramos la configuración de supervisor.

supervisorctl reread
supervisorctl update

Configuración del servidor web

Tanto si has decidido tirar por Nginx o por Apache, te dejo a continuación la configuración necesaria con lo que hay que cambiar:

Para Nginx:

En este bloque de código es necesario modificar server_name por el dominio y revisar que root sea la ruta correcta y que el PHP-FPM configurado en fastcgi_pass sea el instalado en el servidor.

server {
    listen 80;
    listen [::]:80;
    server_name your-domain.com;
    root /var/www/loops/public;
    
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";
    
    index index.php;
    
    charset utf-8;
    
    # Handle large video uploads
    client_max_body_size 100M;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }
    
    error_page 404 /index.php;
    
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_hide_header X-Powered-By;
    }
}

Para Apache

En este bloque de Apache, es necesario modificar ServerName por el nombre de tu dominio y revisar que tanto DocumentRoot y Directory sean las rutas correctas de la aplicación.

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /var/www/loops/public
    
    <Directory /var/www/loops/public>
        AllowOverride All
        Require all granted
    </Directory>
    
    # Handle large video uploads
    LimitRequestBody 104857600
    
    ErrorLog ${APACHE_LOG_DIR}/loops_error.log
    CustomLog ${APACHE_LOG_DIR}/loops_access.log combined
</VirtualHost>

Finalmente, revisamos que los permisos sean los correctos:

chown -R www-data:www-data /var/www/loops
chmod -R 755 /var/www/loops
chmod -R 775 /var/www/loops/storage
chmod -R 775 /var/www/loops/bootstrap/cache

Configuramos crontab

Para que funcione todo correctamente y se lancen las tareas programadas, es necesario configurar este Cronjob:

crontab -e

Y añadimos al final lo siguiente:

* * * * * cd /var/www/loops && php artisan schedule:run >> /dev/null 2>&1

Iniciar Loops en el servidor

Una vez realizada toda la configuración, es necesario reiniciar los servicios para que los cambios se apliquen. Podemos hacerlo de la siguiente manera:

php artisan horizon:terminate

Con esto ya podremos acceder, desde nuestro navegador favorito, al dominio configurado y comprobar que Loops se carga correctamente.

Y podremos iniciar sesión con el administrador que hemos creado durante el proceso:

Más sobre ./voidNull

• 📖 Aprende todos sobre los comandos de GNU/Linux en nuestro Diccionario "De la A a la Z: Los comandos de GNU/Linux"
• 💪 ¡Forma parte de la Comunidad de ./voidNull!
• 🤖 Disfruta de todos nuestros Cursos sobre Ansible, Proxmox, Home Assistant entre otros.
• 📩 Mantente actualizado con lo último en GNU/Linux y Software Libre. Recibe nuestra Newsletter mensual.