FactorySandbox
HomeGet Started

Quickstart

Configure the Docker CLI to run workloads on FactorySandbox.

1. Create a client token

First, create an account and generate a client token from the dashboard.

  1. Sign up at factorysandbox.ai
  2. Navigate to Client Tokens in your dashboard
  3. Create a token for your agent, terminal, or automation
  4. Copy the token and store it securely

Your token is shown only once. Store it somewhere safe. FactorySandbox cannot recover the plaintext token later.

2. Configure Docker

Export the remote Docker endpoint and your token in the terminal where Docker commands will run:

bash
export DOCKER_HOST=tcp://docker.factorysandbox.ai:2377
export DOCKER_CUSTOM_HEADERS='Authorization=Bearer <your-api-token>'

These variables affect Docker commands in the current shell. Open a new terminal or unset them when you want to use your local Docker daemon again.

3. Run your first sandbox

Use standard Docker commands. FactorySandbox creates an isolated remote sandbox for the workload.

bash
docker run --rm alpine echo hello

Use any base image your workflow needs:

bash
docker run --rm python:3.12 python -V
docker run --rm node:22 node -e 'console.log(process.version)'

4. Inspect and clean up

List running sandboxes, inspect what is active, and remove containers when you are done.

bash
docker ps
docker rm -f <container-id>

Next Steps