Hospedagem com 20% de desconto comprando pelo link

Publicar o site

Coloque o site no ar num servidor de verdade com um pedido: o que preparar, o que a IA pergunta na primeira vez, o que ela faz e o que conferir depois.

Publicar é levar o site que você construiu no seu computador para um servidor de hospedagem, com o conteúdo, para ele responder no endereço de verdade. Com a skill do Velk, é um pedido: na primeira vez a IA pergunta o que não sabe, inspeciona o servidor, envia tudo e confere o resultado.

Esta página trata do primeiro deploy. Depois dele, o site no ar é o de verdade: as mudanças seguintes vão como publicações do tema (Publicar alterações) e as versões novas do Velk como atualizações (Atualizar o Velk).

Antes de começar

  1. Acesso SSH

    SSH é a conexão segura do seu computador com o servidor, aberta com uma chave em vez de senha. Ative no painel da hospedagem, na seção Acesso SSH (a Hostinger usa a porta 65002). Os planos compartilhados intermediários costumam ter, os básicos muitas vezes não, uma VPS (um servidor virtual só seu) sempre tem.

  2. Um banco e seus quatro dados

    Crie o banco e o usuário dele no painel da hospedagem: o Velk não consegue criar lá. Anote host (geralmente localhost), nome, usuário e senha exatamente como aparecem, com o prefixo, como em u12345678_lumen.

  3. O domínio

    Aponte o domínio para o servidor, ou pelo menos comece: o DNS, a lista telefônica da internet, leva de minutos a horas para espalhar uma mudança.

  4. O endereço canônico

    Escolha um endereço oficial, com ou sem www, sempre com https. Ele vira o APP_URL no .env do servidor (o arquivo de configuração dele), e é dele que nascem o sitemap, o robots.txt e as tags canônicas. Subir com um endereço provisório deixa tudo isso apontando para ele até alguém perceber.

Peça à IA

Gera uma chave SSH pra mim e me mostra a parte pública, pra eu colar no painel da hospedagem.

A parte pública vai para o servidor; a privada nunca sai do seu computador.

Peça à IA

Sobe esse site pela primeira vez na minha hospedagem da Hostinger. É o site da Clínica Lumen, e o endereço oficial é https://www.clinicalumen.example, com www. O SSH já está ativo e eu criei o banco no painel.

Na primeira vez, a IA pergunta o que ainda não sabe. Ela guarda as respostas, e nos pedidos seguintes não pergunta mais nada.

O que a IA pergunta na primeira vez

PerguntaO que responder
SSHEndereço, porta e usuário, que estão no painel da hospedagem. A IA conecta com a chave, nunca com senha.
Pasta no servidorO caminho completo onde o site vai morar, como /home/u123456789/domains/clinicalumen.example/public_html na Hostinger (a raiz do documento, no painel). A IA nunca deduz isso do endereço.
EndereçoO endereço canônico com https (com http, a IA avisa) e, se o site não fica na raiz do domínio, a subpasta.
Banco do servidorNome, usuário e senha exatamente como o painel criou; o host só se não for localhost.
Banco localNada: a IA lê do .env do seu projeto.

O que a IA faz

Ela guarda as respostas em .deploy/ssh.json, que só você lê e que fica fora do Git, e testa tudo. Depois:

  • Olha o servidor primeiro, e para se a pasta já tem um Velk.
  • Recusa subir problema: um motor editado, ou as páginas originais de um site HTML convertido esquecidas no tema.
  • Envia os arquivos: motor, tema, storage/uploads/ e o .htaccess, o arquivo de regras do servidor web. Nunca o seu .env local, o .git ou a configuração de deploy.
  • Escreve o .env do servidor com as suas respostas, já com APP_DEBUG=false, trancado para outras contas do servidor não lerem. As suas credenciais locais nunca sobem.
  • Copia o seu banco local para o do servidor e roda o migrate, as atualizações de banco do motor: páginas, posts, mídia e usuários do painel chegam como estavam.
  • Fecha: escreve o robots.txt com o endereço real do sitemap e confere se a home responde.
O que a IA roda
# os scripts da skill, na pasta scripts/ do plugin do Velk # 1. olhar primeiro $ scripts/preflight.sh --project . --local-db ✓ Preflight passed # 2. o primeiro deploy $ scripts/deploy/init.sh --project . ✓ Target empty — proceeding ✓ Files synced ✓ DB imported ✓ Migrations OK ✓ HTTP 200 OK ✓ Init deploy complete.
Você não digita nada disso: a IA roda e responde com o endereço do site no ar e o do painel.

