Base de Conhecimento

Joomla na VPS: como instalar seu site

  • joomla, cms, vps, php, nginx, apache
  • Usuários acharam útil: 0

Instale o Joomla numa VPS: requisitos do Joomla 6, PHP e banco de dados, instalação no navegador ou pelo terminal, Nginx e Apache, segurança, atualização e backup.

Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Joomla na VPS: como instalar seu site

Capa da Redação Eleven Host para o guia: Joomla na VPS: como instalar seu site Arte: Eleven Host

Joomla na VPS é o caminho para ter um site com o CMS Joomla num servidor seu: você prepara PHP, banco de dados e servidor web, envia os arquivos e conclui a instalação no navegador. Veja requisitos, passo a passo, segurança e backup.

Atualizado em 05/11/2026. Nessa data, a versão mais recente do Joomla é a 6.2.0, publicada em 13/10/2026, e a linha 5.x está na 5.4.10. Trate as versões como um retrato do dia e confira a página de downloads antes de começar.

O que é o Joomla

O README oficial descreve o Joomla como um sistema de gerenciamento de conteúdo (CMS) para criar sites e aplicações online. Ele é software livre e aberto, distribuído sob a GNU General Public License, versão 2 ou posterior.

O guia oficial de instalação é escrito para hospedagem com cPanel e envio por FTP. O passo a passo abaixo adapta essas etapas a uma VPS, com exemplos de comandos para você conferir no seu servidor. O repositório do código no GitHub também não serve para instalar direto, porque o próprio projeto avisa que o Joomla não é instalável a partir dele. Use o pacote da página de downloads.

Para a linha 6.x, o manual do Joomla exige PHP 8.3.0 ou mais novo, e o PHP 8.4 aparece como a versão indicada. Confira a versão do PHP do servidor antes de enviar os arquivos.

Requisitos do Joomla 6

Se você ainda não tem um servidor, o guia de servidor VPS explica o que é e como escolher o plano. Os requisitos vêm da tabela do manual do Joomla para a linha 6.x:

  • PHP: a partir da 8.3.0 é suportado, e a 8.4 é a indicada na tabela;
  • MySQL: a partir da 8.0.13 é suportado, e a 8.4 é a indicada;
  • MariaDB: a partir da 10.6 é suportado, e a 12.0 é a indicada;
  • servidor web: Apache 2.4 ou Nginx a partir da 1.26, sendo a 1.29 a indicada.

As extensões de PHP exigidas são json, simplexml, dom, zlib, gd e uma entre mysqlnd, pdo_mysql ou pdo_pgsql. O mbstring é indicado, e o manual aponta um limite de memória do PHP de pelo menos 256 MB. No Apache, o módulo mod_rewrite é opcional e serve para URLs amigáveis. O guia de instalação traz estes valores de PHP como referência: memory_limit 256M, upload_max_filesize 64M, post_max_size 64M e max_execution_time 30.

Um cuidado com o banco: suportado pelo Joomla não quer dizer que o fabricante ainda mantém aquela versão. O MySQL 8.0 chegou ao fim da vida em abril de 2026, e o MariaDB 10.6 passou do fim de manutenção comunitária em 06/07/2026. Recomendamos escolher uma versão de banco que ainda receba atualizações, como o MySQL 8.4 ou o MariaDB 12.0 da tabela.

Vamos olhar os planos de VPS? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos

Prepare o servidor

Um exemplo de comandos para Debian ou Ubuntu, que você deve conferir no seu servidor antes de rodar. Ele instala o Nginx, o MariaDB, o PHP com as extensões usuais e o unzip:

sudo apt install nginx mariadb-server php-fpm php-mysql php-gd php-xml php-zip php-mbstring unzip

sudo mysql

Se você prefere o Apache, instale-o no lugar do Nginx e siga a documentação do Apache da sua distribuição.

Crie o banco e o usuário

O guia oficial manda criar o banco e o usuário antes da instalação e anotar o host, o nome do banco, o usuário e a senha, porque o instalador pede esses dados. Um exemplo de comandos SQL, dentro do cliente aberto no passo anterior, com uma senha fictícia que você deve trocar:

CREATE DATABASE joomla CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'joomla'@'localhost' IDENTIFIED BY 'SENHA_FORTE';

GRANT ALL ON joomla.* TO 'joomla'@'localhost';

Depois do último comando, saia do cliente com exit. O usuário recebe permissão só sobre o banco do Joomla. Se for montar mais de um site na mesma VPS, vale separar um banco e um usuário para cada um.

Baixe e envie os arquivos

Baixe a versão atual na página oficial de downloads do Joomla. O guia avisa que, ao descompactar, você deve mover só as pastas e os arquivos de dentro do pacote, e não a pasta que o contém. Ele também orienta usar nomes de pasta em minúsculas e sem espaços. Um exemplo de comandos, trocando o nome do pacote pelo que você baixou:

sudo mkdir -p /var/www/joomla

sudo unzip PACOTE_BAIXADO.zip -d /var/www/joomla

sudo chown -R www-data:www-data /var/www/joomla

O usuário www-data é o do Nginx e do Apache no Debian e no Ubuntu. Em outras distribuições o nome muda, então confira o do seu servidor.

Configure o servidor web

O guia de hospedagem do Joomla traz um arquivo de exemplo para o Nginx, e a própria página pede que você troque o domínio e o caminho da pasta. Nas distribuições atuais, o PHP-FPM pode estar num socket Unix em vez da porta 9000, então abra esse guia e compare com o seu servidor. O bloco abaixo é um exemplo a conferir, e não a configuração oficial. Um exemplo de arquivo para /etc/nginx/sites-available/:

