🐳 Docker Sandboxes — $250 de Crédito Cloud y CLI sbx

Qué es

Docker Sandboxes ejecuta agentes de código dentro de microVMs con kernel propio, en tu máquina o en la nube de Docker. El CLI sbx es el mismo para ambos modos; añades --cloud y el trabajo sigue aunque cierres el portátil.

  • 🆓 Local: gratis, sin Docker Desktop, incluso para uso comercial
  • ☁️ Cloud: pago por segundo, desde $0,07/hora
  • 🎁 Promo: $250 de crédito para nuevas cuentas de Docker Agentic Platform
  • 💳 Requisito: tarjeta válida al registrarte; el crédito es solo para cómputo

«Gratis» con asterisco grande

Los $250 son un crédito de prueba, no un plan gratuito permanente. Cubren solo cómputo de sandbox; las APIs de los modelos y las suscripciones de agentes se pagan aparte. Cuando se acaba el crédito, Docker cobra a la tarjeta. El crédito caduca a los 6 meses, es uno por cuenta, no es transferible y no tiene valor en efectivo. La oferta está vigente hasta el 31 de enero de 2027 (11:59 PM PT).


📋 Ficha técnica

CampoDato
NombreDocker Sandboxes · Docker Agentic Platform
CLIsbx (versión 0.45+ para cloud)
AislamientoMicroVM con kernel propio, no un contenedor compartido
ModosLocal (tu hardware) · Cloud (infraestructura de Docker)
AgentesClaude, Codex, Cursor, Devin, Docker Agent, Gemini, OpenCode, Shell y más
LocalGratis, sin Docker Desktop; requiere KVM en Linux
CloudPago por segundo; 2 vCPU / 4 GiB por defecto
Crédito$250 para nuevas cuentas, con tarjeta y por 6 meses
TTL cloud1 hora por defecto; máximo 24 horas por sesión
Webdocker.com/products/docker-sandboxes · Promo

🧭 Local vs. cloud (no son lo mismo)

CapacidadLocalCloud (--cloud)
CómputoTu CPU/RAMInfraestructura de Docker
WorkspaceMonta carpetas del host o clona un repoNo acepta rutas locales; hay que copiar o clonar dentro
GPU / USB / displaySí, si el host lo soportaNo
SecretosStore local de sbxStore separado de sbx --cloud
PuertosBind al hostURL HTTPS pública
PersistenciaHasta que borras el sandboxSegún TTL; al expirar se para o se borra
Facturación$0Por segundo de cómputo
Estadosbx lssbx --cloud ls (listas separadas)

La trampa de mezclar modos

Un sandbox local no aparece en sbx --cloud ls, y viceversa. Los secretos, plantillas, políticas y volúmenes tampoco se comparten. Para mover un filesystem entre ambos existe sbx move, pero no unifica los stores ni transfiere secretos.


💸 El crédito de $250

Cómo se activa

  1. Entra a la página de la promo.
  2. Crea una cuenta nueva de Docker Agentic Platform.
  3. Añade una tarjeta válida y completa la verificación 3DS.
  4. El crédito aparece como «Your $250 compute credit has been applied».

La tarjeta no es decorativa

Docker hace una retención de autorización (típicamente ~$1) y la devuelve. Si usas una tarjeta prepago con saldo mínimo, el alta puede pasar, pero no hay colchón para sobrecostes. Si el crédito se agota y la tarjeta no puede pagar, el cloud puede quedar bloqueado. No es un free tier ilimitado.

Cuánto rinde

TamañovCPURAMPrecio/hora$250 compran
Micro12 GiB$0,070~3.570 h
Small (default)24 GiB$0,140~1.785 h
Medium48 GiB$0,280~890 h
Large816 GiB$0,560~445 h
XL1632 GiB$1,118~225 h

Qué cuenta: cómputo desde start hasta stop. Setup, idle y reintentos también cuentan. Volúmenes, egress e imágenes públicas son gratis. Las APIs de modelos y las suscripciones de agentes van por tu cuenta.

