Add Docker Compose configuration for running TinySearch with SearXNG

Author: MarcellM01

README.md

@@ -34,10 +34,12 @@ Just search -> crawl -> rerank -> grounded prompt.
 
 ## Quick start
 
-Run TinySearch as an MCP server over Streamable HTTP:
+Run TinySearch with its own SearXNG instance as an MCP server over Streamable
+HTTP. Docker Compose loads the configuration directly from GitHub, so you do
+not need to clone the repository or create any configuration files:
 
 ```bash
-docker run --rm -p 8000:8000 -e MCP_TRANSPORT=streamable-http -e MCP_HOST=0.0.0.0 marcellm01/tinysearch:latest
+docker compose -f "https://github.com/MarcellM01/TinySearch.git#main:compose.quickstart.yaml" up -d
 ```
 
 Then connect your MCP client to:
@@ -52,6 +54,12 @@ Then connect your MCP client to:
 }
 ```
 
+Stop and remove the containers later with:
+
+```bash
+docker compose -f "https://github.com/MarcellM01/TinySearch.git#main:compose.quickstart.yaml" down
+```
+
 TinySearch exposes one MCP tool:
 
 ```text

compose.quickstart.yaml

@@ -0,0 +1,41 @@
+name: tinysearch
+
+services:
+  searxng:
+    image: searxng/searxng:latest
+    restart: unless-stopped
+    configs:
+      - source: searxng_settings
+        target: /etc/searxng/settings.yml
+
+  tinysearch:
+    image: marcellm01/tinysearch:latest
+    restart: unless-stopped
+    ports:
+      - "8000:8000"
+    shm_size: "1gb"
+    volumes:
+      - models:/data/models
+    environment:
+      MCP_TRANSPORT: streamable-http
+      MCP_HOST: 0.0.0.0
+      MCP_PORT: 8000
+      SEARXNG_URL: http://searxng:8080/search
+    depends_on:
+      - searxng
+
+configs:
+  searxng_settings:
+    content: |
+      use_default_settings: true
+      search:
+        formats:
+          - html
+          - json
+      server:
+        secret_key: "tinysearch-local-only"
+        limiter: false
+        image_proxy: false
+
+volumes:
+  models: