Base de Conhecimento

PrestaShop na VPS: como instalar sua loja virtual

  • prestashop na vps, prestashop, loja virtual, docker, vps
  • Usuários acharam útil: 0

Aprenda a instalar o PrestaShop no seu servidor com Docker, trocar as senhas, instalar pelo navegador, esconder o painel, ligar o HTTPS e fazer o backup.

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

Arte da Eleven Host: janela de terminal com o título: PrestaShop na VPS: como instalar sua loja virtual

Capa da Redação Eleven Host para o tutorial: PrestaShop na VPS: como instalar sua loja virtual Arte: Eleven Host

PrestaShop na VPS é a sua loja virtual hospedada por conta própria. A imagem oficial roda no Docker junto com um banco MySQL, e o instalador pelo navegador conclui a configuração da loja.

O que é o PrestaShop e qual é a licença

O PrestaShop é uma aplicação de e-commerce livre e de código aberto, escrita em PHP. O projeto mantém imagens oficiais no Docker, feitas sobre a imagem oficial do PHP, o que permite subir a loja e o banco com poucos comandos.

Na documentação do projeto, o Docker é apresentado para testar, experimentar e desenvolver módulos ou temas. Por isso, trate os comandos deste guia como ponto de partida e revise cada item antes de abrir a loja ao público.

Segundo o arquivo de licença do projeto, o núcleo do PrestaShop é licenciado sob a OSL-3.0, e os módulos, sob a AFL-3.0. Em caso de dúvida sobre uso comercial, consulte um profissional.

Antes de começar

Se você está conhecendo servidores agora, leia primeiro o guia de iniciantes sobre servidor VPS. Para este tutorial, você precisa de:

  • Docker instalado na VPS.
  • Um domínio ou subdomínio, como loja.exemplo.com, apontado para o IP da VPS, se você quiser acessar com HTTPS.

Na versão 9.2.0, publicada em 30 de setembro segundo a página de releases do GitHub, a documentação do PrestaShop 9 informa os requisitos de software:

  • PHP: a versão 9.0 suporta do PHP 8.1 ao 8.4, e a 9.1 suporta do 8.1 ao 8.5. A documentação recomenda o PHP 8.5.
  • Banco: MySQL 5.7 ou MariaDB 10.2, no mínimo, e a documentação recomenda uma versão recente.
  • Servidor web: Apache 2.4 ou posterior (o Nginx 1.0 ou posterior também é aceito).
  • PHP: memory_limit de pelo menos 512M e allow_url_fopen ligado, além de extensões como CURL, DOM, Fileinfo, GD, Iconv, Intl, JSON, Mbstring, OpenSSL, PDO, PDO MySQL, SimpleXML e Zip.

A documentação não informa quanto de memória, processador ou disco o servidor precisa. Comece pequeno, acompanhe o consumo e ajuste conforme o tamanho do seu catálogo.

Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Passo a passo: rede, banco e loja

O README do Docker do PrestaShop instala em três comandos: cria uma rede para os contêineres conversarem, sobe o MySQL e sobe a loja. A documentação do PrestaShop 9 mostra o mesmo desenho em um arquivo do Docker Compose. Aqui usamos os comandos, com alguns ajustes que explicamos logo depois. Primeiro, a rede:

docker network create prestashop-net

Agora o banco. Troque SENHA-FORTE por uma senha forte e guarde-a em um lugar seguro:

docker run -d --name some-mysql --network prestashop-net --restart unless-stopped -e MYSQL_ROOT_PASSWORD=SENHA-FORTE -e MYSQL_DATABASE=prestashop -v prestashop-db:/var/lib/mysql mysql:8.4

E por fim a loja, com a mesma senha:

docker run -d --name prestashop --network prestashop-net --restart unless-stopped -e DB_SERVER=some-mysql -e DB_NAME=prestashop -e DB_USER=root -e DB_PASSWD=SENHA-FORTE -e PS_DEV_MODE=0 -p 127.0.0.1:8080:80 prestashop/prestashop:latest

