Erste Schritte und Antworten auf häufige Fragen.

Ubuntu 26.04 und 24.04 LTS, Debian 13 und 12, Fedora 44 Cloud Base sowie Rocky Linux 10 und 9. Die App lädt das offizielle Image des Herstellers, bereitet es für Apples Virtualization-Framework auf und übergibt cloud-init Ihren Benutzernamen, Ihr Passwort, den SSH-Schlüssel dieses Macs und einen Hostnamen. Beim ersten Start richtet sich das System selbst ein und wächst auf die gewählte Festplattengröße. Nach dem Download ist es meist in etwa einer Minute bereit zur Anmeldung.

Ubuntu Server und Desktop, Fedora Server und Everything sowie Rocky Linux (minimal und DVD). Lassen Sie im Schritt „Image“ die Option „Automatische Installation“ eingeschaltet, dann beantwortet die App die Fragen des Installers: Ihr Konto und SSH-Schlüssel sowie Sprache, Tastatur und Zeitzone dieses Macs. Der Installer hält für keine Rückfrage an, auch nicht vor dem Löschen der virtuellen Festplatte. Nach der Installation startet der Arbeitsbereich in das neue System.

Der Debian-Installer, Fedora Workstation, Kali Linux, NixOS und Alpine Linux führen ihren eigenen Installer in der Anzeige des Arbeitsbereichs aus, genau wie auf einem PC. Für ein Debian ohne Handarbeit nehmen Sie das Debian-Cloud-Image. Auf einem Mac mit Apple Silicon können Sie außerdem macOS aus Apples Wiederherstellungs-Image installieren.

Das ist nach jeder manuellen Installation so vorgesehen, etwa bei Kali Linux, NixOS, Alpine Linux oder dem Debian-Installer. Velo Workspaces erkennt, wann eine automatische Installation fertig ist, aber nur Sie wissen, wann Sie eine Installation von Hand abgeschlossen haben. Während der Installation nutzt der Arbeitsbereich die Anzeigeskalierung „Großer Text“, damit Bootmenü und Installer gut lesbar sind. Sobald das installierte System gestartet ist, klicken Sie auf „Installation abgeschlossen“: Das Installationsmedium wird nicht mehr eingebunden, und ab dem nächsten Start gilt die eigene Anzeigeeinstellung des Arbeitsbereichs. Stoppen und starten Sie den Arbeitsbereich einmal, um umzuschalten; ein Neustart im Gast genügt nicht.

Ja. Klicken Sie im Schritt „Image“ auf Datei auswählen… oder unter Einstellungen › Images auf „Importieren …“. Steht der Dateiname in der Prüfsummenliste des Herstellers, prüft die App die Datei vor der Verwendung gegen die offizielle Prüfsumme. Alles, was Sie laden oder importieren, bleibt unter Einstellungen › Images (auch „Images“ in der Seitenleiste), wo Sie es wiederverwenden, prüfen oder löschen können.

Starten Sie den Arbeitsbereich, öffnen Sie den Tab „Zugriff“ und klicken Sie auf „Terminal öffnen“. Das integrierte Terminal meldet sich per SSH mit einem Schlüssel an, den die App für diesen Mac erzeugt und in Ihrem Schlüsselbund ablegt. Arbeitsbereiche aus einem Cloud-Image oder einer automatischen Installation vertrauen diesem Schlüssel bereits.

Bei einem selbst installierten System geben Sie im Tab „Zugriff“ den Benutzernamen ein, melden sich einmal mit dem Passwort an und klicken dann auf „Schlüssel installieren“. Danach brauchen Sie das Passwort nicht mehr. Unter Einstellungen › Zugriff können Sie den Schlüssel kopieren, importieren oder exportieren.

Ja, und das ist kostenlos. Der Tab „Zugriff“ zeigt die Adresse des Arbeitsbereichs mit einem kopierfertigen ssh-Befehl sowie den ~/.ssh/config-Block für die VS-Code-Erweiterung Remote - SSH. Diese nutzen Ihren eigenen SSH-Schlüssel, nicht den des integrierten Terminals aus dem Schlüsselbund. Fügen Sie Ihren öffentlichen Schlüssel beim Erstellen des Arbeitsbereichs unter „Öffentliche SSH-Schlüssel“ ein, oder aktivieren Sie „SSH-Anmeldung mit dem Passwort erlauben“.

Andere Computer erreichen einen Arbeitsbereich über Ihren Mac, denn Arbeitsbereiche liegen in einem privaten Netzwerk darin. Aktivieren Sie „Entfernte Anmeldung“ unter Systemeinstellungen › Allgemein › Freigaben und verwenden Sie dann den ssh -J -Befehl aus dem Tab „Zugriff“.

Arbeitsbereiche liegen in einem kleinen virtuellen Netzwerk in Ihrem Mac (Adressen wie 192.168.64.x), und macOS zählt das zum lokalen Netzwerk. Die SSH-Prüfung und das Terminal verbinden sich mit dieser Adresse, deshalb fragt macOS einmal. Die App durchsucht Ihr Netzwerk nie; sie spricht nur mit ihren eigenen Arbeitsbereichen.

Haben Sie „Nicht erlauben“ gewählt, zeigt der Tab „Zugriff“ „Kein Zugriff auf lokales Netzwerk“. Schalten Sie den Zugriff unter Systemeinstellungen › Datenschutz & Sicherheit › Lokales Netzwerk wieder ein.

macOS-Arbeitsbereiche (macOS 13 oder neuer): Gemeinsame Ordner werden automatisch eingebunden — öffnen Sie den Finder und schauen Sie unter /Volumes/My Shared Files nach. Kein Befehl nötig.

Linux-Arbeitsbereiche: Jeder gemeinsame Ordner erhält seinen eigenen Einbindungsbefehl, der direkt in der App unter dem Tab „Freigegebene Dateien“ des Arbeitsbereichs angezeigt wird. Er sieht so aus, mit dem eigenen Tag dieses Ordners:

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

Verwenden Sie genau das in der App angezeigte Tag — es ist pro Ordner eindeutig, sodass das Kopieren eines Befehls von anderswo nicht funktioniert.

Die Zwischenablage-Freigabe unter Linux hängt von einem im Gast laufenden Agenten ab. Gehen Sie diese Schritte der Reihe nach durch:

1. Bestätigen Sie im Resources-Tab des Arbeitsbereichs, dass Zwischenablage-Freigabe aktiviert ist.
2. Stellen Sie im Gast sicher, dass spice-vdagent installiert ist:

   sudo apt install spice-vdagent

3. Bestätigen Sie, dass der Agent tatsächlich läuft:

   systemctl status spice-vdagentd

   Falls er inaktiv ist, starten Sie ihn mit sudo systemctl start spice-vdagentd, und melden Sie sich, falls Sie eine grafische Desktop-Umgebung nutzen, ab und wieder an, damit die Desktop-Sitzung ihn erkennt.
4. Manche minimalen oder headless Desktop-Umgebungen starten spice-vdagent nicht automatisch — prüfen Sie die Autostart-Einstellungen Ihrer Desktop-Umgebung, falls es weiterhin nicht funktioniert, nachdem der Agent installiert ist und läuft.

Die Zwischenablage-Freigabe funktioniert derzeit nur für Linux-Arbeitsbereiche.

Debian nutzt dieselben apt und update-binfmts Werkzeuge wie Ubuntu. Aktivieren Sie Rosetta für den Arbeitsbereich im Resources-Tab, starten Sie den Arbeitsbereich, und führen Sie dann einmalig Folgendes im Gast aus:

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 liefert Debians update-binfmts Tool nicht mit, wohl aber systemd-binfmt, das über eine Konfigurationsdatei exakt dieselbe Kernel- binfmt_misc -Registrierung liest. Aktivieren Sie Rosetta für den Arbeitsbereich im Resources-Tab, starten Sie den Arbeitsbereich, und führen Sie dann einmalig Folgendes im Gast aus:

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

Die Datei rosetta.conf bleibt über Neustarts hinweg bestehen — dies ist also eine einmalige Einrichtung pro Arbeitsbereich.

