CONFIGURATION

Route workbench

Set a path, status, content type, and body, then download routes.json.

Runs entirely in your browser. This generates configuration; it does not run a Tez server or send requests.

START WITH

01 / Define the response

GET + HEAD

Route path

Use a path such as /hello or /fixtures/profile.

Status

Content type

Response body 11 bytes

The exact body returned for GET. HEAD returns headers only.

Ready to export.

02 / Export configuration

routes.json

CONFIGURATION

{
  "/hello": {
    "status": "200 OK",
    "content_type": "text/plain; charset=utf-8",
    "body": "hello, Tez\n"
  }
}

REQUEST IT LOCALLY

curl --include 'http://127.0.0.1:8080/hello'

03 / RUN LOCALLY

Use your configuration

Put your downloaded routes.json in your working directory. Choose Docker, or build Tez with the source guide.

Stop any previous server using port 8080. Run your curl command in a second terminal. Stop Tez with Ctrl-C; restart after editing routes.

DOCKER COMMAND

docker run --rm --pull=always --name tez-fixture \
  --read-only --cap-drop=ALL --security-opt=no-new-privileges \
  -p 127.0.0.1:8080:8080 \
  --mount "type=bind,src=$(pwd)/routes.json,dst=/app/config.json,readonly" \
  ramogh2404/tez:main

The file must be readable by container user 10001. Container reference ↗