Soporte

Primeros pasos y respuestas a preguntas frecuentes.

¿No encuentras lo que buscas? Escribe a support@veloworkspaces.com y te ayudaremos directamente.

Primeros pasos

Cómo crear un espacio de trabajo

  1. Elige de dónde sale el sistema

    Elige una biblioteca en la barra lateral y haz clic en «+» arriba a la derecha. Elige «Imagen cloud» para un sistema listo en un minuto aproximadamente, «Imagen de instalación» para ejecutar el instalador de una distribución, o «Arrancar desde un disco virtual ya existente» para partir de una imagen base o de un disco que ya tengas.

  2. Elige la imagen

    Elige distribución y versión. Las imágenes se descargan de los servidores del fabricante a tu biblioteca de imágenes, se comprueban con la suma de verificación publicada y se reutilizan la próxima vez. ¿Ya tienes el archivo? Haz clic en «Elegir archivo…». En los instaladores de Ubuntu, Fedora Server y Rocky Linux, deja activada «Instalación automática» y la instalación avanza sola.

  3. Configura, revisa y crea

    Elige un perfil (Code & Build, DevOps Lab, AI Sandbox u Office & Study) o ajusta tú la CPU, la memoria y el disco, e introduce un nombre de usuario y una contraseña. Revisa el resumen y haz clic en «Crear espacio de trabajo». La app crea tu cuenta y le añade la clave SSH de este Mac.

Guías paso a paso con capturas, para cada forma de crear un espacio de trabajo (en inglés) →

Cómo usar los espacios de trabajo desechablesPro

  1. Añadir un espacio de trabajo desechable

    Elige «Espacio de trabajo desechable» en la barra lateral, haz clic en «+» arriba a la derecha y sigue los pasos anteriores. Lo más rápido es «Arrancar desde un disco virtual ya existente» con una imagen base guardada: un sistema fiable, listo en segundos.

  2. Úsalo para exactamente una tarea

    Ejecuta tu prueba, reproduce el error, o prueba el comando arriesgado — trata el espacio de trabajo como totalmente prescindible.

  3. Ciérralo

    Cerrar un espacio de trabajo desechable lo elimina automáticamente, disco incluido. No hay nada que limpiar después, ni nada que recuperar — no uses espacios de trabajo desechables para nada que necesites conservar.

Preguntas frecuentes

Imágenes cloud e instalaciones automáticas

¿Qué sistemas Linux puedo crear desde una imagen cloud?

Ubuntu 26.04 y 24.04 LTS, Debian 13 y 12, Fedora 44 Cloud Base y Rocky Linux 10 y 9. La app descarga la imagen oficial del fabricante, la convierte para el framework Virtualization de Apple y pasa a cloud-init tu nombre de usuario, tu contraseña, la clave SSH de este Mac y un nombre de host. En el primer arranque el sistema se configura solo y crece hasta el tamaño de disco que elegiste. Terminada la descarga, suele estar listo para iniciar sesión en un minuto aproximadamente.

¿Qué instaladores funcionan solos?

Ubuntu Server y Desktop, Fedora Server y Everything, y Rocky Linux (minimal y DVD). Deja activada «Instalación automática» en el paso Imagen y la app responde por ti a las preguntas del instalador: tu cuenta y tu clave SSH, además del idioma, el teclado y la zona horaria de este Mac. El instalador no se detiene a preguntar nada, ni siquiera antes de borrar el disco virtual. Al terminar, el espacio de trabajo se reinicia en el sistema nuevo.

¿Qué sistemas instalo a mano?

El instalador de Debian, Fedora Workstation, Kali Linux, NixOS y Alpine Linux ejecutan su propio instalador en la pantalla del espacio de trabajo, igual que en un PC. Para un Debian sin intervención, usa la imagen cloud de Debian. En un Mac con Apple silicon también puedes instalar macOS desde la imagen de restauración de Apple.

¿Por qué un espacio de trabajo instalado a mano pregunta «¿Terminaste de instalar el sistema invitado?»?

Es lo esperado tras cualquier instalación manual, como Kali Linux, NixOS, Alpine Linux o el instalador de Debian. Velo Workspaces sabe cuándo termina una instalación automática, pero solo tú sabes cuándo has terminado una a mano. Mientras se instala el sistema, el espacio de trabajo usa el escalado «Texto grande» para que el menú de arranque y el instalador se lean bien. Cuando el sistema instalado haya arrancado, haz clic en «Instalación completada»: el instalador deja de conectarse y, desde el próximo inicio, se aplica el ajuste de pantalla propio del espacio de trabajo. Detén e inicia el espacio de trabajo una vez para cambiar; reiniciar desde dentro del invitado no basta.

