# Onde ficam os arquivos do site num VPS OpenLiteSpeed

Document root, arquivo de host virtual, senha inicial do WebAdmin e log de erro: a tradução de cada tela do cPanel para um VPS com imagem pronta de OpenLiteSpeed.

> os arquivos do site ficam no document root do host virtual, normalmente em /usr/local/lsws/Example/html na instalação padrão ou /var/www/html nas imagens prontas. O painel WebAdmin responde em HTTPS na porta 7080 e a configuração vive em /usr/local/lsws/conf.

João Rizzon · 2026-11-01 · Servidores

---

Quem vem de cPanel tem um mapa mental pronto: o site está em `public_html`, o domínio é criado em Domínios, o PHP troca no MultiPHP e o log de erro aparece em Erros. Num VPS com imagem pronta de OpenLiteSpeed não existe nenhuma dessas telas. Existe um painel próprio, o WebAdmin, que responde numa porta diferente da do site, e arquivos de configuração em texto que o painel escreve por você.

Este guia é de localização e primeira configuração. Os caminhos citados são os da imagem padrão do OpenLiteSpeed descritos na [documentação oficial das imagens de nuvem](https://docs.litespeedtech.com/shared/cloud/FAQ-OLS/). Trate cada um como ponto de partida e confirme no seu servidor: provedores e scripts de instalação alteram caminho de document root com frequência.

## O que cada tela do cPanel vira no OpenLiteSpeed

| O que você procura no cPanel | Onde fica no VPS com OpenLiteSpeed |
|---|---||
| Gerenciador de Arquivos / `public_html` | pasta de document root do host virtual, acessada por SSH ou SFTP |
| Criar domínio / subdomínio | Virtual Hosts e Listeners no WebAdmin |
| Painel de controle (porta 2083) | WebAdmin do OpenLiteSpeed na porta **7080** |
| Senha do painel vinda do provedor | arquivo de senha inicial gravado na primeira inicialização da imagem |
| MultiPHP Manager | External App do tipo LSAPI, definido por host virtual |
| Logs de erro do site | arquivos de log do servidor e do host virtual, em texto |
| Reiniciar serviços | `systemctl restart lshttpd`, `/usr/local/lsws/bin/lswsctrl restart` ou o botão Graceful Restart no WebAdmin |

A diferença mais importante não é o caminho. É que no cPanel o painel é o dono da configuração e você quase nunca toca em arquivo. No OpenLiteSpeed o arquivo é a fonte da verdade, e o WebAdmin é uma interface que escreve nele.

## O painel responde na porta 7080 e a senha inicial fica em /root

O WebAdmin do OpenLiteSpeed atende em **HTTPS na porta 7080**, separado do site, que continua nas portas 80 e 443. O endereço é `https://SEU_IP:7080`.

O certificado é autoassinado por padrão, então o navegador mostra aviso de segurança na primeira visita. Isso é esperado numa instalação recém criada.

A senha inicial do usuário administrador é gerada quando a imagem sobe pela primeira vez e gravada em um arquivo no servidor, conforme a documentação das imagens de nuvem do OpenLiteSpeed. Entre por SSH como root e procure por ele:

```bash
cat /root/.litespeed_password
```

Se o arquivo não existir com esse nome na sua imagem, procure por arquivos de credencial no diretório do root:

```bash
ls -la /root/ | grep -i pass
```

O resultado esperado é uma linha com usuário e senha em texto puro, ou um arquivo contendo apenas a senha. Alguns provedores também exibem a credencial na tela inicial do SSH (o motd) no primeiro acesso.

### Como redefinir a senha do WebAdmin quando ela não funciona

O OpenLiteSpeed traz um script oficial para redefinir a credencial do WebAdmin:

```bash
/usr/local/lsws/admin/misc/admin_pass.sh
```

Ele pergunta o nome de usuário e a nova senha, e grava o hash no arquivo de credenciais do painel. Depois disso o login novo já vale, sem reiniciar o servidor. Guarde a senha antes de executar: o script substitui a anterior e não há como recuperá-la.

## Onde ficam os arquivos do site e como descobrir o document root real

O diretório de instalação do OpenLiteSpeed é `/usr/local/lsws`. Dentro dele ficam binários, configuração, logs e o host virtual de exemplo.

O site servido por padrão depende da imagem. Dois caminhos aparecem com frequência:

- `/usr/local/lsws/Example/html` é o document root do host virtual de exemplo que acompanha o OpenLiteSpeed.
- `/var/www/html` é o caminho usado por boa parte das imagens prontas que já vêm com um aplicativo instalado, como WordPress.

Em vez de adivinhar, pergunte ao servidor. Este comando lista todas as linhas de document root declaradas na configuração:

```bash
grep -r "docRoot" /usr/local/lsws/conf/
```

A saída traz o arquivo e o valor, algo como `docRoot  $VH_ROOT/html`. A variável `$VH_ROOT` é o caminho raiz do host virtual, definido no mesmo arquivo na diretiva `vhRoot`. Resolvendo as duas você chega à pasta física onde ficam `index.php`, `wp-config.php` e `wp-content`.

Essa pasta é o equivalente funcional ao `public_html`. É ela que você aponta no cliente de SFTP e é dentro dela que o WordPress vive.

## A configuração se divide em servidor e host virtual

A configuração do OpenLiteSpeed se divide em duas camadas.

### httpd_config.conf guarda listeners, domínios e aplicativos de PHP

`/usr/local/lsws/conf/httpd_config.conf` guarda as definições globais: listeners (as portas 80 e 443), mapeamento de domínio para host virtual, usuário e grupo do processo, caminhos de log e os aplicativos externos de PHP.

### vhconf.conf guarda document root, rewrite e SSL de cada site

Cada host virtual tem o próprio arquivo, no padrão `/usr/local/lsws/conf/vhosts/NOME/vhconf.conf`. No host de exemplo, o nome é `Example`. Ali ficam o document root, as regras de rewrite, os contextos e o certificado SSL daquele site.

Para ver a estrutura:

```bash
ls -la /usr/local/lsws/conf/vhosts/
```

Cada subpasta listada é um host virtual configurado.

## Como trocar o domínio servido por padrão sem ficar sem volta

Antes de qualquer edição, copie o arquivo. Sem isso, um erro de sintaxe deixa o servidor sem subir e você não tem para onde voltar.

```bash
cp /usr/local/lsws/conf/httpd_config.conf /root/httpd_config.conf.bak
```

Para desfazer, basta o caminho inverso e um restart. Na instalação padrão do OpenLiteSpeed a unidade do systemd se chama `lshttpd`, e não `lsws`. Confirme o nome no seu servidor antes de precisar dele:

```bash
systemctl list-units | grep -i ls
```

A saída traz a linha da unidade do servidor web, algo como `lshttpd.service   loaded active running`. Use esse nome nos comandos abaixo. Se nenhuma unidade aparecer, o controle é feito pelo script próprio do OpenLiteSpeed: `/usr/local/lsws/bin/lswsctrl restart`.

```bash
cp /root/httpd_config.conf.bak /usr/local/lsws/conf/httpd_config.conf
systemctl restart lshttpd
```

### Trocar o domínio pelo WebAdmin em Virtual Hosts e Listeners

- Entre em `https://SEU_IP:7080` e faça login.
- No menu lateral, abra **Virtual Hosts** e clique no host existente (em geral `Example`).
- Na aba **General**, confira **Virtual Host Root** e **Document Root**. Ajuste se o site ficar em outra pasta.
- Volte ao menu e abra **Listeners**, clique no listener da porta 80 (e no da 443, se existir).
- Em **Virtual Host Mappings**, edite o mapeamento e troque o campo **Domains** pelo seu domínio. Vale usar `seudominio.com.br, www.seudominio.com.br` para cobrir as duas formas.
- Clique no ícone de **Graceful Restart**, no topo direito, para aplicar.

Graceful Restart recarrega a configuração sem derrubar conexões em andamento. É a forma recomendada de aplicar mudança em produção.

### Trocar o domínio pelo terminal e confirmar que a mudança entrou

Quem prefere editar o arquivo deve mexer no bloco `listener` dentro de `httpd_config.conf`, no trecho `map NomeDoVHost dominio`. Depois de salvar, aplique e verifique:

```bash
systemctl restart lshttpd
systemctl status lshttpd
```

Processo ativo não prova que a configuração nova entrou: o OpenLiteSpeed pode continuar servindo com o que já estava em memória. A verificação tem três partes. Primeiro, o restart não pode falhar. Segundo, o log de erro não pode trazer linha nova de sintaxe:

```bash
tail -n 30 /usr/local/lsws/logs/error.log
```

Procure por linhas com `[ERROR]` ou menção a `config` com a data e hora do restart que você acabou de dar. Terceiro, abra o site no navegador (ou rode `curl -I http://seudominio.com.br`) e confirme que o conteúdo servido é o seu, não o host de exemplo. Se o retorno do `status` for `Unit lshttpd.service could not be found`, a unidade tem outro nome na sua imagem: rode `systemctl list-units | grep -i ls` para descobrir, ou use `/usr/local/lsws/bin/lswsctrl restart`, que funciona em qualquer instalação. Se o restart falhar ou o log acusar erro, restaure o backup e leia o log de erro inteiro antes de tentar de novo.

## Qual log abrir quando a página não carrega

Os logs do OpenLiteSpeed ficam em `/usr/local/lsws/logs/`. Os dois que resolvem a maioria dos casos:

| Arquivo | O que ele registra |
|---|---||
| `/usr/local/lsws/logs/error.log` | erros do servidor, falhas de PHP via LSAPI, problemas de permissão e de sintaxe na configuração |
| `/usr/local/lsws/logs/access.log` | cada requisição recebida, com código de status |

Acompanhe o log de erro em tempo real enquanto recarrega a página no navegador:

```bash
tail -f /usr/local/lsws/logs/error.log
```

O terminal fica parado esperando novas linhas. Recarregue o site e observe o que aparece. Saia com `Ctrl+C`.

### O que significam tempo esgotado, erro 500, 403 e site de exemplo

- **Nada aparece no error.log e o navegador dá tempo esgotado**: a requisição não chegou ao servidor. Verifique DNS e firewall nas portas 80 e 443.
- **Página em branco ou erro 500 com linha de LSAPI no log**: problema no PHP do site, não no servidor web. Ative `WP_DEBUG_LOG` e olhe o `debug.log` dentro de `wp-content`.
- **403 Forbidden**: permissão de arquivo ou dono errado na pasta do site. Confira qual usuário o OpenLiteSpeed roda, na diretiva `user` do `httpd_config.conf`, e compare com o dono dos arquivos (`ls -la`).
- **O site de exemplo aparece em vez do seu**: o mapeamento de domínio no listener ainda aponta para o host virtual `Example`. Volte à seção anterior.

Se o host virtual tiver log próprio configurado, ele é declarado no `vhconf.conf` e pode estar em outro caminho. Vale conferir antes de concluir que não há registro.

## Snapshot, cópia datada e uma mudança por vez

Três hábitos que evitam a maior parte dos becos sem saída em VPS com OpenLiteSpeed.

- **Snapshot do VPS antes da primeira edição de configuração.** É o único backup que cobre tudo de uma vez, inclusive o que você não lembrou de copiar.
- **Cópia datada do arquivo antes de cada mudança**, com `cp arquivo arquivo.bak-$(date +%F)`. O comando `date +%F` devolve a data no formato ano-mês-dia, então o nome do backup já indica quando foi feito.
- **Uma mudança por vez, com Graceful Restart entre elas.** Se algo quebrar, você sabe exatamente o que causou.

Seguir esse roteiro troca o reflexo de cPanel por outro igualmente mecânico: SSH para achar o caminho, WebAdmin na 7080 para configurar, `error.log` para diagnosticar. Com os três mapeados, o resto dos tutoriais de WordPress volta a funcionar normalmente, porque a parte que mudou era só a localização.