Regla de oro

Un sandbox parado no consume cómputo. Si vas a almorzar, a dormir o a jugar una partida: sbx --cloud stop <nombre>. El estado se conserva y lo retomas con attach.


📦 Instalación

El comando que circula está roto

curl -fsSL https://get.docker.com/sbx | sh devuelve 403 Access Denied. No es el instalador oficial. Usa los comandos de abajo.

macOS

brew trust docker/tap
brew install docker/tap/sbx

Windows 11

winget install -h Docker.sbx

Para sandboxes locales hace falta Windows Hypervisor Platform; para cloud no.

Ubuntu 24.04+

# Opción A: Docker Engine + sbx
curl -fsSL https://get.docker.com | sudo SBX=1 sh
 
# Opción B: solo sbx (sin Docker Engine)
curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
sudo apt install docker-sbx

Linux Mint no está soportado oficialmente

Docker solo prueba Ubuntu 24.04+. En derivados como Mint, el script de conveniencia puede configurar un repositorio incorrecto. Si estás en Mint, las vías más limpias son:

  1. Usar los artefactos de release de docker/sbx-releases.
  2. Instalar en una Ubuntu 24.04 (VM o equipo aparte).
  3. Asumir el riesgo con el repo de Ubuntu, sabiendo que puede romperse en la siguiente actualización.

Login y diagnóstico

sbx login
sbx --cloud diagnose

diagnose comprueba CLI, sesión de Docker, conectividad con la API y acceso de la cuenta. Si dice que no tienes acceso, revisa la suscripción de Agentic Platform.

Credenciales para el agente

Los secretos locales no sirven en cloud. Configura el del agente que vayas a usar:

# Claude Code
sbx --cloud secret set anthropic
 
# OpenAI / Codex
sbx --cloud secret set openai

🛠️ Comandos clave

Qué quieresComando
Crear y entrarsbx --cloud run claude --name ryukami-dev
Crear sin entrarsbx --cloud create --name ryukami-dev --cpus 2 --memory 4g --ttl 2h --on-timeout stop claude
Entrar a uno existentesbx --cloud attach ryukami-dev
Ejecutar un comandosbx --cloud exec ryukami-dev pwd
Subir códigosbx --cloud cp ./mi-proyecto ryukami-dev:/home/agent/workspace/mi-proyecto
Bajar un archivosbx --cloud cp ryukami-dev:/home/agent/workspace/result.json ./result.json
Publicar un puertosbx --cloud ports ryukami-dev --publish 4321
Quitar el puertosbx --cloud ports ryukami-dev --unpublish 4321
Listarsbx --cloud ls
Inspeccionarsbx --cloud inspect ryukami-dev
Ver/extender TTLsbx --cloud ttl ryukami-dev · sbx --cloud ttl +30m ryukami-dev
Pararsbx --cloud stop ryukami-dev
Borrarsbx --cloud rm ryukami-dev
Dashboard TUIsbx tui

Flujo mínimo para un proyecto Astro

# 1. Crear la VM cloud y entrar
sbx --cloud run claude --name ryukami-dev
 
# 2. Desde otra terminal: subir el proyecto
sbx --cloud cp ./mi-proyecto ryukami-dev:/home/agent/workspace/mi-proyecto
 
# 3. Ejecutar comandos dentro
sbx --cloud exec ryukami-dev bash -lc 'cd /home/agent/workspace/mi-proyecto && pnpm install && pnpm build'
 
# 4. Publicar el dev server
sbx --cloud ports ryukami-dev --publish 4321
 
# 5. Al terminar, parar (no borrar)
sbx --cloud stop ryukami-dev

Atajos que importan

  • Ctrl+\ — detach de la sesión del agente sin matarlo.
  • sbx --cloud attach <nombre> — volver a la sesión.
  • sbx tui — ver sandboxes locales y cloud en un dashboard.
  • sbx --cloud ls — confirmar que dice stopped antes de cerrar el portátil.

