Repolode
Enviar
stoatchat

stoatchat/self-hosted

Configuración basada en Docker para desplegar una instancia completa y autohospedada del chat Stoat, con back-end, cliente web, servidor de archivos y proxies.

Alternativa open source a:Discord

Ver en GitHubSitio web
Estrellas
2,684
Forks
301
Issues abiertos
20
Último commit
el mes pasado

¿Qué es?

Este repositorio incluye la configuración de Docker Compose y una guía paso a paso para ejecutar una instancia completa de Stoat en tu propio servidor. El despliegue incluye el back-end, el cliente web, un servidor de archivos y un proxy de metadatos e imágenes.

La configuración se basa en el script generate_config.sh, que crea los secretos necesarios en el archivo secrets.env y genera una configuración Revolt.toml. Luego, puedes editarla para configurar opciones como la verificación por correo electrónico, captcha, un servidor S3 personalizado y las notificaciones push para iOS y Android. La guía explica cómo preparar un VPS con Ubuntu, configurar las reglas del firewall, apuntar un dominio al servidor e instalar Docker. Las secciones opcionales explican cómo alojar la instancia detrás de otro proxy inverso, fijar la versión de MongoDB o sustituir KeyDB por Valkey o Redis en hardware antiguo o ARM, y actualizar un despliegue existente.

La mayoría de los clientes oficiales aún no admiten instancias autohospedadas, por lo que el cliente web —también se puede usar como PWA— es la principal forma de acceder a ellas.

Funciones clave

  • 01Despliega en conjunto el back-end, el cliente web, el servidor de archivos y el proxy de metadatos e imágenes mediante Docker Compose.
  • 02Genera secretos y una configuración Revolt.toml con generate_config.sh.
  • 03Admite almacenamiento S3 personalizado, verificación por correo electrónico, captcha y notificaciones push para dispositivos móviles.
  • 04Incluye guías para configurar un proxy inverso, el acceso solo por invitación y NGINX.
  • 05Documenta los pasos de actualización y las migraciones necesarias por cambios incompatibles anteriores.

Casos de uso

  • Ejecutar un servidor de chat privado para una comunidad o un equipo en tu propio VPS.
  • Alojar una instancia de Stoat en un dominio que controlas, con tu propio almacenamiento y tus datos.
  • Probar o evaluar el conjunto de componentes de Stoat antes de desplegarlo a mayor escala.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/stoatchat/self-hosted stoat
  2. 2

    Entra en el directorio del proyecto

    cd stoat
  3. 3

    Genera la configuración con tu dominio

    ./generate_config.sh your.domain
  4. 4

    Inicia la instancia en segundo plano

    docker compose up -d

Antes de usarlo

  • Necesitas un servidor con Docker y un nombre de dominio que apunte a él, por lo que alojarlo por tu cuenta requiere cierto trabajo de configuración.
  • La mayoría de los clientes oficiales no admiten instancias alojadas por cuenta propia; el cliente web y la PWA funcionan mejor.
  • Está bajo la licencia AGPL-3.0, una licencia copyleft que exige divulgar el código fuente cuando se usa a través de una red.

En colecciones

Apps autoalojadas

Temas

#self-hosted#docker#chat#docker-compose#messaging#deployment#self-hosting#stoat#stoat-chat#stoatchat

Preguntas frecuentes

¿Qué es self-hosted?
Configuración basada en Docker para desplegar una instancia completa y autohospedada del chat Stoat, con back-end, cliente web, servidor de archivos y proxies. Este repositorio incluye la configuración de Docker Compose y una guía paso a paso para ejecutar una instancia completa de Stoat en tu propio servidor. El despliegue incluye el back-end, el cliente web, un servidor de archivos y un proxy de metadatos e imágenes.
¿self-hosted es gratuito? ¿Qué licencia tiene?
self-hosted es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿self-hosted sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de self-hosted fue el 7 oct 2026.
¿Para qué puedo usar self-hosted?
Ejecutar un servidor de chat privado para una comunidad o un equipo en tu propio VPS. Alojar una instancia de Stoat en un dominio que controlas, con tu propio almacenamiento y tus datos. Probar o evaluar el conjunto de componentes de Stoat antes de desplegarlo a mayor escala.
¿Cómo se instala self-hosted?
Clona el repositorio: git clone https://github.com/stoatchat/self-hosted stoat Entra en el directorio del proyecto: cd stoat Genera la configuración con tu dominio: ./generate_config.sh your.domain Inicia la instancia en segundo plano: docker compose up -d
¿Dónde consigo self-hosted?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/stoatchat/self-hosted

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados