Repolode
stoatchat

stoatchat/self-hosted

Configuração baseada em Docker para implantar uma instância completa e auto-hospedada do chat Stoat, com back-end, front-end web, servidor de arquivos e proxies.

Alternativa open source a:Discord

Estrelas
2,682
Forks
303
Issues abertas
20
Último commit
mês passado

O que é?

Este repositório oferece uma configuração do Docker Compose e instruções passo a passo para executar uma instância completa do Stoat no seu próprio servidor. A implantação inclui o back-end, o front-end web, um servidor de arquivos e um proxy de metadados e imagens.

A configuração gira em torno do script generate_config.sh, que cria os segredos necessários no arquivo secrets.env e gera uma configuração Revolt.toml, que pode ser editada para definir opções como verificação de e-mail, captcha, um servidor S3 personalizado e notificações push para iOS e Android. O guia explica como provisionar um VPS com Ubuntu, configurar regras de firewall, apontar um domínio para o servidor e instalar o Docker. As seções opcionais abordam como colocar a instância atrás de outro reverse proxy, fixar a versão do MongoDB ou substituir o KeyDB por Valkey ou Redis em hardware mais antigo ou ARM, além de atualizar uma implantação existente.

A maioria dos clientes oficiais ainda não oferece suporte a instâncias auto-hospedadas, então o cliente web — inclusive como PWA — é a principal forma de acessar uma delas.

Recursos principais

  • 01Implanta juntos o back-end, o front-end web, o servidor de arquivos e o proxy de metadados/imagens usando Docker Compose.
  • 02Gera segredos e uma configuração Revolt.toml com generate_config.sh.
  • 03Oferece suporte a armazenamento S3 personalizado, verificação de e-mail, captcha e notificações push para dispositivos móveis.
  • 04Inclui guias sobre uso de reverse proxy, configuração por convite e NGINX.
  • 05Documenta etapas de atualização e migrações para mudanças incompatíveis anteriores.

Casos de uso

  • Executar um servidor de chat privado para uma comunidade ou equipe no seu próprio VPS.
  • Hospedar uma instância do Stoat em um domínio sob seu controle, com armazenamento e dados próprios.
  • Testar ou avaliar a stack do Stoat antes de implantá-la em maior escala.

Início rápido

  1. 1

    Clone o repositório

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

    Acesse o diretório do projeto

    cd stoat
  3. 3

    Gere a configuração com o seu domínio

    ./generate_config.sh your.domain
  4. 4

    Inicie a instância em segundo plano

    docker compose up -d

Antes de usar

  • É necessário ter um servidor com Docker e um nome de domínio apontado para ele, então hospedar por conta própria exige algum trabalho de configuração.
  • A maioria dos clientes oficiais não oferece suporte a instâncias auto-hospedadas; o cliente web e o PWA funcionam melhor.
  • Licenciado sob a AGPL-3.0, uma licença copyleft que exige a disponibilização do código-fonte quando o software é usado pela rede.

Em coleções

Tópicos

Perguntas frequentes

O que é self-hosted?
Configuração baseada em Docker para implantar uma instância completa e auto-hospedada do chat Stoat, com back-end, front-end web, servidor de arquivos e proxies. Este repositório oferece uma configuração do Docker Compose e instruções passo a passo para executar uma instância completa do Stoat no seu próprio servidor. A implantação inclui o back-end, o front-end web, um servidor de arquivos e um proxy de metadados e imagens.
self-hosted é gratuito? Qual é a licença?
self-hosted é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
self-hosted ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de self-hosted foi em 7 de out. de 2026.
Para que posso usar self-hosted?
Executar um servidor de chat privado para uma comunidade ou equipe no seu próprio VPS. Hospedar uma instância do Stoat em um domínio sob seu controle, com armazenamento e dados próprios. Testar ou avaliar a stack do Stoat antes de implantá-la em maior escala.
Como instalar self-hosted?
Clone o repositório: git clone https://github.com/stoatchat/self-hosted stoat Acesse o diretório do projeto: cd stoat Gere a configuração com o seu domínio: ./generate_config.sh your.domain Inicie a instância em segundo plano: docker compose up -d
Onde consigo self-hosted?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/stoatchat/self-hosted

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados