Base de Conhecimento

Mattermost na VPS: chat da equipe no seu servidor

  • mattermost, docker, chat da equipe, vps, self-hosted
  • Usuários acharam útil: 0

Veja como instalar o Mattermost numa VPS com Docker Compose: requisitos, arquivo .env, HTTPS, primeiro acesso, atualização, backup e o aviso sobre produção.

Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Mattermost na VPS: chat da equipe no seu servidor

Capa da Redação Eleven Host para o guia: Mattermost na VPS: chat da equipe no seu servidor Arte: Eleven Host

Mattermost na VPS é uma forma de ter o chat da sua equipe num servidor que você controla. O Mattermost é uma plataforma de colaboração que você mesmo instala, e o caminho mostrado usa Docker Compose, com um aviso importante da documentação sobre produção.

Neste guia você vê o que é o Mattermost, o que a licença diz, o que a documentação pede de requisitos e como subir o sistema com Docker Compose. Depois, como colocar o HTTPS, criar o primeiro acesso, atualizar e fazer backup. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam chat.exemplo.com como endereço fictício.

O que é o Mattermost

O README do projeto no GitHub o descreve como uma plataforma de colaboração open core e self-hosted (instalada por você), que oferece chat, automação de fluxos de trabalho, chamadas de voz e outros recursos de colaboração, inclusive de IA.

Para equipes que querem manter as conversas num servidor próprio, ele é uma das opções. Quem busca outra ferramenta de atendimento, e não de chat interno, pode ver o guia Chatwoot na VPS: central de atendimento própria.

Licença: o que o arquivo LICENSE diz

O arquivo LICENSE do repositório divide o uso em partes. As versões compiladas do Mattermost, produzidas pela Mattermost, Inc., são licenciadas sob a licença MIT. O código-fonte fica sob a GNU AGPL v3.0, sujeito às exceções descritas na própria política. As ferramentas de administração e os arquivos de configuração usam a licença Apache v2.0. Há ainda uma licença comercial, que se contrata com a Mattermost, Inc.

A documentação cita duas imagens oficiais de Docker, a mattermost/mattermost-team-edition e a mattermost/mattermost-enterprise-edition. Em caso de dúvida sobre uso comercial ou sobre qual imagem escolher, consulte um profissional.

O aviso da documentação sobre Docker

Antes dos comandos, vale ler o aviso da documentação de instalação com contêineres: esse método de implantação não deve ser usado em ambientes de produção, porque não oferece, de saída, implantações em cluster nem configurações de alta disponibilidade (HA). A mesma página diz que a implantação com Docker é oficialmente suportada só em sistemas Linux.

A documentação não indica este método para produção, e cluster e alta disponibilidade não vêm prontos nele.

Requisitos segundo a documentação

A página de requisitos de software e hardware traz estas faixas: de 1 a 1.000 usuários, 1 vCPU e 2 GB de RAM; de 1.000 a 2.000 usuários, 2 vCPUs e 4 GB de RAM. O arquivo padrão do Compose define um limite de memória de 4 GB para o Mattermost.

Os sistemas listados para o servidor são Ubuntu 22.04 ou superior, Debian Bookworm ou superior, CentOS Stream 9 ou superior, Red Hat Enterprise Linux 9 ou superior e Oracle Linux 9 ou superior. O banco é o PostgreSQL 15 ou superior, que no método Docker sobe em um contêiner pelo próprio Compose. É preciso ter o Docker Engine e o Docker Compose instalados. A página de requisitos não traz um número para o espaço em disco.

Está comparando planos de servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Baixar os arquivos e preparar as pastas

Os comandos abaixo vêm da página de implantação com contêineres da documentação. Eles baixam o repositório oficial de Docker do Mattermost e preparam o arquivo de configuração:

git clone https://github.com/mattermost/docker

cd docker

cp env.example .env

Com o .env criado, edite o arquivo. A documentação diz que, no mínimo, você precisa trocar o valor de DOMAIN pelo domínio do seu servidor Mattermost. Aqui, chat.exemplo.com. Depois crie as pastas dos dados e acerte o dono delas, que é o usuário 2000:

mkdir -p ./volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}

sudo chown -R 2000:2000 ./volumes/app/mattermost

Ajustar o .env: senha, imagem e versão

O env.example traz valores de exemplo. Estes são os que merecem atenção:

  • DOMAIN: o exemplo é mm.example.com. Troque pelo seu domínio.
  • POSTGRES_PASSWORD: o exemplo é mmuser_password. Troque por uma senha sua, porque o valor de exemplo é público.
  • TZ: o exemplo é UTC. Ajuste se quiser outro fuso.
  • MATTERMOST_IMAGE: o exemplo vem com mattermost-enterprise-edition. A imagem mattermost-team-edition também existe, e o comentário do arquivo diz que o nome muda conforme a versão do Mattermost.
  • MATTERMOST_IMAGE_TAG: o exemplo aponta a tag 11.7.0. Na versão 12.0.1, segundo a página de releases do GitHub, publicada em 22 de outubro, há correções de segurança de severidade média. Você pode ajustar essa tag, como a documentação manda fazer na atualização.

