# Configure ParticleDB

Configure data storage, connection addresses, credentials and resource limits using supported server options.

Source: https://particledb.ai/installation/configuration/

## Check the installed options

```bash
particledb start --help
```

Flags vary between distributions. The installed help is the reference for accepted names and values. Avoid copying options from a different release.

## Configuration sources

The server uses built-in defaults, an optional TOML configuration file, and command-line overrides. Command-line settings override the corresponding file settings.

```bash
particledb start --config ./config.toml --data-dir ./pdb-data
```

An explicitly named configuration file must exist. Keep credentials out of files committed to source control.

## Common settings

| Purpose | Setting |
|---|---|
| Persistent records | `--data-dir` |
| HTTP SQL and health address | `--http-addr` |
| SQL client address | `--pg-addr` |
| Redis client address | `--redis-addr` |
| Initial account | `--pg-username` |
| Password file | `--pg-password-file` |
| Authentication | `--auth-method` |
| TLS | `--tls-cert`, `--tls-key` |
| Durability | `--durability` |
| KV durability (Redis-compatible endpoint) | `--kv-durability` |
| Concurrency control | `--concurrency-control` |
| Default session isolation | `--default-isolation` |
| Server memory | `--max-server-memory` |
| Query memory | `--max-statement-memory` |
| Monitoring endpoint | `--metrics-addr` |

## Transactions and persistence

`--concurrency-control` (default `optimistic`), `--durability` (default `groupsync`) and `--kv-durability` (default `async`) are separate settings; changing one does not change the others.

An explicit transaction defaults to READ COMMITTED unless the session or server default changes. Choosing `strict-optimistic` does not change that default. Read [concurrency, isolation and durability](/operations/modes/) before selecting a mode.

## Before changing a setting

Review the relevant [connection](/installation/ports/), [authentication](/connectivity/tls/), [durability](/operations/durability/) or [memory](/operations/memory/) guide. Restart a development instance and verify the result before applying it to production.

## Related

[Documentation home](/docs/) · [Troubleshooting](/guides/troubleshooting/)
