Quickstart v26.4+

Clone the samples repository

git clone --depth 1 https://github.com/kubling-community/kubling-samples.git
cd kubling-samples/quickstart

Start the stack

docker compose up --wait

The command completes when the In-memory provider is reachable through its gRPC Health RPC and Kubling’s aggregate health endpoint reports UP.

The stack exposes only Kubling’s HTTP port on the host. The provider remains on the internal Compose network.

Open Kubling Studio

Open http://localhost:8282/console . The local Studio login form requires non-empty values even though this VDB has no authentication delegate. Enter quickstart as both username and password. These values are local placeholders, are not external credentials and are not persisted by the sample repository.

Select ProviderQuickstartVDB and expand the provider schema. Its PROJECT, TASK, AUDIT_EVENT and TYPE_SAMPLE tables are imported from the provider’s GetSchema response; their DDL is not duplicated in the VDB.

Query deterministic data

Open SQL Workspace and run:

SELECT id, name, status, active
FROM provider.PROJECT
ORDER BY id;

Expected result:

Run and verify a mutation

The provider starts task-2 with completed = false. Run:

UPDATE provider.TASK
SET completed = true
WHERE id = 'task-2';

The expected update count is 1. Verify the provider-owned change:

SELECT id, title, completed
FROM provider.TASK
WHERE id = 'task-2';

Expected result:

The provider returns to its initial data whenever its container is recreated.

Run the automated verification

With the stack running, execute:

docker compose --profile test run --rm smoke-test

The test checks Studio, verifies both projects, resets task-2, performs the mutation and queries the final provider state. A successful run prints:

Quickstart smoke test passed.

Inspect or stop the stack

Inspect service state or relevant logs with:

docker compose ps
docker compose logs kubling provider

Remove the containers, network and generated descriptor volume with:

docker compose down --volumes