Serviços prontos no Coolify: instalar pelo catálogo

Resposta rápida

Para instalar um serviço pronto no Coolify, abra o ambiente do projeto, clique em New Resource, busque o software no catálogo (como WordPress, Uptime Kuma ou n8n) e clique em Configure. O Coolify cria o serviço a partir de um modelo Docker Compose. Clique em Deploy e, quando ele estiver rodando, abra o endereço no menu Links. O serviço fica sob a sua administração: a configuração, a atualização e o backup do software continuam com você.

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

Encontrar um software no catálogo de serviços
Publicar o serviço e abrir no navegador
Saber onde fica o domínio de cada contêiner do serviço
Atualizar o serviço trocando a tag da imagem

Antes de começar

O Coolify instalado na sua VPS e um projeto criado (projetos e ambientes)
Para usar o seu domínio: o DNS apontando para o IP da VPS

Neste guia

O que é um serviço no Coolify
Instale um serviço do catálogo
Ligue o seu domínio ao serviço
Atualize um serviço
Problemas comuns

O que é um serviço no Coolify

Uma pilha Docker ComposeUm ou mais contêineres, descritos num arquivo Compose, que o Coolify publica como um recurso só.
Copiado de um modeloNa criação, o Coolify copia o modelo do catálogo. Depois disso, o serviço não acompanha as mudanças do modelo.
Administrado por vocêO serviço não é um serviço gerenciado. Configurar, atualizar e fazer backup do software continua com você.

O catálogo tem softwares como WordPress, Uptime Kuma, n8n e muitos outros, e a lista muda com as atualizações do Coolify. Como o serviço não vem de um repositório Git, ele não tem deploy a cada push, prévias de pull request nem webhooks de deploy.

Instale um serviço do catálogo

Busque o software no catálogo
No painel: ProjectsLoja VirtualproductionNew Resource(Projetos › o seu projeto › o ambiente › novo recurso)
Em New Resource, digite o nome do software na busca. Para wordpress, o catálogo mostra modelos com MariaDB, com MySQL e sem banco.
Escolha o modelo e clique em Configure
Busque uptime kuma, um monitor de sites de código aberto, e clique em Configure (configurar) ao lado de Uptime Kuma. O Coolify cria o serviço a partir do modelo.
Clique em Deploy
O serviço nasce parado (Exited). Em Compose resources aparecem os contêineres, aqui só o Uptime Kuma, com a imagem louislam/uptime-kuma:2: clique em Deploy (publicar).
Abra o endereço em Links
Quando o serviço fica Running (rodando), o menu Links mostra o endereço em que ele responde. Clique para abrir.
Faça a configuração inicial do software
O Uptime Kuma abre a própria configuração inicial, em português, começando pelo banco de dados que ele vai usar. Faça essa configuração logo: até ela terminar, quem abrir o endereço pode criar a conta de administrador.

Ligue o seu domínio ao serviço

O endereço provisório foi gerado pelo Coolify. No serviço, o domínio fica em cada contêiner, e não no serviço inteiro: abra o contêiner na lista Compose resources, troque o endereço pelo seu, como status.loja.example.com, e faça o deploy de novo. O passo a passo do DNS e do HTTPS está em domínios e SSL das aplicações.

Atualize um serviço

Para mudar a versão do software, clique em Edit Compose File (editar o arquivo Compose) e troque a tag da imagem, o trecho depois dos dois-pontos. Salve e faça o deploy de novo.

image: louislam/uptime-kuma:2

A linha da imagem no Compose do serviço. A tag (aqui, 2) define a versão que roda.

O modelo novo não entra sozinho

Quando o Coolify atualiza um modelo do catálogo, o serviço que você já criou continua igual: o modelo novo não é mesclado nele. Antes de trocar de versão, leia as notas do software e faça backup dos dados (volumes e tarefas agendadas).

Cada software tem a sua licença

O catálogo facilita a instalação, mas a licença de cada software é definida por quem o desenvolve. Antes de usar, principalmente para fins comerciais ou para oferecer o software a outras pessoas, confira a licença do software que você vai instalar.

Como saber se deu certo

O serviço aparece como Running, o endereço do menu Links abre o software e você já fez a configuração inicial dele.

Problemas comuns

O serviço não fica Running depois do Deploy

Causa provável: Falta memória na VPS ou o software precisa de uma configuração que ainda não foi feita.
O que fazer: Veja os logs do contêiner do serviço e o consumo do servidor, como em logs, terminal e monitoramento. Pare o que não usa ou passe para um plano com mais memória.

O meu domínio não abre o serviço ou fica sem HTTPS

Causa provável: O DNS ainda não aponta para o IP da VPS ou o domínio foi trocado no lugar errado.
O que fazer: Confira o DNS e se o domínio está no contêiner certo do serviço. Depois faça o deploy de novo. Veja domínios e SSL.

O modelo do catálogo mudou, mas o meu serviço continua igual

Causa provável: O Coolify não mescla o modelo novo num serviço já criado.
O que fazer: Troque a tag da imagem em Edit Compose File, com backup feito antes, e faça o deploy de novo.

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

Próximo passoDeploy automático, webhooks e rollback no CoolifyDeploy a cada push, webhook manual com segredo, deploy pela API, rollback para uma imagem anterior e prévias de pull request.

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