Primeiros passos e respostas para dúvidas comuns.

Ubuntu 26.04 e 24.04 LTS, Debian 13 e 12, Fedora 44 Cloud Base e Rocky Linux 10 e 9. O app baixa a imagem oficial do fabricante, converte-a para o framework Virtualization da Apple e passa ao cloud-init seu nome de usuário, sua senha, a chave SSH deste Mac e um nome de host. Na primeira inicialização o sistema se configura sozinho e cresce até o tamanho de disco escolhido. Depois do download, costuma ficar pronto para login em cerca de um minuto.

Ubuntu Server e Desktop, Fedora Server e Everything, e Rocky Linux (minimal e DVD). Deixe “Instalação automática” ligada na etapa Imagem e o app responde às perguntas do instalador por você: sua conta e chave SSH, além do idioma, teclado e fuso horário deste Mac. O instalador não para para perguntar nada, nem mesmo antes de apagar o disco virtual. Ao terminar, o workspace reinicia no sistema novo.

O instalador do Debian, Fedora Workstation, Kali Linux, NixOS e Alpine Linux rodam o próprio instalador na tela do workspace, como num PC. Para um Debian sem intervenção, use a imagem de nuvem do Debian. Em um Mac com Apple silicon você também pode instalar o macOS pela imagem de restauração da Apple.

Isso é esperado depois de qualquer instalação manual, como Kali Linux, NixOS, Alpine Linux ou o instalador do Debian. O Velo Workspaces sabe quando uma instalação automática termina, mas só você sabe quando terminou uma instalação manual. Durante a instalação, o workspace usa a escala “Texto grande” para que o menu de inicialização e o instalador fiquem legíveis. Quando o sistema instalado tiver iniciado, clique em “Instalação concluída”: o instalador deixa de ser conectado e, a partir da próxima inicialização, vale o ajuste de tela do próprio workspace. Pare e inicie o workspace uma vez para trocar; reiniciar dentro do convidado não é suficiente.

Sim. Clique em Escolher arquivo… na etapa Imagem, ou em “Importar…” em Ajustes › Imagens. Se o nome do arquivo estiver na lista de checksums do fabricante, o app confere o arquivo com o checksum oficial antes de usá-lo. Tudo o que você baixa ou importa fica em Ajustes › Imagens (também “Imagens” na barra lateral), onde dá para reutilizar, verificar ou excluir.

Inicie o workspace, abra a aba “Acesso” e clique em “Abrir Terminal”. O terminal integrado entra por SSH com uma chave que o app criou para este Mac e guarda nas suas Chaves. Workspaces criados de uma imagem de nuvem ou por instalação automática já aceitam essa chave.

Em um sistema que você mesmo instalou, digite o nome de usuário na aba “Acesso”, entre uma vez com a senha e clique em “Instalar Chave”; a senha não será mais pedida. Em Ajustes › Acesso você pode copiar, importar ou exportar a chave.

Sim, e isso é gratuito. A aba “Acesso” mostra o endereço do workspace com um comando ssh pronto para copiar, e o bloco do ~/.ssh/config para a extensão Remote - SSH do VS Code. Eles usam a sua própria chave SSH, não a que o terminal integrado guarda nas Chaves: cole sua chave pública em “Chaves públicas SSH” ao criar o workspace, ou ative “Permitir logins SSH com a senha”.

Outros computadores chegam a um workspace pelo seu Mac, porque os workspaces ficam numa rede privada dentro dele. Ative “Sessão Remota” em Ajustes do Sistema › Geral › Compartilhamento e use o comando ssh -J mostrado na aba “Acesso”.

Os workspaces ficam numa pequena rede virtual dentro do seu Mac (endereços como 192.168.64.x), que o macOS considera rede local. A verificação de SSH e o terminal se conectam a esse endereço, por isso o macOS pergunta uma vez. O app nunca navega nem vasculha sua rede; ele só fala com os próprios workspaces.

Se você escolheu “Não Permitir”, a aba “Acesso” mostra “Sem acesso à rede local”. Ative de novo em Ajustes do Sistema › Privacidade e Segurança › Rede Local.

Workspaces macOS (macOS 13 ou posterior): pastas compartilhadas são montadas automaticamente — abra o Finder e procure em /Volumes/My Shared Files. Nenhum comando necessário.

Workspaces Linux: cada pasta compartilhada tem seu próprio comando de montagem, mostrado diretamente no app na aba Arquivos Compartilhados do workspace. Fica assim, usando a própria tag daquela pasta:

mkdir -p /mnt/my_folder
sudo mount -t virtiofs <folder-tag-shown-in-app> /mnt/my_folder

Use exatamente a tag mostrada no app — ela é única por pasta, então copiar um comando de outro lugar não vai funcionar.

O compartilhamento da área de transferência no Linux depende de um agente rodando dentro do convidado. Siga estes passos em ordem:

