Guida introduttiva e risposte alle domande più comuni.

Ubuntu 26.04 e 24.04 LTS, Debian 13 e 12, Fedora 44 Cloud Base e Rocky Linux 10 e 9. L’app scarica l’immagine ufficiale del produttore, la converte per il framework Virtualization di Apple e passa a cloud-init nome utente, password, la chiave SSH di questo Mac e un nome host. Al primo avvio il sistema si configura da solo e si espande fino alla dimensione del disco scelta. Terminato il download, di solito è pronto per l’accesso in circa un minuto.

Ubuntu Server e Desktop, Fedora Server ed Everything e Rocky Linux (minimal e DVD). Lascia attiva “Installazione automatica” nel passaggio Immagine e l’app risponde alle domande del programma di installazione: il tuo account e la chiave SSH, più lingua, tastiera e fuso orario di questo Mac. Il programma di installazione non si ferma a chiedere nulla, nemmeno prima di cancellare il disco virtuale. Al termine, il workspace si riavvia nel nuovo sistema.

Il programma di installazione di Debian, Fedora Workstation, Kali Linux, NixOS e Alpine Linux avviano il proprio programma di installazione nello schermo del workspace, come su un PC. Per un Debian senza interventi usa invece l’immagine cloud di Debian. Su un Mac con Apple silicon puoi anche installare macOS dall’immagine di ripristino di Apple.

È normale dopo ogni installazione manuale, per esempio Kali Linux, NixOS, Alpine Linux o il programma di installazione di Debian. Velo Workspaces sa quando un’installazione automatica è terminata, ma solo tu sai quando hai finito un’installazione a mano. Durante l’installazione il workspace usa il ridimensionamento “Testo grande”, così il menu di avvio e il programma di installazione restano leggibili. Quando il sistema installato si è avviato, fai clic su “Installazione completata”: il supporto di installazione non viene più collegato e dal prossimo avvio vale l’impostazione di visualizzazione del workspace. Arresta e riavvia il workspace una volta per passare all’impostazione; un riavvio dall’interno del guest non basta.

Sì. Fai clic su Scegli file… nel passaggio Immagine, oppure su “Importa…” in Impostazioni › Immagini. Se il nome del file compare nell’elenco dei checksum del produttore, l’app lo verifica con il checksum ufficiale prima di usarlo. Tutto ciò che scarichi o importi resta in Impostazioni › Immagini (anche “Immagini” nella barra laterale), dove puoi riutilizzarlo, verificarlo o eliminarlo.

Avvia il workspace, apri la scheda “Accesso” e fai clic su “Apri Terminale”. Il terminale integrato accede via SSH con una chiave che l’app ha creato per questo Mac e conserva nel Portachiavi. I workspace creati da un’immagine cloud o da un’installazione automatica accettano già quella chiave.

Per un sistema installato da te, inserisci il nome utente nella scheda “Accesso”, accedi una volta con la password e poi fai clic su “Installa chiave”: la password non ti servirà più. In Impostazioni › Accesso puoi copiare, importare o esportare la chiave.

Sì, ed è gratis. La scheda “Accesso” mostra l’indirizzo del workspace con un comando ssh pronto da copiare, e il blocco ~/.ssh/config per l’estensione Remote - SSH di VS Code. Usano la tua chiave SSH, non quella che il terminale integrato conserva nel Portachiavi: incolla la tua chiave pubblica in “Chiavi pubbliche SSH” quando crei il workspace, oppure attiva “Consenti l’accesso SSH con la password”.

Gli altri computer raggiungono un workspace passando dal tuo Mac, perché i workspace si trovano su una rete privata al suo interno. Attiva “Login remoto” in Impostazioni di Sistema › Generali › Condivisione, poi usa il comando ssh -J mostrato nella scheda “Accesso”.

I workspace si trovano su una piccola rete virtuale dentro il Mac (indirizzi come 192.168.64.x), che macOS considera rete locale. Il controllo SSH e il terminale si collegano a quell’indirizzo, quindi macOS lo chiede una volta. L’app non esplora né analizza mai la tua rete: parla solo con i propri workspace.

Se hai scelto “Non consentire”, la scheda “Accesso” mostra “Nessun accesso alla rete locale”. Riattivalo in Impostazioni di Sistema › Privacy e sicurezza › Rete locale.

Workspace macOS (macOS 13 o successivo): le cartelle condivise si montano automaticamente — apri Finder e cerca sotto /Volumes/My Shared Files. Nessun comando necessario.

Workspace Linux: ogni cartella condivisa ha il proprio comando di mount, mostrato direttamente nell'app nella scheda File condivisi del workspace. Ha questo aspetto, usando il tag proprio di quella cartella:

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

Usa esattamente il tag mostrato nell'app — è univoco per cartella, quindi copiare un comando da un'altra parte non funzionerà.