O que muda em relação ao exemplo da documentação:

  • Senha do banco. O exemplo usa a senha admin para o usuário root do MySQL. Use a mesma senha forte nos dois comandos (MYSQL_ROOT_PASSWORD e DB_PASSWD), antes da primeira subida, porque o banco é criado com esse valor.
  • Versão do MySQL. O exemplo usa mysql:5.7, que é o mínimo aceito. Como a própria documentação recomenda uma versão recente, usamos mysql:8.4. Confira no Docker Hub se a etiqueta existe no dia da sua instalação.
  • Porta só no servidor. O exemplo publica 8080:80, que deixa a porta aberta nas interfaces do servidor. Com 127.0.0.1:8080:80, só o próprio servidor acessa, e o acesso de fora passa por um proxy com HTTPS. O exemplo também publica a porta 3307 do MySQL; aqui ela não é publicada, e é bom que continue assim.
  • Modo desenvolvedor. A documentação e o README do Docker divergem sobre o valor padrão de PS_DEV_MODE. Por isso, definimos PS_DEV_MODE=0 de forma explícita.
  • Volume do banco. O parâmetro -v prestashop-db:/var/lib/mysql guarda os dados do MySQL fora do contêiner.

Se a sua loja é só para testar, e você vai abrir o navegador direto no IP da VPS, troque a porta por 8080:80 e use o endereço do servidor. Depois do teste, volte para 127.0.0.1. Quem prefere o Compose pode traduzir os mesmos parâmetros para o arquivo, seguindo o exemplo da documentação.

Fixe também a versão da imagem. O exemplo usa latest, mas o Docker Hub tem etiquetas da série 9.2, como as terminadas em -apache. Escolha uma etiqueta de versão estável da lista, e não as que trazem rc no nome, porque são candidatas a lançamento. Assim, uma subida futura não traz uma versão diferente da que você testou.

Conferir se a loja subiu

Acompanhe os contêineres com docker ps. Segundo a documentação, quando o contêiner da loja sobe, uma nova loja é montada e fica pronta para ser instalada.

Se você também usa WordPress no Docker, o guia WordPress no Docker: como instalar com Docker Compose mostra outro exemplo com banco e aplicação em contêineres, que ajuda a comparar.

Instalar pelo navegador

Abra a loja no navegador pelo domínio, com o proxy já configurado, ou, num teste com a porta publicada como 8080:80 (como explicado acima), por exemplo em http://203.0.113.10:8080 (um IP de exemplo; use o da sua VPS). O instalador pede os dados do banco. Para estes comandos, o servidor é some-mysql, o nome do banco é prestashop, o usuário é root e a senha é a que você definiu.

Defina também o e-mail e a senha do administrador com valores próprios e uma senha forte.

A documentação traz ainda a instalação automática, que usa variáveis. Veja as principais, com o padrão de cada uma:

  • PS_INSTALL_AUTO: instala automaticamente (padrão 0). Pode exigir PS_DOMAIN, o endereço da loja.
  • ADMIN_MAIL e ADMIN_PASSWD: e-mail e senha do administrador.
  • PS_LANGUAGE e PS_COUNTRY: idioma e país padrão (os padrões são en e GB).
  • PS_ENABLE_SSL: liga o SSL na instalação (padrão 0).
  • PS_FOLDER_ADMIN e PS_FOLDER_INSTALL: mudam o nome das pastas do painel e do instalador.

As páginas do projeto divergem sobre a senha padrão do administrador. Por isso, defina os seus próprios ADMIN_MAIL e ADMIN_PASSWD, em vez de contar com um valor padrão.

Cuidado com PS_ERASE_DB

A variável PS_ERASE_DB apaga o banco MySQL, ou seja, os dados da loja. O padrão é 0. Deixe assim, e só troque para 1 numa instalação de teste que você aceita perder.

Fechar a pasta de instalação e esconder o painel

A documentação do PrestaShop diz que é uma boa prática mudar os nomes das pastas install e admin. Se você não usou as variáveis PS_FOLDER_INSTALL e PS_FOLDER_ADMIN na instalação, a documentação mostra estes dois comandos depois de instalar. O primeiro apaga a pasta do instalador, e o segundo renomeia o painel:

