# Como instalar uma aplicação na VPS pelo painel

> Em Minhas VPS › Gerenciar › Apps, marque os apps no catálogo (ou escolha uma combinação), clique em Revisar opções de instalação e confirme. O painel instala tudo e mostra o link e a senha na aba Apps.

Para instalar um programa na VPS sem digitar comandos, abra **Minhas VPS › Gerenciar › Apps**, marque os apps que quer no catálogo (ou escolha uma combinação pronta), clique em **Revisar opções de instalação** e confirme. Quando termina, o link e a senha de cada app aparecem na própria aba **Apps**.

## Antes de começar
- Você precisa de uma VPS ativa na StayCloud e de acesso ao painel em `dash.staycloud.com`.
- Confira se a VPS tem memória livre para os apps: cada card mostra quanto o app usa.
- **Se a VPS não foi criada com o instalador, instalar apaga o disco.** O painel avisa antes. Nesse caso, crie um snapshot ou um backup antes de começar.

## Abrir a aba Apps
1. No menu da esquerda, clique em **VPS › Minhas VPS**.
   Resultado: aparece a lista das suas VPS.

![Menu da esquerda com o item Minhas VPS destacado](/imagens/dc4acca4e0e572109bd537d995e66548e62f4a6f995ffb76cbb2d33109d19a6b.webp)

2. Clique em **Gerenciar** na VPS onde quer instalar.
   Resultado: abre a **Visão geral** da VPS.

![Lista Minhas VPS com o botão Gerenciar destacado](/imagens/4d7626178d04c19db8d8fac8ea7e58f25e3704da087ee7cc74751cf51fab527d.webp)

3. Clique na aba **Apps**.
   Resultado: aparece o instalador, com as etapas no topo e o uso de memória e disco da VPS.

![Abas da VPS com a aba Apps destacada](/imagens/7f6e9288e72008bb5c63373490a373afdbf9efb98c02f0fb5d6db5f01fd77248.webp)

![Topo da aba Apps com as etapas Escolha os apps, A gente prepara e instala e Use pelo navegador, e o uso de memória e disco](/imagens/a362165c1d2e0ab00b633c435ce5ca3aa73f2c8a573b0580b1c381a3c1e9eb40.webp)

## Escolher os apps
1. Em **Escolher app por app**, clique no card do app que você quer (por exemplo, **n8n**).
   Resultado: abre uma janela com os detalhes do app: para que serve, memória, disco, tempo de instalação e com quais apps ele combina.

![Catálogo Escolher app por app com os cards dos aplicativos](/imagens/d228768d1ab97207d03bada3dbe8ccb5ff926948a133589c582c62750a22ee3b.webp)

2. Clique em **Selecionar** (no exemplo, **Selecionar n8n**).
   Resultado: o card fica marcado e aparece, no rodapé, uma barra com o número de apps selecionados, a memória somada, se cabe no seu plano e o tempo estimado.

![Janela de detalhes do n8n com o que ele faz, 512 MB de memória, cerca de 3 minutos de instalação, 1,2 GB de disco e o botão Selecionar n8n](/imagens/fa2fce38d34acd09e7a33c1bd8de7e4f9d445039fa4498a9770ff3f672ba00d8.webp)

3. Repita para outros apps, se quiser instalar mais de um.
   Resultado: a barra do rodapé soma os apps escolhidos. Para desfazer, clique em **Limpar**.

![Card do n8n marcado e a barra 1 app selecionado, com 512 MB de memória, cabe no seu plano, e os botões Limpar e Revisar opções de instalação](/imagens/aa25266079920ef7e12852c19fd0aedc11f2d403a85368fc0218f91eab986aa7.webp)

Prefere um conjunto pronto? Desça até **Ou comece por um objetivo** e clique em **Instalar combinação** na combinação que faz sentido para você (por exemplo, **Atendimento no WhatsApp**).

![Combinações recomendadas com o botão Instalar combinação em cada uma](/imagens/93f99f5a1decfeb6367e179c071fdfe9e5765622a7b8b81353705871e5528418.webp)

## Revisar e confirmar
1. Na barra do rodapé, clique em **Revisar opções de instalação**.
   Resultado: abre a tela **Antes de instalar**. Até aqui, nenhuma alteração foi feita.
2. Leia o resumo. Se a VPS ainda não estiver preparada para o instalador, a tela mostra **A instalação direta não está disponível neste servidor**, com a lista do que é preservado (IP e domínios apontados, plano e vencimento, backups já criados) e do que é apagado (arquivos e programas, bancos de dados e sites, configurações feitas por SSH, chaves e snapshots do disco).
   Resultado: você vê também quais apps serão instalados e o tempo total estimado.

![Tela Antes de instalar com o que é preservado e o que é apagado, a recomendação de fazer backup, o n8n na lista de instalação, o campo para digitar APAGAR TUDO e os botões Agora não, Fazer backup antes e Apagar o servidor e instalar n8n](/imagens/b04562de03eff857077e21cfb65625aecbf2b7cdae57abb1455d85c1f33588b0.webp)

3. Se quiser um ponto de volta, clique em **Fazer backup antes**. Para desistir, clique em **Agora não**.
4. Para seguir, digite `APAGAR TUDO` no campo de confirmação (quando o painel pedir) e clique no botão de instalar (por exemplo, **Apagar o servidor e instalar n8n**).
   Resultado: o painel prepara o servidor e instala os apps.

Não quer apagar nada? Contrate uma segunda VPS já com os apps prontos e mantenha a atual como está.

## Como saber se deu certo
Quando a instalação termina, a aba **Apps** passa a mostrar o app instalado, com o endereço de acesso e o botão **Ver credenciais**. Abra o endereço no navegador e entre com o login mostrado.

## Se algo der errado
### O painel diz que a seleção não cabe no plano
Causa: a soma da memória dos apps passa do que a VPS tem. Solução: tire algum app da seleção ou aumente o plano em **Plano › Mudar de plano**.

### O catálogo aparece desativado
Causa: a VPS é gerenciada por outro painel de aplicações, como o EasyPanel. Solução: use esse painel para instalar, ou formate o servidor pela aba **Apps** para passar a usar o catálogo da StayCloud (isso apaga tudo).

## Relacionados
- O que é o instalador de aplicações da VPS pelo painel e como ele funciona
- Como ver as credenciais de uma aplicação instalada pelo painel
- Como criar um snapshot da sua VPS pelo painel antes de uma mudança

---
Fonte: https://help.staycloud.com/artigos/como-instalar-uma-aplicacao-na-vps-pelo-painel