⏱️ TTL y control de costes

El TTL por defecto es 1 hora. Al expirar, el servicio para los sandboxes que se pueden reanudar y borra el resto. Por eso conviene decidir la acción al crearlo:

sbx --cloud create --name ryukami-dev --ttl 2h --on-timeout stop claude
AcciónQué hace
stopConserva el sandbox para reanudarlo
restartLo para y lo arranca de inmediato (TTL mínimo 1 h)
deleteLo borra; irreversible

Límites: el TTL se puede extender, pero no más de 24 horas desde la creación. --ttl 0 es un error, no desactiva la expiración. Un sandbox parado no tiene TTL corriendo; al reanudarlo empieza una ventana nueva.

No confíes en un tope automático

El crédito se agota y luego se cobra a la tarjeta. Revisa el panel de facturación, pon un recordatorio y para los sandboxes que no uses. Un agente «pensando» en idle sí consume.


🔐 El correo de Pomelo y el OTP (lo que sí es normal)

El código OTP no se guarda aquí

Nunca guardes un OTP, CVV, clave o token en la bóveda. El código que recibiste ya cumplió su función; si alguien te lo pide por chat, correo o teléfono, es una señal de fraude.

Por qué el correo puede venir de noreply@pomelo.la:

  • Pomelo es una empresa de infraestructura financiera de LatAm. Emite tarjetas Visa para Lemon en Perú mediante BIN Sponsorship, además de procesar pagos y gestionar fraude.
  • El 3D Secure (3DS) es el protocolo que pide un código extra al vincular una tarjeta. Es normal que el OTP llegue por email o SMS.
  • Pero el remitente no prueba legitimidad. Un correo puede falsificarse. Verifica siempre:
    1. Que el cobro o la vinculación aparezca en la app de Lemon.
    2. Que la acción la hayas iniciado tú en Docker.
    3. Que el dominio y el flujo coincidan con lo que ves en la app.

Si algo no cuadra: pausa la tarjeta en Lemon (Tarjeta → icono de pausa), revisa movimientos y contacta a soporte. Pausar evita cargos nuevos, pero no cancela la suscripción de Docker; si Docker no puede cobrar, el cloud puede quedar suspendido. Úsalo como freno de emergencia, no como plan de pago.


⚖️ Cuándo usarlo y cuándo no

SíNo
Agentes que corren horas y no pueden depender de tu laptopTrabajo diario liviano: el sandbox local es gratis
Builds pesados, tests, monorepos grandesNecesitas GPU, USB o display del host
Varios agentes en paralelo, cada uno aisladoQuieres montar tu carpeta local directamente en cloud
Probar un agente sin instalar nada en tu máquinaProducción persistente: el TTL y el coste no están pensados para eso
Dar un entorno desechable a código no confiableBuscas un free tier permanente

Alternativas para comparar: 🧊 CreateOS (500 créditos, enfoque enterprise), 📦 InstaBox (plan Free real) y 📦 Upstash Box (serverless).


🐉 Mi lectura

Los $250 son reales, pero no son una estrategia

La promo existe y el crédito sirve para validar lo que de verdad importa: un agente trabajando en la nube mientras cierras el portátil. Con $250 tienes ~1.785 horas de una VM Small o ~890 de una Medium; suficiente para medir cuánto tarda y cuánto cuesta un flujo real.

Lo que no compraría: la idea de que «4 soles desbloquean $250 y ya está». El crédito caduca en 6 meses, la tarjeta queda vinculada y el consumo extra se cobra. Si tu tarjeta no puede cubrirlo, el cloud se bloquea. Úsalo como presupuesto de laboratorio, no como infraestructura gratuita.

Mi flujo: sbx local para el día a día (gratis), --cloud solo para builds largos o agentes en paralelo, --ttl corto y stop al terminar. Y antes de cerrar: sbx --cloud ls debe decir stopped.


🔗 Enlaces