Equipe e notificações no Coolify: convites e avisos

Resposta rápida

Para dar acesso a outra pessoa no Coolify, abra Team > Members, informe o e-mail, escolha o papel (Owner, Admin ou Member) e clique em Generate Link: o link de convite vale 3 dias. Para receber avisos, abra Notifications, escolha o canal (e-mail, Discord, Telegram, Slack, Pushover ou Webhook), preencha os dados de envio e marque os eventos, como deploy com falha, backup com falha e disco do servidor. Na VPS da Hospedagem Segura, o e-mail por SMTP sai pela porta 587 ou 465.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

O que cada papel da equipe pode fazer: Owner, Admin e Member
Convidar uma pessoa por link, sem compartilhar a sua senha
Escolher o canal dos avisos e os eventos que importam
Configurar o e-mail por SMTP numa VPS com a porta 25 bloqueada

Antes de começar

O Coolify instalado e o primeiro acesso feito (veja como)
Ser Owner ou Admin da equipe

Neste guia

Os papéis da equipe
Convide um membro
Escolha onde receber os avisos
Problemas comuns

Os papéis da equipe

Cada pessoa entra com a própria conta. Assim, você sabe quem fez o quê e tira o acesso de alguém sem trocar a sua senha. O papel define o alcance de cada um.

Papéis de uma equipe no Coolify
Papel	O que pode fazer
Owner (dono)	Tudo, inclusive convidar e remover outros Owners, excluir a equipe e transferir um servidor.
Admin (administrador)	Gerencia os membros (menos os Owners), os servidores, o proxy, o terminal, as notificações e o registro de auditoria.
Member (membro)	Só leitura na equipe, por padrão. O acesso pode crescer por projeto, ambiente ou recurso: ler, ver segredos, fazer deploy, editar, apagar ou acesso total. Nunca abre o terminal nem o navegador de arquivos.

As configurações da instância, como atualizações e backup do Coolify, aparecem só para Owner e Admin da equipe principal.

Convide um membro

Abra a página de membros
No painel: TeamMembers(Equipe › Membros)
No menu lateral, abra Team (equipe). A lista Members mostra quem tem acesso, o papel de cada um e se a pessoa usa a verificação em duas etapas (2FA).
Preencha o convite e clique em Generate Link
Em Invite a member (convidar um membro), informe o e-mail da pessoa e escolha o papel em Role. Para um Member, o botão Scopes (escopos) define o que ele acessa; o padrão é só leitura na equipe.
1. Email address: o e-mail da pessoa convidada.
2. Generate Link (gerar link): cria o link do convite.
Mande o link para a pessoa
Copie o link e envie por um canal de confiança. Ele vale 3 dias; depois disso, gere outro. A pessoa abre o link e entra na equipe com o papel escolhido.
Dica O painel também manda o convite por e-mail, mas só com o e-mail transacional da instância configurado. Enquanto isso, ele mostra o aviso Email delivery is not configured.

Peça o 2FA a todos

A lista de membros avisa quem está sem 2FA. Quem entra no painel publica contêineres e lê variáveis com senhas: veja segurança do Coolify.

Escolha onde receber os avisos

O Coolify avisa quando um deploy falha, um backup não roda ou o servidor fica sem disco. Os avisos valem para a equipe toda e ficam em Notifications (notificações), com uma aba por canal.

E-mailPor SMTP, no servidor de e-mail que você já usa, ou pelo serviço Resend.
Discord, Slack e MattermostO aviso cai no canal de conversa da equipe.
TelegramUm robô manda os avisos para um grupo: você informa o token do robô e o ID do chat.
Pushover e WebhookNotificação no celular, pelo Pushover, ou um JSON enviado por POST para outro sistema.

Escolha o provedor de e-mail e os eventos
No painel: NotificationsEmail(Notificações › E-mail)
Na aba de e-mail, escolha o provedor em Email provider. Com None (nenhum), a equipe não recebe e-mail. Depois, marque os eventos em Notification events (eventos avisados).
1. Email provider (provedor de e-mail): SMTP ou Resend.
2. Notification events: os avisos que vão para este canal, agrupados por assunto.

Preencha os dados do SMTP

Use os dados do seu provedor de e-mail. Quem envia é a sua VPS, por isso a porta conta.

Campo	O que preencher
Host	O servidor SMTP do seu provedor, como `smtp.example.com`.
Port	`587` ou `465`.A 25 não funciona na VPS da Hospedagem Segura.
Encryption	StartTLS com a 587, ou TLS/SSL com a 465.
Remetente, usuário e senha	O endereço que aparece como remetente e a conta do SMTP, com a senha que o provedor gerou.

Ou ligue o Telegram
No painel: NotificationsTelegram(Notificações › Telegram)
Informe o Bot API token (o token do robô, que o BotFather do Telegram gera) e o Chat ID (o número do grupo). Clique em Enable (ligar).
Dica O robô precisa estar no grupo para conseguir mandar a mensagem.
Clique em Send Test
Cada aba tem Send Test (enviar teste). Use para confirmar que o aviso chega antes de depender dele.

A porta 25 de saída é bloqueada na VPS

Na VPS da Hospedagem Segura, a porta SMTP 25 de saída é bloqueada por padrão. Configure o SMTP na 587, com StartTLS, ou na 465, com TLS/SSL. Com a 25, o teste não chega.

Eventos que podem gerar aviso
Grupo	Eventos
Deployments	Deploy concluído e deploy com falha
Resources	Mudança de status, limite de reinícios atingido e vulnerabilidades na imagem
Backups	Backup concluído e backup com falha
Scheduled tasks	Tarefa agendada concluída e com falha
Server	Limpeza do Docker concluída e com falha, disco quase cheio, servidor fora e de volta, atualizações do sistema e proxy desatualizado

Numa instalação nova, os avisos de falha já vêm marcados. Alguns chegam sempre, sem opção de desligar: token da API perto de vencer ou com muitas falhas, certificados SSL renovados e atualizações automáticas do Coolify.

Como saber se deu certo

A pessoa convidada aparece em Members com o papel escolhido, e o Send Test do canal configurado chega ao e-mail ou ao grupo da equipe.

Problemas comuns

O teste de e-mail não chega

Causa provável: O SMTP está na porta 25, bloqueada na VPS, ou a criptografia não combina com a porta.
O que fazer: Use 587 com StartTLS ou 465 com TLS/SSL e confira o usuário e a senha do SMTP com o seu provedor de e-mail.

O link de convite não funciona

Causa provável: O link passou dos 3 dias de validade.
O que fazer: Gere outro em Generate Link e mande de novo.

O membro não vê o terminal

Causa provável: O papel Member nunca abre o terminal nem o navegador de arquivos.
O que fazer: Se a pessoa precisa mesmo do terminal, ela precisa do papel Admin. Dê esse papel só a quem administra o servidor.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoSegurança do Coolify: checklist para a sua VPSOs itens que fecham o painel e o servidor: 2FA, cadastro, domínio com HTTPS, portas, API, chaves, banco, o arquivo .env e as atualizações do Ubuntu.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para Coolify Conhecer o VPS Assistido