Não conseguir instalar uma extensão pode ser o resultado de problemas com a extensão, as preferências do Firefox ou a versão do Firefox que você esta usando. Este artigo descreve várias causas de problemas de instalação e o que você pode fazer corrigi-los.

O complemento não é compatível

Um arquivo interno em cada complemento indica as versões do Firefox com as quais a extensão é compatível. No site de Complementos para o Firefox da Mozilla você poderá encontrar informações sobre a compatibilidade de cada extensão disponível.

Se sua versão do Firefox estiver entre as versões compatíveis, a instalação do complemento resultará em um erro, indicando que o complemento não é compatível. Se sua versão do Firefox é incompatível com o complemento, você pode:

• Atualizar para a versão mais recente do Firefox. Para mais informações, veja Atualizando o Firefox.
• Encontrar um versão do complemento que é compatível com a sua versão do Firefox. O site Mozilla Add-ons normalmente oferece a versão mais atualizada de cada Complemento.
• Use uma extensão diferente. Para várias extensões há extensões similares que oferecem a mesma funcionalidade. Para mais informações, visite o Mozilla Add-ons.

Instalação de Software desativada

É possível desativar todas as instalações de software pelo Firefox, incluindo complementos. Para verificar se a instalação de software esta desativada:

1. No Campo de endereços, digite about:config e pressione EnterReturn.

   • O aviso "As modificações destas configurações avançadas pode prejudicar a estabilidade, a segurança e o desempenho deste aplicativo"' da página about:config poderá aparecer. Clique em Serei cuidadoso, eu prometo! para continuar.
2. Insira xpinstall.enabled na caixa de texto FiltrarLocalizar.
3. O valor de xpinstall.enabled deve ser definido para true. Se esse valor estiver definido atualmente como false, então a instalação de softwares esta desativada.
4. Para alterar o valor para true, clique com o botão direitosegure a tecla Ctrl enquanto você clica no nome da propriedade e selecione Restaurar o padrão.
5. Tente reinstalar a extensão.

O Firefox impediu o site de instalar o complemento

Por padrão, o Firefox permite instalar complementos somente de sites confiáveis. Se o site do qual você está instalando o complemento não está na lista de sites confiáveis, uma barra aparecerá no topo da página com uma mensagem parecida com a seguinte:

Para permitir a instalação, clique no botão Permitir.

Para adicionar um site à lista de sites confiáveis:

1. No topo da janela do FirefoxNa barra de menus, clique no menu FerramentasFirefox, e depois clique em OpçõesFirefoxEditar e selecione Opções…Preferências…
2. Selecione o painel Segurança.
3. Ao lado de "Alertar se sites tentarem instalar extensões ou temas", clique em Exceções....
4. O diálogo Sites permitidos - Instalação de extensões e temas será exibido com a lista de sites permitidos.
5. Insira o endereço do site o qual você deseja permitir que instale complementos na caixa de texto.
6. Para permitir o site, clique em Permitir. Em seguida, clique em Fechar.

Você é perguntado se deseja baixar o complemento em vez de instala-lo

Alguns sites servem os complementos como downloads, pedindo que você baixe o arquivo do complemento para seu computador antes de instalá-lo.

• Esses arquivos são geralmente .xpi ou .jar.

1. Baixe o arquivo para o seu computador.
2. No menu do topo da janela do Firefox, clique no menu Ferramentas e selecione Complementos. O Gerenciador de complementos será exibido.
3. Para adicionar um complemento baixado à lista de complementos disponíveis, arraste e solte o arquivo no Gerenciador de complementos. O Complemento será adicionado à lista.
4. O processo de instalação deve começar.

Assinatura do arquivo inválida (provável download corrompido) (-261)

Esse erro pode ocorrer quando o Firefox está configurado para não aceitar cookies de terceiros. Para evitar esse erro, você precisa ativar temporariamente os cookies de terceiros.

1. No topo da janela do FirefoxNa barra de menus, clique no menu FerramentasFirefox, e depois clique em OpçõesFirefoxEditar e selecione Opções…Preferências…
2. Selecione o painel Privacidade.
3. Marque a caixa Inclusive cookies de elementos fora do site visitado.

Falha no download (-228)

Cache desativado

Esse erro pode ocorrer quando o cache do Firefox está desativado. Para reativar o cache do Firefox:

1. No topo da janela do FirefoxNa barra de menus, clique no menu FerramentasFirefox, e depois clique em OpçõesFirefoxEditar e selecione Opções…Preferências…
2. Selecione o painel Avançado.
3. Clique na aba Rede.
4. Na seção Cache de conteúdo web, o tamanho do cache deve ser de no mínimo 1 MB.

Erro de instalação não previsto (-203)

Leia o artigo Unexpected installation error -203 when installing add-ons.

Nada acontece quando você clica no link de instalação

Se você clica em um link de instalação e nada acontece, você deve verificar se o JavaScript esta ativado. Para mais informações, leia JavaScript.

Arquivos de extensões corrompidos

Arquivos de configurações de extensões corrompidos podem causar problemas ao tentar instalar uma extensão. Excluir esses arquivos fará com que o Firefox os crie novamente (removendo qualquer corrupção) na próxima vez que for iniciado. Você não perderá suas extensões ou suas configurações ao excluir esses arquivos.

1. Abra a pasta do seu perfil:

   • (Firefox 3.5): Veja Como encontro o meu perfil?
   • (Firefox 3.6):
     1. No topo da janela do FirefoxNa barra de menus, clique no menu Ajuda e selecione Dados para suporte. A aba Dados para suporte será aberta.
     2. Em Informações básicas sobre o aplicativo, clique em Abrir pastaAbrir no Finder. Uma janela com os arquivosa pasta do seu perfil será aberta.
   1. No topo da janela do FirefoxNa barra de menus, clique no menu AjudaFirefox, vá para o menu Ajuda (no Windows XP, clique no menu Ajuda) e selecione Dados para suporte. A aba Dados para suporte será aberta.
   2. Na seção Informações básicas sobre o aplicativo, clique em Abrir pastaAbrir no Finder. Uma janela com os arquivosa pasta do seu perfil será aberta.

2. No topo da janela do Firefox, clique no botão Firefox (menu Arquivo no Windows XP) e então clique em SairNo topo da janela do Firefox, clique no menu Arquivo e selecione SairNa barra de menus, clique no menu Firefox e selecione Fechar o FirefoxNo topo da janela do Firefox, clique no menu Arquivo, e então selecione Sair
3. Exclua os seguintes arquivos:

• • extensions.ini
  • extensions.cache
  • extensions.rdf

1. Reinicie o Firefox.

O complementos está bloqueado

Certos complementos estão em uma lista de complementos bloqueados pela Mozilla por serem inseguros. Para mais informações, leia Complementos inseguros ou instáveis na lista de bloqueios (blocklist).

Baseado em informações do artigo Unable to install themes or extensions - Firefox (mozillaZine KB)