Para produção, a documentação recomenda tags de versão específicas, como release-10.5. Esse é um exemplo do formato da tag.

O arquivo também define as portas: HTTP_PORT=80, HTTPS_PORT=443, APP_PORT=8065 e CALLS_PORT=8443. A documentação recomenda ainda preencher MM_SUPPORTSETTINGS_SUPPORTEMAIL, o contato de suporte da instalação.

Subir o Mattermost

Há dois arquivos de Compose para escolher. Sem o Nginx do repositório, use o comando abaixo, e o Mattermost responde em http://chat.exemplo.com:8065/:

docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml up -d

Com o Nginx do repositório e HTTPS, o comando é este, e o endereço fica https://chat.exemplo.com/:

docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

Para parar, repita o mesmo comando com down no lugar de up -d. Quem já usa outro proxy na VPS escolhe o arquivo sem Nginx e aponta o proxy para a porta do Mattermost. O guia Nginx Proxy Manager: vários sites numa VPS só mostra uma opção com painel.

HTTPS com certificado

Para usar o arquivo com Nginx, a documentação traz duas formas de obter o certificado. A primeira usa o script do repositório, com Let's Encrypt. Como cuidado geral, aponte antes o domínio do DOMAIN para o servidor.

bash scripts/issue-certificate.sh -d chat.exemplo.com -o ${PWD}/certs

A segunda é usar um certificado que você já tem:

mkdir -p ./volumes/web/cert

cp caminho-do-certificado.pem ./volumes/web/cert/cert.pem

cp caminho-da-chave.pem ./volumes/web/cert/key-no-password.pem

Os caminhos do certificado e da chave vão no .env, nas variáveis CERT_PATH e KEY_PATH. Depois, suba com o docker-compose.nginx.yml, como mostrado acima.

Primeiro acesso

Ao abrir o endereço pela primeira vez, a documentação manda criar o primeiro usuário administrador do sistema. No método Docker normal não existe usuário nem senha padrão. Depois de entrar, convide os usuários da equipe.

Atualizar o Mattermost

O processo da documentação tem quatro passos: desligar os serviços com down, atualizar o repositório com git pull, ajustar o MATTERMOST_IMAGE_TAG no .env para a versão da imagem enterprise ou team que você quer e subir de novo.

docker compose -f docker-compose.yml -f docker-compose.nginx.yml down

git pull

docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

Para atualizar o PostgreSQL, o repositório traz o script ./scripts/upgrade-postgres.sh, com um aviso no próprio arquivo: confirme que há espaço em disco suficiente para os backups.

Backup e cuidados com os dados

A documentação de backup e recuperação de desastres lista três itens: o banco de dados, feito com os procedimentos padrão do PostgreSQL; o arquivo config/config.json (ou a pasta config inteira, se você usa SAML); e a pasta data, onde ficam os arquivos enviados. A página diz que é preciso parar o Mattermost durante o backup.

No método Docker, o .env aponta as pastas de configuração e de dados para ./volumes/app/mattermost/config e ./volumes/app/mattermost/data. Confirme esses caminhos na sua instalação antes de copiar. Guarde também o .env e faça a cópia fora do servidor.

Checklist do Mattermost na VPS

  • Linux, com Docker Engine e Docker Compose instalados.
  • DOMAIN trocado e POSTGRES_PASSWORD diferente do exemplo.
  • Imagem e tag escolhidas no .env.
  • Pastas criadas e com dono 2000:2000.
  • Compose com Nginx e certificado, ou proxy próprio na frente.
  • Primeiro administrador criado.
  • Cópia do banco, da pasta config, da pasta data e do .env feita com o Mattermost parado.
  • Aviso da documentação sobre produção lido.

Vai escolher onde instalar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Perguntas frequentes

O que é o Mattermost?

É uma plataforma de colaboração open core e self-hosted que oferece chat, automação de fluxos de trabalho, chamadas de voz e outros recursos.

O Mattermost com Docker serve para produção?

A documentação avisa que esse método não deve ser usado em produção, porque não oferece, de saída, cluster nem alta disponibilidade. Para produção, consulte a documentação do Mattermost sobre outros métodos de instalação.

Qual é o login e a senha padrão do Mattermost?

No método Docker normal não existe login padrão. No primeiro acesso, você cria o usuário administrador do sistema.

Qual imagem usar, enterprise ou team?

O env.example vem com a mattermost-enterprise-edition, e a mattermost-team-edition também existe. Em caso de dúvida sobre uso comercial, consulte um profissional.

Como fazer backup do Mattermost?

Guarde o banco, o config.json e a pasta data, com o Mattermost parado durante a cópia.

Esta resposta lhe foi útil?

Artigos Relacionados