Pular para o conteúdo principal

Instalar em um servidor

O Qubix é executado em seu próprio servidor — um único comando de instalação inicializa toda a pilha (banco de dados, backend, servidor web, utilitários). Você precisa apenas de um servidor Linux limpo com acesso SSH e Docker.

Requisitos do servidor​

O instalador verifica o servidor antes de iniciar e recusa continuar em uma máquina claramente subdimensionada. O mínimo recomendado:

RecursoMínimo recomendado
CPU4 vCPU
RAM8 GB
Disco20 GB SSD ou HDD

Esses são os valores recomendados pelo instalador; abaixo deles o sistema ainda funciona, mas avisa que o ClickHouse ficará lento em dias de alto tráfego. Há um limite absoluto de 10 GB de espaço livre em disco — abaixo disso a instalação é interrompida.

O tipo de disco não afeta o desempenho do tráfego — tanto SSD quanto HDD funcionam, e o HDD permite economizar; o SSD só acelera os relatórios administrativos em grandes volumes. 20 GB é mais que suficiente para começar: comporta a plataforma mais milhares de criativos, e o histórico de tráfego pesa quase nada. Para saber exatamente quanto tráfego e quantos criativos um determinado disco suporta, veja Escolhendo o servidor.

Alguns requisitos obrigatórios:

  • Um servidor Linux de 64 bits (VPS/VDS ou servidor dedicado), não um computador pessoal ou hospedagem compartilhada.
  • Docker com o plugin docker compose (V2). O antigo docker-compose independente (V1) não é suportado — o instalador o detecta e para.
  • HTTPS de saída para que o servidor possa baixar as imagens do Qubix.
Servidor limpo

Instale o Qubix em um servidor dedicado a ele. A pilha espera que as portas 80, 443 (e 8443 para a opção Cloudflare) estejam livres. Se outro servidor web já as estiver ocupando, libere-as primeiro ou escolha a opção Cloudflare posteriormente no assistente.

Instalação​

  1. Conecte-se ao servidor via SSH como root.

  2. Execute o comando de instalação:

    Bash
    curl -sSL https://qubix.pro/install.sh | bash

    (ou wget -qO- https://qubix.pro/install.sh | bash)

    o banner do instalador e a inicialização da stack no terminal

  3. O instalador exibe o banner do Qubix, verifica o servidor, faz algumas perguntas (pasta de instalação, qual interface de rede utilizar) e então baixa e inicia a stack. Aguarde até que ele informe que tudo está funcionando.

Não interrompa

Deixe o instalador concluir. Interrompê-lo no meio do processo pode deixar a pilha parcialmente configurada — caso isso ocorra, a recuperação mais segura é remover a pasta de instalação e executar o comando novamente em um servidor limpo.

O que você obtém​

O instalador inicializa um conjunto de contêineres que compõem o Qubix: o banco de dados de análises, o backend do Qubix, o servidor web e os utilitários de atualização automática, certificado e IA. Você não precisa gerenciá-los manualmente — o Qubix cuida disso por você.

Concluindo a configuração no navegador​

Quando a pilha estiver em execução, o instalador exibirá um link como:

http://<ip-do-seu-servidor>:7000/install?k=…

Abra esse link completo em um navegador (a chave ?k=… é obrigatória). Ele abre o assistente de configuração, onde você escolhe como o Qubix será acessado, insere sua licença e cria o primeiro administrador.

a linha do terminal com o link do assistente

O link funciona uma vez

O assistente de configuração só está acessível até você concluí-lo. Após a criação do primeiro administrador, o link deixa de funcionar — isso é esperado. A partir daí, você acessa o painel pelo endereço próprio do seu painel.

Próximos passos​

Criar um administrador

Percorra o assistente de configuração: endereço, licença, administrador.

Visão geral da interface

Como o painel administrativo está organizado.

On this page