Como funcionam os volumes de sandbox
Um volume é um disco de 1 a 1.000 GiB em um dos nossos servidores, uma imagem ext4 esparsa fora de todo sandbox. Você cria um com create_volume e o monta ao criar um sandbox, em um caminho absoluto como /data. Um sandbox monta até 4 volumes e roda no servidor que os guarda.
Um sandbox monta um volume para leitura e escrita, ou qualquer número de sandboxes o monta só para leitura, nunca as duas coisas ao mesmo tempo. Um sandbox mantém a montagem até ser excluído: pausá-lo ou pará-lo mantém a montagem. Então, para passar um volume do sandbox que o encheu para os leitores, exclua o que escreve e depois crie os leitores com montagens só leitura. Um fork de um sandbox que monta volumes só para leitura também os monta.
Quando um sandbox é excluído, o volume fica com os arquivos, e o próximo sandbox que o montar os encontra como foram deixados. Cada volume informa os bytes que usa e os sandboxes que o montam, e excluí-lo é recusado enquanto um sandbox o monta. O guia de volumes tem todas as chamadas e campos.
from pethost.sandboxes import Mount, Sandboxes
sandboxes = Sandboxes() # lê o 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) # o volume fica
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 # o volume fica
pethost sandbox new --mount "$vol:/data:ro" # um leitorO que saber antes de depender de um volume
Um volume vive no disco de um servidor e não é copiado para nenhum outro lugar. Se esse servidor se perder, o volume se perde com ele, e os sandboxes que o montavam também o perdem. Guarde em outro lugar uma cópia de tudo o que você não pode perder. Já o disco próprio de um sandbox é copiado para o armazenamento de objetos um minuto depois que o sandbox para.
Um volume também prende os sandboxes ao servidor dele. Um sandbox parado que monta um só inicia de novo ali, enquanto um sandbox sem volumes pode iniciar em outro servidor com espaço. Um fork é recusado enquanto o sandbox monta um volume para leitura e escrita. Um volume ainda não pode ser redimensionado nem montado em um sandbox rodando, e um maior que metade do disco de um servidor é recusado. Se o sandbox que escrevia terminou sem desmontá-lo, porque travou ou foi excluído enquanto pausado, monte o volume para leitura e escrita uma vez, o que reproduz o journal dele, antes de qualquer montagem só leitura.
Um volume não acrescenta velocidade de disco. Os volumes de um sandbox dividem a taxa de disco do tamanho dele com o próprio disco: 64 MiB/s e 1.500 operações por segundo por vCPU, ou seja, 128 MiB/s e 3.000 para um SMALL.
Quanto custa um volume
Um volume é cobrado pelo tamanho inteiro, usado ou não, a US$ 0,20 por GiB ao mês, contado por segundo. Seu plano limita os GiB que os seus volumes guardam juntos:
| Plano | Volumes, todos juntos |
|---|---|
| O teste grátis | 10 GiB |
| US$ 20 por mês | 100 GiB |
| US$ 100 por mês | 600 GiB |
| US$ 500 por mês | 3.500 GiB |
| US$ 2.000 por mês | 16.000 GiB |
Para arquivos que pertencem a um sandbox, o disco próprio dele custa menos: um sandbox parado paga US$ 0,03 por GiB ao mês dos dados que guarda, e um template leva arquivos para novos sandboxes sem custo, dentro do espaço de templates do seu plano. Um fork copia o disco próprio de um sandbox junto com a memória; um volume nunca é copiado.
Como se compara
Volumes custam mais no Pethost do que nos fornecedores que lemos em 21 de novembro de 2026. O Modal cobrava US$ 0,09 por GiB ao mês, o Blaxel US$ 0,12 por GB, e o Daytona incluía volumes sem custo, até 100 por organização; os volumes do E2B estavam em beta privado. Use um volume onde vários sandboxes leem os mesmos dados, ou onde os dados precisam durar mais que o sandbox que os criou; mantenha o resto no disco próprio de um sandbox.