💬 Microblogging Federado · ActivityPub & API Mastodon · PHP + SQLite

Tu Propia Instancia en el Fediverso, Ligera y Sin Complicaciones

KutSocial es un servidor y cliente web de microblogging diseñado para ofrecer soberanía social sin la sobrecarga de instancias pesadas. Compatible al 100% con clientes móviles de Mastodon, impulsado por SQLite y con una interfaz SPA ultrarrápida para interactuar con millones de usuarios en el Fediverso.

🌐 Protocolo ActivityPub W3C 🐘 Compatible API Mastodon 🗄️ Base de datos embebida SQLite 3 ⚡ Cliente Web SPA Vanilla JS/CSS 🛡️ Seguridad 2FA (TOTP) & JWT 🔔 Notificaciones Web Push (VAPID)

Instalar KutSocial Ver Características Código en GitHub

Interfaz de usuario SPA de KutSocial con timeline federado

Microblogging Libre

Características Principales

Conectividad descentralizada completa y una experiencia de usuario de primera clase sin necesidad de gestionar clusters de bases de datos pesadas ni servicios Redis complejos.

🌐

Federación Nativa ActivityPub

Implementación del estándar abierto ActivityPub (Webfinger, Inbox, Outbox, Follow, Undo, Create). Tu cuenta en KutSocial puede seguir, ser seguida e intercambiar publicaciones con usuarios de Mastodon, Lemmy, Pixelfed, Firefish, Pleroma y Threads de manera orgánica.

📱

Compatibilidad Total con la API de Mastodon

Usa cualquier cliente de terceros para Mastodon en Android, iOS o escritorio (como Tusky, Ivory, Megalodon, Mona, Fedilab o Tokodon). Solo introduce la dirección de tu nodo KutSocial e inicia sesión con tu cuenta para disfrutar de tu app preferida.

🗄️

Cero MySQL ni PostgreSQL — SQLite Puro

KutSocial utiliza SQLite como motor de base de datos embebido en data/kutsocial.db. Esto erradica la necesidad de mantener daemons pesados de base de datos, reduce el consumo de RAM a unos pocos megabytes y permite respaldar toda tu instancia copiando un solo archivo.

⚡

Cliente Web SPA Ultrarrápido y Moderno

Cliente Single Page Application construido en HTML5, Vanilla CSS y JavaScript sin dependencias pesadas de frameworks. Incluye compositor con autocompletado, encuestas interactivas, avisos de contenido (CW), adjuntos multimedia y modos timeline: Inicio, Local, Público y Ponerse al día.

🛡️

Panel de Control & Moderación Integral

Administra tu servidor desde /admin/dashboard: control de usuarios locales, lista de bloqueo y silenciamiento de dominios remotos, supervisión de almacenamiento multimedia, gestión de relays federados y comprobación de actualizaciones en un clic.

🔐

Seguridad: 2FA (TOTP), JWT & Web Push

Protege tu cuenta con autenticación en dos factores (TOTP) compatible con apps autenticadoras, tokens JWT criptográficamente seguros para la API, y notificaciones push web en tiempo real (VAPID) para no perderte menciones o respuestas en el móvil.

Detalles Técnicos

Otras Características

Arquitectura robusta optimizada para funcionar en VPS económicos o servidores domésticos sin mantenimiento.

✓

Procesador de Cola Eficiente (Cron Worker)

El script cron.php procesa la entrega y recepción de actividades federadas en segundo plano sin ralentizar la navegación web.

✓

Publicaciones con Advertencia de Contenido (CW)

Oculta texto bajo etiquetas personalizadas de advertencia para spoilers o temas sensibles, respetando el estándar del Fediverso.

✓

Encuestas Nativas con Vencimiento

Crea encuestas de múltiples opciones con límite de tiempo (1 hora, 1 día o 1 semana) y resultados en tiempo real.

✓

Gestión de Relays Federados

Conéctate a relays de ActivityPub para poblar el timeline público y descubrir contenido de la red global desde el primer día.

✓

Marcadores, Listas y Colecciones

Guarda toots favoritos en tus marcadores privados y clasifica a tus cuentas seguidas en listas organizadas por temática.

✓

Filtros y Búsqueda de Hashtags

Explora tendencias locales y globales, y sigue hashtags específicos para recibirlos en tu feed principal.

✓

Plantillas Nginx Listas para Usar

Archivos nginx_local.conf y nginx_proxy.conf incluidos en el repositorio para despliegue directo con SSL.

✓

Mantenimiento y Purga Automática de Disco

Mecanismo interno para limpiar avatares e imágenes en caché de instancias externas y evitar que el disco se sature.

Ficha Técnica

Especificaciones de KutSocial

Lenguaje & Versión

PHP 8.3.0+

Sin Composer en producción

Base de Datos

SQLite 3 (PDO)

Archivo local data/kutsocial.db

Protocolos de Red

ActivityPub W3C

WebFinger & HTTP Signatures

API de Clientes

API Mastodon v1 / v2

Compatible con Tusky, Ivory, etc.

Seguridad & Auth

TOTP 2FA & JWT

Web Push VAPID integrado

Licencia de Software

MIT License

Software libre y abierto

Puesta en Marcha

Despliega tu Propio Nodo KutSocial

Instala KutSocial mediante el asistente web interactivo o con una sola línea en la terminal.

Instalador Web Gráfico

Instalación Asistida

Clona el código en tu directorio web y abre install.php en tu navegador.

Repositorio GitHub Repositorio
Asistente Web /install.php
Requisitos PHP 8.3+ (pdo_sqlite, openssl, curl)

Descargar desde GitHub

Instalación CLI por Terminal

Comandos Rápidos

Ejecuta el script unificado de instalación directamente desde la consola SSH.

git clone https://github.com/ernestoacostame/KutSocial /var/www/kutsocial
cd /var/www/kutsocial
sudo chown -R www-data:www-data .
php install.php --username=admin --email=yo@mi-nodo.org --password=MiClave123 --domain=social.mi-nodo.org
                        

Añade * * * * * php /var/www/kutsocial/cron.php a tu crontab para la entrega en segundo plano.

Ver Guía Completa de Nginx & Cron