Digite para filtrar as páginas da documentação.

    SetupVibe

    SetupVibe 2: edição server e configuração de segurança

    Prepare um servidor com o SetupVibe 2. Crie o usuário de trabalho e configure o acesso por chave SSH antes de aplicar o firewall e iniciar o Docker Swarm.

    Um VPS novo começa como root, sem usuário de trabalho, sem firewall e com SSH aceitando senha. Antes de clonar o primeiro projeto, essa máquina precisa de quatro coisas na ordem certa: um usuário que não seja root, a chave dele no lugar, o firewall fechado e o SSH só por chave. O SetupVibe faz as quatro com a edição server, que é separada da desktop de propósito.

    A edição server instala só o que uma máquina de operação usa: Docker, Portainer, Ansible, GitHub CLI, Tailscale, servidor SSH, as CLIs de agente, shell e tmux. Ela não traz PHP, Ruby, Go nem os aplicativos gráficos da desktop. O que as duas compartilham é a pasta ~/.setupvibe/, o prefixo SETUPVIBE_ e a tabela de exit codes.

    Instalar a edição server

    O installer é o mesmo, com a edição escolhida na linha de comando:

    Terminal
    curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install.sh | sh -s -- --edition server

    Também existe o endereço que já chega com a edição escolhida:

    Terminal
    curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install-server.sh | sh

    A verificação é a mesma da desktop: versão lida de version.json, binário do release, SHA256SUMS e assinatura Sigstore quando o cosign existe. A edição server roda em Ubuntu e Debian. Em macOS, o installer recusa com 11, UNSUPPORTED_SYSTEM.

    As edições são exclusivas por máquina. Se a máquina já tiver a desktop preparada, o init da server sai com 2 e orienta executar self uninstall antes da troca.

    Usuário de trabalho

    Como root, crie o usuário antes de qualquer outra etapa. O user create cria o usuário, o home, a entrada no grupo de sudo (wheel no Arch e no Omarchy), instala a chave pública em authorized_keys e, com --nopasswd, a regra de sudo sem senha validada por visudo -cf antes de entrar no lugar.

    Terminal
    setupvibe user create deploy --ssh-key ~/.ssh/id_ed25519.pub

    A saída termina com o próximo passo: entrar como o usuário novo e rodar o init. A permissão de sudo sem senha criada pelo auto é temporária. Com user create --nopasswd, ela fica até você removê-la:

    Terminal
    setupvibe user nopasswd deploy --remove

    A regra fica em /etc/sudoers.d/90-setupvibe-deploy. Outras regras em /etc/sudoers.d/ são preservadas.

    Módulo de segurança

    security apply configura o UFW para negar conexões de entrada, liberando SSH e as portas do Swarm quando você usa --swarm no servidor. O módulo também configura o jail sshd do fail2ban e as atualizações automáticas de segurança em Debian e Ubuntu. Para fixar o fuso usado pela sincronização de horário, informe --timezone.

    O SSH muda para login só por chave com /etc/ssh/sshd_config.d/10-setupvibe.conf apenas quando o usuário atual já tem uma chave autorizada. O arquivo passa por sshd -t antes de o serviço recarregar. O arquivo define PasswordAuthentication no para desativar o acesso por senha.

    Terminal
    setupvibe security apply --dry-run
    setupvibe security apply --timezone America/Sao_Paulo

    Antes da primeira mudança, o módulo registra em ~/.setupvibe/state/security.json se o UFW e o fail2ban estavam ativos e quais arquivos dele já existiam. Esse registro é o que permite desfazer sem adivinhar:

    Terminal
    setupvibe security remove

    O remove apaga os arquivos que o SetupVibe criou, desliga o fail2ban e o UFW quando eles estavam desligados antes e apaga o registro. Os pacotes continuam instalados. Os arquivos preexistentes são preservados. Sem registro, o comando sai com 3, CONFIG.

    O fluxo de um VPS novo

    A sequência abaixo parte de uma máquina que acabou de subir, com a sua chave já na mão. O auto cria o usuário, continua como ele, instala a seleção da edição server e inicia o Swarm como manager.

    Terminal
    curl -fsSL https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install-server.sh \
    | sh -s -- auto --user deploy --ssh-key ~/.ssh/id_ed25519.pub \
    --manager --advertise-addr 10.0.0.1:2377

    O endereço anunciado precisa ser o que os outros nós alcançam. O auto remove a regra temporária de sudo no fim, salvo --keep-nopasswd. O módulo de segurança entra automaticamente na edição server e na desktop exposta.

    Para juntar um worker, peça o token no manager e passe para a máquina nova:

    Terminal
    TOKEN=$(ssh deploy@10.0.0.1 setupvibe-server swarm token)
    curl -fsSL https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install-server.sh \
    | sh -s -- auto --user deploy --ssh-key ~/.ssh/id_ed25519.pub \
    --join "$TOKEN" --advertise-addr 10.0.0.2:2377

    swarm token manager devolve o token de manager. A option --rotate troca o token de worker antes de imprimir. Com --encrypted-network, a rede overlay do Swarm cifra o tráfego. Para fornecer o token sem escrevê-lo na linha de comando, use a variável SETUPVIBE_SWARM_TOKEN.

    Portainer e portas publicadas

    Nas variantes remotas, o auto prende o Portainer a 127.0.0.1 e grava "ip": "127.0.0.1" em /etc/docker/daemon.json quando o arquivo não tem endereço. Docker escreve as próprias regras de iptables e não passa pelo UFW. Uma porta publicada sem esse cuidado ficaria aberta para a internet. Chegue ao Portainer por túnel SSH ou pela tailnet.

    O doctor lista cada container que publica uma porta em todas as interfaces e mostra o comando para prender a porta ao localhost. Para abrir só uma porta, publique com -p 127.0.0.1:PORTA:PORTA e alcance pelo túnel ou pelo Tailscale.

    Acesso remoto

    Três itens resolvem o acesso de trabalho: openssh-server, tailscale e mosh. O Tailscale entra com a auth key da variável TAILSCALE_AUTHKEY. Depois da entrada na tailnet, --tailscale-ssh ativa o SSH do Tailscale.

    Terminal
    setupvibe auto --profile remoto --tailscale-authkey "$TAILSCALE_AUTHKEY" --tailscale-ssh

    Com o SSH só por chave, a primeira conexão precisa acontecer depois de a chave estar no authorized_keys. O ssh copy-id faz isso antes de o módulo de segurança entrar:

    Terminal
    setupvibe ssh copy-id deploy@203.0.113.10

    Conferir o servidor

    Depois da instalação, a conferência é a mesma da desktop, com o binário da edição server:

    Terminal
    setupvibe-server check
    setupvibe-server doctor

    O doctor mostra o estado do Swarm, das portas publicadas, do firewall e dos itens. O report gera o Markdown para uma issue quando a falha precisa de investigação pelo suporte.

    Se algo der errado

    Sintoma Exit code O que fazer
    execução como root sem --user 12 ROOT passe --user ou crie o usuário com user create
    sudo pede senha sem terminal 13 SUDO_PASSWORD crie a regra com user nopasswd ou rode no terminal
    security remove sem registro 3 CONFIG o módulo não foi aplicado por este binário; confira o estado à mão
    parte dos passos falhou 10 PARTIAL leia o log e rode doctor
    edição desktop já preparada 2 USAGE rode self uninstall antes de instalar a server

    Próximo passo

    O capítulo Agentes de IA e MCP mostra como um agente consulta o estado do servidor e executa o SetupVibe por protocolo.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano