> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alginte.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Point Alginte at your brokers and the surrounding Confluent services.

Alginte is configured with standard Spring properties. Every value can be set three ways,
in ascending precedence:

1. an `application.properties` file (mounted with `--spring.config.additional-location=`),
2. a command-line flag (`--alginte.ksqldb.url=…`),
3. an **environment variable** (wins over the others — handy for containers).

> [!NOTE]
>
> **Env-var naming (relaxed binding).** Uppercase the property, replace `.` with `_`, and
> remove dashes: `alginte.connect.url` → `ALGINTE_CONNECT_URL`,
> `alginte.schema-registry.url` → `ALGINTE_SCHEMAREGISTRY_URL`.

## Core connectivity

The rule: a **`.url` property is always a full URL** (scheme, host, port). Leave it empty
and that area is disabled — Alginte runs degraded-but-running.

| Property | Env var | Purpose |
| - | - | - |
| `spring.kafka.bootstrap-servers` | `SPRING_KAFKA_BOOTSTRAPSERVERS` | Broker bootstrap list (required), standard `host:port` form. |
| `alginte.schema-registry.url` | `ALGINTE_SCHEMAREGISTRY_URL` | Schema Registry URL, e.g. `http://schema-registry:8081/`. Optional `alginte.schema-registry.username` / `.password` for basic auth. |
| `alginte.connect.url` | `ALGINTE_CONNECT_URL` | Kafka Connect URL, e.g. `http://connect:8083/`. |
| `alginte.ksqldb.url` | `ALGINTE_KSQLDB_URL` | ksqlDB URL, e.g. `http://ksqldb-server:8088`. |

## Server & networking

| Property | Env var | Purpose |
| - | - | - |
| `server.address` | `SERVER_ADDRESS` | Bind address. Defaults to `localhost`; set `0.0.0.0` to serve a network — see [Run with the JAR](https://docs.alginte.com/installation/jar.md). |
| `alginte.startup-connectivity-check.enabled` | `ALGINTE_STARTUPCONNECTIVITYCHECK_ENABLED` | Fail-fast broker check on boot. `false` to start before the broker is up. |

## Streams observation

> [!NOTE]
>
> Available from Alginte 0.11.0.

| Property | Env var | Purpose |
| - | - | - |
| `alginte.instance-id` | `ALGINTE_INSTANCEID` | This instance's name on every observation it produces (the [State tab](https://docs.alginte.com/streams/monitoring.md#the-state-tab)'s Observer card). Defaults to the host name. |
| `alginte.runtime.tokens` | `ALGINTE_RUNTIME_TOKENS` | Comma-separated bearer tokens accepted on `POST /api/runtime/v1/observations`, where a runtime can push a stream's observations to this console. With none listed every push answers 401 and the endpoint is effectively off. |
| `alginte.runtime.stale-after-seconds` | `ALGINTE_RUNTIME_STALEAFTERSECONDS` | How old a pushed snapshot may be before the console marks it stale (default `60`). A runtime that stopped pushing is shown as stale, never as current. |
| `alginte.runtime.max-pushes-per-second` | `ALGINTE_RUNTIME_MAXPUSHESPERSECOND` | Pushes one token may make per second (default `100`); past it the console answers `429` with `Retry-After: 1`. The reporter pushes once every ten seconds per instance, so the default leaves room for a thousand instances on one token. `0` switches the limit off. |
| `alginte.runtime.max-snapshots-per-push` | `ALGINTE_RUNTIME_MAXSNAPSHOTSPERPUSH` | Snapshots one push may carry (default `100`); past it `413`. `0` switches the limit off. |
| `alginte.runtime.max-events-per-push` | `ALGINTE_RUNTIME_MAXEVENTSPERPUSH` | Events one push may carry (default `1000`); past it `413`, and the pusher sends the rest in its next push. `0` switches the limit off. |
| `alginte.runtime.max-applications-per-token` | `ALGINTE_RUNTIME_MAXAPPLICATIONSPERTOKEN` | Distinct application ids one token may report (default `100`), remembered while the console runs; a push that would take a token past it answers `429` naming the new ids, while the applications it already reports still land. `0` switches the limit off. |

## Sandbox mode

> [!NOTE]
>
> Available from Alginte 0.13.0.

| Property | Env var | Purpose |
| - | - | - |
| `alginte.sandbox.enabled` | `ALGINTE_SANDBOX_ENABLED` | This instance runs against an isolated stack that is nobody's shared cluster; the [playground](https://docs.alginte.com/installation/playground.md) sets it. Switches on the MCP [stream tools](https://docs.alginte.com/operate/mcp.md#sandbox-mode-the-stream-tools) that validate, deploy, stop and delete designs. Default `false`; never set it on an instance against a shared cluster. |

## Enrich services

> [!NOTE]
>
> Available from Alginte 0.14.0.

The services an [Enrich from a service](https://docs.alginte.com/streams/enrich.md) node may call, one group per service,
named by what follows `alginte.services.`; a design refers to the service by that name. As
environment variables the name sits in the middle and is lowercased:
`alginte.services.jev.base-url` → `ALGINTE_SERVICES_JEV_BASEURL`. Each declaration is checked when
Alginte starts, and one that could never be called stops the start.

| Property | Env var | Purpose |
| - | - | - |
| `alginte.services.<name>.kind` | `ALGINTE_SERVICES_<NAME>_KIND` | The kind of service; `http-json` is the only one so far. Required. |
| `alginte.services.<name>.base-url` | `ALGINTE_SERVICES_<NAME>_BASEURL` | The service's absolute `http` or `https` address; a node's path suffix is appended to it. Required. |
| `alginte.services.<name>.auth-scheme` | `ALGINTE_SERVICES_<NAME>_AUTHSCHEME` | The `Authorization` scheme, for example `Bearer`. Empty sends no `Authorization` header. |
| `alginte.services.<name>.auth-value-env` | `ALGINTE_SERVICES_<NAME>_AUTHVALUEENV` | The **name** of the environment variable that holds the credential, read when a call is made. The credential itself is never a property. |
| `alginte.services.<name>.timeout` | `ALGINTE_SERVICES_<NAME>_TIMEOUT` | The whole budget for one record, retries included (default `2s`). A node may set its own. |
| `alginte.services.<name>.retry-statuses` | `ALGINTE_SERVICES_<NAME>_RETRYSTATUSES` | Comma-separated HTTP statuses retried with backoff inside the timeout (default `429,500,502,503,504`); any other status fails at once. |
| `alginte.services.<name>.modifies-data` | `ALGINTE_SERVICES_<NAME>_MODIFIESDATA` | Whether a call changes data at the service (default `false`). Submit refuses every node naming a service set to `true`: a stream repeats calls after an error or a restart. |
| `alginte.services.<name>.answer-example` | `ALGINTE_SERVICES_<NAME>_ANSWEREXAMPLE` | One raw answer in the service's shape, as JSON. A node choosing the service takes it as its simulated answer. |

## Profiles

Set `SPRING_PROFILES_ACTIVE` to activate a profile (for example a `local` profile that
turns on DEBUG logging and dev defaults). Environment variables still override any value
a profile supplies.

## Related

> [card] [Authentication](https://docs.alginte.com/operate/authentication.md)
>
> Username/password and OIDC login.

> [card] [Update notifications](https://docs.alginte.com/operate/updates.md)
>
> Opt into the "new version available" check.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.