Skip to content

Latest commit

 

History

History
66 lines (41 loc) · 1.58 KB

README-runtime.md

File metadata and controls

66 lines (41 loc) · 1.58 KB

Retreivr Runtime Deployment

What This Is

This runtime bundle provides the minimum files required to run Retreivr with Docker, without cloning the full repository.

Requirements

  • Docker
  • Docker Compose

Setup Instructions

Step 1 — Download release bundle

Download retreivr-runtime-<version>.zip from the GitHub Release.

Step 2 — Extract files

Extract the bundle to a directory where you want to run Retreivr.

Step 3 — Copy config template

Create your runtime config file:

cp config/config.json.example config/config.json

Step 4 — Edit config.json

Update config/config.json for your environment and preferences.

Step 5 — Start Retreivr

Run:

docker compose up -d

Updating

To update to a newer release:

  1. Pull the new image referenced by the updated compose file.
  2. Replace docker-compose.yml with the version from the new runtime bundle if it changed.
  3. Restart the service:
docker compose pull
docker compose up -d

Versioning

The runtime bundle version matches the Docker image tag for that release.

Notes

  • Full source code and development files are available in the main repository.
  • The runtime bundle is intended for simplified Docker deployment only.
  • Optional custom search adapters can be defined in config/custom_search_adapters.yaml.
    • Start from config/custom_search_adapters.example.yaml.
    • Point custom_search_adapters_file in config/config.json to your YAML/JSON file path.
    • Custom adapters that load successfully are exposed automatically in Home source selection.