This guide is for users that would like to use their own custom Docker image for the runtime. For example, with certain tools or programming languages pre-installed.
python-nodejs:python3.12-nodejs22
from nikolaik/python-nodejs) comes with some packages installed such
as python and Node.js but may need other software installed by default.
You have two options for customization:
Create Your Docker Image
section.
ruby
installed, you could create a Dockerfile
with the following content:
custom-image
, which will be available in Docker.
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=...
with -e SANDBOX_BASE_CONTAINER_IMAGE=<custom image name>
:
config.toml
file within the OpenHands directory, set the base_container_image
to the image you want to use.
This can be an image you’ve already pulled or one you’ve built:
config.toml
file supports several other options for customizing your sandbox:
make run
in the top level directory.