OpenCart na VPS: como instalar sua loja virtual
Instale o OpenCart 4.1.0.4 numa VPS: requisitos, PHP 8.1, banco, instalação manual e por linha de comando, exemplo de Nginx, HTTPS, atualização, backup e cuidados de segurança.
Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: OpenCart na VPS: como instalar sua loja virtual Arte: Eleven Host
O OpenCart na VPS permite montar uma loja virtual própria, com instalação direta e banco MySQL ou MariaDB. Veja os requisitos, o passo a passo, a configuração do Nginx, a atualização, o backup e os cuidados de segurança.
Atualizado em 05/11/2026, com base na documentação oficial do OpenCart e na versão 4.1.0.4.
O que é o OpenCart
O README do projeto descreve o OpenCart como uma plataforma de comércio eletrônico gratuita e de código aberto para lojistas. A licença é a GNU GPL versão 3 (GPLv3). Se você ainda não tem um servidor, o guia de servidor VPS explica o que é e como escolher.
Na data da publicação, o GitHub marca a 4.1.0.4 (de 11/08/2026) como a versão mais recente. A linha 3.x também recebeu release no mesmo dia, a 3.0.5.1, mas o guia de instalação oficial é o da linha 4, e é esse o caminho seguido aqui. Se você está comparando plataformas, veja também o artigo PrestaShop na VPS.
O instalador da versão 4.1.0.4 recusa PHP abaixo da 8.1. Use PHP 8.1 ou mais novo. Instale a partir de um release, e não do branch master: o README explica que o master leva o sufixo "_rc" da próxima versão, ou seja, é a versão em desenvolvimento.
Requisitos do OpenCart
O instalador confere as extensões e as configurações do PHP. As extensões e funções verificadas são:
- gd, curl, zlib e zip;
- a função openssl_encrypt;
- iconv ou mbstring;
- uma extensão de banco: mysqli, pdo ou pgsql.
A documentação cita MySQL ou MariaDB, via MySQLi ou PDO, com preferência para o MySQLi, e não informa uma versão mínima do banco. Quanto ao servidor web, a documentação recomenda o Apache. A configuração para Nginx mostrada adiante não é oficial do projeto, por isso recomendamos testá-la antes de publicar a loja.
O orçamento mensal do projeto está definido? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instale os pacotes no servidor
Um exemplo de comando para Debian ou Ubuntu, para conferir no próprio servidor:
apt install nginx php-fpm php-mysql php-gd php-curl php-zip php-mbstring mariadb-server unzip
Depois, confira se a versão do PHP é a 8.1 ou mais nova:
php -v
Crie o banco de dados
O INSTALL.md do projeto manda criar um banco MySQL ou MariaDB com um usuário próprio, sem usar o root. Um exemplo de comandos SQL, para conferir no seu servidor e trocar nomes e senha:
CREATE DATABASE loja;
CREATE USER 'loja'@'localhost' IDENTIFIED BY 'senha-forte-aqui';
GRANT ALL PRIVILEGES ON loja.* TO 'loja'@'localhost';
FLUSH PRIVILEGES;
Baixe e envie os arquivos
Baixe a versão 4.x na página de releases do projeto no GitHub ou no site oficial do OpenCart e extraia o arquivo. Os passos da instalação manual, segundo o INSTALL.md da versão 4.1.0.4, são estes:
- Envie o conteúdo da pasta
uploadpara a raiz do site, e não a pastauploadem si. - Renomeie
admin/config-dist.phpeconfig-dist.phpparaconfig.php. - Dê permissão de escrita aos dois arquivos de configuração. O INSTALL.md traz estes comandos:
chmod 0777 config.php
chmod 0777 admin/config.php
O INSTALL.md também diz que o usuário do servidor web precisa de leitura, escrita e execução nas pastas sob a raiz. Um exemplo de comando, para conferir no próprio servidor, em Debian ou Ubuntu:
chown -R www-data:www-data /var/www/opencart
Recomendamos apertar as permissões dos dois arquivos de configuração para 644 depois de instalar e testar a loja, porque 0777 libera escrita para outros usuários do sistema:
chmod 644 config.php
chmod 644 admin/config.php
Se você baixou a versão compilada, o INSTALL.md manda enviar a pasta vendor para um nível acima da raiz do site.
Configure o Nginx
O OpenCart traz regras de reescrita de URL para o Apache no arquivo .htaccess.txt. Sem renomear esse arquivo para .htaccess, as URLs amigáveis não funcionam. No Nginx, a tradução dessas regras fica por sua conta. Um exemplo de configuração mínima, que recomendamos testar em um ambiente de teste antes de publicar; ajuste a raiz, o domínio e o soquete do PHP, cujo nome muda com a versão instalada:
server {
listen 80;
server_name loja.exemplo.com.br;
root /var/www/opencart;
index index.php;
location ~ /\. { deny all; }
location ^~ /system/storage/ { deny all; }
location / { try_files $uri $uri/ @opencart; }
location @opencart { rewrite ^/(.+)$ /index.php?_route_=$1 last; }
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
O arquivo snippets/fastcgi-php.conf é um padrão de Debian e Ubuntu. Se você vai manter mais de um site na mesma VPS, o artigo Nginx Proxy Manager: vários sites numa VPS só mostra uma forma de organizar isso.
Rode o instalador
Abra o endereço da loja no navegador. O instalador pede a licença, confere os requisitos e pergunta os dados do banco e do administrador. Durante a instalação, a documentação oficial manda digitar um novo nome para a pasta do painel administrativo no campo indicado, para proteger o acesso. Anote o nome escolhido.
Quando a instalação terminar, o INSTALL.md manda apagar a pasta install, por segurança. Para colocar a loja no ar, ele também manda trocar, no arquivo system/config/default.php, a linha abaixo por false, para que os erros não apareçam para o visitante:
$_['error_display'] = true;
Instalação pela linha de comando
O pacote da versão 4.1.0.4 também traz o script upload/install/cli_install.php. Antes de usá-lo, os dois arquivos config.php precisam existir, com os nomes corretos, e poder ser gravados. Um exemplo de comando com valores fictícios, para adaptar ao seu servidor; as três linhas abaixo formam um único comando e devem ser unidas em uma só linha. O INSTALL.md manda não usar o root no banco, então use o usuário criado antes:
php cli_install.php install --username admin --email email@exemplo.com.br --password senha-forte-aqui
--http_server https://loja.exemplo.com.br/ --db_driver mysqli --db_hostname localhost
--db_username loja --db_password senha-do-banco --db_database loja --db_port 3306 --db_prefix oc_
As opções --email, --password, --http_server, --db_username e --db_database não têm valor padrão. A URL vai em --http_server, com barra no final.
Ative o HTTPS
Com o certificado pronto, use https:// na URL da loja. Um exemplo de comando com o Certbot, para conferir na documentação do Certbot antes de usar:
certbot --nginx -d loja.exemplo.com.br
Cuidados de segurança depois de instalar
A documentação de instalação traz duas medidas: mover a pasta storage para fora da raiz do site (o instalador da linha 4 oferece uma opção para isso) e dar um nome novo à pasta do painel.
Sobre vulnerabilidades, o repositório do OpenCart no GitHub, na data da publicação, informa que não há avisos de segurança publicados e que não há política de segurança. O changelog da 4.1.0.4 lista correções como a prevenção de XSS na tela do log de erros e o cookie de sessão com a opção httponly. Esse anúncio não é um aviso formal de segurança.
Relatos de segurança em aberto
Há relatos de terceiros sobre problemas de segurança na 4.1.0.4, ainda sem confirmação do projeto. Não afirmamos nem descartamos nenhum deles. Recomendamos usar a versão mais recente, acompanhar os releases do projeto e limitar quem acessa o painel administrativo.
Atualize o OpenCart
Pelo painel, o caminho é System, Maintenance, Upgrade. A ferramenta consulta o servidor oficial, compara a sua versão com a mais recente, baixa o pacote do GitHub, copia os arquivos e leva você ao script do banco. Ela precisa que o servidor consiga acessar api.opencart.com e github.com, e de cerca de 20 a 50 MB livres.
A documentação manda criar um backup completo do banco e dos arquivos antes de atualizar, e avisa que, depois de iniciado, o processo não é fácil de reverter sem backup. Na passagem da linha 3.x para a 4.x, que é manual, a orientação é subir os arquivos novos sem sobrescrever configurações, imagens e a pasta storage, rodar o script, fazer backup do banco e dos arquivos e testar antes em homologação. A documentação avisa que algumas extensões podem não funcionar na linha 4.
Backup do banco da loja
O painel tem o caminho System, Maintenance, Backup & Restore, que copia o banco, por tabelas, para um arquivo SQL guardado na pasta /storage/backup/. As tabelas user e user_group ficam de fora, para evitar problemas de permissão, e restaurar um backup sobrescreve por completo o banco atual. Como essa página trata só do banco, ela não cobre arquivos e imagens.
Recomendamos guardar uma cópia fora da VPS e incluir arquivos, imagens e a pasta storage. Um exemplo de comando para o banco, para conferir no próprio servidor:
mysqldump -u loja -p loja > loja.sql
Meios de pagamento
A documentação oficial só manda configurar pelo menos um meio de pagamento antes de testar a loja. O marketplace do OpenCart lista extensões de terceiros para Pix e boleto, e esses meios não são nativos do OpenCart. Confira a versão compatível, o preço e a data da última atualização de cada extensão antes de instalar. Para divulgar a loja, veja o artigo Mautic na VPS, sobre automação de marketing.
Primeiros passos na loja
O painel fica, em geral, no endereço da loja seguido de /admin; se você renomeou a pasta, use o nome novo. A documentação sugere esta ordem: configurar a loja em System, Settings, cadastrar produtos em Catalog, Products, definir o pagamento, configurar o frete em Extensions, Shipping e fazer uma compra de teste.
O repositório inclui um ambiente Docker, mas o README o descreve como ambiente de desenvolvimento local. Por isso, o passo a passo acima usa a instalação direta.
A escolha do plano depende do tamanho da loja? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Perguntas frequentes
Qual versão do PHP o OpenCart 4.1.0.4 exige?
O instalador da 4.1.0.4 recusa PHP abaixo da 8.1. Use a 8.1 ou mais nova.
O OpenCart tem suporte oficial ao Nginx?
Não. A documentação recomenda o Apache, e as regras oficiais de reescrita estão no formato do Apache. O exemplo de Nginx deste artigo não é oficial e deve ser testado em ambiente de teste antes de publicar.
O OpenCart tem Pix e boleto nativos?
Não. Esses meios dependem de extensões de terceiros do marketplace, e é preciso conferir a compatibilidade com a versão instalada.
Posso instalar pelo branch master?
Não é recomendado. O master é a próxima versão em desenvolvimento, e não a versão estável. Baixe um release.
O backup do painel salva a loja inteira?
Não. Ele copia o banco, sem as tabelas user e user_group. Faça também a cópia dos arquivos, das imagens e da pasta storage.