Como instalar o Ravix em um VPS em 10 minutos: guia passo a passo
Guia completo para instalar o Ravix CMS em um servidor Ubuntu com um único comando: PostgreSQL, Nginx, HTTPS grátis e backups diários, tudo automático. Do servidor zerado ao pain…

Nesta página
Quer seu site no seu próprio servidor, com HTTPS, backups automáticos e sem dor de cabeça com configuração? O instalador do Ravix faz tudo isso com um único comando. Neste guia partimos de um servidor Ubuntu zerado e chegamos ao painel de administração em cerca de 10 minutos.
Requisitos
- Um VPS zerado com Ubuntu 22.04, 24.04 ou 26.04
- Acesso root via SSH
- Um domínio cujo registro A (e www, se quiser) já aponte para o IP do servidor
- Portas 80 e 443 abertas
Dica: antes de começar, confirme que o DNS do domínio já chega ao servidor. Sem isso o certificado HTTPS não pode ser emitido.
Passo 1: conecte-se ao servidor
Conecte-se por um terminal (ou um app como Termius ou PuTTY):
ssh root@YOUR-SERVER-IP
Passo 2: baixe o código do Ravix
apt update && apt install -y git
git clone https://github.com/ravixcms/ravixcms.git
cd ravixcms
Passo 3: rode o instalador
Troque example.com pelo seu domínio e o e-mail pelo seu (o e-mail só é usado para o certificado do Let's Encrypt):
sudo ./install.sh --domain example.com --email you@example.com --yes
- Sem
--yes, o instalador pergunta antes de cada alteração. - Para ver o que o instalador faria sem mudar nada no servidor:
sudo ./install.sh --dry-run --domain example.com
O que exatamente o instalador faz?
- Instala só os pacotes necessários que estiverem faltando: Python, PostgreSQL, Nginx e certbot.
- Cria um usuário de sistema separado chamado
ravix(sem login) e as pastas do aplicativo em/srv/ravix. - Cria o banco de dados PostgreSQL com uma senha aleatória.
- Grava o arquivo de configuração
/etc/ravix/ravix.envcom chaves seguras. - Configura os serviços do systemd: o próprio site, a publicação agendada de posts e os backups diários.
- Configura o Nginx com compressão gzip, cache de arquivos estáticos e HTTP/2.
- Obtém um certificado HTTPS grátis do Let's Encrypt e redireciona HTTP para HTTPS.
- Por fim, verifica a saúde do site e mostra o endereço da página de instalação e um token de instalação.
Rodar o instalador de novo é seguro: cada etapa verifica primeiro o estado atual e é pulada se já estiver feita. O log completo fica em /var/log/ravix-install.log.
Passo 4: conclua a instalação no navegador
Abra https://seu-dominio/install/ e preencha o formulário:
- Token de instalação: o que o instalador mostrou. Ele impede que um estranho vire administrador do site antes de você.
- Nome do site
- Idioma e fuso horário
- Usuário, e-mail e senha do superadministrador
Clique em "Instalar". Você entra direto no painel de administração, e a página de instalação fica fechada para sempre a partir desse momento.
Passo 5: apague o token
Depois de instalar com sucesso, rode o instalador mais uma vez para que ele remova o token do arquivo de configuração:
sudo ./install.sh
Depois da instalação
- Conteúdo de exemplo: são criados um post e duas páginas de exemplo ("Sobre" e "Contato"). Edite-os ou remova-os no painel com "Excluir conteúdo de exemplo".
- O guia de primeiros passos no painel mostra o que fazer em seguida: logo, primeiro post e escolha do tema.
- Saúde do site (Painel → Sistema) mostra o estado do servidor e dos backups. Alguns avisos são normais num servidor novo, como o e-mail SMTP ainda não configurado.
- Para desenhar suas páginas, vá para o construtor Ravix Studio.
Se algo der errado
- O certificado HTTPS não foi emitido: geralmente o DNS do domínio ainda não aponta para o servidor. Espere um pouco e rode o instalador de novo.
- "Token de instalação inválido": copie o token do final da saída do instalador ou do arquivo de log.
- Não consegue entrar depois de instalar: o login só funciona via HTTPS; abra o endereço com https.
Outras formas de instalar
- Docker:
docker compose up -d --buildpara um teste rápido ou em servidores que já usam Docker. - Hospedagem compartilhada cPanel (experimental): igual ao WordPress, envie os arquivos e conclua a instalação no navegador.
Comece agora: a versão mais recente e mais detalhes na página de download do Ravix e no código-fonte no GitHub.
Comentários
Nenhum comentário foi publicado ainda.