Configuration Reference

Indexed stores its configuration in ~/.indexed/config.toml. This page documents every available setting.

Managing Configuration

# Initialize with defaults
indexed config init --yes

# Initialize interactively
indexed config init

# View current config
indexed config inspect
indexed config inspect --json

# Set a value
indexed config set core.v1.indexing.chunk_size 1024

# Preview a change without applying
indexed config set core.v1.indexing.chunk_size 1024 --dry-run

# Remove a value (reset to default)
indexed config delete core.v1.indexing.chunk_overlap

# Validate config file
indexed config validate

Configuration Keys

Indexing

Key	Type	Default	Description
`core.v1.indexing.chunk_size`	int	`512`	Maximum number of tokens per chunk
`core.v1.indexing.chunk_overlap`	int	`50`	Number of overlapping tokens between consecutive chunks

Embedding

Key	Type	Default	Description
`core.v1.embedding.model_name`	string	`"all-MiniLM-L6-v2"`	Sentence Transformers model to use for embeddings

Environment Variable Overrides

Any configuration key can be overridden with an environment variable using the pattern:

INDEXED__<section>__<subsection>__<key>=<value>

Double underscores (__) separate each level of the config hierarchy.

Examples:

export INDEXED__core__v1__indexing__chunk_size=1024
export INDEXED__core__v1__indexing__chunk_overlap=100
export INDEXED__core__v1__embedding__model_name="all-MiniLM-L6-v2"

Environment variables take precedence over values in config.toml.

Connector Credentials

Connector credentials are read from environment variables (or a .env file):

Variable	Used by	Description
`JIRA_API_TOKEN`	Jira connector	API token (Cloud) or personal access token (Server/DC)
`JIRA_EMAIL`	Jira Cloud connector	Email address of the Atlassian account
`CONFLUENCE_API_TOKEN`	Confluence connector	API token (Cloud) or personal access token (Server/DC)
`CONFLUENCE_EMAIL`	Confluence Cloud connector	Email address of the Atlassian account

Keep secrets out of version control

Store credentials in a .env file and add it to .gitignore. Never put tokens in config.toml.

Example Config File

~/.indexed/config.toml

[core.v1.indexing]
chunk_size = 512
chunk_overlap = 50

[core.v1.embedding]
model_name = "all-MiniLM-L6-v2"

Data Directory

All Indexed data is stored at ~/.indexed/:

~/.indexed/
├── config.toml
└── data/
    └── collections/<name>/
        ├── manifest.json
        ├── documents.json
        ├── chunks.json
        └── index.faiss

See Privacy & Data Storage for details on what each file contains.

Configuration Reference

On this page