O recurso Aplicativos com um clique permite navegar por um amplo catálogo de aplicativos e fazer o deploy deles diretamente pela interface web do seu VPS. Neste guia, você aprenderá a preparar seu servidor, escolher o tipo de instalação correto, instalar e gerenciar aplicativos e usar configurações avançadas e ferramentas de solução de problemas quando necessário.
Antes de usar o recurso Aplicativos com um clique, seu VPS precisa atender aos requisitos mínimos e usar um sistema operacional compatível.
Requisitos mínimos O recurso Apps exige que seu VPS esteja online e configurado com recursos suficientes para executar de forma confiável tanto os serviços da plataforma quanto os aplicativos instalados.
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Status do servidor | Online | Online |
| Espaço em disco | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 núcleos | 4 núcleos |
| Sistema operacional | Debian ou Ubuntu LTS | Debian 13 |
Recomendamos um sistema operacional recém-instalado Recomendamos fortemente configurar o recurso Apps em uma instalação nova do sistema operacional. Isso ajuda a evitar conflitos com serviços existentes, portas ocupadas, configurações do Docker ou outras configurações personalizadas que já estejam no servidor.
Se precisar reinstalar seu VPS, use uma imagem nova e compatível do Debian ou Ubuntu LTS na interface de gerenciamento do VPS.
Após o deploy, seus aplicativos instalados serão listados na área de gerenciamento da aba. Nela, você pode monitorar e controlar seus serviços sem precisar interagir manualmente com os contêineres subjacentes.
A área de aplicativos instalados permite executar ações comuns do ciclo de vida diretamente na aba.
| Ação | Finalidade |
|---|---|
| Iniciar | Inicia um aplicativo parado |
| Parar | Para um aplicativo em execução |
| Ver logs | Abre os logs do aplicativo para solucionar problemas |
| Reinstalar | Reinstala o aplicativo |
Essas ferramentas facilitam o gerenciamento de todos os aplicativos em um só lugar, especialmente se você prefere o controle simples pela web em vez de usar a linha de comando manualmente.
Projetos e ambientes ajudam a estruturar seus deploys com clareza. Você pode usá-los para separar:
- Aplicativos pessoais e de produção
- Ambientes de teste e de produção
- Deploys de vários clientes ou equipes
- Diferentes stacks no mesmo VPS
Essa organização se torna cada vez mais importante à medida que sua coleção de aplicativos cresce e você gerencia mais serviços em um ou vários Nodes.
O recurso Aplicativos com um clique oferece suporte a domínios personalizados e à integração com a ZAP Cloud. Assim, você pode disponibilizar aplicativos com segurança e fornecer certificados SSL para seus deploys.
Suporte a domínios e SSL Você pode usar domínios personalizados para seus aplicativos e aproveitar a emissão automática de certificados SSL, desde que a plataforma ofereça suporte à configuração.
Ao atribuir um domínio, certifique-se de que seus registros DNS apontem para [deine_server_ip]. Se o domínio não estiver configurado corretamente, talvez o aplicativo não fique acessível pela internet.
| Valor | Descrição |
|---|---|
[deine_domain] | O domínio ou subdomínio atribuído ao seu aplicativo |
[deine_server_ip] | O endereço IP público do seu VPS |
O DNS precisa apontar para seu VPS
Se o DNS de [deine_domain] não apontar para [deine_server_ip], a validação do domínio e o acesso ao aplicativo poderão falhar.
Se o painel indicar um status degradado, isso significa que a plataforma não consegue acessar a instância que executa o recurso Aplicativos com um clique ou recuperar dados dela. Siga as etapas de solução de problemas na ordem indicada.
A janela de solução de problemas pode mostrar os seguintes indicadores:
| Status | Significado |
|---|---|
| Status do Coolify: Ativo | O serviço do painel parece estar em execução |
| Status da API: Acessível | A API está acessível no momento |
| Status do serviço: Online | Seu VPS está online |
Se um ou mais componentes não estiverem funcionando corretamente, continue com as etapas a seguir.
Primeiro, confira se seu VPS está online no painel ZapX. Se o servidor estiver offline, a plataforma Apps não poderá funcionar.
Use a ação Atualizar status para executar novamente a verificação de integridade com os dados mais recentes. Isso pode resolver problemas temporários de conexão.
Problemas temporários de conexão Às vezes, um status degradado é causado por problemas temporários de comunicação. Atualizar o status é a forma mais rápida de fazer uma primeira verificação.
Se o status continuar degradado, use a ação Reiniciar Docker. Isso reinicia a instância da plataforma. Depois de receber a confirmação de sucesso, aguarde 1-2 minutos e atualize o status novamente.
Reinicialização do serviço Reiniciar o Docker pode interromper temporariamente os aplicativos em execução enquanto os serviços são reiniciados.
Como última etapa, use Atualizar credenciais. Isso é especialmente importante se o status indicar que está tudo online, mas recursos do painel, como a instalação de aplicativos, não estiverem funcionando.
Essa ação:
- Não exclui seus dados
- Atualiza as credenciais do usuário root
- Renova o token da API usado pelo painel
- Atualiza automaticamente as credenciais do painel quando a operação é concluída com sucesso
Atualização segura das credenciais Atualizar as credenciais não remove aplicativos instalados nem dados de deploy. Apenas renova as credenciais necessárias para acesso e comunicação.
Se o problema persistir após todas as etapas de solução de problemas, abra um chamado de suporte pelo site da ZAP-Hosting.
Para manter o recurso Aplicativos com um clique estável e fácil de gerenciar, siga estas recomendações:
| Boa prática | Motivo |
|---|---|
| Usar uma instalação nova do sistema operacional | Evita conflitos com serviços existentes e portas ocupadas |
| Atender aos requisitos de recursos recomendados | Melhora o desempenho e a confiabilidade |
| Organizar os aplicativos em projetos e ambientes | Mantém os deploys organizados |
| Configurar o DNS antes de atribuir um domínio | Evita problemas de acesso e SSL |
| Usar as configurações avançadas com cuidado | Evita alterações personalizadas sem suporte |
Mantenha seus deploys organizados
Se quiser hospedar muitos aplicativos, defina um padrão claro de nomes para [dein_projektname], [dein_umgebungsname] e [dein_appname] antes do primeiro deploy.
Fonte preferida no Google
