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…

  • 3 min de leitura

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?

  1. Instala só os pacotes necessários que estiverem faltando: Python, PostgreSQL, Nginx e certbot.
  2. Cria um usuário de sistema separado chamado ravix (sem login) e as pastas do aplicativo em /srv/ravix.
  3. Cria o banco de dados PostgreSQL com uma senha aleatória.
  4. Grava o arquivo de configuração /etc/ravix/ravix.env com chaves seguras.
  5. Configura os serviços do systemd: o próprio site, a publicação agendada de posts e os backups diários.
  6. Configura o Nginx com compressão gzip, cache de arquivos estáticos e HTTP/2.
  7. Obtém um certificado HTTPS grátis do Let's Encrypt e redireciona HTTP para HTTPS.
  8. 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 --build para 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.

Artigos relacionados

Comentários

Nenhum comentário foi publicado ainda.

Escreva seu comentário