> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalando o AppSignal para Ruby

Siga primeiro o [guia de instalação](/guides/new-application) ao adicionar uma nova aplicação ao AppSignal.

## Requisitos

Antes de compilar a gem do AppSignal, certifique-se de que as ferramentas de build/compilação estejam instaladas no seu sistema. Verifique a página [Sistemas operacionais suportados](/support/operating-systems) para quaisquer dependências de sistema que possam ser necessárias.

## Instalando a gem

Recomendamos que você instale e gerencie a dependência da gem do AppSignal com o
[Bundler](http://bundler.io/).

Adicione a seguinte linha ao seu `Gemfile`.

<CodeGroup>
  ```ruby Ruby theme={null}
  # Gemfile
  source "https://rubygems.org"

  gem "appsignal"
  ```
</CodeGroup>

Em seguida, execute `bundle install` para instalar a gem.

Para instalar o AppSignal na sua aplicação, recomendamos que você execute o comando `appsignal install`. Forneça a ele sua [Push API key](/appsignal/terminology#push-api-key) para configurá-lo corretamente.

<CodeGroup>
  ```sh Shell theme={null}
  bundle exec appsignal install YOUR_PUSH_API_KEY
  ```
</CodeGroup>

Isso apresentará um script de instalação que pode integrar automaticamente em alguns frameworks e gems e permitirá que você configure o AppSignal.

Para mais informações sobre como integrar o AppSignal à sua aplicação, consulte a [documentação de integrações](/ruby/integrations) para ver quais passos são necessários.

***

<Note>
  📖 Continue com nosso [guia de instalação](/guides/new-application).
</Note>

## Desinstalação

Desinstale o AppSignal do seu app seguindo os passos abaixo. Quando esses passos estiverem concluídos, seu app não enviará mais dados para os servidores do AppSignal.

1. No `Gemfile` do seu app, exclua a linha `gem "appsignal"`.

2. Execute `bundle install` para atualizar seu `Gemfile.lock` com o estado da gem removida.

3. Remova quaisquer [arquivos de configuração](/ruby/configuration/) do AppSignal do seu app.
   * Localização do arquivo de configuração: `config/appsignal.rb` ou `config/appsignal.yml`

4. Remova quaisquer variáveis de ambiente do sistema dos seus hosts de desenvolvimento, staging, produção, etc.
   * Variáveis de ambiente prefixadas com `APPSIGNAL_`

   * Variável de ambiente [`APP_REVISION`](/ruby/configuration/options#option-revision)

5. Commite, faça deploy e reinicie seu app.
   * Isso garantirá que os servidores do AppSignal não continuem recebendo dados do seu app.

6. Opcional: certifique-se de que não há processos `appsignal-agent` rodando em segundo plano.
   * Verifique a saída de `ps aux | grep appsignal-agent` e mate os processos que ainda estiverem rodando.

7. Por fim, [remova o app](/guides/application/deleting-applications) no AppSignal.com.

<Note>
  📖 Continue com nosso [guia de
  desinstalação](/guides/application/deleting-applications).
</Note>