1. Na aba Recursos do workspace, confirme que Compartilhamento de Área de Transferência está ativado.
2. Dentro do convidado, confirme que o spice-vdagent está instalado:

   sudo apt install spice-vdagent

3. Confirme que o agente está realmente rodando:

   systemctl status spice-vdagentd

   Se estiver inativo, inicie-o com sudo systemctl start spice-vdagentd, e, se você estiver em um desktop gráfico, saia e entre novamente para que a sessão desktop reconheça.
4. Alguns ambientes desktop mínimos ou headless não iniciam o spice-vdagent automaticamente — verifique as configurações de inicialização automática do seu ambiente desktop se ainda não funcionar depois que o agente estiver instalado e rodando.

O compartilhamento da área de transferência atualmente funciona apenas para workspaces Linux.

O Debian usa as mesmas ferramentas apt e update-binfmts que o Ubuntu. Ative o Rosetta para o workspace na aba Recursos, inicie o workspace, e execute isto uma vez dentro do convidado:

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo apt-get update
sudo apt-get install -y binfmt-support

sudo /usr/sbin/update-binfmts --install rosetta /media/rosetta/rosetta \
  --magic "\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00" \
  --mask "\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff" \
  --credentials yes --preserve yes --fix-binary yes

O Fedora não vem com a ferramenta update-binfmts do Debian, mas vem com o systemd-binfmt, que lê exatamente o mesmo registro de kernel binfmt_misc a partir de um arquivo de configuração. Ative o Rosetta para o workspace na aba Recursos, inicie o workspace, e execute isto uma vez dentro do convidado:

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo mkdir -p /etc/binfmt.d
sudo tee /etc/binfmt.d/rosetta.conf > /dev/null <<'EOF'
:rosetta:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00:\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/media/rosetta/rosetta:CF
EOF

sudo systemctl restart systemd-binfmt

O arquivo rosetta.conf persiste entre reinicializações, então é uma configuração única por workspace.

1. Instale e execute o Ollama ou o MLX no seu Mac, fora do workspace.
2. Ative a Ponte de IA para o workspace (ativa por padrão no perfil Sandbox de IA, ou ative você mesmo nas configurações de Integrações ou Recursos do workspace).
3. Inicie o workspace e abra sua aba Ponte de IA — ela mostra o endereço do endpoint local e, para um convidado Linux, os comandos exatos para encaminhar a conexão.
4. Dentro do workspace, aponte suas ferramentas para esse endereço, exatamente como você faria com qualquer servidor local que use o formato de API chat-completions padrão.

Full setup guide: MLX or Ollama + AI agents in a VM →

Abra Diagnóstico na barra lateral e clique em Exportar. Isso reúne seus logs locais do app e informações do sistema em um único arquivo no seu Mac — útil para anexar a um e-mail ao resolver um problema conosco.

Nada é coletado automaticamente, nunca. Essa exportação só acontece quando você mesmo a executa, e o arquivo resultante permanece no seu Mac, a menos que você escolha enviá-lo.

Ele é excluído automaticamente no momento em que você o fecha, disco incluído. Não há nada para recuperar depois — não use um workspace descartável para nada que você precise manter.

Pare o workspace e escolha Salvar como Imagem Base no banner de um workspace parado. Salvar o mesmo workspace de novo depois cria uma imagem base nova e independente, sem substituir a anterior. Gerencie e exclua imagens base em Ajustes › Imagens › Imagens base.

Discos de workspace e imagens base ficam em ~/Library/Application Support/VeloWorkspaces no seu Mac. Para liberar espaço, exclua da biblioteca os workspaces que você não usa mais e, em Ajustes › Imagens, as imagens baixadas ou imagens base que não usa.

Não nesta versão. O Velo Workspaces atualmente suporta convidados Linux e macOS.

CPU, memória, armazenamento, pastas compartilhadas e algumas outras configurações fazem parte da configuração da máquina virtual e não podem ser alteradas enquanto ela está em execução (o framework Virtualization da Apple não suporta hot-plugging delas). Pare o workspace, faça a alteração, e inicie-o novamente.

Convidados macOS exigem um Mac com Apple Silicon como host. Em um Mac Intel, convidados Linux continuam totalmente suportados.

O Velo Workspaces atribui um novo endereço MAC exclusivo a cada workspace, incluindo um clonado de uma imagem base. A instalação minimizada do Ubuntu Server configura a rede com Netplan sobre o systemd-networkd, que por padrão vincula a interface ao endereço MAC original da imagem base em vez de identificá-la pelo nome da interface — assim, assim que o clone tem um MAC diferente, nada corresponde e o DHCP nunca é solicitado.

Encontre o endereço MAC real do workspace e atualize-o na configuração do netplan:

ip addr show

Anote o endereço exibido após link/ether para a interface (geralmente enp0s1), defina-o como o MAC dessa interface na configuração do netplan e reaplique:

sudo sed -i 's/macaddress:.*/macaddress: <new-mac-address>/' /etc/netplan/*.yaml
sudo netplan apply