Ir para o conteúdo
Promovaweb
Projeto open source da Promovaweb

Preparar a máquina

Debian 12+: usuário comum, sudo e curl

Procedimento para preparar um servidor Debian 12 ou mais recente antes do SetupVibe: instalar o sudo e o curl como root, criar um usuário comum no grupo sudo e executar o instalador com esse usuário.

StayCloudVPS Agêntica

O mesmo ambiente do SetupVibe, agora numa VPS

Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

30% offnos 2 primeiros meses do plano mensal da VPS

Black Friday da StayCloud até 30/11, sem fidelidade.

Criar minha VPS na StayCloud

Link de parceiro da Promovaweb. O cupom Black entra sozinho no configurador.

Por que executar como usuário comum

Os instaladores gravam as ferramentas de usuário no diretório do usuário indicado pela variável REAL_USER. Com sudo, o valor vem de SUDO_USER. Numa sessão SSH aberta como root, sem sudo, o desktop.sh consulta logname e who am i. Quando os dois retornam root, o usuário-alvo também é root.

Nesse caso, a configuração do Zsh, do Starship, do tmux, dos CLIs de IA e dos aliases fica em /root. Um usuário criado depois começa sem essa configuração.

O server.sh exige o sudo quando não roda como root. Sem o binário, ele encerra com sudo is required when not running as root.

Requisitos

  • Sistema: Debian 12 (bookworm) ou mais recente. O SetupVibe também suporta o Ubuntu 24.04 ou mais recente, que já traz o sudo.
  • Acesso: login como root por SSH, com senha ou chave, ou pelo console do provedor.
  • Rede: saída HTTPS para a internet, usada pelo apt e pelo instalador.
  • Cliente: OpenSSH no computador local.

Procedimento

Os comandos usam o usuário dev e o endereço 203.0.113.10, da faixa reservada para documentação (RFC 5737). Substitua pelos valores do seu servidor. Os passos 2 a 4 rodam como root.

  1. Conecte como root

    Abra a sessão SSH com o endereço informado pelo provedor. Na primeira conexão, confira a impressão digital da chave do host antes de aceitar. No console web do provedor, faça login como root e siga para o passo 2.

    ssh root@203.0.113.10
  2. Instale o sudo e o curl

    apt update atualiza o índice de pacotes a partir das fontes em /etc/apt/sources.list e /etc/apt/sources.list.d/. apt install -y instala os dois pacotes sem pedir confirmação. Pacotes já instalados são mantidos.

    apt update
    apt install -y sudo curl
  3. Crie o usuário

    adduser cria o usuário, o grupo primário com o mesmo nome e o diretório /home/dev. O comando pede a senha e os campos GECOS, como nome completo e telefones, que podem ficar vazios. Use letras minúsculas, sem espaços.

    adduser dev
  4. Adicione o usuário ao grupo sudo

    O /etc/sudoers do Debian traz a regra %sudo ALL=(ALL:ALL) ALL. Com ela, todo membro do grupo sudo executa comandos como root com a própria senha. usermod -aG acrescenta o grupo suplementar e mantém os demais. Sem o -a, o -G substitui a lista de grupos do usuário.

    usermod -aG sudo dev
  5. Verifique o acesso

    su - dev abre um shell de login com o ambiente do usuário. sudo -v valida a senha e renova o cache de credenciais sem executar comando. Sem saída, o acesso está correto. groups lista os grupos do usuário, com sudo entre eles. Encerre com exit.

    su - dev
    sudo -v
    groups
  6. Reconecte com o usuário

    Encerre a sessão de root e abra uma sessão SSH com o usuário criado. A associação ao grupo vale para as sessões abertas depois do usermod.

    ssh dev@203.0.113.10
  7. Execute o instalador

    Escolha a edição pelo papel do servidor. O Desktop atende desenvolvimento, Vibe Coding e agentes remotos. O Server atende aplicações em produção. Execute o comando com esse usuário, sem sudo. O script pede a senha nas etapas que instalam pacotes de sistema. As ferramentas de usuário ficam em /home/dev.

    No fim, o script define o Zsh como shell do usuário com chsh. Rode exec zsh ou abra uma nova sessão.

    SetupVibe Desktop

    curl -fsSL https://desktop.setupvibe.dev | bash

    SetupVibe Server

    curl -fsSL https://server.setupvibe.dev | bash

Solução de problemas

dev is not in the sudoers file

O usuário não pertence ao grupo sudo, ou a sessão foi aberta antes do usermod. Como root, rode usermod -aG sudo dev e confira com getent group sudo. Depois, abra uma nova sessão com o usuário.

getent group sudo

sudo: command not found

O pacote não está instalado. A mesma causa vale para curl: command not found. Repita o passo 2 como root. Se o apt update falhar, confira a resolução de nomes e as fontes em /etc/apt/sources.list.d/.

Configuração gravada em /root

O instalador rodou numa sessão de root sem sudo. Por isso, o usuário-alvo foi root. Abra uma sessão com o usuário, como no passo 6. Depois, execute o comando da edição de novo. A configuração passa a ficar em /home/dev.

Regra dedicada em /etc/sudoers.d/

Para liberar o acesso sem o grupo, crie um arquivo em /etc/sudoers.d/ com o visudo, que valida a sintaxe antes de gravar. Um erro de sintaxe pode impedir o sudo de carregar a configuração. Conteúdo do arquivo: dev ALL=(ALL:ALL) ALL.

visudo -f /etc/sudoers.d/dev

Desenvolvimento com IA na Promovaweb

Preparar o ambiente é uma etapa do desenvolvimento. No Plano IA Makers, você aprende a especificar, construir, revisar e publicar sistemas e agentes com apoio de IA. A Formação Vibe Coding está incluída no plano. Consulte a página para conhecer o conteúdo e as condições de acesso.

Conhecer o Plano IA Makers

Prefere avançar no seu projeto com orientação ao vivo? Veja o Desenvolvimento Colaborativo da Dev Side Studio.