¿Puedo usar una ISO o una imagen cloud que ya descargué?

Sí. Haz clic en Elegir archivo… en el paso Imagen, o en «Importar…» en Ajustes › Imágenes. Si el nombre del archivo aparece en la lista de sumas de verificación del fabricante, la app lo comprueba con la suma oficial antes de usarlo. Todo lo que descargas o importas queda en Ajustes › Imágenes (también «Imágenes» en la barra lateral), donde puedes reutilizarlo, verificarlo o eliminarlo.

SSH y terminal

¿Cómo abro un terminal en un espacio de trabajo?Pro

Inicia el espacio de trabajo, abre su pestaña «Acceso» y haz clic en «Abrir Terminal». El terminal integrado inicia sesión por SSH con una clave que la app creó para este Mac y guarda en tu llavero. Los espacios de trabajo creados desde una imagen cloud o con instalación automática ya aceptan esa clave.

En un sistema que instalaste tú, escribe su nombre de usuario en la pestaña «Acceso», inicia sesión una vez con la contraseña y haz clic en «Instalar clave»; ya no necesitarás la contraseña. En Ajustes › Acceso puedes copiar, importar o exportar la clave.

¿Puedo usar mi propio terminal o VS Code, o conectarme desde otro ordenador?

Sí, y es gratis. La pestaña «Acceso» muestra la dirección del espacio de trabajo con un comando ssh listo para copiar, y el bloque de ~/.ssh/config para la extensión Remote - SSH de VS Code. Usan tu propia clave SSH, no la que el terminal integrado guarda en el llavero: pega tu clave pública en «Claves públicas SSH» al crear el espacio de trabajo, o activa «Permitir inicios de sesión SSH con la contraseña».

Otros ordenadores llegan a un espacio de trabajo a través de tu Mac, porque los espacios de trabajo están en una red privada dentro de él. Activa «Sesión remota» en Ajustes del Sistema › General › Compartir y usa el comando ssh -J que aparece en la pestaña «Acceso».

¿Por qué macOS pregunta si Velo Workspaces puede buscar dispositivos en la red local?

Los espacios de trabajo están en una pequeña red virtual dentro de tu Mac (direcciones como 192.168.64.x), y macOS la considera red local. La comprobación SSH y el terminal se conectan a esa dirección, así que macOS pregunta una vez. La app nunca explora ni analiza tu red; solo habla con sus propios espacios de trabajo.

Si elegiste «No permitir», la pestaña «Acceso» muestra «Sin acceso a la red local». Vuelve a activarlo en Ajustes del Sistema › Privacidad y seguridad › Red local.

Carpetas compartidas

¿Cómo accedo a la carpeta compartida desde dentro de un espacio de trabajo?

Espacios de trabajo macOS (macOS 13 o posterior): las carpetas compartidas se montan automáticamente — abre Finder y busca en /Volumes/My Shared Files. No se necesita ningún comando.

Espacios de trabajo Linux: cada carpeta compartida tiene su propio comando de montaje, que se muestra directamente en la app en la pestaña Archivos compartidos del espacio de trabajo. Se ve así, usando la etiqueta propia de esa carpeta:

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

Usa exactamente la etiqueta mostrada en la app — es única por carpeta, así que copiar un comando de otro lugar no funcionará.

Portapapeles y entrada

Copiar y pegar no funciona entre mi Mac y un espacio de trabajo Linux

La compartición del portapapeles en Linux depende de un agente que se ejecuta dentro del invitado. Sigue estos pasos en orden:

  1. En la pestaña Recursos del espacio de trabajo, confirma que Compartir portapapeles esté activado.
  2. Dentro del invitado, asegúrate de que spice-vdagent esté instalado:
    sudo apt install spice-vdagent
  3. Confirma que el agente realmente se esté ejecutando:
    systemctl status spice-vdagentd
    Si está inactivo, inícialo con sudo systemctl start spice-vdagentd, y si usas un escritorio gráfico, cierra sesión y vuelve a entrar para que la sesión de escritorio lo reconozca.
  4. Algunos entornos de escritorio mínimos o headless no inician spice-vdagent automáticamente — revisa la configuración de inicio automático de tu entorno de escritorio si sigue sin funcionar después de que el agente esté instalado y en ejecución.

La compartición del portapapeles actualmente solo funciona para espacios de trabajo Linux.

Rosetta (x86_64 en Apple Silicon)Pro

¿Cómo activo Rosetta en un espacio de trabajo Debian?