Conferindo no ar

  1. A home

    Abre, com o mesmo conteúdo que você tinha no local.

  2. Uma página interna

    Abre também, o que testa as regras de endereço do .htaccess. Se a home funciona e as internas dão 404, esse arquivo é o primeiro suspeito.

  3. As imagens

    Aparecem, o que testa se o storage/uploads/ chegou.

  4. O painel

    O seu endereço mais /admin aceita o usuário que você tinha no local.

  5. Um formulário

    Envia, e o envio aparece no painel.

  6. O robots.txt

    Abre em /robots.txt e aponta para o sitemap no endereço certo. Desde a v3.8.1 ele não cita o painel, que avisa sozinho os buscadores para não indexá-lo.

Peça à IA

Confere o site no ar: abre a home, a página Sobre e um post do blog, vê se as imagens carregam e me diz o que está no /robots.txt.

HTTPS e ajustes de produção

Certificado. Ative no painel da hospedagem (a Hostinger emite um gratuito). O endereço que você passou para a IA já começa com https, então os links que saem dele ficam certos.

Modo de depuração desligado. O primeiro deploy já escreve APP_DEBUG=false no servidor. Mantenha: ligado, um erro mostra caminho de arquivo, consulta ao banco e versão para qualquer visitante.

E-mail. Os dados de envio de e-mail (SMTP) do .env do servidor começam vazios. Se os formulários mandam e-mail, peça para a IA preencher com os dados do seu provedor; até lá, o envio depende da função de e-mail do próprio servidor.

Site numa subpasta

Um site pode morar num caminho, como https://escolaaurora.example/matriculas. Informe a subpasta quando a IA perguntar: ela vai para o APP_BASE_PATH, e o APP_URL fica só com o https e o domínio. A pasta no servidor é outra resposta; a IA nunca deduz uma da outra.

Os links funcionam ali porque um tema Velk monta todo endereço pelas funções do motor, e desde a v3.9.0 as tags canônica e de idioma não repetem mais a pasta. Um detalhe: os buscadores só leem o robots.txt da raiz do domínio, então declare o sitemap lá ou envie pelo Google Search Console.

Hospedagem sem SSH

Sem SSH, a IA não consegue fazer o deploy por você, mas o Velk roda lá: os arquivos sobem por FTP (transferência simples de arquivos) ou pelo gerenciador de arquivos da hospedagem, o .env do servidor recebe os dados do banco e um primeiro usuário do painel, e a primeira visita instala o site. Depois de uma atualização do motor, a primeira visita aplica sozinha as mudanças de banco (AUTO_MIGRATE, ligado por padrão).

O conteúdo do seu banco local não viaja com os arquivos, e nenhum dos fluxos por SSH destas páginas funciona lá. Se puder, escolha um plano com SSH.

Trabalhar direto no ar

Dá para pular a cópia local e pedir mudanças direto no site no ar. Mesmo assim a IA nunca edita arquivo no servidor: ela baixa uma cópia nova do tema no ar, faz a mudança e publica, com todas as verificações (veja Sites de clientes). O custo: você só vê o resultado quando ele já está no ar, e as verificações pegam uma página quebrada, não uma feia. Local para construir, no ar para ajuste pontual, backup antes de qualquer coisa grande.

Perguntas frequentes

E se eu pedir deploy de novo depois?

A IA encontra o Velk no servidor e pergunta o que mudou: o tema (uma publicação com versão) ou o motor (uma atualização). Ela nunca repete o primeiro deploy, e o seu conteúdo local nunca mais sobe: o banco do site no ar, o storage/uploads/ e o .env do servidor nunca são sobrescritos.

Quais hospedagens servem?

Qualquer uma com PHP 8.2 ou mais novo, MySQL ou MariaDB e SSH com chave: Hostinger, hospedagens com cPanel (Locaweb, HostGator, KingHost), DreamHost, uma VPS ou um servidor na nuvem; só muda o caminho da pasta. Se o PHP fica num caminho diferente, a IA encontra e, com o seu OK, guarda esse caminho. Um servidor com nginx em vez de Apache ignora o .htaccess e precisa das regras do nginx.conf.example do Velk.