# Como funciona o provisionamento da VPS na StayCloud (instalador do painel, Easypanel ou sistema limpo)

> Toda VPS da StayCloud roda num destes modelos - apps do instalador do painel, um gerenciador de aplicações como o Easypanel, ou um sistema operacional limpo. Os modelos não se misturam, e para trocar de um para outro é preciso reinstalar a VPS, o que apaga tudo.

> **Atenção: este tutorial mexe na segurança da sua VPS.** As mudanças descritas aqui são feitas por sua conta e risco. Confira cada passo antes de aplicar e, se puder, crie um snapshot da VPS antes de começar.

Toda VPS da StayCloud funciona num destes três modelos: **apps do instalador do painel**, **um gerenciador de aplicações** (como o Easypanel) ou **sistema operacional limpo**. Eles não se misturam no mesmo servidor. Para trocar de um modelo para outro, você reinstala a VPS, e a reinstalação apaga tudo o que está nela.

## Para que serve
Entender o provisionamento ajuda a escolher o caminho certo antes de começar e evita surpresas, como abrir a aba **Apps** e encontrar o catálogo desativado. Na prática, você decide quem vai cuidar das aplicações do servidor:

- **O instalador do painel da StayCloud:** você escolhe os apps no painel e a StayCloud instala, conecta e mostra as credenciais.
- **Um gerenciador de aplicações, como o Easypanel:** o gerenciador instala, publica e atualiza os apps, dentro dele mesmo.
- **Você, num sistema limpo:** a VPS vem só com o sistema operacional e você monta tudo por SSH.

## Como funciona na StayCloud

### O instalador do painel é um quebra-cabeça
O instalador de aplicativos, na aba **Minhas VPS › sua VPS › Apps**, funciona como um quebra-cabeça. Cada app é uma peça nova que se encaixa no servidor. Você pode instalar vários de uma vez, ou começar por uma combinação pronta e ir acrescentando peças depois.

Para as peças se encaixarem, todos os apps precisam usar a **stack do painel**, a mesma base de instalação que o instalador monta no servidor. É ela que deixa o painel instalar, remover, acompanhar e mostrar as credenciais de cada app. Um programa que você instala por fora, à mão, não vira peça desse quebra-cabeça, e o painel não consegue gerenciá-lo.

![Catálogo Escolher app por app na aba Apps da VPS, com cards de OpenClaw, Evolution API, n8n, Chatwoot, Hermes, Typebot, Langflow e Open WebUI, cada um com a memória necessária e o tempo de instalação](/imagens/4286f94aad8658008ed655d81aa87b49858be140206f473035bcce68cbe6885b.webp)

### Um gerenciador de aplicações desativa o instalador
O Easypanel, e qualquer outro gerenciador de aplicações, também é um instalador de apps. Ele instala, publica e atualiza os apps por conta própria, e pode fazer limpezas automáticas de disco que não separam o que é dele do que não é.

Dois gerenciadores no mesmo servidor entrariam em conflito. Por isso, quando a VPS tem um gerenciador de aplicações, o painel desativa o catálogo da StayCloud. A aba **Apps** passa a mostrar o gerenciador, com o endereço de acesso, o botão para abri-lo e as credenciais do administrador.

![Aba Apps de uma VPS com o Easypanel: botão Abrir o EasyPanel, endereço de acesso pela porta 3000, botão Ver credenciais e o aviso Este servidor é gerenciado pelo EasyPanel, com o botão Formatar servidor](/imagens/1cf76642164cf9623d95d4346e96891c58a897afe917a661f5c4c548d999113b.webp)

O próprio painel explica: "um app instalado por fora ficaria à mercê dessas limpezas". Para voltar a usar o catálogo da StayCloud, é preciso formatar o servidor.

### Trocar de modelo exige reinstalar a VPS
Você reinstala a VPS nestes casos:

- **Tirar o Easypanel** (ou outro gerenciador) para usar o instalador do painel. Na aba **Apps**, o botão **Formatar servidor** devolve o servidor zerado, e você escolhe a stack de aplicativos.
- **Colocar o Easypanel** (ou outro gerenciador) numa VPS que hoje usa o instalador do painel ou um sistema limpo.
- **Ficar com um sistema operacional limpo**, sem instalador nem gerenciador. Em **Minhas VPS › sua VPS › Sistema › Reinstalar sistema operacional**, você escolhe a imagem do sistema.

O passo a passo da reinstalação está em "Como reinstalar o sistema operacional da VPS pelo painel".

## Em quais planos está disponível
Os três modelos valem para as VPS da StayCloud. Cada app do catálogo mostra no card quanto de memória precisa: confira se o plano da sua VPS comporta os apps que você quer somar.

## Limites e cuidados
- **Formatar ou reinstalar apaga tudo:** apps, bancos, arquivos e configurações. O painel avisa que os snapshots permanecem, mas os dados do disco são perdidos. Antes de trocar de modelo, crie um snapshot e salve o que for importante.
- **Não misture modelos:** não instale um gerenciador de aplicações por SSH numa VPS que usa o instalador do painel, nem coloque apps à mão dentro de um servidor com gerenciador. As limpezas automáticas e o conflito entre os dois podem derrubar ou apagar apps.
- **Apps fora da stack do painel ficam por sua conta:** o painel só gerencia o que ele mesmo instalou.
- **O suporte da StayCloud cuida da infraestrutura:** a equipe ajuda com a VPS, a rede e o provisionamento. A configuração interna dos apps e dos gerenciadores é responsabilidade do cliente.

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

---
Fonte: https://help.staycloud.com/artigos/como-funciona-o-provisionamento-da-vps-na-staycloud-instalador-do-painel-easypan
