ESC
Getting Started
Installation
Install Çolpan on your Windows computer and get started.
First Search
Make your first search in UDF files with Çolpan.
Interface Tour
Detailed walkthrough of the main Colpan interface, panels, and status indicators.
CQL Query Language
CQL Basics
Make powerful searches with Çolpan Query Language (CQL).
Advanced Queries
Build complex CQL expressions with grouping, exclusions, and professional search patterns.
Query Examples
Ready-to-use CQL examples for common legal research scenarios.
Features
Profile Management
Organize work with up to five independent profiles and isolated settings.
Directory Management
Add, exclude, and maintain searchable folders for each profile.
Indexing System
How Colpan builds and refreshes indexes for fast searching across large archives.
Search and Filtering
Indexed, instant, and external-index search flows with file/path/date filters.
PDF Viewer
Use the integrated PDF viewer for preview, navigation, search, and printing.
AI Query Assistant
Generate CQL queries from natural language with CF Worker or OpenRouter modes.
Results List
Understand columns, sorting, selection, and batch workflows in search results.
Manticore Search
Advanced full-text search mode with BM25 ranking for richer relevance ordering.
System Tray
Run Colpan in the background with tray controls and quick restore options.
Document Conversion
Convert UDF and office files to PDF/UDF with Java or native conversion flows.
Themes and Appearance
Customize theme, preview position, and interface behavior for your workflow.
Reference
Keyboard Shortcuts
Complete reference of productivity shortcuts in Colpan.
Troubleshooting
Common issues and practical fixes for startup, indexing, search, and conversion.
Frequently Asked Questions
Common questions about installation, indexing, search behavior, and privacy.
Technical Reference
Reference for folder layout, index artifacts, logs, and operational parameters.
LLM Quick Guide
Canonical links, response rules, and practical usage notes for Colpan-focused AI assistants.
MCP Integration
MCP bootstrap layer for Colpan, current status, usage model, and roadmap.
Legal
Privacy Policy
Privacy and data handling principles for Colpan desktop features, including optional AI assistant modes.
No results found
Home
TR
Reference

Troubleshooting

Common issues and practical fixes for startup, indexing, search, and conversion.

Application Does Not Start

Symptoms

  • Colpan does not open after clicking executable.

Checks

  • Ensure all bundled files are in the same directory.
  • Run as administrator once.
  • Add Colpan folder to antivirus exclusions.

PDF Preview Is Blank

Checks

  • Verify conversion daemon status.
  • Ensure conversion dependencies exist.
  • Restart Colpan and reopen the file.

Search Returns No Results

Checks

  • Confirm directory is active.
  • Confirm index is up to date.
  • Test with a simpler query first.
  • Remove restrictive filters.

Indexing Is Slow

Reasons

  • very large dataset
  • network drive latency
  • HDD bottlenecks

Actions

  • move dataset to local SSD
  • split massive folders
  • re-index in smaller batches

Manticore Errors

Common Causes

  • daemon startup blocked
  • port conflict
  • corrupted data directory

Actions

  • free the required port
  • restart machine
  • reinitialize Manticore data folder

AI Assistant Errors

Common Causes

  • internet connectivity
  • temporary endpoint outage
  • invalid API key (direct mode)

Actions

  • retry with shorter prompt
  • verify credentials
  • switch integration mode if available

Reporting Issues

When reporting, include:

  • exact steps to reproduce
  • sample query
  • %TEMP%\Colpan\colpan.log excerpt