Prise en main, et réponses aux questions fréquentes.

Espaces de travail macOS (macOS 13 ou ultérieur) : les dossiers partagés se montent automatiquement — ouvrez le Finder et cherchez sous /Volumes/My Shared Files. Aucune commande nécessaire.

Espaces de travail Linux : chaque dossier partagé a sa propre commande de montage, affichée directement dans l'application sous l'onglet Fichiers partagés de l'espace de travail. Elle ressemble à ceci, en utilisant le tag propre de ce dossier :

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

Utilisez exactement le tag affiché dans l'application — il est unique par dossier, donc copier une commande venant d'ailleurs ne fonctionnera pas.

Le partage du presse-papiers sous Linux dépend d'un agent exécuté dans l'invité. Suivez ces étapes dans l'ordre :

1. Dans l'onglet Ressources de l'espace de travail, vérifiez que Partage du presse-papiers est activé.
2. Dans l'invité, assurez-vous que spice-vdagent est installé :

   sudo apt install spice-vdagent

3. Vérifiez que l'agent est bien en cours d'exécution :

   systemctl status spice-vdagentd

   S'il est inactif, démarrez-le avec sudo systemctl start spice-vdagentd, et si vous êtes sur un bureau graphique, déconnectez-vous et reconnectez-vous pour que la session de bureau le prenne en compte.
4. Certains environnements de bureau minimaux ou headless ne lancent pas automatiquement spice-vdagent — vérifiez les paramètres de démarrage automatique de votre environnement de bureau si cela ne fonctionne toujours pas une fois l'agent installé et en cours d'exécution.

Le partage du presse-papiers fonctionne actuellement uniquement pour les espaces de travail Linux.

Debian utilise les mêmes outils apt et update-binfmts qu'Ubuntu. Activez Rosetta pour l'espace de travail dans son onglet Ressources, démarrez l'espace de travail, puis exécutez ceci une fois dans l'invité :

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 n'embarque pas l'outil update-binfmts de Debian, mais il embarque systemd-binfmt, qui lit exactement le même enregistrement noyau binfmt_misc depuis un fichier de configuration. Activez Rosetta pour l'espace de travail dans son onglet Ressources, démarrez l'espace de travail, puis exécutez ceci une fois dans l'invité :

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

Le fichier rosetta.conf persiste après redémarrage, il s'agit donc d'une configuration unique par espace de travail.

1. Installez et exécutez Ollama sur votre Mac, en dehors de l'espace de travail.
2. Activez Pont IA pour l'espace de travail (activé par défaut dans le profil Bac à sable IA, ou activez-le vous-même dans les paramètres Intégrations ou Ressources de l'espace de travail).
3. Démarrez l'espace de travail, puis ouvrez son onglet Pont IA — il affiche l'adresse du point de terminaison local et, pour un invité Linux, les commandes exactes pour transférer la connexion.
4. Dans l'espace de travail, pointez vos outils vers cette adresse exactement comme vous le feriez pour n'importe quel serveur local qui parle le format d'API chat-completions standard.

Il est supprimé automatiquement dès que vous le fermez, disque compris. Il n'y a rien à récupérer ensuite — n'utilisez pas un espace de travail jetable pour quoi que ce soit que vous devez conserver.

Arrêtez l'espace de travail, puis choisissez Enregistrer comme image de base depuis la bannière affichée sur un espace de travail arrêté. Enregistrer à nouveau le même espace de travail plus tard crée une nouvelle image de base indépendante plutôt que d'écraser la précédente — gérez et supprimez les images de base dont vous n'avez plus besoin depuis Préférences → Images de base.

Les disques des espaces de travail et les images de base se trouvent sous ~/Library/Application Support/VeloWorkspaces sur votre Mac. Supprimez de la bibliothèque les espaces de travail dont vous n'avez plus besoin, et les images de base inutilisées depuis Préférences → Images de base, pour libérer de l'espace.

Pas dans cette version. Velo Workspaces prend actuellement en charge les invités Linux et macOS.

Le CPU, la mémoire, le stockage, les dossiers partagés et quelques autres paramètres font partie de la configuration de la machine virtuelle et ne peuvent pas être modifiés pendant son exécution (le framework Virtualization d'Apple ne prend pas en charge leur modification à chaud). Arrêtez l'espace de travail, effectuez le changement, puis redémarrez-le.

Les invités macOS nécessitent un Mac Apple Silicon comme hôte. Sur un Mac Intel, les invités Linux restent entièrement pris en charge.