Sandbox

Represents a Daytona Sandbox instance.

Exposes lifecycle controls and operation facades for process execution, file-system access, and Git.

Properties:

• process Process - Process execution interface for this Sandbox.
• fs FileSystem - File-system operations interface for this Sandbox.
• git Git - Git operations interface for this Sandbox.
• computerUse ComputerUse - Computer use (desktop automation) interface for this Sandbox.
• codeInterpreter CodeInterpreter - Stateful code interpreter for this Sandbox (Python).

Methods

createLspServer()

public LspServer createLspServer(String languageId, String pathToProject)

Creates an LSP server instance for the specified language and project.

Parameters:

• languageId String - language server to start (e.g. “typescript”, “python”, “go”)
• pathToProject String - absolute path to the project root inside the sandbox

Returns:

• LspServer - a new LspServer configured for the given language

start()

public void start()

Starts this Sandbox with default timeout.

Throws:

• DaytonaException - if the Sandbox fails to start

start()

public void start(long timeoutSeconds)

Starts this Sandbox and waits for readiness.

Parameters:

• timeoutSeconds long - maximum seconds to wait; 0 disables timeout

Throws:

• DaytonaException - if start fails or times out

stop()

public void stop()

Stops this Sandbox with default timeout.

Throws:

• DaytonaException - if the Sandbox fails to stop

stop()

public void stop(long timeoutSeconds)

Stops this Sandbox and waits until fully stopped.

Parameters:

• timeoutSeconds long - maximum seconds to wait; 0 disables timeout

Throws:

• DaytonaException - if stop fails or times out

waitUntilStopped()

public void waitUntilStopped(long timeoutSeconds)

Waits until Sandbox reaches stopped (or destroyed) state.

Parameters:

• timeoutSeconds long - maximum seconds to wait; 0 disables timeout

Throws:

• DaytonaException - if timeout is invalid, state becomes error, or timeout expires

delete()

public void delete()

Deletes this Sandbox with default timeout behavior.

Throws:

• DaytonaException - if deletion fails

delete()

public void delete(long timeoutSeconds)

Deletes this Sandbox.

Parameters:

• timeoutSeconds long - reserved timeout parameter for parity with other SDKs

Throws:

• DaytonaException - if deletion fails

setLabels()

public Map<String, String> setLabels(Map<String, String> labels)

Replaces Sandbox labels.

Parameters:

• labels Map<String, String> - label map to apply

Returns:

• Map\<String, String\> - updated labels

Throws:

• DaytonaException - if label update fails

setAutostopInterval()

public void setAutostopInterval(int minutes)

Sets Sandbox auto-stop interval.

Parameters:

• minutes int - idle minutes before automatic stop

Throws:

• DaytonaException - if the update fails

setAutoArchiveInterval()

public void setAutoArchiveInterval(int minutes)

Sets Sandbox auto-archive interval.

Parameters:

• minutes int - minutes in stopped state before automatic archive

Throws:

• DaytonaException - if the update fails

setAutoDeleteInterval()

public void setAutoDeleteInterval(int minutes)

Sets Sandbox auto-delete interval.

Parameters:

• minutes int - minutes before automatic deletion after stop

Throws:

• DaytonaException - if the update fails

getUserHomeDir()

public String getUserHomeDir()

Returns home directory path for Sandbox user.

Returns:

• String - absolute home directory path

Throws:

• DaytonaException - if the request fails

getWorkDir()

public String getWorkDir()

Returns current working directory path.

Returns:

• String - absolute working directory path

Throws:

• DaytonaException - if the request fails

waitUntilStarted()

public void waitUntilStarted(long timeoutSeconds)

Waits until Sandbox reaches started state.

Parameters:

• timeoutSeconds long - maximum seconds to wait; 0 disables timeout

Throws:

• DaytonaException - if timeout is invalid, state becomes failure, or timeout expires

refreshData()

public void refreshData()

Refreshes local Sandbox fields from latest API state.

Throws:

• DaytonaException - if refresh fails

getId()

public String getId()

Returns Sandbox ID.

Returns:

• String - Sandbox ID

getName()

public String getName()

Returns Sandbox name.

Returns:

• String - Sandbox name

getState()

public String getState()

Returns Sandbox state.

Returns:

• String - lifecycle state

getTarget()

public String getTarget()

Returns target region.

Returns:

• String - target identifier

getUser()

public String getUser()

Returns Sandbox OS user.

Returns:

• String - OS user

getToolboxProxyUrl()

public String getToolboxProxyUrl()

Returns toolbox proxy URL.

Returns:

• String - proxy URL

getCpu()

public int getCpu()

Returns allocated CPU cores.

Returns:

• int - CPU cores

getGpu()

public int getGpu()

Returns allocated GPU units.

Returns:

• int - GPU units

getMemory()

public int getMemory()

Returns allocated memory in GiB.

Returns:

• int - memory in GiB

getDisk()

public int getDisk()

Returns allocated disk in GiB.

Returns:

• int - disk in GiB

getEnv()

public Map<String, String> getEnv()

Returns Sandbox environment variables.

Returns:

• Map\<String, String\> - environment map

getLabels()

public Map<String, String> getLabels()

Returns Sandbox labels.

Returns:

• Map\<String, String\> - labels map

getAutoStopInterval()

public Integer getAutoStopInterval()

Returns auto-stop interval in minutes.

Returns:

• Integer - auto-stop interval

getAutoArchiveInterval()

public Integer getAutoArchiveInterval()

Returns auto-archive interval in minutes.

Returns:

• Integer - auto-archive interval

getAutoDeleteInterval()

public Integer getAutoDeleteInterval()

Returns auto-delete interval in minutes.

Returns:

• Integer - auto-delete interval

getProcess()

public Process getProcess()

Returns process operations facade.

Returns:

• Process - process interface

getFs()

public FileSystem getFs()

Returns file-system operations facade.

Returns:

• FileSystem - file-system interface

getGit()

public Git getGit()

Returns Git operations facade.

Returns:

• Git - Git interface