1. Installieren und starten Sie Ollama oder MLX auf Ihrem Mac, außerhalb des Arbeitsbereichs.
2. Aktivieren Sie AI Bridge für den Arbeitsbereich (standardmäßig aktiv im KI-Sandbox-Profil, oder selbst in den Integrations- bzw. Resources-Einstellungen des Arbeitsbereichs aktivieren).
3. Starten Sie den Arbeitsbereich und öffnen Sie dann dessen AI-Bridge-Tab — er zeigt die lokale Endpunktadresse und, bei einem Linux-Gast, die genauen Befehle zur Weiterleitung der Verbindung.
4. Richten Sie Ihre Werkzeuge innerhalb des Arbeitsbereichs auf diese Adresse, genauso wie Sie es bei jedem lokalen Server tun würden, der das gängige Chat-Completions-API-Format spricht.

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

Öffnen Sie Diagnose in der Seitenleiste und klicken Sie auf Exportieren. Dies bündelt Ihre lokalen App-Protokolle und Systeminformationen in einer einzigen Datei auf Ihrem Mac — praktisch, um sie einer E-Mail anzuhängen, wenn Sie mit uns ein Problem beheben.

Es wird niemals automatisch etwas erfasst. Dieser Export erfolgt nur, wenn Sie ihn selbst ausführen, und die resultierende Datei bleibt auf Ihrem Mac, es sei denn, Sie entscheiden sich, sie zu senden.

Er wird automatisch in dem Moment gelöscht, in dem Sie ihn schließen, inklusive Festplatte. Danach gibt es nichts wiederherzustellen — verwenden Sie einen Einweg-Arbeitsbereich nicht für etwas, das Sie behalten müssen.

Stoppen Sie den Arbeitsbereich und wählen Sie dann Als Basis-Image speichern aus dem Banner eines gestoppten Arbeitsbereichs. Speichern Sie denselben Arbeitsbereich später erneut, entsteht ein neues, eigenständiges Basis-Image; das alte bleibt erhalten. Basis-Images verwalten und löschen Sie unter Einstellungen › Images › Basis-Images.

Arbeitsbereich-Festplatten und Basis-Images liegen unter ~/Library/Application Support/VeloWorkspaces auf Ihrem Mac. Um Speicherplatz freizugeben, löschen Sie nicht mehr benötigte Arbeitsbereiche aus der Bibliothek und ungenutzte geladene Images oder Basis-Images unter Einstellungen › Images.

Nicht in dieser Version. Velo Workspaces unterstützt derzeit Linux- und macOS-Gäste.

CPU, Arbeitsspeicher, Speicherplatz, gemeinsame Ordner und einige andere Einstellungen sind Teil der Konfiguration der virtuellen Maschine und können nicht geändert werden, während sie läuft (Apples Virtualization-Framework unterstützt kein Hot-Plugging dafür). Stoppen Sie den Arbeitsbereich, nehmen Sie die Änderung vor, und starten Sie ihn erneut.

macOS-Gäste erfordern einen Apple-Silicon-Mac als Host. Auf einem Intel-Mac werden Linux-Gäste weiterhin vollständig unterstützt.

Velo Workspaces vergibt für jeden Workspace eine neue, eindeutige MAC-Adresse — auch für einen aus einem Basisabbild geklonten. Die minimierte Ubuntu-Server-Installation konfiguriert das Netzwerk mit Netplan auf Basis von systemd-networkd, das die Schnittstelle standardmäßig an die ursprüngliche MAC-Adresse des Basisabbilds bindet, statt sie über den Schnittstellennamen zuzuordnen — sobald der Klon eine andere MAC-Adresse hat, passt nichts mehr zusammen und DHCP wird nie angefragt.

Ermitteln Sie die tatsächliche MAC-Adresse des Workspace und tragen Sie sie in die Netplan-Konfiguration ein:

ip addr show

Notieren Sie sich die nach link/ether angezeigte Adresse der Schnittstelle (meist enp0s1), setzen Sie sie als MAC-Adresse dieser Schnittstelle in der Netplan-Konfiguration und wenden Sie sie erneut an:

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