docker exec -i prestashop rm -rf install

docker exec -i prestashop mv admin admin_xxx

Troque admin_xxx por um nome só seu. O painel passa a abrir no caminho novo, como /admin_xxx no endereço da loja. Anote o nome em um lugar seguro, porque sem ele você não encontra o painel.

O comando rm -rf apaga sem pedir confirmação. Confira que você está apagando a pasta install do contêiner prestashop antes de executar.

HTTPS com um proxy reverso

As páginas do PrestaShop sobre Docker não trazem proxy reverso nem HTTPS. A única variável relacionada é a PS_ENABLE_SSL, que liga o SSL na instalação. Uma forma comum de ter HTTPS é colocar um proxy na frente da porta 8080, que cuida do certificado e encaminha o acesso para a loja. Este é um caminho de uso comum, e não uma instrução da documentação do projeto.

Com o proxy, mantenha a porta como 127.0.0.1:8080:80, como nos comandos acima. Se usar a instalação automática, informe o domínio da loja em PS_DOMAIN e deixe o PS_ENABLE_SSL coerente com o endereço. Confira o resultado abrindo a loja pelo domínio.

O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para cuidar do certificado. Se preferir um servidor web com certificado automático, veja o Caddy na VPS.

Atualização e backup

As páginas do PrestaShop sobre Docker não trazem um procedimento de atualização nem de backup. Por isso, recomendamos este roteiro simples, que é um conselho nosso, e não um método oficial:

  1. Faça uma cópia do banco e dos arquivos da loja e guarde fora da VPS. O banco fica no volume prestashop-db. Copie também os arquivos da loja que estiverem dentro do contêiner (por exemplo, com docker cp).
  2. Leia as notas da release da versão nova no GitHub do projeto.
  3. Só então troque a etiqueta da imagem e recrie o contêiner da loja. Os arquivos que estiverem apenas dentro do contêiner antigo são perdidos, por isso a cópia do primeiro passo é indispensável. Se puder, teste a atualização antes em um ambiente separado.

A documentação mostra, em outros trechos, como usar volumes e pastas montadas para manter também os arquivos da loja fora do contêiner. Revise essa parte antes de colocar produtos e pedidos na loja.

Checklist depois de instalar

  • Troquei a senha admin do MySQL por uma senha forte.
  • Defini os meus próprios ADMIN_MAIL e ADMIN_PASSWD, ou escolhi uma senha forte no instalador.
  • Defini PS_DEV_MODE=0.
  • Não publiquei a porta do MySQL.
  • Apaguei a pasta install e renomeei a pasta admin.
  • Fixei a etiqueta da imagem em uma versão estável.
  • Copiei os arquivos da loja e fiz o backup do banco e dos arquivos.
  • Publiquei a porta como 127.0.0.1:8080:80 e coloquei um proxy com HTTPS na frente.

Um domínio para a sua loja

Para que os clientes acessem a loja por um endereço próprio, você precisa de um domínio. Se ainda não tem um, você pode registrar um na Eleven Host.

Sua loja ainda não tem domínio? Registre o seu na Eleven Host. Registrar domínio

Perguntas frequentes

Qual é a licença do PrestaShop?

Segundo o arquivo de licença do projeto, o núcleo usa a OSL-3.0 e os módulos usam a AFL-3.0. Em caso de dúvida sobre uso comercial, consulte um profissional.

Em qual porta a loja abre?

Na 8080 do servidor, ligada à porta 80 do contêiner. Para acesso externo com HTTPS, coloque um proxy reverso na frente.

Preciso instalar o MySQL à parte?

Com os comandos deste guia, não. Um deles sobe um MySQL junto com a loja, e o volume mantém os dados do banco fora do contêiner.

O que acontece se eu usar PS_ERASE_DB igual a 1?

A variável apaga o banco MySQL, com os dados da loja. Deixe no padrão 0.

Qual a senha padrão do administrador?

As páginas do projeto divergem sobre ela. Por isso, defina os seus próprios ADMIN_MAIL e ADMIN_PASSWD, ou crie a senha no instalador.

Esta resposta lhe foi útil?

Artigos Relacionados