La condivisione degli appunti su Linux dipende da un agente in esecuzione all'interno del guest. Procedi in quest'ordine:

1. Nella scheda Risorse del workspace, conferma che Condivisione appunti sia attivata.
2. All'interno del guest, assicurati che spice-vdagent sia installato:

   sudo apt install spice-vdagent

3. Conferma che l'agente sia effettivamente in esecuzione:

   systemctl status spice-vdagentd

   Se è inattivo, avvialo con sudo systemctl start spice-vdagentd, e se ti trovi su un desktop grafico, esci e rientra affinché la sessione desktop lo rilevi.
4. Alcuni ambienti desktop minimali o headless non avviano spice-vdagent automaticamente — controlla le impostazioni di avvio automatico del tuo ambiente desktop se continua a non funzionare dopo che l'agente è installato ed è in esecuzione.

La condivisione degli appunti al momento funziona solo per i workspace Linux.

Debian usa gli stessi strumenti apt e update-binfmts di Ubuntu. Attiva Rosetta per il workspace nella sua scheda Risorse, avvia il workspace, poi esegui questo una volta all'interno del guest:

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

Fedora non include lo strumento update-binfmts di Debian, ma include systemd-binfmt, che legge esattamente la stessa registrazione kernel binfmt_misc da un file di configurazione. Attiva Rosetta per il workspace nella sua scheda Risorse, avvia il workspace, poi esegui questo una volta all'interno del guest:

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

Il file rosetta.conf persiste tra i riavvii, quindi è una configurazione una tantum per workspace.

1. Installa ed esegui Ollama o MLX sul tuo Mac, al di fuori del workspace.
2. Attiva Ponte IA per il workspace (attivo per impostazione predefinita nel profilo Sandbox IA, oppure attivalo tu stesso nelle impostazioni Integrazioni o Risorse del workspace).
3. Avvia il workspace, poi apri la sua scheda Ponte IA — mostra l'indirizzo dell'endpoint locale e, per un guest Linux, i comandi esatti per inoltrare la connessione.
4. All'interno del workspace, punta i tuoi strumenti verso quell'indirizzo esattamente come faresti con qualsiasi server locale che parla il formato API chat-completions standard.

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

Apri Diagnostica dalla barra laterale, poi fai clic su Esporta. Questo raccoglie i log dell'app locali e le informazioni di sistema in un unico file sul tuo Mac — utile da allegare a un'email quando risolvi un problema con noi.

Nulla viene mai raccolto automaticamente. Questa esportazione avviene solo quando la esegui tu stesso, e il file risultante resta sul tuo Mac a meno che tu non scelga di inviarlo.

Viene eliminato automaticamente nel momento in cui lo chiudi, disco incluso. Non c'è nulla da recuperare dopo — non usare un workspace usa e getta per qualcosa che devi conservare.

Ferma il workspace, poi scegli Salva come immagine di base dal banner di un workspace fermato. Salvando di nuovo lo stesso workspace in seguito si crea una nuova immagine di base separata, senza sostituire quella precedente. Gestisci ed elimina le immagini di base in Impostazioni › Immagini › Immagini base.

I dischi dei workspace e le immagini di base si trovano sotto ~/Library/Application Support/VeloWorkspaces sul tuo Mac. Per liberare spazio, elimina dalla libreria i workspace che non ti servono più e, in Impostazioni › Immagini, le immagini scaricate o le immagini di base che non usi.

Non in questa versione. Velo Workspaces attualmente supporta guest Linux e macOS.

CPU, memoria, storage, cartelle condivise e alcune altre impostazioni fanno parte della configurazione della macchina virtuale e non possono essere modificate mentre è in esecuzione (il framework Virtualization di Apple non supporta la loro modifica a caldo). Ferma il workspace, apporta la modifica, e riavvialo.

I guest macOS richiedono un Mac Apple Silicon come host. Su un Mac Intel, i guest Linux sono comunque pienamente supportati.

Velo Workspaces assegna un nuovo indirizzo MAC univoco a ogni workspace, incluso uno clonato da un'immagine di base. L'installazione minimizzata di Ubuntu Server configura la rete con Netplan sopra systemd-networkd, che per impostazione predefinita associa l'interfaccia all'indirizzo MAC originale dell'immagine di base anziché farla corrispondere per nome interfaccia — quindi, una volta che il clone ha un MAC diverso, nulla corrisponde più e il DHCP non viene mai richiesto.

Trova l'indirizzo MAC effettivo del workspace, quindi aggiornalo nella configurazione di netplan:

ip addr show

Annota l'indirizzo mostrato dopo link/ether per l'interfaccia (solitamente enp0s1), impostalo come MAC di quell'interfaccia nella configurazione netplan e riapplica:

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