Modal logo
Introduction Functions Functions Invocation methods Function lookups Container lifecycle management Parametrized Functions Dynamic configuration Sandboxes Sandboxes Running commands Networking and security File access Snapshots Pricing and resources VM Sandboxes BetaSidecars AlphaEndpoints Endpoints Shared Endpoints Dedicated Endpoints Endpoint integrations Images Defining Images Using existing container images Named images Fast pull from registry GPUs and other resources GPU acceleration Using CUDA on Modal Configuring CPU, memory, and disk Scaling out Scaling out Input concurrency Batch processing Job queues Dynamic batching Multi-node clusters BetaDeployment Apps, Functions, and entrypoints Managing deployments Continuous deployment Scheduled Functions HTTP Applications Servers Web Functions Streaming endpoints Web Function URLs Request timeouts Proxy Tokens Networking Tunnels Proxies BetaCluster networking Data sharing and storage Passing local data Volumes Storing model weights Cloud bucket mounts Dicts Queues Dataset ingestion Secrets and environment variables Secrets Environment variables Performance Cold start performance Memory Snapshots High-performance LLM inference Reliability and robustness Failures and retries Preemption Timeouts GPU health Troubleshooting Security and privacy Security and privacy Data residency Customer-supplied encryption keys AlphaAudit logs Integrations Using OIDC to authenticate with external services Connecting Modal to your Datadog account Connecting Modal to your OpenTelemetry provider Okta SSO Microsoft Entra SSO Custom SAML SSO SCIM Integration BetaSlack notifications BetaWorkspace & account settings Workspaces Environments Modal user account setup Service users User groups BetaRole-Based Access Control (RBAC) Billing Network egress billing Budgets Other topics Feature maturity Notebooks Restricted Functions JavaScript/Go SDKs BetaModal 1.0 migration guide File and project structure Developing and debugging Jupyter notebooks Asynchronous API usage Global variables Region selection GPU Metrics

V2 Sandboxes

“V2” refers to Modal’s next-generation Sandbox backend, which creates Sandboxes with higher throughput, runs more of them concurrently, and gets them interactive faster. It is not a separate API: once it becomes the default, all Sandboxes use it automatically.

Upgrade early 

You can opt in ahead of the cutover by setting the MODAL_SANDBOX_V2=1 environment variable, or sandbox_v2 = true in your .modal.toml profile, with these SDK versions or later:

  • Python 1.5.4
  • JavaScript 0.10.1
  • Go 0.10.1

Sandbox.create(), Sandbox.from_name(), and Sandbox.list() (and their JavaScript and Go equivalents) then use the new backend without any code changes.

Sandboxes that use features the new backend does not support (such as GPUs) are created on the previous backend automatically.

Two things to be aware of when the flag is set:

  • The new backend does not support the deprecated legacy filesystem API (Sandbox.open, ls, mkdir, rm, and watch). Migrate any code that is issuing deprecation warnings before opting in.
  • When Sandbox.create() returns, the Sandbox has already been scheduled onto a machine, so wait_until_ready() completes faster and more consistently.

If you hit a rough edge, please reach out via Slack or email us at support@modal.com.