Instalador

Entrar com GitHub e instalar

O login serve só pra saber quem é você. O TekZoom pede apenas o escopo read:user, nunca acessa nenhum repositório seu e descarta o token logo depois de confirmar seu login.

Como funciona, passo a passo

1. Escolher o repositório. Precisa ser público e ter Dockerfile ou docker-compose.yml na raiz. Sem isso, o TekZoom recusa na hora, antes de pedir qualquer dado do seu servidor.
2. Informar o seu servidor. Host, porta SSH e usuário. Pode ser qualquer VPS Linux com Docker. Se não tiver Docker, o TekZoom mostra o comando oficial de instalação e espera você confirmar antes de rodar.
3. Colar uma chave que dura um deploy. O TekZoom gera um par de chaves ed25519 na hora e mostra o comando pronto pra você colar no authorized_keys. Ela vale só pra esse deploy.
4. Acompanhar ao vivo. Cada linha de saída aparece na tela enquanto roda. Nada acontece escondido no seu servidor.
5. Abrir no navegador. No fim sai um endereço com HTTPS válido, emitido pela Let's Encrypt. Sem domínio próprio, o TekZoom usa nip.io e funciona na hora.

O que o Instalador nunca faz

• Nunca roda o script de instalação do repositório. Só a sequência fixa de comandos acima. O que roda dentro do container continua sendo decisão do projeto, o que é um risco bem menor do que executar shell de estranho como usuário do seu servidor.
• Nunca apaga nada. Nem arquivo, nem container, nem configuração que já existia. Se um deploy falhar no meio, o que subiu fica como está, visível no seu perfil com o status de falha, pra você decidir o que fazer.
• Nunca toma uma porta ocupada. Se a 80 ou a 443 já estiverem em uso, o TekZoom recusa e explica, em vez de parar o que estava rodando.
• Nunca guarda a sua chave. Cada deploy gera uma chave nova e a remove do authorized_keys no fim, inclusive quando dá erro. Não existe acesso permanente ao seu servidor.
• Nunca conecta em rede interna. Endereços privados (10.x, 192.168.x, 169.254.x) são recusados antes de qualquer tentativa de conexão.

Que repositório dá pra instalar

Dois formatos, e o TekZoom reconhece qual é antes de você tentar.

• Projeto que já traz Docker. Tem Dockerfile, docker-compose.yml ou compose.yml, na raiz ou numa pasta comum como docker/. Esse é o caminho principal: a receita de subida vem do próprio projeto e o TekZoom não precisa adivinhar nada.
• Site estático sem Docker. Quando o projeto é um site feito com Vite, Astro, Docusaurus ou Eleventy, o TekZoom escreve o Dockerfile por você: instala as dependências, roda o build do projeto e serve a pasta que o build gerou. Esse arquivo é nosso, tem passos fixos e nada vindo do repositório entra nele.

Fora esses dois, o TekZoom recusa e diz por quê. E ele recusa bastante, de propósito. Medindo os repositórios que este site exibia, só cerca de três em cada dez dão pra instalar. O resto é biblioteca, ferramenta de linha de comando, app de celular ou lista de links: coisas que nunca tiveram a intenção de rodar num servidor, e que nenhum Dockerfile conserta. Preferimos dizer isso antes de você fazer login do que depois.

Nos cartões do trending, só os projetos que a gente confirmou que dá mostram o botão de instalar. Os outros levam direto pro site ou pro código do projeto.

Por que o TekZoom escreve o Dockerfile só pra site estático

Porque é o único formato em que errar é inofensivo. Num site estático o build gera uma pasta de arquivos e o servidor só entrega arquivo: se o build falhar, falhou um build, e o seu servidor continua como estava.

Num app com banco de dados, senha e variável de ambiente seria diferente. O TekZoom teria que adivinhar configuração que só você tem, a taxa de acerto despencaria, e cada erro aconteceria na sua máquina, deixando container e pasta pela metade lá (porque a gente nunca apaga nada, nem o próprio estrago). Por isso não fazemos, mesmo dando.

Preciso ter domínio?

Não. Sem domínio próprio, o TekZoom publica em um endereço nome.SEU-IP.nip.io, que resolve na hora, sem esperar propagação de DNS, e recebe certificado válido da Let's Encrypt. Se você tiver um domínio apontando pro servidor, é só informar.

Entrar com GitHub e instalar

Saber mais sobre o TekZoom · voltar pro trending