Supporto

Guida introduttiva e risposte alle domande più comuni.

Non trovi quello che cerchi? Scrivi a support@veloworkspaces.com e ti aiuteremo direttamente.

Guida introduttiva

Come creare un workspace

  1. Apri Nuovo Workspace

    Dalla libreria dei workspace, scegli Nuovo Workspace e seleziona una fonte per l'immagine: un'immagine ufficiale, un disco virtuale esistente, o un'immagine di base salvata.

  2. Scegli un profilo

    Scegli il profilo adatto al tuo lavoro — Codice & Build, Lab DevOps, Sandbox IA, e altro — oppure configura tu stesso CPU, memoria e storage.

  3. Rivedi e avvia

    Conferma il riepilogo, poi avvia l'installazione (o l'avvio, per un clone di un'immagine di base). Le immagini ufficiali vengono scaricate direttamente dalla fonte propria di quel progetto la prima volta che le usi.

Come usare i workspace usa e getta

  1. Contrassegna un workspace come usa e getta

    Quando crei un workspace, attiva l'opzione usa e getta — meglio se abbinata a un'immagine di base così parte istantaneamente da uno stato noto e funzionante.

  2. Usalo per esattamente un compito

    Esegui il tuo test, riproduci il bug, o prova il comando rischioso — tratta il workspace come completamente sacrificabile.

  3. Chiudilo

    Chiudere un workspace usa e getta lo elimina automaticamente, disco incluso. Non c'è nulla da ripulire dopo, e nulla da recuperare — non usare i workspace usa e getta per qualcosa che devi conservare.

Domande frequenti

Cartelle condivise

Come accedo alla cartella condivisa dall'interno di un workspace?

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

Appunti & input

Copia e incolla non funziona tra il mio Mac e un workspace Linux

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.

Rosetta (x86_64 su Apple Silicon)

Come abilito Rosetta in un workspace Debian?

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
Come abilito Rosetta in un workspace Fedora?

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.

Ponte IA

Come collego Ponte IA a Ollama?
  1. Installa ed esegui Ollama 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.

Workspace usa e getta & immagini di base

Cosa succede a un workspace usa e getta quando lo chiudo?

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.

Come trasformo un workspace in un'immagine di base riutilizzabile?

Ferma il workspace, poi scegli Salva come immagine di base dal banner mostrato su un workspace fermato. Salvare di nuovo lo stesso workspace in seguito crea una nuova immagine di base indipendente invece di sovrascrivere quella precedente — gestisci ed elimina le immagini di base che non ti servono più da Preferenze → Immagini di base.

Dove sono memorizzati i miei workspace e le immagini di base, e come libero spazio?

I dischi dei workspace e le immagini di base si trovano sotto ~/Library/Application Support/VeloWorkspaces sul tuo Mac. Elimina dalla libreria i workspace che non ti servono più, e le immagini di base inutilizzate da Preferenze → Immagini di base, per liberare spazio.

Generale

Velo Workspaces supporta i guest Windows?

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

Perché non posso cambiare alcune impostazioni mentre un workspace è in esecuzione?

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.

Perché non posso creare un guest macOS?

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

Ancora bloccato?

Scrivici e ti aiuteremo a risolvere il problema.

support@veloworkspaces.com