Primeiros passos e respostas para dúvidas comuns.

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 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.

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 mostrado em um workspace parado. Salvar o mesmo workspace novamente depois cria uma nova imagem base independente, em vez de sobrescrever a anterior — gerencie e exclua imagens base que você não precisa mais em Preferências → Imagens Base.

Discos de workspace e imagens base ficam em ~/Library/Application Support/VeloWorkspaces no seu Mac. Exclua da biblioteca os workspaces que você não precisa mais, e imagens base não usadas em Preferências → Imagens Base, para liberar espaço.

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.