Mattermost na VPS: chat da equipe no seu servidor
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

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 imagemmattermost-team-editiontambé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.
DOMAINtrocado ePOSTGRES_PASSWORDdiferente 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 pastadatae do.envfeita 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.