Skip to main content
Blaxel is a hosted sandbox provider. Roomote creates a sandbox, exposes task ports through Blaxel preview URLs, and starts the task worker as a keep-alive process.

​
When to use Blaxel

Use Blaxel when task work should run outside the Roomote host and you want provider-managed microVMs with automatic standby and fast wake-up.

​
Configuration

Create a key from the Blaxel API keys page, then add Blaxel from Settings > Sandboxes or provide:
You can optionally select a region:
Standby retention can be bounded separately from active task timeouts:
Region and standby retention are also editable under Settings > Sandboxes > Blaxel > Advanced settings. Process environment variables take precedence and appear as locked values in Settings. Roomote’s provisioned Blaxel worker image includes Docker, Docker Compose, and the legacy iptables backend required for Docker projects. Container builds and services share the task sandbox’s memory allocation. Roomote requests 8 GiB for these tasks and 4 GiB for tasks that do not need nested Docker.

​
Verify setup

  1. Save the API key and workspace name.
  2. Select Blaxel as the default sandbox provider.
  3. Start a small task and confirm logs reach the task view.
  4. Start a web app and verify its preview link.

​
Common issues

  • Authentication fails. Confirm the API key belongs to BL_WORKSPACE.
  • A preview has no URL. Confirm the configured workspace can create public sandbox previews and that the requested ports are valid.