---
updatedAt: 2025-05-14T08:14:16.000Z
agentTools:
  projectIndex: https://learn.vtex.com/llms.txt
---

# Instalando uma app em uma conta VTEX

<HTMLBlock>{`
<style>
      section#hub-content header h1, section#hub-content header h2 {
        color: #f71963
      }
    
      p {
        line-height: 1.5rem;
      }
    </style>
`}</HTMLBlock>

# Instalando uma *app* no VTEX IO

## Introdução

Uma vez que você publica uma *app*, é possível instalá-la em uma conta VTEX. Em geral, depois de instalar, há um robô chamado *House Keeper*, que se assegura de que todas as contas VTEX se mantenham com as *apps* atualizadas com a versão mais recente. Versões *minors* e *patches* que são lançadas, são automaticamente atualizadas nas contas.

Porém, para instalar uma *app* pela primeira vez ou uma nova versão *major*, é necessário que seja feito manualmente. Neste passo, você aprenderá como fazer isso.

## Instalando a app

Como no passo anterior, é necessário apenas um único comando para instalar uma *app* em uma conta específica. Há duas possíveis situações para isso:

* Você não tem o repositório raiz do projeto da *app*, mas você sabe o *vendor*, o nome da *app* e também a versão que você gostaria de instalar;
* Você tem o projeto da aplicação no seu computador.

No primeiro caso, você pode instalá-la rodando o seguinte comando:

```
vtex install `{vendor}.{appName}@{version}`
```

Já no caso de ter projeto da *app*, você precisar ir na pasta do projeto e rodar o seguinte comando:

```
vtex install
```

> Em ambos os casos, você precisa ter certeza que está na conta correta, na qual você quer instalar a aplicação.

Considerando o caso que temos neste passo - tendo o projeto da *app* - é tão simples como rodar o segundo comando que foi mencionado anteriormente.

Em primeiro lugar, tenha certeza de que está na conta correta, utilizando o comando `vtex whoami`; você irá instalar a *app* na conta `appliancetheme`. Ao rodar o comando, o resultado deve ser similar a imagem abaixo:

![image](https://user-images.githubusercontent.com/19495917/88828271-62750f00-d1a1-11ea-89d0-068340f8b522.png)

Agora, vá até a pasta correta, que é a do projeto da *app*, e rode o seguinte comando:

```
vtex install
```

Após executá-lo, é esperado que você veja uma mensagem que constata que a *app* foi instalada com sucesso, como a imagem abaixo:

![image](https://user-images.githubusercontent.com/19495917/88828538-c0095b80-d1a1-11ea-86cf-bac9cfdf554e.png)

Dica: se você quer listar as *apps* que estão atualmente instaladas em uma conta, você pode utilizar o comando `vtex ls`, você verá uma lista semelhante a seguinte imagem:

![image](https://user-images.githubusercontent.com/19495917/88828816-1e363e80-d1a2-11ea-88bb-b3f082b90877.png)

> **Atenção**: Há mais informação ao rodar o comando mencionado acima, mas foi omitida da imagem devido a sua extensão.

<hr/>
<div id="contribute-container">
  <p id="contribute-title"> 
    Ajude-nos a fazer este conteúdo melhor!
  </p>
  <p id="contribute-description">
    Os cursos do VTEX IO são de código aberto. Se você perceber algum problema, pode abrir um pull request!
  </p>

  <a id="contribute-button" href="https://github.com/vtex/vtex-courses/edit/master/courses/content-workflow/steps/03_installing-app/pt.md">
    Faça uma contribuição
  </a>

  <p id="contribute-issue">
    ou <a href="https://github.com/vtex/vtex-courses/issues/new/choose">abra uma issue</a>
  </p>

</div>