Cómo funcionan los volúmenes de los sandboxes
Un volumen es un disco de 1 a 1000 GiB en uno de nuestros servidores, una imagen ext4 dispersa fuera de todo sandbox. Lo creas con create_volume y lo montas al crear un sandbox, en un path absoluto como /data. Un sandbox monta hasta 4 volúmenes, y se ejecuta en el servidor que los tiene.
Un sandbox monta un volumen de lectura y escritura, o cualquier número de sandboxes lo montan de solo lectura, nunca las dos cosas a la vez. Un sandbox conserva su montaje hasta que se elimina: pausarlo o detenerlo conserva el montaje. Así que, para pasar un volumen del sandbox que lo llenó a los que lo leen, elimina el que escribe y crea los lectores con montajes de solo lectura. Un fork de un sandbox que monta volúmenes de solo lectura también los monta.
Cuando se elimina un sandbox, el volumen se queda con sus archivos, y el siguiente sandbox que lo monta los encuentra como se dejaron. Cada volumen informa de los bytes que usa y de los sandboxes que lo montan, y eliminarlo se rechaza mientras un sandbox lo monta. La guía de volúmenes tiene cada llamada y cada campo.
from pethost.sandboxes import Mount, Sandboxes
sandboxes = Sandboxes() # lee PETHOST_TOKEN
volume = sandboxes.create_volume("datasets", size_gib=50)
writer = sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data")])
sandboxes.run_command(writer.sandbox_id, command="seq 1 1000000 > /data/numbers.txt")
sandboxes.delete_sandbox(writer.sandbox_id) # el volumen se queda
readers = [
sandboxes.create_sandbox(mounts=[Mount(volume_id=volume.volume_id, path="/data", read_only=True)])
for _ in range(3)
]
print(sandboxes.run_command(readers[0].sandbox_id, command="wc -l /data/numbers.txt").stdout)
# 1000000 /data/numbers.txtvol=$(pethost sandbox volume new datasets --size 50)
pethost sandbox new --name writer --mount "$vol:/data"
pethost sandbox run writer -- 'seq 1 1000000 > /data/numbers.txt'
pethost sandbox rm writer -y # el volumen se queda
pethost sandbox new --mount "$vol:/data:ro" # uno que leeQué saber antes de confiar en un volumen
Un volumen vive en el disco de un servidor y no se copia a ningún otro sitio. Si ese servidor se pierde, el volumen se pierde con él, y los sandboxes que lo montaban también lo pierden. Guarda en otro lugar una copia de todo lo que no puedas perder. El propio disco de un sandbox, en cambio, se copia al almacenamiento de objetos un minuto después de que el sandbox se detiene.
Un volumen también ata sus sandboxes a su servidor. Un sandbox detenido que monta uno solo vuelve a iniciarse allí, mientras que un sandbox sin volúmenes puede iniciarse en otro servidor con espacio. Un fork se rechaza mientras el sandbox monta un volumen de lectura y escritura. Un volumen aún no puede cambiar de tamaño ni montarse en un sandbox en ejecución, y uno mayor que la mitad del disco de un servidor se rechaza. Si el que escribía terminó sin desmontarlo, porque falló o se eliminó estando en pausa, monta el volumen de lectura y escritura una vez, lo que reproduce su journal, antes de cualquier montaje de solo lectura.
Un volumen no agrega velocidad de disco. Los volúmenes de un sandbox comparten con su propio disco la velocidad de disco de su tamaño: 64 MiB/s y 1500 operaciones por segundo por vCPU, es decir, 128 MiB/s y 3000 para un SMALL.
Cuánto cuesta un volumen
Un volumen se factura por su tamaño entero, se use o no, a 0,20 US$ por GiB al mes, contado por segundo. Tu plan limita los GiB que tus volúmenes ocupan en total:
| Plan | Volúmenes, en total |
|---|---|
| La prueba gratis | 10 GiB |
| 20 US$ al mes | 100 GiB |
| 100 US$ al mes | 600 GiB |
| 500 US$ al mes | 3500 GiB |
| 2000 US$ al mes | 16.000 GiB |
Para archivos que pertenecen a un sandbox, su propio disco cuesta menos: un sandbox detenido paga 0,03 US$ por GiB al mes de los datos que guarda, y una plantilla lleva archivos a sandboxes nuevos gratis dentro del espacio para plantillas de tu plan. Un fork copia el propio disco de un sandbox junto con su memoria; un volumen nunca se copia.
Cómo se compara
Los volúmenes cuestan más en Pethost que en los proveedores que leímos el 21 de noviembre de 2026. Modal cobraba 0,09 US$ por GiB al mes, Blaxel 0,12 US$ por GB, y Daytona incluía volúmenes gratis, hasta 100 por organización; los volúmenes de E2B estaban en beta privada. Usa un volumen donde varios sandboxes leen los mismos datos, o donde los datos deben sobrevivir al sandbox que los creó; guarda lo demás en el propio disco de un sandbox.