bluemachine_docs

Ephemeral Sandbox Runs

Learn about how ephemeral sandboxes work, their lifecycle, and how to execute isolated tasks.

Ephemeral sandboxes are designed for short-lived, isolated task executions. When you use the machine run command, BlueMachine dynamically provisions a lightweight virtual machine, mirrors your workspace files, runs your command, streams the logs, and then immediately destroys the environment.

Sandbox Lifecycle

Because ephemeral runs destroy the environment as soon as the process completes, any installations or modifications made outside your synced files will be discarded. If you need a persistent environment that keeps its state, please refer to Developer Stations.

To configure runtime details such as libraries, compilers, or specific run configurations, you can configure your Python Environment or install packages inline during your runs.

Example Ephemeral Sandbox Run
# Run a command inside a fresh sandbox VM
machine run "python3 -c 'print(\"Hello from ephemeral sandbox!\")'"
STATUS // BETADOCS.BLUEMACHINE