<div id="readability-page-1" class="page"><div>We’ve released E2B Build System 2.0 — a faster and simpler way to create custom sandboxes in E2B.
With the new system you don’t need Dockerfiles, extra config files, or manual CLI build commands. You just write code. The build step still exists, but it runs automatically when you execute your template.
<figure></figure>
<h2 id="why-we-rebuilt-it">Why we rebuilt it</h2>
The old build system was functional, but:
<ul>
<li>Required juggling config files, Dockerfiles, and CLI commands.</li>
<li>Builds were slow, mostly local, and debugging was painful.</li>
<li>Hard to expose or extend build logic for your own users.</li>
</ul>
Build System 2.0 addresses these problems head-on.
<h2 id="whats-new">What’s new</h2>
<h3 id="1-better-developer-experience">1. Better Developer Experience</h3>
<ul>
<li>Before: e2b template build + config + Dockerfile</li>
<li>Now:&nbsp;Just run your code → the template builds automatically/</li>
</ul>
What previously took a config file, a Docker file, and running a terminal command is now just running a script with a few lines of code. This enables type hints, linters, dynamic builds inside apps, and exposing build logic directly to users.
Javascript:&nbsp;
<figure><div><pre tabindex="0"><code>Template()
 .fromImage("node:24")
 .copy("src/", ".")
 .runCmd("npm install")</code></pre></div></figure>
Python:
<figure><div><pre tabindex="0"><code>Template()
 .from_image("node:24")
 .copy("src/", ".")
 .run_cmd("npm install")</code></pre></div></figure>
<h3 id="2-agentic-experience">2. Agentic Experience</h3>
Templates are now expressed as code, so AI IDEs and agents like Cursor or Claude Codecan parse, suggest, and generate them without extra config. This makes it straightforward to plug the build system into an LLM as a tool. This makes it straightforward to plug the build system into an LLM as a tool.
<h3 id="3-speed">3. Speed</h3>
<ul>
<li>Intelligent caching</li>
<li>Parallel uploads</li>
<li>Server-side optimizations</li>
</ul>
Builds are up to 14× faster when cached, and ~2× faster without cache. They now run on E2B infra — making the feedback loops shorter, performance more stable, and have clearer error messages. They now run on E2B infra — making the feedback loops shorter, performance more stable, and have clearer error messages.
<h3 id="4-painless-migration">4. Painless Migration</h3>
We kept backwards compatibility and added multiple migration paths:
<ol>
<li><code>e2b template migrate</code> (CLI)<code>‍</code></li>
<li><code>Template().fromDockerfile()/Template(path).from_dockerfile(path)</code> → parses your Dockerfile<code>‍</code></li>
<li><code>fromImage(tag)/from_image(tag)</code> → continue building from an existing base image</li>
</ol>
<h2 id="helper-methods">Helper Methods</h2>
The API now includes helpers for common tasks such as:
JavaScript
<figure><div><pre tabindex="0"><code>Template()
 .fromUbuntu("24.04")
 .pipInstall(["numpy", "pandas"])
 .aptInstall(["curl", "wget"])
 .gitClone("https://github.com/user/repo.git", { branch: "main" })
 .setEnvs({ DEBUG: "true" })
 .runCmd("npm start")</code></pre></div></figure>
Python
<figure><div><pre tabindex="0"><code>Template()
 .from_ubuntu("24.04")
 .pip_install(["numpy", "pandas"])
 .apt_install(["curl", "wget"])
 .git_clone("https://github.com/user/repo.git", branch="main")
 .set_envs({ DEBUG: "true" })
 .run_cmd("npm start")</code></pre></div></figure>
<h2 id="get-started-with-build-system-20">Get Started with Build System 2.0</h2>
If you’re on the latest E2B SDK, you already have Build System 2.0. Here’s how to try it out:
<h3 id="1-install-or-update-the-sdk">1. Install or update the SDK</h3>
Make sure you’re on the newest version:
JavaScript
<code>npm install e2b@latest</code>
Python
<code>pip install --upgrade e2b</code>
<h3 id="2-create-a-simple-template">2. Create a simple template</h3>
Define your build directly in code:
JavaScript
<figure><div><pre tabindex="0"><code>import { Template, waitForPort } from "e2b"

const template = Template()
 .fromImage("node:24")
 .copy("src/", ".")
 .runCmd("npm install")
 .setStartCmd("npm start", waitForPort(3000))</code></pre></div></figure>
Python
<figure><div><pre tabindex="0"><code>from e2b import Template, wait_for_port

template = (
 Template()
 .from_image("python:3.11")
 .pip_install(["requests", "numpy"])
 .copy("app.py", ".")
 .run_cmd("python app.py", wait_for_port(3000))
)</code></pre></div></figure>
<h3 id="3-build-the-template">3. Build the template</h3>
The build step is automatic — just run code:
JavaScript
<figure><div><pre tabindex="0"><code>await Template.build(template, {
 alias: "my-template",
 onBuildLogs: defaultBuildLogger(),
})</code></pre></div></figure>
Python
<figure><div><pre tabindex="0"><code>Template.build(template, alias="my-template", on_build_logs=default_build_logger())</code></pre></div></figure>
<h3 id="4-run-your-sandbox">4. Run your sandbox</h3>
Once the template is built, launch a sandbox from it:
JavaScript
<figure><div><pre tabindex="0"><code>import { Sandbox } from "e2b"

const sandbox = await Sandbox.create("my-template")
const result = await sandbox.commands.run("echo Hello E2B")
console.log(result.output)</code></pre></div></figure>
Python
<figure><div><pre tabindex="0"><code>from e2b import Sandbox

sandbox = Sandbox.create("my-template")
result = sandbox.commands.run("echo Hello E2B")
print(result.output)</code></pre></div></figure>
<h3 id="5-migrating-existing-templates">5. Migrating existing templates</h3>
If you already have templates built with the old system, you can migrate:
<code>e2b template migrate</code>
Or update your code with:
JavaScript
<code>Template().fromDockerfile("./e2b.Dockerfile")</code>
Python
<code>Template().from_dockerfile("./e2b.Dockerfile").</code>
<h3 id="resources">Resources</h3>
</div></div>

E2B Blog & Customer Stories

Vaclav Mlejnsky

A faster and simpler way to create custom sandboxes in E2B

Introducing Build System 2.0

댓글