Como instalar o Softaculous no cPanel e WHM imprimir

Como instalar o Softaculous no cPanel e WHM com o instalador oficial, ativar o ionCube, liberar a licença e resolver os erros mais comuns.

• Tempo: 10 min
• Nível: Intermediário
• Vale para: cPanel e WHM 134 a 138 em AlmaLinux, CloudLinux e Ubuntu
• Atualizado: outubro de 2026

O Softaculous é o instalador automático de aplicativos que aparece no cPanel dos seus clientes: WordPress, Joomla, PrestaShop, Moodle e centenas de outros scripts em poucos cliques. Ele é um produto separado do cPanel, com licença própria, e é instalado pelo root no servidor. O antigo método de copiar um arquivo addon_softaculous.php para a pasta do WHM não é mais usado.

Antes de começar

• Acesso SSH como root ao servidor cPanel.
• Licença do Softaculous para o IP do servidor, comprada no site da Softaculous ou com o seu fornecedor de licenças. Sem licença válida o instalador termina, mas o painel avisa que a licença não foi encontrada.
• Saída liberada no firewall para os domínios *.softaculous.com, de onde vêm o instalador e os pacotes dos scripts.

Como instalar o Softaculous no cPanel

1. Ative o ionCube para o PHP interno do cPanel. Em WHM » Server Configuration » Tweak Settings, aba PHP, na opção cPanel PHP loader, marque ioncube e salve. O Softaculous é codificado com ionCube e não roda sem ele.
2. Baixe e rode o instalador oficial como root:

   wget -O install.sh https://files.softaculous.com/install.sh
   chmod 755 install.sh
   ./install.sh

   A instalação leva poucos minutos. Para terminar mais rápido e baixar os pacotes dos scripts em segundo plano, use ./install.sh --quick.
3. Abra o Softaculous no WHM. Atualize o WHM no navegador e entre em WHM » Plugins » Softaculous - Instant Installs. A tela inicial mostra a licença e a versão instalada.
4. Confira no cPanel de um cliente. O ícone do Softaculous aparece na seção de software do cPanel. Se não aparecer, veja os problemas comuns abaixo.

Configurações recomendadas depois de instalar

• Scripts habilitados: em Softaculous » Software, confira se os aplicativos que seus clientes usam (WordPress em especial) estão marcados. Script desabilitado some do cPanel do cliente e também quebra atalhos como o login direto no painel do WordPress.
• Atualizações automáticas: em Softaculous » Settings, defina se as atualizações dos scripts dos clientes serão automáticas e se o backup é feito antes de atualizar.
• WP Toolkit: o cPanel já traz o WP Toolkit para gerenciar WordPress. Os dois convivem, mas é bom decidir qual você vai indicar aos clientes para não confundir.

Problemas comuns

Erro dizendo que o arquivo exige o ionCube PHP Loader

O ionCube não está ativo para o PHP interno do cPanel. Volte ao passo 1 (Tweak Settings » cPanel PHP loader » ioncube) e recarregue a página.

Licença não encontrada ou inválida

A licença foi emitida para outro IP ou ainda não foi ativada. Confira o IP principal do servidor e, se ele mudou, peça ao fornecedor para atualizar a licença.

O ícone não aparece no cPanel dos clientes

O recurso pode estar desligado no pacote ou na lista de recursos (WHM » Packages » Feature Manager). Marque o Softaculous na lista de recursos usada pelas contas.

O "entrar como administrador" do WordPress abre a tela de login comum

O WordPress está desabilitado em Softaculous » Software, então o Softaculous não reconhece a instalação. Habilite o script e teste de novo.

Erro ao baixar o instalador ou os pacotes

O firewall do servidor está bloqueando a saída para files.softaculous.com. Libere a saída HTTP e HTTPS e rode o instalador outra vez.