caddy-search

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 36 Open GitHub ↗

search middleware for Caddy

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# search

Middleware for [Caddy](https://caddyserver.com).

**search** indexes your static and/or dynamic documents then serves a HTTP search endpoint.

### Syntax

```
search [directory|regexp] [endpoint "search/"]
```
* **directory** is the path, relative to site root, to a directory (static content)
* **regexp** is the URL [regular expression] of documents that must be indexed (static and dynamic content)
* **endpoint** is the path, relative to site's root url, of the search endpoint

For more options, use the following syntax:

```
search {
    engine      (default: bleve)
    datadir     (default: /tmp/caddyIndex)
    endpoint    (default: /search)
    template    (default: nil)
    expire      (default: 60)

+path       regexp
    -path       regexp
}
```
* **engine** is the engine for indexing and searching
* **datadir** is the absolute path to where the indexer should store all data
* **template** is the path to the search's HTML result's template
* **expire** is the duration (in seconds) until a indexed document validation expires (should be updated)
* **+path** include a path to be indexed (can be added multiple times)
* **-path** exclude a path from being index (can be added multiple times)

Each property in the block is optional.

### Supported Engines

* [BleveSearch](http://github.com/blevesearch/bleve)

### Examples

Index every static content in root folder (single line configuration)
```
search /
```

Index every content (single line configuration)
```
search ^/
```

Indexing every dynamic content with a different endpoint (single line configuration)
```
search /(.*) /mySearch
```

Ignoring specific type of file
```
search {
    -path \.pdf$
}
```

Multiple static and dynamic paths
```
search ^/blog/ {
	+path /static/docs/
    -path ^/blog/admin/
    -path robots.txt
}
```

Different directory for storing the index
```
search {
	datadir /tmp/index
}
```

caddy-search

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README