crudjt/crudjt-server repository overview

Persistent, revocable tokens for distributed systems

⁠CRUDJT Server Docker Image

CRUDJT is a high-performance, B-tree backed token engine that provides durable, stateful session management across distributed environments.

It stores authentication and authorization state on disk with predictable resource usage and low-latency access, making it suitable for long-lived sessions, microservices, and multi-node deployments.

This Docker image runs the CRUDJT runtime server and is intended to be used together with the official CRUDJT SDKs⁠

⁠🚀 Quick Start

The recommended way to run CRUDJT Server is via Docker Compose:

Create a docker-compose.yml

nano docker-compose.yml

Paste the following into docker-compose.yml

services:
  crudjt-server:
    image: crudjt/crudjt-server:latest
    restart: unless-stopped

    ports:
      - "${CRUDJT_CLIENT_PORT:-50051}:50051"

    volumes:
      - "${STORE_JT:-./store_jt}:/app/store_jt"
      - "${CRUDJT_SECRETS:-./crudjt_secrets}:/app/secrets"

    environment:
      CRUDJT_DOCKER_HOST: 0.0.0.0
      CRUDJT_DOCKER_PORT: 50051

Run server:

docker-compose up -d

The server will be available on localhost:50051 Ensure the secrets directory contains your secret key file at ./crudjt_secrets/secret_key.txt

⁠🔌 Official SDKs

CRUDJT Server is compatible with all official SDKs:

For usage examples, see the README of each SDK repository

⁠🧪 CI / Testing Example

You can run the server as a service dependency in CI pipelines:

services:
  crudjt-server:
    image: crudjt/crudjt-server:latest

    ports:
      - "${CRUDJT_CLIENT_PORT:-50051}:50051"

    environment:
      CRUDJT_DOCKER_HOST: 0.0.0.0
      CRUDJT_DOCKER_PORT: 50051

Or directly with docker run:

docker run -d \
  -p 50051:50051 \
  -e CRUDJT_DOCKER_HOST=0.0.0.0 \
  -e CRUDJT_DOCKER_PORT=50051 \
  crudjt/crudjt-server:latest

⁠🏷 Version Compatibility

All official SDKs are compatible with the server 1.x line. SDKs follow independent semantic versioning