Debian usa las mismas herramientas apt y update-binfmts que Ubuntu. Activa Rosetta para el espacio de trabajo en su pestaña Recursos, inícialo, y luego ejecuta esto una vez dentro del invitado:

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
¿Cómo activo Rosetta en un espacio de trabajo Fedora?

Fedora no incluye la herramienta update-binfmts de Debian, pero sí incluye systemd-binfmt, que lee exactamente el mismo registro del kernel binfmt_misc desde un archivo de configuración. Activa Rosetta para el espacio de trabajo en su pestaña Recursos, inícialo, y luego ejecuta esto una vez dentro del invitado:

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

El archivo rosetta.conf persiste entre reinicios, así que es una configuración única por espacio de trabajo.

Puente de IAPro

¿Cómo conecto Puente de IA a Ollama o MLX?
  1. Instala y ejecuta Ollama o MLX en tu Mac, fuera del espacio de trabajo.
  2. Activa Puente de IA para el espacio de trabajo (activado por defecto en el perfil Sandbox de IA, o actívalo tú mismo en la configuración de Integraciones o Recursos del espacio de trabajo).
  3. Inicia el espacio de trabajo y luego abre su pestaña Puente de IA — muestra la dirección del endpoint local y, para un invitado Linux, los comandos exactos para reenviar la conexión.
  4. Dentro del espacio de trabajo, apunta tus herramientas a esa dirección igual que lo harías con cualquier servidor local que use el formato de API chat-completions estándar.

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

Diagnóstico

¿Cómo exporto registros para solucionar un problema?

Abre Diagnóstico desde la barra lateral y haz clic en Exportar. Esto agrupa tus registros locales de la app e información del sistema en un solo archivo en tu Mac — útil para adjuntarlo a un correo cuando resuelves un problema con nosotros.

Nunca se recopila nada automáticamente. Esa exportación solo ocurre cuando la ejecutas tú mismo, y el archivo resultante permanece en tu Mac a menos que decidas enviarlo.

Espacios de trabajo desechables e imágenes base

¿Qué pasa con un espacio de trabajo desechable cuando lo cierro?

Se elimina automáticamente en el momento en que lo cierras, disco incluido. No hay nada que recuperar después — no uses un espacio de trabajo desechable para nada que necesites conservar.

¿Cómo convierto un espacio de trabajo en una imagen base reutilizable?Pro

Detén el espacio de trabajo y luego elige Guardar como imagen base en el aviso de un espacio de trabajo detenido. Si más tarde guardas otra vez el mismo espacio de trabajo, se crea una imagen base nueva e independiente, sin sustituir la anterior. Gestiona y elimina tus imágenes base en Ajustes › Imágenes › Imágenes base.

¿Dónde se guardan mis espacios de trabajo e imágenes, y cómo libero espacio?

Los discos de los espacios de trabajo y las imágenes base están en ~/Library/Application Support/VeloWorkspaces en tu Mac. Para liberar espacio, elimina de la biblioteca los espacios de trabajo que ya no necesites y, en Ajustes › Imágenes, las imágenes descargadas o imágenes base que no uses.

General

¿Velo Workspaces admite invitados Windows?

No en esta versión. Velo Workspaces actualmente admite invitados Linux y macOS.

¿Por qué no puedo cambiar algunos ajustes mientras un espacio de trabajo está en ejecución?

CPU, memoria, almacenamiento, carpetas compartidas y algunos otros ajustes forman parte de la configuración de la máquina virtual y no se pueden cambiar mientras está en ejecución (el framework Virtualization de Apple no admite modificarlos en caliente). Detén el espacio de trabajo, haz el cambio, y vuelve a iniciarlo.

¿Por qué no puedo crear un invitado macOS?

Los invitados macOS requieren un Mac con Apple Silicon como host. En un Mac Intel, los invitados Linux siguen siendo totalmente compatibles.

Un workspace clonado desde una imagen base de Ubuntu Server (minimizada) no obtiene una dirección IP

Velo Workspaces asigna una nueva dirección MAC única a cada workspace, incluido uno clonado desde una imagen base. La instalación minimizada de Ubuntu Server configura la red con Netplan sobre systemd-networkd, que por defecto vincula la interfaz a la dirección MAC original de la imagen base en lugar de identificarla por el nombre de la interfaz — así que en cuanto el clon tiene una MAC diferente, nada coincide y nunca se solicita DHCP.

Busca la dirección MAC real del workspace y actualízala en la configuración de netplan:

ip addr show

Anota la dirección que aparece después de link/ether para la interfaz (normalmente enp0s1), configúrala como la MAC de esa interfaz en netplan y vuelve a aplicar:

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

¿Sigues atascado?

Escríbenos y te ayudaremos a resolverlo.

support@veloworkspaces.com