github.com/nalgeon/codapi

Dropped the DOCKER environment variable introduced in 0.13.1 in favor of the docker.bin config option in codapi.json. Having a single configuration source is strictly better.

Example:

{
    "pool_size": 8,
    "verbose": true,
    "docker": {
        "bin": "nerdctl"
    }
}

Also: updated Go version to 1.24.

You can now override the default docker executable name with the DOCKER environment variable (#36, courtesy of @afbjorklund).

Added a health endpoint to check if the server is up:

HEAD /v1/health

You can now create nested directories when running a command in a sandbox.

Before, this request gave an error because the data directory didn't exist:

POST /v1/exec

{
    "sandbox": "ash",
    "command": "run",
    "files": {
        "": "cat data/hello.txt",
        "data/hello.txt": "hello world!"
    }
}

Now this request creates the data directory before writing hello.txt, and the command works just fine:

{
    "id": "ash_run_86408aef",
    "ok": true,
    "duration": 542,
    "stdout": "hello world!",
    "stderr": ""
}

Codapi is a lightweight sandbox server for interactive documentation and learning. This release lets you run a source file in a sandbox directly from your terminal:

Usage: ./codapi-cli exec <sandbox> <command> <filename>

For example:

./codapi-cli exec ash run hello.sh
Hello, world!

This is especially helpful when debugging new sandboxes.

Codapi is a lightweight sandbox server for interactive documentation and learning. This release introduces a command line interface — codapi-cli. It makes managing sandboxes much easier:

Usage: ./codapi-cli <command> [args...]

commands:
  sandbox add     Add a new sandbox
  sandbox rm      Remove an existing sandbox
  sandbox ls      List all sandboxes

See the sandboxes repository for a complete list of supported sandboxes.

New sandbox layout

Previously, Codapi had its stuff organized into three folders: "images", "boxes", and "commands":

├── configs
│   ├── config.json
│   ├── boxes
│   │   ├── bash.json
│   │   └── python.json
│   └── commands
│       ├── bash.json
│       └── python.json
└── images
    ├── bash
    │   └── Dockerfile
    └── python
        └── Dockerfile

Now each sandbox gets its own subfolder inside the "sandboxes" folder:

├── codapi.json
└── sandboxes
    ├── bash
    │   ├── Dockerfile
    │   ├── box.json
    │   └── commands.json
    └── python
        ├── Dockerfile
        ├── box.json
        └── commands.json

All sandbox-related files live in a single folder, making it easier to create, edit, and distribute sandboxes.

Also, the main configuration file (previously configs/config.json) is now called codapi.json and resides next to the codapi binary.

The old layout is still supported for backward compatibility, but will be removed in future releases.