Skip to main content
Konduktor configuration happens at two levels: server-wide (environment variables and files) and per-workspace (via the CLI/UI).

​
Server configuration

​
Environment variables

VariableDefaultPurpose
KONDUKTOR_DIR~/.konduktorData directory for DB, credentials, logs, and workspaces
KONDUKTOR_EXTERNAL_URL(none)Public URL for the UI — used in PR description links (e.g. https://konduktor.example.com)
KONDUKTOR_UI_DIR(auto-detected)Path to the built UI dist/ directory

​
Server startup options

konduktor-server start --host 0.0.0.0 --port 8080
FlagDefaultPurpose
--host127.0.0.1Bind address
--port8080Port

​
Files

PathPurpose
~/.konduktor/credentialsServer auth credentials (bcrypt hashed)
~/.konduktor/konduktor.dbSQLite database
~/.konduktor/server.logServer log (10 MB max, 3 rotated backups)
~/.konduktor/cli.jsonCLI authentication token
~/.konduktor/github-app.jsonGitHub App config
~/.konduktor/github-app.pemGitHub App private key

​
Workspace configuration

​
Auto-fix merge conflicts

When enabled, Konduktor automatically spawns an agent to resolve merge conflicts when they’re detected on a task’s PR branch. 
konduktor config get <workspace>
konduktor config set <workspace> --auto-fix-merge-conflicts true
konduktor config set <workspace> --auto-fix-merge-conflicts false

​
Custom agent prompt

Override the default system prompt that agents receive when running tasks: 
konduktor config get-prompt <workspace>                   # View current prompt
konduktor config set-prompt <workspace> \
  --prompt "Always write tests. Use TypeScript."           # Set custom prompt
konduktor config set-prompt <workspace> \
  --prompt-file my-prompt.md                               # Load from file
konduktor config set-prompt <workspace> --reset            # Reset to default
The custom prompt is prepended to the agent’s context for every task run in the workspace. Use it to enforce project-specific conventions, testing requirements, or coding standards.

​
Workspace documents

Documents provide additional context to agents. Create documents that are injected into the agent’s context: 
konduktor docs create <workspace> \
  --title "Coding Standards" \
  --file standards.md
The total size of inline-injected documents per workspace is capped at 8,000 characters. Use documents for concise, high-value context (architecture decisions, API conventions, etc.) rather than full reference documentation.

​
Operational parameters

These are hardcoded defaults in the server. They cannot be changed via configuration, but are documented here for operational awareness.
ParameterValuePurpose
Max concurrent tasks6Maximum agent sessions running simultaneously
Stuck timeout120 minKill agents with no output after this duration
Stuck check interval2 minHow often the stuck detector runs
Orphan check interval10 minHow often the orphan detector runs
Worktree cleanup interval30 minHow often orphaned worktrees are cleaned
Worktree max age24 hoursClean worktrees with no active session older than this
Conflict check interval1 minHow often merge conflicts are checked
Login rate limit5 attempts / 15 minPer-IP rate limiting on the login endpoint
Inline doc size limit8,000 charsMax total size of inline-injected documents per workspace