# Como instalar programas na VPS via SSH

> No terminal da VPS, rode apt update e depois apt install com o nome do programa, por exemplo apt install htop git curl. Para procurar um programa, use apt search; para remover, apt remove.

No Ubuntu e no Debian, os programas são instalados pelo `apt`, o gerenciador de pacotes do sistema. Rode `apt update` e depois `apt install` com o nome do programa. Para procurar, use `apt search`; para remover, `apt remove`.

## Antes de começar
- Acesse a VPS por SSH. Se ainda não sabe como, veja "Como acessar sua VPS por SSH pelo terminal (Linux, Windows e Mac)".
- Os comandos funcionam no Ubuntu e no Debian, os sistemas das VPS da StayCloud.
- Os exemplos supõem que você entrou como `root`. Com outro usuário, coloque `sudo` na frente de cada comando.
- Tenha o nome do programa. Se não souber o nome exato do pacote, veja a seção de busca abaixo.

## Instalar um programa
O exemplo instala três programas úteis: `htop` (ver os processos), `git` (baixar código de repositórios) e `curl` (baixar arquivos e testar endereços).

1. Atualize a lista de pacotes:
   ```
   apt update
   ```
   Resultado: aparecem linhas com `Get:` e `Hit:` e o prompt volta.
2. Instale os programas:
   ```
   apt install htop git curl
   ```
   Resultado: o terminal mostra o que vai instalar e pergunta `Do you want to continue? [Y/n]`. Se um deles já estiver instalado, aparece `is already the newest version`.
3. Digite `y` e aperte `Enter`.
   Resultado: os pacotes são baixados e instalados, e o prompt volta.

Para instalar sem a pergunta de confirmação, acrescente `-y`: `apt install -y htop git curl`.

## Procurar um programa
1. Procure pelo nome ou por uma palavra da descrição:
   ```
   apt search htop
   ```
   Resultado: aparece a lista dos pacotes encontrados, cada um com o nome e uma descrição curta.
2. Veja os detalhes de um pacote antes de instalar:
   ```
   apt show htop
   ```
   Resultado: aparecem a versão, o tamanho e a descrição completa.

## Remover um programa
1. Remova o programa:
   ```
   apt remove htop
   ```
   Resultado: o terminal pede confirmação. Digite `y` e aperte `Enter`. O programa sai, mas os arquivos de configuração ficam.
2. Para remover também a configuração, use `purge`:
   ```
   apt purge htop
   ```
   Resultado: o programa e a configuração dele saem.
3. Limpe as dependências que ficaram sobrando:
   ```
   apt autoremove
   ```
   Resultado: o terminal lista os pacotes que não são mais usados e pede confirmação.

Cuidado ao remover: confira na lista do terminal o que vai sair antes de digitar `y`. Se aparecerem pacotes que você não reconhece, responda `n`.

## Como saber se deu certo
Rode o programa ou peça a versão dele:

```
htop --version
git --version
curl --version
```

Cada comando deve mostrar a versão instalada. Para conferir se um pacote está instalado, rode `apt list --installed htop`: ele aparece na lista com `[installed]`.

## Se algo der errado
### "E: Unable to locate package"
Causa: a lista de pacotes está desatualizada ou o nome está errado. Solução: rode `apt update` e tente de novo. Se continuar, procure o nome certo com `apt search`.

### "Could not get lock /var/lib/dpkg/lock-frontend"
Causa: outra instalação ou atualização está rodando, muitas vezes a atualização automática de segurança. Solução: espere alguns minutos e tente de novo. Não apague o arquivo de trava.

### "Permission denied" ou "are you root?"
Causa: você entrou com um usuário comum. Solução: coloque `sudo` na frente do comando, por exemplo `sudo apt install htop`.

### O programa não está no apt
Causa: alguns programas não estão nos repositórios do Ubuntu ou do Debian, ou estão numa versão antiga. Solução: siga as instruções oficiais do próprio programa. Prefira sempre o site oficial dele e desconfie de scripts de fontes desconhecidas.

## Relacionados
- Como atualizar o sistema da VPS via SSH
- Como instalar o Docker na VPS via SSH
- Comandos básicos de Linux para usar na sua VPS via SSH
- Como acessar sua VPS por SSH pelo terminal (Linux, Windows e Mac)

---
Fonte: https://help.staycloud.com/artigos/como-instalar-programas-na-vps-via-ssh