> ## 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.ksql-db-host=…`),
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** — do not turn a dash into an underscore. `alginte.kafka-connect-host`
  → `ALGINTE_KAFKACONNECTHOST`. A stray underscore (`ALGINTE_KAFKA_CONNECT_HOST`) binds a
  *different* property and is silently ignored.
</Note>

## Core connectivity

| Property                             | Env var                           | Purpose                           |
| ------------------------------------ | --------------------------------- | --------------------------------- |
| `spring.kafka.bootstrap-servers`     | `SPRING_KAFKA_BOOTSTRAPSERVERS`   | Broker bootstrap list (required). |
| `alginte.kafka-schema-registry-host` | `ALGINTE_KAFKASCHEMAREGISTRYHOST` | Schema Registry base URL.         |
| `alginte.kafka-connect-host`         | `ALGINTE_KAFKACONNECTHOST`        | Kafka Connect base URL.           |
| `alginte.ksql-db-host`               | `ALGINTE_KSQLDBHOST`              | ksqlDB server host.               |

The Confluent components are **optional** — leave a host unset and Alginte runs with that
area disabled (degraded-but-running).

## 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](/installation/jar). |
| `alginte.startup-connectivity-check.enabled` | `ALGINTE_STARTUPCONNECTIVITYCHECK_ENABLED` | Fail-fast broker check on boot. `false` to start before the broker is up.                                            |

## 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

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/operate/authentication">
    Username/password and OIDC login.
  </Card>

  <Card title="Update notifications" icon="bell" href="/operate/updates">
    Opt into the "new version available" check.
  </Card>
</CardGroup>