Running the Server

Starting the Server

Start the HEBBS server with default configuration:

hebbs-server

Default Ports

• gRPC: 6380
• HTTP/REST: 6381

Bootstrap API Key

On first start, HEBBS auto-generates a bootstrap API key and prints it to the console. Save it and export it for the CLI:

export HEBBS_API_KEY="hb_..."

To disable auth for local development: HEBBS_AUTH_ENABLED=false hebbs-server.

Health Check

Verify the server is running:

curl http://localhost:6381/v1/health/ready

Basic Config File

Create a hebbs.toml file to customize server behavior:

[server]
grpc_port = 6380
http_port = 6381