server {

listen 80;

server_name exemplo.com.br;

root /var/www/joomla;

index index.php;

add_header X-Content-Type-Options nosniff;

location / {

try_files $uri $uri/ /index.php?$args;

}

location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {

return 403;

}

location ~ \.php$ {

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_pass 127.0.0.1:9000;

}

}

Troque exemplo.com.br pelo seu domínio. O endereço 127.0.0.1:9000 depende de como o PHP-FPM está configurado: confira no seu servidor se ele escuta nessa porta ou num socket e ajuste a linha fastcgi_pass. Um exemplo de comandos para ativar o arquivo, testar a sintaxe e recarregar o servidor, supondo que você o salvou como /etc/nginx/sites-available/joomla:

sudo ln -s /etc/nginx/sites-available/joomla /etc/nginx/sites-enabled/joomla

sudo nginx -t

sudo systemctl reload nginx

No Apache, o guia do arquivo .htaccess manda renomear o htaccess.txt que vem no Joomla para .htaccess. Ele também avisa para não editar o htaccess.txt, porque uma atualização do Joomla pode sobrescrevê-lo e as mudanças se perdem.

Aponte o domínio

Para o site abrir pelo nome, o domínio precisa apontar para o IP da VPS. Se ainda não tem domínio, veja o artigo Como criar site: do domínio ao ar, que mostra o caminho inteiro. Para domínios registrados conosco, o DNS gerenciado é grátis na rede da Cloudflare, com painel na área do cliente. Quem for colocar vários sites na mesma VPS pode olhar o guia do Nginx Proxy Manager.

Conclua a instalação no navegador

Abra o domínio no navegador e siga o instalador, que segue esta ordem, segundo o guia oficial:

  • escolha o idioma e o nome do site;
  • informe os dados do Super User, o administrador do site;
  • preencha os dados do banco: tipo MySQLi, host, usuário, senha, nome do banco, prefixo das tabelas e criptografia da conexão;
  • clique em Install Joomla.

Segundo o guia oficial, em uma instalação de produção o Joomla remove sozinho a pasta installation ao terminar. Depois de instalar, confira no servidor se ela realmente sumiu.

Instalação pela linha de comando

O Joomla também tem um instalador de terminal, descrito no guia de linha de comando. Os comandos oficiais são estes, rodados de dentro da pasta onde o Joomla foi descompactado (por exemplo, /var/www/joomla):

php installation/joomla.php install

php installation/joomla.php help install

O exemplo do guia usa opções como --site-name, --admin-user, --admin-username, --admin-password, --admin-email, --db-type, --db-host, --db-user, --db-pass, --db-name, --db-prefix, --db-encryption e --public-folder. Para saber quais são obrigatórias e quais valem na sua versão, rode o help install no seu servidor.

Instalador automático da hospedagem

O guia de hospedagem do Joomla diz que os especialistas, em geral, desaconselham o instalador automático que algumas hospedagens oferecem. Numa VPS você não depende dele: o caminho manual acima dá o controle de cada etapa.

Depois da instalação

Ao entrar no painel, leia as mensagens pós-instalação. Segundo o guia, elas trazem sobretudo ajustes de segurança e mudanças de arquivo que devem ser feitas à mão. O guia de boas práticas de segurança diz que é muito recomendável ativar a autenticação em vários fatores do Joomla, que acrescenta uma camada de proteção ao login.

Recomendamos não copiar permissões de arquivos de tutoriais sem conferir o que cada uma faz no seu servidor.

Atualização do Joomla

O README do projeto diz que as atualizações são gratuitas e orienta usar a versão mais recente. Em 05/11/2026, a linha 6.x tem correções previstas até 17/10/2028 e segurança até 16/10/2029, segundo a página de roadmap do projeto, que avisa que as datas são tentativas. A linha 5.x teve a 5.4.10 como última versão de correções de bugs e, daqui para a frente, recebe só atualizações de segurança, por mais um ano, segundo o anúncio da 5.4.10.

Quem está na 5.4 e quer ir para a 6.2 deve saber que, segundo o anúncio do Joomla 6.2, isso é uma atualização, e não uma migração. Antes de atualizar, faça o backup descrito a seguir.

Backup do site

O guia oficial de backup explica que um backup do Joomla tem duas partes: os arquivos da pasta raiz do site e o banco de dados. O guia recomenda a extensão Akeeba Backup e cita o mysqldump e o zip como alternativas manuais.

Teste a restauração

O guia pede que, depois de restaurar, você confira se o site restaurado funciona direito. Recomendamos guardar uma cópia fora da própria VPS e treinar a restauração antes de precisar dela.

Para quem vai escolher um servidor

A loja mostra os planos de VPS disponíveis e o que cada um inclui.

Mensalidade de servidor cabe no seu bolso? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer os planos

Perguntas frequentes

Qual versão do PHP o Joomla 6 pede?

O manual exige PHP 8.3.0 ou mais novo para a linha 6.x e indica o PHP 8.4 como a versão recomendada na tabela.

Dá para usar MySQL ou MariaDB?

Sim. O Joomla 6 suporta MySQL a partir da 8.0.13 e MariaDB a partir da 10.6. Como o MySQL 8.0 e o MariaDB 10.6 já saíram de manutenção, recomendamos uma versão mais nova do banco.

Preciso apagar a pasta installation?

Segundo o guia, a instalação de produção remove a pasta sozinha. Confira no servidor se ela sumiu ao terminar.

Como fazer backup do Joomla?

O guia oficial de backup recomenda a extensão Akeeba Backup e cita o mysqldump e o zip como opções manuais. O backup tem duas partes: os arquivos do site e o banco de dados.

O Joomla é gratuito?

Sim. Ele é software livre, distribuído sob a GNU General Public License, versão 2 ou posterior.

Esta resposta lhe foi útil?

Artigos Relacionados